Part of twisted.python._release View Source View In Hierarchy
This knows how to build tarballs for Twisted and all of its subprojects.
Method | __init__ | Create a distribution builder. |
Method | buildTwisted | Build the main Twisted distribution in
Twisted-<version>.tar.bz2 . |
Method | buildCore | Build a core distribution in
TwistedCore-<version>.tar.bz2 . |
Method | buildSubProject | Build a subproject distribution in
Twisted<Projectname>-<version>.tar.bz2 . |
Method | _buildDocInDir | Generate documentation in the given path, building man pages first if necessary and swallowing errors (so that directories without lore documentation in them are ignored). |
Method | _createBasicSubprojectTarball | Helper method to create and fill a tarball with things common between subprojects and core. |
Parameters | rootDirectory | root of a Twisted export which will populate subsequent tarballs. (type: FilePath .) |
outputDirectory | The directory in which to create the tarballs. (type: FilePath ) | |
templatePath | Path to the template file that is used for the howto documentation. (type: FilePath ) | |
apiBaseURL | A format string which will be interpolated with the fully-qualified Python
name for each API link. For example, to generate the Twisted 8.0.0
documentation, pass
"http://twistedmatrix.com/documents/8.0.0/api/%s.html" . (type: str or NoneType ) |
Parameters | path | The path containing documentation to build. (type: FilePath ) |
version | The version of the project to include in all generated pages. (type: str ) | |
howtoPath | The "resource path" as DocBuilder
describes it. (type: FilePath ) |
Twisted-<version>.tar.bz2
.
bin/admin is excluded.
Parameters | version | The version of Twisted to build. (type: str ) |
Returns | The tarball file. (type: FilePath .) |
Build a core distribution in
TwistedCore-<version>.tar.bz2
.
This is very similar to buildSubProject
,
but core tarballs and the input are laid out slightly differently.
bin
directory.
twisted
directory,
excluding subprojects.
Parameters | version | The version of Twisted to build. (type: str ) |
Returns | The tarball file. (type: FilePath .) |
Twisted<Projectname>-<version>.tar.bz2
.Parameters | projectName | The lowercase name of the subproject to build. (type: str ) |
version | The version of Twisted to build. (type: str ) | |
Returns | The tarball file. (type: FilePath .) |
Parameters | projectName | The subproject's name. (type: str ) |
version | The version of the release. (type: str ) | |
outputFile | The location of the tar file to create. (type: FilePath ) |