{"id":15505377,"url":"https://github.com/lekoarts/thanks-contributors","last_synced_at":"2025-04-23T01:37:21.981Z","repository":{"id":43463852,"uuid":"321611750","full_name":"LekoArts/thanks-contributors","owner":"LekoArts","description":"This little script accesses GitHub's API to get all contributors and their PRs between two distinct points in the history of commits.","archived":false,"fork":false,"pushed_at":"2024-07-11T15:40:18.000Z","size":1252,"stargazers_count":20,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-29T20:51:12.581Z","etag":null,"topics":["changelog","changelog-generator","cli","contributors","generator","github","lekoarts-oss","rust","thanks"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LekoArts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-15T09:07:14.000Z","updated_at":"2025-02-01T18:57:36.000Z","dependencies_parsed_at":"2023-01-31T19:01:21.638Z","dependency_job_id":null,"html_url":"https://github.com/LekoArts/thanks-contributors","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LekoArts%2Fthanks-contributors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LekoArts%2Fthanks-contributors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LekoArts%2Fthanks-contributors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LekoArts%2Fthanks-contributors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LekoArts","download_url":"https://codeload.github.com/LekoArts/thanks-contributors/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250354268,"owners_count":21416747,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["changelog","changelog-generator","cli","contributors","generator","github","lekoarts-oss","rust","thanks"],"created_at":"2024-10-02T09:23:02.990Z","updated_at":"2025-04-23T01:37:21.935Z","avatar_url":"https://github.com/LekoArts.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Thanks Contributors!\n\nThis little script accesses GitHub's API to get all contributors and their PRs between two distinct points in the history of commits. This is helpful for changelogs where you'd want to list all contributions for that release (so e.g. changes between v1 and v1.1).\n\n## Usage\n\n```shell\nnpx @lekoarts/thanks-contributors [OPTIONS] \u003cBASE\u003e \u003cHEAD\u003e [OWNER] [REPO]\n```\n\nFirst, it get's the list of commits between `base...head` (equivalent to `git log\nbase..head`), then parses their authors and creates a markdown list of each\ncontributor and their contribution.\n\n```shell\nUsage: @lekoarts/thanks-contributors [OPTIONS] \u003cBASE\u003e \u003cHEAD\u003e [OWNER] [REPO]\n\nArguments:\n  \u003cBASE\u003e\n          Pointer from where to start looking for changes\n\n  \u003cHEAD\u003e\n          Pointer until where to stop looking for changes\n\n  [OWNER]\n          Name of the owner/user/organization of the repository\n\n          [default: gatsbyjs]\n\n  [REPO]\n          Name of the repository\n\n          [default: gatsby]\n\nOptions:\n  -i, --include-org-members \u003cINCLUDE_ORG_MEMBERS\u003e\n          Include organization members into the list [default: false]\n\n          [possible values: true, false]\n\n  -e, --excludes \u003cEXCLUDES\u003e...\n          List of members to exclude from the list. Usage: -e=member1,member2 [default: \"renovate-bot\", \"renovate[bot]\"]\n\n  -v, --verbose...\n          More output per occurrence\n\n  -q, --quiet...\n          Less output per occurrence\n\n  -h, --help\n          Print help information (use `-h` for a summary)\n```\n\nYou must have an environment variable called `GITHUB_ACCESS_TOKEN` either exported in your CLI or defined inside an `.env` file in the directory you're running the CLI in.\n\nThe script automatically excludes the members of the organization (\"owner\" in this case). If you want to exclude specific users, you'll need to provide the `--excludes` flag.\n\nYou can use the options `-v` to `-vvvv` to display additional logging (warnings, info, debug, trace).\n\nThe results are stored inside a `output` folder in the current directory.\n\n### Example\n\n```shell\nnpx @lekoarts/thanks-contributors gatsby@5.1.0-next.0 gatsby@5.1.0 gatsbyjs gatsby\n```\n\n## Resulting output\n\nIt'll create a markdown list, grouped by user login. If a person had more than one commit, it creates a nested list. Example:\n\n```md\n- [harry](https://www.github.com/harry): Update something [PR #1](https://github.com/foobar/pull/1)\n- [hermione](https://www.github.com/hermione)\n  - Update something [PR #2](https://github.com/foobar/pull/2)\n  - Update something more [PR #3](https://github.com/foobar/pull/3)\n```\n\nIf the url can't be found only the name will be printed.\n\n## Caveats\n\n- Getting the PR number only works if you consistently add the number in the commit itself, e.g. in `feat: My cool feature (#123)`. This automatically happens in GitHub's UI if you use squash commits.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flekoarts%2Fthanks-contributors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flekoarts%2Fthanks-contributors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flekoarts%2Fthanks-contributors/lists"}