1//! Command-line arguments parsed at startup via clap.
2
3use std::path::PathBuf;
4
5use clap::Parser;
6
7use crate::theme::Theme;
8
9#[derive(Parser)]
10pub struct Args {
11    /// Path to the directory containing bare git repositories.
12    #[arg(long, default_value = ".")]
13    pub root: PathBuf,
14
15    /// Hostname shown in the breadcrumb and used to build clone URLs.
16    #[arg(long)]
17    pub hostname: Option<String>,
18
19    /// Path prefix prepended before the repository name in SSH clone URLs
20    /// (e.g. `repos/` or `/srv/git/`).
21    #[arg(long)]
22    pub ssh_prefix: Option<String>,
23
24    /// Built-in color theme.
25    #[arg(long, default_value = "auto")]
26    pub theme: Theme,
27
28    /// Path to a custom CSS file with theme variable overrides; takes
29    /// precedence over --theme if provided.
30    #[arg(long)]
31    pub theme_file: Option<PathBuf>,
32
33    /// Port to listen on.
34    #[arg(long, default_value = "3000")]
35    pub port: u16,
36
37    /// Address to bind the HTTP server to.
38    #[arg(long, default_value = "0.0.0.0")]
39    pub bind: String,
40
41    /// URL path prefix when served behind a reverse proxy (e.g. `/git`).
42    /// All generated URLs will be prefixed with this value.
43    #[arg(long)]
44    pub base_url: Option<String>,
45}