[tahoe-lafs-trac-stream] [Tahoe-LAFS] #3665: Remove docutils pin from tox configuration
Tahoe-LAFS
trac at tahoe-lafs.org
Tue Apr 20 22:27:52 UTC 2021
#3665: Remove docutils pin from tox configuration
------------------------------------+-----------------------
Reporter: sajith | Owner: sajith
Type: defect | Status: new
Priority: normal | Milestone: undecided
Component: dev-infrastructure | Version: n/a
Resolution: | Keywords:
Launchpad Bug: |
------------------------------------+-----------------------
Comment (by meejah):
Replying to [comment:6 exarkun]:
> > If we're pinning anything here, it seems we should pin Sphinx (our
direct dependency) right?
>
> I'm not sure. Sphinx probably doesn't pin its direct dependencies,
right? The convention seems to be "declare your dependencies unversioned,
or maybe with an extremely liberal and untested version constraint".
The best-practices I've seen documented are that libraries should declare
minimum dependencies and "programs" (that is, like tahoe or sphinx) should
pin exact dependencies. Bonus points for using hashes too.
Since we're using Sphinx as "just a tool", we should pin a Sphinx version
that we know and love. I don't know if Sphinx pins its own dependencies
(but if it followed best-practices, it should).
--
Ticket URL: <https://tahoe-lafs.org/trac/tahoe-lafs/ticket/3665#comment:8>
Tahoe-LAFS <https://Tahoe-LAFS.org>
secure decentralized storage
More information about the tahoe-lafs-trac-stream
mailing list