Skip to main content

Crate rusteero

Crate rusteero 

Source
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::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 EeroApi aggregator: one auth API plus the 37 domain endpoint modules, composed over a single Transport.
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 Client facade: EeroApi plus a Cache plus in-memory preferred-network state.
consts
Wire constants: base URLs, size limits, timeouts, and other values ported from eero-api’s src/eero/const.py at v8.4.1.
endpoints
One module per Python domain module in eero-api’s src/eero/api/.
envelope
Lossless view over the raw {"meta": …, "data": …} wire envelope.
error
The crate error type.
errors
The closed catalogue of meta.error strings the Eero cloud API reports, and the single classification point that turns an HTTP status + parsed envelope into an Error.
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 Resource or Nested constant.
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.