upstream/certbot
1
0
Fork 0
mirror of https://github.com/certbot/certbot.git synced 2026-06-05 06:42:10 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions 5

no dummies

Browse source
This commit is contained in:
Brad Warren 2021-07-16 15:18:43 -07:00
parent 7dfeac9106
commit e65ffb24bb
2 changed files with 11 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
certbot/docs/contributing.rst
View file

@ -599,13 +599,13 @@ Updating dependency versions
``tools/requirements.txt`` and ``tools/oldest_constraints.txt`` can be updated
using ``tools/pinning/current/repin.sh`` and ``tools/pinning/oldest/repin.sh``
respectively. This works by using ``poetry`` to generate pinnings based on a
dummy Poetry project defined by the ``pyproject.toml`` file in the same
directory as the script. In many cases, you can just run the script to generate
updated dependencies, however, if you need to pin back packages or unpin
packages that were previously restricted to an older version, you will need to
modify the ``pyproject.toml`` file. The syntax used by this file is described
at https://python-poetry.org/docs/pyproject/ and how dependencies are specified
in this file is further described at
Poetry project defined by the ``pyproject.toml`` file in the same directory as
the script. In many cases, you can just run the script to generate updated
dependencies, however, if you need to pin back packages or unpin packages that
were previously restricted to an older version, you will need to modify the
``pyproject.toml`` file. The syntax used by this file is described at
https://python-poetry.org/docs/pyproject/ and how dependencies are specified in
this file is further described at
https://python-poetry.org/docs/dependency-specification/.
If you want to learn more about the design used here, see

8
tools/pinning/DESIGN.md
View file

@ -64,10 +64,10 @@ pinnings.
Under `current` and `oldest`, there are two files as of writing this. One is a
pyproject.toml file for use with [Poetry](https://python-poetry.org/) while
the other is a script that can be run to regenerate pinnings. The
pyproject.toml file defines a dummy Python package that depends on everything
we want to pin. This file largely just depends on our own local packages,
however, extra dependencies can be declared to further constrain package
versions or to declare additional dependencies.
pyproject.toml file defines a Python package that depends on everything we want
to pin. This file largely just depends on our own local packages, however,
extra dependencies can be declared to further constrain package versions or to
declare additional dependencies.
The reason we use Poetry is that it is somewhat unique among Python packaging
tools in that when locking dependencies, it makes a best effort approach to do