Metadata-Version: 2.1
Name: Unalix
Version: 0.5
Summary: A simple module that removes tracking fields from URLs and unshort shortened URLs.
Home-page: https://github.com/AmanoTeam/Unalix
Author: Amano Team
Author-email: contact@amanoteam.com
License: LGPL-3.0
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Operating System :: Unix
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: httpx[http2] (==0.15.1)

### What it does?

In addition to removing tracking fields from URLs, Unalix also try to gets the direct link from shortened URLs.

### Installation

```bash
pip3 install --upgrade 'unalix'
```
or
```bash
pip3 install --upgrade 'git+https://github.com/AmanoTeam/Unalix'
```

The git repository will always have the most recent changes, so it is recommended that you install/update the module through it.

### Usage:

Let's see some examples:

**On a Python3 console:**

```python
from unalix import clear_url, unshort_url

url = 'http://example.com/?utm_source=google'
result = clear_url(url)

print(result)

url = 'http://goo.gl/ko4LWp'
result = unshort_url(url)

print(result)

```

Output:

```bash
http://example.com/
https://forum.xda-developers.com/android/apps-games/app-youtube-vanced-edition-t3758757
```
### Limitations

- Getting direct links from URL shorteners
  - Unalix only follows the URLs/paths provided by the `Location` header (see [RFC 7231, section 7.1.2: Location](https://tools.ietf.org/html/rfc7231#section-7.1.2)). It means that Unalix cannot obtain direct links from URL shorteners that require user interaction (e.g clicking a button or resolving CAPTCHA) to redirect or that uses JavaScript code to redirect.

### Contact

Want to say something? Need some help? [Open a issue](https://github.com/AmanoTeam/Unalix/issues) or [send a email](https://spamty.eu/show.php?key=d7967f0e625c5f19c9c655b8).

### License

Unalix in licensed under the [GNU Lesser General Public License v3.0](https://github.com/AmanoTeam/Unalix/blob/master/LICENSE).

### Third party software

Unalix includes some third party software. See them below:

- **ClearURLs**
  - Author: Kevin Röbert ([KevinRoebert](https://gitlab.com/KevinRoebert))
  - Repository: [KevinRoebert/ClearUrls](https://gitlab.com/KevinRoebert/ClearUrls)
  - License: [GNU Lesser General Public License v3.0](https://gitlab.com/KevinRoebert/ClearUrls/blob/master/LICENSE)

- **python-requests**
  - Author: Kenneth Reitz
  - Repository: [psf/requests](https://github.com/psf/requests)
  - License: [Apache v2.0](https://github.com/psf/requests/blob/master/LICENSE)


