Metadata-Version: 2.4
Name: torrentlib
Version: 1.2.0
Summary: BitTorrent utilities for querying trackers and peers
Author: JackyHe398
Author-email: hekinghung@gmail.com
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.32.4
Requires-Dist: bencodepy>=0.9.5
Requires-Dist: humanize>=4.9.0
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# torrentlib

Python helpers for BitTorrent tracker queries, peer communication, and metadata inspection.

`torrentlib` is not a full BitTorrent client. It can:

- load `.torrent` metadata
- announce to HTTP and UDP trackers
- collect IPv4 and IPv6 peer lists
- connect to peers and download metadata
- process peer exchange (`ut_pex`) messages
- edit and rebuild `.torrent` files

It does not manage piece downloads/uploads for complete content transfer.

## Installation

```bash
pip install torrentlib
```

Supports Python 3.10 through 3.14.

## Public API

```python
from torrentlib import Torrent, TorrentMetaInfo, TorrentStatus, Peer
from torrentlib.Tracker import Check, Query
```

## Usage 

Please refer to the [Wiki](https://github.com/JackyHe398/torrentlib/wiki) for detailed usage examples and API reference.

## License
MIT. See [LICENSE](LICENSE).
