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.