Setuptools convenience functionality.

This file must not import anything from Twisted, as it is loaded by exec in setup.py. If you need compatibility functions for this code, duplicate them here.

Variable notPortedModules Modules that are not yet ported to Python 3.
Class ConditionalExtension An extension module that will only be compiled if certain conditions are met.
Function getSetupArgs Generate arguments for setuptools.setup()
Class BuildPy3 A version of build_py that doesn't install the modules that aren't yet ported to Python 3.
Class build_ext_twisted Allow subclasses to easily detect and customize Extensions to build at install-time.
Variable _EXTRA_OPTIONS These are the actual package names and versions that will be used by extras_require. This is not passed to setup directly so that combinations of the packages can be created without the need to copy package names multiple times.
Variable _EXTRAS_REQUIRE extras_require is a dictionary of items that can be passed to setup.py to install optional dependencies. For example, to install the optional dev dependencies one would type:
   pip install -e ".[dev]"

This has been supported by setuptools since 0.5a4.

Variable _PLATFORM_INDEPENDENT A list of all optional cross-platform dependencies, as setuptools version specifiers, used to populate _EXTRAS_REQUIRE.
Variable _EXTENSIONS The list of ConditionalExtension used by the setup process.
Function _checkPythonVersion Fail if we detect a version of Python we don't support.
Function _longDescriptionArgsFromReadme Generate a PyPI long description from the readme.
Function _checkCPython Checks if this implementation is CPython.
_EXTRA_OPTIONS =
These are the actual package names and versions that will be used by extras_require. This is not passed to setup directly so that combinations of the packages can be created without the need to copy package names multiple times.
_EXTRAS_REQUIRE =
extras_require is a dictionary of items that can be passed to setup.py to install optional dependencies. For example, to install the optional dev dependencies one would type:
   pip install -e ".[dev]"

This has been supported by setuptools since 0.5a4.

_PLATFORM_INDEPENDENT =
A list of all optional cross-platform dependencies, as setuptools version specifiers, used to populate _EXTRAS_REQUIRE.
_EXTENSIONS =
The list of ConditionalExtension used by the setup process.
notPortedModules =
Modules that are not yet ported to Python 3.
def _checkPythonVersion(): (source)

Fail if we detect a version of Python we don't support.

def _longDescriptionArgsFromReadme(readme): (source)

Generate a PyPI long description from the readme.

ParametersreadmePath to the readme reStructuredText file. (type: str)
ReturnsKeyword arguments to be passed to setuptools.setup(). (type: str)
def getSetupArgs(extensions=_EXTENSIONS, readme='README.rst'): (source)

Generate arguments for setuptools.setup()

ParametersextensionsC extension modules to maybe build. This argument is to be used for testing. (type: list of ConditionalExtension)
readmePath to the readme reStructuredText file. This argument is to be used for testing. (type: str)
ReturnsThe keyword arguments to be used by the setup method. (type: dict)
def _checkCPython(sys=sys, platform=platform): (source)

Checks if this implementation is CPython.

This uses platform.python_implementation.

This takes sys and platform kwargs that by default use the real modules. You shouldn't care about these -- they are for testing purposes only.

ReturnsFalse if the implementation is definitely not CPython, True otherwise.
API Documentation for Twisted, generated by pydoctor at 2019-08-06 12:10:50.