| Name | buildlink JSON |
| Version |
1.0.0
JSON |
| download |
| home_page | https://github.com/TechUX/buildlink |
| Summary | buildlink is a python program which helps you to shorten link with a single command without any registration or using any API Key.Its also provide option to expand any link available on internet on wide range of domain names. |
| upload_time | 2023-01-15 16:59:24 |
| maintainer | |
| docs_url | None |
| author | Devesh Singh |
| requires_python | >=2.0 |
| license | MIT |
| keywords |
link
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# buildlink
[](https://github.com/TechUX/buildlink)
[](https://pypi.org/project/buildlink/)
[](https://pypi.org/project/buildlink/)
buildlink is a python program which helps you to shorten link with a single command without any registration or using any API Key. Its is capable of expanding any link available on internet. with support of wide range of domain names.
# Features
- ### Link Shortening
buildlink has ability to shorten any long url into short url using 5 different service providers along with custom alias for shorten link
<br>**Note :** ```alias``` for link shortening must be less than 30 characters. <br>
*i.e.* ```shorten("url", alias="less than 30 char")``` <br><br>
- ### Link Expanding
with the help of ```expand()``` , you can expand any shorten link available on internet to their long form without visiting really to that link. <br> This is helpful when you get malicious short link and you want to know actual URL behind the shorten one, without clicking on the Link.
# Functions
- #### ```expand(url)```
This function takes one input as a parameter and return the Long URL associated with the short link. <br>
**Return Type :** string
```python
expand("https://tinyurl.com/yuxh3b37")
# Output : https://github.com/TechUX/buildlink
```
[See Examples](#examples)
- #### ```shorten(url, service, alias)```
This function takes three parameters as a input, url, service for shortening, and alias . <br>
**Return Type :** list - list of shortened URL , *if no service is privided*
```python
shorten("https://github.com/TechUX/buildlink", service="tinyurl")
# Output : https://tinyurl.com/yuxh3b37
```
[See Examples](#examples)
- #### ```help()```
This function display a basic help page of the package.
## Options
There are 5 options which is available for ```service```.
<br> These are as follow :
| Service | Domain |
|:---------: | :--------: |
| tinyurl | tinyurl.com |
| isgd | is.gd |
| clckru | clck.ru |
| chilpit | chilp.it |
| daga | da.gd |
**Note :** length of ```alias``` must be less than 30 characters.
# Examples
## Link shortening
```python
import buildlink as link
long_url = "https://github.com/TechUX/buildlink/blob/main/README.md"
shorten_url = link.shorten(long_url)
print(shorten_url)
# Output : ['https://tinyurl.com/2mksjsq7', 'https://is.gd/e8tsIB', 'https://clck.ru/33GnAf', 'http://chilp.it/6c70182\n', 'https://da.gd/tsttQ\n']
```
### Shortening with service specified
for this, just add the ```service="<service_value>``` parameter.
```python
import buildlink as link
long_url = "https://github.com/TechUX/buildlink/blob/main/README.md"
shorten_url = link.shorten(long_url, service="tinyurl")
print(shorten_url)
# Output : https://tinyurl.com/2mksjsq7
```
### Shortening with alias
```python
import buildlink as link
long_url = "https://github.com/TechUX/buildlink/blob/main/README.md"
shorten_url = link.shorten(long_url, alias="pylink")
print(shorten_url)
# Output : https://is.gd/pylink
```
## Link Expanding
```python
import buildlink as link
short_url = "https://is.gd/pylink"
long_url = link.expand(short_url)
print(longurl)
# Output : https://github.com/TechUX/buildlink/blob/main/README.md
```
# Supported Domain for link shortening
this package is currently using 5 domains to short link :
These are as follow
- [Tinyurl](https://tinyurl.com)
- [is.gd](https://is.gd)
- [clck.ru](https://clck.ru)
- [chilp.it](http://chilp.it)
- [da.gd](https://da.gd)
# Supported Domain for link expanding
Almost all the shorten domains are supported for expansion.
buildlink supports a wide range of URL shortening services, including t.co, goo.gl, bit.ly, amzn.to, tinyurl.com, ow.ly, youtu.be, rg.gy, adf.ly and many others.
# Issues & Pull Requests
If you find any issue or bug in the package, kindly post it on [Issue page](https://github.com/TechUX/buildlink/issues) .
[Go to Issue page](https://github.com/TechUX/buildlink/issues)
New Ideas and Innovations are always welcomed. [Create a pull request](https://github.com/TechUX/buildlink/compare) if you want to add something new or have a fix of any bug.
<br>[Click here for Pull Request](https://github.com/TechUX/buildlink/pulls)
# About
A simple , lghtweight python package which have ability of shortening and expanding links.<br>
You can shorten a long URL with 5 different services and also expand any shorten URL of internet to its original Long form in a single Click.
<br>Try this package now. [Its available on pypi](https://pypi.org/project/buildlink/).
# Author & License
[](https://instagram.com/code.radius) <br>
**Author** : Devesh Singh [ [GitHub: @TechUX](https://github.com/TechUX/) | Instagram : [@devesh92744](https://instagram.com/devesh92744) : [@code.radius](https://instagram.com/code.radius) ]
**License**
This project is under MIT License.
<br>[Click Here for detailed License](https://github.com/TechUX/buildlink/blob/main/LICENSE)
Raw data
{
"_id": null,
"home_page": "https://github.com/TechUX/buildlink",
"name": "buildlink",
"maintainer": "",
"docs_url": null,
"requires_python": ">=2.0",
"maintainer_email": "",
"keywords": "link",
"author": "Devesh Singh",
"author_email": "connect.world12345@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/48/80/ba2e971c6381c0bbc7728e6bb5f5ee19ce78d5b5bfcbce1753c5f0f72a2e/buildlink-1.0.0.tar.gz",
"platform": null,
"description": "# buildlink\n[](https://github.com/TechUX/buildlink)\n\n[](https://pypi.org/project/buildlink/)\n[](https://pypi.org/project/buildlink/)\n\nbuildlink is a python program which helps you to shorten link with a single command without any registration or using any API Key. Its is capable of expanding any link available on internet. with support of wide range of domain names.\n\n# Features\n- ### Link Shortening\nbuildlink has ability to shorten any long url into short url using 5 different service providers along with custom alias for shorten link\n\n <br>**Note :** ```alias``` for link shortening must be less than 30 characters. <br>\n *i.e.* ```shorten(\"url\", alias=\"less than 30 char\")``` <br><br>\n \n\n- ### Link Expanding\nwith the help of ```expand()``` , you can expand any shorten link available on internet to their long form without visiting really to that link. <br> This is helpful when you get malicious short link and you want to know actual URL behind the shorten one, without clicking on the Link.\n\n# Functions\n- #### ```expand(url)```\nThis function takes one input as a parameter and return the Long URL associated with the short link. <br>\n**Return Type :** string\n\n```python\nexpand(\"https://tinyurl.com/yuxh3b37\")\n\n# Output : https://github.com/TechUX/buildlink\n```\n[See Examples](#examples)\n\n- #### ```shorten(url, service, alias)```\nThis function takes three parameters as a input, url, service for shortening, and alias . <br>\n**Return Type :** list - list of shortened URL , *if no service is privided*\n\n```python\nshorten(\"https://github.com/TechUX/buildlink\", service=\"tinyurl\")\n\n# Output : https://tinyurl.com/yuxh3b37\n```\n\n[See Examples](#examples)\n\n- #### ```help()```\nThis function display a basic help page of the package.\n\n## Options\nThere are 5 options which is available for ```service```.\n<br> These are as follow :\n\n | Service | Domain |\n |:---------: | :--------: |\n | tinyurl | tinyurl.com |\n | isgd | is.gd |\n | clckru | clck.ru |\n | chilpit | chilp.it |\n | daga | da.gd |\n \n **Note :** length of ```alias``` must be less than 30 characters.\n \n# Examples\n## Link shortening\n```python\nimport buildlink as link\n\nlong_url = \"https://github.com/TechUX/buildlink/blob/main/README.md\"\n\nshorten_url = link.shorten(long_url)\n\nprint(shorten_url)\n\n# Output : ['https://tinyurl.com/2mksjsq7', 'https://is.gd/e8tsIB', 'https://clck.ru/33GnAf', 'http://chilp.it/6c70182\\n', 'https://da.gd/tsttQ\\n']\n```\n\n### Shortening with service specified \nfor this, just add the ```service=\"<service_value>``` parameter.\n```python\nimport buildlink as link\n\nlong_url = \"https://github.com/TechUX/buildlink/blob/main/README.md\"\n\nshorten_url = link.shorten(long_url, service=\"tinyurl\")\n\nprint(shorten_url)\n\n# Output : https://tinyurl.com/2mksjsq7\n```\n\n### Shortening with alias\n```python\nimport buildlink as link\n\nlong_url = \"https://github.com/TechUX/buildlink/blob/main/README.md\"\n\nshorten_url = link.shorten(long_url, alias=\"pylink\")\n\nprint(shorten_url)\n\n# Output : https://is.gd/pylink\n\n```\n\n## Link Expanding\n```python\nimport buildlink as link\n\nshort_url = \"https://is.gd/pylink\"\n\nlong_url = link.expand(short_url)\n\nprint(longurl)\n\n# Output : https://github.com/TechUX/buildlink/blob/main/README.md\n```\n\n\n# Supported Domain for link shortening\nthis package is currently using 5 domains to short link :\nThese are as follow\n - [Tinyurl](https://tinyurl.com)\n - [is.gd](https://is.gd)\n - [clck.ru](https://clck.ru)\n - [chilp.it](http://chilp.it)\n - [da.gd](https://da.gd)\n\n# Supported Domain for link expanding\nAlmost all the shorten domains are supported for expansion.\nbuildlink supports a wide range of URL shortening services, including t.co, goo.gl, bit.ly, amzn.to, tinyurl.com, ow.ly, youtu.be, rg.gy, adf.ly and many others.\n\n# Issues & Pull Requests \n\nIf you find any issue or bug in the package, kindly post it on [Issue page](https://github.com/TechUX/buildlink/issues) .\n[Go to Issue page](https://github.com/TechUX/buildlink/issues)\n\nNew Ideas and Innovations are always welcomed. [Create a pull request](https://github.com/TechUX/buildlink/compare) if you want to add something new or have a fix of any bug.\n<br>[Click here for Pull Request](https://github.com/TechUX/buildlink/pulls)\n\n\n# About\nA simple , lghtweight python package which have ability of shortening and expanding links.<br>\nYou can shorten a long URL with 5 different services and also expand any shorten URL of internet to its original Long form in a single Click.\n<br>Try this package now. [Its available on pypi](https://pypi.org/project/buildlink/).\n\n# Author & License\n[](https://instagram.com/code.radius) <br>\n**Author** : Devesh Singh [ [GitHub: @TechUX](https://github.com/TechUX/) | Instagram : [@devesh92744](https://instagram.com/devesh92744) : [@code.radius](https://instagram.com/code.radius) ]\n\n**License**\nThis project is under MIT License. \n<br>[Click Here for detailed License](https://github.com/TechUX/buildlink/blob/main/LICENSE)\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "buildlink is a python program which helps you to shorten link with a single command without any registration or using any API Key.Its also provide option to expand any link available on internet on wide range of domain names.",
"version": "1.0.0",
"split_keywords": [
"link"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "50e463912fd0660b0ff2a2193b52687834409510dc7a36c11548f8f61c443379",
"md5": "e80a466e743258cdcd61b5872b495ea9",
"sha256": "150de37178b3c15d9b929aedee4672bce1ebd90a4d3504f5f9dc3b6a306e67a8"
},
"downloads": -1,
"filename": "buildlink-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e80a466e743258cdcd61b5872b495ea9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=2.0",
"size": 5812,
"upload_time": "2023-01-15T16:59:22",
"upload_time_iso_8601": "2023-01-15T16:59:22.381400Z",
"url": "https://files.pythonhosted.org/packages/50/e4/63912fd0660b0ff2a2193b52687834409510dc7a36c11548f8f61c443379/buildlink-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4880ba2e971c6381c0bbc7728e6bb5f5ee19ce78d5b5bfcbce1753c5f0f72a2e",
"md5": "b126385bd3934785b7151a62a2da8bb3",
"sha256": "458fcb6be5eff196f255b5fd80dd363e3d7c1089f5157b8dfafbe0f9bdb16cbf"
},
"downloads": -1,
"filename": "buildlink-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "b126385bd3934785b7151a62a2da8bb3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=2.0",
"size": 5189,
"upload_time": "2023-01-15T16:59:24",
"upload_time_iso_8601": "2023-01-15T16:59:24.967461Z",
"url": "https://files.pythonhosted.org/packages/48/80/ba2e971c6381c0bbc7728e6bb5f5ee19ce78d5b5bfcbce1753c5f0f72a2e/buildlink-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-15 16:59:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "TechUX",
"github_project": "buildlink",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "buildlink"
}
