optional-referenced-request-bodies-custom-commands

name	optional-referenced-request-bodies-custom-commands
description	How to author custom commands for the optional-referenced-request-bodies CLI using the co-generated SDK.

Custom Commands for optional-referenced-request-bodies

Overview

The optional-referenced-request-bodies CLI supports user-authored custom commands that are compiled into the binary alongside the auto-generated API commands. Custom commands get a fully-wired SDK client that inherits the CLI's auth, retries, TLS, base URL, and global headers — zero configuration required.

Architecture

cli/optional-referenced-request-bodies/custom.rs    ← Your command handlers (protected by .fernignore)
cli/optional-referenced-request-bodies/sdk.rs       ← Generated bridge: client() + block_on()
cli/optional-referenced-request-bodies/main.rs      ← Generated entrypoint (calls custom::register)
optional-referenced-request-bodies-sdk/             ← Co-generated typed SDK crate
optional-referenced-request-bodies-types/           ← Co-generated typed model crate

Adding a Custom Command

1. Edit cli/optional-referenced-request-bodies/custom.rs

This file is protected by .fernignore — fern generate will never overwrite it. Register commands in the register() function:

use optional_referenced_request_bodies_sdk::api::*;

pub fn register(app: CliApp) -> CliApp {
    let app = app.command(
        clap::Command::new("my-command")
            .()
            .(clap::Arg::().()),
        |matches, ctx| {
              = matches.get_one::<>().();
              = super::sdk::(ctx);
              = super::sdk::(
                client.resource.(id),
            )?;
            (, serde_json::(&result).());
            (())
        },
    );
    app
}