diff options
| author | Max Audron <audron@cocaine.farm> | 2022-07-06 12:20:44 +0200 |
|---|---|---|
| committer | Max Audron <audron@cocaine.farm> | 2022-07-06 12:30:04 +0200 |
| commit | bd79c7f8f1128d94c266aab3250b4081967d5466 (patch) | |
| tree | db950de759a6ed0034fbcdcee5ad602c1fad0c9e | |
| parent | paginate results from gitlab api (diff) | |
release 1.0.1
- fix gitlab api not returning all results
| -rw-r--r-- | Cargo.toml | 2 | ||||
| -rw-r--r-- | README.md | 56 |
2 files changed, 57 insertions, 1 deletions
@@ -1,7 +1,7 @@ [package] name = "gtree" description = "A tool to clone and pull whole group trees from a git forge, properly organized on disk." -version = "1.0.0" +version = "1.0.1" edition = "2021" authors = ["Max Audron <audron@cocaine.farm>"] license = "ISC" diff --git a/README.md b/README.md new file mode 100644 index 0000000..5f5e4c7 --- /dev/null +++ b/README.md @@ -0,0 +1,56 @@ + +# Table of Contents + +1. [Usage](#org86116bf) +2. [Config](#org4e7be59) + +A tool to clone and pull whole group trees from a git forge, properly organized on disk. + + +<a id="org86116bf"></a> + +# Usage + + gtree + Sync Gitlab Trees + + USAGE: + gtree <SUBCOMMAND> [SCOPE] + + ARGS: + <SCOPE> Only operate on this subtree + + OPTIONS: + -h, --help Print help information + -j, --jobs <JOBS> Number of jobs to run in parallel, 0 is automatic [default: 0] + + SUBCOMMANDS: + help Print this message or the help of the given subcommand(s) + list List Directories + sync Download new repositories and delete old ones, also update + update Pull and Push new commits to and from the cloned repos + + +<a id="org4e7be59"></a> + +# Config + +Default location for the config file is `$HOME/.config/gtree/config.toml`, in the toml format, yaml is also supported. + + # Give the forge a easily identifiable name + ["gitlab.com"] + # Configure which kind of forge this is + # Currently only gitlab is supported + type = "gitlab" + + # Set the domain name to reach the forge at + host = "gitlab.com" + + # API Token for the forge + # for gitlab this is a Personal Access Token + # https://gitlab.com/-/profile/personal_access_tokens + token = "HgDAfJ9tfD5xUw2L6SUm" + + # Directory to clone the repos into + directory = "/home/audron/repo/gitlab.com" + |
