rust

Vovk.ts Rust client

vovk-rust generates typed Rust crate from same .vovk-schema/ artifacts driving TS client. Async by default via reqwest + tokio; streaming via futures.

Experimental — generated API may shift between Vovk versions. Pin crate version on consume.

Scope

Covers:

• Install vovk-rust + generate Rust crate.
• Templates: rs (standalone crate) vs rsSrc (source files to embed).
• Auto-gen config in vovk.config.mjs.
• Async call shape + nested-module _:: type convention.
• JSON Lines streaming via futures::Stream.
• Client-side validation toggle.
• crates.io publishing flow.

Out of scope:

• Procedure / controller authoring → procedure skill.
• vovk bundle general (TS, Python) → bundle skill.
• Server-side JSON Lines → jsonlines skill.

Install + generate

npm i -D vovk-rust

Standalone crate

Canonical output dir ./dist_rust (hello-world convention):

npx vovk generate --from rs --out ./dist_rust

Output:

dist_rust/
  src/http_request.rs       # HTTP handling
  src/lib.rs                # RPC functions + types
  src/read_full_schema.rs   # Schema utilities
  src/schema.json           # Vovk schema (read at runtime via CARGO_MANIFEST_DIR/src/schema.json)
  Cargo.toml                # edition = "2021"
  README.md

Embedded source

npx vovk generate --from rsSrc --out ./rust_src

Auto-generate with composed client

// vovk.config.mjs
const config = {
  composedClient: {
    fromTemplates: ['js', 'rs'],
  },
};
export default config;

Bake prod API URL via clientTemplateDefs.rs.outputConfig.origin — generated crate uses this by default. Pattern from hello-world:

// vovk.config.js
const PROD_ORIGIN = 'https://hello-world.vovk.dev';

const config = {
  composedClient: { fromTemplates: ['js', 'rs'] },
  clientTemplateDefs: {
    rs: {
      extends: 'rs',
      outputConfig: { origin: PROD_ORIGIN },
      // composedClient: { outDir: './my_other_dir' }, // optional — defaults to ./dist_rust
    },
  },
};