Why Gemfury?
Push, build, and install
RubyGems
npm packages
Python packages
Maven artifacts
PHP packages
Go Modules
Debian packages
RPM packages
NuGet packages
squarecapadmin
squarecapadmin / zope.interface python
Repository URL to install this package:
|
Version:
4.1.2 ▾
|
cdocutils.nodes
document
q)q}q(UtagnameqUdocumentqUreporterqNU
attributesq}q(Udupnamesq ]Ubackrefsq
]UsourceX> /home/tseaver/projects/Zope/Z3/zope.interface/docs/hacking.rstq Uidsq ]Uclassesq
]Unamesq]uUparse_messagesq]qU
decorationqNU citationsq]qU rawsourceqU U nametypesq}q(X1 running tests on multiple python versions via toxqNX toxqX submitting a bug reportqNX* building the documentation in a virtualenvqNX, building the documentation using zc.buildoutqNX getting the codeq NX! running the tests in a virtualenvq NX sharing your changesq NX# running the tests using zc.buildoutq NX hacking on zope.interfaceq NuUsettingsq!(cdocutils.frontend
Values
q"oq#}q$(Upep_referencesq%NU output_encoding_error_handlerq&Ustrictq'U
halt_levelq(KU
source_urlq)NU
dump_settingsq*NUdoctitle_xformq+Udump_pseudo_xmlq,NU tab_widthq-KU id_prefixq.U Utitleq/NUembed_stylesheetq0U
docinfo_xformq1KUfootnote_backlinksq2KUerror_encodingq3UUTF-8q4Uauto_id_prefixq5Uidq6U
language_codeq7Uenq8U datestampq9NUdump_transformsq:NUoutput_encodingq;Uutf-8q<Uexit_status_levelq=KUstrict_visitorq>NU_disable_configq?NUfile_insertion_enabledq@U tracebackqAUrecord_dependenciesqBNUstrip_commentsqCNUdebugqDNU generatorqENUgettext_compactqFUenvqGNU
strip_classesqHNUpep_file_url_templateqIUpep-%04dqJU input_encoding_error_handlerqKh'Uexpose_internalsqLNUrfc_referencesqMNU
toc_backlinksqNUentryqOU trim_footnote_reference_spaceqPU_sourceqQh Uwarning_streamqRNUinput_encodingqSU utf-8-sigqTUsectsubtitle_xformqUU source_linkqVNUconfigqWNU
sectnum_xformqXKU error_encoding_error_handlerqYUbackslashreplaceqZU
_config_filesq[]Udump_internalsq\NU smart_quotesq]Ucloak_email_addressesq^U raw_enabledq_KUstrip_elements_with_classesq`NU pep_base_urlqaU https://www.python.org/dev/peps/qbU report_levelqcKU rfc_base_urlqdU https://tools.ietf.org/html/qeU _destinationqfNUsyntax_highlightqgUlongqhubUautofootnote_refsqi]qjU
footnote_refsqk}qlUid_startqmKU
citation_refsqn}qoUsymbol_footnote_refsqp]qqUtransform_messagesqr]qscdocutils.nodes
system_message
qt)qu}qv(hU hUsystem_messageqwh}qx(h ]h
]h
]h ]UlevelKUsourceh h]UtypeUINFOqyuUchildrenqz]q{cdocutils.nodes
paragraph
q|)q}}q~(hU hU paragraphqh}q(h
]h ]h]h ]h
]uUparentqhuhz]qcdocutils.nodes
Text
qX- Hyperlink target "index-0" is not referenced.q
q
}q(hU hh}ubaubaubaU footnotesq]qUnameidsq}q(hU1running-tests-on-multiple-python-versions-via-toxqhUtoxqhUsubmitting-a-bug-reportqhU*building-the-documentation-in-a-virtualenvqhU,building-the-documentation-using-zc-buildoutqh Ugetting-the-codeqh U!running-the-tests-in-a-virtualenvqh Usharing-your-changesqh U#running-the-tests-using-zc-buildoutqh Uhacking-on-zope-interfacequUrefnamesq}qU transformerqNUidsq}q(hcdocutils.nodes
section
q)q}q(hhhUsectionqh}q(h
]h ]h]qh ah ]q hah
]uUlineq¡M:Usourceq¢h hU hh)q£}q¤(hhhhh}q¥(h
]h ]h]q¦h ah ]q§hah
]uh¡Kh¢h hU hhhz]q¨(cdocutils.nodes
title
q©)qª}q«(hhhh/h}q¬(h
]h ]h]h ]h
]uh¡Kh¢h hX Hacking on :mod:`zope.interface`qhh£hz]q®(hX Hacking on q¯
q°}q±(hX Hacking on q²hhªubcsphinx.addnodes
pending_xref
q³)q´}qµ(hU pending_xrefq¶h}q·(h ]Urefwarnq¸UreftypeX modh
]U reftargetq¹X zope.interfaceh
]U py:moduleqºNh ]U refexplicitUpy:classq»NU refdomainX pyq¼Urefdocq½X hackingq¾h]uh¡Kh¢h hX :mod:`zope.interface`q¿hhªhz]qÀcdocutils.nodes
literal
qÁ)qÂ}qÃ(hh¿hUliteralqÄh}qÅ(h
]h ]h]h ]h
]qÆ(UxrefqÇh¼X py-modqÈeuhh´hz]qÉhX zope.interfaceqʅqË}qÌ(hU hhÂubaubaubeubh)qÍ}qÎ(hhhhh}qÏ(h
]h ]h]qÐh ah ]qÑhah
]uh¡Kh¢h hU hh£hz]qÒ(h©)qÓ}qÔ(hhhh/h}qÕ(h
]h ]h]h ]h
]uh¡Kh¢h hX Getting the CodeqÖhhÍhz]q×hX Getting the CodeqqÙ}qÚ(hhÖhhÓubaubh|)qÛ}qÜ(hhhhh}qÝ(h
]h ]h]h ]h
]uh¡Kh¢h hXS The main repository for :mod:`zope.interface` is in the Zope Subversion
repository:hhÍhz]qÞ(hX The main repository for q߅qà}qá(hX The main repository for hhÛubh³)qâ}qã(hh¶h}qä(h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyqåh½h¾h]uh¡Kh¢h hX :mod:`zope.interface`qæhhÛhz]qçhÁ)qè}qé(hhæhhÄh}qê(h
]h ]h]h ]h
]që(hÇhåX py-modqìeuhhâhz]qíhX zope.interfaceqqï}qð(hU hhèubaubaubhX& is in the Zope Subversion
repository:qñ
qò}qó(hX& is in the Zope Subversion
repository:hhÛubeubh|)qô}qõ(hhhhh}qö(h
]h ]h]h ]h
]uh¡K h¢h hX" http://svn.zope.org/zope.interfaceq÷hhÍhz]qøcdocutils.nodes
reference
qù)qú}qû(hh÷hU referenceqüh}qý(h ]h
]h
]h ]h]Urefurih÷uhhôhz]qþhX" http://svn.zope.org/zope.interfaceqÿ
r }r (hU hhúubaubaubh|)r }r (hhhhh}r (h
]h ]h]h ]h
]uh¡K
h¢h hX7 You can get a read-only Subversion checkout from there:r hhÍhz]r hX7 You can get a read-only Subversion checkout from there:r
r }r (hj hj ubaubcdocutils.nodes
literal_block
r
)r }r (hhhU
literal_blockr
h}r (Ulinenosr h ]h
]U xml:spacer Upreserver Uhighlight_argsr }h
]Ulanguager X shh ]h]uh¡Kh¢h hXP $ svn checkout svn://svn.zope.org/repos/main/zope.interface/trunk zope.interfacehhÍhz]r hXP $ svn checkout svn://svn.zope.org/repos/main/zope.interface/trunk zope.interfacer
r }r (hU hj ubaubh|)r }r (hhhhh}r (h
]h ]h]h ]h
]uh¡Kh¢h hXb The project also mirrors the trunk from the Subversion repository as a
Bazaar branch on Launchpad:r hhÍhz]r hXb The project also mirrors the trunk from the Subversion repository as a
Bazaar branch on Launchpad:r
r }r (hj hj ubaubh|)r }r! (hhhhh}r" (h
]h ]h]h ]h
]uh¡Kh¢h hX) https://code.launchpad.net/zope.interfacer# hhÍhz]r$ hù)r% }r& (hj# hhüh}r' (h ]h
]h
]h ]h]Urefurij# uhj hz]r( hX) https://code.launchpad.net/zope.interfacer)
r* }r+ (hU hj% ubaubaubh|)r, }r- (hhhhh}r. (h
]h ]h]h ]h
]uh¡Kh¢h hX1 You can branch the trunk from there using Bazaar:r/ hhÍhz]r0 hX1 You can branch the trunk from there using Bazaar:r1
r2 }r3 (hj/ hj, ubaubj
)r4 }r5 (hhhj
h}r6 (j h ]h
]j j j }h
]j X shh ]h]uh¡Kh¢h hX $ bzr branch lp:zope.interfacehhÍhz]r7 hX $ bzr branch lp:zope.interfacer8
r9 }r: (hU hj4 ubaubeubh)r; }r< (hhhhh}r= (h
]h ]h]r> h ah ]r? hah
]uh¡K h¢h hU hh£hz]r@ (h©)rA }rB (hhhh/h}rC (h
]h ]h]h ]h
]uh¡K h¢h hX% Running the tests in a ``virtualenv``rD hj; hz]rE (hX Running the tests in a rF
rG }rH (hX Running the tests in a rI hjA ubhÁ)rJ }rK (hX ``virtualenv``rL hhÄh}rM (h
]h ]h]h ]h
]uhjA hz]rN hX
virtualenvrO
rP }rQ (hU hjJ ubaubeubh|)rR }rS (hhhhh}rT (h
]h ]h]h ]h
]uh¡K"h¢h hX× If you use the ``virtualenv`` package to create lightweight Python
development environments, you can run the tests using nothing more
than the ``python`` binary in a virtualenv. First, create a scratch
environment:hj; hz]rU (hX If you use the rV
rW }rX (hX If you use the hjR ubhÁ)rY }rZ (hX ``virtualenv``hhÄh}r[ (h
]h ]h]h ]h
]uhjR hz]r\ hX
virtualenvr]
r^ }r_ (hU hjY ubaubhXr package to create lightweight Python
development environments, you can run the tests using nothing more
than the r`
ra }rb (hXr package to create lightweight Python
development environments, you can run the tests using nothing more
than the hjR ubhÁ)rc }rd (hX
``python``hhÄh}re (h
]h ]h]h ]h
]uhjR hz]rf hX pythonrg
rh }ri (hU hjc ubaubhX> binary in a virtualenv. First, create a scratch
environment:rj
rk }rl (hX> binary in a virtualenv. First, create a scratch
environment:hjR ubeubj
)rm }rn (hhhj
h}ro (j h ]h
]j j j }h
]j X shh ]h]uh¡K'h¢h hXA $ /path/to/virtualenv --no-site-packages /tmp/hack-zope.interfacehj; hz]rp hXA $ /path/to/virtualenv --no-site-packages /tmp/hack-zope.interfacerq
rr }rs (hU hjm ubaubh|)rt }ru (hhhhh}rv (h
]h ]h]h ]h
]uh¡K+h¢h hXL Next, get this package registered as a "development egg" in the
environment:rw hj; hz]rx hXL Next, get this package registered as a "development egg" in the
environment:ry
rz }r{ (hjw hjt ubaubj
)r| }r} (hhhj
h}r~ (j h ]h
]j j j }h
]j X shh ]h]uh¡K.h¢h hX6 $ /tmp/hack-zope.interface/bin/python setup.py develophj; hz]r hX6 $ /tmp/hack-zope.interface/bin/python setup.py developr
r }r (hU hj| ubaubh|)r }r (hhhhh}r
(h
]h ]h]h ]h
]uh¡K2h¢h hXD Finally, run the tests using the build-in ``setuptools`` testrunner:r hj; hz]r (hX* Finally, run the tests using the build-in r
r }r (hX* Finally, run the tests using the build-in hj ubhÁ)r }r (hX ``setuptools``hhÄh}r (h
]h ]h]h ]h
]uhj hz]r hX
setuptoolsr
r }r (hU hj ubaubhX testrunner:r
r }r (hX testrunner:hj ubeubj
)r }r (hhhj
h}r (j h ]h
]j j j }h
]j X shh ]h]uh¡K4h¢h hX¨ $ /tmp/hack-zope.interface/bin/python setup.py test -q
running test
...
----------------------------------------------------------------------
Ran 2 tests in 0.000s
OKhj; hz]r hX¨ $ /tmp/hack-zope.interface/bin/python setup.py test -q
running test
...
----------------------------------------------------------------------
Ran 2 tests in 0.000s
OKr
r }r (hU hj ubaubh|)r }r (hhhhh}r (h
]h ]h]h ]h
]uh¡K>h¢h hX The ``dev`` command alias downloads and installs extra tools, like the
:mod:`nose` testrunner and the :mod:`coverage` coverage analyzer:hj; hz]r (hX The r
r¡ }r¢ (hX The hj ubhÁ)r£ }r¤ (hX ``dev``hhÄh}r¥ (h
]h ]h]h ]h
]uhj hz]r¦ hX devr§
r¨ }r© (hU hj£ ubaubhX< command alias downloads and installs extra tools, like the
rª
r« }r¬ (hX< command alias downloads and installs extra tools, like the
hj ubh³)r }r® (hh¶h}r¯ (h ]h¸UreftypeX modh
]h¹X noseh
]hºNh ]U refexplicith»NU refdomainX pyr° h½h¾h]uh¡K>h¢h hX :mod:`nose`r± hj hz]r² hÁ)r³ }r´ (hj± hhÄh}rµ (h
]h ]h]h ]h
]r¶ (hÇj° X py-modr· euhj hz]r¸ hX noser¹
rº }r» (hU hj³ ubaubaubhX testrunner and the r¼
r½ }r¾ (hX testrunner and the hj ubh³)r¿ }rÀ (hh¶h}rÁ (h ]h¸UreftypeX modh
]h¹X coverageh
]hºNh ]U refexplicith»NU refdomainX pyr h½h¾h]uh¡K>h¢h hX :mod:`coverage`rà hj hz]rÄ hÁ)rÅ }rÆ (hjà hhÄh}rÇ (h
]h ]h]h ]h
]rÈ (hÇj X py-modrÉ euhj¿ hz]rÊ hX coveragerË
rÌ }rÍ (hU hjÅ ubaubaubhX coverage analyzer:rÎ
rÏ }rÐ (hX coverage analyzer:hj ubeubj
)rÑ }rÒ (hhhj
h}rÓ (j h ]h
]j j j }h
]j X shh ]h]uh¡KAh¢h hX $ /tmp/hack-zope.interface/bin/python setup.py dev
$ /tmp/hack-zope.interface/bin/nosetests
running nosetests
.................................... (lots more dots)
----------------------------------------------------------------------
Ran 707 tests in 2.166s
OKhj; hz]rÔ hX $ /tmp/hack-zope.interface/bin/python setup.py dev
$ /tmp/hack-zope.interface/bin/nosetests
running nosetests
.................................... (lots more dots)
----------------------------------------------------------------------
Ran 707 tests in 2.166s
OKrÕ
rÖ }r× (hU hjÑ ubaubh|)rØ }rÙ (hhhhh}rÚ (h
]h ]h]h ]h
]uh¡KLh¢h hXs If you have the :mod:`coverage` pacakge installed in the virtualenv,
you can see how well the tests cover the code:hj; hz]rÛ (hX If you have the rÜ
rÝ }rÞ (hX If you have the hjØ ubh³)rß }rà (hh¶h}rá (h ]h¸UreftypeX modh
]h¹X coverageh
]hºNh ]U refexplicith»NU refdomainX pyrâ h½h¾h]uh¡KLh¢h hX :mod:`coverage`rã hjØ hz]rä hÁ)rå }ræ (hjã hhÄh}rç (h
]h ]h]h ]h
]rè (hÇjâ X py-modré euhjß hz]rê hX coveragerë
rì }rí (hU hjå ubaubaubhXT pacakge installed in the virtualenv,
you can see how well the tests cover the code:rî
rï }rð (hXT pacakge installed in the virtualenv,
you can see how well the tests cover the code:hjØ ubeubj
)rñ }rò (hhhj
h}ró (j h ]h
]j j j }h
]j X shh ]h]uh¡KOh¢h hXM $ /tmp/hack-zope.interface/bin/nosetests --with coverage
running nosetests
.................................... (lots more dots)
Name Stmts Miss Cover Missing
----------------------------------------------------------------
zope.interface 30 0 100%
zope.interface.adapter 440 0 100%
zope.interface.advice 69 0 100%
zope.interface.common 0 0 100%
zope.interface.common.idatetime 98 0 100%
zope.interface.common.interfaces 81 0 100%
zope.interface.common.mapping 32 0 100%
zope.interface.common.sequence 38 0 100%
zope.interface.declarations 312 0 100%
zope.interface.document 54 0 100%
zope.interface.exceptions 21 0 100%
zope.interface.interface 378 0 100%
zope.interface.interfaces 137 0 100%
zope.interface.registry 300 0 100%
zope.interface.ro 25 0 100%
zope.interface.verify 48 0 100%
----------------------------------------------------------------
TOTAL 2063 0 100%
----------------------------------------------------------------------
Ran 707 tests in 2.166s
OKhj; hz]rô hXM $ /tmp/hack-zope.interface/bin/nosetests --with coverage
running nosetests
.................................... (lots more dots)
Name Stmts Miss Cover Missing
----------------------------------------------------------------
zope.interface 30 0 100%
zope.interface.adapter 440 0 100%
zope.interface.advice 69 0 100%
zope.interface.common 0 0 100%
zope.interface.common.idatetime 98 0 100%
zope.interface.common.interfaces 81 0 100%
zope.interface.common.mapping 32 0 100%
zope.interface.common.sequence 38 0 100%
zope.interface.declarations 312 0 100%
zope.interface.document 54 0 100%
zope.interface.exceptions 21 0 100%
zope.interface.interface 378 0 100%
zope.interface.interfaces 137 0 100%
zope.interface.registry 300 0 100%
zope.interface.ro 25 0 100%
zope.interface.verify 48 0 100%
----------------------------------------------------------------
TOTAL 2063 0 100%
----------------------------------------------------------------------
Ran 707 tests in 2.166s
OKrõ
rö }r÷ (hU hjñ ubaubeubh)rø }rù (hhhhh}rú (h
]h ]h]rû hah ]rü hah
]uh¡Koh¢h hU hh£hz]rý (h©)rþ }rÿ (hhhh/h}r (h
]h ]h]h ]h
]uh¡Koh¢h hX. Building the documentation in a ``virtualenv``r hjø hz]r (hX Building the documentation in a r
r }r (hX Building the documentation in a r hjþ ubhÁ)r }r (hX ``virtualenv``r hhÄh}r
(h
]h ]h]h ]h
]uhjþ hz]r hX
virtualenvr
r
}r (hU hj ubaubeubh|)r }r (hhhhh}r (h
]h ]h]h ]h
]uh¡Kqh¢h hX® :mod:`zope.interface` uses the nifty :mod:`Sphinx` documentation system
for building its docs. Using the same virtualenv you set up to run the
tests, you can build the docs:hjø hz]r (h³)r }r (hh¶h}r (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyr h½h¾h]uh¡Kqh¢h hX :mod:`zope.interface`r hj hz]r hÁ)r }r (hj hhÄh}r (h
]h ]h]h ]h
]r (hÇj X py-modr euhj hz]r hX zope.interfacer
r }r! (hU hj ubaubaubhX uses the nifty r"
r# }r$ (hX uses the nifty hj ubh³)r% }r& (hh¶h}r' (h ]h¸UreftypeX modh
]h¹X Sphinxh
]hºNh ]U refexplicith»NU refdomainX pyr( h½h¾h]uh¡Kqh¢h hX
:mod:`Sphinx`r) hj hz]r* hÁ)r+ }r, (hj) hhÄh}r- (h
]h ]h]h ]h
]r. (hÇj( X py-modr/ euhj% hz]r0 hX Sphinxr1
r2 }r3 (hU hj+ ubaubaubhX| documentation system
for building its docs. Using the same virtualenv you set up to run the
tests, you can build the docs:r4
r5 }r6 (hX| documentation system
for building its docs. Using the same virtualenv you set up to run the
tests, you can build the docs:hj ubeubh|)r7 }r8 (hhhhh}r9 (h
]h ]h]h ]h
]uh¡Kuh¢h hXN The ``docs`` command alias downloads and installs Sphinx and its dependencies:r: hjø hz]r; (hX The r<
r= }r> (hX The hj7 ubhÁ)r? }r@ (hX ``docs``hhÄh}rA (h
]h ]h]h ]h
]uhj7 hz]rB hX docsrC
rD }rE (hU hj? ubaubhXB command alias downloads and installs Sphinx and its dependencies:rF
rG }rH (hXB command alias downloads and installs Sphinx and its dependencies:hj7 ubeubj
)rI }rJ (hhhj
h}rK (j h ]h
]j j j }h
]j X shh ]h]uh¡Kwh¢h hXÎ $ /tmp/hack-zope.interface/bin/python setup.py docs
...
$ bin/sphinx-build -b html -d docs/_build/doctrees docs docs/_build/html
...
build succeeded.
Build finished. The HTML pages are in docs/_build/html.hjø hz]rL hXÎ $ /tmp/hack-zope.interface/bin/python setup.py docs
...
$ bin/sphinx-build -b html -d docs/_build/doctrees docs docs/_build/html
...
build succeeded.
Build finished. The HTML pages are in docs/_build/html.rM
rN }rO (hU hjI ubaubh|)rP }rQ (hhhhh}rR (h
]h ]h]h ]h
]uh¡Kh¢h hX9 You can also test the code snippets in the documentation:rS hjø hz]rT hX9 You can also test the code snippets in the documentation:rU
rV }rW (hjS hjP ubaubj
)rX }rY (hhhj
h}rZ (j h ]h
]j j j }h
]j X shh ]h]uh¡Kh¢h hXÌ $ bin/sphinx-build -b doctest -d docs/_build/doctrees docs docs/_build/doctest
...
running tests...
Document: index
---------------
1 items passed all tests:
17 tests in default
17 tests in 1 items.
17 passed and 0 failed.
Test passed.
Doctest summary
===============
17 tests
0 failures in tests
0 failures in setup code
build succeeded.
Testing of doctests in the sources finished, look at the \
results in docs/_build/doctest/output.txt.hjø hz]r[ hXÌ $ bin/sphinx-build -b doctest -d docs/_build/doctrees docs docs/_build/doctest
...
running tests...
Document: index
---------------
1 items passed all tests:
17 tests in default
17 tests in 1 items.
17 passed and 0 failed.
Test passed.
Doctest summary
===============
17 tests
0 failures in tests
0 failures in setup code
build succeeded.
Testing of doctests in the sources finished, look at the \
results in docs/_build/doctest/output.txt.r\
r] }r^ (hU hjX ubaubeubh)r_ }r` (hhhhh}ra (h
]h ]h]rb h ah ]rc hah
]uh¡Kh¢h hU hh£hz]rd (h©)re }rf (hhhh/h}rg (h
]h ]h]h ]h
]uh¡Kh¢h hX+ Running the tests using :mod:`zc.buildout`rh hj_ hz]ri (hX Running the tests using rj
rk }rl (hX Running the tests using rm hje ubh³)rn }ro (hh¶h}rp (h ]h¸UreftypeX modh
]h¹X zc.buildouth
]hºNh ]U refexplicith»NU refdomainX pyrq h½h¾h]uh¡Kh¢h hX :mod:`zc.buildout`rr hje hz]rs hÁ)rt }ru (hjr hhÄh}rv (h
]h ]h]h ]h
]rw (hÇjq X py-modrx euhjn hz]ry hX zc.buildoutrz
r{ }r| (hU hjt ubaubaubeubh|)r} }r~ (hhhhh}r (h
]h ]h]h ]h
]uh¡Kh¢h hX :mod:`zope.interface` ships with its own :file:`buildout.cfg` file and
:file:`bootstrap.py` for setting up a development buildout:hj_ hz]r (h³)r }r (hh¶h}r (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyr h½h¾h]uh¡Kh¢h hX :mod:`zope.interface`r
hj} hz]r hÁ)r }r (hj
hhÄh}r (h
]h ]h]h ]h
]r (hÇj X py-modr euhj hz]r hX zope.interfacer
r }r (hU hj ubaubaubhX ships with its own r
r }r (hX ships with its own hj} ubhÁ)r }r (hU hhÄh}r (h ]h
]UroleX filer h
]r j ah ]h]uhj} hz]r hX buildout.cfgr
r }r (hX buildout.cfghj ubaubhX
file and
r
r }r (hX
file and
hj} ubhÁ)r }r (hU hhÄh}r¡ (h ]h
]UroleX filer¢ h
]r£ j¢ ah ]h]uhj} hz]r¤ hX bootstrap.pyr¥
r¦ }r§ (hX bootstrap.pyhj ubaubhX' for setting up a development buildout:r¨
r© }rª (hX' for setting up a development buildout:hj} ubeubj
)r« }r¬ (hhhj
h}r (j h ]h
]j j j }h
]j X shh ]h]uh¡K¡h¢h hXê $ /path/to/python2.6 bootstrap.py
...
Generated script '.../bin/buildout'
$ bin/buildout
Develop: '/home/tseaver/projects/Zope/BTK/interface/.'
...
Generated script '.../bin/sphinx-quickstart'.
Generated script '.../bin/sphinx-build'.hj_ hz]r® hXê $ /path/to/python2.6 bootstrap.py
...
Generated script '.../bin/buildout'
$ bin/buildout
Develop: '/home/tseaver/projects/Zope/BTK/interface/.'
...
Generated script '.../bin/sphinx-quickstart'.
Generated script '.../bin/sphinx-build'.r¯
r° }r± (hU hj« ubaubh|)r² }r³ (hhhhh}r´ (h
]h ]h]h ]h
]uh¡K¬h¢h hX You can now run the tests:rµ hj_ hz]r¶ hX You can now run the tests:r·
r¸ }r¹ (hjµ hj² ubaubj
)rº }r» (hhhj
h}r¼ (j h ]h
]j j j }h
]j X shh ]h]uh¡K®h¢h hX. $ bin/test --all
Running zope.testing.testrunner.layer.UnitTests tests:
Set up zope.testing.testrunner.layer.UnitTests in 0.000 seconds.
Ran 702 tests with 0 failures and 0 errors in 0.000 seconds.
Tearing down left over layers:
Tear down zope.testing.testrunner.layer.UnitTests in 0.000 seconds.hj_ hz]r½ hX. $ bin/test --all
Running zope.testing.testrunner.layer.UnitTests tests:
Set up zope.testing.testrunner.layer.UnitTests in 0.000 seconds.
Ran 702 tests with 0 failures and 0 errors in 0.000 seconds.
Tearing down left over layers:
Tear down zope.testing.testrunner.layer.UnitTests in 0.000 seconds.r¾
r¿ }rÀ (hU hjº ubaubeubh)rÁ }r (hhhhh}rà (h
]h ]h]rÄ hah ]rÅ hah
]uh¡K¹h¢h hU hh£hz]rÆ (h©)rÇ }rÈ (hhhh/h}rÉ (h
]h ]h]h ]h
]uh¡K¹h¢h hX3 Building the documentation using :mod:`zc.buildout`rÊ hjÁ hz]rË (hX! Building the documentation using rÌ
rÍ }rÎ (hX! Building the documentation using rÏ hjÇ ubh³)rÐ }rÑ (hh¶h}rÒ (h ]h¸UreftypeX modh
]h¹X zc.buildouth
]hºNh ]U refexplicith»NU refdomainX pyrÓ h½h¾h]uh¡K¸h¢h hX :mod:`zc.buildout`rÔ hjÇ hz]rÕ hÁ)rÖ }r× (hjÔ hhÄh}rØ (h
]h ]h]h ]h
]rÙ (hÇjÓ X py-modrÚ euhjÐ hz]rÛ hX zc.buildoutrÜ
rÝ }rÞ (hU hjÖ ubaubaubeubh|)rß }rà (hhhhh}rá (h
]h ]h]h ]h
]uh¡K»h¢h hX The :mod:`zope.interface` buildout installs the Sphinx scripts required to
build the documentation, including testing its code snippets:hjÁ hz]râ (hX The rã
rä }rå (hX The hjß ubh³)ræ }rç (hh¶h}rè (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyré h½h¾h]uh¡K»h¢h hX :mod:`zope.interface`rê hjß hz]rë hÁ)rì }rí (hjê hhÄh}rî (h
]h ]h]h ]h
]rï (hÇjé X py-modrð euhjæ hz]rñ hX zope.interfacerò
ró }rô (hU hjì ubaubaubhXo buildout installs the Sphinx scripts required to
build the documentation, including testing its code snippets:rõ
rö }r÷ (hXo buildout installs the Sphinx scripts required to
build the documentation, including testing its code snippets:hjß ubeubcdocutils.nodes
target
rø )rù }rú (hhhUtargetrû h}rü (h ]h
]Urefidrý Uindex-0rþ h
]h ]h]uh¡Nh¢h hU hjÁ hz]ubcsphinx.ext.todo
todo_node
rÿ )r }r (hhhU todo_noder Uexpect_referenced_by_idr }r jþ jù sh}r (h
]h ]h]h ]r jþ ah
]r Uadmonition-todor auh¡K¾h¢h hX verify this!r hjÁ hz]r
(h©)r }r (hX Todor
hh/h}r (h
]h ]h]h ]h
]uhj hz]r hX Todor
r }r (hj
hj ubaubh|)r }r (hhh}r (h
]h ]h]h ]h
]uh¡K¾h¢h hj hj hz]r hX verify this!r
r }r (hj hj ubaubeUexpect_referenced_by_namer }ubj
)r }r (hhhj
h}r (j h ]h
]j j j }h
]j X shh ]h]uh¡KÀh¢h hX± $ cd docs
$ PATH=../bin:$PATH make doctest html
.../bin/sphinx-build -b doctest -d .../docs/_build/doctrees .../docs .../docs/_build/doctest
running tests...
Document: index
---------------
1 items passed all tests:
17 tests in default
17 tests in 1 items.
17 passed and 0 failed.
Test passed.
Doctest summary
===============
17 tests
0 failures in tests
0 failures in setup code
build succeeded.
Testing of doctests in the sources finished, look at the results in .../docs/_build/doctest/output.txt.
.../bin/sphinx-build -b html -d .../docs/_build/doctrees .../docs .../docs/_build/html
...
build succeeded.
Build finished. The HTML pages are in .../docs/_build/html.hjÁ hz]r hX± $ cd docs
$ PATH=../bin:$PATH make doctest html
.../bin/sphinx-build -b doctest -d .../docs/_build/doctrees .../docs .../docs/_build/doctest
running tests...
Document: index
---------------
1 items passed all tests:
17 tests in default
17 tests in 1 items.
17 passed and 0 failed.
Test passed.
Doctest summary
===============
17 tests
0 failures in tests
0 failures in setup code
build succeeded.
Testing of doctests in the sources finished, look at the results in .../docs/_build/doctest/output.txt.
.../bin/sphinx-build -b html -d .../docs/_build/doctrees .../docs .../docs/_build/html
...
build succeeded.
Build finished. The HTML pages are in .../docs/_build/html.r
r }r! (hU hj ubaubeubh)r" }r# (hhhhh}r$ (h
]h ]h]r% hah ]r& hah
]uh¡KÞh¢h hU hh£hz]r' (h©)r( }r) (hhhh/h}r* (h
]h ]h]h ]h
]uh¡KÞh¢h hX8 Running Tests on Multiple Python Versions via :mod:`tox`r+ hj" hz]r, (hX. Running Tests on Multiple Python Versions via r-
r. }r/ (hX. Running Tests on Multiple Python Versions via r0 hj( ubh³)r1 }r2 (hh¶h}r3 (h ]h¸UreftypeX modh
]h¹X toxh
]hºNh ]U refexplicith»NU refdomainX pyr4 h½h¾h]uh¡KÝh¢h hX
:mod:`tox`r5 hj( hz]r6 hÁ)r7 }r8 (hj5 hhÄh}r9 (h
]h ]h]h ]h
]r: (hÇj4 X py-modr; euhj1 hz]r< hX toxr=
r> }r? (hU hj7 ubaubaubeubh|)r@ }rA (hhhhh}rB (h
]h ]h]h ]h
]uh¡Kàh¢h hX: `tox <http://tox.testrun.org/latest/>`_ is a Python-based test automation
tool designed to run tests against multiple Python versions. It creates
a ``virtualenv`` for each configured version, installs the current package
and configured dependencies into each ``virtualenv``, and then runs the
configured commands.hj" hz]rC (hù)rD }rE (hX' `tox <http://tox.testrun.org/latest/>`_hhüh}rF (h ]Unamehh
]h
]h ]h]UrefurirG X http://tox.testrun.org/latest/rH uhj@ hz]rI hX toxrJ
rK }rL (hU hjD ubaubjø )rM }rN (hjû h}rO (h ]h
]h
]h ]rP hah]rQ haUrefurijH uhX! <http://tox.testrun.org/latest/>hj@ U
referencedrR Khz]ubhXn is a Python-based test automation
tool designed to run tests against multiple Python versions. It creates
a rS
rT }rU (hXn is a Python-based test automation
tool designed to run tests against multiple Python versions. It creates
a hj@ ubhÁ)rV }rW (hX ``virtualenv``hhÄh}rX (h
]h ]h]h ]h
]uhj@ hz]rY hX
virtualenvrZ
r[ }r\ (hU hjV ubaubhXa for each configured version, installs the current package
and configured dependencies into each r]
r^ }r_ (hXa for each configured version, installs the current package
and configured dependencies into each hj@ ubhÁ)r` }ra (hX ``virtualenv``hhÄh}rb (h
]h ]h]h ]h
]uhj@ hz]rc hX
virtualenvrd
re }rf (hU hj` ubaubhX( , and then runs the
configured commands.rg
rh }ri (hX( , and then runs the
configured commands.hj@ ubeubh|)rj }rk (hhhhh}rl (h
]h ]h]h ]h
]uh¡Kæh¢h hX` :mod:`zope.interface` configures the following :mod:`tox` environments via
its ``tox.ini`` file:hj" hz]rm (h³)rn }ro (hh¶h}rp (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyrq h½h¾h]uh¡Kæh¢h hX :mod:`zope.interface`rr hjj hz]rs hÁ)rt }ru (hjr hhÄh}rv (h
]h ]h]h ]h
]rw (hÇjq X py-modrx euhjn hz]ry hX zope.interfacerz
r{ }r| (hU hjt ubaubaubhX configures the following r}
r~ }r (hX configures the following hjj ubh³)r }r (hh¶h}r (h ]h¸UreftypeX modh
]h¹X toxh
]hºNh ]U refexplicith»NU refdomainX pyr h½h¾h]uh¡Kæh¢h hX
:mod:`tox`r hjj hz]r
hÁ)r }r (hj hhÄh}r (h
]h ]h]h ]h
]r (hÇj X py-modr euhj hz]r hX toxr
r }r (hU hj ubaubaubhX environments via
its r
r }r (hX environments via
its hjj ubhÁ)r }r (hX ``tox.ini``hhÄh}r (h
]h ]h]h ]h
]uhjj hz]r hX tox.inir
r }r (hU hj ubaubhX file:r
r }r (hX file:hjj ubeubcdocutils.nodes
bullet_list
r )r }r (hhhU bullet_listr h}r (h ]h
]h
]h ]Ubulletr¡ X -h]uh¡Kéh¢h hU hj" hz]r¢ (cdocutils.nodes
list_item
r£ )r¤ }r¥ (hhhU list_itemr¦ h}r§ (h
]h ]h]h ]h
]uh¡Nh¢h hXª The ``py26`` environment builds a ``virtualenv`` with ``python2.6``,
installs :mod:`zope.interface` and dependencies, and runs the tests
via ``python setup.py test -q``.
hj hz]r¨ h|)r© }rª (hhh}r« (h
]h ]h]h ]h
]uh¡Kéh¢h hX© The ``py26`` environment builds a ``virtualenv`` with ``python2.6``,
installs :mod:`zope.interface` and dependencies, and runs the tests
via ``python setup.py test -q``.hj¤ hz]r¬ (hX The r
r® }r¯ (hX The hj© ubhÁ)r° }r± (hX ``py26``hhÄh}r² (h
]h ]h]h ]h
]uhj© hz]r³ hX py26r´
rµ }r¶ (hU hj° ubaubhX environment builds a r·
r¸ }r¹ (hX environment builds a hj© ubhÁ)rº }r» (hX ``virtualenv``hhÄh}r¼ (h
]h ]h]h ]h
]uhj© hz]r½ hX
virtualenvr¾
r¿ }rÀ (hU hjº ubaubhX with rÁ
r }rà (hX with hj© ubhÁ)rÄ }rÅ (hX
``python2.6``hhÄh}rÆ (h
]h ]h]h ]h
]uhj© hz]rÇ hX python2.6rÈ
rÉ }rÊ (hU hjÄ ubaubhX ,
installs rË
rÌ }rÍ (hX ,
installs hj© ubh³)rÎ }rÏ (hh¶h}rÐ (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyrÑ h½h¾h]uh¡Kéh¢h hX :mod:`zope.interface`rÒ hj© hz]rÓ hÁ)rÔ }rÕ (hjÒ hhÄh}rÖ (h
]h ]h]h ]h
]r× (hÇjÑ X py-modrØ euhjÎ hz]rÙ hX zope.interfacerÚ
rÛ }rÜ (hU hjÔ ubaubaubhX* and dependencies, and runs the tests
via rÝ
rÞ }rß (hX* and dependencies, and runs the tests
via hj© ubhÁ)rà }rá (hX ``python setup.py test -q``hhÄh}râ (h
]h ]h]h ]h
]uhj© hz]rã hX python setup.py test -qrä
rå }ræ (hU hjà ubaubhX .
rç }rè (hX .hj© ubeubaubj£ )ré }rê (hhhj¦ h}rë (h
]h ]h]h ]h
]uh¡Nh¢h hXª The ``py27`` environment builds a ``virtualenv`` with ``python2.7``,
installs :mod:`zope.interface` and dependencies, and runs the tests
via ``python setup.py test -q``.
hj hz]rì h|)rí }rî (hhh}rï (h
]h ]h]h ]h
]uh¡Kíh¢h hX© The ``py27`` environment builds a ``virtualenv`` with ``python2.7``,
installs :mod:`zope.interface` and dependencies, and runs the tests
via ``python setup.py test -q``.hjé hz]rð (hX The rñ
rò }ró (hX The hjí ubhÁ)rô }rõ (hX ``py27``hhÄh}rö (h
]h ]h]h ]h
]uhjí hz]r÷ hX py27rø
rù }rú (hU hjô ubaubhX environment builds a rû
rü }rý (hX environment builds a hjí ubhÁ)rþ }rÿ (hX ``virtualenv``hhÄh}r (h
]h ]h]h ]h
]uhjí hz]r hX
virtualenvr
r }r (hU hjþ ubaubhX with r
r }r (hX with hjí ubhÁ)r }r (hX
``python2.7``hhÄh}r
(h
]h ]h]h ]h
]uhjí hz]r hX python2.7r
r
}r (hU hj ubaubhX ,
installs r
r }r (hX ,
installs hjí ubh³)r }r (hh¶h}r (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyr h½h¾h]uh¡Kíh¢h hX :mod:`zope.interface`r hjí hz]r hÁ)r }r (hj hhÄh}r (h
]h ]h]h ]h
]r (hÇj X py-modr euhj hz]r hX zope.interfacer
r }r (hU hj ubaubaubhX* and dependencies, and runs the tests
via r!
r" }r# (hX* and dependencies, and runs the tests
via hjí ubhÁ)r$ }r% (hX ``python setup.py test -q``hhÄh}r& (h
]h ]h]h ]h
]uhjí hz]r' hX python setup.py test -qr(
r) }r* (hU hj$ ubaubhX .
r+ }r, (hX .hjí ubeubaubj£ )r- }r. (hhhj¦ h}r/ (h
]h ]h]h ]h
]uh¡Nh¢h hXª The ``py32`` environment builds a ``virtualenv`` with ``python3.2``,
installs :mod:`zope.interface` and dependencies, and runs the tests
via ``python setup.py test -q``.
hj hz]r0 h|)r1 }r2 (hhh}r3 (h
]h ]h]h ]h
]uh¡Kñh¢h hX© The ``py32`` environment builds a ``virtualenv`` with ``python3.2``,
installs :mod:`zope.interface` and dependencies, and runs the tests
via ``python setup.py test -q``.hj- hz]r4 (hX The r5
r6 }r7 (hX The hj1 ubhÁ)r8 }r9 (hX ``py32``hhÄh}r: (h
]h ]h]h ]h
]uhj1 hz]r; hX py32r<
r= }r> (hU hj8 ubaubhX environment builds a r?
r@ }rA (hX environment builds a hj1 ubhÁ)rB }rC (hX ``virtualenv``hhÄh}rD (h
]h ]h]h ]h
]uhj1 hz]rE hX
virtualenvrF
rG }rH (hU hjB ubaubhX with rI
rJ }rK (hX with hj1 ubhÁ)rL }rM (hX
``python3.2``hhÄh}rN (h
]h ]h]h ]h
]uhj1 hz]rO hX python3.2rP
rQ }rR (hU hjL ubaubhX ,
installs rS
rT }rU (hX ,
installs hj1 ubh³)rV }rW (hh¶h}rX (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyrY h½h¾h]uh¡Kñh¢h hX :mod:`zope.interface`rZ hj1 hz]r[ hÁ)r\ }r] (hjZ hhÄh}r^ (h
]h ]h]h ]h
]r_ (hÇjY X py-modr` euhjV hz]ra hX zope.interfacerb
rc }rd (hU hj\ ubaubaubhX* and dependencies, and runs the tests
via re
rf }rg (hX* and dependencies, and runs the tests
via hj1 ubhÁ)rh }ri (hX ``python setup.py test -q``hhÄh}rj (h
]h ]h]h ]h
]uhj1 hz]rk hX python setup.py test -qrl
rm }rn (hU hjh ubaubhX .
ro }rp (hX .hj1 ubeubaubj£ )rq }rr (hhhj¦ h}rs (h
]h ]h]h ]h
]uh¡Nh¢h hX¥ The ``pypy`` environment builds a ``virtualenv`` with ``pypy``,
installs :mod:`zope.interface` and dependencies, and runs the tests
via ``python setup.py test -q``.
hj hz]rt h|)ru }rv (hhh}rw (h
]h ]h]h ]h
]uh¡Kõh¢h hX¤ The ``pypy`` environment builds a ``virtualenv`` with ``pypy``,
installs :mod:`zope.interface` and dependencies, and runs the tests
via ``python setup.py test -q``.hjq hz]rx (hX The ry
rz }r{ (hX The hju ubhÁ)r| }r} (hX ``pypy``hhÄh}r~ (h
]h ]h]h ]h
]uhju hz]r hX pypyr
r }r (hU hj| ubaubhX environment builds a r
r }r
(hX environment builds a hju ubhÁ)r }r (hX ``virtualenv``hhÄh}r (h
]h ]h]h ]h
]uhju hz]r hX
virtualenvr
r }r (hU hj ubaubhX with r
r }r (hX with hju ubhÁ)r }r (hX ``pypy``hhÄh}r (h
]h ]h]h ]h
]uhju hz]r hX pypyr
r }r (hU hj ubaubhX ,
installs r
r }r (hX ,
installs hju ubh³)r }r (hh¶h}r (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyr h½h¾h]uh¡Kõh¢h hX :mod:`zope.interface`r hju hz]r hÁ)r }r¡ (hj hhÄh}r¢ (h
]h ]h]h ]h
]r£ (hÇj X py-modr¤ euhj hz]r¥ hX zope.interfacer¦
r§ }r¨ (hU hj ubaubaubhX* and dependencies, and runs the tests
via r©
rª }r« (hX* and dependencies, and runs the tests
via hju ubhÁ)r¬ }r (hX ``python setup.py test -q``hhÄh}r® (h
]h ]h]h ]h
]uhju hz]r¯ hX python setup.py test -qr°
r± }r² (hU hj¬ ubaubhX .
r³ }r´ (hX .hju ubeubaubj£ )rµ }r¶ (hhhj¦ h}r· (h
]h ]h]h ]h
]uh¡Nh¢h hXÔ The ``coverage`` environment builds a ``virtualenv`` with ``python2.6``,
installs :mod:`zope.interface` and dependencies, installs
:mod:`nose` and :mod:`coverage`, and runs ``nosetests`` with statement
coverage.
hj hz]r¸ h|)r¹ }rº (hhh}r» (h
]h ]h]h ]h
]uh¡Kùh¢h hXÓ The ``coverage`` environment builds a ``virtualenv`` with ``python2.6``,
installs :mod:`zope.interface` and dependencies, installs
:mod:`nose` and :mod:`coverage`, and runs ``nosetests`` with statement
coverage.hjµ hz]r¼ (hX The r½
r¾ }r¿ (hX The hj¹ ubhÁ)rÀ }rÁ (hX ``coverage``hhÄh}r (h
]h ]h]h ]h
]uhj¹ hz]rà hX coveragerÄ
rÅ }rÆ (hU hjÀ ubaubhX environment builds a rÇ
rÈ }rÉ (hX environment builds a hj¹ ubhÁ)rÊ }rË (hX ``virtualenv``hhÄh}rÌ (h
]h ]h]h ]h
]uhj¹ hz]rÍ hX
virtualenvrÎ
rÏ }rÐ (hU hjÊ ubaubhX with rÑ
rÒ }rÓ (hX with hj¹ ubhÁ)rÔ }rÕ (hX
``python2.6``hhÄh}rÖ (h
]h ]h]h ]h
]uhj¹ hz]r× hX python2.6rØ
rÙ }rÚ (hU hjÔ ubaubhX ,
installs rÛ
rÜ }rÝ (hX ,
installs hj¹ ubh³)rÞ }rß (hh¶h}rà (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyrá h½h¾h]uh¡Kùh¢h hX :mod:`zope.interface`râ hj¹ hz]rã hÁ)rä }rå (hjâ hhÄh}ræ (h
]h ]h]h ]h
]rç (hÇjá X py-modrè euhjÞ hz]ré hX zope.interfacerê
rë }rì (hU hjä ubaubaubhX and dependencies, installs
rí
rî }rï (hX and dependencies, installs
hj¹ ubh³)rð }rñ (hh¶h}rò (h ]h¸UreftypeX modh
]h¹X noseh
]hºNh ]U refexplicith»NU refdomainX pyró h½h¾h]uh¡Kùh¢h hX :mod:`nose`rô hj¹ hz]rõ hÁ)rö }r÷ (hjô hhÄh}rø (h
]h ]h]h ]h
]rù (hÇjó X py-modrú euhjð hz]rû hX noserü
rý }rþ (hU hjö ubaubaubhX and rÿ
r }r (hX and hj¹ ubh³)r }r (hh¶h}r (h ]h¸UreftypeX modh
]h¹X coverageh
]hºNh ]U refexplicith»NU refdomainX pyr h½h¾h]uh¡Kùh¢h hX :mod:`coverage`r hj¹ hz]r hÁ)r }r (hj hhÄh}r
(h
]h ]h]h ]h
]r (hÇj X py-modr euhj hz]r
hX coverager
r }r (hU hj ubaubaubhX , and runs r
r }r (hX , and runs hj¹ ubhÁ)r }r (hX
``nosetests``hhÄh}r (h
]h ]h]h ]h
]uhj¹ hz]r hX nosetestsr
r }r (hU hj ubaubhX with statement
coverage.r
r }r (hX with statement
coverage.hj¹ ubeubaubj£ )r }r (hhhj¦ h}r (h
]h ]h]h ]h
]uh¡Nh¢h hXÕ The ``docs`` environment builds a virtualenv with ``python2.6``, installs
:mod:`zope.interface` and dependencies, installs ``Sphinx`` and
dependencies, and then builds the docs and exercises the doctest snippets.
hj hz]r! h|)r" }r# (hhh}r$ (h
]h ]h]h ]h
]uh¡Kþh¢h hXÔ The ``docs`` environment builds a virtualenv with ``python2.6``, installs
:mod:`zope.interface` and dependencies, installs ``Sphinx`` and
dependencies, and then builds the docs and exercises the doctest snippets.hj hz]r% (hX The r&
r' }r( (hX The hj" ubhÁ)r) }r* (hX ``docs``hhÄh}r+ (h
]h ]h]h ]h
]uhj" hz]r, hX docsr-
r. }r/ (hU hj) ubaubhX& environment builds a virtualenv with r0
r1 }r2 (hX& environment builds a virtualenv with hj" ubhÁ)r3 }r4 (hX
``python2.6``hhÄh}r5 (h
]h ]h]h ]h
]uhj" hz]r6 hX python2.6r7
r8 }r9 (hU hj3 ubaubhX , installs
r:
r; }r< (hX , installs
hj" ubh³)r= }r> (hh¶h}r? (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyr@ h½h¾h]uh¡Kþh¢h hX :mod:`zope.interface`rA hj" hz]rB hÁ)rC }rD (hjA hhÄh}rE (h
]h ]h]h ]h
]rF (hÇj@ X py-modrG euhj= hz]rH hX zope.interfacerI
rJ }rK (hU hjC ubaubaubhX and dependencies, installs rL
rM }rN (hX and dependencies, installs hj" ubhÁ)rO }rP (hX
``Sphinx``hhÄh}rQ (h
]h ]h]h ]h
]uhj" hz]rR hX SphinxrS
rT }rU (hU hjO ubaubhXO and
dependencies, and then builds the docs and exercises the doctest snippets.rV
rW }rX (hXO and
dependencies, and then builds the docs and exercises the doctest snippets.hj" ubeubaubeubh|)rY }rZ (hhhhh}r[ (h
]h ]h]h ]h
]uh¡Mh¢h hXh This example requires that you have a working ``python2.6`` on your path,
as well as installing ``tox``:hj" hz]r\ (hX. This example requires that you have a working r]
r^ }r_ (hX. This example requires that you have a working hjY ubhÁ)r` }ra (hX
``python2.6``hhÄh}rb (h
]h ]h]h ]h
]uhjY hz]rc hX python2.6rd
re }rf (hU hj` ubaubhX% on your path,
as well as installing rg
rh }ri (hX% on your path,
as well as installing hjY ubhÁ)rj }rk (hX ``tox``hhÄh}rl (h
]h ]h]h ]h
]uhjY hz]rm hX toxrn
ro }rp (hU hjj ubaubhX :
rq }rr (hX :hjY ubeubj
)rs }rt (hhhj
h}ru (j h ]h
]j j j }h
]j X shh ]h]uh¡Mh¢h hX $ tox -e py26
GLOB sdist-make: .../zope.interface/setup.py
py26 sdist-reinst: .../zope.interface/.tox/dist/zope.interface-4.0.2dev.zip
py26 runtests: commands[0]
...
----------------------------------------------------------------------
Ran 1341 tests in 0.477s
OK
___________________________________ summary ____________________________________
py26: commands succeeded
congratulations :)hj" hz]rv hX $ tox -e py26
GLOB sdist-make: .../zope.interface/setup.py
py26 sdist-reinst: .../zope.interface/.tox/dist/zope.interface-4.0.2dev.zip
py26 runtests: commands[0]
...
----------------------------------------------------------------------
Ran 1341 tests in 0.477s
OK
___________________________________ summary ____________________________________
py26: commands succeeded
congratulations :)rw
rx }ry (hU hjs ubaubh|)rz }r{ (hhhhh}r| (h
]h ]h]h ]h
]uh¡Mh¢h hX Running ``tox`` with no arguments runs all the configured environments,
including building the docs and testing their snippets:hj" hz]r} (hX Running r~
r }r (hX Running hjz ubhÁ)r }r (hX ``tox``hhÄh}r (h
]h ]h]h ]h
]uhjz hz]r hX toxr
r }r (hU hj ubaubhXp with no arguments runs all the configured environments,
including building the docs and testing their snippets:r
r }r (hXp with no arguments runs all the configured environments,
including building the docs and testing their snippets:hjz ubeubj
)r }r (hhhj
h}r (j h ]h
]j j j }h
]j X shh ]h]uh¡Mh¢h hX' $ tox
GLOB sdist-make: .../zope.interface/setup.py
py26 sdist-reinst: .../zope.interface/.tox/dist/zope.interface-4.0.2dev.zip
py26 runtests: commands[0]
...
Doctest summary
===============
678 tests
0 failures in tests
0 failures in setup code
0 failures in cleanup code
build succeeded.
___________________________________ summary ____________________________________
py26: commands succeeded
py27: commands succeeded
py32: commands succeeded
pypy: commands succeeded
coverage: commands succeeded
docs: commands succeeded
congratulations :)hj" hz]r hX' $ tox
GLOB sdist-make: .../zope.interface/setup.py
py26 sdist-reinst: .../zope.interface/.tox/dist/zope.interface-4.0.2dev.zip
py26 runtests: commands[0]
...
Doctest summary
===============
678 tests
0 failures in tests
0 failures in setup code
0 failures in cleanup code
build succeeded.
___________________________________ summary ____________________________________
py26: commands succeeded
py27: commands succeeded
py32: commands succeeded
pypy: commands succeeded
coverage: commands succeeded
docs: commands succeeded
congratulations :)r
r }r (hU hj ubaubeubh)r }r (hhhhh}r (h
]h ]h]r hah ]r hah
]uh¡M0h¢h hU hh£hz]r (h©)r }r (hhhh/h}r (h
]h ]h]h ]h
]uh¡M0h¢h hX Submitting a Bug Reportr hj hz]r hX Submitting a Bug Reportr
r }r (hj hj ubaubh|)r }r¡ (hhhhh}r¢ (h
]h ]h]h ]h
]uh¡M2h¢h hX3 :mod:`zope.interface` tracks its bugs on Launchpad:r£ hj hz]r¤ (h³)r¥ }r¦ (hh¶h}r§ (h ]h¸UreftypeX modh
]h¹X zope.interfaceh
]hºNh ]U refexplicith»NU refdomainX pyr¨ h½h¾h]uh¡M2h¢h hX :mod:`zope.interface`r© hj hz]rª hÁ)r« }r¬ (hj© hhÄh}r (h
]h ]h]h ]h
]r® (hÇj¨ X py-modr¯ euhj¥ hz]r° hX zope.interfacer±
r² }r³ (hU hj« ubaubaubhX tracks its bugs on Launchpad:r´
rµ }r¶ (hX tracks its bugs on Launchpad:hj ubeubh|)r· }r¸ (hhhhh}r¹ (h
]h ]h]h ]h
]uh¡M4h¢h hX) https://bugs.launchpad.net/zope.interfacerº hj hz]r» hù)r¼ }r½ (hjº hhüh}r¾ (h ]h
]h
]h ]h]Urefurijº uhj· hz]r¿ hX) https://bugs.launchpad.net/zope.interfacerÀ
rÁ }r (hU hj¼ ubaubaubh|)rà }rÄ (hhhhh}rÅ (h
]h ]h]h ]h
]uh¡M6h¢h hX5 Please submit bug reports and feature requests there.rÆ hj hz]rÇ hX5 Please submit bug reports and feature requests there.rÈ
rÉ }rÊ (hjÆ hjà ubaubeubheubhz]rË (h©)rÌ }rÍ (hhhh/h}rÎ (h
]h ]h]h ]h
]uh¡M:h¢h hX Sharing Your ChangesrÏ hhhz]rÐ hX Sharing Your ChangesrÑ
rÒ }rÓ (hjÏ hjÌ ubaubcdocutils.nodes
note
rÔ )rÕ }rÖ (hhhUnoter× h}rØ (h
]h ]h]h ]h
]uh¡Nh¢h hXõ Please ensure that all tests are passing before you submit your code.
If possible, your submission should include new tests for new features
or bug fixes, although it is possible that you may have tested your
new code by updating existing tests.hhhz]rÙ h|)rÚ }rÛ (hhh}rÜ (h
]h ]h]h ]h
]uh¡M>h¢h hXõ Please ensure that all tests are passing before you submit your code.
If possible, your submission should include new tests for new features
or bug fixes, although it is possible that you may have tested your
new code by updating existing tests.rÝ hjÕ hz]rÞ hXõ Please ensure that all tests are passing before you submit your code.
If possible, your submission should include new tests for new features
or bug fixes, although it is possible that you may have tested your
new code by updating existing tests.rß
rà }rá (hjÝ hjÚ ubaubaubh|)râ }rã (hhhhh}rä (h
]h ]h]h ]h
]uh¡MCh¢h hX³ If you got a read-only checkout from the Subversion repository, and you
have made a change you would like to share, the best route is to let
Subversion help you make a patch file:rå hhhz]ræ hX³ If you got a read-only checkout from the Subversion repository, and you
have made a change you would like to share, the best route is to let
Subversion help you make a patch file:rç
rè }ré (hjå hjâ ubaubj
)rê }rë (hhhj
h}rì (j h ]h
]j j j }h
]j X shh ]h]uh¡MGh¢h hX. $ svn diff > zope.interface-cool_feature.patchhhhz]rí hX. $ svn diff > zope.interface-cool_feature.patchrî
rï }rð (hU hjê ubaubh|)rñ }rò (hhhhh}ró (h
]h ]h]h ]h
]uh¡MKh¢h hXO You can then upload that patch file as an attachment to a Launchpad bug
report.rô hhhz]rõ hXO You can then upload that patch file as an attachment to a Launchpad bug
report.rö
r÷ }rø (hjô hjñ ubaubh|)rù }rú (hhhhh}rû (h
]h ]h]h ]h
]uh¡MNh¢h hXx If you branched the code from Launchpad using Bazaar, you have another
option: you can "push" your branch to Launchpad:rü hhhz]rý hXx If you branched the code from Launchpad using Bazaar, you have another
option: you can "push" your branch to Launchpad:rþ
rÿ }r (hjü hjù ubaubj
)r }r (hhhj
h}r (j h ]h
]j j j }h
]j X shh ]h]uh¡MQh¢h hX2 $ bzr push lp:~tseaver/zope.interface/cool_featurehhhz]r hX2 $ bzr push lp:~tseaver/zope.interface/cool_featurer
r }r (hU hj ubaubh|)r }r (hhhhh}r
(h
]h ]h]h ]h
]uh¡MUh¢h hX§ After pushing your branch, you can link it to a bug report on Launchpad,
or request that the maintainers merge your branch using the Launchpad
"merge request" feature.r hhhz]r hX§ After pushing your branch, you can link it to a bug report on Launchpad,
or request that the maintainers merge your branch using the Launchpad
"merge request" feature.r
r }r (hj hj ubaubeubhjÁ hjM hhÍhh£hj_ hjø jþ j hj hj; hj" uUsymbol_footnotesr ]r hhUindirect_targetsr ]r Usubstitution_namesr }r U current_liner NUsubstitution_defsr }r Usymbol_footnote_startr K Uautofootnote_startr KU
autofootnotesr ]r hz]r h£aUcurrent_sourcer NUrefidsr }r jþ ]r! jù asub.