DEV Community

Fernando B πŸš€
Fernando B πŸš€

Posted on • Originally published at on

Showcase Generatrix Utility for Git Branches-Tags Markdown

I wrote this utility last week which I call Generatrix. It generates markdown for a repo branches/tags. I don't know how much of a problem this is for other people, but I figured to share it anyways. If you are doing a tutorial, and need to provide code to your users, and you split the code in branches or tags as you progress throughout the tutorial or lesson, you can too use generatrix. And then copy and paste the output in your readme.


I actually started doing a static-site on github pages, repository but I sorta failed miserably because I suck at JS, well not really, I just suck at async code. I've never done any JS and I got frustated, I did asked for help which some folks provided awesome help and I still have to work on it. Site works but branches are spit out not in date order, sometimes, which is a problem. I am sure my JS code is a mess lol.

Out of order mkdown

Python Version

I spent a few days on the static site, and then went and did the python version in a couple of hours.


It works in all platforms since is piping git commands.

pip install Generatrix
Enter fullscreen mode Exit fullscreen mode

Inside a git repo:

gtrix --help
gtrix --tags
Enter fullscreen mode Exit fullscreen mode

Optional, if you don't have .gitconfig configured:

gtrix --user "username"
Enter fullscreen mode Exit fullscreen mode

All arguments have short version too, help documentation is on the repo posted in the beginning. Let me know if you've ever had to generate this manually for a readme file. I welcome feedback as well. :)

Top comments (0)