khelp 0.1.15

A tool for managing kubernetes contexts
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

use clap::{Parser, Subcommand, ValueHint};
use clap_complete::Shell;
use std::path::PathBuf;

#[derive(Parser)]
#[command(author, version, about, long_about = None)]
#[command(name = "khelp")]
#[command(about = "A tool to manage Kubernetes contexts")]
pub struct Cli {
    #[command(subcommand)]
    pub command: Option<Commands>,
}

#[derive(Subcommand)]
pub enum Commands {
    /// List all available contexts
    List,

    /// Get the current context
    Current,

    /// Switch to a different context
    Switch {
        #[arg(value_hint = ValueHint::Other)]
        context_name: Option<String>,
    },

    /// Edit a specific context
    Edit {
        #[arg(value_hint = ValueHint::Other)]
        context_name: Option<String>,
    },

    /// Export one or more contexts to stdout (can be redirected to a file)
    Export {
        /// Names of contexts to export (if none provided, interactive selection)
        #[arg(value_hint = ValueHint::Other, num_args = 0..)]
        context_names: Vec<String>,
    },

    /// Delete a specific context (also removes orphaned cluster and user)
    Delete {
        /// Name of the context to delete
        #[arg(value_hint = ValueHint::Other)]
        context_name: Option<String>,

        /// Skip confirmation prompt
        #[arg(long)]
        force: bool,
    },

    /// Clean up orphaned clusters and users not referenced by any context
    Cleanup {
        /// Skip confirmation prompt
        #[arg(long)]
        force: bool,
    },

    /// Rename a context
    Rename {
        /// Current name of the context
        #[arg(value_hint = ValueHint::Other)]
        old_name: String,

        /// New name for the context
        #[arg(value_hint = ValueHint::Other)]
        new_name: String,
    },

    /// Add contexts from an external kubeconfig file
    Add {
        /// Path to the kubeconfig file to import
        #[arg(value_hint = ValueHint::FilePath)]
        file_path: PathBuf,

        /// Rename conflicting entries by appending a suffix
        #[arg(long)]
        rename: bool,

        /// Overwrite existing entries with the same name
        #[arg(long)]
        overwrite: bool,

        /// Switch to the first newly added context after import
        #[arg(long)]
        switch: bool,
    },

    /// Generate or install shell completions
    Completions {
        #[arg(value_enum)]
        shell: Option<Shell>,
        #[arg(long)]
        install: bool,
    },

    /// Check for updates to khelp
    #[cfg(feature = "self_update")]
    Update {
        /// Apply the update if one is available
        #[arg(long)]
        apply: bool,
    },
}