site-support/src/installing/packages/README.md

955 B

To Be Written...

The goal of this section is to provide a practical, step-by-step guide to getting Python packages installed, presuming any already-working Python installation.

At this stage, the greatest danger is "easy just-works """solutions""". In this ecosystem, they tend to be ridden with little gotchas, OS-dependent behavior, and confusing ways of misconfiguring them.

Thus, a deliberate decision is taken to presume very basic terminal knowledge (as provided by the dedicated section of this very book), and barebones working system Python installation, and explain packaging in the only reliably built-in and future-proof way: venv and pip. Special care is especially paid to requirements.txt, which at this stage is the only comprehensible way of "saving" what packages (and at what versions!) are installed in a .venv for ex. use by others.

As with the rest of the book, it should be written in an accessible style.