diff options
| -rw-r--r-- | docs/setuptools.txt | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/docs/setuptools.txt b/docs/setuptools.txt index 2f78b133..94ee09ad 100644 --- a/docs/setuptools.txt +++ b/docs/setuptools.txt @@ -769,6 +769,38 @@ so that Package B doesn't have to remove the ``[PDF]`` from its requirement specifier. +.. _Platform Specific Dependencies: + + +Declaring platform specific dependencies +---------------------------------------- + +Sometimes a project might require a dependency to run on a specific platform. +This could to a package that back ports a module so that it can be used in +older python versions. Or it could be a package that is required to run on a +specific operating system. This will allow a project to work on multiple +different platforms without installing dependencies that are not required for +a platform that is installing the project. + +For example, here is a project that uses the ``enum`` module and ``pywin32``:: + + setup( + name="Project", + ... + extras_require={ + ':python_version < "3.4"': ["enum34"], + ':sys_platform == "win32"': ["pywin32 >= 1.0"] + } + ) + +Since the ``enum`` module was added in python 3.4, it should only be installed +if the python version is earlier. Since ``pywin32`` will only be used on +windows, it should only be installed when the operating system is Windows. +Specifying version requirements for the dependencies is supported as normal. + +The environmental markers that may be used for testing platform types are +detailed in PEP 496. + Including Data Files ==================== |