The main reason I care so much about the proper typing and general understandability and maintainability of the code is that for me the “real” client is as much a client of your work as are the people who are going to maintain it. You future self included. The mere fact that the code works is not enough to consider the ticket done. Creating the tests for the code is obvious requirement as well. Spending some time to make the code more readable — not so obvious. The most common problems — e.g. illogical variable or function names — are more easily caught during code review than too strict typing — the problem this post is about.

There is a well-known gotcha in Python. Namely, the default arguments retaining the mutation if mutated.

Doing it this way introduces a UX drawback being every MR’s pipeline failing if it does not have an approval from someone who isn’t the author of the MR. This might be irritaating, but I have not found another way that is not upgrading your Gitlab to at least Premium.

This is a “feel good” article mainly for myself, where I can add an item once I do something for the opensource community ❤️.

Docs

This post will showcase the extremely basic setup of a monorepo that will contain a local ts library and a next.js project as siblings: