auto-pr

A command line tool to perform bulk updates across multiple GitHub repositories.

How to install

With pipx (recommended):

pipx install auto-pr

With pip:

pip install auto-pr

Usage

Init

First initialise the project directory by running the init command within an empty directory.

auto-pr init --api-key=<github_token> --ssh-key-file=<path-to-ssh-key>

Where <github_token> is a GitHub personal access token which has repo and user:user:email scope.

Next modify the generated config.yaml file with your desired configurations.

credentials:
  api_key: <github_token>
  ssh_key_file: /path/to/ssh/key/to/push/.ssh/id_rsa
pr:
  body: >
    Body of the PR that will be generated

    Can be multi-line :)
  branch: auto-pr # The branch name to use when making changes
  message: Replace default pipelines with modules # Commit message
  title: 'My awesome change' # Title of the PR
repositories: # Rules that define what repos to update
  - mode: add
    match_owner: <org/user>
update_command:
  - touch
  - my-file

Repositories

You can define the list of repositories to pull and build into the database to update using a list of rules.

• mode - either add or remove - used to either match or negate
• public (optional) - pull only public or private, leave out for both
• archived (optional) - archived or non-archived, leave out for both
• match_owner (optional) - the owner or user to pull
• match_name (optional) - a list of regular expressions to match against to pull

The flags of the filter rules are optional not specifying will run the command on all repositories that the token has access too.

Update Command

This is the list containing the command to be executed along with the arguments passed to it. It will be executed from the root of each repository that is processed.

If an error occurs during the execution it will be displayed in the output but will not halt the execution.

See example commands

Pull

After you have configured the project you can now pull the repositories down that match your rules.

auto-pr pull

This will generate a db.json file within your workdir containing a list of mapped repositories and their state.

This command can be run multiple times, if there are new matching repositories found they will be merged into the existing database.

Test

Once the pull command has finished setting up the work directory you can now run test to check what the changes that will be made by the script will yield.

Run

When you're confident with the changes output from the test command you can finally execute run.

auto-pr run

This will perform the changes to a branch on the locally cloned repository and push the branch upstream with the information you provided within config.yaml.

See --help for more information about other commands and their usage.

Security

For sensitive security matters please contact security@getyourguide.com.

Legal

Copyright 2021 GetYourGuide GmbH.

auto-pr is licensed under the Apache License, Version 2.0. See LICENSE for the full text.