predb 1.0.0

Python client for PreDB.net API

PreDB Python Client 🎉

Python client for the PreDB.net API.

Like it? I'd appreciate the support :)

Installation

pip install predb

Usage

from predb import PreDBClient

# Initialize the client
client = PreDBClient()

# Search for releases
response = client.search("!search Ubuntu", user_agent="MyApp/1.0")

# Check the response
if response and response.get("status") == "success":
    for row in response.get("data", {}).get("rows", []):
        print(f"{row['name']} - {row['cat']}")

Search Types

The client supports different search types using the command prefix format:

• !search <query> or !dupe <query> - General search
• !pre <name> - Search by exact release name
• !nfo <query> - Search in NFO files
• !group <name> - Search by group name
• !section <name> or !cat <name> - Search by section/category
• !genre <name> - Search by genre
• !tag <name> or !lang <name> - Search by tag/language
• !nuked, !unnuked, !delpre, !undelpre - Filter by status
• !last - Get last releases

Example

from predb import PreDBClient

client = PreDBClient()

# Search for a specific release
result = client.search("!pre Some.Release.Name-GRP", user_agent="MyApp/1.0")

# Search by group
result = client.search("!group RARBG", user_agent="MyApp/1.0")

# Get latest releases
result = client.search("!last", user_agent="MyApp/1.0")

API Response

The API returns a dictionary with the following structure:

{
    "status": "success",
    "message": "",
    "data": {
        "offset": 0,
        "total": 100,
        "time": 0.5,
        "rows": [
            {
                "id": "12345",
                "name": "Release.Name-GRP",
                "team": "GRP",
                "cat": "TV",
                "genre": "...",
                "url": "...",
                "size": "...",
                "files": "...",
                "pretime": 1234567890,
                "nuke": "...",
                "unnuke": "...",
                "reason": "...",
                ...
            }
        ]
    }
}

Requirements

• Python 3.7+
• requests
• timeago

License

MIT

That's it!

Be excellent to each other. And, Party on, dudes!