trackerstatus 1.0.10

A Python client for the trackerstatus.info API

trackerstatus

A Python wrapper for the trackerstatus.info API and its tracker-specific endpoints. This library provides a simple interface to monitor the status of various trackers and their services.

• Rate-limited API client (1 request per minute as per API requirements)
• Support for all tracker-specific endpoints:
  • AlphaRatio (ar.trackerstatus.info)
  • BroadcastTheNet (btn.trackerstatus.info)
  • GazelleGames (ggn.trackerstatus.info)
  • PassThePopcorn (ptp.trackerstatus.info)
  • Redacted (red.trackerstatus.info)
  • Orpheus (ops.trackerstatus.info)
  • Nebulance (nbl.trackerstatus.info)
  • Anthelion (ant.trackerstatus.info)
• Comprehensive status information including:
  • Current status
  • Latency metrics
  • Uptime statistics
  • Record uptimes
  • Downtime tracking
• Type hints and detailed documentation
• Extensive test coverage

Documentation

The project includes comprehensive documentation:

• API Reference - Detailed API documentation
• Examples - Various usage examples and best practices
• Changelog - Version history and changes

Features

• Check tracker status and response times
• Support for multiple tracker protocols (HTTP, HTTPS, UDP)
• Detailed status information including:
  • Response time
  • Status code
  • Error messages
  • Protocol information
• Easy-to-use API with subdomain-based endpoints
• Comprehensive documentation

Installation

pip install trackerstatus

Quick Start

from trackerstatus import APIClient, StatusEndpoint, BTNEndpoint

# Create an API client
client = APIClient()

# Get overall status of all trackers
status_endpoint = StatusEndpoint(client)
all_statuses = status_endpoint.get_status()
print("Overall Status:")
for tracker, info in all_statuses.items():
    print(f"{tracker.upper()}: {info['status_message']}")
    if info['details']:
        details = info['details']
        print(f"  Description: {details.get('Description', 'N/A')}")
        print(f"  Services: {details.get('Services', {})}")
        print(f"  Last Update: {details.get('tweet', {}).get('date', 'N/A')}")

# Get specific tracker status (using subdomain-based endpoint)
btn = BTNEndpoint(client)
btn_status = btn.get_status()  # Uses https://btn.trackerstatus.info/api/status
print(f"\nBTN Status: {btn_status['status_code']['Description']}")

For more detailed examples, see the examples documentation.

Documentation

• API Reference
• Examples
• Changelog

Development

This project uses Poetry for dependency management and development tools:

# Install dependencies
poetry install

# Run tests
poetry run pytest

# Format code
poetry run black .
poetry run isort .

# Type checking
poetry run mypy .

License

This project is licensed under the MIT License - see the LICENSE file for details.