smidr 0.7.0

Smidr is a cargo-inspired build tool for C projects, meant to bridge dependencies across different build systems into a single build.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

// SPDX-License-Identifier: MIT OR Apache-2.0
// Copyright (c) 2026 Max-Mend
// This file is part of smidr: https://github.com/Max-Mend/smidr

//! Command-line argument definitions.
//!
//! This module only parses arguments - it has no knowledge of how
//! commands are executed. Dispatching a parsed [`Commands`] to the
//! right function is [`crate::main`]'s job, kept separate so the CLI
//! layer can be tested (or replaced) independently of the underlying
//! logic.

use crate::config::{CStandard, ProjectType};
use clap::{Parser, Subcommand};

/// Top-level CLI definition for the `smidr` binary.
#[derive(Parser)]
#[command(name = "Smidr", version = "0.7.0", long_about = None)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Commands,
}

/// The available `smidr` subcommands.
#[derive(Subcommand)]
pub enum Commands {
    /// Scaffold a new project.
    #[command(alias = "n")]
    New {
        name: String,
        /// Explicit project kind: `static` or `dynamic`. Cannot be
        /// combined with `--lib`. Defaults to a binary if neither this
        /// nor `--lib` is given.
        #[arg(long, value_enum, conflicts_with = "lib")]
        r#type: Option<ProjectType>,
        /// Shorthand for `--type static` — scaffold a library instead of
        /// a binary (the common case; use `--type dynamic` if you
        /// specifically need a shared object).
        #[arg(long)]
        lib: bool,
        /// Specify the C standard to use (e.g., c99, c11, c17, c23).
        /// Defaults to c17.
        #[arg(long, value_enum)]
        std: Option<CStandard>,
    },
    /// Compile the current project.
    #[command(alias = "b")]
    Build {
        #[arg(long)]
        release: bool,
    },
    /// Compile and run the current project.
    #[command(alias = "r")]
    Run {
        #[arg(long)]
        release: bool,
    },
    /// Remove the `target/` build directory.
    #[command(alias = "cl")]
    Clean,
    /// Clean, then compile the current project from scratch.
    #[command(alias = "rb")]
    Rebuild {
        #[arg(long)]
        release: bool,
    },
    /// Format project source and header files with clang-format.
    #[command(alias = "fmt")]
    Format,
    /// Add a dependency to the project.
    #[command(alias = "a")]
    Add { name: String },
    /// Remove a dependency from the project.
    #[command(alias = "rm")]
    Remove { name: String },

    // TODO: Add:
    // Analyze, // analyze code
    // Lint, // lint code
    // Update, // update smidr
}

/// Parse `std::env::args()` into a [`Cli`], exiting the process with a
/// usage message on invalid input (standard `clap` behavior).
pub fn parse_args() -> Cli {
    Cli::parse()
}