kingfisher-bin 2.8.0

MongoDB's blazingly fast and accurate secret scanning and validation tool
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

use clap::{Args, Subcommand, ValueEnum, ValueHint};
use strum::Display;
use url::Url;

use crate::cli::commands::output::{GitHubOutputFormat, OutputArgs};

/// Top-level GitLab command group
#[derive(Args, Debug)]
pub struct GitLabArgs {
    #[command(subcommand)]
    pub command: GitLabCommand,

    /// Override GitLab API URL (e.g. Enterprise)
    #[arg(global = true, long, default_value = "https://gitlab.com/", value_hint = ValueHint::Url)]
    pub gitlab_api_url: Url,
}

#[derive(Subcommand, Debug)]
pub enum GitLabCommand {
    /// Interact with GitLab repositories
    #[command(subcommand)]
    Repos(GitLabReposCommand),
}

#[derive(Subcommand, Debug)]
pub enum GitLabReposCommand {
    /// List repositories for a user or group
    List(GitLabReposListArgs),
}

/// `kingfisher gitlab repos`
#[derive(Args, Debug, Clone)]
pub struct GitLabReposListArgs {
    #[command(flatten)]
    pub repo_specifiers: GitLabRepoSpecifiers,

    #[command(flatten)]
    pub output_args: OutputArgs<GitLabOutputFormat>,
}

/// Options for selecting GitLab repos
#[derive(Args, Debug, Clone)]
pub struct GitLabRepoSpecifiers {
    /// Repositories belonging to these users
    #[arg(long, alias = "gitlab-user")]
    pub user: Vec<String>,

    /// Include accessible personal snippets for users and snippets in selected projects
    #[arg(long)]
    pub include_snippets: bool,

    /// Repositories belonging to these groups
    #[arg(long, alias = "gitlab-group")]
    pub group: Vec<String>,

    /// Skip specific repositories when enumerating GitLab sources (format: group/project)
    #[arg(
        long = "gitlab-exclude",
        alias = "gitlab-exclude-project",
        alias = "gitlab-exclude-repo",
        value_name = "GROUP/PROJECT"
    )]
    pub exclude_repos: Vec<String>,

    /// Repositories for all groups (Enterprise only)
    #[arg(long, alias = "all-groups", alias = "all-gitlab-groups", requires = "api_url")]
    pub all_groups: bool,

    /// Filter by repository type
    #[arg(long, default_value_t = GitLabRepoType::All, alias = "gitlab-repo-type")]
    pub repo_type: GitLabRepoType,

    /// Include repositories from subgroups of the specified groups
    #[arg(long, alias = "gitlab-include-subgroups")]
    pub include_subgroups: bool,
}

impl GitLabRepoSpecifiers {
    /// Check if no GitLab sources are specified
    pub fn is_empty(&self) -> bool {
        self.user.is_empty() && self.group.is_empty() && !self.all_groups
    }
}

/// GitLab repository type filter
#[derive(Copy, Clone, Debug, Display, PartialEq, Eq, PartialOrd, Ord, ValueEnum)]
#[strum(serialize_all = "kebab-case")]
pub enum GitLabRepoType {
    /// All repositories the user/group has access to
    All,
    /// Only repositories owned by the user/group
    Owner,
    /// Only repositories where the user is a member
    Member,
}

/// Output formats for GitLab commands - reusing GitHub's formats
pub type GitLabOutputFormat = GitHubOutputFormat;

impl From<GitLabRepoType> for crate::gitlab::RepoType {
    fn from(val: GitLabRepoType) -> Self {
        match val {
            GitLabRepoType::All => crate::gitlab::RepoType::All,
            GitLabRepoType::Owner => crate::gitlab::RepoType::Owner,
            GitLabRepoType::Member => crate::gitlab::RepoType::Member,
        }
    }
}