Metadata-Version: 2.4
Name: truelink
Version: 1.2.0
Summary: Extract direct download links from various URL formats
Project-URL: Homepage, https://github.com/5hojib/truelink
Project-URL: Repository, https://github.com/5hojib/truelink
Project-URL: Documentation, https://github.com/5hojib/truelink#readme
Project-URL: Issues, https://github.com/5hojib/truelink/issues
Project-URL: Changelog, https://github.com/5hojib/truelink/releases
Author-email: 5hojib <yesiamshojib@gmail.com>
Maintainer-email: 5hojib <yesiamshojib@gmail.com>
License: MIT
License-File: LICENSE
Keywords: direct-link,download,extractor,link,url
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: cloudscraper>=1.2.71
Requires-Dist: lxml>=4.9.0
Provides-Extra: docs
Requires-Dist: mkdocs-autorefs>=0.4.0; extra == 'docs'
Requires-Dist: mkdocs-gen-files>=0.4.0; extra == 'docs'
Requires-Dist: mkdocs-literate-nav>=0.6.0; extra == 'docs'
Requires-Dist: mkdocs-macros-plugin; extra == 'docs'
Requires-Dist: mkdocs-material>=9.0.0; extra == 'docs'
Requires-Dist: mkdocs-section-index>=0.3.0; extra == 'docs'
Requires-Dist: mkdocs>=1.4.0; extra == 'docs'
Requires-Dist: mkdocstrings[python]>=0.20.0; extra == 'docs'
Description-Content-Type: text/markdown

# TrueLink

[![PyPI version](https://img.shields.io/pypi/v/truelink.svg)](https://pypi.org/project/truelink/)
[![Downloads](https://static.pepy.tech/badge/truelink/month)](https://pepy.tech/project/truelink)

A Python library for resolving media URLs to direct download links from various file hosting services.

## Features

- **Asynchronous**: Built with `async/await` for efficient handling of multiple requests.
- **Easy to use**: Simple API with intuitive method names.
- **Extensible**: Support for multiple file hosting platforms.
- **Error handling**: Robust error handling for various edge cases.
- **URL validation**: Built-in URL validation before processing.
- **Type-hinted**: Fully type-hinted codebase for better readability and maintainability.

## Installation

```bash
pip install truelink
```

## Quick Start

```python
import asyncio
from truelink import TrueLinkResolver

async def main():
    resolver = TrueLinkResolver()
    url = "https://buzzheavier.com/rnk4ut0lci9y"

    try:
        if resolver.is_supported(url):
            result = await resolver.resolve(url)
            print(type(result))
            print(result)
        else:
            print(f"URL not supported: {url}")
    except Exception as e:
        print(f"Error processing {url}: {e}")

asyncio.run(main())
```

### Documentation

For more information, see the [documentation](https://5hojib.github.io/truelink/).
