summaryrefslogtreecommitdiff
path: root/docs/userguide
diff options
context:
space:
mode:
authorAarni Koskela <akx@iki.fi>2022-04-06 16:06:08 +0300
committerAarni Koskela <akx@iki.fi>2022-06-14 14:51:56 +0300
commit40fbbf2e7062f8482161576db8366cd4a7caaa93 (patch)
tree3961cece96fb2d29a8c83a017a11d70166dcbad6 /docs/userguide
parent78cb747d66bda1a6f6649e82690aaf5083a89d69 (diff)
downloadpython-setuptools-git-40fbbf2e7062f8482161576db8366cd4a7caaa93.tar.gz
Allow `file:` for `requires` statements in setup.cfg
Refs #1951
Diffstat (limited to 'docs/userguide')
-rw-r--r--docs/userguide/declarative_config.rst15
1 files changed, 10 insertions, 5 deletions
diff --git a/docs/userguide/declarative_config.rst b/docs/userguide/declarative_config.rst
index aa8bc7ea..a57bb607 100644
--- a/docs/userguide/declarative_config.rst
+++ b/docs/userguide/declarative_config.rst
@@ -211,13 +211,13 @@ obsoletes list-comma
Options
-------
-======================= =================================== =============== =========
+======================= =================================== =============== ====================
Key Type Minimum Version Notes
-======================= =================================== =============== =========
+======================= =================================== =============== ====================
zip_safe bool
setup_requires list-semi 36.7.0
-install_requires list-semi
-extras_require section [#opt-2]_
+install_requires file:, list-semi [#opt-6]_
+extras_require file:, section [#opt-2]_, [#opt-6]_
python_requires str 34.4.0
entry_points file:, section 51.0.0
scripts list-comma
@@ -232,7 +232,7 @@ exclude_package_data section
namespace_packages list-comma [#opt-5]_
py_modules list-comma 34.4.0
data_files section 40.6.0 [#opt-4]_
-======================= =================================== =============== =========
+======================= =================================== =============== ====================
**Notes**:
@@ -266,6 +266,11 @@ data_files section 40.6.0 [#
namespaces (:pep:`420`). Check :doc:`the Python Packaging User Guide
<PyPUG:guides/packaging-namespace-packages>` for more information.
+.. [#opt-6] ``file:`` directives for reading requirements are supported since version 63.0.
+ The format for the file is basically the same as for a ``requirements.txt`` file.
+ Library developers should avoid tightly pinning their dependencies to a specific
+ version (e.g. via a "locked" requirements file).
+
Compatibility with other tools
==============================