Metadata-Version: 2.4
Name: truelink
Version: 1.4.3
Summary: Extract direct download links from various URL formats
Project-URL: Homepage, https://5hojib.github.io/truelink/
Project-URL: Repository, https://github.com/5hojib/truelink
Project-URL: Source, https://github.com/5hojib/truelink
Project-URL: Documentation, https://5hojib.github.io/truelink/
Project-URL: Issues, https://github.com/5hojib/truelink/issues
Project-URL: Changelog, https://5hojib.github.io/truelink/changelog/
Author-email: 5hojib <yesiamshojib@gmail.com>
Maintainer-email: 5hojib <yesiamshojib@gmail.com>
License: MIT
License-File: LICENSE
License-File: NOTICE
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: dev
Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
Requires-Dist: ruff>=0.12.5; extra == 'dev'
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.
- **Caching**: Built-in caching for faster resolution of repeated requests.
- **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():
    # Check if a URL is supported without creating an instance
    if TrueLinkResolver.is_supported("https://buzzheavier.com/rnk4ut0lci9y"):
        print("BuzzHeavier is supported!")

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

    try:
        result = await resolver.resolve(url)
        print(type(result))
        print(result)
    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/).

### Community

- [Contributing](docs/contributing.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Changelog](docs/changelog.md)
