brk_bindgen

Code generation for BRK client libraries.

What It Enables

Generate typed client libraries for Rust, JavaScript, and Python from the OpenAPI specification. Keeps frontend code in sync with available metrics and API endpoints without manual maintenance.

Key Features

• Multi-language: Generates Rust, JavaScript, and Python clients
• OpenAPI-driven: Extracts endpoints and schemas from the OpenAPI spec
• Metric catalog: Includes all metric IDs and their supported indexes
• Type definitions: Generates types/interfaces from JSON Schema
• Selective output: Generate only the languages you need

Core API

use brk_bindgen::{generate_clients, ClientOutputPaths};

let paths = ClientOutputPaths::new()
    .rust("crates/brk_client/src/lib.rs")
    .javascript("modules/brk-client/index.js")
    .python("packages/brk_client/brk_client/__init__.py");

generate_clients(&vecs, &openapi_json, &paths)?;

Generated Clients

Each client includes:

• All REST API endpoints as typed functions
• Complete metric catalog with index information
• Type definitions for request/response schemas

Built On

• brk_query for metric enumeration
• brk_types for type schemas