automatic-contrib-prs
Automatically open a pull request for repositories that have no CONTRIBUTING.md file for a targeted set of repositories.
What this repository does
This code is for a GitHub Action that opens pull requests in the repositories that have a specified repository topic and also don't have a CONTRIBUTING.md file.
Why would someone do this
It is desirable, for example, for all Open Source and InnerSource projects to have a CONTRIBUTING.md file that specifies for new contributors what the processes and procedures are for making a new contribution. This has been done in some large GitHub customers organizations.
How it does this
- It pulls a list of labelled repositories from a
repos.jsonwhich can be generated by the InnerSource-Crawler GitHub Action. - It opens a pull request in each of those repositories which adds the
CONTRIBUTING.mdfile with some template contents.
Use as a GitHub Action
- Create a repository to host this GitHub Action or select an existing repository.
- Create the env values from the sample workflow below (GH_TOKEN, GH_ACTOR, PR_TITLE, PR_BODY, and ORGANIZATION) with your information as repository secrets. More info on creating secrets can be found here. Note: Your GitHub token will need to have read/write access to all the repositories in the
repos.jsonfile. - Copy the below example workflow to your repository and put it in the
.github/workflows/directory with the file extension.yml(ie..github/workflows/auto-contrib-file.yml)
Example workflow
name: Find proper repos and open CONTRIBUTING.md prs
on:
workflow_dispatch:
jobs:
build:
name: Open CONTRIBUTING.md in OSS if it doesnt exist
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/[email protected]
- name: Find OSS repository in organization
uses: docker://ghcr.io/zkoppert/innersource-crawler:v1
env:
GH_TOKEN: ${{ secrets.GH_TOKEN }}
ORGANIZATION: ${{ secrets.ORGANIZATION }}
TOPIC: open-source
- name: Open pull requests in OSS repository that are missing contrib files
uses: docker://ghcr.io/github/automatic-contrib-prs:v1
env:
GH_TOKEN: ${{ secrets.GH_TOKEN }}
ORGANIZATION: ${{ secrets.ORGANIZATION }}
GH_ACTOR: ${{ secrets.GH_ACTOR }}
PR_TITLE: ${{ secrets.PR_TITLE }}
PR_BODY: ${{ secrets.PR_BODY }}
Scaling for large organizations
- GitHub Actions workflows have time limits currently set at 72 hours per run. If you are operating on more than 1400 repos or so with this action, it will take several runs to complete.
Contributions
We would
Instructions to run locally without Docker
- Clone the repository or open a codespace
- Create a personal access token with read only permissions
- Copy the
.env-examplefile to.env - Edit the
.envfile by adding your Personal Access Token to it and the desired organization, pull request title and body, and actor (GitHub username) - Install dependencies
python3 -m pip install -r requirements.txt - Run the code
python3 open_contrib_pr.py - After running locally this will have changed your git config user.name and user.email so those should be reset for this repository
Docker debug instructions
- Install Docker and make sure docker engine is running
- cd to the repository
- Edit the Dockerfile to enable interactive docker debug as instructed in the comments of the file
docker build -t test .docker run -it test- Now you should be at a command prompt inside your docker container and you can begin debugging
651 Dec 27, 2022
188 Dec 30, 2022
1 Jan 17, 2022
18 May 08, 2021
3 Jul 18, 2022
263 Dec 23, 2022
21 Dec 24, 2022
6.7k Jan 09, 2023
25.5k Dec 29, 2022
19 Apr 20, 2022
71 Oct 28, 2022
14 Dec 18, 2022
825 Dec 27, 2022
462 Dec 29, 2022
186 Dec 30, 2022
121 Jan 03, 2023
1.3k Jan 08, 2023
1.2k Dec 30, 2022
124 Jan 06, 2023
1 Dec 19, 2021