Expand description
§rusteero
Async Rust client for the Eero (Amazon) mesh Wi-Fi cloud API.
rusteero is a port of the Python eero-api
library. It keeps that library’s contract: every endpoint returns the raw
{"meta": …, "data": …} JSON envelope from the Eero cloud API, method names are the same,
and stored credentials are wire-compatible.
Unofficial project. This crate uses reverse-engineered APIs and is not affiliated with or endorsed by Eero or Amazon. Accounts that sign in with Amazon cannot use the email/SMS verification flow; see the project wiki for the documented workaround.
§Status
Under construction. See PARITY.md in the repository for the per-method checklist against
eero-api.
Re-exports§
pub use api::EeroApi;pub use auth::Session;pub use client::Client;pub use client::ClientBuilder;pub use envelope::Envelope;pub use envelope::Meta;pub use error::Error;pub use error::StorageError;pub use errors::ErrorGroup;pub use errors::classify_error_code;pub use links::join_api_path;pub use links::resolve_link;pub use links::resource_url;pub use links::rewrite_version;pub use links::self_url;pub use links::sub_resource_url;pub use storage::KeyringStore;pub use storage::ChainedStore;pub use storage::CredentialStore;pub use storage::FileStore;pub use storage::MemoryStore;pub use transport::RequestTimeout;
Modules§
- api
- The
EeroApiaggregator: one auth API plus the 37 domain endpoint modules, composed over a singleTransport. - auth
- Authentication: the session credential value (
Session), its on-disk storage representation, the interactive login handshake (flow), and the network-facing authentication API (AuthApi). - cache
- In-memory TTL cache backing
Client’s cached getters. - client
- The
Clientfacade:EeroApiplus aCacheplus in-memory preferred-network state. - consts
- Wire constants: base URLs, size limits, timeouts, and other values ported from
eero-api’ssrc/eero/const.pyatv8.4.1. - endpoints
- One module per Python domain module in
eero-api’ssrc/eero/api/. - envelope
- Lossless view over the raw
{"meta": …, "data": …}wire envelope. - error
- The crate error type.
- errors
- The closed catalogue of
meta.errorstrings the Eero cloud API reports, and the single classification point that turns an HTTP status + parsed envelope into anError. - links
- Resource-link resolution for Eero API response envelopes.
- params
- Shared query-parameter validation and identifier-resolution helpers.
- redact
- Redaction of sensitive keys in a
serde_json::Value. - routes
- Every wire endpoint as a
ResourceorNestedconstant. - storage
- Pluggable credential storage.
- transport
- Request core: header/credential construction, status mapping, response size cap, redirect refusal, GET-only bounded retry, and the server-driven refresh-and-replay handshake.
- util
- Small helpers shared across the crate.
Constants§
- VERSION
- Crate version, as compiled from
Cargo.toml.