add-contributors

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

_{Bailey Harrington}