Skip to main content

repo-manager

Project description

repo-manager

Code style: black

repo-manager is a GitHub Action that manages your repository for you based on a configuration file in your repository.

Configuration

Usage

Inputs

repo-manager offers three inputs that you can use to configure its behavior. The only required input is github-token.

NOTE: The token you provide MUST have full admin permissions on your repo. The built-in GitHub Actions token will not work.

  1. github-token (required) : The OAuth token that repo-manager should use.
    • This token MUST have full admin permissions on your repo. Because of this, the built-in GitHub Actions token will not work.
    • NOTE: Make sure that you never put tokens in your workflow files directly. Always use GitHub Secrets to store these values.
  2. config-file (optional) : The location of the config file that repo-manager should use. By default, repo-manager assumes that your config file is where Probot Settings needs it to be (.github/settings.yml). If you want to put your config file somewhere else in your repo, you can control that using this value.
  3. debug (optional) : If you set this value to true, repo-manager will output more granular logs.

Examples

To use repo-manager, simply define a step in your workflow, providing your GitHub Token.

- uses: mattsb42/repo-manager@v1
  with:
    github-token: ${{ secrets.ADMIN_GITHUB_TOKEN }}

If you want to enable debug logging or use a special config file location, you indicate that with the other input values.

- uses: mattsb42/repo-manager@v1
  with:
    github-token: ${{ secrets.ADMIN_GITHUB_TOKEN }}
    config-file: .github/config/repository.yaml
    debug: true

Design Goals

repo-manager was inspired by Probot Settings but is designed to solve two issues with that app:

  1. Permissions : Out of necessity, Probot Settings requires you to either hand over administrator control of your repository to the Probot app or to run an instance of the app yourself. Granting these permissions is not always possible, and running your own app is extra overhead that I would rather not have to deal with.

    • repo-manager solves this problem by running as a GitHub Action using the credentials that you provide.
  2. Debugging : Probot Settings lacks a feedback mechanism to let you know when it ran and what happened. This is especially frustrating if you are attempting to debug a bad config, when the only feedback you can get is that nothing happened.

    • Because repo-manager runs as a GitHub Action, you can see exactly when it ran and what happened.

Because it runs as a GitHub Action, you can also exert more fine control over when repo-manager runs, rather than simply running on any pushes to your default branch.

repo-manager is fully backwards compatible with Probot Settings config files, but will expand in the future to support more repository administration features.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

github_repo_manager-1.1.0-py2.py3-none-any.whl (23.9 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file github_repo_manager-1.1.0-py2.py3-none-any.whl.

File metadata

  • Download URL: github_repo_manager-1.1.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 23.9 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.8.2

File hashes

Hashes for github_repo_manager-1.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 6153bcbb84ade37b439dbb3560c2c700e007496997e202e2aa351015a681220f
MD5 9b13b794d8d033db8138b9372a7a78c1
BLAKE2b-256 db8d1890ed9621e1508c5494b851aeb082a25de097ef050a9ab8b120a50e120b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page