ryMc@sdZddlZddlZddlZddlZddlZddlmZddlZddlm Z ddl m Z ddl mZddlmZddlmZdd lmZdd lmZdd lmZdd lmZmZdd lmZmZddlmZddlmZm Z ddlm!Z!ddlm"Z"ddlm#Z#m$Z$m%Z%ddlm&Z&m'Z'ddlm(Z(m)Z)ddlm*Z*m+Z+ddlm,Z,ddlm-Z-m.Z.ddlm/Z/m0Z0ddlm1Z1m2Z2ddlm3Z3ej4dkr(dZ5ne6Z5yddl7m8Z8Wne9k r[dZ:nXe5Z:yddl;Z<Wne9e=fk rdZ>n1Xe?e<d d!fd!d"fkrd#Z>ne5Z>ed$oed%oed&re5Z@nd'Z@ed(o ed)re5ZAnd*ZAd+ZBd,eCfd-YZDd.eeDfd/YZEd0efd1YZFd2efd3YZGd4efd5YZHd6eCfd7YZId8eeIfd9YZJd:efd;YZKd<eeIfd=YZLd>eeIfd?YZMd@efdAYZNdBeeDfdCYZOdDeIeDefdEYZPdFePfdGYZQdHePfdIYZRdJeIeDefdKYZSdS(Ls Tests for L{twisted.python.release} and L{twisted.python._release}. All of these tests are skipped on platforms other than Linux, as the release is only ever performed on Linux. iN(tStringIO(tminidom(tdate(tTestCase(tset(twhich(trelease(tFilePath(tVersion(t_changeVersionInFiletgetNextVersion(tfindTwistedProjectst replaceInFile(treplaceProjectVersion(tupdateTwistedVersionInformationtProject(tgenerateVersionFileData(tchangeAllProjectVersions(tVERSION_OFFSETt DocBuildert ManBuilder(tNoDocumentsFoundt filePathDelta(t CommandFailedt BookBuilder(tDistributionBuildert APIBuilder(tBuildAPIDocsScript(tbuildAllTarballst runCommand(tUncleanWorkingDirectorytNotWorkingDirectory(tChangeVersionsScripttBuildTarballsScript(t NewsBuildertposixs*Release toolchain only supported on POSIX.(tloresLore is not present.sPydoctor is not present.t version_infoiisPydoctor is too old.tlatextdvipstps2pdf13sLaTeX is not available.tsvntsvnadminssvn or svnadmin is not present.cOstt||S(s A convenience for generating _version.py data. @param args: Arguments to pass to L{Version}. @param kwargs: Keyword arguments to pass to L{Version}. (RR(targstkwargs((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt genVersionTstStructureAssertingMixincBs)eZdZdZdZdZRS(s A mixin for L{TestCase} subclasses which provides some methods for asserting the structure and contents of directories and files on the filesystem. cCsxxq|D]i}|j|}t||trP|j|j|||q|j||jdtjqWdS(s# Create a set of directories and files given a dict defining their structure. @param root: The directory in which to create the structure. It must already exist. @type root: L{FilePath} @param dirDict: The dict defining the structure. Keys should be strings naming files, values should be strings describing file contents OR dicts describing subdirectories. All files are written in binary mode. Any string values are assumed to describe text files and will have their newlines replaced with the platform-native newline convention. For example:: {"foofile": "foocontents", "bardir": {"barfile": "bar contents"}} @type dirDict: C{dict} s N( tchildt isinstancetdicttcreateDirectorytcreateStructuret setContenttreplacetostlinesep(tselftroottdirDicttxR/((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR3ds   cCsg|jD]}|j^q }x|D]}|j|}t||tr|j|jd|jf|j|||n5|j j t j d}|j ||||j|j|q,W|r|jd|j|fndS(s Assert that a directory is equivalent to one described by a dict. @param root: The filesystem directory to compare. @type root: L{FilePath} @param dirDict: The dict that should describe the contents of the directory. It should be the same structure as the C{dirDict} parameter to L{createStructure}. @type dirDict: C{dict} s%s is not a dir!s s#There were extra children in %s: %sN(tchildrentbasenameR/R0R1t assertTruetisdirtpathtassertStructuret getContentR5R6R7t assertEqualstremovetfail(R8R9R:R;R<R/ta((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRAs %  cCsytjj|jd}t|j}|jx$|D]}|j|d|jq;W|j|j d|dS(s Assert that a tarfile content is equivalent to one described by a dict. @param outputFile: The tar file built by L{DistributionBuilder}. @type outputFile: L{FilePath}. @param dirDict: The dict that should describe the contents of the directory. It should be the same structure as the C{dirDict} parameter to L{createStructure}. @type dirDict: C{dict} sr:bz2R@iN( ttarfiletTarFiletopenR@RtmktempR2textractRAR<(R8t outputFileR:ttarFilet extractedtinfo((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytassertExtractedStructures   (t__name__t __module__t__doc__R3RARP(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR._s  tChangeVersionTestcBsDeZdZdZdZdZdZdZdZRS(s5 Twisted has the ability to change versions. cCslt|j}tjj|\}}|j|}|j|j|}|j|j||S(s Create a file with the given content relative to a temporary directory. @param relativePath: The basename of the file to create. @param content: The content that the file will have. @return: The filename. ( RRJR6R@tsplitt preauthChildtmakedirsR/R4(R8t relativePathtcontentt baseDirectoryt directorytfilenametfile((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytmakeFiles cCs]tj}|jt}td|dd}|jt|d|td|dddS(s When calculating the next version to release when a release is happening in the same year as the last release, the minor version number is incremented. ttwistedi itnowi N(RttodaytyearRRRCR (R8R`tmajortversion((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_getNextVersions   cCsatj}|jt}td|ddd}|jt|d|td|dddS(s When calculating the next version to release when a release is happening in a later year, the minor version number is reset to 0. R_ii iR`N(RRaRbRRRCR (R8R`RcRd((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt"test_getNextVersionAfterYearChanges   cCsd}t|ddd}|jdd|j}t|ddd}t|||j|j|jd|jd S( s _changeVersionInFile replaces the old version information in a file with the given new version information. tfooiiitREADMEsHello and welcome to %s.iiN(RR^tbaseR R@t assertEqualRB(R8t packageNamet oldVersionR]t newVersion((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_changeVersionInFiles cCs"t|j}|jidd6iidd6d6tddddd6iidd6d6td dddd6d 6d6}|j||t|td ddd id d6iidd6d6tdddd d6iidd6d6td ddd d6d 6d6}|j||dS(s L{changeAllProjectVersions} changes all version numbers in _version.py and README files for all projects as well as in the the top-level README file. sHi this is 1.0.0.RhsHi this is 1.0.0ttopfilesR_iis _version.pys twisted.webtwebtlolisHi this is 1.0.2.sHi this is 1.0.2N(RRJR2R-R3RRRA(R8R9t structuret outStructure((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_changeAllProjectVersionss2   !  !c Csrt|j}|jd}d}idd6||d6iidd6|d6d6tdd d d d 6iid d6|d6d6td d d d d d 6d6d6}|j||t|tdd d ddd}d}idd6||d6iidd6|d6d6tdd d dd 6iidd6|d6d6td d d dd 6d6d6}|j||dS(s L{changeAllProjectVersions} changes all version numbers in _version.py and README files for all projects as well as in the the top-level README file. If the old version was a pre-release, it will change the version in NEWS files as well. sATwisted Core 1.0.0 (2009-12-25) =============================== sGTwisted Web 1.0.0pre1 (2009-12-25) ================================== sHi this is 1.0.0.RhtNEWSsHi this is 1.0.0RoR_iis _version.pysHi this is 1.0.0pre1s twisted.webRpRqis 2010-01-01s?Twisted Web 1.0.2 (2010-01-01) ============================== sHi this is 1.0.2.sHi this is 1.0.2N(RRJR2R-R3RRRA(R8R9tcoreNewstwebNewsRrRs((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt'test_changeAllProjectVersionsPreReleasesF    $   !( RQRRRSR^ReRfRnRtRx(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRTs   %t ProjectTestcBsYeZdZdZd dZdZdZdZdZ dZ dZ RS( s= There is a first-class representation of a project. cCs|jt|t|t|dtjd}t|dtjd}x3t||D]"\}}|j|j|jqbWdS(sA Assert that two lists of L{Project}s are equal. tkeyR[N(Rjtlentsortedtoperatort attrgettertzipR[(R8tobservedProjectstexpectedProjectstobservedtexpected((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytassertProjectsEqualUs  cCs|dkr+t|j}|jn|jjd}|}xL|D]D}|j|}|jsx|jn|jdjdqJW|jdj|jdjdj|j t |jdj |t |S(s( Make a Twisted-style project in the given base directory. @param baseDirectory: The directory to create files in (as a L{FilePath). @param version: The version information for the project. @return: L{Project} pointing to the created project. t.s __init__.pytRoRhs _version.pyN( tNoneRRJR2tpackageRUR/texistsR4RiR R@R(R8RdRZtsegmentsR[tsegment((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt makeProjectbs     %cGsAt|j}|jx|D]}|j||q#W|S(s Create a series of projects underneath a temporary base directory. @return: A L{FilePath} for the base directory. (RRJR2R(R8tversionsRZRd((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt makeProjects|s   cCs>tdddd}|j|}|j|j|dS(s5 Project objects know their version. RgiiiN(RRRCt getVersion(R8Rdtproject((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_getVersionscCs|jtdddd}tdddd}|j||j|j||j|jjdjdjd d S( sc Project objects know how to update the version numbers in those projects. tbariiiii RoRhs3.2.9N(RRt updateVersionRCRR[R/RB(R8RRm((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_updateVersions cCs3ttd}|jt|d|jdS(sH The representation of a Project is Project(directory). Rs Project(%r)N(RRRjtreprR[(R8Rg((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_reprscCs}|jtddddtdddd}t|}|j|t|jdt|jdjdgd S( s findTwistedStyleProjects finds all projects underneath a particular directory. A 'project' is defined by the existence of a 'topfiles' directory and is returned as a Project object. Rgiiisfoo.bariiRN(RRR RRR/(R8RZtprojects((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_findTwistedStyleProjectss* cCst|j}|jtj}d}t|ddd}t|d|}|j||}t|d||j |j ||j |j j dj dj |jdS( sq Update Twisted version information in the top-level project and all of the subprojects. RgiiiR`RoRhN(RRJR2RRaRR RRRjRR[R/RBRi(R8RZR`t projectNameRlRmR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt$test_updateTwistedVersionInformations  N( RQRRRSRRRRRRRRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRyPs   t UtilityTestcBs eZdZdZdZRS(s< Tests for various utility functions for releasing. cCsEtj}d}|jttj||j|tjdS(s Test that the runChdirSafe is actually safe, i.e., it still changes back to the original directory even if an error is raised. cSs&tjdtjddddS(Nt releaseChii(R6tmkdirtchdir(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt chAndBreaks  N(R6tgetcwdt assertRaisestZeroDivisionErrorRt runChdirSafeRC(R8tcwdR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_chdirs     cCsd}tdd}|j||j|jdd}tdidd6|jtdj||jdd}tdidd6|jtdj|dS(s L{replaceInFile} replaces data in a file based on a dict. A key from the dict that is found in the file is replaced with the corresponding value. sfoo hey hey $VER bar srelease.replacetws$VERs2.0.0s3.0.0N(RItwritetcloseR5R RCtread(R8tin_toutfR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_replaceInFiles  (RQRRRSRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs tVersionWritingTestcBs eZdZdZdZRS(s- Tests for L{replaceProjectVersion}. cCsTtdtddddidd6}td||j|djdd S( s L{replaceProjectVersion} writes a Python file that defines a C{version} variable that corresponds to the given name and version number. t test_projectstwisted.test_projectiiRit __name___Rds0.82.7N(R RtexecfileRCRi(R8tns((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_replaceProjectVersions   c CsZtdtddddddidd6}td||j|d jd d S( s L{replaceProjectVersion} will write a Version instantiation that includes a prerelease parameter if necessary. Rstwisted.test_projectiiRit prereleaseiRRds 0.82.7pre8N(R RRRCRi(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt(test_replaceProjectVersionWithPrereleases    (RQRRRSRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs tBuilderTestsMixincBskeZdZdZdZdZdddZdZdddZd Z d Z dd Z RS( sx A mixin class which provides various methods for creating sample Lore input and output. @cvar template: The lore template that will be used to prepare sample output. @type template: C{str} @ivar docCounter: A counter which is incremented every time input is generated and which is included in the documents. @type docCounter: C{int} s Yo:
Index Version: cCs d|_dS(sP Initialize the doc counter which ensures documents are unique. iN(t docCounter(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytsetUp4scCs2|jtj|jtj|jdS(sJ Verify that two strings represent the same XML document. N(Rjtdomt parseStringttoxml(R8tfirsttsecond((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytassertXMLEqual;sRs%scCs@d}tj|i|d6|d6|d6|dd6jdS( sJ Get the correct HTML output for the arbitrary input returned by L{getArbitraryLoreInput} for the given parameters. @param version: The version string to include in the output. @type version: C{str} @param counter: A counter to include in the output. @type counter: C{int} sO Yo:Hi! Title: %(count)d
Hi! %(count)d
foobar
Index Version: %(version)s tcounttprefixRdtfoobart foobarLinksutf-8(R(RRR(R8RdtcounterRt apiBaseURLtdocument((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytgetArbitraryOutputDs cCsd}|i|d6S(s Get an arbitrary, unique (for this test case) string of lore input. @param counter: A counter to include in the input. @type counter: C{int} stHi! Title: %(count)sHi! %(count)s
foobar
R((R8Rttemplate((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytgetArbitraryLoreInput^scCs@|jd7_|j|j|j||jd|d|fS(s Get an input document along with expected output for lore run on that output document, assuming an appropriately-specified C{self.template}. @param version: A version string to include in the input and output. @type version: C{str} @param prefix: The prefix to include in the link to the index. @type prefix: C{str} @return: A two-tuple of input and expected output. @rtype: C{(str, str)}. iRR(RRR(R8RdRR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytgetArbitraryLoreInputAndOutputpscCsdS(s4 Get an arbitrary man page content. s+.TH MANHOLE "1" "August 2001" "" "" .SH NAME manhole \- Connect to a Twisted Manhole service .SH SYNOPSIS .B manhole .SH DESCRIPTION manhole is a GTK interface to Twisted Manhole services. You can execute python code as if at an interactive Python console inside a running Twisted process with this.((R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytgetArbitraryManInputs cCsdS(s Get an arbitrary lore input document which represents man-to-lore output based on the man page returned from L{getArbitraryManInput} s. MANHOLE.1

MANHOLE.1

NAME

manhole - Connect to a Twisted Manhole service

SYNOPSIS

manhole

DESCRIPTION

manhole is a GTK interface to Twisted Manhole services. You can execute python code as if at an interactive Python console inside a running Twisted process with this.

((R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytgetArbitraryManLoreOutputs cCs(tjdi|d6|d6jdS(s} Get an arbitrary lore output document which represents the lore HTML output based on the input document returned from L{getArbitraryManLoreOutput}. @param version: A version string to include in the document. @type version: C{str} @param prefix: The prefix to include in the link to the index. @type prefix: C{str} sn Yo:MANHOLE.1

NAME

manhole - Connect to a Twisted Manhole service

SYNOPSIS

manhole

DESCRIPTION

manhole is a GTK interface to Twisted Manhole services. You can execute python code as if at an interactive Python console inside a running Twisted process with this.

Index Version: %(version)s RRdsutf-8(RRR(R8RdR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytgetArbitraryManHTMLOutputs ( RQRRRSRRRRRRRRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs        "tDocBuilderTestCasecBseZdZeZdZdZdZdZdZ dZ dZ dZ d Z d Zd Zd ZRS( se Tests for L{DocBuilder}. Note for future maintainers: The exact byte equality assertions throughout this suite may need to be updated due to minor differences in lore. They should not be taken to mean that Lore must maintain the same byte format forever. Feel free to update the tests when Lore changes, but please be careful. cCsgtj|t|_t|j|_|jj|jjd|_ |j j |j dS(s Set up a few instance variables that will be useful. @ivar builder: A plain L{DocBuilder}. @ivar docCounter: An integer to be used as a counter by the C{getArbitrary...} methods. @ivar howtoDir: A L{FilePath} representing a directory to be used for containing Lore documents. @ivar templateFile: A L{FilePath} representing a file with C{self.template} as its content. s template.tplN( RRRtbuilderRRJthowtoDirR2R/t templateFileR4R(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs   cCsd}|j|\}}|j|\}}|jjdj||jjdj||jj||j|j|j|jjd}|jjd}|j|j||j|j|dS(sU The L{DocBuilder} runs lore on all .xhtml files within a directory. s1.2.3s one.xhtmls two.xhtmlsone.htmlstwo.htmlN( RRR/R4RtbuildRRRB(R8Rdtinput1toutput1tinput2toutput2tout1tout2((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_builds cCs/|jt|jjd|j|j|jdS(s} The C{build} method raises L{NoDocumentsFound} if there are no .xhtml files in the given directory. s1.2.3N(RRRRRR(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_noDocumentsFoundscCs|jd}|jjd}|j|jdj||jjd|j||j|jd}|jd|j dS(s The L{DocBuilder} generates correct links from documents to template-generated links like stylesheets and index backreferences. ittutorials child.xhtmls1.2.3s child.htmls!IndexN( RRR/R2R4RRRtassertInRB(R8tinputttutoDirtoutFile((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_parentDocumentLinkings  cCs|jd}|jjd}|jjd}|j|jdj||jjd|||j|jd}|jd|j dS( s It is necessary to generate documentation in a directory foo/bar where stylesheet and indexes are located in foo/baz. Such resources should be appropriately linked to. it resourcestdocss child.xhtmls1.2.3s child.htmls+IndexN( RRR/R2R4RRRRRB(R8Rt resourceDirtdocDirR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt$test_siblingDirectoryDocumentLinking.s  cCsd}|j|\}}|jjdj||jj||j|j|jd|jjd}|jd|jdS(sh The L{DocBuilder} generates correct links from documents to API documentation. s1.2.3s one.xhtmlsscheme:apilinks/%s.extsone.htmls>foobarN( RRR/R4RRRRRB(R8RdRtoutputtout((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_apiLinking?s cCs|jd}|jjdj||jjd|j|j|jdt|j|jjdj |j |jjdj dS(s L{DocBuilder.build} can be instructed to delete the input files after generating the output based on them. is one.xhtmltwhatevert deleteInputsone.htmlN( RRR/R4RRRtTrueR>Rt assertFalse(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_deleteInputPs cCs|jd}|jjdj||jjd|j|j|j|j|jjdj|j|jjdjdS(s7 Input will not be deleted by default. is one.xhtmlRsone.htmlN( RRR/R4RRRR>R(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_doNotDeleteInput]s  cCs5|jjtdtd}|j|ddS(sr If the doc and resource directories are the same, the linkrel should be an empty string. s/foo/barRN(Rt getLinkrelRRC(R8tlinkrel((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_getLinkrelToSameDirectoryiscCs5|jjtdtd}|j|ddS(sy If the doc directory is a child of the resource directory, the linkrel should make use of '..'. s/foos/foo/bars../N(RRRRC(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_getLinkrelToParentDirectorysscCs5|jjtdtd}|j|ddS(s If the doc directory is a sibling of the resource directory, the linkrel should make use of '..' and a named segment. s /foo/howtos /foo/exampless ../howto/N(RRRRC(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_getLinkrelToSibling}scCs5|jjtdtd}|j|ddS(s If the doc directory is a sibling of the parent of the resource directory, the linkrel should make use of multiple '..'s and a named segment. s /foo/howtos/foo/examples/quotess ../../howto/N(RRRRC(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_getLinkrelToUncles(RQRRRStloreSkiptskipRRRRRRRRRRRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs       tAPIBuilderTestCasecBs8eZdZeZdZdZdZdZRS(s" Tests for L{APIBuilder}. c Cst}|jtd|d}d}d}d}d}d}t|jj|}|j|jdjd ||ft|j} | jt} | j ||||| | jd } |j | j d | j f|j d ||f| jd | jd} |j | j d| j f|j || jd|j d||f| j|j d||f| j|j || j|j | jdj |j|jddS(st L{APIBuilder.build} writes an index file which includes the name of the project specified. tstdouttFoobartquuxsscheme:projects scheme:sourcestext in docstringsshould also appear in outputs __init__.pys(def foo(): '%s' def _bar(): '%s's index.htmlsAPI index %r did not exist.s%ss+Project name/location not in file contents.s quux.htmls,Package documentation file %r did not exist.s,Docstring not in package documentation file.sView Sources:s quux.foo.htmlRN(RtpatchtsysRRJR/RWR4RRR>RR@RRBtsiblingRjtgetvalue( R8RRRkt projectURLt sourceURLt docstringtprivateDocstringt inputPatht outputPathRt indexPathtquuxPath((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRsT             c Cszt}|jtd|d}t|j}|jd}|j|jdjd|f|jdjtddddt|j}t }|j |||jd }|j |j d |j f|jd |jd |jd }|j |j d|j f|j||jd|jd|j|j|jddS(s L{BuildAPIDocsScript.buildAPIDocs} builds the API docs with values appropriate for the Twisted project. Rstext in docstringR_s __init__.pysdef foo(): '%s' s _version.pyiis index.htmlsAPI index %r did not exist.s/Twisteds+Project name/location not in file contents.s twisted.htmls,Package documentation file %r did not exist.s,Docstring not in package documentation file.scView SourceRN(RRRRRJR/RWR4R-Rt buildAPIDocsR>RR@RRBRjR( R8RRt projectRoott packagePathRtscriptRt twistedPath((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_buildWithPolicysD         cCs[t}|jt|jg|jt|jdg|jt|jdddgdS(s SystemExit is raised when the incorrect number of command line arguments are passed to the API building script. RgRtbazN(RRt SystemExittmain(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt-test_apiBuilderScriptMainRequiresTwoArgumentss cs]t}gfd|_|jddg|jtdtdfgdS(sk The API building script invokes the same code that L{test_buildWithPolicy} tests. csj||fS(N(tappend(RFtb(tcalls(sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytsthellotthereN(RRR RCR(R8R((RsD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_apiBuilderScriptMains  ( RQRRRSt pydoctorSkipRRR RR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs  < 1 tManBuilderTestCasecBs8eZdZeZdZdZdZdZRS(s" Tests for L{ManBuilder}. cCs?tj|t|_t|j|_|jjdS(s Set up a few instance variables that will be useful. @ivar builder: A plain L{ManBuilder}. @ivar manDir: A L{FilePath} representing a directory to be used for containing man pages. N(RRRRRRJtmanDirR2(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR$s  cCs |jt|jj|jdS(sy L{ManBuilder.build} raises L{NoDocumentsFound} if there are no .1 files in the given directory. N(RRRRR(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR2scCs|j}|jjdj||jj|j|jjdj}|j}|jdt j }|j ||dS(s Check that L{ManBuilder.build} find the man page in the directory, and successfully produce a Lore content. stest1.1stest1-man.xhtmls N( RRR/R4RRRBRR5R6R7RC(R8t manContentRR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR:s  cCs|j}|jjdj||jj|j|jjd}|jtjt}|jd|j|j||jjdj }|j |ddS(sr Check that the content output by C{build} is compatible as input of L{DocBuilder.build}. stest1.1s template.tpls1.2.3stest1-man.htmls^ Yo:MANHOLE.1

NAME

manhole - Connect to a Twisted Manhole service

SYNOPSIS

manhole

DESCRIPTION

manhole is a GTK interface to Twisted Manhole services. You can execute python code as if at an interactive Python console inside a running Twisted process with this.

Index Version: 1.2.3 N( RRR/R4RRRRRRBR(R8RRt docBuilderR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_toHTMLIs  ( RQRRRSRRRRRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs    tBookBuilderTestscBseZdZepeZdZdZdddZ dZ dZ dZ dZ d Zd Zd Zd Zd ZdZdZdZdZdZdZdZdZdZRS(s# Tests for L{BookBuilder}. cCsJd|_t|j|_|jjtjtjtj|_dS(sG Make a directory into which to place temporary files. iN( RRRJRRWtsignaltSIGCHLDtSIG_DFLt oldHandler(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs  cCstjtj|jdS(N(RRR (R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttearDownsRcCs2|jjd|fj}di|d6|d6S(s Create and return a C{str} containing the LaTeX document which is expected as the output for processing the result of the document returned by C{self.getArbitraryLoreInput(counter)}. s%d.xhtmlsB\section{Hi! Title: %(count)s\label{%(path)s}} Hi! %(count)sfoobarRR@(RR/R@(R8RdRRRR@((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRscCs2t}|j|jtjddgddS(s L{BookBuilder.run} executes the command it is passed and returns a string giving the stdout and stderr of the command if it completes successfully. s-csgimport sys; sys.stdout.write("hi\n"); sys.stdout.flush(); sys.stderr.write("bye\n"); sys.stderr.flush()shi bye N(RRCtrunRt executable(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_runSuccesss    cCsjt}|jt|jtjddg}|j|jd|j|jd|j|j ddS(s L{BookBuilder.run} executes the command it is passed and raises L{CommandFailed} if it completes unsuccessfully. s-csprint "hi"; raise SystemExit(1)ishi N( RRRR"RR#RCt exitStatust exitSignalRR(R8Rtexc((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_runFaileds  cCsjt}|jt|jtjddg}|j|jd|j|jd|j|j ddS(s L{BookBuilder.run} executes the command it is passed and raises L{CommandFailed} if it exits due to a signal. s-csNimport sys; print "hi"; sys.stdout.flush(); import os; os.kill(os.getpid(), 9)i shi N( RRRR"RR#RCR&R%RR(R8RR'((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_runSignaleds    cCsd}|j|\}}|j|\}}|jjdj||jjdj|t}|j|j|j|jjdj||j|jjdj|dS(sx L{BookBuilder.buildTeX} writes intermediate TeX files for all lore input files in a directory. s3.2.1s1.xhtmls2.xhtmls1.texs2.texN(RRR/R4RtbuildTeXRjRB(R8RdRRRRR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_buildTeXs "cCs,t}|jt|j|jjdS(sr L{BookBuilder.buildTeX} raises L{ValueError} if passed a directory which does not exist. N(RRt ValueErrorR*RttemporarySibling(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt$test_buildTeXRejectsInvalidDirectorys cCs'|jjdjd|jdS(sd L{BookBuilder.buildTeX} ignores files which which don't end with ".xhtml". s not-input.datt>N(RR/R4R+(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_buildTeXOnlyBuildsXHTMLscCsVt}|jtd||jtdd|j|j|jddS(sC L{BookBuilder.buildTeX} does not write to stdout. Rtwarnc_sdS(N(R(RFtkw((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRsRN(RRRtwarningsR+RjR(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_stdouts   cCs>t}|jt|jt|jjddddS(su L{BookBuilder.buildPDF} raises L{ValueError} if the book filename does not end with ".tex". RgN(RRR,tbuildPDFRRJR/R(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt'test_buildPDFRejectsInvalidBookFilenames cCs&td}|j||j|S(Ni(tranget_setupTeXSectionst _setupTeXBook(R8tsections((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt_setupTeXFiless  cCsGx@|D]8}|jjd|f}|j|jd|qWdS(Ns%d.texs1.2.3(RR/R4R(R8R:ttexSectionNumberttexPath((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR8s  cCsN|jjd}|jddjg|D]}d|f^q(d|S(Nsbook.texs&\documentclass{book} \begin{document} s s\input{%d.tex}s\end{document} (RR/R4tjoin(R8R:tbookTeXtn((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR9s *cCsT|j}t|j}t}|j||j||j|jdS(s~ L{BookBuilder.buildPDF} creates a PDF given an index tex file and a directory containing .tex files. N(R;RRJRR5RR>R(R8tbookPathRR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_buildPDF&s   cCs|jjddjddjdd|_|jj|j}t|j}t}|j||j||j|j dS(s L{BookBuilder.buildPDF} succeeds even if the paths it is operating on are very long. C{ps2pdf13} seems to have problems when path names are long. This test verifies that even if inputs have long paths, generation still succeeds. R;iN( RR/RWR;RRJRR5R>R(R8RARR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_buildPDFLongPath4s 3   c CsdtfdY}|j}t|j}|}|j||j||j\}}}}} |j|||j|||j|d dgd|f|j|d|jgd||jf|j|d dgd |f|j| d d gd | fd S( sD L{BookBuilder.buildPDF} runs C{latex} three times. tInspectableBookBuildercBseZdZdZRS(cSstj|g|_dS(N(Rt__init__tcommands(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyREPs cSs |jj|tj||S(sI Record the command and then execute it. (RFRRR"(R8tcommand((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR"Ts(RQRRRER"(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRDOs iR&s%LaTeX command %r does not seem right.is6LaTeX command %r does not end with the book path (%r).R's%dvips command %r does not seem right.R(s(ps2pdf13 command %r does not seem right.N( RR;RRJR5RRFRCR@( R8RDRARRtlatex1tlatex2tlatex3R'R(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_buildPDFRunsLaTeXThreeTimesKs*     cCstj}|j}|jj}|jj}t}|j||jt|j |j |tj|j ||jj|j ||jjdS(s The working directory is the same before and after a call to L{BookBuilder.buildPDF}. Also the contents of the directory containing the input book are the same before and after the call. N( R6RR;tparentR<RRR5RRJRj(R8tstartDirR?tstartTeXSiblingststartHowtoChildrenR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_noSideEffectsws   "cCst|jd}t}|jj}|jt|j||jt|j}|j |j t |jjt |}|j t |d|j}|j |jd|jfdS(s If a subprocess fails, L{BookBuilder.buildPDF} raises L{CommandFailed} with the subprocess's output and leaves the temporary directory as a sibling of the book path. s.texis*Expected work path %r was not a directory.N(RRJRRLR<RRR5RR>RRRjR{tpopR?R@(R8R?Rt inputStateR'tnewOutputStatetworkPath((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_failedCommandProvidesOutputs "  cCstdd}x7|D]/}|jjd|fj|j|qW|j|}t|j}t}|j |j|jg|||j |j dS(sd L{BookBuilder.build} generates a pdf book file from some lore input files. iis%d.xhtmlN( R7RR/R4RR9RRJRRR>R(R8R:t sectionNumberR?tbookPDFR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs  cCstdd}x7|D]/}|jjd|fj|j|qW|j|}t|j}t}|j |j|jg|||j t |jj t |j gg|D]}d|f^qdS(sW L{BookBuilder.build} removes the intermediate LaTeX files it creates. iis%d.xhtmlN(R7RR/R4RR9RRJRRRjRtlistdirR=(R8R:RVR?RWRR@((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt$test_buildRemovesTemporaryLaTeXFiless  N(RQRRRSt latexSkipRRRR!RRR$R(R)R+R.R0R4R6R;R8R9RBRCRKRPRURRY(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRzs.             ,   tFilePathDeltaTestcBs2eZdZdZdZdZdZRS(s% Tests for L{filePathDelta}. cCs,|jttdtddgdS(sU L{filePathDelta} can create a simple relative path to a child path. s/foo/bars /foo/bar/bazR N(RCRR(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_filePathDeltaSubdirs cCs/|jttdtdddgdS(se L{filePathDelta} can traverse upwards to create relative paths to siblings. s/foo/bars/foo/bazs..R N(RCRR(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_filePathDeltaSiblingDirs cCs5|jttdtdddddgdS(sx L{filePathDelta} can create relative paths to totally unrelated paths for maximum portability. s/foo/bars /baz/quuxs..R RN(RCRR(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_filePathNoCommonElementss cCs5|jttdtdddddgdS(s L{filePathDelta} doesn't take into account final elements when comparing 2 paths, but stops at the first difference. s/foo/bar/bar/spams/foo/bar/baz/spams..R tspamN(RCRR(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt$test_filePathDeltaSimilarEndElementss (RQRRRSR\R]R^R`(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR[s  tNewsBuilderTestscBseZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZRS(s# Tests for L{NewsBuilder}. cCst|_t|j|_|jjd|_|j|ji |jd6dd6dd6dd6d d 6d d 6d d6dd6dd6dd6dd6dS(sc Create a fake project and stuff some basic structure and content into it. s,Here is stuff which was present previously. RusWe now support the web. s 5.featuresThe widget is more robust. s 12.featuresA very long feature which takes many words to describe with any accuracy was introduced so that the line wrapping behavior of the news generating code could be verified. s 15.features9A simpler feature described on multiple lines was added. s 16.featuresBroken stuff was fixed. s 23.bugfixsStupid stuff was deprecated. s 25.removalRs30.miscs35.miscsfoo.bar.Baz.quuxs40.docswriting Foo serverss41.docN(R"RRRJRR2t existingTextR3(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs     cCs,|j|jjtjjddS(sP L{NewsBuilder._today} returns today's date in YYYY-MM-DD form. s%Y-%m-%dN(RCRt_todayRRatstrftime(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_todayscCs>|jj|j|jj}|j|d d d d gd S(s When called with L{NewsBuilder._FEATURE}, L{NewsBuilder._findChanges} returns a list of bugfix ticket numbers and descriptions as a list of two-tuples. isWe now support the web.i sThe widget is more robust.isA very long feature which takes many words to describe with any accuracy was introduced so that the line wrapping behavior of the news generating code could be verified.is8A simpler feature described on multiple lines was added.N(isWe now support the web.(i sThe widget is more robust.(isA very long feature which takes many words to describe with any accuracy was introduced so that the line wrapping behavior of the news generating code could be verified.(is8A simpler feature described on multiple lines was added.(Rt _findChangesRt_FEATURERC(R8tfeatures((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_findFeaturess cCs5|jj|j|jj}|j|dgdS(s When called with L{NewsBuilder._BUGFIX}, L{NewsBuilder._findChanges} returns a list of bugfix ticket numbers and descriptions as a list of two-tuples. isBroken stuff was fixed.N(isBroken stuff was fixed.(RRfRt_BUGFIXRC(R8tbugfixes((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_findBugfixes/s  cCs5|jj|j|jj}|j|dgdS(s When called with L{NewsBuilder._REMOVAL}, L{NewsBuilder._findChanges} returns a list of removal/deprecation ticket numbers and descriptions as a list of two-tuples. isStupid stuff was deprecated.N(isStupid stuff was deprecated.(RRfRt_REMOVALRC(R8tremovals((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_findRemovals<s  cCs8|jj|j|jj}|j|ddgdS(s When called with L{NewsBuilder._DOC}, L{NewsBuilder._findChanges} returns a list of documentation ticket numbers and descriptions as a list of two-tuples. i(sfoo.bar.Baz.quuxi)swriting Foo serversN(i(sfoo.bar.Baz.quux(i)swriting Foo servers(RRfRt_DOCRC(R8tdoc((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_findDocumentationIs  cCs8|jj|j|jj}|j|ddgdS(s When called with L{NewsBuilder._MISC}, L{NewsBuilder._findChanges} returns a list of removal/deprecation ticket numbers and descriptions as a list of two-tuples. iRi#N(iR(i#R(RRfRt_MISCRC(R8tmisc((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_findMiscellaneousWs  cCs6t}|jj|d|j|jddS(s L{NewsBuilder._writeHeader} accepts a file-like object opened for writing and a header string and writes out a news file header to it. sSuper Awesometastic 32.16s5Super Awesometastic 32.16 ========================= N(RRt _writeHeaderRCR(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_writeHeaderes   cCs?t}|jj|ddd g|j|jddS( s L{NewsBuilder._writeSection} accepts a file-like object opened for writing, a section name, and a list of ticket information (as returned by L{NewsBuilder._findChanges}) and writes out a section header and all of the given ticket information. tFeaturesis Great stuff.ismVery long line which goes on and on and on, seemingly without end until suddenly without warning it does end.sFeatures -------- - Great stuff. (#3) - Very long line which goes on and on and on, seemingly without end until suddenly without warning it does end. (#17) N(is Great stuff.(ismVery long line which goes on and on and on, seemingly without end until suddenly without warning it does end.(RRt _writeSectionRCR(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_writeSectionss    cCs^t}|jj|dgtdddD]}|df^q+|j|jddS(s- L{NewsBuilder._writeMisc} accepts a file-like object opened for writing, a section name, and a list of ticket information (as returned by L{NewsBuilder._findChanges} and writes out a section header and all of the ticket numbers, but excludes any descriptions. tOtherii2iRs_Other ----- - #2, #5, #8, #11, #14, #17, #20, #23, #26, #29, #32, #35, #38, #41, #44, #47 N(RRt _writeMiscR7RCR(R8RR;((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_writeMiscs  , cCsX|jj|j|jjdd|jjdj}|j|d|jdS(s L{NewsBuilder.build} updates a NEWS file with new features based on the I{.feature} files found in the directory specified. RusSuper Awesometastic 32.16sSuper Awesometastic 32.16 ========================= Features -------- - We now support the web. (#5) - The widget is more robust. (#12) - A very long feature which takes many words to describe with any accuracy was introduced so that the line wrapping behavior of the news generating code could be verified. (#15) - A simpler feature described on multiple lines was added. (#16) Bugfixes -------- - Broken stuff was fixed. (#23) Improved Documentation ---------------------- - foo.bar.Baz.quux (#40) - writing Foo servers (#41) Deprecations and Removals ------------------------- - Stupid stuff was deprecated. (#25) Other ----- - #30, #35 N(RRRR/RBRCRb(R8tresults((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs cCst|jjd}|j|j|i|jd6|jj||jdd|jdj}|j |d|jj d|jdS(s If no changes exist for a project, I{NEWS} gains a new section for that project that includes some helpful text about how there were no interesting changes. R_RusSuper Awesometastic 32.16s5Super Awesometastic 32.16 ========================= s N( RRJR/RWR3RbRRRBRCt _NO_CHANGES(R8RR~((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_emptyProjectCalledOuts   cCsR|jjd}|jd|jj|j|d|j|jddS(s If a I{NEWS} file begins with the two magic lines which point readers at the issue tracker, those lines are kept at the top of the new file. RusTicket numbers in this file can be looked up by visiting http://twistedmatrix.com/trac/ticket/ Blah blah other stuff. sSuper Awesometastic 32.16sTicket numbers in this file can be looked up by visiting http://twistedmatrix.com/trac/ticket/ Super Awesometastic 32.16 ========================= Features -------- - We now support the web. (#5) - The widget is more robust. (#12) - A very long feature which takes many words to describe with any accuracy was introduced so that the line wrapping behavior of the news generating code could be verified. (#15) - A simpler feature described on multiple lines was added. (#16) Bugfixes -------- - Broken stuff was fixed. (#23) Improved Documentation ---------------------- - foo.bar.Baz.quux (#40) - writing Foo servers (#41) Deprecations and Removals ------------------------- - Stupid stuff was deprecated. (#25) Other ----- - #30, #35 Blah blah other stuff. N(RR/R4RRRCRB(R8tnews((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_preserveTicketHints cCsx:|jjD])}|jdd kr|jqqW|jj|j|jjdd|j|jjdjddS( s If there are no changes of a particular type (feature, bugfix, etc), no section for that type is written by L{NewsBuilder.build}. is.features.miscs.docRusSome Thing 1.2sSome Thing 1.2 ============== Bugfixes -------- - Broken stuff was fixed. (#23) Deprecations and Removals ------------------------- - Stupid stuff was deprecated. (#25) Here is stuff which was present previously. N(s.features.miscs.doc( RR<tsplitextRDRRR/RCRB(R8tticket((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_emptySectionsOmitteds csfd}|dj|d|dj|djjjjjddjjjdjddS( sr If two change files have the same contents, they are merged in the generated news entry. csjj|dS(Ns.feature(RR/(ts(R8(sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytfeature6st5t15t16RusProject Name 5.0sProject Name 5.0 ================ Features -------- - We now support the web. (#5, #15, #16) - The widget is more robust. (#12) Bugfixes -------- - Broken stuff was fixed. (#23) Improved Documentation ---------------------- - foo.bar.Baz.quux (#40) - writing Foo servers (#41) Deprecations and Removals ------------------------- - Stupid stuff was deprecated. (#25) Other ----- - #30, #35 Here is stuff which was present previously. N(tcopyToRRRR/RCRB(R8R((R8sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_duplicatesMerged1s c Cst|jjd}|j|j|idd6tddddd6idd6d d 6d d 6d 6itddddd6idd6dd6d 6d6|S(sF Create a fake-looking Twisted project to build from. R_s Old boring stuff from the past. Ruiiis _version.pysOld core news. sThird feature addition. s 3.featureRs5.miscRos twisted.conchiisOld conch news. sFixed that bug. s7.bugfixtconch(RRJR/RWR3R-(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytcreateFakeTwistedProject]s   c sgt}fd|_d|_|j}|j||jd}|jd}d}|jdjd}|jd}d}|jd} |j|||f|||f|| |f|| |fgdS( s L{NewsBuilder.buildAll} calls L{NewsBuilder.build} once for each subproject, passing that subproject's I{topfiles} directory as C{path}, the I{NEWS} file in that directory as C{output}, and the subproject's name as C{header}, and then again for each subproject with the top-level I{NEWS} file for C{output}. Blacklisted subprojects are skipped. csj|||fS(N(R(R@Rtheader(tbuilds(sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR~scSsdS(Ns 2009-12-01((((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRsRoRusTwisted Core 1.2.3 (2009-12-01)Rs Twisted Conch 3.4.5 (2009-12-01)N(R"RRcRtbuildAllR/RC( R8RRt coreTopfilesRvt coreHeadert conchTopfilest conchNewst conchHeadert aggregateNews((RsD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt test_buildAllss&        cCst}d|_|j}|j|tdddd}|jdjd}|j|dtdd d d |d d }|j|d|jdS(s| L{NewsBuilder._changeVersions} gets the release date for a given version of a project as a string. cSsdS(Ns 2009-12-01((((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRstTEMPLATEiiRoRutCoreR_iiis 2010-01-01sTwisted Core 7.7.14 (2010-01-01) ================================ Features -------- - Third feature addition. (#3) Other ----- - #5 sOld core news. N( R"RcRRRR/t_changeNewsVersionRCRB(R8RRRmRvt expectedCore((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_changeVersionInNewss      (RQRRRSRReRiRlRoRrRuRwRzR}RRRRRRRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRas&         +  3  ,  $tDistributionBuilderTestBasecBseZdZeZdZRS(s3 Base for tests of L{DistributionBuilder}. cCsmtj|t|j|_|jjt|j|_|jjt|j|j|_dS(N( RRRRJtrootDirR2t outputDirRR(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs    (RQRRRSRRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRstDistributionBuilderTestcBs>eZdZdZdZdZdZdZRS(c Csw|jd\}}|j}|jdd}|j}|jdd}|jddd\}}idd6dd6d d 6d d 6iid d6d6dd6d6iidd6idd 6dd6d6d6idd6d6idd6dd6d6d6iii|d 6d!6i|d"6d#6d6ii|jd$6d!6i|d%6d#6|d 6d&6d'6} idd6dd6d d 6d d 6iid d6d6dd6d6iidd6idd 6dd6d6d6idd6d6idd6dd6d6d6iii|d(6d!6i|d"6|d)6d#6d6ii|jd$6d!6i|d%6|d*6d#6|d(6d&6d'6} |j|j| |jjd} |j| | d+S(,ss The Twisted tarball contains everything in the source checkout, with built documentation. s10.0.0s ../howto/Rshowto/tTwistedRhR;t unrelateds copyright!tLICENSEsimport toplevelssetup.pysSET ROOTt websetrootRptTWISTDttwistdtbins import WEBs __init__.pysimport WEBINSTALLsWEB!Ros import WORDStwordssimport WEBPLUGstwisted_web.pysimport WORDPLUGstwisted_words.pytpluginsR_s index.xhtmlthowtos websetroot.1tmans template.tplstwistd.1tcoreRqs index.htmlswebsetroot-man.htmlstwistd-man.htmlN( RRRRR3RRt buildTwistedRP( R8t loreInputt loreOutputt manInput1t manOutput1t manInput2t manOutput2tcoreIndexInputtcoreIndexOutputRrRsRL((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_twistedDistributionsb             cCsidd6dd6dd6dd6iid d 6d 6id d 6d6d6iidd6idd6dd6d6d 6idd6d6idd6dd6d6d6}idd6dd6dd6id d 6d6iidd6d 6idd6d6d6}|j|j||jjd d}|j||dS(s The subproject tarball includes files like so: 1. twisted//topfiles defines the files that will be in the top level in the tarball, except LICENSE, which comes from the real top-level directory. 2. twisted/ is included, but without the topfiles entry in that directory. No other twisted subpackages are included. 3. twisted/plugins/twisted_.py is included, but nothing else in plugins is. sHI!@RhR;Rs copyright!Rsimport toplevelssetup.pysSET ROOTRRps#!imtimRRs import WEBs __init__.pysimport WEBINSTALLsWEB!Ros import WORDSsimport WEBPLUGstwisted_web.pysimport WORDPLUGstwisted_words.pyRR_s0.3.0N(R3RRtbuildSubProjectRP(R8RrRsRL((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_subProjectLayout s0    cCsidd6id6iidd6idd6d6d 6id 6d 6}idd6dd6iidd6d 6d 6}|j|j||jjd d }|j||d S(sG buildSubProject should work with minimal subprojects. s copyright!RRs import WEBs __init__.pysimport WEBINSTALLssetup.pyRoRpRR_s0.3.0N(R3RRRRP(R8RrRsRL((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_minimalSubProjectLayout5s cCs4|jd\}}|j}|jdd}idd6iidd6idd6d 6d 6d 6iii|d 6d 6i|d6d6d 6ii|jd6d 6d6d6}idd6dd6iidd6d 6d 6ii|d6d 6i|d6|d6d6d6}|j|j||jjd d}|j||dS(sf When building a subproject release, documentation should be built with lore. s0.3.0s ../howto/s copyright!Rs import WEBs __init__.pysimport WEBINSTssetup.pyRoRpR_s index.xhtmlRstwistd.1Rs template.tplRRqs index.htmlstwistd-man.htmlN( RRRRR3RRRRP(R8RRtmanInputt manOutputRrRsRL((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_subProjectDocBuildingMs(   cCs|jddd\}}|jd\}}|jddd\}}|jddd\}}|jddd\} } idd6idd 6id d 6d d 6d 6id d 6dd6d 6dd6idd6dd6dd6d6idd6dd6d6d6iii|jd6|d6i| d6d6d 6i|d6d!6i|d6d"6id#d#6d$6|d6d%6iid&d6d 6d'6d(6id)d*6id+d+6d'6d,6} idd6dd6dd6idd 6id d 6d d 6d 6dd6idd6dd6d6d6ii|jd6|d-6i| d-6d6d 6i|d-6d!6i|d-6d"6id#d#6d$6|d-6d(6id)d*6d,6} |j|j| |jjd} |j| | d.S(/s The core tarball looks a lot like a subproject tarball, except it doesn't include: - Python packages from other subprojects - plugins from other subprojects - scripts from other subprojects s8.0.0Rshowto/s ../howto/s../s copyright!RR_s __init__.pytpythonsroots!sroots.pyRs import conchs unrelated.pytplugins plugin.pytwebplugstwisted_web.pysinclude!stwisted_whatever.pyscred.pyRs import COREssetup.pys core readmeRhRos template.tpls index.xhtmlRRtspecificationstupgradessfoo.pytexamplesRtwebindexRpRqRRRRs index.htmlN(RRR3RRt buildCoreRP(R8t indexInputt indexOutputt howtoInputt howtoOutputt specInputt specOutputt upgradeInputt upgradeOutputt tutorialInputttutorialOutputRrRsRL((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_coreProjectLayoutnsj                cCsd}t|j|jd|}|jdd|\}}idd6iidd6idd 6d 6d 6d 6iii|d 6d6d 6ii|jd6d6d6d6}idd6dd 6iidd6d 6d 6ii|d6d6d6}|j|j||jd d}|j||dS(sc DistributionBuilder builds documentation with the specified API base URL. s http://%sRs0.3.0s copyright!Rs import WEBs __init__.pysimport WEBINSTssetup.pyRoRpR_s index.xhtmlRs template.tplRRqs index.htmlN(RRRRRR3RRP(R8RRRRRrRsRL((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_apiBaseURLs&  (RQRRRRRRRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs  ? +  ! FtBuildAllTarballsTestcBsAeZdZeZdZdZdZdZdZ RS(s< Tests for L{DistributionBuilder.buildAllTarballs}. cCs,tjtjtj|_tj|dS(N(RRRR RR(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRscCs'tjtj|jtj|dS(N(RRR RR!(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyR!sc CsX|j}t|}|j}t|}|jjtdd|gtddd|j|jg|jdddd d \}}id d 6d d6dd6dd6iidd6d6dd6d6iidd6dd 6d6tddddd 6id!d"6td#dddd 6id$d6d%d 6d6d6id&d'6d(d)6d*d+6d,6d6iii|jd-6d.6|d/6d06d16}id d 6d d6dd6dd6idd6idd6d6d6iidd6dd 6d6tddddd 6id!d"6td#dddd 6id$d6d%d 6d6d6id&d'6d(d)6d*d+6d,6d6iii|jd-6d.6|d26d06d16}idd6dd 6dd6idd6d6itddddd 6id*d+6d,6d6ii|jd-6d.6|d26d16} id%d 6dd6d$d6idd6d6iid!d"6td#dddd 6d6id(d)6d,6d6} |j ||g|j D]} | j^qY} tdd3g| tdd4|jd5d6gt ||j|j t |jj t |jjd7|jjd8|jjd9g|j|jjd7||j|jjd8| |j|jjd9| d:S(;s0 L{buildAllTarballs} builds tarballs for Twisted and all of its subprojects based on an SVN checkout; the resulting tarballs contain no SVN metadata. This involves building documentation, which it will build with the correct API documentation reference base URL. R*tcreateR)tcheckoutsfile://s1.2.0Rshowto/Rs4http://twistedmatrix.com/documents/1.2.0/api/%s.htmlRRhR;Rs copyright!Rsimport toplevelssetup.pys import imRRRRRsimport TOPINSTALLsCORE!RoR_iiis _version.pys import WORDSs __init__.pys twisted.wordssimport WORDSINSTALLsWORDS!simport WEBPLUGstwisted_web.pysimport WORDPLUGstwisted_words.pys import YAYstwisted_yay.pyRs template.tplRs index.xhtmlRRqs index.htmltaddtcommits-mtyaysTwisted-1.2.0.tar.bz2sTwistedCore-1.2.0.tar.bz2sTwistedWords-1.2.0.tar.bz2N(RJRRRDRR@RR-RR3R<RRCRR/RP( R8trepositoryPatht repositoryt checkoutPathRRRRrttwistedStructuret coreStructuretwordsStructureR;tchilds((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_buildAllTarballss                    "cCs|j}t|}|j}t|}tdd|gtddd|j|jg|jdjd|jtt|t|jdS( s L{UncleanWorkingDirectory} is raised by L{buildAllTarballs} when the SVN checkout provided has uncommitted changes. R*RR)Rsfile://RgRN( RJRRR@R/R4RRR(R8RRRR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt)test_buildAllTarballsEnsuresCleanCheckoutV s      cCsdt|j}|jtt|t|j|j|jtt|t|jdS(s L{NotWorkingDirectory} is raised by L{buildAllTarballs} when the checkout passed does not exist or is not an SVN checkout. N(RRJRRRR2(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt,test_buildAllTarballsEnsuresExistingCheckouti s   ( RQRRRStsvnSkipRRR!RRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRs   s t ScriptTestscBs}eZdZd dZdZdZdZdZdZ dZ dZ d Z d Z d Zd ZRS(s5 Tests for the release script functionality. csgfd}t}||_d|||f}|dk rZ|d|f7}n|j|g|jtd|jddtd|jddj||jddj||jddj ||jddj |dS(s Check that L{ChangeVersionsScript.main} calls the version-changing function with the appropriate version data and filesystem path. csj||fdS(N(R(t sourceTreetversionTemplate(tversionUpdates(sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pytmyVersionChanger ss%d.%d.%dspre%diiRN( R RRR RCR{RRctminortmicroR(R8RcRRRRtversionChangerRd((RsD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt_testVersionChanging~ s   cCs|jddddS(sh L{ChangeVersionsScript.main} changes version numbers for all Twisted projects. iiiN(R(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_changeVersions scCs|jdddddS(sK A prerelease can be specified to L{changeVersionsScript}. i iii&N(R(R8((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt!test_changeVersionsWithPrerelease scCs t}|j|jtdS(ss The default implementation of C{changeAllProjectVersions} is L{changeAllProjectVersions}. N(R RCR(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt(test_defaultChangeVersionsVersionChanger s  cCs#t}|jt|jgdS(sr L{changeVersionsScript} raises SystemExit when the wrong number of arguments are passed. N(R RR R (R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt/test_badNumberOfArgumentsToChangeVersionsScript s cCs&t}|jt|jdgdS(s L{changeVersionsScript} raises SystemExit when there are the wrong number of segments in the version number passed. s3.2.1.0N(R RR R (R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt&test_tooManyDotsToChangeVersionsScript s cCs&t}|jt|jdgdS(sv L{changeVersionsScript} raises SystemExit when the version number isn't made out of numbers. smy united.states.of prewhateverN(R RR R (R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt&test_nonIntPartsToChangeVersionsScript s cscgfd}t}||_|jddg|jtdtdfgdS(s L{BuildTarballsScript.main} invokes L{buildAllTarballs} with L{FilePath} instances representing the paths passed to it. csj||fdS(N(R(Rt destination(R(sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt myBuilder st checkoutDirtdestinationDirN(R!RR RCR(R8RttarballBuilder((RsD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_buildTarballsScript s  cCs t}|j|jtdS(sw The default implementation of L{BuildTarballsScript.buildAllTarballs} is L{buildAllTarballs}. N(R!RCR(R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt&test_defaultBuildTarballsScriptBuilder s cCs#t}|jt|jgdS(sv L{BuildTarballsScript.main} raises SystemExit when the wrong number of arguments are passed. N(R!RR R (R8R((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt(test_badNumberOfArgumentsToBuildTarballs s cCs?t}|jt|jg|jt|jddgdS(sn L{NewsBuilder.main} raises L{SystemExit} when other than 1 argument is passed to it. RtworldN(R"RR R (R8t newsBuilder((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt$test_badNumberOfArgumentsToBuildNews s cCsHg}t}|j|_|jdg|j|tdgdS(s L{NewsBuilder.main} calls L{NewsBuilder.buildAll} with a L{FilePath} instance constructed from the path passed to it. s /foo/bar/bazN(R"RRR RCR(R8RR((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyttest_buildNews s   N(RQRRRSRRRRRRRRRRRRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyRy s     (TRSR3R}R6RRRRGtxml.domRRtdatetimeRttwisted.trial.unittestRttwisted.python.compatRttwisted.python.procutilsRttwisted.pythonRttwisted.python.filepathRttwisted.python.versionsRttwisted.python._releaseR R R R R RRRRRRRRRRRRRRRRRRR R!R"tnameRRttwisted.lore.scriptsR$t ImportErrorRtpydoctor.drivertpydoctort SyntaxErrorRtgetattrRZRR-tobjectR.RTRyRRRRRRRR[RaRRRR(((sD/usr/lib/python2.7/dist-packages/twisted/python/test/test_release.pyt s  $     ! $   P, \M-