rheopy 0.4.0

Concurrent HTTP download orchestration with async I/O

Rheo

Concurrent HTTP download orchestration with async I/O

What It Is

A Python library for managing multiple asynchronous HTTP downloads. Built on asyncio and aiohttp, it handles concurrency, tracks state, emits events, and lets you monitor progress.

Installation

pip install rheopy

Quick Start

import asyncio
from pathlib import Path
from rheo import DownloadManager
from rheo.domain import FileConfig

async def main():
    files = [
        FileConfig(url="https://example.com/file1.zip", priority=1),
        FileConfig(url="https://example.com/file2.pdf", priority=2),
    ]

    async with DownloadManager(download_dir=Path("./downloads"), max_concurrent=3) as manager:
        await manager.add(files)
        await manager.wait_until_complete()

    print("All downloads complete!")

asyncio.run(main())

Key Features

• Concurrent downloads with worker pool
• Priority queue
• Hash validation (MD5, SHA256, SHA512)
• Retry logic with exponential backoff
• Real-time speed & ETA tracking
• File exists handling (skip, overwrite, or error)
• Event-driven architecture
• CLI tool (rheo download)
• Full type hints

CLI Usage

# Basic download
rheo download https://example.com/file.zip

# With hash verification
rheo download https://example.com/file.zip --hash sha256:abc123...

# Custom output directory
rheo download https://example.com/file.zip -o /path/to/dir

See CLI Reference for complete command documentation.

Documentation

• Full Documentation - Complete guide with detailed examples
• CLI Reference - Command-line interface
• Architecture - System design and patterns
• Contributing - Development setup and guidelines
• Roadmap - What's next

Examples

Check examples/ for working code:

• 01_basic_download.py - Simple single file download
• 02_multiple_with_priority.py - Multiple files with priorities
• 03_hash_validation.py - File integrity verification
• 04_progress_tracking.py - Real-time progress monitoring
• 05_event_monitoring.py - Event-driven statistics

Project Status

Alpha - Core functionality works, but API may change before 1.0.

• Python: 3.12+
• License: MIT
• Version: 0.4.0

Questions?

Open an issue on GitHub or check the full documentation.