Metadata-Version: 2.1
Name: Unalix
Version: 0.6
Summary: Small, dependency-free, fast Python package for removing tracking fields from URLs.
Home-page: https://github.com/AmanoTeam/Unalix
Author: SnwMds
Author-email: snwmds@tutanota.com
License: LGPL-3.0
Project-URL: Bug Tracker, https://github.com/AmanoTeam/Unalix/issues
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Operating System :: Unix
Classifier: Topic :: Internet
Classifier: Topic :: Security
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.6
Description-Content-Type: text/markdown

Unalix is a small, dependency-free, fast Python package that implements the same regex rule processing mechanism used by the [ClearURLs](https://github.com/ClearURLs/Addon) addon.

#### Installation

Install using `pip`:

```bash
pip3 install --force-reinstall \
    --disable-pip-version-check \
    --upgrade 'unalix'
```

_**Note**: Unalix requires Python 3.6 or higher._

#### Usage:

Removing tracking fields:

```python
from unalix import clear_url

url = "https://deezer.com/track/891177062?utm_source=deezer"
result = clear_url(url)

print(result)
```

Unshort shortened URL:

```python
from unalix import unshort_url

url = "https://bitly.is/Pricing-Pop-Up"
result = unshort_url(url)

print(result)
```

Output from both examples:

```bash
https://deezer.com/track/891177062
https://bitly.com/pages/pricing
```

#### Contributing

If you have discovered a bug in this library and know how to fix it, fork this repository and open a Pull Request.

If you found a URL that was not fully cleaned by Unalix (e.g. some tracking fields still remains), report them here or in the [ClearURLs addon repository](https://gitlab.com/anti-tracking/ClearURLs/rules/-/issues). We use the list of regex rules maintained by the ClearURLs maintainers, but we also have our [own list](./unalix/package_data/rulesets/unalix.json).

#### Third party software

Unalix includes some third party software. See them below:

- **ClearURLs**
  - Author: Kevin Röbert
  - Repository: [ClearURLs/Rules](https://github.com/ClearURLs/Rules)
  - License: [GNU Lesser General Public License v3.0](https://gitlab.com/ClearURLs/Rules/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)


