A "glutton" Gopher mutant 🧟‍♂️ that helps in cloning massively certain (or all) repositoriesof a given GitHub organization.
Use it with precautions.

It was created due to some lazziness and the need to clone all the repositories of a given organization. If you are looking for a more in-depth explanation of the project, sorry there isn't. 🤷🏻‍♀️ Some important details:

• It is a CLI tool.
• The term 'organization' and 'owner', in the context of GitHub, are used interchangeably.
• Depending on the size (amount of repositories) of the organization, the cloning process can take a while.

It browses through all the repositories of a given organization and clones them locally. It also creates a glonner.json file with the information of the repositories that were cloned. This file is used to keep track of the repositories that were cloned and to avoid cloning them again. If you want to clone all the repositories again, you can use the --force flag.

These options are required, in order to operate with the above commands.

NOTE: For the clone command, it's supported the dry-run option, set with the flag --dry-run. This option will print the list of repositories that would be cloned, without actually cloning them.

(back to top)

There are some prerequisites to get started with this project. Ready and follow the instructions below.

Follow this guide to setup the project locally.

If you want to clone repositories, it is as simple as running:

$ glonner clone --org="gruntwork-io" --token="your-token"

or

$ GITHUB_ORG="gruntwork-io" GITHUB_TOKEN="your-token" glonner clone

If you only want to list, and take a look to a given set of repositories, within an organization, you can run:

$ glonner list --org="gruntwork-io" --token="your-token"

or

$ GITHUB_ORG="gruntwork-io" GITHUB_TOKEN="your-token" glonner list

NOTE: For advanced options, and more information, please refer to the help command, running: glonner --help.

(back to top)

brew tap Excoriate/homebrew-tap
brew install glonner

Or, if you have TaskFile installed, it's the same method, just wrapping it with it:

task install

• ❤️ Add Daeger as a 'portable' approach for CI and CD respectively.
• ❤️ Add Unit Test coverage.
• ❤️ Add a built-in configuration, using 'Viper', to keep tack of local repositories cloned.
• ❤️️ Add a way to selectively clone repositories, based on a given set of criteria.
• ❤️️ Allow custom output formats. Currently, it's supporting only 'table'. Potential formats: 'json', 'yaml', 'csv', etc.
• ❤️️ Add a storage/capacity check, for larger organizations and less-space-in-disk sort of machines.

See the open issues for a full list of proposed features (and known issues). Also, your contributions are more than welcome — just ensure following the contributing guidelines.

(back to top)

• 📧 Email: Alex T.
• 🧳 Linkedin: Alex T.

made/with ❤️ 🤟