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.}