DEV Community

Fernando B 🚀
Fernando B 🚀

Posted on • Originally published at kodaman2.github.io 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.

Backstory

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
static_gtrix

Python Version

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

gtrix_cmd

It works in all platforms since is piping git commands.

pip install Generatrix
Enter fullscreen mode Exit fullscreen mode

Inside a git repo:

gtrix
  or
gtrix --help
  or
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)