git-project 0.2.0

Manage piles of git repositories with ease!
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
121
122
123
124

use std::{ffi, path};
use structopt::{clap, StructOpt};

/// A manager for all of your git projects
#[derive(StructOpt)]
pub struct Options {
    #[structopt(flatten)]
    pub command: Command,
}

#[derive(StructOpt)]
pub struct BaseOptions {
    /// The base directory that all of your repositories are inside
    #[structopt(
        short = "-d",
        long = "--base-dir",
        env = "GIT_PROJECT_BASE_DIR",
        parse(try_from_os_str = "parse_canonical_path")
    )]
    pub base_dir: path::PathBuf,
}

#[derive(StructOpt)]
pub enum Command {
    /// Clone a new project into a folder based on the remote URL
    #[structopt(name = "clone")]
    Clone(CloneOptions),

    /// List all repositories under the base path
    #[structopt(name = "list")]
    List(ListOptions),

    /// Check all repositories under the base path to ensure the are up to date with remotes
    #[structopt(name = "check")]
    Check(CheckOptions),

    /// Organize an existing directory of git repositories into a normalized format based on remotes
    #[structopt(name = "organize")]
    Organize(OrganizeOptions),

    /// Generate CLI completions for your shell of choice
    #[structopt(name = "gen-completions")]
    GenCompletions(CompletionOptions),
}

#[derive(StructOpt)]
pub struct CloneOptions {
    #[structopt(flatten)]
    pub base: BaseOptions,

    /// Print the clone location for the given URL and exit
    #[structopt(short = "-n", long = "--dry-run")]
    pub only_print_location: bool,

    /// The URL of the project to be cloned. Can be URL or ssh path
    #[structopt(name = "URL")]
    pub clone_url: String,
}

#[derive(StructOpt)]
pub struct ListOptions {
    #[structopt(flatten)]
    pub base: BaseOptions,

    #[structopt(flatten)]
    pub list: BaseListOptions,
}

#[derive(StructOpt)]
pub struct BaseListOptions {
    /// Do not stop recursing when a .git folder is found
    #[structopt(short = "-r", long = "--deep-recurse")]
    pub deep_recurse: bool,
}

#[derive(StructOpt)]
pub struct CheckOptions {
    #[structopt(flatten)]
    pub list: BaseListOptions,

    #[structopt(flatten)]
    pub base: BaseOptions,

    /// Print a summary of the repositories
    #[structopt(short = "-s", long = "--summarize")]
    pub summarize: bool,
}

#[derive(StructOpt)]
pub struct OrganizeOptions {
    /// Directory to organize
    #[structopt(name = "DIR", parse(from_os_str))]
    pub dir: path::PathBuf,

    /// Directory to place organized repositories in
    #[structopt(name = "NEW_DIR", parse(from_os_str))]
    pub new_dir: path::PathBuf,

    /// Print out the folders that will be moved without actually moving anything
    #[structopt(short = "-n", long = "--dry-run")]
    pub dry_run: bool,
}

#[derive(StructOpt)]
pub struct CompletionOptions {
    /// The shell that the completions will be compatible with
    #[structopt(
        name = "SHELL",
        raw(
            possible_values = "&clap::Shell::variants()",
            case_insensitive = "true"
        )
    )]
    pub shell: clap::Shell,
}

fn parse_canonical_path(path_str: &ffi::OsStr) -> Result<path::PathBuf, ffi::OsString> {
    path::Path::new(path_str).canonicalize().map_err(|err| {
        ffi::OsString::from(format!(
            "Unable to recognize base directory as absolute path: {}",
            err
        ))
    })
}