contributor - print contributor List (only supports git)

contributor command will print the list of people who have modified code or documentation in a git project. The release page contains packages in .deb, .rpm, and .apk formats.

$ cd <PROJECT_ROOT_DIR>
$ contributor 
+-------------------------+-----------------------------------------------------------+-----------+-----------+
|          NAME           |                           EMAIL                           | +(APPEND) | -(DELETE) |
+-------------------------+-----------------------------------------------------------+-----------+-----------+
| Ichinose Shogo          | [email protected]                                      |     11042 |      6044 |
| Daisuke Maki            | [email protected]                                 |       866 |       223 |
| Songmu                  | [email protected]                                        |       237 |        65 |
| Stefan Tudose           | [email protected]                              |        14 |        12 |
| mattn                   | [email protected]                                        |         9 |         9 |
| yusuke-enomoto          | [email protected]                                   |         8 |         6 |
| pyros2097               | [email protected]                                       |         3 |         1 |
| catatsuy                | [email protected]                                     |         2 |         2 |
| Shoma Okamoto           | [email protected]                 |         1 |         1 |
| nasa9084                | [email protected]                          |         1 |         1 |
| dependabot-preview[bot] | 27856297+dependabot-preview[bot]@users.noreply.github.com |         0 |         0 |
+-------------------------+-----------------------------------------------------------+-----------+-----------+

How to install

Step.1 Install golang

contributor command only supports installation with $ go install. If you do not have golang development environment installed on your system, please install golang from the golang official website.

Step.2 Install contributor

$ go install github.com/nao1215/contributor@latest

Generate Contributors.md

The --file option generates Contributors.md in Markdown format.

$ contributor --markdown 
|          NAME           |                           EMAIL                           | +(APPEND) | -(DELETE) |
|-------------------------|-----------------------------------------------------------|-----------|-----------|
| Ichinose Shogo          | [email protected]                                      |      5642 |      1074 |
| Tatsuro Furusawa        | [email protected]                              |        14 |         4 |
| Shoma Okamoto           | [email protected]                 |         1 |         1 |
| dependabot-preview[bot] | 27856297+dependabot-preview[bot]@users.noreply.github.com |         0 |         0 |

Auto-generate Contributors.md in GitHub Actions

If you want to automatically create Contributors.md in GitHub Actions, put .github/workflows/contributor.yml in your project.

name: Contributors

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  contributors:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
        with:
          fetch-depth: 0

      - name: Set up Go
        uses: actions/setup-go@v2
        with:
          go-version: "1.18"

      - name: Generate Contributors
        run: |
          go install github.com/nao1215/contributor@latest
          git remote set-url origin https://github-actions:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}
          git config --global user.name "${GITHUB_ACTOR}"
          git config --global user.email "${GITHUB_ACTOR}@users.noreply.github.com"
          contributor --file
          git add .; \
          git commit -m "Update Contributors List"; \
          git push origin HEAD:${GITHUB_REF};

Contributing

First off, thanks for taking the time to contribute! ❤️ See CONTRIBUTING.md for more information.

Contact

If you would like to send comments such as "find a bug" or "request for additional features" to the developer, please use one of the following contacts.

• GitHub Issue

LICENSE

The contributor project is licensed under the terms of MIT LICENSE.