infrahub.rs

rust client for the infrahub graphql api.

features

• ergonomic, typed graphql operations
• branch-aware graphql routing
• schema fetch helper
• pagination helper for connection queries
• good errors
• examples and smoke tests

docs

• docs index
• client guide
• changelog

install

add to Cargo.toml:

[dependencies]
infrahub = "0.0.1"
tokio = { version = "1", features = ["full"] }

quick start

use infrahub::{Client, ClientConfig};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = ClientConfig::new("http://localhost:8000", "token");
    let client = Client::new(config)?;

    let response = client
        .execute_raw("{ InfrahubInfo { deployment_id version } }", None, None)
        .await?;

    println!("response: {response:?}");
    Ok(())
}

usage model

• this crate is the base graphql client
• generate a schema-specific crate with infrahub-codegen for ergonomic helpers

generated client

use infrahub-codegen to generate a schema-specific crate. this base crate stays stable and talks graphql directly; the generated crate adds typed, topic-grouped helpers for your schema.

generate a schema-specific client with infrahub-codegen:

cargo run --bin infrahub-codegen -- --schema /path/to/schema.graphql --out /tmp/infrahub-generated

development

update schema:

INFRAHUB_URL=http://localhost:8000 INFRAHUB_TOKEN=token ./scripts/update_schema.sh

generate a schema-specific client:

cargo run --bin infrahub-codegen -- --schema /path/to/schema.graphql --out /tmp/infrahub-generated