This repository is a template for a Python monorepo with projects-specific virtual environments. It uses Pip for installing dependencies.
Because this repository is a GitHub template, you can duplicate it by using Creating a repository from a template in the GitHub UI. It will create a copy of this repository that is not a fork.
This repository's design is explained on the Tweag blog:
- Python monorepo; part 1 describes the monorepo's structure, how libraries are linked together and which tools are used.
- Python monorepo; part 2 describes the monorepo's CI, striking a good balance between being easy to use and being featureful.
The design strives to be simple, to work well in a startup environment where CI specialists are not yet available, and yet to achieve a great deal of reproducibility to prepare for scaling.
We use a virtual environment per library/project, to allow dependencies to diverge if you need to. Another alternative is to have a single virtual environment for the entire repository, to maximize uniformity. Choose what suits you best.
We use editable installs for dependencies within this repository, so that changes to a library are reflected immediately in code depending on the said library. This implements the live at HEAD workflow, a term made popular by Titus Winters from Google.