fitgirl 0.2.0

Add your description here

High-Performance, Async-First Scraper for the FitGirl Repacks Universe

Documentation • Installation • Usage • API Reference

---

⚡ Overview

FitGirl Scraper is a production-grade Python library designed to programmatically interact with fitgirl-repacks.site. Unlike simple HTML parsers, it leverages the hidden WordPress REST API for robust data retrieval, falling back to high-speed HTML parsing (via selectolax) only when necessary.

It is built for speed, stealth, and type safety.

✨ Key Features

🚀 Async & Fast I/O bound operations are fully asynchronous. Built on curl_cffi to impersonate real browsers (Chrome 131) and selectolax for ultra-fast C-based parsing.

🛡️ Type Safe 100% type-hinted and runtime validated using msgspec. Every API response is a structured, frozen, and immutable object. No more `Dict[str, Any]`.

🕵️ Hybrid Engine Intelligently switches between the LinkeDom-like HTML scraping and the hidden JSON API to get the most reliable data available.

• Torrent Health: Real-time UDP tracker scraping to check seeds/peers.
• Smart Search: Advanced filtering by category (Lossless, Repack), tags, and dates.
• Resilient: Built-in exponential backoff, retry logic, and error handling.
• Zero-Config: Works out of the box with sensible defaults.

📦 Installation

Requires Python 3.13+. Use uv for the best experience.

uv add fitgirl

Or standard pip:

pip install fitgirl

🚀 Quick Start

import asyncio
from fitgirl import FitGirlClient

async def main():
    # Context manager handles session cleanup automatically
    async with FitGirlClient() as client:
        
        # 1. Search for a game (Uses API for speed)
        print("🔍 Searching for 'Cyberpunk'...")
        results = await client.search_api("cyberpunk")
        
        for post in results.items:
            print(f"found: {post.title}")

        # 2. Get Deep Details
        slug = "cyberpunk-2077"
        print(f"\n📥 Fetching details for {slug}...")
        repack = await client.get_repack_api(slug)
        
        print(f"📦 Size: {repack.repack_size}")
        print(f"🧲 Magnet: {repack.torrent_sources[0].magnet.raw_uri[:60]}...")
        
        # 3. Check Real-time Health
        health = await client.check_magnet_health(repack.torrent_sources[0].magnet)
        if health:
            print(f"🟢 Seeds: {health.seeds} | 🔴 Peers: {health.peers}")

if __name__ == "__main__":
    asyncio.run(main())

Detailed Usage: Check the Wiki Usage Guide for advanced examples.

📚 Documentation

The documentation is hosted in the GitHub Wiki:

• Home: Architecture & Design.
• Installation: Setup & Requirements.
• Usage Guide: Common patterns & recipes.
• API Reference: Complete method documentation.
• Contributing: How to build & test.

⚖️ Legal & Disclaimer

This software is for educational purposes only. The authors are not affiliated with FitGirl Repacks. Downloading copyrighted material without permission may be illegal in your jurisdiction. Use this tool responsibly.

---

_{Built with ❤️ by xsyncio}