this post was submitted on 23 Nov 2024
8 points (100.0% liked)

Python

6401 readers
18 users here now

Welcome to the Python community on the programming.dev Lemmy instance!

πŸ“… Events

PastNovember 2023

October 2023

July 2023

August 2023

September 2023

🐍 Python project:
πŸ’“ Python Community:
✨ Python Ecosystem:
🌌 Fediverse
Communities
Projects
Feeds

founded 1 year ago
MODERATORS
 

In a requirements-*.in file, at the top of the file, are lines with -c and -r flags followed by a requirements-*.in file. Uses relative paths (ignoring URLs).

Say have docs/requirements-pip-tools.in

-r ../requirements/requirements-prod.in
-c ../requirements/requirements-pins-base.in
-c ../requirements/requirements-pins-cffi.in

...

The intent is compiling this would produce docs/requirements-pip-tool.txt

But there is confusion as to which flag to use. It's non-obvious.

constraint

Subset of requirements features. Intended to restrict package versions. Does not necessarily (might not) install the package!

Does not support:

  • editable mode (-e)

  • extras (e.g. coverage[toml])

Personal preference

  • always organize requirements files in folder(s)

  • don't prefix requirements files with requirements-, just doing it here

  • DRY principle applies; split out constraints which are shared.

top 5 comments
sorted by: hot top controversial new old
[–] [email protected] 1 points 10 hours ago (1 children)

my personal preference is a pyproject.toml over that mess

[–] spoonbill 1 points 10 hours ago (1 children)

But pyproject.toml supports neither locking nor constraints.

[–] [email protected] 1 points 9 hours ago

Ah true, I had the wrong idea about this constraints file. What's your use case?

[–] spoonbill 3 points 19 hours ago

Constraints are useful for restricting build dependencies of your dependencies, especially if they follow PEP-518.

[–] logging_strict 1 points 22 hours ago

A package's requirements are left unlocked An app's requirements are locked

This doesn't excuse app devs from excluding a requirements.in file