💾 Archived View for d.moonfire.us › blog › 2021 › 12 › 19 › yeoman-generators captured on 2023-06-16 at 16:44:37. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

generator-mfgames-nix-project v1.4.1 and generator-mfgames-writing 1.0.0

Up a Level

I create a lot of projects. I think between Github and Gitlab, I have a few hundred now. Much if it is because I started pushing toward strictly being one story per repository (OSPR). This means I have a lot of common patterns that not only do I have to set up but also maintain as my skills and knowledge evolve. The problem comes when I figure out a new pattern, I have to update a couple hundred repositories if I want to keep them consistent. Needless to say, this is one drawback of a monorepo but there are a lot of advantages of OSPR.

A lot of my inspiration comes from Larry Wall's Three Virtues of a Great Programmer:

Laziness: The quality that makes you go to great effort to reduce overall energy expenditure. It makes you write labor-saving programs that other people will find useful and document what you wrote so you don't have to answer so many questions about it.
Impatience: The anger you feel when the computer is being lazy. This makes you write programs that don't just react to your needs, but actually anticipate them. Or at least pretend to.
Hubris: The quality that makes you write (and maintain) programs that other people won't want to say bad things about.

This means, instead of manually doing it, I want to find a nice automated way (virtue one) that I can script and have it run across everything at once (virtue two).

Previously, I had used Yeoman[1] but I was wondering if I needed to break out of that to work on a “me-specific” CLI tool. That line of thought came down because so many of the tools I'm using all package their own custom CLIs. While I do enjoy writing a good CLI, I don't want to write one if I can't.

1: https://yeoman.io/

In the process of finding an alternative, I finally understood how to compose Yeoman generators together. That means I could create a generic project generator and then layer the writing[2] one on top of it.

2: /tags/mfgames-writing/

At the same time, I could migrate away from asdf[3] and onto my preferred infrastructure du jour, Nix[4].

3: /tags/asdf/

4: /tags/nix/

Side Note: Let me be honest, I'm constantly evolving my structures and they change as I learn new tools and my processes change with me. I won't be on Nix forever, but right now, Nix works out very nicely for what I want it to do.

This weekend I pulled something together and actually got a working version by tonight. This involves three projects:

mfgames-writing[5]: My publishing framework for Markdown and YAML files.

5: https://gitlab.com/mfgames-writing/mfgames-writing-js/

generator-mfgames-nix-project[6]: A Yeoman generator for creating a basic project layout.

6: https://gitlab.com/mfgames-js/generator-mfgames-nix-project

generator-mfgames-writing[7]: A Yeoman generator for setting up a writing project.

7: https://gitlab.com/mfgames-writing/generator-mfgames-writing-js

generator-mfgames-nix-project v1.4.1

I pulled out the basic project stuff from `generator-mfgames-writing` and made it a dedicated generator while improving it. It still asks a bunch of questions, but mainly it does the following:

Set up semantic-release[8] to handle non-romantic releases. “Non-romantic” meaning automated and every time I push up to `main`.

8: /tags/semantic-release/

Set up Conventional Commits[9] to drive the semantic release process. This is why my check-ins start with `feat:`, `fix:`, or something other tag. That way, I can just focus on a given commit being a new feature, fixing something, or breaking everything.

9: /tags/conventional-commits/

Set up commitlint[10] to make sure the commits are properly handled for the semantic releasing.

10: /tags/commitlint/

Set up Husky[11] to make sure commitlint is automatically handled.

11: /tags/husky/

Configure Prettier[12] to make everything pretty and normalized. This mostly helps if someone ever contributes, but I like things being consistent and neat. While I disagree with Prettier on many things, it does a fantastic job.

12: /tags/prettier/

Set up a Nix flake[13] to represent all the build tools needed to build the project.

13: /tags/nix/

Set up direnv[14] to automatically ‘enter’ the environment when you go into the directory.

14: /tags/direnv/

Write out the files needed to run Gitlab's CI/CD[15] on push and generate all the files and automatically release.

15: /tags/gitlab/

Set up EditorConfig[16] for normalized formatting.

16: /tags/editorconfig/

That's a lot of work and it was getting tedious as I migrated/created new projects over the last month or so as I figured out the pattern. I like it, though it is opinionated. Previously, I hated that word, but this is honestly how I work and I think it's a reasonable pattern for any writing or coding project.

Running it is pretty simple:

$ npm install -g generator-mfgames-nix-project yo
$ mkdir name-of-project
$ cd name-of-project
$ yo mfgames-nix-project
... lots of prompting

Overall, I like the resulting project and I'm going to be testing it fairly heavily in the new few weeks.

generator-mfgames-writing v1.0.0

Most of the intial work for `generator-mfgames-nix-project` came from `generator-mfgames-writing`, but I ended up also expanding that over the weekend to ask better questions about theme, author information, and the release process. It works the same as the project generator.

$ npm install -g generator-mfgames-writing yo
$ mkdir name-of-project
$ cd name-of-project
$ yo mfgames-writing
... a different set of questions
$ npm run build
... lots of noise
$ ls *.epub *.pdf
name-of-project-0.0.1.epub
name-of-project-0.0.1.pdf

This one bypasses some questions that the project one does (build, test, and release questions) and adds some other ones (theme, configuration file format, title of the work), but otherwise works the same as the other. The end result is something you should be able to build and get the output immediately.

I honestly think that is really cool.

mfgames-writing

There were a bunch of versions with this, but I needed to tweak some processes because I found some bugs in these tools while writing the generators. Sadly, a “simple” fix of moving `rimraf` from a developer dependency to a normal dependency required me to upgrade TypeScript[17] to the last version and accept a wall of warnings because some of the linting tools don't like the latest version.

17: /tags/typescript/