/add-contributors

A Github Action to add contributors to your file automatically. Feel free to contribute!

Primary LanguagePythonApache License 2.0Apache-2.0

add-contributors

Codacy Badge GitHub release (latest by date) language-python LICENSE Apache-2.0

A Github Action to add contributors to your markdown file(i.e. README.md) automatically on schedule or triggered by events

Specifically handle unreachable Chinese context (着重解决了中文内容乱码的问题)

Feel free to submit a pull request or an issue, but make sure to follow the templates

Welcome contributors to improve this project together!

Usage

Create a workflow file such as .github/workflows/contributors.yml (you can find it in this repo)

name: Add contributors
on:
  schedule:
    - cron:  '20 20 * * *'
# push:
#   branches:
#     - master

jobs:
  add-contributors:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - uses: BobAnkh/add-contributors@master
      with:
        REPO_NAME: 'BobAnkh/add-contributors'
        CONTRIBUTOR: '### Contributors'
        COLUMN_PER_ROW: '6'
        ACCESS_TOKEN: ${{secrets.GITHUB_TOKEN}}
        IMG_WIDTH: '100'
        FONT_SIZE: '14'
        PATH: '/README.md'
        COMMIT_MESSAGE: 'docs(README): update contributors'
        AVATAR_SHAPE: 'round'

Parameters

Parameter Description Required Default
REPO_NAME Repository name yes -
CONTRIBUTOR Where you want to add contributors list no ### Contributors
COLUMN_PER_ROW Number of contributors per row no 6
ACCESS_TOKEN Github Access Token yes You can just pass ${{secrets.GITHUB_TOKEN}}
IMG_WIDTH Width of img no 100
FONT_SIZE Font size of name (px) no 14
PATH Path to the file you want to add contributors' list no /README.md
COMMIT_MESSAGE commit message no docs(README): update contributors
AVATAR_SHAPE Set round for round avatar and square for square avatar no square
IGNORED_CONTRIBUTORS Ignored contributors, seperated by comma no ''

NOTE: You should leave a blank line after the CONTRIBUTOR line for the first time

NOTE: You can use <branch>:<file> format to specify the branch where your file is located. e.g. 'dev:/README.md'

NOTE: Github seems not support image style in markdown file rendering yet

NOTE: IGNORED_CONTRIBUTORS takes display name not username

Maintainer

@BobAnkh

How to contribute

You should follow our Code of Conduct.

See CONTRIBUTING GUIDELINES for contributing conventions.

Make sure to pass all the tests before submitting your code. You can conduct pytest -ra at the root directory to run all tests.

You can use local mode when develope it on your local machine, here is the command-line help info:

usage: main.py [-h] [-m MODE] [-f FILE] [-o OUTPUT] [-t TOKEN]

optional arguments:
  -h, --help            show this help message and exit
  -m MODE, --mode MODE  choose to use local-dev mode or on github action mode.
                        Valid values are 'local' or 'github'
  -f FILE, --file FILE  configuration file to read from when running local-dev
                        mode
  -o OUTPUT, --output OUTPUT
                        output file when running local-dev mode
  -t TOKEN, --token TOKEN
                        Github Access Token

Contributors

BobAnkh/
BobAnkh
Bailey
Bailey Harrington

LICENSE

Apache-2.0 © BobAnkh