Clone all your repositories and apply sweeping changes.

pip install all-repos

A configuration file looks roughly like this:

{
    "output_dir": "output",
    "source": "all_repos.source.github",
    "source_settings":  {
        "api_key": "...",
        "username": "asottile"
    },
    "push": "all_repos.push.github_pull_request",
    "push_settings": {
        "api_key": "...",
        "username": "asottile"
    }
}

• output_dir: where repositories will be cloned to when all-repos-clone is run.
• source: the module import path to a source, see below for builtin source modules as well as directions for writing your own.
• source_settings: the source-type-specific settings, the source module's documentation will explain the various possible values.
• push: the module import path to a push, see below for builtin push modules as well as directions for writing your own.
• push_settings: the push-type-specific settings, the push module's documentation will explain the various possible values.
• include (default ""): python regex for selecting repositories. Only repository names which match this regex will be included.
• exclude (default "^$"): python regex for excluding repositories. Repository names which match this regex will be excluded.

Clones all repositories listed in a file. The file must be formatted as follows:

{
    "example/repo1": "https://git.example.com/example/repo1",
    "repo2": "https://git.example.com/repo2"
}

• filename: file containing repositories one-per-line.

output/
+--- repos.json
+--- repos_filtered.json
+--- {repo_key1}/
+--- {repo_key2}/
+--- {repo_key3}/
+--- {repo_key4}/

Clones all repositories available to a user on github.

• api_key: the api key which the user will log in as.
  • Use the settings tab to create a personal access token.
  • The minimum scope required to function is public_repo, though you'll need repo to access private repositories.
• username: the github username you will log in as.

• collaborator (default false): whether to include repositories which are not owned but can be contributed to as a collaborator.
• forks (default false): whether to include repositories which are forks.
• private (default false): whether to include private repositories.

output/
+--- repos.json
+--- repos_filtered.json
+--- {username1}/
    +--- {repo1}.git/
    +--- {repo2}.git/
    +--- {repo3}.git/
+--- {username2}/
    +--- {repo4}.git/

First create a module. This module must have the following api:

This class will receive keyword arguments for all values in the source_settings dictionary.

An easy way to implement the Settings class is by using a namedtuple:

Settings = collections.namedtuple('Settings', ('required_thing', 'optional'))
Settings.__new__.__defaults__ = ('optional default value',)

In this example, the required_thing setting is a required setting whereas optional may be omitted (and will get a default value of 'optional default value').

This callable will be passed an instance of your Settings class. It must return a mapping from {repo_name: repository_url}. The repo_name is the directory name inside the output_dir.

Merges the branch directly to master and pushes. The commands it runs look roughly like this:

git checkout master
git pull
git merge --no-ff $BRANCH
git push origin HEAD

There are no configurable settings for merge_to_master.

Pushes the branch to origin and then creates a github pull request for the branch.

• api_key: the api key which the user will log in as.
  • Use the settings tab to create a personal access token.
  • The minimum scope required to function is public_repo, though you'll need repo to access private repositories.
• username: the github username you will log in as.

First create a module. This module must have the following api:

This class will receive keyword arguments for all values in the push_settings dictionary.

This callable will be passed an instance of your Settings class. It should deploy the branch. The function will be called with the root of the repository as the cwd.

TODO

TODO