CLI Development

The bucky CLI is a Rust binary that sets up workflows in target repos via the GitHub API. Source code is in cli/.

Prerequisites

• Rust toolchain (stable)
• GitHub CLI (gh) installed and authenticated

Commands

cd cli
make build       # cargo build --release (binary: target/release/bucky)
make test        # cargo test (unit + integration)
make lint        # cargo clippy -- -D warnings
make fmt         # cargo fmt
make fmt-check   # cargo fmt --check
make install     # build + copy binary to /usr/local/bin/bucky

Run a single test:

cd cli && cargo test <test_name>

Module structure

Module	File	Purpose
main	src/main.rs	Entry point, error handling
cli	src/cli.rs	Arg parsing (clap), workflow enum, repo format validation, git remote detection
preset	src/preset.rs	Preset enum, config loading from embedded presets.json
detect	src/detect.rs	Auto-detect project type (checks for go.mod, package.json)
templates	src/templates.rs	Embedded workflow templates with __PRESET__ and @main → @v{major} substitution
version	src/version.rs	Version constants from VERSION file via build.rs
github	src/github.rs	GitHub API interactions via octocrab
prompt	src/prompt.rs	Interactive preset selection via dialoguer
pr_body	src/pr_body.rs	PR description generation
labels	src/labels.rs	Label creation/management
output	src/output.rs	Output formatting

Key patterns

• Error handling: anyhow::Result throughout; errors bubble up to main() which prints and exits with code 1
• Async: Single-threaded tokio runtime (current_thread) for GitHub API calls
• Testing: Unit tests inline in source files, integration tests in cli/tests/integration.rs using assert_cmd and predicates
• Auth: Relies on gh CLI being installed and authenticated
• Compile-time embedding: presets.json is embedded via include_str! and parsed into a LazyLock<HashMap> static; workflow templates embedded similarly; version from VERSION file via build.rs
• Dry-run: --dry-run flag previews all changes without writing to the remote