twisted.python.dist : API documentation

Class	ConditionalExtension	An extension module that will only be compiled if certain conditions are met.
Function	setup	An alternative to distutils' setup() which is specially designed for Twisted subprojects.
Function	get_setup_args	Undocumented
Function	getVersion	Extract the version number for a given project.
Function	relativeTo	Gets 'relativee' relative to 'basepath'.
Function	getDataFiles	Get all the data files that should be included in this distutils Project.
Function	getPackages	Get all packages which are under dname. This is necessary for Python 2.2's distutils. Pretty similar arguments to getDataFiles, including 'parent'.
Function	getScripts	Returns a list of scripts for a Twisted subproject; this works in any of an SVN checkout, a project-specific tarball.
Class	build_scripts_twisted	Renames scripts so they end with '.py' on Windows.
Class	install_data_twisted	I make sure data files are installed in the package directory.
Class	build_ext_twisted	Allow subclasses to easily detect and customize Extensions to build at install-time.
Function	_filterNames	Given a list of file names, return those names that should be copied.
Function	_checkCPython	Checks if this implementation is CPython.
Function	_hasEpoll	Checks if the header for building epoll (`sys/epoll.h`) is available.

def setup(**kw): (source)

An alternative to distutils' setup() which is specially designed for Twisted subprojects.

Pass twisted_subproject=projname if you want package and data files to automatically be found for you.

Parameters conditionalExtensions Extensions to optionally build. (type: list of ConditionalExtension)

def get_setup_args(**kw): (source)

Undocumented

def getVersion(proj, base='twisted'): (source)

Extract the version number for a given project.

Parameters	proj	the name of the project. Examples are "core", "conch", "words", "mail".
Returns	The version number of the project, as a string like "2.0.0". (type: str)

def _filterNames(names): (source)

Given a list of file names, return those names that should be copied.

def relativeTo(base, relativee): (source)

Gets 'relativee' relative to 'basepath'.

i.e.,

>>> relativeTo('/home/', '/home/radix/')
'radix'
>>> relativeTo('.', '/home/radix/Projects/Twisted') # curdir is /home/radix
'Projects/Twisted'

The 'relativee' must be a child of 'basepath'.

def getDataFiles(dname, ignore=None, parent=None): (source)

Get all the data files that should be included in this distutils Project.

'dname' should be the path to the package that you're distributing.

'ignore' is a list of sub-packages to ignore. This facilitates disparate package hierarchies. That's a fancy way of saying that the 'twisted' package doesn't want to include the 'twisted.conch' package, so it will pass ['conch'] as the value.

'parent' is necessary if you're distributing a subpackage like twisted.conch. 'dname' should point to 'twisted/conch' and 'parent' should point to 'twisted'. This ensures that your data_files are generated correctly, only using relative paths for the first element of the tuple ('twisted/conch/*'). The default 'parent' is the current working directory.

def getPackages(dname, pkgname=None, results=None, ignore=None, parent=None): (source)

Get all packages which are under dname. This is necessary for Python 2.2's distutils. Pretty similar arguments to getDataFiles, including 'parent'.

def getScripts(projname, basedir=''): (source)

Returns a list of scripts for a Twisted subproject; this works in any of an SVN checkout, a project-specific tarball.

def _checkCPython(sys=sys, platform=platform): (source)

Checks if this implementation is CPython.

On recent versions of Python, will use platform.python_implementation. On 2.5, it will try to extract the implementation from sys.subversion. On older versions (currently the only supported older version is 2.4), checks if __pypy__ is in sys.modules, since PyPy is the implementation we really care about. If it isn't, assumes CPython.

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.

Returns False if the implementation is definitely not CPython, True otherwise.

def _hasEpoll(builder): (source)

Checks if the header for building epoll (sys/epoll.h) is available.

Returns True if the header is available, False otherwise.

t.p.dist : module documentation