CLI & Testing

cargo artisan

cargo install rustasea        # ships the cargo-rustasea binary
cargo artisan list            # 37 default commands, plus feature-gated mcp:serve
cargo artisan list --json     # machine-readable metadata

cargo rustasea is the cargo subcommand; cargo artisan is the in-app alias.

Generators

17 scaffolds. {name} is PascalCase (snake_case for make:migration); --force overwrites.

cargo artisan make:controller UserController --resource
cargo artisan make:model Post --migration
cargo artisan make:request StorePostRequest
cargo artisan make:job SendWelcomeEmail
cargo artisan make:test PostFeatureTest --browser

Also available: make:middleware, make:provider, make:command, make:event, make:listener, make:observer, make:seeder, make:agent, make:tool, make:action, make:module.

Modules

Module state is discovered from modules/<name>/ and persisted in the [modules] table of rustasea.toml (or config/modules.toml). Enabling an unknown name is rejected before the manifest is written.

cargo artisan module:list --json
cargo artisan module:enable billing
cargo artisan module:disable billing

The Module contract plus a deterministic ModuleRegistry mounts each enabled module's routes, providers, and migrations. Opt-in via the modules feature.

Action pattern

One typed unit of work runs through four adapters with an identical validate → authorize → handle pipeline:

Opt-in via the action feature; scaffold one with make:action.

Localization and logging

Testing

cargo test --workspace
cargo test -p rustasea --features integration -- --ignored

Console UX

Commands declare typed args and flags through clap, and the console layer supports ask, secret, confirm, choice, and multiSelect prompts, plus table, progressBar, and spinner output, graceful shutdown via Shutdownable, and programmatic Artisan::call().