# tributors
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[](#contributors-)
<!-- ALL-CONTRIBUTORS-BADGE:END -->
[Documentation](https://con.github.io/tributors/)
## What is tributors?
Tributors is a Python library and GitHub action that helps you to pay tribute to your
contributors. Tribute interacts with several well-known repository metadata files:
- [all-contributors](https://github.com/all-contributors)
- [Zenodo](https://zenodo.org)
- [CodeMeta](https://codemeta.github.io/)
Each of the services above allows you to generate some kind of metadata file
that has one or more repository contributors. This file typically needs to be
generated and updated manually, and this is where tributors comes in to help!
Tributors will allow you to programmatically create and update these files.
By way of using a shared cache, a `.tributors` file that can store common
identifiers, it becomes easy to update several of these metadata files at once.
You can set criteria such as a threshold for contributions to add a contributor,
export an Orcid ID token to ensure that you have Orcid Ids where needed,
or use an interactive mode to make decisions as you go.
## How does it work?
Tributors uses the GitHub API, Zenodo API, and Orcid API to look up shared identifiers
for common metadata services like all contributors, Zenodo, and CodeMeta. The
tool is available for local or container usage, and as a GitHub Action (see the [examples](examples) folder).
See the full [documentation](https://con.github.io/tributors/) for getting started.
## Contributors
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tbody>
<tr>
<td align="center" valign="top" width="14.28%"><a href="www.onerussian.com"><img src="https://avatars3.githubusercontent.com/u/39889?v=4?s=100" width="100px;" alt="Yaroslav Halchenko"/><br /><sub><b>Yaroslav Halchenko</b></sub></a><br /><a href="https://github.com/con/tributors/commits?author=yarikoptic" title="Code">💻</a> <a href="https://github.com/con/tributors/commits?author=yarikoptic" title="Documentation">📖</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://vsoch.github.io"><img src="https://avatars0.githubusercontent.com/u/814322?v=4?s=100" width="100px;" alt="Vanessasaurus"/><br /><sub><b>Vanessasaurus</b></sub></a><br /><a href="https://github.com/con/tributors/commits?author=vsoch" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/pgrimaud"><img src="https://avatars1.githubusercontent.com/u/1866496?v=4?s=100" width="100px;" alt="Pierre Grimaud"/><br /><sub><b>Pierre Grimaud</b></sub></a><br /><a href="https://github.com/con/tributors/commits?author=pgrimaud" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/vuillaut"><img src="https://avatars.githubusercontent.com/u/4263646?v=4?s=100" width="100px;" alt="vuillaut"/><br /><sub><b>vuillaut</b></sub></a><br /><a href="https://github.com/con/tributors/commits?author=vuillaut" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/jwodder"><img src="https://avatars.githubusercontent.com/u/98207?v=4?s=100" width="100px;" alt="jwodder"/><br /><sub><b>jwodder</b></sub></a><br /><a href="https://github.com/con/tributors/commits?author=jwodder" title="Code">💻</a></td>
</tr>
</tbody>
</table>
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
Raw data
{
"_id": null,
"home_page": "http://www.github.com/con/tributors",
"name": "tributors",
"maintainer": "Vanessa Sochat",
"docs_url": null,
"requires_python": "",
"maintainer_email": "vsochat@stanford.edu",
"keywords": "contributions,tributes",
"author": "Vanessa Sochat",
"author_email": "vsochat@stanford.edu",
"download_url": "https://files.pythonhosted.org/packages/b9/7e/4f936bad329befeeaf82b1c561b13f1aa41c175ba7e9747af912a55b2434/tributors-0.1.1.tar.gz",
"platform": null,
"description": "# tributors\n\n\n\n<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->\n[](#contributors-)\n<!-- ALL-CONTRIBUTORS-BADGE:END -->\n\n[Documentation](https://con.github.io/tributors/)\n\n## What is tributors?\n\nTributors is a Python library and GitHub action that helps you to pay tribute to your\ncontributors. Tribute interacts with several well-known repository metadata files:\n\n - [all-contributors](https://github.com/all-contributors)\n - [Zenodo](https://zenodo.org)\n - [CodeMeta](https://codemeta.github.io/)\n\nEach of the services above allows you to generate some kind of metadata file\nthat has one or more repository contributors. This file typically needs to be\ngenerated and updated manually, and this is where tributors comes in to help!\nTributors will allow you to programmatically create and update these files.\nBy way of using a shared cache, a `.tributors` file that can store common\nidentifiers, it becomes easy to update several of these metadata files at once.\nYou can set criteria such as a threshold for contributions to add a contributor,\nexport an Orcid ID token to ensure that you have Orcid Ids where needed,\nor use an interactive mode to make decisions as you go.\n\n## How does it work?\n\nTributors uses the GitHub API, Zenodo API, and Orcid API to look up shared identifiers\nfor common metadata services like all contributors, Zenodo, and CodeMeta. The\ntool is available for local or container usage, and as a GitHub Action (see the [examples](examples) folder).\nSee the full [documentation](https://con.github.io/tributors/) for getting started.\n\n\n## Contributors\n\n<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n<!-- prettier-ignore-start -->\n<!-- markdownlint-disable -->\n<table>\n <tbody>\n <tr>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"www.onerussian.com\"><img src=\"https://avatars3.githubusercontent.com/u/39889?v=4?s=100\" width=\"100px;\" alt=\"Yaroslav Halchenko\"/><br /><sub><b>Yaroslav Halchenko</b></sub></a><br /><a href=\"https://github.com/con/tributors/commits?author=yarikoptic\" title=\"Code\">\ud83d\udcbb</a> <a href=\"https://github.com/con/tributors/commits?author=yarikoptic\" title=\"Documentation\">\ud83d\udcd6</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://vsoch.github.io\"><img src=\"https://avatars0.githubusercontent.com/u/814322?v=4?s=100\" width=\"100px;\" alt=\"Vanessasaurus\"/><br /><sub><b>Vanessasaurus</b></sub></a><br /><a href=\"https://github.com/con/tributors/commits?author=vsoch\" title=\"Code\">\ud83d\udcbb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/pgrimaud\"><img src=\"https://avatars1.githubusercontent.com/u/1866496?v=4?s=100\" width=\"100px;\" alt=\"Pierre Grimaud\"/><br /><sub><b>Pierre Grimaud</b></sub></a><br /><a href=\"https://github.com/con/tributors/commits?author=pgrimaud\" title=\"Code\">\ud83d\udcbb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/vuillaut\"><img src=\"https://avatars.githubusercontent.com/u/4263646?v=4?s=100\" width=\"100px;\" alt=\"vuillaut\"/><br /><sub><b>vuillaut</b></sub></a><br /><a href=\"https://github.com/con/tributors/commits?author=vuillaut\" title=\"Code\">\ud83d\udcbb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/jwodder\"><img src=\"https://avatars.githubusercontent.com/u/98207?v=4?s=100\" width=\"100px;\" alt=\"jwodder\"/><br /><sub><b>jwodder</b></sub></a><br /><a href=\"https://github.com/con/tributors/commits?author=jwodder\" title=\"Code\">\ud83d\udcbb</a></td>\n </tr>\n </tbody>\n</table>\n\n<!-- markdownlint-restore -->\n<!-- prettier-ignore-end -->\n\n<!-- ALL-CONTRIBUTORS-LIST:END -->\n",
"bugtrack_url": null,
"license": "LICENSE",
"summary": "give tribute to your repository contributors.",
"version": "0.1.1",
"project_urls": {
"Homepage": "http://www.github.com/con/tributors"
},
"split_keywords": [
"contributions",
"tributes"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3d709f8989d796b665e46501860cb25ebe780d0af21fa0b456e3aa72e363ba51",
"md5": "1c7abf0dafa8d63ae6014a26f548fec3",
"sha256": "64d529b5e3101fd2838275403de9a749c14178ef272fa9c331a5318fcc11bd15"
},
"downloads": -1,
"filename": "tributors-0.1.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "1c7abf0dafa8d63ae6014a26f548fec3",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 36469,
"upload_time": "2023-06-07T13:53:50",
"upload_time_iso_8601": "2023-06-07T13:53:50.551730Z",
"url": "https://files.pythonhosted.org/packages/3d/70/9f8989d796b665e46501860cb25ebe780d0af21fa0b456e3aa72e363ba51/tributors-0.1.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b97e4f936bad329befeeaf82b1c561b13f1aa41c175ba7e9747af912a55b2434",
"md5": "17563d57492d6f01e55668733b3a385d",
"sha256": "8ff8139d7c23150a0457d7815aa579756ae11d05f2f4c16433d0c512cd4a6f32"
},
"downloads": -1,
"filename": "tributors-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "17563d57492d6f01e55668733b3a385d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 29561,
"upload_time": "2023-06-07T13:53:52",
"upload_time_iso_8601": "2023-06-07T13:53:52.093424Z",
"url": "https://files.pythonhosted.org/packages/b9/7e/4f936bad329befeeaf82b1c561b13f1aa41c175ba7e9747af912a55b2434/tributors-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-07 13:53:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "con",
"github_project": "tributors",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "tributors"
}
JSON
