Struct Cli 

pub struct Cli;

A simple CLI struct for building the SSG command.

Implementations

impl Cli

pub fn build() -> Command

Builds the legacy flag-style clap::Command.

Preserved so the deprecation shim, existing examples, and the already-shipped CI invocations keep working through the 0.0.x line. Removed in 1.0 per issue #527 AC7.

Examples

use ssg::cmd::Cli;

let cmd = Cli::build();
assert!(cmd.get_name().contains("ssg") || !cmd.get_name().is_empty());

pub fn subcommand_app() -> Command

Builds the subcommand-style clap::Command (issue #527).

Surface:

ssg <SUBCOMMAND> [OPTIONS]

Development:
  dev      Start the dev server with file watching

Build:
  build    Produce a static site under the configured output dir

Validate:
  check    Run validators (read-only) and exit

Deploy:
  deploy   Build and ship to a pluggable target

Each subcommand carries the same --config / --output / … option pile so existing scripts can be ported one-to-one.

Examples

use ssg::cmd::Cli;

let app = Cli::subcommand_app();
let names: Vec<_> = app.get_subcommands().map(|c| c.get_name()).collect();
assert!(names.contains(&"build"));
assert!(names.contains(&"dev"));

pub fn parse_and_dispatch<I, T>( argv: I, ) -> Result<(CliInvocation, ArgMatches), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Routes argv to either the subcommand parser or the legacy flag parser.

The contract:

• If argv[1] matches a known subcommand (build, dev, check, deploy, help), parses with the new surface.
• Otherwise, falls back to the legacy parser and prints LEGACY_DEPRECATION_WARNING to stderr (issue #527 AC5, except when no args were supplied at all — bare ssg is silent and behaves like the prior 0.0.42 default).

Returns a (CliInvocation, ArgMatches) pair so the caller can reuse the existing SsgConfig::from_matches / RunOptions::from_matches helpers.

Examples

use ssg::cmd::{Cli, CliInvocation};

let (inv, _matches) = Cli::parse_and_dispatch(vec!["ssg", "build"])
    .expect("parses");
assert!(matches!(inv, CliInvocation::Build));

Errors

Returns the underlying clap::Error if parsing fails — the caller is expected to print it and exit non-zero.

pub fn print_banner()

Displays the application banner

Examples

use ssg::cmd::Cli;

// Prints to stdout — runnable in a doctest, no panics.
Cli::print_banner();

Trait Implementations

impl Clone for Cli

fn clone(&self) -> Cli

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Cli

impl Debug for Cli

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Cli

fn default() -> Cli

Returns the “default value” for a type.