Add all the badges with Badgie!
Project description
Badgie
Add all the badges with Badgie!
Badgie is experimental and should not be used by anyone ever!
tl;dr
Install Badgie:
pip install badgie
Add Badgie tags:
<!-- BADGIE TIME -->
<!-- END BADGIE TIME -->
Run Badgie:
badgie -w README.md
Why Badgie
Adding badges to repositories is frustrating. I spend so much time fiddling with setup and achieve little consistency across repos without even more fiddling.
Without Badgie, there's a good chance that:
-
Most repos just don't have badges.
-
If they have badges, they look different or show different info between repos.
-
Updating them is not fun.
The thing is, the whole internet WANTS you to have badges:
-
Badges convey authority and stewardship while occupying little real estate.
-
Many services have badges to make discovering info about your project easier.
-
You just gotta know where to find 'em!
About Badgie
Badgie is different because Badgie doesn't like asking for anything.
Starting with the Git remote URL of your checked out repo, Badgie attempts to reconstruct what your repository is, where it came from, and what information is interesting about it.
Supported features
Here's what Badgie supports currently:
Almost nothing!
Here's a more exhaustive list:
-
Interfacing with GitLab (barely)
-
Generated badges:
-
GitLab CI pipeline status
-
Pre-commit
-
Badgie is used to manage the badges on this README.
Using Badgie
Add the following tags wherever and Badgie will do its thing.
<!-- BADGIE TIME -->
<!-- END BADGIE TIME -->
Then run Badgie:
badgie -w README.md
And enjoy magic badges:
<!-- BADGIE TIME -->
[![pipeline status](brettops/containers/verible/badges/main/pipeline.svg)](brettops/containers/verible/-/commits/main)
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
<!-- END BADGIE TIME -->
Use as a pre-commit hook
Badgie can be used as a pre-commit hook, so you can get fresh badges on every commit.
Add the following to a .pre-commit-config.yaml
file. Note the empty
rev
tag:
repos:
- repo: https://gitlab.com/brettops/tools/badgie
rev: ""
hooks:
- id: badgie
Run pre-commit autoupdate
to pin to the latest version:
pre-commit autoupdate
Run pre-commit
directly or install as a hook:
# directly
pre-commit
# as a Git hook
pre-commit install
git commit -m "..."
Caveats
Badgie makes decisions on the assumption that you do sensible things with your repository structure. It does not try to work around bad practices. MRs that encourage this will be rejected.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.