giti 0.1.3

A tool to easily query Git repos for basic information. Can be used via CLI or as a library.
Documentation 
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

use clap::{Parser, Subcommand, ValueEnum};
use std::path::PathBuf;

#[derive(Parser)]
#[command(name = "giti")]
#[command(
    author,
    version,
    about = "A CLI tool to get git repository information"
)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Option<Commands>,
}

#[derive(Subcommand)]
pub enum Commands {
    /// Clone a git repository to $HOME/Repos
    Clone {
        /// Repository URL to clone (can also be provided via stdin or clipboard)
        url: Option<String>,
    },
    /// Show repository information (default behavior)
    Info(InfoArgs),
    /// Open repository URLs in the browser
    Open(OpenArgs),
}

#[derive(Parser, Default)]
#[expect(
    clippy::struct_excessive_bools,
    reason = "Many bools make sense for CLI flags"
)]
pub struct InfoArgs {
    /// Print repo urls
    #[arg(short = 'r', long = "repo-urls")]
    pub repo_urls: bool,

    /// Print last update by git commit
    #[arg(short = 'u', long = "last-update")]
    pub last_update: bool,

    /// Print last fetch attempt date
    #[arg(short = 'f', long = "last-fetch")]
    pub last_fetch: bool,

    /// Print git repo size
    #[arg(short = 'g', long = "repo-size")]
    pub repo_size: bool,

    /// Print total working dir size
    #[arg(short = 's', long = "size")]
    pub size: bool,

    /// Print as TSV (Tab Separated Values)
    #[arg(short = 't', long = "tsv")]
    pub tsv: bool,

    /// Repository paths to analyze (defaults to current directory)
    pub paths: Vec<PathBuf>,
}

impl InfoArgs {
    pub fn setup_defaults(&mut self) {
        // If no flags specified, enable all info flags
        if !self.repo_urls && !self.last_update && !self.last_fetch && !self.repo_size && !self.size
        {
            self.repo_urls = true;
            self.last_update = true;
            self.last_fetch = true;
            self.repo_size = true;
            self.size = true;
        }
    }
}

#[derive(Parser)]
pub struct OpenArgs {
    /// The page to open
    #[arg(value_enum, default_value = "repo")]
    pub page: OpenPage,

    /// Override the forge/service to use (e.g., github, gitlab, bitbucket)
    #[arg(long = "forge", visible_alias = "service", visible_alias = "site")]
    pub forge: Option<String>,

    /// Remote name to use (defaults to "origin")
    #[arg(short = 'r', long = "remote", default_value = "origin")]
    pub remote: String,

    /// Repository path (defaults to current directory)
    pub path: Option<PathBuf>,
}

#[derive(ValueEnum, Clone, Default, Debug)]
pub enum OpenPage {
    /// The main repository page
    #[default]
    Repo,
    /// The code/source page (same as repo on most forges)
    Code,
    /// The author/organization page
    #[value(alias = "org")]
    Author,
    /// The issues/bug tracker page
    Issues,
    /// The pull requests page
    #[value(alias = "pull-requests", alias = "prs", alias = "mrs")]
    Pulls,
    /// The wiki page
    Wiki,
    /// The commits listing
    Commits,
    /// The branches listing
    Branches,
    /// The tags listing
    Tags,
    /// The releases page
    Releases,
}