Skip to main content

Crate confium_registry

Crate confium_registry 

Source
Expand description

Client for the Confium plugin registry.

The registry is a static-site catalog hosted at registry.confium.org (GitHub Pages). This client fetches the index, verifies publisher signatures, downloads plugin artifacts, and stages them for the Engine to load.

See TODO.roadmap/06-module-registry.md for the registry design, including URL structure, manifest schema, trust model, and publishing flow.

§Crate layout

  • client — the Client that resolves plugin metadata from the static site. The transport is pluggable via the Fetcher trait so tests (and offline mirrors) can inject content without a network.
  • manifest — typed mirrors of the TOML documents served by the registry (index.toml, per-plugin index.toml, manifest.toml, trust-roots.toml).
  • [install] — install an artifact to the local plugin directory, resolving versions and (once signature verification ships) checking the trust policy.
  • trust — the TrustStore that persists the user’s trusted publishers under ~/.config/confium/trust/.
  • verify — cryptographic (verify::verify_signature) and policy (verify::check) layers for PGP signature verification. The crypto layer prefers in-process RNP via libloading and falls back to gpg --verify when librnp isn’t available.

Re-exports§

pub use client::Client;
pub use client::Fetcher;
pub use client::MemoryFetcher;
pub use error::Error;
pub use error::Result;
pub use install::InstalledRecord;
pub use install::install;
pub use manifest::AlgorithmMap;
pub use manifest::Artifact;
pub use manifest::ConfiumMeta;
pub use manifest::IndexEntry;
pub use manifest::Manifest;
pub use manifest::PluginIndex;
pub use manifest::TrustRoot;
pub use manifest::TrustRootsFile;
pub use manifest::VersionEntry;
pub use paths::config_dir;
pub use paths::plugin_install_dir;
pub use paths::plugins_dir;
pub use paths::trust_dir;
pub use trust::TrustStore;
pub use trust::TrustStoreEntry;
pub use verify::Verification;
pub use verify::verify_signature;

Modules§

client
Registry client.
error
Error model for the registry client.
install
Install + local-plugin management.
manifest
Typed mirrors of the TOML documents served by the registry.
paths
Filesystem locations used by the CLI and the registry client.
trust
Local trust store.
verify
Signature verification.

Constants§

DEFAULT_REGISTRY_URL
The default registry base URL.