Skip to content
/ tributors Public

Pay tribute to your contributors! A tool to automatically update contributor files.

License

Notifications You must be signed in to change notification settings

con/tributors

Repository files navigation

tributors

docs/assets/img/logo.png

All Contributors

Documentation

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:

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 folder). See the full documentation for getting started.

Contributors

Yaroslav Halchenko
Yaroslav Halchenko

💻 📖
Vanessasaurus
Vanessasaurus

💻
Pierre Grimaud
Pierre Grimaud

💻
vuillaut
vuillaut

💻
jwodder
jwodder

💻