README.md

Kamino is a dotnet tool to clone an organisation from GitLab

Getting Started

Install kamino as a global dotnet tool

dotnet tool install kamino -g

or update it with

dotnet tool update kamino

or as a dotnet local tool

dotnet new tool-manifest
dotnet tool install kamino

Quickstart

Run kamino:

kamino -b my-gitlab.com -o C:\Development\Git\ -g 42 -t xT0K3Nx4CC355x

Usage

You can also get this with dotnet kamino help.

Kamino                                GitLab Organisation Cloner
----------------------------------------------------------------
EXAMPLE: kamino -b my-gitlab.com -o C:\Development\Git\ -g 42 -t xT0K3Nx4CC355x

USAGE: kamino [--help] --baseaddress <string> --group <string> --output <string> --token <string> [--include <string>]
              [--exclude <string>] [--printonly]

OPTIONS:

    --baseaddress, -b <string>
                          specify your gitlab instance base address
    --group, -g <string>  specify the group name or id to clone recursively
    --output, -o <string> specify the output folder to clone to
    --token, -t <string>  specify your access token
    --include, -i <string>
                          exclude all repositories but include matching
    --exclude, -e <string>
                          include all repositories but exclude matching
    --printonly, -p       print theorical path without actually cloning
    --help                display this list of options.

Contributing

Help and feedback is always welcome and pull requests get accepted.

Here is the contribution flow (more information on datascholl.io):

• Open or answer an issue to discuss the changes
• Fork the project after the change has been formally approved
• Create a feature branch
• Follow the code convention by examining existing code (mostly Microsoft's guidelines)
• Edit the code with the changes
• Add/modify unit tests as required
• Submit your PR against the main branch

PRs can only be approved and merged when all checks succeed (builds on Windows, MacOs and Linux)

Alternatives

• GitLabber - clones or pulls entire groups tree from gitlab
• Ghorg - clone an entire org/users repositories into one directory
• Related SO Q&A - How to clone all projects of a group at once in GitLab?

License

• Marble icon is licensed as Creative Commons CCBY by Monjin Friends from the Noun Project.
• MIT