feat(python): AsyncDaemon with async status() (partial #65)

[zackees]

Summary

Next incremental step on #65 (native async Python API). Adds `AsyncDaemon` as a counterpart to the sync `Daemon` class, mirroring the `AsyncSerialMonitor` pattern from PR #73.

Changes

• `AsyncDaemon` is purely additive — the sync `Daemon` class keeps all its methods and behavior.
• Exposes `async status()` as the first method. Like `reset_device` on `AsyncSerialMonitor`, `status` is stateless HTTP so it ports without needing the cross-await state refactor.

Follow-up (tracked in #65)

• `async ensure_running()`, `async stop()` are straightforward next steps (same HTTP-only pattern).
• The WebSocket-backed methods (`AsyncSerialMonitor.read_lines`, `write`, `write_json_rpc`, `aenter`/`aexit`) still need the shared WebSocket state refactored to be `Send + Sync` across `await` points before they can be exposed.

Test plan

• `cargo check -p fbuild-python` clean
• `cargo clippy --workspace --all-targets -- -D warnings` clean
• `cargo fmt --all -- --check` clean

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features
  • Added async daemon status checking with HTTP connectivity and automatic error handling for connection failures and timeouts.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 9a10399e-fe81-4d60-916c-fbbed9088f4d

📥 Commits

Reviewing files that changed from the base of the PR and between 4f153d0 and 8dbdd03.

📒 Files selected for processing (1)

• crates/fbuild-python/src/lib.rs

---

📝 Walkthrough

Walkthrough

A new Python-exposed Rust class AsyncDaemon was introduced with a static async method status that performs HTTP GET requests to a daemon info endpoint with a 10-second timeout, converting HTTP and JSON errors into Python exceptions.

Changes

Cohort / File(s)	Summary
Async Daemon Status API crates/fbuild-python/src/lib.rs	Added AsyncDaemon PyO3 class with status() static async method; performs HTTP GET to daemon API with 10s timeout; handles connection/send errors as PyConnectionError, response read/JSON parsing errors as PyRuntimeError; registered in module initializer.

Sequence Diagram(s)

sequenceDiagram
    participant Python as Python Client
    participant Async as AsyncDaemon
    participant Tokio as Tokio Runtime
    participant HTTP as HTTP Client
    participant Daemon as Daemon API
    
    Python->>Async: status(py)
    activate Async
    Async->>Tokio: spawn async task
    activate Tokio
    Tokio->>HTTP: GET /api/daemon/info
    activate HTTP
    HTTP->>Daemon: send request
    activate Daemon
    Daemon-->>HTTP: response
    deactivate Daemon
    HTTP-->>Tokio: response body
    deactivate HTTP
    Tokio->>Tokio: parse JSON
    Tokio-->>Async: future result
    deactivate Tokio
    Async->>Async: convert to Python
    Async-->>Python: PyResult<Bound<PyAny>>
    deactivate Async

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related issues

• feat(python): native async API via pyo3-async-runtimes (AsyncSerialMonitor, AsyncDaemon) #65: This PR directly implements the proposed native async API by adding the AsyncDaemon pyclass and async-friendly status() method using pyo3-async-runtimes.

Poem

🐰 Async daemons hopping fast,
HTTP requests unsurpassed,
Timeouts ticking, responses flow,
Python and Rust together glow! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'feat(python): AsyncDaemon with async status() (partial #65)' clearly and concisely summarizes the main change: adding a new AsyncDaemon class with an async status() method. It accurately reflects the primary additions shown in the changeset and follows conventional commit formatting.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/issue-65-async-daemon

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}