Your IP : 172.28.240.42

Current Path : /usr/lib/python2.7/dist-packages/twisted/python/
Upload File :
Current File : //usr/lib/python2.7/dist-packages/twisted/python/_release.pyc


ryMc@sdZddlZddlmZddlZddlZddlZddlmZddl	Z	ddl
mZmZm
Z
ddlmZddlmZddlmZydd	lmZWnek
rnXd
ZdZdefd
YZdZedZedZdefdYZ dZ!dZ"dZ#dZ$dZ%defdYZ&defdYZ'de'fdYZ(de'fdYZ)d efd!YZ*d"e'fd#YZ+d$efd%YZ,d&Z-d'efd(YZ.d)efd*YZ/d+efd,YZ0d-Z1d.efd/YZ2d0efd1YZ3d2efd3YZ4dS(4sL
Twisted's automated release system.

This module is only for use within Twisted's release system. If you are anyone
else, do not use it. The interface and behaviour will change without notice.

Only Linux is supported by this code.  It should not be used by any tools
which must run on multiple platforms (eg the setup.py script).
iN(tdate(tmkdtemp(tPIPEtSTDOUTtPopen(tVersion(tFilePath(ttwisted_subprojects(tloreicCszt|dtdt}|jj}|j}|dkrUtd||n!|dkrvt|d|n|S(s;
    Execute a vector of arguments.

    @type args: C{list} of C{str}
    @param args: A list of arguments, the first of which will be used as the
        executable to run.

    @rtype: C{str}
    @return: All of the standard output.

    @raise CommandFailed: when the program exited with a non-0 exit code.
    tstdouttstderriN(RRRR	treadtwaitt
CommandFailedtNone(targstprocessR	texitCode((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt
runCommand(s
R
cBseZdZdZRS(sY
    Raised when a child process exits unsuccessfully.

    @type exitStatus: C{int}
    @ivar exitStatus: The exit status for the child process.

    @type exitSignal: C{int}
    @ivar exitSignal: The exit signal for the child process.

    @type output: C{str}
    @ivar output: The bytes read from stdout and stderr of the child process.
    cCs5tj||||||_||_||_dS(N(t	Exceptiont__init__t
exitStatust
exitSignaltoutput(tselfRRR((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRLs		(t__name__t
__module__t__doc__R(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR
?scCs$t|i|j|j6dS(s]
    Replace the C{old} version number with the C{new} one in the given
    C{filename}.
    N(t
replaceInFiletbase(toldtnewtfilename((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt_changeVersionInFileTscCsc|dkrtj}n|jt}||jkr@d}n
|jd}t|j||dS(s
    Calculate the version number for a new release of Twisted based on
    the previous version number.

    @param version: The previous version number.
    @param now: (optional) The current date.
    iiN(	RRttodaytyeartVERSION_OFFSETtmajortminorRtpackage(tversiontnowR%R&((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytgetNextVersion]s

	
cCsL|stjjd}nx't|D]}|jjdkrOd}nd|jj}|j}t||j|j	|j
d|j}|jrt}|j
|jd|j|||||j
|jjdjd|j||||n|dkr7t|||jdjn|j|q+WdS(	sk
    Change the version of all projects (including core and all subprojects).

    If the current version of a project is pre-release, then also change the
    versions in the current NEWS entries for that project.

    @type root: L{FilePath}
    @param root: The root of the Twisted source tree.
    @type versionTemplate: L{Version}
    @param versionTemplate: The version of all projects.  The name will be
        replaced for each respective project.
    @type today: C{str}
    @param today: A YYYY-MM-DD formatted string. If not provided, defaults to
        the current day, according to the system clock.
    s%Y-%m-%dttwistedstwisted.t
prereleasetNEWSttopfilestREADMEN(RR"tstrftimetfindTwistedProjectst	directorytbasenamet
getVersionRR%R&tmicroR,tNewsBuildert_changeNewsVersiontchildt_getNewsNameR!tpatht
updateVersion(troottversionTemplateR"tprojecttpackageNamet
oldVersiont
newVersiontbuilder((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytchangeAllProjectVersionsqs.			

tProjectcBs2eZdZdZdZdZdZRS(s>
    A representation of a project that has a version.

    @ivar directory: A L{twisted.python.filepath.FilePath} pointing to the base
        directory of a Twisted-style Python package. The package should contain
        a C{_version.py} file and a C{topfiles} directory that contains a
        C{README} file.
    cCs
||_dS(N(R2(RR2((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRscCsd|jj|jfS(Ns%s(%r)(t	__class__RR2(R((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt__repr__scCs*i}t|jjdj||dS(sz
        @return: A L{Version} specifying the version number of the project
        based on live python modules.
        s_version.pyR((texecfileR2R8R:(Rt	namespace((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR4scCsT|j}t|jjdj|t|||jjdjdjdS(sz
        Replace the existing version numbers in _version.py and README files
        with the specified version.
        s_version.pyR.R/N(R4treplaceProjectVersionR2R8R:R!(RR(R@((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR;s(RRRRRFR4R;(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRDs
			
cCsUg}xH|jD]:}|jdkr|j}|jt|qqW|S(s
    Find all Twisted-style projects beneath a base directory.

    @param baseDirectory: A L{twisted.python.filepath.FilePath} to look inside.
    @return: A list of L{Project}.
    R.(twalkR3tparenttappendRD(t
baseDirectorytprojectstfilePathtprojectDirectory((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR1scCs:x3t|D]%}|jt|jd|q
WdS(sR
    Update the version information for Twisted and all subprojects to the
    date-based version number.

    @param baseDirectory: Where to look for Twisted. If None, the function
        infers the information from C{twisted.__file__}.
    @param now: The current date (as L{datetime.date}). If None, it defaults
        to today.
    R)N(R1R;R*R4(RMR)R>((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytupdateTwistedVersionInformations
cCsQ|jdk	r"d|jf}nd}d|j|j|j|j|f}|S(sh
    Generate the data to be placed into a _version.py file.

    @param version: A version object.
    s, prerelease=%rts# This is an auto-generated file. Do not edit it.
from twisted.python import versions
version = versions.Version(%r, %s, %s, %s%s)
N(R,RR'R%R&R5(R(R,tdata((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytgenerateVersionFileDatas
%cCs0t|d}|jt||jdS(s
    Write version specification code into the given filename, which
    sets the version to the given version number.

    @param filename: A filename which is most likely a "_version.py"
        under some Twisted project.
    @param newversion: A version object.
    twN(topentwriteRTtclose(R t
newversiontf((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRIscCstj||dt|d}|j}|jx,|jD]\}}|j||}qGWt|dd}|j||jtj|d|tj|ddS(sP
    I replace the text `oldstr' with `newstr' in `filename' using science.
    s.baks.newRUN(	tostrenameRVRRXtitemstreplaceRWtunlink(R toldToNewRZtdtktv((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRs


tNoDocumentsFoundcBseZdZRS(s3
    Raised when no input documents are found.
    (RRR(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRd!stLoreBuilderMixincBseZdZdZRS(s4
    Base class for builders which invoke lore.
    cCs1tj}|jdg|tj|dS(s
        Run lore with the given arguments.

        @param arguments: A C{list} of C{str} giving command line arguments to
            lore which should be used.
        s--nullN(RtOptionstparseOptionstrunGivenOptions(Rt	argumentstoptions((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR,s(RRRR(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRe(st
DocBuildercBs&eZdZdedZdZRS(s3
    Generate HTML documentation for projects.
    c
	Cs|j||}|jd}g|D]}	|	j^q(}
|
sYtd|fn|d	k	rxdd|g}ng}|jdd|jfdddd|fd|g|
|j||rx|D]}|jqWnd	S(
s)
        Build the documentation in C{docDir} with Lore.

        Input files ending in .xhtml will be considered. Output will written as
        .html files.

        @param version: the version of the documentation to pass to lore.
        @type version: C{str}

        @param resourceDir: The directory which contains the toplevel index and
            stylesheet file for this section of documentation.
        @type resourceDir: L{twisted.python.filepath.FilePath}

        @param docDir: The directory of the documentation.
        @type docDir: L{twisted.python.filepath.FilePath}

        @param template: The template used to generate the documentation.
        @type template: L{twisted.python.filepath.FilePath}

        @type apiBaseURL: C{str} or C{NoneType}
        @param 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
            C{"http://twistedmatrix.com/documents/8.0.0/api/%s.html"}.

        @param deleteInput: If True, the input documents will be deleted after
            their output is generated.
        @type deleteInput: C{bool}

        @raise NoDocumentsFound: When there are no .xhtml files in the given
            C{docDir}.
        s*.xhtmlsNo input documents found in %ss--configsbaseurl=stemplate=%ss	ext=.htmls
version=%ss	--linkrelN(t
getLinkreltglobChildrenR:RdRtextendRtremove(
RR(tresourceDirtdocDirttemplatet
apiBaseURLtdeleteInputtlinkrelt
inputFilestxt	filenamesRit	inputFile((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytbuild>s "


cCs.||kr&djt||dSdSdS(s
        Calculate a value appropriate for Lore's --linkrel option.

        Lore's --linkrel option defines how to 'find' documents that are
        linked to from TEMPLATE files (NOT document bodies). That is, it's a
        prefix for links ('a' and 'link') in the template.

        @param resourceDir: The directory which contains the toplevel index and
            stylesheet file for this section of documentation.
        @type resourceDir: L{twisted.python.filepath.FilePath}

        @param docDir: The directory containing documents that must link to
            C{resourceDir}.
        @type docDir: L{twisted.python.filepath.FilePath}
        t/RRN(tjoint
filePathDelta(RRpRq((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRlssN(RRRRtFalseRzRl(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRk9s4t
ManBuildercBseZdZdZRS(s?
    Generate man pages of the different existing scripts.
    cCst|jd}g|D]}|j^q}|sGtd|fnddddddg|}|j|d	S(
s
        Generate Lore input files from the man pages in C{manDir}.

        Input files ending in .1 will be considered. Output will written as
        -man.xhtml files.

        @param manDir: The directory of the man pages.
        @type manDir: L{twisted.python.filepath.FilePath}

        @raise NoDocumentsFound: When there are no .1 files in the given
            C{manDir}.
        s*.1sNo manual pages found in %ss--inputtmans--outputRs--configsext=-man.xhtmlN(RmR:RdR(RtmanDirRvRwRxRi((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRzs
(RRRRz(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRst
APIBuildercBseZdZdZRS(s
    Generate API documentation from source files using
    U{pydoctor<http://codespeak.net/~mwh/pydoctor/>}.  This requires
    pydoctor to be installed and usable (which means you won't be able to
    use it with Python 2.3).
    cCs`ddlm}|d|d|ddd|jjd|d	|jd
|jddd
gdS(sh
        Call pydoctor's entry point with options which will generate HTML
        documentation for the specified package's API.

        @type projectName: C{str}
        @param projectName: The name of the package for which to generate
            documentation.

        @type projectURL: C{str}
        @param projectURL: The location (probably an HTTP URL) of the project
            on the web.

        @type sourceURL: C{str}
        @param sourceURL: The location (probably an HTTP URL) of the root of
            the source browser for the project.

        @type packagePath: L{FilePath}
        @param packagePath: The path to the top-level of the package named by
            C{projectName}.

        @type outputPath: L{FilePath}
        @param outputPath: An existing directory to which the generated API
            documentation will be written.
        i(tmains--project-names
--project-urls--system-classs#pydoctor.twistedmodel.TwistedSystems--project-base-dirs--html-viewsource-bases
--add-packages
--html-outputs--html-write-function-pagess--quiets--make-htmlN(tpydoctor.driverRRKR:(RtprojectNamet
projectURLt	sourceURLtpackagePatht
outputPathR((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRzs		(RRRRz(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRstBookBuildercBs2eZdZdZdZdZdZRS(sQ
    Generate the LaTeX and PDF documentation.

    The book is built by assembling a number of LaTeX documents.  Only the
    overall document which describes how to assemble the documents is stored
    in LaTeX in the source.  The rest of the documentation is generated from
    Lore input files.  These are primarily XHTML files (of the particular
    Lore subset), but man pages are stored in GROFF format.  BookBuilder
    expects all of its input to be Lore XHTML format, so L{ManBuilder}
    should be invoked first if the man pages are to be included in the
    result (this is determined by the book LaTeX definition file).
    Therefore, a sample usage of BookBuilder may look something like this::

        man = ManBuilder()
        man.build(FilePath("doc/core/man"))
        book = BookBuilder()
        book.build(
            FilePath('doc/core/howto'),
            [FilePath('doc/core/howto'), FilePath('doc/core/howto/tutorial'),
             FilePath('doc/core/man'), FilePath('doc/core/specifications')],
            FilePath('doc/core/howto/book.tex'), FilePath('/tmp/book.pdf'))
    cCs
t|S(s
        Execute a command in a child process and return the output.

        @type command: C{str}
        @param command: The shell command to run.

        @raise CommandFailed: If the child process exits with an error.
        (R(Rtcommand((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytruns	cCse|js%td|jfn|jddddgg|jdD]}|j^qJdS(sW
        Build LaTeX files for lore input files in the given directory.

        Input files ending in .xhtml will be considered. Output will written as
        .tex files.

        @type howtoDir: L{FilePath}
        @param howtoDir: A directory containing lore input files.

        @raise ValueError: If C{howtoDir} does not exist.
        s%r does not exist.s--outputtlatexs--configtsections*.xhtmlN(texistst
ValueErrorR:RRm(RthowtoDirR8((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytbuildTeXs	cCs|jjds$tdntt}ytj}ztj|jddd|j|jg}x!t	dD]}|j
|q~W|jd }|j|d}	|j|d	}
|j|d
}|j
dd|
jd
dd|	jg|j
d|
j|jg|j||j
Wdtj|XWn,|j|jj|jnXdS(s
        Build a PDF from the given a LaTeX book document.

        @type bookPath: L{FilePath}
        @param bookPath: The location of a LaTeX document defining a book.

        @type inputDirectory: L{FilePath}
        @param inputDirectory: The directory which the inputs of the book are
            relative to.

        @type outputPath: L{FilePath}
        @param outputPath: The location to which to write the resulting book.
        s.texs Book filename must end with .texRs-interaction=nonstopmodes-output-directory=iis.dvis.pss.pdftdvipss-os-ttletters-Ppdftps2pdf13N(R3tendswithRRRR[tgetcwdtchdirR:trangeRR8tmoveToRoRK(RtbookPathtinputDirectoryRtworkPathtstartDirttexToDVItitbookBaseWithoutExtensiontdviPathtpsPathtpdfPath((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytbuildPDFs4


"cCsx|D]}|j|qW|j|||xT|D]L}xC|jD]5}|jddkrK||krK|jqKqKWq8WdS(s
        Build a PDF book from the given TeX book definition and directories
        containing lore inputs.

        @type baseDirectory: L{FilePath}
        @param baseDirectory: The directory which the inputs of the book are
            relative to.

        @type inputDirectories: C{list} of L{FilePath}
        @param inputDirectories: The paths which contain lore inputs to be
            converted to LaTeX.

        @type bookPath: L{FilePath}
        @param bookPath: The location of a LaTeX document defining a book.

        @type outputPath: L{FilePath}
        @param outputPath: The location to which to write the resulting book.
        is.texN(RRtchildrentsplitextRo(RRMtinputDirectoriesRRtinputDirRR8((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRz@s

"(RRRRRRRz(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRs
			4R6cBseZdZdZdZdZdZdZide6de6de6d	e6d
e6ZdZ	dZ
d
ZdZdZ
dZdZdZdZdZdZdZdZdZRS(sh
    Generate the new section of a NEWS file.

    The C{_FEATURE}, C{_BUGFIX}, C{_DOC}, C{_REMOVAL}, and C{_MISC}
    attributes of this class are symbolic names for the news entry types
    which are supported.  Conveniently, they each also take on the value of
    the file name extension which indicates a news entry of that type.

    @cvar _headings: A C{dict} mapping one of the news entry types to the
        heading to write out for that type of news entry.

    @cvar _NO_CHANGES: A C{str} giving the text which appears when there are
        no significant changes in a release.

    @cvar _TICKET_HINT: A C{str} giving the text which appears at the top of
        each news file and which should be kept at the top, not shifted down
        with all the other content.  Put another way, this is the text after
        which the new news text is inserted.
    s.features.bugfixs.docs.removals.misctFeaturestBugfixessImproved DocumentationsDeprecations and RemovalstOthers8No significant changes have been made for this release.
shTicket numbers in this file can be looked up by visiting
http://twistedmatrix.com/trac/ticket/<number>

cCstjjdS(sG
        Return today's date as a string in YYYY-MM-DD format.
        s%Y-%m-%d(RR"R0(R((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt_todayscCsg}xo|jD]a}tjj|j\}}||kr|jt|dj|jj	fqqW|j
|S(s&
        Load all the feature ticket summaries.

        @param path: A L{FilePath} the direct children of which to search
            for news entries.

        @param ticketType: The type of news entries to search for.  One of
            L{NewsBuilder._FEATURE}, L{NewsBuilder._BUGFIX},
            L{NewsBuilder._REMOVAL}, or L{NewsBuilder._MISC}.

        @return: A C{list} of two-tuples.  The first element is the ticket
            number as an C{int}.  The second element of each tuple is the
            description of the feature.
        t (RR[R:RR3RLtintR|t
getContentt
splitlinestsort(RR:t
ticketTypetresultsR8Rtext((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt_findChangess	&
cCs|ddt|dS(s
        Format a header for a NEWS file.

        A header is a title with '=' signs underlining it.

        @param header: The header string to format.
        @type header: C{str}
        @return: A C{str} containing C{header}.
        s
t=s

(tlen(Rtheader((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt
_formatHeaders
cCs|j|j|dS(s
        Write a version header to the given file.

        @param fileObj: A file-like object to which to write the header.
        @param header: The header to write to the file.
        @type header: C{str}
        N(RWR(RtfileObjR((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt_writeHeadersc
Cs+|s
dSi}x-|D]%\}}|j|gj|qWx|D]}||jqGW|j}|jdd|j|ddt|dxv|D]n\}}djg|D]}dt|^q}d||f}	tj	|	d	d
}	|j|	dqW|jddS(sy
        Write out one section (features, bug fixes, etc) to the given file.

        @param fileObj: A file-like object to which to write the news section.

        @param header: The header for the section to write.
        @type header: C{str}

        @param tickets: A C{list} of ticket information of the sort returned
            by L{NewsBuilder._findChanges}.
        NtkeycSs|\}}|dS(Ni((t.0tdescrttickets((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt<lambda>ss
t-s, t#s
 - %s (%s)tsubsequent_indents   (
t
setdefaultRLRR]RWRR|tstrttextwraptfill(
RRRRtreversettickettdescriptiontrelatedTicketst
ticketListtentry((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt
_writeSections"
#&cCs|s
dS|j|ddt|dg}x+|D]#\}}|jdt|q:Wddj|}tj|dd}|j|d	dS(
sr
        Write out a miscellaneous-changes section to the given file.

        @param fileObj: A file-like object to which to write the news section.

        @param header: The header for the section to write.
        @type header: C{str}

        @param tickets: A C{list} of ticket information of the sort returned
            by L{NewsBuilder._findChanges}.
        Ns
RRs - s, Rs   s

(RWRRLRR|RR(RRRRtformattedTicketsRtignoredR((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt
_writeMiscs#c
Csg}xT|j|j|j|jfD]4}|j||}|r%|j||fq%q%W|j||j}|j}|jdj	d}	|j
|jr|	j|j|t
|j}n|j|	||rxS|D]+\}}|j|	|jj||qWn|	j|j|	jd|j|	|jj|j||	jd|	j||	j|jdj|dS(s
        Load all of the change information from the given directory and write
        it out to the given output file.

        @param path: A directory (probably a I{topfiles} directory) containing
            change information in the form of <ticket>.<change type> files.
        @type path: L{FilePath}

        @param output: The NEWS file to which the results will be prepended.
        @type output: L{FilePath}

        @param header: The top-level header to use when writing the news.
        @type header: L{str}
        sNEWS.newRUs
N(t_FEATUREt_BUGFIXt_DOCt_REMOVALRRLt_MISCRtsiblingRVt
startswitht_TICKET_HINTRWRRRt	_headingstgett_NO_CHANGESRRXR(
RR:RRtchangestpartRtmisctoldNewstnewNews((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRzs,%&
"


cCs.|jjj}|dkr*d}n|S(s
        Return the name of C{project} that should appear in NEWS.

        @param project: A L{Project}
        @return: The name of C{project}.
        tTwistedtCore(R2R3ttitle(RR>tname((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR9#s	c	cst|}|jdd|jxttgD]|}xs|D]k}|jjd}|rs|jd}n|jd}|j|}|j}||||fVqCWq6WdS(s
        Iterate through the Twisted projects in C{baseDirectory}, yielding
        everything we need to know to build news for them.

        Yields C{topfiles}, C{news}, C{name}, C{version} for each sub-project
        in reverse-alphabetical order. C{topfile} is the L{FilePath} for the
        topfiles directory, C{news} is the L{FilePath} for the NEWS file,
        C{name} is the nice name of the project (as should appear in the NEWS
        file), C{version} is the current version string for that project.

        @param baseDirectory: A L{FilePath} representing the root directory
            beneath which to find Twisted projects for which to generate
            news (see L{findTwistedProjects}).
        @type baseDirectory: L{FilePath}
        RcSs
|jjS(N(R2R:(tproj((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRCsR.R-N(	R1RRR~tTrueR2R8R9R4(	RRMRNt
aggregateNewsR>R.tnewsRR(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt
_iterProjects0s

cCs\|j}xI|j|D]8\}}}}|j||d||j|fqWdS(s
        Find all of the Twisted subprojects beneath C{baseDirectory} and update
        their news files from the ticket change description files in their
        I{topfiles} directories and update the news file in C{baseDirectory}
        with all of the news.

        @param baseDirectory: A L{FilePath} representing the root directory
            beneath which to find Twisted projects for which to generate
            news (see L{findTwistedProjects}).
        sTwisted %s %s (%s)N(RRRzR(RRMR"R.RRR(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytbuildAllTs
"cCs|jd||j|f}tjdtj|tj|jf}|j}|j|}	|	r|	j}
t|j	i||
6ndS(sB
        Change all references to the current version number in a NEWS file to
        refer to C{newVersion} instead.

        @param news: The NEWS file to change.
        @type news: L{FilePath}
        @param name: The name of the project to change.
        @type name: C{str}
        @param oldVersion: The old version of the project.
        @type oldVersion: L{Version}
        @param newVersion: The new version of the project.
        @type newVersion: L{Version}
        @param today: A YYYY-MM-DD string representing today's date.
        @type today: C{str}
        sTwisted %s %s (%s)s)Twisted %s %s \(\d{4}-\d\d-\d\d\)\n=+\n\nN(
RRtretcompiletescapeRtsearchtgroupRR:(RRRR@RAR"t	newHeadertexpectedHeaderRegexRtmatcht	oldHeader((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR7fs(cCs=t|dkr"tjdn|jt|ddS(s
        Build all news files.

        @param args: The command line arguments to process.  This must contain
            one string, the path to the base of the Twisted checkout for which
            to build the news.
        @type args: C{list} of C{str}
        is;Must specify one argument: the path to the Twisted checkoutiN(RtsystexitRR(RR((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRs	(RRRRRRRRRRRRRRRRRRzR9RRR7R(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR6]s4
			
		!		*	
	$		cCsd}|jjtj}|jjtj}x7t||D]&\}}||kre|d7}q@Pq@Wdgt||}|||S(s4
    Return a list of strings that represent C{destination} as a path relative
    to C{origin}.

    It is assumed that both paths represent directories, not files. That is to
    say, the delta of L{twisted.python.filepath.FilePath} /foo/bar to
    L{twisted.python.filepath.FilePath} /foo/baz will be C{../baz},
    not C{baz}.

    @type origin: L{twisted.python.filepath.FilePath}
    @param origin: The origin of the relative path.

    @type destination: L{twisted.python.filepath.FilePath}
    @param destination: The destination of the relative path.
    iis..(R:tsplitR[tseptzipR(torigintdestinationtcommonItemstpath1tpath2telem1telem2R:((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR}s
tDistributionBuildercBsWeZdZddlmZd	dZdZdZ	dZ
dZdZRS(
s{
    A builder of Twisted distributions.

    This knows how to build tarballs for Twisted and all of its subprojects.
    i(RcCs7||_||_||_t|_t|_dS(s
        Create a distribution builder.

        @param rootDirectory: root of a Twisted export which will populate
            subsequent tarballs.
        @type rootDirectory: L{FilePath}.

        @param outputDirectory: The directory in which to create the tarballs.
        @type outputDirectory: L{FilePath}

        @type apiBaseURL: C{str} or C{NoneType}
        @param 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
            C{"http://twistedmatrix.com/documents/8.0.0/api/%s.html"}.
        N(t
rootDirectorytoutputDirectoryRsRt
manBuilderRkt
docBuilder(RRRRs((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRs
			cCs|jjdjdjdjd}|jdkrR|jj|n|jry&|jj|||||jtWqt	k
rqXndS(s!
        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).

        @param path: The path containing documentation to build.
        @type path: L{FilePath}
        @param version: The version of the project to include in all generated
            pages.
        @type version: C{str}
        @param howtoPath: The "resource path" as L{DocBuilder} describes it.
        @type howtoPath: L{FilePath}
        tdoctcorethowtostemplate.tplRN(
RR8R3RRztisdirRRsRRd(RR:R(t	howtoPathttemplatePath((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt_buildDocInDirs
c
sOd|ffd}|jjd}tjj|jd}|jjd}|jrxY|jD]H}|jrux3|j	D]"}|j
|||jdqWququWnxW|jjdjD]=}|jdkr|j|j|d|jqqWx|jjd	jD]y}	|	jd
krx^|	jD]+}
|j|
j|d	d
|
jq\Wq7|j|	j|d	|	jq7WxB|jjdjD](}|j|j|d|jqWxE|jjD]4}|js	|j|j||jq	q	W|j
|S(s
        Build the main Twisted distribution in C{Twisted-<version>.tar.bz2}.

        bin/admin is excluded.

        @type version: C{str}
        @param version: The version of Twisted to build.

        @return: The tarball file.
        @rtype: L{FilePath}.
        s
Twisted-%scsdjf|S(NR{(R|(R(treleaseName(s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRss.tar.bz2sw:bz2RR	tbintadminR+tplugins(RR8ttarfiletTarFileRVR:RR
RRJR
R3taddRX(
RR(t	buildPatht
outputFilettarballtdocPatht
subProjectDirR8tbinthingt	submoduletpluginRqttoplevel((Rs;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytbuildTwisteds:
&&
csd|f|jjd}fd}|jd||}xQ|jjdjD]7}|js`|j|j|d|jq`q`Wx|jjdjD]}|jdkr<x|jD]\}xS|j	D]#}|jd|fkrPqqW|j|j|dd|jqWq|j|j	d	gkr|j|j|d|jqqW|j|jjdjd	j|j
|S(
sT
        Build a core distribution in C{TwistedCore-<version>.tar.bz2}.

        This is very similar to L{buildSubProject}, but core tarballs and the
        input are laid out slightly differently.

         - scripts are in the top level of the C{bin} directory.
         - code is included directly from the C{twisted} directory, excluding
           subprojects.
         - all plugins except the subproject plugins are included.

        @type version: C{str}
        @param version: The version of Twisted to build.

        @return: The tarball file.
        @rtype: L{FilePath}.
        sTwistedCore-%ss.tar.bz2csdjf|S(NR{(R|(R(R(s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR3sRRR+Rs
twisted_%s.pyR.(RR8t_createBasicSubprojectTarballRRR
RR:R3tsubprojectsRX(RR(RRRR:Rt
subproject((Rs;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt	buildCores.
)	)!
c
sd|j|f|jjd}fd}|jjdj|}|j|||}|j|jdjxN|jD]@}|j}|dkr|j|j|d||qqW|jjdjd}	d|f}
|	j|
}|j	r=|j|j|dd|
n|jjdj|}|j
r|j|j|dn|j|S(	sm
        Build a subproject distribution in
        C{Twisted<Projectname>-<version>.tar.bz2}.

        @type projectName: C{str}
        @param projectName: The lowercase name of the subproject to build.
        @type version: C{str}
        @param version: The version of Twisted to build.

        @return: The tarball file.
        @rtype: L{FilePath}.
        sTwisted%s-%ss.tar.bz2csdjf|S(NR{(R|(R(R(s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR`sR+R.Rs
twisted_%s.pyR(t
capitalizeRR8RRRR:RR3RR
RX(
RRR(RRRRR8Rt
pluginsDirtpluginFileNamet
pluginFiletbinPath((Rs;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytbuildSubProjectQs0
	

csd|j|ffd}tjj|jd}|j|jjdj|d|jjdj|}|jrx0|j	D]"}|j
|||jdqW|j|j|dn|S(s
        Helper method to create and fill a tarball with things common between
        subprojects and core.

        @param projectName: The subproject's name.
        @type projectName: C{str}
        @param version: The version of the release.
        @type version: C{str}
        @param outputFile: The location of the tar file to create.
        @type outputFile: L{FilePath}
        sTwisted%s-%scsdjf|S(NR{(R|(R(R(s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRssw:bz2tLICENSERR	(R#RRRVR:RRR8R
RJR
(RRR(RRRRR8((Rs;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRs
 N(
RRRttwisted.python.distRR RRR
RR"R(R(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRs		7	2	0tUncleanWorkingDirectorycBseZdZRS(sJ
    Raised when the working directory of an SVN checkout is unclean.
    (RRR(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR+stNotWorkingDirectorycBseZdZRS(sQ
    Raised when a directory does not appear to be an SVN working directory.
    (RRR(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR,sc
Cse|jdjs.td|jfntdd|jgjretd|jfntt}|jd}tdd|j|jg|jd}t	|j
}|j}d|}|js|jnt
||d	|}|j|x6tD].}	|j|	jr|j|	|qqW|j||jd
S(ss
    Build complete tarballs (including documentation) for Twisted and all
    subprojects.

    This should be called after the version numbers have been updated and
    NEWS files created.

    @type checkout: L{FilePath}
    @param checkout: The SVN working copy from which a pristine source tree
        will be exported.
    @type destination: L{FilePath}
    @param destination: The directory in which tarballs will be placed.

    @raise UncleanWorkingDirectory: if there are modifications to the
        working directory of C{checkout}.
    @raise NotWorkingDirectory: if the checkout path is not an SVN checkout.
    s.svns2%s does not appear to be an SVN working directory.tsvntsts8There are local modifications to the SVN checkout in %s.texportR+s2http://twistedmatrix.com/documents/%s/api/%%s.htmlRsN(R8RR,R:RtstripR+RRRDR4RtcreateDirectoryRR"RR(RRo(
tcheckoutRRR/ttwistedPathR(t
versionStringRstdbR!((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytbuildAllTarballss2



tChangeVersionsScriptcBs#eZdZeeZdZRS(s<
    A thing for changing version numbers. See L{main}.
    c
Cs6d}t|dkr(tjdn|d}y|jd\}}}Wntk
rmt|nXd|kr|jd\}}n|}d	}yCt|}t|}t|}|d	k	rt|}nWntk
rt|nXtd|||d|}	|j	t
d|	d	S(
s
        Given a list of command-line arguments, change all the Twisted versions
        in the current directory.

        @type args: list of str
        @param args: List of command line arguments.  This should only
            contain the version number.
        s6Version should be in a form kind of like '1.2.3[pre4]'is4Must specify exactly one argument to change-versionsit.tpretWhateverR,N(RRRRRt
SystemExitRRRRCR(
RRtversion_formatR(R%R&t
micro_and_preR5R9tversion_template((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRs.



(RRRtstaticmethodRCR(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR7stBuildTarballsScriptcBs#eZdZeeZdZRS(s=
    A thing for building release tarballs. See L{main}.
    cCsJt|dkr"tjdn|jt|dt|ddS(s
        Build all release tarballs.

        @type args: list of str
        @param args: The command line arguments to process.  This must contain
            two strings: the checkout directory and the destination directory.
        isAMust specify two arguments: Twisted checkout and destination pathiiN(RRRR6R(RR((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRs(RRRR?R6R(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR@stBuildAPIDocsScriptcBs eZdZdZdZRS(s>
    A thing for building API documentation. See L{main}.
    cCsct|jdj}|j}d|f}t}|jdd||jd|dS(s
        Build the API documentation of Twisted, with our project policy.

        @param projectRoot: A L{FilePath} representing the root of the Twisted
            checkout.
        @param output: A L{FilePath} pointing to the desired output directory.
        R+s>http://twistedmatrix.com/trac/browser/tags/releases/twisted-%sRshttp://twistedmatrix.com/N(RDR8R4RRRz(RtprojectRootRR(R4Rt
apiBuilder((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pytbuildAPIDocs"s
	cCsJt|dkr"tjdn|jt|dt|ddS(s
        Build API documentation.

        @type args: list of str
        @param args: The command line arguments to process.  This must contain
            two strings: the path to the root of the Twisted checkout, and a
            path to an output directory.
        isAMust specify two arguments: Twisted checkout and destination pathiiN(RRRRDR(RR((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyR7s	(RRRRDR(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyRAs	(5RRtdatetimeRRRR[ttempfileRRt
subprocessRRRttwisted.python.versionsRttwisted.python.filepathRR*Rttwisted.lore.scriptsRtImportErrorR$RRR
R!RR*RCtobjectRDR1RQRTRIRRdReRkRRRR6R}RR+R,R6R7R@RA(((s;/usr/lib/python2.7/dist-packages/twisted/python/_release.pyt<module>
sV
			2+					Q.5		1+