GitHub - alexellis/derek: Derek is a GitHub to delegate & automate repo main...
source link: https://github.com/alexellis/derek
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
README.md
derek
It's derek . Nice to meet you. I'd like to help you with Pull Requests and Issues on your GitHub project.
Please show support for the project and Star the repo.
From the team that brought you OpenFaaS - Serverless Functions Made Simple.
User guide / documentation
Core features
Derek is a bot for GitHub designed to reduce fatigue for maintainers and to delegate permissions to non-admin users in your community or team.
- Let non-admin users manage Issues and PRs by commenting
Derek <command>
- Enforce Developer Certificate of Origin (DCO) checking (optional)
- Automatically label/flag PRs without a Description
- Use the managed service or self-host
User guide
Find out what Derek can do you for your project, community and team including all available commands and configuration options: Read the user-guide
Get Derek
You can use a managed Derek bot or self-host your own on OpenFaaS. Start here: Get Derek.
How do I work?
I'm designed to be installed as a GitHub App, but don't worry - I don't need a lot of permissions. Just access to issues and Pull Requests will do.
I'm not a long-running daemon.. I'd get bored that way. I work with webhooks - so deploy me to a Serverless platform like OpenFaaS and forget about me. Just apply oil from time to time.
This is me in action with the DCO-checking feature. If I find a commit that isn't signed off then I'll let the contributor know in a comment. Normally they edit their commits and re-push within a few minutes after re-reading the message.
Inspiration for Derek
The idea for a bot that could comment on issues or respond to activity is from the docker/docker or Moby project's bot called Poule. It's a much more complex long-running daemon which uses Personal Access Tokens (so needs to run as a full GitHub login). Derek is much simpler (so hackable) and can be installed with granular permissions.
Our users
Some of our users include:
- Docker / Moby:
https://github.com/moby/moby/issues/35736
- OpenFaaS
https://github.com/openfaas/faas-cli/issues/85
Example: https://github.com/Subsurface-divelog/subsurface/pull/1748
See other users in our customers file
Backlog:
- Derek as a managed GitHub App
- Lock thread
- Edit title
- Toggle the DCO-feature
Future work:
- Caching of customers / .DEREK.yml file
- Observability of GitHub API Token rate limit
- Add roles & actions
- PR target branch checking (i.e. no PRs from master to master)
Maintainers and contributors
There are over a dozen contributors to Derek, but the following people have made the most impact.
- Alex Ellis - creator
- Richard Gee (@rgee0) - co-maintainer
- John McCabe (@johnmccabe) - contributor
- Martin Dekov (@martindekov) - contributor
- Lubomir I. Ivanov (@neolit123) - contributor
- Ivana Yovcheva (@ivanayov) - contributor
Alex Ellis created Derek to automate project maintainer duties around licensing and to help bring granular permissions back to GitHub. Derek has empowered contributors in the OpenFaaS community to run and maintain the project without needing full write access. OpenFaaS contributors continue to improve Derek so they can get the job done without fuss.
Contributions
Please follow the OpenFaaS contribution guide.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK