feat(daemon): download scheduling windows and bandwidth throttling

[rfsbraz]

Fixes #36

• New TDL_SCHEDULE_ACTIVE_HOURS setting gates daemon checks to configured time windows (24h local time via TZ); supports multiple comma-separated windows and windows that cross midnight (23:00-06:00)
• Outside active hours the daemon logs the skip, keeps updating the health file, and never interrupts a download already in flight - the schedule only gates the start of a check
• New TDL_MAX_DOWNLOAD_SPEED setting (e.g. 5MB) caps aggregate download speed via a shared async token-bucket limiter fed by pyrogram's progress callbacks, so throttling never blocks the event loop
• Both settings validate at startup (clear config errors on bad formats) and default to unrestricted
• Unit tests cover window parsing, cross-midnight logic, the daemon gate, rate parsing and throttle timing; README documents both settings

[github-actions]

Testing this PR

Option 1 — Docker Compose override:

Create a docker-compose.override.yml:

services:
  telegram-downloader:
    build: https://github.com/rfsbraz/telegram-downloader.git#refs/pull/56/head

Then run:

docker compose up --build

Option 2 — Direct build and run:

docker build https://github.com/rfsbraz/telegram-downloader.git#refs/pull/56/head -t telegram-downloader:pr-56
docker run --rm -it telegram-downloader:pr-56

[Copilot]

Pull request overview

This PR adds two user-configurable controls to the daemon: (1) scheduling windows that gate when a daemon check can start, and (2) an optional aggregate bandwidth cap applied during downloads via a shared async rate limiter.

Changes:

• Introduces TDL_SCHEDULE_ACTIVE_HOURS parsing + daemon gating to skip checks outside configured time windows.
• Introduces TDL_MAX_DOWNLOAD_SPEED parsing + a shared async token-bucket limiter wired into Pyrogram download progress.
• Adds unit tests and README documentation for both settings, plus startup validation in config schema.

Reviewed changes

Copilot reviewed 10 out of 11 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
tests/unit/daemon/test_schedule.py	Adds unit tests for active-hours parsing, cross-midnight behavior, and daemon check gating.
tests/unit/daemon/init.py	Marks daemon unit test package.
tests/unit/client/test_ratelimit.py	Adds unit tests for rate parsing and RateLimiter throttling behavior.
src/main.py	Wires optional RateLimiter into download flows and passes schedule config into DaemonService.
src/daemon/service.py	Adds active_hours configuration and gates run_check() based on parsed schedule windows.
src/daemon/schedule.py	Implements active-hours parsing and “within window” checks (including cross-midnight).
src/config/schema.py	Adds schedule_active_hours and max_download_speed config fields with startup validation.
src/config/loader.py	Allows the new config keys to be loaded from environment variables.
src/client/ratelimit.py	Implements parse_rate() and an async shared token-bucket RateLimiter.
src/client/downloader.py	Hooks the optional limiter into progress callbacks by feeding byte deltas to the limiter.
README.md	Documents scheduling and bandwidth environment variables and expected formats.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.