example.py

"""Example usage of the Aria2 XML-RPC client."""

from aria2_client import Aria2Client

def main():
    # Initialize client with custom settings
    client = Aria2Client(
        host="http://127.0.0.1",
        port=6800,
        token="your_token_here"
    )

    # Or update settings later
    # client.set_server(host="http://example.com", port=6800, token="1234")

    # Check connection
    status = client.check_connection()
    print(f"Connection status: {status}")

    # Get Aria2 version
    version = client.get_version()
    print(f"Aria2 version: {version}")

    # Add a single URI
    gid = client.add_uri("https://example.com/file.zip")
    print(f"Added download GID: {gid}")

    # Add multiple URIs
    uris = [
        "https://example.com/file1.zip",
        "https://example.com/file2.zip",
    ]
    gids = client.add_uri(uris, save_dir="/tmp/downloads")
    print(f"Added downloads: {gids}")

    # Add a torrent
    # gid = client.add_torrent("example.torrent", save_dir="/tmp/torrents")

    # Get active downloads
    active = client.tell_active(["gid", "status", "totalLength"])
    print(f"Active downloads: {active}")

    # Pause a download
    # client.pause(gid)

    # Resume a download
    # client.unpause(gid)

    # Get global status
    global_status = client.get_global_status()
    print(f"Global status: {global_status}")

    # Change download speed limit
    # client.change_global_option({"max-download-limit": "1M"})


if __name__ == "__main__":
    main()