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(U
autofootnotesq]qU transformerqNUsubstitution_namesq}qU
citation_refsq }q
Usymbol_footnotesq ]q Ureporterq
NU rawsourceqU UtagnameqUdocumentqUautofootnote_startqKU footnotesq]qUsubstitution_defsq}qUrefidsq}qU
attributesq}q(Udupnamesq]UsourceX: /home/tseaver/projects/Zope/Z3/zope.interface/docs/api.rstqUclassesq ]Uidsq ]Unamesq ]Ubackrefsq ]uUchildrenq ]q!cdocutils.nodes
section
q")q#}q$(Ulineq%KUsourceq&hh}q'(h]h ]q(U zope-interface-api-documentationq)ah ]h ]q*X zope.interface api documentationq+ah ]uh ]q,(cdocutils.nodes
title
q-)q.}q/(h%Kh&hh}q0(h]h ]h ]h ]h ]uh ]q1(csphinx.addnodes
pending_xref
q2)q3}q4(h%Kh&hh}q5(h]U py:moduleq6Nh ]h ]U refdomainX pyq7Upy:classq8NUreftypeX modU reftargetq9X zope.interfaceUrefwarnq:h ]h ]U refexplicitUrefdocq;X apiq<uh ]q=cdocutils.nodes
literal
q>)q?}q@(h ]qAcdocutils.nodes
Text
qBX zope.interfaceqC
qD}qE(hU UparentqFh?ubahUliteralqGhX :mod:`zope.interface`qHhFh3h}qI(h]h ]h ]h ]h ]qJ(UxrefqKh7X py-modqLeuubahU pending_xrefqMhhHhFh.ubhBX API DocumentationqN
qO}qP(hX API DocumentationqQhFh.ubehUtitleqRhhhX' :mod:`zope.interface` API DocumentationqShFh#ubh")qT}qU(h%Kh&hh}qV(h]h ]qWU&zope-interface-interface-specificationqXah ]h ]qYX& zope.interface.interface.specificationqZah ]uh ]q[(h-)q\}q](h%Kh&hh}q^(h]h ]h ]h ]h ]uh ]q_h2)q`}qa(h%Kh&hh}qb(h]h6Nh ]h ]U refdomainX pyqch8NUreftypeX classh9X& zope.interface.interface.Specificationh:h ]h ]U refexplicith;h<uh ]qdh>)qe}qf(h ]qghBX& zope.interface.interface.Specificationqh
qi}qj(hU hFheubahhGhX/ :class:`zope.interface.interface.Specification`qkhFh`h}ql(h]h ]h ]h ]h ]qm(hKhcX py-classqneuubahhMhhkhFh\ubahhRhhhhkhFhTubh")qo}qp(h%K h&hh}qq(h]qrX apiqsah ]qtUapiquah ]h ]h ]uh ]qv(h-)qw}qx(h%K h&hh}qy(h]h ]h ]h ]h ]uh ]qzhBX APIq{
q|}q}(hX APIq~hFhwubahhRhhhh~hFhoubcdocutils.nodes
paragraph
q)q}q(h%K h&hh}q(h]h ]h ]h ]h ]uh ]q(hBX3 Specification objects implement the API defined by
q
q
}q(hX3 Specification objects implement the API defined by
hFhubh2)q}q(h%K h&hh}q(h]h6Nh ]h ]U refdomainX pyqh8NUreftypeX classh9X( zope.interface.interfaces.ISpecificationh:h ]h ]U refexplicith;h<uh ]qh>)q}q(h ]qhBX( zope.interface.interfaces.ISpecificationq
q}q(hU hFhubahhGhX1 :class:`zope.interface.interfaces.ISpecification`qhFhh}q(h]h ]h ]h ]h ]q(hKhX py-classqeuubahhMhhhFhubhBX :
q}q(hX :hFhubehU paragraphqhhhXe Specification objects implement the API defined by
:class:`zope.interface.interfaces.ISpecification`:hFhoubcsphinx.addnodes
index
q)q}q(h%Nh&Nh}q(h]h ]h ]Uentries]q(UsingleqX7 ISpecification (interface in zope.interface.interfaces)X( zope.interface.interfaces.ISpecificationqU tq ah ]h ]uh ]hUindexq¡hhhU hFhoubcsphinx.addnodes
desc
q¢)q£}q¤(h%Nh&Nh}q¥(h]Udomainq¦X pyh ]h ]Udesctypeq§X interfaceq¨Uobjtypeq©h¨Unoindexqªh ]h ]uh ]q«(csphinx.addnodes
desc_signature
q¬)q}q®(h%Nh&U <autodoc>q¯h}q°(h]h ]h ]q±haUfirstq²Uclassq³U h ]q´haUmoduleqµcdocutils.nodes
reprunicode
q¶X zope.interface.interfacesq·
q¸}q¹bh ]UfullnameqºX ISpecificationq»uh ]q¼(csphinx.addnodes
desc_annotation
q½)q¾}q¿(h%Nh&h¯h}qÀ(h]h ]h ]h ]h ]uh ]qÁhBX
interface q
qÃ}qÄ(hU hFh¾ubahUdesc_annotationqÅhhhX
interface hFhubcsphinx.addnodes
desc_addname
qÆ)qÇ}qÈ(h%Nh&h¯h}qÉ(h]h ]h ]h ]h ]uh ]qÊhBX zope.interface.interfaces.q˅qÌ}qÍ(hU hFhÇubahU desc_addnameqÎhhhX zope.interface.interfaces.hFhubcsphinx.addnodes
desc_name
qÏ)qÐ}qÑ(h%Nh&h¯h}qÒ(h]h ]h ]h ]h ]uh ]qÓhBX ISpecificationqԅqÕ}qÖ(hU hFhÐubahU desc_nameq×hhhh»hFhubcsphinx.addnodes
only
qØ)qÙ}qÚ(h%Nh&Nh}qÛ(h]UexprUhtmlqÜh ]h ]h ]h ]uh ]qÝh2)qÞ}qß(h ]qàcdocutils.nodes
inline
qá)qâ}qã(h ]qähBX [source]q允qæ}qç(hU hFhâubahUinlineqèhU hFhÞh}qé(h]h ]h ]h ]h ]qêU
viewcode-linkqëauubahhMhU hFhÙh}qì(h]Urefidh»h ]U refdomainUstdqíh ]UreftypeUviewcodeqîUrefdoch<h ]h ]U refexplicitU reftargetU"_modules/zope/interface/interfacesuubahUonlyqïhhhU hFhubehUdesc_signatureqðhhhh»hFh£ubcsphinx.addnodes
desc_content
qñ)qò}qó(h%Nh&h¯h}qô(h]h ]h ]h ]h ]uh ]qõ(h)qö}q÷(h%Kh&X¦ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/interfaces.py:docstring of zope.interface.interfaces.ISpecificationh}qø(h]h ]h ]h ]h ]uh ]qùhBX Object Behavioral specificationsqú
qû}qü(hX Object Behavioral specificationsqýhFhöubahhhhhhýhFhòubh)qþ}qÿ(h%Nh&X@ docstring of zope.interface.interfaces.ISpecification.providedByr h}r (h]h ]h ]Uentries]r (hX$ providedBy() (ISpecification method)X ISpecification.providedByr U tr ah ]h ]uh ]hh¡hhhU hFhòubh¢)r }r (h%Nh&j h}r (h]h¦X pyh ]h ]h§X methodr h©j hªh ]h ]uh ]r (h¬)r
}r (h%Kh&U<autointerface>r h}r
(h]h ]h ]r j ah²h³h»h ]r j ahµNh ]hºj uh ]r (hÏ)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r hBX
providedByr
r }r (hU hFj ubahh×hhhX
providedByhFj
ubcsphinx.addnodes
desc_parameterlist
r )r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r csphinx.addnodes
desc_parameter
r )r }r (h ]r hBX objectr!
r" }r# (hU hFj ubahUdesc_parameterr$ hX objecthFj h}r% (h]h ]h ]h ]h ]uubahUdesc_parameterlistr& hhhU hFj
ubehhðhhhX providedBy(object)hFj ubhñ)r' }r( (h%Kh&j h}r) (h]h ]h ]h ]h ]uh ]r* (h)r+ }r, (h%Kh&j h}r- (h]h ]h ]h ]h ]uh ]r. hBX7 Test whether the interface is implemented by the objectr/
r0 }r1 (hX7 Test whether the interface is implemented by the objectr2 hFj+ ubahhhhhj2 hFj' ubh)r3 }r4 (h%Kh&j h}r5 (h]h ]h ]h ]h ]uh ]r6 hBX Return true of the object asserts that it implements the
interface, including asserting that it implements an extended
interface.r7
r8 }r9 (hX Return true of the object asserts that it implements the
interface, including asserting that it implements an extended
interface.r: hFj3 ubahhhhhj: hFj' ubehU desc_contentr; hhhU hFj ubehUdescr< hhhU hFhòubh)r= }r> (h%Nh&XC docstring of zope.interface.interfaces.ISpecification.implementedByr? h}r@ (h]h ]h ]Uentries]rA (hX' implementedBy() (ISpecification method)X ISpecification.implementedByrB U trC ah ]h ]uh ]hh¡hhhU hFhòubh¢)rD }rE (h%Nh&j? h}rF (h]h¦X pyh ]h ]h§X methodrG h©jG hªh ]h ]uh ]rH (h¬)rI }rJ (h%Kh&j h}rK (h]h ]h ]rL jB ah²h³h»h ]rM jB ahµNh ]hºjB uh ]rN (hÏ)rO }rP (h%Kh&j h}rQ (h]h ]h ]h ]h ]uh ]rR hBX
implementedByrS
rT }rU (hU hFjO ubahh×hhhX
implementedByhFjI ubj )rV }rW (h%Kh&j h}rX (h]h ]h ]h ]h ]uh ]rY j )rZ }r[ (h ]r\ hBX class_r]
r^ }r_ (hU hFjZ ubahj$ hX class_hFjV h}r` (h]h ]h ]h ]h ]uubahj& hhhU hFjI ubehhðhhhX implementedBy(class_)hFjD ubhñ)ra }rb (h%Kh&j h}rc (h]h ]h ]h ]h ]uh ]rd (h)re }rf (h%Kh&j? h}rg (h]h ]h ]h ]h ]uh ]rh hBXC Test whether the interface is implemented by instances of the classri
rj }rk (hXC Test whether the interface is implemented by instances of the classrl hFje ubahhhhhjl hFja ubh)rm }rn (h%Kh&j? h}ro (h]h ]h ]h ]h ]uh ]rp hBX Return true of the class asserts that its instances implement the
interface, including asserting that they implement an extended
interface.rq
rr }rs (hX Return true of the class asserts that its instances implement the
interface, including asserting that they implement an extended
interface.rt hFjm ubahhhhhjt hFja ubehj; hhhU hFjD ubehj< hhhU hFhòubh)ru }rv (h%Nh&XA docstring of zope.interface.interfaces.ISpecification.isOrExtendsrw h}rx (h]h ]h ]Uentries]ry (hX% isOrExtends() (ISpecification method)X ISpecification.isOrExtendsrz U tr{ ah ]h ]uh ]hh¡hhhU hFhòubh¢)r| }r} (h%Nh&jw h}r~ (h]h¦X pyh ]h ]h§X methodr h©j hªh ]h ]uh ]r (h¬)r }r (h%Kh&j h}r (h]h ]h ]r jz ah²h³h»h ]r
jz ahµNh ]hºjz uh ]r (hÏ)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r hBX isOrExtendsr
r }r (hU hFj ubahh×hhhX isOrExtendshFj ubj )r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r j )r }r (h ]r hBX otherr
r }r (hU hFj ubahj$ hX otherhFj h}r (h]h ]h ]h ]h ]uubahj& hhhU hFj ubehhðhhhX isOrExtends(other)hFj| ubhñ)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r h)r }r (h%Kh&jw h}r (h]h ]h ]h ]h ]uh ]r hBX4 Test whether the specification is or extends anotherr¡
r¢ }r£ (hX4 Test whether the specification is or extends anotherr¤ hFj ubahhhhhj¤ hFj ubahj; hhhU hFj| ubehj< hhhU hFhòubh)r¥ }r¦ (h%Nh&X= docstring of zope.interface.interfaces.ISpecification.extendsr§ h}r¨ (h]h ]h ]Uentries]r© (hX! extends() (ISpecification method)X ISpecification.extendsrª U tr« ah ]h ]uh ]hh¡hhhU hFhòubh¢)r¬ }r (h%Nh&j§ h}r® (h]h¦X pyh ]h ]h§X methodr¯ h©j¯ hªh ]h ]uh ]r° (h¬)r± }r² (h%Kh&j h}r³ (h]h ]h ]r´ jª ah²h³h»h ]rµ jª ahµNh ]hºjª uh ]r¶ (hÏ)r· }r¸ (h%Kh&j h}r¹ (h]h ]h ]h ]h ]uh ]rº hBX extendsr»
r¼ }r½ (hU hFj· ubahh×hhhX extendshFj± ubj )r¾ }r¿ (h%Kh&j h}rÀ (h]h ]h ]h ]h ]uh ]rÁ (j )r }rà (h ]rÄ hBX otherrÅ
rÆ }rÇ (hU hFj ubahj$ hX otherhFj¾ h}rÈ (h]h ]h ]h ]h ]uubj )rÉ }rÊ (h ]rË hBX strict=TruerÌ
rÍ }rÎ (hU hFjÉ ubahj$ hX strict=TruehFj¾ h}rÏ (h]h ]h ]h ]h ]uubehj& hhhU hFj± ubehhðhhhX extends(other, strict=True)hFj¬ ubhñ)rÐ }rÑ (h%Kh&j h}rÒ (h]h ]h ]h ]h ]uh ]rÓ (h)rÔ }rÕ (h%Kh&j§ h}rÖ (h]h ]h ]h ]h ]uh ]r× hBX, Test whether a specification extends anotherrØ
rÙ }rÚ (hX, Test whether a specification extends anotherrÛ hFjÔ ubahhhhhjÛ hFjÐ ubh)rÜ }rÝ (h%Kh&j§ h}rÞ (h]h ]h ]h ]h ]uh ]rß hBXj The specification extends other if it has other as a base
interface or if one of it's bases extends other.rà
rá }râ (hXj The specification extends other if it has other as a base
interface or if one of it's bases extends other.rã hFjÜ ubahhhhhjã hFjÐ ubh)rä }rå (h%Kh&j§ h}ræ (h]h ]h ]h ]h ]uh ]rç hBX: If strict is false, then the specification extends itself.rè
ré }rê (hX: If strict is false, then the specification extends itself.rë hFjä ubahhhhhjë hFjÐ ubehj; hhhU hFj¬ ubehj< hhhU hFhòubh)rì }rí (h%Nh&X= docstring of zope.interface.interfaces.ISpecification.weakrefrî h}rï (h]h ]h ]Uentries]rð (hX! weakref() (ISpecification method)X ISpecification.weakrefrñ U trò ah ]h ]uh ]hh¡hhhU hFhòubh¢)ró }rô (h%Nh&jî h}rõ (h]h¦X pyh ]h ]h§X methodrö h©jö hªh ]h ]uh ]r÷ (h¬)rø }rù (h%Kh&j h}rú (h]h ]h ]rû jñ ah²h³h»h ]rü jñ ahµNh ]hºjñ uh ]rý (hÏ)rþ }rÿ (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r hBX weakrefr
r }r (hU hFjþ ubahh×hhhX weakrefhFjø ubj )r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r j )r }r
(h ]r hBX
callback=Noner
r
}r (hU hFj ubahj$ hX
callback=NonehFj h}r (h]h ]h ]h ]h ]uubahj& hhhU hFjø ubehhðhhhX weakref(callback=None)hFjó ubhñ)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r (h)r }r (h%Kh&jî h}r (h]h ]h ]h ]h ]uh ]r hBX% Return a weakref to the specificationr
r }r (hX% Return a weakref to the specificationr hFj ubahhhhhj hFj ubh)r }r (h%Kh&jî h}r (h]h ]h ]h ]h ]uh ]r hBXÞ This method is, regrettably, needed to allow weakrefs to be
computed to security-proxied specifications. While the
zope.interface package does not require zope.security or
zope.proxy, it has to be able to coexist with it.r
r! }r" (hXÞ This method is, regrettably, needed to allow weakrefs to be
computed to security-proxied specifications. While the
zope.interface package does not require zope.security or
zope.proxy, it has to be able to coexist with it.r# hFj ubahhhhhj# hFj ubehj; hhhU hFjó ubehj< hhhU hFhòubh)r$ }r% (h%Nh&X? docstring of zope.interface.interfaces.ISpecification.__bases__r& h}r' (h]h ]h ]Uentries]r( (hX$ __bases__ (ISpecification attribute)X ISpecification.__bases__r) U tr* ah ]h ]uh ]hh¡hhhU hFhòubh¢)r+ }r, (h%Nh&j& h}r- (h]h¦X pyh ]h ]h§X attributer. h©j. hªh ]h ]uh ]r/ (h¬)r0 }r1 (h%Kh&j h}r2 (h]h ]h ]r3 j) ah²h³h»h ]r4 j) ahµNh ]hºj) uh ]r5 hÏ)r6 }r7 (h%Kh&j h}r8 (h]h ]h ]h ]h ]uh ]r9 hBX __bases__r:
r; }r< (hU hFj6 ubahh×hhhX __bases__r= hFj0 ubahhðhhhj= hFj+ ubhñ)r> }r? (h%Kh&j h}r@ (h]h ]h ]h ]h ]uh ]rA (h)rB }rC (h%Kh&j& h}rD (h]h ]h ]h ]h ]uh ]rE hBX Base specificationsrF
rG }rH (hX Base specificationsrI hFjB ubahhhhhjI hFj> ubh)rJ }rK (h%Kh&j& h}rL (h]h ]h ]h ]h ]uh ]rM hBXL A tuple if specifications from which this specification is
directly derived.rN
rO }rP (hXL A tuple if specifications from which this specification is
directly derived.rQ hFjJ ubahhhhhjQ hFj> ubehj; hhhU hFj+ ubehj< hhhU hFhòubh)rR }rS (h%Nh&X= docstring of zope.interface.interfaces.ISpecification.__sro__rT h}rU (h]h ]h ]Uentries]rV (hX" __sro__ (ISpecification attribute)X ISpecification.__sro__rW U trX ah ]h ]uh ]hh¡hhhU hFhòubh¢)rY }rZ (h%Nh&jT h}r[ (h]h¦X pyh ]h ]h§X attributer\ h©j\ hªh ]h ]uh ]r] (h¬)r^ }r_ (h%Kh&j h}r` (h]h ]h ]ra jW ah²h³h»h ]rb jW ahµNh ]hºjW uh ]rc hÏ)rd }re (h%Kh&j h}rf (h]h ]h ]h ]h ]uh ]rg hBX __sro__rh
ri }rj (hU hFjd ubahh×hhhX __sro__rk hFj^ ubahhðhhhjk hFjY ubhñ)rl }rm (h%Kh&j h}rn (h]h ]h ]h ]h ]uh ]ro (h)rp }rq (h%Kh&jT h}rr (h]h ]h ]h ]h ]uh ]rs hBX Specification-resolution orderrt
ru }rv (hX Specification-resolution orderrw hFjp ubahhhhhjw hFjl ubh)rx }ry (h%Kh&jT h}rz (h]h ]h ]h ]h ]uh ]r{ hBXj A tuple of the specification and all of it's ancestor
specifications from most specific to least specific.r|
r} }r~ (hXj A tuple of the specification and all of it's ancestor
specifications from most specific to least specific.r hFjx ubahhhhhj hFjl ubh)r }r (h%Kh&jT h}r (h]h ]h ]h ]h ]uh ]r hBXG (This is similar to the method-resolution order for new-style classes.)r
r
}r (hXG (This is similar to the method-resolution order for new-style classes.)r hFj ubahhhhhj hFjl ubehj; hhhU hFjY ubehj< hhhU hFhòubh)r }r (h%Nh&X= docstring of zope.interface.interfaces.ISpecification.__iro__r h}r (h]h ]h ]Uentries]r (hX" __iro__ (ISpecification attribute)X ISpecification.__iro__r U tr ah ]h ]uh ]hh¡hhhU hFhòubh¢)r }r (h%Nh&j h}r (h]h¦X pyh ]h ]h§X attributer h©j hªh ]h ]uh ]r (h¬)r }r (h%Kh&j h}r (h]h ]h ]r j ah²h³h»h ]r j ahµNh ]hºj uh ]r hÏ)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r hBX __iro__r
r }r (hU hFj ubahh×hhhX __iro__r¡ hFj ubahhðhhhj¡ hFj ubhñ)r¢ }r£ (h%Kh&j h}r¤ (h]h ]h ]h ]h ]uh ]r¥ (h)r¦ }r§ (h%Kh&j h}r¨ (h]h ]h ]h ]h ]uh ]r© hBX Interface-resolution orderrª
r« }r¬ (hX Interface-resolution orderr hFj¦ ubahhhhhj hFj¢ ubh)r® }r¯ (h%Kh&j h}r° (h]h ]h ]h ]h ]uh ]r± hBX A tuple of the of the specification's ancestor interfaces from
most specific to least specific. The specification itself is
included if it is an interface.r²
r³ }r´ (hX A tuple of the of the specification's ancestor interfaces from
most specific to least specific. The specification itself is
included if it is an interface.rµ hFj® ubahhhhhjµ hFj¢ ubh)r¶ }r· (h%Kh&j h}r¸ (h]h ]h ]h ]h ]uh ]r¹ hBXG (This is similar to the method-resolution order for new-style classes.)rº
r» }r¼ (hXG (This is similar to the method-resolution order for new-style classes.)r½ hFj¶ ubahhhhhj½ hFj¢ ubehj; hhhU hFj ubehj< hhhU hFhòubh)r¾ }r¿ (h%Nh&X9 docstring of zope.interface.interfaces.ISpecification.getrÀ h}rÁ (h]h ]h ]Uentries]r (hX get() (ISpecification method)X ISpecification.getrà U trÄ ah ]h ]uh ]hh¡hhhU hFhòubh¢)rÅ }rÆ (h%Nh&jÀ h}rÇ (h]h¦X pyh ]h ]h§X methodrÈ h©jÈ hªh ]h ]uh ]rÉ (h¬)rÊ }rË (h%Kh&jÀ h}rÌ (h]h ]h ]rÍ jà ah²h³h»h ]rÎ jà ahµNh ]hºjà uh ]rÏ (hÏ)rÐ }rÑ (h%Kh&jÀ h}rÒ (h]h ]h ]h ]h ]uh ]rÓ hBX getrÔ
rÕ }rÖ (hU hFjÐ ubahh×hhhX gethFjÊ ubj )r× }rØ (h%Kh&jÀ h}rÙ (h]h ]h ]h ]h ]uh ]rÚ (j )rÛ }rÜ (h ]rÝ hBX namerÞ
rß }rà (hU hFjÛ ubahj$ hX namehFj× h}rá (h]h ]h ]h ]h ]uubj )râ }rã (h ]rä hBX default=Nonerå
ræ }rç (hU hFjâ ubahj$ hX default=NonehFj× h}rè (h]h ]h ]h ]h ]uubehj& hhhU hFjÊ ubehhðhhhX get(name, default=None)hFjÅ ubhñ)ré }rê (h%Kh&jÀ h}rë (h]h ]h ]h ]h ]uh ]rì (h)rí }rî (h%Kh&jÀ h}rï (h]h ]h ]h ]h ]uh ]rð hBX" Look up the description for a namerñ
rò }ró (hX" Look up the description for a namerô hFjí ubahhhhhjô hFjé ubh)rõ }rö (h%Kh&jÀ h}r÷ (h]h ]h ]h ]h ]uh ]rø hBX? If the named attribute is not defined, the default is
returned.rù
rú }rû (hX? If the named attribute is not defined, the default is
returned.rü hFjõ ubahhhhhjü hFjé ubehj; hhhU hFjÅ ubehj< hhhU hFhòubehj; hhhU hFh£ubehj< hhhU hFhoubehUsectionrý hhhU hFhTU
referencedrþ Kubh")rÿ }r (h%Kh&hh}r (h]r X usager ah ]r Uusager ah ]h ]h ]uh ]r (h-)r }r (h%Kh&hh}r (h]h ]h ]h ]h ]uh ]r
hBX Usager
r }r
(hX Usager hFj ubahhRhhhj hFjÿ ubh)r }r (h%Kh&hh}r (h]h ]h ]h ]h ]uh ]r hBX For example:r
r }r (hX For example:r hFj ubahhhhhj hFjÿ ubcdocutils.nodes
literal_block
r )r }r (h%Kh&hh}r (h]U xml:spacer Upreserver h ]h ]U testnodetypeX doctestUgroups]r Udefaultr ah ]h ]Uoptionsr }uh ]r hBX >>> from zope.interface.interface import Specification
>>> from zope.interface import Interface
>>> class I1(Interface):
... pass
>>> class I2(I1):
... pass
>>> class I3(I2):
... pass
>>> [i.__name__ for i in I1.__bases__]
['Interface']
>>> [i.__name__ for i in I2.__bases__]
['I1']
>>> I3.extends(I1)
True
>>> I2.__bases__ = (Interface, )
>>> [i.__name__ for i in I2.__bases__]
['Interface']
>>> I3.extends(I1)
Falser!
r" }r# (hU hFj ubahU
literal_blockr$ hhhX >>> from zope.interface.interface import Specification
>>> from zope.interface import Interface
>>> class I1(Interface):
... pass
>>> class I2(I1):
... pass
>>> class I3(I2):
... pass
>>> [i.__name__ for i in I1.__bases__]
['Interface']
>>> [i.__name__ for i in I2.__bases__]
['I1']
>>> I3.extends(I1)
True
>>> I2.__bases__ = (Interface, )
>>> [i.__name__ for i in I2.__bases__]
['Interface']
>>> I3.extends(I1)
FalsehFjÿ ubh)r% }r& (h%K.h&hh}r' (h]h ]h ]h ]h ]uh ]r( (hBX Exmples for r)
r* }r+ (hX Exmples for hFj% ubh2)r, }r- (h%K.h&hh}r. (h]h6Nh ]h ]U refdomainX pyr/ h8NUreftypeX methh9X Specification.providedByh:h ]h ]U refexplicith;h<uh ]r0 h>)r1 }r2 (h ]r3 hBX Specification.providedBy()r4
r5 }r6 (hU hFj1 ubahhGhX :meth:`Specification.providedBy`r7 hFj, h}r8 (h]h ]h ]h ]h ]r9 (hKj/ X py-methr: euubahhMhj7 hFj% ubhBX :
r; }r< (hX :hFj% ubehhhhhX- Exmples for :meth:`Specification.providedBy`:r= hFjÿ ubj )r> }r? (h%K0h&hh}r@ (h]j j h ]h ]U testnodetypeX doctestUgroups]rA j ah ]h ]j }uh ]rB hBXh >>> from zope.interface import *
>>> class I1(Interface):
... pass
>>> class C(object):
... implements(I1)
>>> c = C()
>>> class X(object):
... pass
>>> x = X()
>>> I1.providedBy(x)
False
>>> I1.providedBy(C)
False
>>> I1.providedBy(c)
True
>>> directlyProvides(x, I1)
>>> I1.providedBy(x)
True
>>> directlyProvides(C, I1)
>>> I1.providedBy(C)
TruerC
rD }rE (hU hFj> ubahj$ hhhXh >>> from zope.interface import *
>>> class I1(Interface):
... pass
>>> class C(object):
... implements(I1)
>>> c = C()
>>> class X(object):
... pass
>>> x = X()
>>> I1.providedBy(x)
False
>>> I1.providedBy(C)
False
>>> I1.providedBy(c)
True
>>> directlyProvides(x, I1)
>>> I1.providedBy(x)
True
>>> directlyProvides(C, I1)
>>> I1.providedBy(C)
TruehFjÿ ubh)rF }rG (h%KHh&hh}rH (h]h ]h ]h ]h ]uh ]rI (hBX
Examples for rJ
rK }rL (hX
Examples for hFjF ubh2)rM }rN (h%KHh&hh}rO (h]h6Nh ]h ]U refdomainX pyrP h8NUreftypeX methh9X Specification.isOrExtendsh:h ]h ]U refexplicith;h<uh ]rQ h>)rR }rS (h ]rT hBX Specification.isOrExtends()rU
rV }rW (hU hFjR ubahhGhX! :meth:`Specification.isOrExtends`rX hFjM h}rY (h]h ]h ]h ]h ]rZ (hKjP X py-methr[ euubahhMhjX hFjF ubhBX :
r\ }r] (hX :hFjF ubehhhhhX/ Examples for :meth:`Specification.isOrExtends`:r^ hFjÿ ubj )r_ }r` (h%KJh&hh}ra (h]j j h ]h ]U testnodetypeX doctestUgroups]rb j ah ]h ]j }uh ]rc hBXÄ >>> from zope.interface import Interface
>>> from zope.interface.declarations import Declaration
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration()
>>> int(spec.extends(Interface))
1
>>> spec = Declaration(I2)
>>> int(spec.extends(Interface))
1
>>> int(spec.extends(I1))
1
>>> int(spec.extends(I2))
1
>>> int(spec.extends(I3))
0
>>> int(spec.extends(I4))
0rd
re }rf (hU hFj_ ubahj$ hhhXÄ >>> from zope.interface import Interface
>>> from zope.interface.declarations import Declaration
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration()
>>> int(spec.extends(Interface))
1
>>> spec = Declaration(I2)
>>> int(spec.extends(Interface))
1
>>> int(spec.extends(I1))
1
>>> int(spec.extends(I2))
1
>>> int(spec.extends(I3))
0
>>> int(spec.extends(I4))
0hFjÿ ubh)rg }rh (h%Keh&hh}ri (h]h ]h ]h ]h ]uh ]rj (hBX
Examples for rk
rl }rm (hX
Examples for hFjg ubh2)rn }ro (h%Keh&hh}rp (h]h6Nh ]h ]U refdomainX pyrq h8NUreftypeX methh9X Specification.interfacesh:h ]h ]U refexplicith;h<uh ]rr h>)rs }rt (h ]ru hBX Specification.interfaces()rv
rw }rx (hU hFjs ubahhGhX :meth:`Specification.interfaces`ry hFjn h}rz (h]h ]h ]h ]h ]r{ (hKjq X py-methr| euubahhMhjy hFjg ubhBX :
r} }r~ (hX :hFjg ubehhhhhX. Examples for :meth:`Specification.interfaces`:r hFjÿ ubj )r }r (h%Kgh&hh}r (h]j j h ]h ]U testnodetypeX doctestUgroups]r j ah ]h ]j }uh ]r hBXC >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Specification((I2, I3))
>>> spec = Specification((I4, spec))
>>> i = spec.interfaces()
>>> [x.getName() for x in i]
['I4', 'I2', 'I3']
>>> list(i)
[]r
r }r (hU hFj ubahj$ hhhXC >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Specification((I2, I3))
>>> spec = Specification((I4, spec))
>>> i = spec.interfaces()
>>> [x.getName() for x in i]
['I4', 'I2', 'I3']
>>> list(i)
[]hFjÿ ubh)r }r (h%Kzh&hh}r (h]h ]h ]h ]h ]uh ]r (hBX Exmples for r
r }r (hX Exmples for hFj ubh2)r }r (h%Kzh&hh}r (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX methh9X Specification.extendsh:h ]h ]U refexplicith;h<uh ]r h>)r }r (h ]r hBX Specification.extends()r
r }r (hU hFj ubahhGhX :meth:`Specification.extends`r hFj h}r (h]h ]h ]h ]h ]r (hKj X py-methr euubahhMhj hFj ubhBX :
r }r (hX :hFj ubehhhhhX* Exmples for :meth:`Specification.extends`:r hFjÿ ubj )r¡ }r¢ (h%K|h&hh}r£ (h]j j h ]h ]U testnodetypeX doctestUgroups]r¤ j ah ]h ]j }uh ]r¥ hBX" >>> from zope.interface import Interface
>>> from zope.interface.declarations import Declaration
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration()
>>> int(spec.extends(Interface))
1
>>> spec = Declaration(I2)
>>> int(spec.extends(Interface))
1
>>> int(spec.extends(I1))
1
>>> int(spec.extends(I2))
1
>>> int(spec.extends(I3))
0
>>> int(spec.extends(I4))
0
>>> I2.extends(I2)
False
>>> I2.extends(I2, False)
True
>>> I2.extends(I2, strict=False)
Truer¦
r§ }r¨ (hU hFj¡ ubahj$ hhhX" >>> from zope.interface import Interface
>>> from zope.interface.declarations import Declaration
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration()
>>> int(spec.extends(Interface))
1
>>> spec = Declaration(I2)
>>> int(spec.extends(Interface))
1
>>> int(spec.extends(I1))
1
>>> int(spec.extends(I2))
1
>>> int(spec.extends(I3))
0
>>> int(spec.extends(I4))
0
>>> I2.extends(I2)
False
>>> I2.extends(I2, False)
True
>>> I2.extends(I2, strict=False)
TruehFjÿ ubehjý hhhU hFhTjþ Kubehjý hhhU hFh#ubh")r© }rª (h%Kh&hh}r« (h]h ]r¬ U'zope-interface-interface-interfaceclassr ah ]h ]r® X' zope.interface.interface.interfaceclassr¯ ah ]uh ]r° (h-)r± }r² (h%Kh&hh}r³ (h]h ]h ]h ]h ]uh ]r´ h2)rµ }r¶ (h%Kh&hh}r· (h]h6Nh ]h ]U refdomainX pyr¸ h8NUreftypeX classh9X' zope.interface.interface.InterfaceClassh:h ]h ]U refexplicith;h<uh ]r¹ h>)rº }r» (h ]r¼ hBX' zope.interface.interface.InterfaceClassr½
r¾ }r¿ (hU hFjº ubahhGhX0 :class:`zope.interface.interface.InterfaceClass`rÀ hFjµ h}rÁ (h]h ]h ]h ]h ]r (hKj¸ X py-classrà euubahhMhjÀ hFj± ubahhRhhhjÀ hFj© ubh")rÄ }rÅ (h%K¢h&hh}rÆ (h]rÇ hsah ]rÈ Uid1rÉ ah ]h ]h ]uh ]rÊ (h-)rË }rÌ (h%K¢h&hh}rÍ (h]h ]h ]h ]h ]uh ]rÎ hBX APIrÏ
rÐ }rÑ (hX APIrÒ hFjË ubahhRhhhjÒ hFjÄ ubh)rÓ }rÔ (h%K¤h&hh}rÕ (h]h ]h ]h ]h ]uh ]rÖ (hBX3 Specification objects implement the API defined by
r×
rØ }rÙ (hX3 Specification objects implement the API defined by
hFjÓ ubh2)rÚ }rÛ (h%K¤h&hh}rÜ (h]h6Nh ]h ]U refdomainX pyrÝ h8NUreftypeX classh9X$ zope.interface.interfaces.IInterfaceh:h ]h ]U refexplicith;h<uh ]rÞ h>)rß }rà (h ]rá hBX$ zope.interface.interfaces.IInterfacerâ
rã }rä (hU hFjß ubahhGhX- :class:`zope.interface.interfaces.IInterface`rå hFjÚ h}ræ (h]h ]h ]h ]h ]rç (hKjÝ X py-classrè euubahhMhjå hFjÓ ubhBX :
ré }rê (hX :hFjÓ ubehhhhhXa Specification objects implement the API defined by
:class:`zope.interface.interfaces.IInterface`:hFjÄ ubh)rë }rì (h%Nh&Nh}rí (h]h ]h ]Uentries]rî (hX3 IInterface (interface in zope.interface.interfaces)X$ zope.interface.interfaces.IInterfacerï U trð ah ]h ]uh ]hh¡hhhU hFjÄ ubh¢)rñ }rò (h%Nh&Nh}ró (h]h¦X pyh ]h ]h§X interfacerô h©jô hªh ]h ]uh ]rõ (h¬)rö }r÷ (h%Nh&h¯h}rø (h]h ]h ]rù jï ah²h³U h ]rú jï ahµh¶X zope.interface.interfacesrû
rü }rý bh ]hºX
IInterfacerþ uh ]rÿ (h½)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX
interface r
r }r (hU hFj ubahhÅhhhX
interface hFjö ubhÆ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r
hBX zope.interface.interfaces.r
r }r
(hU hFj ubahhÎhhhX zope.interface.interfaces.hFjö ubhÏ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX
IInterfacer
r }r (hU hFj ubahh×hhhjþ hFjö ubhØ)r }r (h%Nh&Nh}r (h]UexprhÜh ]h ]h ]h ]uh ]r h2)r }r (h ]r há)r }r (h ]r hBX [source]r
r }r! (hU hFj ubahhèhU hFj h}r" (h]h ]h ]h ]h ]r# hëauubahhMhU hFj h}r$ (h]Urefidjþ h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU"_modules/zope/interface/interfacesuubahhïhhhU hFjö ubehhðhhhjþ hFjñ ubhñ)r% }r& (h%Nh&h¯h}r' (h]h ]h ]h ]h ]uh ]r( (h)r) }r* (h%Kh&U <autodoc>r+ h}r, (h]h ]h ]h ]h ]uh ]r- (hBX Extends: r.
r/ }r0 (hX Extends: hFj) ubh2)r1 }r2 (h%Kh&hh}r3 (h]h6Nh ]h ]U refdomainX pyr4 h8jþ UreftypeX classh9X( zope.interface.interfaces.ISpecificationh:h ]h ]U refexplicith;h<uh ]r5 h>)r6 }r7 (h ]r8 hBX( zope.interface.interfaces.ISpecificationr9
r: }r; (hU hFj6 ubahhGhX1 :class:`zope.interface.interfaces.ISpecification`r< hFj1 h}r= (h]h ]h ]h ]h ]r> (hKj4 X py-classr? euubahhMhj< hFj) ubhBX , r@
rA }rB (hX , hFj) ubh2)rC }rD (h%Kh&hh}rE (h]h6Nh ]h ]U refdomainX pyrF h8jþ UreftypeX classh9X" zope.interface.interfaces.IElementh:h ]h ]U refexplicith;h<uh ]rG h>)rH }rI (h ]rJ hBX" zope.interface.interfaces.IElementrK
rL }rM (hU hFjH ubahhGhX+ :class:`zope.interface.interfaces.IElement`rN hFjC h}rO (h]h ]h ]h ]h ]rP (hKjF X py-classrQ euubahhMhjN hFj) ubehhhhhXg Extends: :class:`zope.interface.interfaces.ISpecification`, :class:`zope.interface.interfaces.IElement`rR hFj% ubh)rS }rT (h%Kh&X¢ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/interfaces.py:docstring of zope.interface.interfaces.IInterfacerU h}rV (h]h ]h ]h ]h ]uh ]rW hBX Interface objectsrX
rY }rZ (hX Interface objectsr[ hFjS ubahhhhhj[ hFj% ubh)r\ }r] (h%Kh&jU h}r^ (h]h ]h ]h ]h ]uh ]r_ hBX Interface objects describe the behavior of an object by containing
useful information about the object. This information includes:r`
ra }rb (hX Interface objects describe the behavior of an object by containing
useful information about the object. This information includes:rc hFj\ ubahhhhhjc hFj% ubcdocutils.nodes
block_quote
rd )re }rf (h%Nh&Nh}rg (h]h ]h ]h ]h ]uh ]rh (cdocutils.nodes
definition_list
ri )rj }rk (h ]rl (cdocutils.nodes
definition_list_item
rm )rn }ro (h%K h&jU h}rp (h]h ]h ]h ]h ]uh ]rq (cdocutils.nodes
term
rr )rs }rt (h%K h&jU h}ru (h]h ]h ]h ]h ]uh ]rv hBX> o Prose documentation about the object. In Python terms, thisrw
rx }ry (hX> o Prose documentation about the object. In Python terms, thisrz hFjs ubahUtermr{ hjz hFjn ubcdocutils.nodes
definition
r| )r} }r~ (h ]r h)r }r (h%Kh&jU h}r (h]h ]h ]h ]h ]uh ]r hBX¥ is called the "doc string" of the interface. In this element,
you describe how the object works in prose language and any
other useful information about the object.r
r
}r (hX¥ is called the "doc string" of the interface. In this element,
you describe how the object works in prose language and any
other useful information about the object.r hFj ubahhhj hFj} ubahU
definitionr hU hFjn h}r (h]h ]h ]h ]h ]uubehUdefinition_list_itemr hXå o Prose documentation about the object. In Python terms, this
is called the "doc string" of the interface. In this element,
you describe how the object works in prose language and any
other useful information about the object.
hFjj ubjm )r }r (h%K
h&jU h}r (h]h ]h ]h ]h ]uh ]r (jr )r }r (h%K
h&jU h}r (h]h ]h ]h ]h ]uh ]r hBX= o Descriptions of attributes. Attribute descriptions includer
r }r (hX= o Descriptions of attributes. Attribute descriptions includer hFj ubahj{ hj hFj ubj| )r }r (h ]r h)r }r (h%K h&jU h}r (h]h ]h ]h ]h ]uh ]r hBXR the name of the attribute and prose documentation describing
the attributes usage.r
r }r (hXR the name of the attribute and prose documentation describing
the attributes usage.r¡ hFj ubahhhj¡ hFj ubahj hU hFj h}r¢ (h]h ]h ]h ]h ]uubehj hX o Descriptions of attributes. Attribute descriptions include
the name of the attribute and prose documentation describing
the attributes usage.
hFjj ubehUdefinition_listr£ hU hFje h}r¤ (h]h ]h ]h ]h ]uubh)r¥ }r¦ (h%Kh&jU h}r§ (h]h ]h ]h ]h ]uh ]r¨ hBX< o Descriptions of methods. Method descriptions can include:r©
rª }r« (hX< o Descriptions of methods. Method descriptions can include:r¬ hFj¥ ubahhhj¬ hFje ubjd )r }r® (h ]r¯ cdocutils.nodes
bullet_list
r° )r± }r² (h ]r³ (cdocutils.nodes
list_item
r´ )rµ }r¶ (h ]r· h)r¸ }r¹ (h%Kh&jU h}rº (h]h ]h ]h ]h ]uh ]r» hBX@ Prose "doc string" documentation about the method and its
usage.r¼
r½ }r¾ (hX@ Prose "doc string" documentation about the method and its
usage.r¿ hFj¸ ubahhhj¿ hFjµ ubahU list_itemrÀ hXA Prose "doc string" documentation about the method and its
usage.
hFj± h}rÁ (h]h ]h ]h ]h ]uubj´ )r }rà (h ]rÄ h)rÅ }rÆ (h%Kh&jU h}rÇ (h]h ]h ]h ]h ]uh ]rÈ hBX A description of the methods arguments; how many arguments
are expected, optional arguments and their default values,
the position or arguments in the signature, whether the
method accepts arbitrary arguments and whether the method
accepts arbitrary keyword arguments.rÉ
rÊ }rË (hX A description of the methods arguments; how many arguments
are expected, optional arguments and their default values,
the position or arguments in the signature, whether the
method accepts arbitrary arguments and whether the method
accepts arbitrary keyword arguments.rÌ hFjÅ ubahhhjÌ hFj ubahjÀ hX
A description of the methods arguments; how many arguments
are expected, optional arguments and their default values,
the position or arguments in the signature, whether the
method accepts arbitrary arguments and whether the method
accepts arbitrary keyword arguments.
hFj± h}rÍ (h]h ]h ]h ]h ]uubehU bullet_listrÎ hU hFj h}rÏ (h]h ]h ]UbulletrÐ X -h ]h ]uubahU block_quoterÑ hU hFje h}rÒ (h]h ]h ]h ]h ]uubji )rÓ }rÔ (h ]rÕ jm )rÖ }r× (h%K h&jU h}rØ (h]h ]h ]h ]h ]uh ]rÙ (jr )rÚ }rÛ (h%K h&jU h}rÜ (h]h ]h ]h ]h ]uh ]rÝ hBXD o Optional tagged data. Interface objects (and their attributes andrÞ
rß }rà (hXD o Optional tagged data. Interface objects (and their attributes andrá hFjÚ ubahj{ hjá hFjÖ ubj| )râ }rã (h ]rä h)rå }ræ (h%Kh&jU h}rç (h]h ]h ]h ]h ]uh ]rè hBX methods) can have optional, application specific tagged data
associated with them. Examples uses for this are examples,
security assertions, pre/post conditions, and other possible
information you may want to associate with an Interface or its
attributes.ré
rê }rë (hX methods) can have optional, application specific tagged data
associated with them. Examples uses for this are examples,
security assertions, pre/post conditions, and other possible
information you may want to associate with an Interface or its
attributes.rì hFjå ubahhhjì hFjâ ubahj hU hFjÖ h}rí (h]h ]h ]h ]h ]uubehj hXF o Optional tagged data. Interface objects (and their attributes and
methods) can have optional, application specific tagged data
associated with them. Examples uses for this are examples,
security assertions, pre/post conditions, and other possible
information you may want to associate with an Interface or its
attributes.
hFjÓ ubahj£ hU hFje h}rî (h]h ]h ]h ]h ]uubehjÑ hhhU hFj% ubh)rï }rð (h%K!h&jU h}rñ (h]h ]h ]h ]h ]uh ]rò hBX Not all of this information is mandatory. For example, you may
only want the methods of your interface to have prose
documentation and not describe the arguments of the method in
exact detail. Interface objects are flexible and let you give or
take any of these components.ró
rô }rõ (hX Not all of this information is mandatory. For example, you may
only want the methods of your interface to have prose
documentation and not describe the arguments of the method in
exact detail. Interface objects are flexible and let you give or
take any of these components.rö hFjï ubahhhhhjö hFj% ubh)r÷ }rø (h%K'h&jU h}rù (h]h ]h ]h ]h ]uh ]rú hBXt Interfaces are created with the Python class statement using
either Interface.Interface or another interface, as in:rû
rü }rý (hXt Interfaces are created with the Python class statement using
either Interface.Interface or another interface, as in:hFj÷ ubahhhhhXu Interfaces are created with the Python class statement using
either Interface.Interface or another interface, as in::hFj% ubj )rþ }rÿ (h%K0h&jU h}r (h]h ]h ]j j h ]h ]uh ]r hBXL from zope.interface import Interface
class IMyInterface(Interface):
'''Interface documentation'''
def meth(arg1, arg2):
'''Documentation for meth'''
# Note that there is no self argument
class IMySubInterface(IMyInterface):
'''Interface documentation'''
def meth2():
'''Documentation for meth2'''r
r }r (hU hFjþ ubahj$ hhhXL from zope.interface import Interface
class IMyInterface(Interface):
'''Interface documentation'''
def meth(arg1, arg2):
'''Documentation for meth'''
# Note that there is no self argument
class IMySubInterface(IMyInterface):
'''Interface documentation'''
def meth2():
'''Documentation for meth2'''hFj% ubh)r }r (h%K:h&jU h}r (h]h ]h ]h ]h ]uh ]r hBX You use interfaces in two ways:r
r
}r (hX You use interfaces in two ways:r hFj ubahhhhhj hFj% ubh)r
}r (h%K<h&jU h}r (h]h ]h ]h ]h ]uh ]r hBX7 o You assert that your object implement the interfaces.r
r }r (hX7 o You assert that your object implement the interfaces.r hFj
ubahhhhhj hFj% ubjd )r }r (h%Nh&Nh}r (h]h ]h ]h ]h ]uh ]r (h)r }r (h%K>h&jU h}r (h]h ]h ]h ]h ]uh ]r hBXR There are several ways that you can assert that an object
implements an interface:r
r }r (hXR There are several ways that you can assert that an object
implements an interface:r hFj ubahhhj hFj ubcdocutils.nodes
enumerated_list
r! )r" }r# (h ]r$ (j´ )r% }r& (h ]r' h)r( }r) (h%KAh&jU h}r* (h]h ]h ]h ]h ]uh ]r+ hBX8 Call zope.interface.implements in your class definition.r,
r- }r. (hX8 Call zope.interface.implements in your class definition.r/ hFj( ubahhhj/ hFj% ubahjÀ hX9 Call zope.interface.implements in your class definition.
hFj" h}r0 (h]h ]h ]h ]h ]uubj´ )r1 }r2 (h ]r3 h)r4 }r5 (h%KCh&jU h}r6 (h]h ]h ]h ]h ]uh ]r7 hBX5 Call zope.interfaces.directlyProvides on your object.r8
r9 }r: (hX5 Call zope.interfaces.directlyProvides on your object.r; hFj4 ubahhhj; hFj1 ubahjÀ hX6 Call zope.interfaces.directlyProvides on your object.
hFj" h}r< (h]h ]h ]h ]h ]uubj´ )r= }r> (h ]r? (h)r@ }rA (h%KEh&jU h}rB (h]h ]h ]h ]h ]uh ]rC hBXa Call 'zope.interface.classImplements' to assert that instances
of a class implement an interface.rD
rE }rF (hXa Call 'zope.interface.classImplements' to assert that instances
of a class implement an interface.rG hFj@ ubahhhjG hFj= ubh)rH }rI (h%KHh&jU h}rJ (h]h ]h ]h ]h ]uh ]rK hBX For example:rL
rM }rN (hX For example:hFjH ubahhhX
For example::rO hFj= ubj )rP }rQ (h%KPh}rR (h]h ]h ]j j h ]h ]uh ]rS hBXW from zope.interface import classImplements
classImplements(some_class, some_interface)rT
rU }rV (hU hFjP ubahj$ hXW from zope.interface import classImplements
classImplements(some_class, some_interface)hFj= ubh)rW }rX (h%KNh&jU h}rY (h]h ]h ]h ]h ]uh ]rZ hBX´ This approach is useful when it is not an option to modify
the class source. Note that this doesn't affect what the
class itself implements, but only what its instances
implement.r[
r\ }r] (hX´ This approach is useful when it is not an option to modify
the class source. Note that this doesn't affect what the
class itself implements, but only what its instances
implement.r^ hFjW ubahhhj^ hFj= ubehjÀ hX Call 'zope.interface.classImplements' to assert that instances
of a class implement an interface.
For example::
from zope.interface import classImplements
classImplements(some_class, some_interface)
This approach is useful when it is not an option to modify
the class source. Note that this doesn't affect what the
class itself implements, but only what its instances
implement.
hFj" h}r_ (h]h ]h ]h ]h ]uubehUenumerated_listr` hU hFj h}ra (h]Uprefixrb U Uenumtyperc Uarabicrd h ]h ]h ]h ]Usuffixre U.uubehjÑ hhhU hFj% ubji )rf }rg (h%Nh&j h}rh (h]h ]h ]h ]h ]uh ]ri jm )rj }rk (h%KVh&jU h}rl (h]h ]h ]h ]h ]uh ]rm (jr )rn }ro (h%KVh&jU h}rp (h]h ]h ]h ]h ]uh ]rq hBX? o You query interface meta-data. See the IInterface methods andrr
rs }rt (hX? o You query interface meta-data. See the IInterface methods andru hFjn ubahj{ hju hFjj ubj| )rv }rw (h ]rx h)ry }rz (h%KTh&jU h}r{ (h]h ]h ]h ]h ]uh ]r| hBX attributes for details.r}
r~ }r (hX attributes for details.r hFjy ubahhhj hFjv ubahj hU hFjj h}r (h]h ]h ]h ]h ]uubehj hXZ o You query interface meta-data. See the IInterface methods and
attributes for details.
hFjf ubahj£ hhhU hFj% ubh)r }r (h%Nh&X7 docstring of zope.interface.interfaces.IInterface.namesr h}r
(h]h ]h ]Uentries]r (hX names() (IInterface method)X IInterface.namesr U tr ah ]h ]uh ]hh¡hhhU hFj% ubh¢)r }r (h%Nh&j h}r (h]h¦X pyh ]h ]h§X methodr h©j hªh ]h ]uh ]r (h¬)r }r (h%Kh&j h}r (h]h ]h ]r j ah²h³jþ h ]r j ahµNh ]hºj uh ]r (hÏ)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r hBX namesr
r }r (hU hFj ubahh×hhhX nameshFj ubj )r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r j )r }r (h ]r¡ hBX all=Falser¢
r£ }r¤ (hU hFj ubahj$ hX all=FalsehFj h}r¥ (h]h ]h ]h ]h ]uubahj& hhhU hFj ubehhðhhhX names(all=False)hFj ubhñ)r¦ }r§ (h%Kh&j h}r¨ (h]h ]h ]h ]h ]uh ]r© (h)rª }r« (h%Kh&j h}r¬ (h]h ]h ]h ]h ]uh ]r hBX! Get the interface attribute namesr®
r¯ }r° (hX! Get the interface attribute namesr± hFjª ubahhhhhj± hFj¦ ubh)r² }r³ (h%Kh&j h}r´ (h]h ]h ]h ]h ]uh ]rµ hBXj Return a sequence of the names of the attributes, including
methods, included in the interface definition.r¶
r· }r¸ (hXj Return a sequence of the names of the attributes, including
methods, included in the interface definition.r¹ hFj² ubahhhhhj¹ hFj¦ ubh)rº }r» (h%Kh&j h}r¼ (h]h ]h ]h ]h ]uh ]r½ hBX¥ Normally, only directly defined attributes are included. If
a true positional or keyword argument is given, then
attributes defined by base classes will be included.r¾
r¿ }rÀ (hX¥ Normally, only directly defined attributes are included. If
a true positional or keyword argument is given, then
attributes defined by base classes will be included.rÁ hFjº ubahhhhhjÁ hFj¦ ubehj; hhhU hFj ubehj< hhhU hFj% ubh)r }rà (h%Nh&XF docstring of zope.interface.interfaces.IInterface.namesAndDescriptionsrÄ h}rÅ (h]h ]h ]Uentries]rÆ (hX* namesAndDescriptions() (IInterface method)X IInterface.namesAndDescriptionsrÇ U trÈ ah ]h ]uh ]hh¡hhhU hFj% ubh¢)rÉ }rÊ (h%Nh&jÄ h}rË (h]h¦X pyh ]h ]h§X methodrÌ h©jÌ hªh ]h ]uh ]rÍ (h¬)rÎ }rÏ (h%Kh&j h}rÐ (h]h ]h ]rÑ jÇ ah²h³jþ h ]rÒ jÇ ahµNh ]hºjÇ uh ]rÓ (hÏ)rÔ }rÕ (h%Kh&j h}rÖ (h]h ]h ]h ]h ]uh ]r× hBX namesAndDescriptionsrØ
rÙ }rÚ (hU hFjÔ ubahh×hhhX namesAndDescriptionshFjÎ ubj )rÛ }rÜ (h%Kh&j h}rÝ (h]h ]h ]h ]h ]uh ]rÞ j )rß }rà (h ]rá hBX all=Falserâ
rã }rä (hU hFjß ubahj$ hX all=FalsehFjÛ h}rå (h]h ]h ]h ]h ]uubahj& hhhU hFjÎ ubehhðhhhX namesAndDescriptions(all=False)hFjÉ ubhñ)ræ }rç (h%Kh&j h}rè (h]h ]h ]h ]h ]uh ]ré (h)rê }rë (h%Kh&jÄ h}rì (h]h ]h ]h ]h ]uh ]rí hBX2 Get the interface attribute names and descriptionsrî
rï }rð (hX2 Get the interface attribute names and descriptionsrñ hFjê ubahhhhhjñ hFjæ ubh)rò }ró (h%Kh&jÄ h}rô (h]h ]h ]h ]h ]uh ]rõ hBX Return a sequence of the names and descriptions of the
attributes, including methods, as name-value pairs, included
in the interface definition.rö
r÷ }rø (hX Return a sequence of the names and descriptions of the
attributes, including methods, as name-value pairs, included
in the interface definition.rù hFjò ubahhhhhjù hFjæ ubh)rú }rû (h%Kh&jÄ h}rü (h]h ]h ]h ]h ]uh ]rý hBX¥ Normally, only directly defined attributes are included. If
a true positional or keyword argument is given, then
attributes defined by base classes will be included.rþ
rÿ }r (hX¥ Normally, only directly defined attributes are included. If
a true positional or keyword argument is given, then
attributes defined by base classes will be included.r hFjú ubahhhhhj hFjæ ubehj; hhhU hFjÉ ubehj< hhhU hFj% ubh)r }r (h%Nh&X= docstring of zope.interface.interfaces.IInterface.__getitem__r h}r (h]h ]h ]Uentries]r (hX! __getitem__() (IInterface method)X IInterface.__getitem__r U tr ah ]h ]uh ]hh¡hhhU hFj% ubh¢)r }r
(h%Nh&j h}r (h]h¦X pyh ]h ]h§X methodr h©j hªh ]h ]uh ]r
(h¬)r }r (h%Kh&j h}r (h]h ]h ]r j ah²h³jþ h ]r j ahµNh ]hºj uh ]r (hÏ)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r hBX __getitem__r
r }r (hU hFj ubahh×hhhX __getitem__hFj ubj )r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r j )r }r (h ]r! hBX namer"
r# }r$ (hU hFj ubahj$ hX namehFj h}r% (h]h ]h ]h ]h ]uubahj& hhhU hFj ubehhðhhhX __getitem__(name)hFj ubhñ)r& }r' (h%Kh&j h}r( (h]h ]h ]h ]h ]uh ]r) (h)r* }r+ (h%Kh&j h}r, (h]h ]h ]h ]h ]uh ]r- hBX Get the description for a namer.
r/ }r0 (hX Get the description for a namer1 hFj* ubahhhhhj1 hFj& ubh)r2 }r3 (h%Kh&j h}r4 (h]h ]h ]h ]h ]uh ]r5 hBX< If the named attribute is not defined, a KeyError is raised.r6
r7 }r8 (hX< If the named attribute is not defined, a KeyError is raised.r9 hFj2 ubahhhhhj9 hFj& ubehj; hhhU hFj ubehj< hhhU hFj% ubh)r: }r; (h%Nh&X8 docstring of zope.interface.interfaces.IInterface.directr< h}r= (h]h ]h ]Uentries]r> (hX direct() (IInterface method)X IInterface.directr? U tr@ ah ]h ]uh ]hh¡hhhU hFj% ubh¢)rA }rB (h%Nh&j< h}rC (h]h¦X pyh ]h ]h§X methodrD h©jD hªh ]h ]uh ]rE (h¬)rF }rG (h%Kh&j h}rH (h]h ]h ]rI j? ah²h³jþ h ]rJ j? ahµNh ]hºj? uh ]rK (hÏ)rL }rM (h%Kh&j h}rN (h]h ]h ]h ]h ]uh ]rO hBX directrP
rQ }rR (hU hFjL ubahh×hhhX directhFjF ubj )rS }rT (h%Kh&j h}rU (h]h ]h ]h ]h ]uh ]rV j )rW }rX (h ]rY hBX namerZ
r[ }r\ (hU hFjW ubahj$ hX namehFjS h}r] (h]h ]h ]h ]h ]uubahj& hhhU hFjF ubehhðhhhX direct(name)hFjA ubhñ)r^ }r_ (h%Kh&j h}r` (h]h ]h ]h ]h ]uh ]ra (h)rb }rc (h%Kh&j< h}rd (h]h ]h ]h ]h ]uh ]re hBXC Get the description for the name if it was defined by the interfacerf
rg }rh (hXC Get the description for the name if it was defined by the interfaceri hFjb ubahhhhhji hFj^ ubh)rj }rk (h%Kh&j< h}rl (h]h ]h ]h ]h ]uh ]rm hBX7 If the interface doesn't define the name, returns None.rn
ro }rp (hX7 If the interface doesn't define the name, returns None.rq hFjj ubahhhhhjq hFj^ ubehj; hhhU hFjA ubehj< hhhU hFj% ubh)rr }rs (h%Nh&XD docstring of zope.interface.interfaces.IInterface.validateInvariantsrt h}ru (h]h ]h ]Uentries]rv (hX( validateInvariants() (IInterface method)X IInterface.validateInvariantsrw U trx ah ]h ]uh ]hh¡hhhU hFj% ubh¢)ry }rz (h%Nh&jt h}r{ (h]h¦X pyh ]h ]h§X methodr| h©j| hªh ]h ]uh ]r} (h¬)r~ }r (h%Kh&j h}r (h]h ]h ]r jw ah²h³jþ h ]r jw ahµNh ]hºjw uh ]r (hÏ)r }r
(h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r hBX validateInvariantsr
r }r (hU hFj ubahh×hhhX validateInvariantshFj~ ubj )r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r (j )r }r (h ]r hBX objr
r }r (hU hFj ubahj$ hX objhFj h}r (h]h ]h ]h ]h ]uubj )r }r (h ]r hBX errors=Noner
r }r (hU hFj ubahj$ hX errors=NonehFj h}r (h]h ]h ]h ]h ]uubehj& hhhU hFj~ ubehhðhhhX$ validateInvariants(obj, errors=None)hFjy ubhñ)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r (h)r¡ }r¢ (h%Kh&jt h}r£ (h]h ]h ]h ]h ]uh ]r¤ hBX Validate invariantsr¥
r¦ }r§ (hX Validate invariantsr¨ hFj¡ ubahhhhhj¨ hFj ubh)r© }rª (h%Kh&jt h}r« (h]h ]h ]h ]h ]uh ]r¬ hBXÕ Validate object to defined invariants. If errors is None,
raises first Invalid error; if errors is a list, appends all errors
to list, then raises Invalid with the errors as the first element
of the "args" tuple.r
r® }r¯ (hXÕ Validate object to defined invariants. If errors is None,
raises first Invalid error; if errors is a list, appends all errors
to list, then raises Invalid with the errors as the first element
of the "args" tuple.r° hFj© ubahhhhhj° hFj ubehj; hhhU hFjy ubehj< hhhU hFj% ubh)r± }r² (h%Nh&X> docstring of zope.interface.interfaces.IInterface.__contains__r³ h}r´ (h]h ]h ]Uentries]rµ (hX" __contains__() (IInterface method)X IInterface.__contains__r¶ U tr· ah ]h ]uh ]hh¡hhhU hFj% ubh¢)r¸ }r¹ (h%Nh&j³ h}rº (h]h¦X pyh ]h ]h§X methodr» h©j» hªh ]h ]uh ]r¼ (h¬)r½ }r¾ (h%Kh&j h}r¿ (h]h ]h ]rÀ j¶ ah²h³jþ h ]rÁ j¶ ahµNh ]hºj¶ uh ]r (hÏ)rà }rÄ (h%Kh&j h}rÅ (h]h ]h ]h ]h ]uh ]rÆ hBX __contains__rÇ
rÈ }rÉ (hU hFjà ubahh×hhhX __contains__hFj½ ubj )rÊ }rË (h%Kh&j h}rÌ (h]h ]h ]h ]h ]uh ]rÍ j )rÎ }rÏ (h ]rÐ hBX namerÑ
rÒ }rÓ (hU hFjÎ ubahj$ hX namehFjÊ h}rÔ (h]h ]h ]h ]h ]uubahj& hhhU hFj½ ubehhðhhhX __contains__(name)hFj¸ ubhñ)rÕ }rÖ (h%Kh&j h}r× (h]h ]h ]h ]h ]uh ]rØ h)rÙ }rÚ (h%Kh&j³ h}rÛ (h]h ]h ]h ]h ]uh ]rÜ hBX1 Test whether the name is defined by the interfacerÝ
rÞ }rß (hX1 Test whether the name is defined by the interfacerà hFjÙ ubahhhhhjà hFjÕ ubahj; hhhU hFj¸ ubehj< hhhU hFj% ubh)rá }râ (h%Nh&X: docstring of zope.interface.interfaces.IInterface.__iter__rã h}rä (h]h ]h ]Uentries]rå (hX __iter__() (IInterface method)X IInterface.__iter__ræ U trç ah ]h ]uh ]hh¡hhhU hFj% ubh¢)rè }ré (h%Nh&jã h}rê (h]h¦X pyh ]h ]h§X methodrë h©jë hªh ]h ]uh ]rì (h¬)rí }rî (h%Kh&j h}rï (h]h ]h ]rð jæ ah²h³jþ h ]rñ jæ ahµNh ]hºjæ uh ]rò (hÏ)ró }rô (h%Kh&j h}rõ (h]h ]h ]h ]h ]uh ]rö hBX __iter__r÷
rø }rù (hU hFjó ubahh×hhhX __iter__hFjí ubj )rú }rû (h%Kh&j h}rü (h]h ]h ]h ]h ]uh ]hj& hhhU hFjí ubehhðhhhX
__iter__()hFjè ubhñ)rý }rþ (h%Kh&j h}rÿ (h]h ]h ]h ]h ]uh ]r (h)r }r (h%Kh&jã h}r (h]h ]h ]h ]h ]uh ]r hBX: Return an iterator over the names defined by the interfacer
r }r (hX: Return an iterator over the names defined by the interfacer hFj ubahhhhhj hFjý ubh)r }r
(h%Kh&jã h}r (h]h ]h ]h ]h ]uh ]r hBXp The names iterated include all of the names defined by the
interface directly and indirectly by base interfaces.r
r }r (hXp The names iterated include all of the names defined by the
interface directly and indirectly by base interfaces.r hFj ubahhhhhj hFjý ubehj; hhhU hFjè ubehj< hhhU hFj% ubh)r }r (h%Nh&X< docstring of zope.interface.interfaces.IInterface.__module__r h}r (h]h ]h ]Uentries]r (hX! __module__ (IInterface attribute)X IInterface.__module__r U tr ah ]h ]uh ]hh¡hhhU hFj% ubh¢)r }r (h%Nh&j h}r (h]h¦X pyh ]h ]h§X attributer h©j hªh ]h ]uh ]r (h¬)r }r (h%Kh&j h}r (h]h ]h ]r j ah²h³jþ h ]r! j ahµNh ]hºj uh ]r" hÏ)r# }r$ (h%Kh&j h}r% (h]h ]h ]h ]h ]uh ]r& hBX
__module__r'
r( }r) (hU hFj# ubahh×hhhX
__module__r* hFj ubahhðhhhj* hFj ubhñ)r+ }r, (h%Kh&j h}r- (h]h ]h ]h ]h ]uh ]r. h)r/ }r0 (h%Kh&j h}r1 (h]h ]h ]h ]h ]uh ]r2 hBX- The name of the module defining the interfacer3
r4 }r5 (hX- The name of the module defining the interfacer6 hFj/ ubahhhhhj6 hFj+ ubahj; hhhU hFj ubehj< hhhU hFj% ubehj; hhhU hFjñ ubehj< hhhU hFjÄ ubehjý hhhU hFj© jþ Kubh")r7 }r8 (h%Kh&hh}r9 (h]r: j ah ]r; Uid2r< ah ]h ]h ]uh ]r= (h-)r> }r? (h%Kh&hh}r@ (h]h ]h ]h ]h ]uh ]rA hBX UsagerB
rC }rD (hX UsagerE hFj> ubahhRhhhjE hFj7 ubh)rF }rG (h%K¯h&hh}rH (h]h ]h ]h ]h ]uh ]rI (hBX Exmples for rJ
rK }rL (hX Exmples for hFjF ubh2)rM }rN (h%K¯h&hh}rO (h]h6Nh ]h ]U refdomainX pyrP h8NUreftypeX methh9X InterfaceClass.extendsh:h ]h ]U refexplicith;h<uh ]rQ h>)rR }rS (h ]rT hBX InterfaceClass.extends()rU
rV }rW (hU hFjR ubahhGhX :meth:`InterfaceClass.extends`rX hFjM h}rY (h]h ]h ]h ]h ]rZ (hKjP X py-methr[ euubahhMhjX hFjF ubhBX :
r\ }r] (hX :hFjF ubehhhhhX+ Exmples for :meth:`InterfaceClass.extends`:r^ hFj7 ubj )r_ }r` (h%K±h&hh}ra (h]j j h ]h ]U testnodetypeX doctestUgroups]rb j ah ]h ]j }uh ]rc hBX >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>>
>>> i = I1.interfaces()
>>> [x.getName() for x in i]
['I1']
>>> list(i)
[]rd
re }rf (hU hFj_ ubahj$ hhhX >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>>
>>> i = I1.interfaces()
>>> [x.getName() for x in i]
['I1']
>>> list(i)
[]hFj7 ubehjý hhhU hFj© jþ Kubehjý hhhU hFh#ubh")rg }rh (h%K¿h&hh}ri (h]h ]rj U'zope-interface-declarations-declarationrk ah ]h ]rl X' zope.interface.declarations.declarationrm ah ]uh ]rn (h-)ro }rp (h%K¿h&hh}rq (h]h ]h ]h ]h ]uh ]rr h2)rs }rt (h%K¾h&hh}ru (h]h6Nh ]h ]U refdomainX pyrv h8NUreftypeX classh9X' zope.interface.declarations.Declarationh:h ]h ]U refexplicith;h<uh ]rw h>)rx }ry (h ]rz hBX' zope.interface.declarations.Declarationr{
r| }r} (hU hFjx ubahhGhX0 :class:`zope.interface.declarations.Declaration`r~ hFjs h}r (h]h ]h ]h ]h ]r (hKjv X py-classr euubahhMhj~ hFjo ubahhRhhhj~ hFjg ubh")r }r (h%KÂh&hh}r (h]r
X apir ah ]r Uid3r ah ]h ]h ]uh ]r (h-)r }r (h%KÂh&hh}r (h]h ]h ]h ]h ]uh ]r hBX APIr
r }r (hX APIr hFj ubahhRhhhj hFj ubh)r }r (h%KÄh&hh}r (h]h ]h ]h ]h ]uh ]r (hBX3 Specification objects implement the API defined by
r
r }r (hX3 Specification objects implement the API defined by
hFj ubh2)r }r (h%KÄh&hh}r (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX classh9X& zope.interface.interfaces.IDeclarationh:h ]h ]U refexplicith;h<uh ]r h>)r }r (h ]r hBX& zope.interface.interfaces.IDeclarationr¡
r¢ }r£ (hU hFj ubahhGhX/ :class:`zope.interface.interfaces.IDeclaration`r¤ hFj h}r¥ (h]h ]h ]h ]h ]r¦ (hKj X py-classr§ euubahhMhj¤ hFj ubhBX :
r¨ }r© (hX :hFj ubehhhhhXc Specification objects implement the API defined by
:class:`zope.interface.interfaces.IDeclaration`:hFj ubh)rª }r« (h%Nh&Nh}r¬ (h]h ]h ]Uentries]r (hX5 IDeclaration (interface in zope.interface.interfaces)X& zope.interface.interfaces.IDeclarationr® U tr¯ ah ]h ]uh ]hh¡hhhU hFj ubh¢)r° }r± (h%Nh&Nh}r² (h]h¦X pyh ]h ]h§X interfacer³ h©j³ hªh ]h ]uh ]r´ (h¬)rµ }r¶ (h%Nh&h¯h}r· (h]h ]h ]r¸ j® ah²h³U h ]r¹ j® ahµh¶X zope.interface.interfacesrº
r» }r¼ bh ]hºX IDeclarationr½ uh ]r¾ (h½)r¿ }rÀ (h%Nh&h¯h}rÁ (h]h ]h ]h ]h ]uh ]r hBX
interface rÃ
rÄ }rÅ (hU hFj¿ ubahhÅhhhX
interface hFjµ ubhÆ)rÆ }rÇ (h%Nh&h¯h}rÈ (h]h ]h ]h ]h ]uh ]rÉ hBX zope.interface.interfaces.rÊ
rË }rÌ (hU hFjÆ ubahhÎhhhX zope.interface.interfaces.hFjµ ubhÏ)rÍ }rÎ (h%Nh&h¯h}rÏ (h]h ]h ]h ]h ]uh ]rÐ hBX IDeclarationrÑ
rÒ }rÓ (hU hFjÍ ubahh×hhhj½ hFjµ ubhØ)rÔ }rÕ (h%Nh&Nh}rÖ (h]UexprhÜh ]h ]h ]h ]uh ]r× h2)rØ }rÙ (h ]rÚ há)rÛ }rÜ (h ]rÝ hBX [source]rÞ
rß }rà (hU hFjÛ ubahhèhU hFjØ h}rá (h]h ]h ]h ]h ]râ hëauubahhMhU hFjÔ h}rã (h]Urefidj½ h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU"_modules/zope/interface/interfacesuubahhïhhhU hFjµ ubehhðhhhj½ hFj° ubhñ)rä }rå (h%Nh&h¯h}ræ (h]h ]h ]h ]h ]uh ]rç (h)rè }ré (h%Kh&j+ h}rê (h]h ]h ]h ]h ]uh ]rë (hBX Extends: rì
rí }rî (hX Extends: hFjè ubh2)rï }rð (h%Kh&hh}rñ (h]h6Nh ]h ]U refdomainX pyrò h8j½ UreftypeX classh9X( zope.interface.interfaces.ISpecificationh:h ]h ]U refexplicith;h<uh ]ró h>)rô }rõ (h ]rö hBX( zope.interface.interfaces.ISpecificationr÷
rø }rù (hU hFjô ubahhGhX1 :class:`zope.interface.interfaces.ISpecification`rú hFjï h}rû (h]h ]h ]h ]h ]rü (hKjò X py-classrý euubahhMhjú hFjè ubehhhhhX: Extends: :class:`zope.interface.interfaces.ISpecification`rþ hFjä ubh)rÿ }r (h%Kh&X¤ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/interfaces.py:docstring of zope.interface.interfaces.IDeclarationr h}r (h]h ]h ]h ]h ]uh ]r hBX Interface declarationr
r }r (hX Interface declarationr hFjÿ ubahhhhhj hFjä ubh)r }r (h%Kh&j h}r
(h]h ]h ]h ]h ]uh ]r hBX^ Declarations are used to express the interfaces implemented by
classes or provided by objects.r
r
}r (hX^ Declarations are used to express the interfaces implemented by
classes or provided by objects.r hFj ubahhhhhj hFjä ubh)r }r (h%Nh&X@ docstring of zope.interface.interfaces.IDeclaration.__contains__r h}r (h]h ]h ]Uentries]r (hX$ __contains__() (IDeclaration method)X IDeclaration.__contains__r U tr ah ]h ]uh ]hh¡hhhU hFjä ubh¢)r }r (h%Nh&j h}r (h]h¦X pyh ]h ]h§X methodr h©j hªh ]h ]uh ]r (h¬)r }r (h%Kh&j h}r (h]h ]h ]r j ah²h³j½ h ]r j ahµNh ]hºj uh ]r! (hÏ)r" }r# (h%Kh&j h}r$ (h]h ]h ]h ]h ]uh ]r% hBX __contains__r&
r' }r( (hU hFj" ubahh×hhhX __contains__hFj ubj )r) }r* (h%Kh&j h}r+ (h]h ]h ]h ]h ]uh ]r, j )r- }r. (h ]r/ hBX interfacer0
r1 }r2 (hU hFj- ubahj$ hX interfacehFj) h}r3 (h]h ]h ]h ]h ]uubahj& hhhU hFj ubehhðhhhX __contains__(interface)hFj ubhñ)r4 }r5 (h%Kh&j h}r6 (h]h ]h ]h ]h ]uh ]r7 (h)r8 }r9 (h%Kh&j h}r: (h]h ]h ]h ]h ]uh ]r; hBX1 Test whether an interface is in the specificationr<
r= }r> (hX1 Test whether an interface is in the specificationr? hFj8 ubahhhhhj? hFj4 ubh)r@ }rA (h%Kh&j h}rB (h]h ]h ]h ]h ]uh ]rC hBXe Return true if the given interface is one of the interfaces in
the specification and false otherwise.rD
rE }rF (hXe Return true if the given interface is one of the interfaces in
the specification and false otherwise.rG hFj@ ubahhhhhjG hFj4 ubehj; hhhU hFj ubehj< hhhU hFjä ubh)rH }rI (h%Nh&X< docstring of zope.interface.interfaces.IDeclaration.__iter__rJ h}rK (h]h ]h ]Uentries]rL (hX __iter__() (IDeclaration method)X IDeclaration.__iter__rM U trN ah ]h ]uh ]hh¡hhhU hFjä ubh¢)rO }rP (h%Nh&jJ h}rQ (h]h¦X pyh ]h ]h§X methodrR h©jR hªh ]h ]uh ]rS (h¬)rT }rU (h%Kh&j h}rV (h]h ]h ]rW jM ah²h³j½ h ]rX jM ahµNh ]hºjM uh ]rY (hÏ)rZ }r[ (h%Kh&j h}r\ (h]h ]h ]h ]h ]uh ]r] hBX __iter__r^
r_ }r` (hU hFjZ ubahh×hhhX __iter__hFjT ubj )ra }rb (h%Kh&j h}rc (h]h ]h ]h ]h ]uh ]hj& hhhU hFjT ubehhðhhhX
__iter__()hFjO ubhñ)rd }re (h%Kh&j h}rf (h]h ]h ]h ]h ]uh ]rg h)rh }ri (h%Kh&jJ h}rj (h]h ]h ]h ]h ]uh ]rk hBX: Return an iterator for the interfaces in the specificationrl
rm }rn (hX: Return an iterator for the interfaces in the specificationro hFjh ubahhhhhjo hFjd ubahj; hhhU hFjO ubehj< hhhU hFjä ubh)rp }rq (h%Nh&X= docstring of zope.interface.interfaces.IDeclaration.flattenedrr h}rs (h]h ]h ]Uentries]rt (hX! flattened() (IDeclaration method)X IDeclaration.flattenedru U trv ah ]h ]uh ]hh¡hhhU hFjä ubh¢)rw }rx (h%Nh&jr h}ry (h]h¦X pyh ]h ]h§X methodrz h©jz hªh ]h ]uh ]r{ (h¬)r| }r} (h%Kh&j h}r~ (h]h ]h ]r ju ah²h³j½ h ]r ju ahµNh ]hºju uh ]r (hÏ)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r
hBX flattenedr
r }r (hU hFj ubahh×hhhX flattenedhFj| ubj )r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]hj& hhhU hFj| ubehhðhhhX flattened()hFjw ubhñ)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r (h)r }r (h%Kh&jr h}r (h]h ]h ]h ]h ]uh ]r hBX: Return an iterator of all included and extended interfacesr
r }r (hX: Return an iterator of all included and extended interfacesr hFj ubahhhhhj hFj ubh)r }r (h%Kh&jr h}r (h]h ]h ]h ]h ]uh ]r hBX An iterator is returned for all interfaces either included in
or extended by interfaces included in the specifications
without duplicates. The interfaces are in "interface
resolution order". The interface resolution order is such that
base interfaces are listed after interfaces that extend them
and, otherwise, interfaces are included in the order that they
were defined in the specification.r
r }r (hX An iterator is returned for all interfaces either included in
or extended by interfaces included in the specifications
without duplicates. The interfaces are in "interface
resolution order". The interface resolution order is such that
base interfaces are listed after interfaces that extend them
and, otherwise, interfaces are included in the order that they
were defined in the specification.r hFj ubahhhhhj hFj ubehj; hhhU hFjw ubehj< hhhU hFjä ubh)r }r¡ (h%Nh&X; docstring of zope.interface.interfaces.IDeclaration.__sub__r¢ h}r£ (h]h ]h ]Uentries]r¤ (hX __sub__() (IDeclaration method)X IDeclaration.__sub__r¥ U tr¦ ah ]h ]uh ]hh¡hhhU hFjä ubh¢)r§ }r¨ (h%Nh&j¢ h}r© (h]h¦X pyh ]h ]h§X methodrª h©jª hªh ]h ]uh ]r« (h¬)r¬ }r (h%Kh&j h}r® (h]h ]h ]r¯ j¥ ah²h³j½ h ]r° j¥ ahµNh ]hºj¥ uh ]r± (hÏ)r² }r³ (h%Kh&j h}r´ (h]h ]h ]h ]h ]uh ]rµ hBX __sub__r¶
r· }r¸ (hU hFj² ubahh×hhhX __sub__hFj¬ ubj )r¹ }rº (h%Kh&j h}r» (h]h ]h ]h ]h ]uh ]r¼ j )r½ }r¾ (h ]r¿ hBX
interfacesrÀ
rÁ }r (hU hFj½ ubahj$ hX
interfaceshFj¹ h}rà (h]h ]h ]h ]h ]uubahj& hhhU hFj¬ ubehhðhhhX __sub__(interfaces)hFj§ ubhñ)rÄ }rÅ (h%Kh&j h}rÆ (h]h ]h ]h ]h ]uh ]rÇ (h)rÈ }rÉ (h%Kh&j¢ h}rÊ (h]h ]h ]h ]h ]uh ]rË hBX? Create an interface specification with some interfaces excludedrÌ
rÍ }rÎ (hX? Create an interface specification with some interfaces excludedrÏ hFjÈ ubahhhhhjÏ hFjÄ ubh)rÐ }rÑ (h%Kh&j¢ h}rÒ (h]h ]h ]h ]h ]uh ]rÓ hBX§ The argument can be an interface or an interface
specifications. The interface or interfaces given in a
specification are subtracted from the interface specification.rÔ
rÕ }rÖ (hX§ The argument can be an interface or an interface
specifications. The interface or interfaces given in a
specification are subtracted from the interface specification.r× hFjÐ ubahhhhhj× hFjÄ ubh)rØ }rÙ (h%Kh&j¢ h}rÚ (h]h ]h ]h ]h ]uh ]rÛ hBXg Removing an interface that is not in the specification does
not raise an error. Doing so has no effect.rÜ
rÝ }rÞ (hXg Removing an interface that is not in the specification does
not raise an error. Doing so has no effect.rß hFjØ ubahhhhhjß hFjÄ ubh)rà }rá (h%K
h&j¢ h}râ (h]h ]h ]h ]h ]uh ]rã hBXC Removing an interface also removes sub-interfaces of the interface.rä
rå }ræ (hXC Removing an interface also removes sub-interfaces of the interface.rç hFjà ubahhhhhjç hFjÄ ubehj; hhhU hFj§ ubehj< hhhU hFjä ubh)rè }ré (h%Nh&X; docstring of zope.interface.interfaces.IDeclaration.__add__rê h}rë (h]h ]h ]Uentries]rì (hX __add__() (IDeclaration method)X IDeclaration.__add__rí U trî ah ]h ]uh ]hh¡hhhU hFjä ubh¢)rï }rð (h%Nh&jê h}rñ (h]h¦X pyh ]h ]h§X methodrò h©jò hªh ]h ]uh ]ró (h¬)rô }rõ (h%Kh&j h}rö (h]h ]h ]r÷ jí ah²h³j½ h ]rø jí ahµNh ]hºjí uh ]rù (hÏ)rú }rû (h%Kh&j h}rü (h]h ]h ]h ]h ]uh ]rý hBX __add__rþ
rÿ }r (hU hFjú ubahh×hhhX __add__hFjô ubj )r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r j )r }r (h ]r hBX
interfacesr
r }r
(hU hFj ubahj$ hX
interfaceshFj h}r (h]h ]h ]h ]h ]uubahj& hhhU hFjô ubehhðhhhX __add__(interfaces)hFjï ubhñ)r }r
(h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r (h)r }r (h%Kh&jê h}r (h]h ]h ]h ]h ]uh ]r hBX< Create an interface specification with some interfaces addedr
r }r (hX< Create an interface specification with some interfaces addedr hFj ubahhhhhj hFj ubh)r }r (h%Kh&jê h}r (h]h ]h ]h ]h ]uh ]r hBX The argument can be an interface or an interface
specifications. The interface or interfaces given in a
specification are added to the interface specification.r
r }r (hX The argument can be an interface or an interface
specifications. The interface or interfaces given in a
specification are added to the interface specification.r hFj ubahhhhhj hFj ubh)r }r! (h%Kh&jê h}r" (h]h ]h ]h ]h ]uh ]r# hBXi Adding an interface that is already in the specification does
not raise an error. Doing so has no effect.r$
r% }r& (hXi Adding an interface that is already in the specification does
not raise an error. Doing so has no effect.r' hFj ubahhhhhj' hFj ubehj; hhhU hFjï ubehj< hhhU hFjä ubh)r( }r) (h%Nh&X? docstring of zope.interface.interfaces.IDeclaration.__nonzero__r* h}r+ (h]h ]h ]Uentries]r, (hX# __nonzero__() (IDeclaration method)X IDeclaration.__nonzero__r- U tr. ah ]h ]uh ]hh¡hhhU hFjä ubh¢)r/ }r0 (h%Nh&j* h}r1 (h]h¦X pyh ]h ]h§X methodr2 h©j2 hªh ]h ]uh ]r3 (h¬)r4 }r5 (h%Kh&j* h}r6 (h]h ]h ]r7 j- ah²h³j½ h ]r8 j- ahµNh ]hºj- uh ]r9 (hÏ)r: }r; (h%Kh&j* h}r< (h]h ]h ]h ]h ]uh ]r= hBX __nonzero__r>
r? }r@ (hU hFj: ubahh×hhhX __nonzero__hFj4 ubj )rA }rB (h%Kh&j* h}rC (h]h ]h ]h ]h ]uh ]hj& hhhU hFj4 ubehhðhhhX
__nonzero__()rD hFj/ ubhñ)rE }rF (h%Kh&j* h}rG (h]h ]h ]h ]h ]uh ]rH h)rI }rJ (h%Kh&j* h}rK (h]h ]h ]h ]h ]uh ]rL hBX? Return a true value of the interface specification is non-emptyrM
rN }rO (hX? Return a true value of the interface specification is non-emptyrP hFjI ubahhhhhjP hFjE ubahj; hhhU hFj/ ubehj< hhhU hFjä ubehj; hhhU hFj° ubehj< hhhU hFj ubehjý hhhU hFjg jþ Kubh")rQ }rR (h%KÍh&hh}rS (h]rT X usagerU ah ]rV Uid4rW ah ]h ]h ]uh ]rX (h-)rY }rZ (h%KÍh&hh}r[ (h]h ]h ]h ]h ]uh ]r\ hBX Usager]
r^ }r_ (hX Usager` hFjY ubahhRhhhj` hFjQ ubh)ra }rb (h%KÏh&hh}rc (h]h ]h ]h ]h ]uh ]rd (hBX Exmples for re
rf }rg (hX Exmples for hFja ubh2)rh }ri (h%KÏh&hh}rj (h]h6Nh ]h ]U refdomainX pyrk h8NUreftypeX methh9X Declaration.__contains__h:h ]h ]U refexplicith;h<uh ]rl h>)rm }rn (h ]ro hBX Declaration.__contains__()rp
rq }rr (hU hFjm ubahhGhX :meth:`Declaration.__contains__`rs hFjh h}rt (h]h ]h ]h ]h ]ru (hKjk X py-methrv euubahhMhjs hFja ubhBX :
rw }rx (hX :hFja ubehhhhhX- Exmples for :meth:`Declaration.__contains__`:ry hFjQ ubj )rz }r{ (h%KÑh&hh}r| (h]j j h ]h ]U testnodetypeX doctestUgroups]r} j ah ]h ]j }uh ]r~ hBX: >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration(I2, I3)
>>> spec = Declaration(I4, spec)
>>> int(I1 in spec)
0
>>> int(I2 in spec)
1
>>> int(I3 in spec)
1
>>> int(I4 in spec)
1r
r }r (hU hFjz ubahj$ hhhX: >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration(I2, I3)
>>> spec = Declaration(I4, spec)
>>> int(I1 in spec)
0
>>> int(I2 in spec)
1
>>> int(I3 in spec)
1
>>> int(I4 in spec)
1hFjQ ubh)r }r (h%Kçh&hh}r (h]h ]h ]h ]h ]uh ]r
(hBX Exmples for r
r }r (hX Exmples for hFj ubh2)r }r (h%Kçh&hh}r (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX methh9X Declaration.__iter__h:h ]h ]U refexplicith;h<uh ]r h>)r }r (h ]r hBX Declaration.__iter__()r
r }r (hU hFj ubahhGhX :meth:`Declaration.__iter__`r hFj h}r (h]h ]h ]h ]h ]r (hKj X py-methr euubahhMhj hFj ubhBX :
r }r (hX :hFj ubehhhhhX) Exmples for :meth:`Declaration.__iter__`:r hFjQ ubj )r }r (h%Kéh&hh}r (h]j j h ]h ]U testnodetypeX doctestUgroups]r j ah ]h ]j }uh ]r hBX4 >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration(I2, I3)
>>> spec = Declaration(I4, spec)
>>> i = iter(spec)
>>> [x.getName() for x in i]
['I4', 'I2', 'I3']
>>> list(i)
[]r
r¡ }r¢ (hU hFj ubahj$ hhhX4 >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration(I2, I3)
>>> spec = Declaration(I4, spec)
>>> i = iter(spec)
>>> [x.getName() for x in i]
['I4', 'I2', 'I3']
>>> list(i)
[]hFjQ ubh)r£ }r¤ (h%Küh&hh}r¥ (h]h ]h ]h ]h ]uh ]r¦ (hBX Exmples for r§
r¨ }r© (hX Exmples for hFj£ ubh2)rª }r« (h%Küh&hh}r¬ (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX methh9X Declaration.flattenedh:h ]h ]U refexplicith;h<uh ]r® h>)r¯ }r° (h ]r± hBX Declaration.flattened()r²
r³ }r´ (hU hFj¯ ubahhGhX :meth:`Declaration.flattened`rµ hFjª h}r¶ (h]h ]h ]h ]h ]r· (hKj X py-methr¸ euubahhMhjµ hFj£ ubhBX :
r¹ }rº (hX :hFj£ ubehhhhhX* Exmples for :meth:`Declaration.flattened`:r» hFjQ ubj )r¼ }r½ (h%Kþh&hh}r¾ (h]j j h ]h ]U testnodetypeX doctestUgroups]r¿ j ah ]h ]j }uh ]rÀ hBXM >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration(I2, I3)
>>> spec = Declaration(I4, spec)
>>> i = spec.flattened()
>>> [x.getName() for x in i]
['I4', 'I2', 'I1', 'I3', 'Interface']
>>> list(i)
[]rÁ
r }rà (hU hFj¼ ubahj$ hhhXM >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration(I2, I3)
>>> spec = Declaration(I4, spec)
>>> i = spec.flattened()
>>> [x.getName() for x in i]
['I4', 'I2', 'I1', 'I3', 'Interface']
>>> list(i)
[]hFjQ ubh)rÄ }rÅ (h%Mh&hh}rÆ (h]h ]h ]h ]h ]uh ]rÇ (hBX Exmples for rÈ
rÉ }rÊ (hX Exmples for hFjÄ ubh2)rË }rÌ (h%Mh&hh}rÍ (h]h6Nh ]h ]U refdomainX pyrÎ h8NUreftypeX methh9X Declaration.__sub__h:h ]h ]U refexplicith;h<uh ]rÏ h>)rÐ }rÑ (h ]rÒ hBX Declaration.__sub__()rÓ
rÔ }rÕ (hU hFjÐ ubahhGhX :meth:`Declaration.__sub__`rÖ hFjË h}r× (h]h ]h ]h ]h ]rØ (hKjÎ X py-methrÙ euubahhMhjÖ hFjÄ ubhBX :
rÚ }rÛ (hX :hFjÄ ubehhhhhX( Exmples for :meth:`Declaration.__sub__`:rÜ hFjQ ubj )rÝ }rÞ (h%Mh&hh}rß (h]j j h ]h ]U testnodetypeX doctestUgroups]rà j ah ]h ]j }uh ]rá hBXq >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration()
>>> [iface.getName() for iface in spec]
[]
>>> spec -= I1
>>> [iface.getName() for iface in spec]
[]
>>> spec -= Declaration(I1, I2)
>>> [iface.getName() for iface in spec]
[]
>>> spec = Declaration(I2, I4)
>>> [iface.getName() for iface in spec]
['I2', 'I4']
>>> [iface.getName() for iface in spec - I4]
['I2']
>>> [iface.getName() for iface in spec - I1]
['I4']
>>> [iface.getName() for iface
... in spec - Declaration(I3, I4)]
['I2']râ
rã }rä (hU hFjÝ ubahj$ hhhXq >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration()
>>> [iface.getName() for iface in spec]
[]
>>> spec -= I1
>>> [iface.getName() for iface in spec]
[]
>>> spec -= Declaration(I1, I2)
>>> [iface.getName() for iface in spec]
[]
>>> spec = Declaration(I2, I4)
>>> [iface.getName() for iface in spec]
['I2', 'I4']
>>> [iface.getName() for iface in spec - I4]
['I2']
>>> [iface.getName() for iface in spec - I1]
['I4']
>>> [iface.getName() for iface
... in spec - Declaration(I3, I4)]
['I2']hFjQ ubh)rå }ræ (h%M2h&hh}rç (h]h ]h ]h ]h ]uh ]rè (hBX Exmples for ré
rê }rë (hX Exmples for hFjå ubh2)rì }rí (h%M2h&hh}rî (h]h6Nh ]h ]U refdomainX pyrï h8NUreftypeX methh9X Declaration.__add__h:h ]h ]U refexplicith;h<uh ]rð h>)rñ }rò (h ]ró hBX Declaration.__add__()rô
rõ }rö (hU hFjñ ubahhGhX :meth:`Declaration.__add__`r÷ hFjì h}rø (h]h ]h ]h ]h ]rù (hKjï X py-methrú euubahhMhj÷ hFjå ubhBX :
rû }rü (hX :hFjå ubehhhhhX( Exmples for :meth:`Declaration.__add__`:rý hFjQ ubj )rþ }rÿ (h%M4h&hh}r
(h]j j h ]h ]U testnodetypeX doctestUgroups]r
j ah ]h ]j }uh ]r
hBX >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration()
>>> [iface.getName() for iface in spec]
[]
>>> [iface.getName() for iface in spec+I1]
['I1']
>>> [iface.getName() for iface in I1+spec]
['I1']
>>> spec2 = spec
>>> spec += I1
>>> [iface.getName() for iface in spec]
['I1']
>>> [iface.getName() for iface in spec2]
[]
>>> spec2 += Declaration(I3, I4)
>>> [iface.getName() for iface in spec2]
['I3', 'I4']
>>> [iface.getName() for iface in spec+spec2]
['I1', 'I3', 'I4']
>>> [iface.getName() for iface in spec2+spec]
['I3', 'I4', 'I1']r
r
}r
(hU hFjþ ubahj$ hhhX >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> spec = Declaration()
>>> [iface.getName() for iface in spec]
[]
>>> [iface.getName() for iface in spec+I1]
['I1']
>>> [iface.getName() for iface in I1+spec]
['I1']
>>> spec2 = spec
>>> spec += I1
>>> [iface.getName() for iface in spec]
['I1']
>>> [iface.getName() for iface in spec2]
[]
>>> spec2 += Declaration(I3, I4)
>>> [iface.getName() for iface in spec2]
['I3', 'I4']
>>> [iface.getName() for iface in spec+spec2]
['I1', 'I3', 'I4']
>>> [iface.getName() for iface in spec2+spec]
['I3', 'I4', 'I1']hFjQ ubehjý hhhU hFjg jþ Kubehjý hhhU hFh#ubh")r
}r
(h%MVh&hh}r
(h]h ]r
U)zope-interface-declarations-implementedbyr
ah ]h ]r
X+ zope.interface.declarations.implementedby()r
ah ]uh ]r
(h-)r
}r
(h%MVh&hh}r
(h]h ]h ]h ]h ]uh ]r
h2)r
}r
(h%MUh&hh}r
(h]h6Nh ]h ]U refdomainX pyr
h8NUreftypeX funch9X) zope.interface.declarations.implementedByh:h ]h ]U refexplicith;h<uh ]r
h>)r
}r
(h ]r
hBX+ zope.interface.declarations.implementedBy()r
r
}r
(hU hFj
ubahhGhX1 :func:`zope.interface.declarations.implementedBy`r
hFj
h}r
(h]h ]h ]h ]h ]r
(hKj
X py-funcr
euubahhMhj
hFj
ubahhRhhhj
hFj
ubh")r!
}r"
(h%MYh&hh}r#
(h]r$
X apir%
ah ]r&
Uid5r'
ah ]h ]h ]uh ]r(
(h-)r)
}r*
(h%MYh&hh}r+
(h]h ]h ]h ]h ]uh ]r,
hBX APIr-
r.
}r/
(hX APIr0
hFj)
ubahhRhhhj0
hFj!
ubh)r1
}r2
(h%Nh&X± /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.implementedByFallbackr3
h}r4
(h]h ]h ]Uentries]r5
(hX? implementedByFallback() (in module zope.interface.declarations)X1 zope.interface.declarations.implementedByFallbackr6
U tr7
ah ]h ]uh ]hh¡hhhU hFj!
ubh¢)r8
}r9
(h%Nh&j3
h}r:
(h]h¦X pyh ]h ]h§X functionr;
h©j;
hªh ]h ]uh ]r<
(h¬)r=
}r>
(h%Nh&h¯h}r?
(h]h ]h ]r@
j6
ah²h³U h ]rA
j6
ahµh¶X zope.interface.declarationsrB
rC
}rD
bh ]hºX implementedByFallbackrE
uh ]rF
(hÆ)rG
}rH
(h%Nh&h¯h}rI
(h]h ]h ]h ]h ]uh ]rJ
hBX zope.interface.declarations.rK
rL
}rM
(hU hFjG
ubahhÎhhhX zope.interface.declarations.hFj=
ubhÏ)rN
}rO
(h%Nh&h¯h}rP
(h]h ]h ]h ]h ]uh ]rQ
hBX implementedByFallbackrR
rS
}rT
(hU hFjN
ubahh×hhhjE
hFj=
ubj )rU
}rV
(h%Nh&h¯h}rW
(h]h ]h ]h ]h ]uh ]rX
j )rY
}rZ
(h ]r[
hBX clsr\
r]
}r^
(hU hFjY
ubahj$ hX clshFjU
h}r_
(h]h ]h ]h ]h ]uubahj& hhhU hFj=
ubhØ)r`
}ra
(h%Nh&Nh}rb
(h]UexprhÜh ]h ]h ]h ]uh ]rc
h2)rd
}re
(h ]rf
há)rg
}rh
(h ]ri
hBX [source]rj
rk
}rl
(hU hFjg
ubahhèhU hFjd
h}rm
(h]h ]h ]h ]h ]rn
hëauubahhMhU hFj`
h}ro
(h]UrefidjE
h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFj=
ubehhðhhhX implementedByFallback(cls)hFj8
ubhñ)rp
}rq
(h%Nh&h¯h}rr
(h]h ]h ]h ]h ]uh ]rs
(h)rt
}ru
(h%Kh&j3
h}rv
(h]h ]h ]h ]h ]uh ]rw
hBX8 Return the interfaces implemented for a class' instancesrx
ry
}rz
(hX8 Return the interfaces implemented for a class' instancesr{
hFjt
ubahhhhhj{
hFjp
ubh)r|
}r}
(h%Kh&j3
h}r~
(h]h ]h ]h ]h ]uh ]r
hBX& The value returned is an IDeclaration.r
r
}r
(hX& The value returned is an IDeclaration.r
hFj|
ubahhhhhj
hFjp
ubehj; hhhU hFj8
ubehj< hhhU hFj!
ubehjý hhhU hFj
jþ Kubh")r
}r
(h%M_h&hh}r
(h]r
X usager
ah ]r
Uid6r
ah ]h ]h ]uh ]r
(h-)r
}r
(h%M_h&hh}r
(h]h ]h ]h ]h ]uh ]r
hBX Usager
r
}r
(hX Usager
hFj
ubahhRhhhj
hFj
ubh)r
}r
(h%Mah&hh}r
(h]h ]h ]h ]h ]uh ]r
hBX Consider the following example:r
r
}r
(hX Consider the following example:r
hFj
ubahhhhhj
hFj
ubj )r
}r
(h%Mch&hh}r
(h]j j h ]h ]U testnodetypeX doctestUgroups]r
j ah ]h ]j }uh ]r
hBX~ >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class I3(Interface): pass
...
>>> class I4(Interface): pass
...
>>> class A(object):
... implements(I3)
>>> class B(object):
... implements(I4)
>>> class C(A, B):
... pass
>>> classImplementsOnly(C, I1, I2)
>>> [i.getName() for i in implementedBy(C)]
['I1', 'I2']r¡
r¢
}r£
(hU hFj
ubahj$ hhhX~ >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class I3(Interface): pass
...
>>> class I4(Interface): pass
...
>>> class A(object):
... implements(I3)
>>> class B(object):
... implements(I4)
>>> class C(A, B):
... pass
>>> classImplementsOnly(C, I1, I2)
>>> [i.getName() for i in implementedBy(C)]
['I1', 'I2']hFj
ubh)r¤
}r¥
(h%Mxh&hh}r¦
(h]h ]h ]h ]h ]uh ]r§
(hBX
Instances of r¨
r©
}rª
(hX
Instances of hFj¤
ubh>)r«
}r¬
(h ]r
hBX C
r®
}r¯
(hU hFj«
ubahhGhX ``C``hFj¤
h}r°
(h]h ]h ]h ]h ]uubhBX provide only r±
r²
}r³
(hX provide only hFj¤
ubh>)r´
}rµ
(h ]r¶
hBX I1r·
r¸
}r¹
(hU hFj´
ubahhGhX ``I1``hFj¤
h}rº
(h]h ]h ]h ]h ]uubhBX , r»
r¼
}r½
(hX , hFj¤
ubh>)r¾
}r¿
(h ]rÀ
hBX I2rÁ
rÂ
}rÃ
(hU hFj¾
ubahhGhX ``I2``hFj¤
h}rÄ
(h]h ]h ]h ]h ]uubhBX5 , and regardless of
whatever interfaces instances of rÅ
rÆ
}rÇ
(hX5 , and regardless of
whatever interfaces instances of hFj¤
ubh>)rÈ
}rÉ
(h ]rÊ
hBX A
rË
}rÌ
(hU hFjÈ
ubahhGhX ``A``hFj¤
h}rÍ
(h]h ]h ]h ]h ]uubhBX and rÎ
rÏ
}rÐ
(hX and hFj¤
ubh>)rÑ
}rÒ
(h ]rÓ
hBX B
rÔ
}rÕ
(hU hFjÑ
ubahhGhX ``B``hFj¤
h}rÖ
(h]h ]h ]h ]h ]uubhBX implement.r×
rØ
}rÙ
(hX implement.hFj¤
ubehhhhhX} Instances of ``C`` provide only ``I1``, ``I2``, and regardless of
whatever interfaces instances of ``A`` and ``B`` implement.hFj
ubh)rÚ
}rÛ
(h%M{h&hh}rÜ
(h]h ]h ]h ]h ]uh ]rÝ
hBX Another example:rÞ
rß
}rà
(hX Another example:rá
hFjÚ
ubahhhhhjá
hFj
ubj )râ
}rã
(h%M}h&hh}rä
(h]j j h ]h ]U testnodetypeX doctestUgroups]rå
j ah ]h ]j }uh ]ræ
hBX. >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> class C1(object):
... implements(I2)
>>> class C2(C1):
... implements(I3)
>>> [i.getName() for i in implementedBy(C2)]
['I3', 'I2']rç
rè
}ré
(hU hFjâ
ubahj$ hhhX. >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(I1): pass
...
>>> class I3(Interface): pass
...
>>> class I4(I3): pass
...
>>> class C1(object):
... implements(I2)
>>> class C2(C1):
... implements(I3)
>>> [i.getName() for i in implementedBy(C2)]
['I3', 'I2']hFj
ubh)rê
}rë
(h%Mh&hh}rì
(h]h ]h ]h ]h ]uh ]rí
hBXS Really, any object should be able to receive a successful answer, even
an instance:rî
rï
}rð
(hXS Really, any object should be able to receive a successful answer, even
an instance:rñ
hFjê
ubahhhhhjñ
hFj
ubj )rò
}ró
(h%Mh&hh}rô
(h]j j h ]h ]U testnodetypeX doctestUgroups]rõ
j ah ]h ]j }uh ]rö
hBX >>> class Callable(object):
... def __call__(self):
... return self
>>> implementedBy(Callable())
<implementedBy __builtin__.?>r÷
rø
}rù
(hU hFjò
ubahj$ hhhX >>> class Callable(object):
... def __call__(self):
... return self
>>> implementedBy(Callable())
<implementedBy __builtin__.?>hFj
ubh)rú
}rû
(h%Mh&hh}rü
(h]h ]h ]h ]h ]uh ]rý
(hBX< Note that the name of the spec ends with a '?', because the rþ
rÿ
}r (hX< Note that the name of the spec ends with a '?', because the hFjú
ubcdocutils.nodes
title_reference
r )r }r (h ]r hBX Callabler
r }r (hU hFj ubahUtitle_referencer hX
`Callable`hFjú
h}r (h]h ]h ]h ]h ]uubhBX
instance does not have a r
r }r (hX
instance does not have a hFjú
ubj )r
}r (h ]r hBX __name__r
r }r (hU hFj
ubahj hX
`__name__`hFjú
h}r (h]h ]h ]h ]h ]uubhBX attribute.r
r }r (hX attribute.hFjú
ubehhhhhXu Note that the name of the spec ends with a '?', because the `Callable`
instance does not have a `__name__` attribute.hFj
ubh)r }r (h%Mh&hh}r (h]h ]h ]h ]h ]uh ]r hBX: This also manages storage of implementation specificationsr
r }r (hX: This also manages storage of implementation specificationsr hFj ubahhhhhj hFj
ubehjý hhhU hFj
jþ Kubehjý hhhU hFh#ubh")r }r (h%M¡h&hh}r! (h]h ]r" U/zope-interface-declarations-classimplementsonlyr# ah ]h ]r$ X1 zope.interface.declarations.classimplementsonly()r% ah ]uh ]r& (h-)r' }r( (h%M¡h&hh}r) (h]h ]h ]h ]h ]uh ]r* h2)r+ }r, (h%M h&hh}r- (h]h6Nh ]h ]U refdomainX pyr. h8NUreftypeX funch9X/ zope.interface.declarations.classImplementsOnlyh:h ]h ]U refexplicith;h<uh ]r/ h>)r0 }r1 (h ]r2 hBX1 zope.interface.declarations.classImplementsOnly()r3
r4 }r5 (hU hFj0 ubahhGhX7 :func:`zope.interface.declarations.classImplementsOnly`r6 hFj+ h}r7 (h]h ]h ]h ]h ]r8 (hKj. X py-funcr9 euubahhMhj6 hFj' ubahhRhhhj6 hFj ubh")r: }r; (h%M¤h&hh}r< (h]r= X apir> ah ]r? Uid7r@ ah ]h ]h ]uh ]rA (h-)rB }rC (h%M¤h&hh}rD (h]h ]h ]h ]h ]uh ]rE hBX APIrF
rG }rH (hX APIrI hFjB ubahhRhhhjI hFj: ubh)rJ }rK (h%Nh&X¯ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.classImplementsOnlyrL h}rM (h]h ]h ]Uentries]rN (hX= classImplementsOnly() (in module zope.interface.declarations)X/ zope.interface.declarations.classImplementsOnlyrO U trP ah ]h ]uh ]hh¡hhhU hFj: ubh¢)rQ }rR (h%Nh&jL h}rS (h]h¦X pyh ]h ]h§X functionrT h©jT hªh ]h ]uh ]rU (h¬)rV }rW (h%Nh&h¯h}rX (h]h ]h ]rY jO ah²h³U h ]rZ jO ahµh¶X zope.interface.declarationsr[
r\ }r] bh ]hºX classImplementsOnlyr^ uh ]r_ (hÆ)r` }ra (h%Nh&h¯h}rb (h]h ]h ]h ]h ]uh ]rc hBX zope.interface.declarations.rd
re }rf (hU hFj` ubahhÎhhhX zope.interface.declarations.hFjV ubhÏ)rg }rh (h%Nh&h¯h}ri (h]h ]h ]h ]h ]uh ]rj hBX classImplementsOnlyrk
rl }rm (hU hFjg ubahh×hhhj^ hFjV ubj )rn }ro (h%Nh&h¯h}rp (h]h ]h ]h ]h ]uh ]rq (j )rr }rs (h ]rt hBX clsru
rv }rw (hU hFjr ubahj$ hX clshFjn h}rx (h]h ]h ]h ]h ]uubj )ry }rz (h ]r{ hBX *interfacesr|
r} }r~ (hU hFjy ubahj$ hX *interfaceshFjn h}r (h]h ]h ]h ]h ]uubehj& hhhU hFjV ubhØ)r }r (h%Nh&Nh}r (h]UexprhÜh ]h ]h ]h ]uh ]r h2)r }r
(h ]r há)r }r (h ]r hBX [source]r
r }r (hU hFj ubahhèhU hFj h}r (h]h ]h ]h ]h ]r hëauubahhMhU hFj h}r (h]Urefidj^ h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFjV ubehhðhhhX% classImplementsOnly(cls, *interfaces)hFjQ ubhñ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r (h)r }r (h%Kh&jL h}r (h]h ]h ]h ]h ]uh ]r hBX? Declare the only interfaces implemented by instances of a classr
r }r (hX? Declare the only interfaces implemented by instances of a classr hFj ubahhhhhj hFj ubh)r }r (h%Kh&jL h}r (h]h ]h ]h ]h ]uh ]r (hBXV The arguments after the class are one or more interfaces or interface
specifications (r
r¡ }r¢ (hXV The arguments after the class are one or more interfaces or interface
specifications (hFj ubh>)r£ }r¤ (h ]r¥ hBX IDeclarationr¦
r§ }r¨ (hU hFj£ ubahhGhX ``IDeclaration``hFj h}r© (h]h ]h ]h ]h ]uubhBX
objects).rª
r« }r¬ (hX
objects).hFj ubehhhhhXp The arguments after the class are one or more interfaces or interface
specifications (``IDeclaration`` objects).hFj ubh)r }r® (h%Kh&jL h}r¯ (h]h ]h ]h ]h ]uh ]r° hBXh The interfaces given (including the interfaces in the specifications)
replace any previous declarations.r±
r² }r³ (hXh The interfaces given (including the interfaces in the specifications)
replace any previous declarations.r´ hFj ubahhhhhj´ hFj ubehj; hhhU hFjQ ubehj< hhhU hFj: ubehjý hhhU hFj jþ Kubh")rµ }r¶ (h%Mªh&hh}r· (h]r¸ X usager¹ ah ]rº Uid8r» ah ]h ]h ]uh ]r¼ (h-)r½ }r¾ (h%Mªh&hh}r¿ (h]h ]h ]h ]h ]uh ]rÀ hBX UsagerÁ
r }rà (hX UsagerÄ hFj½ ubahhRhhhjÄ hFjµ ubh)rÅ }rÆ (h%M¬h&hh}rÇ (h]h ]h ]h ]h ]uh ]rÈ hBX Consider the following example:rÉ
rÊ }rË (hX Consider the following example:rÌ hFjÅ ubahhhhhjÌ hFjµ ubj )rÍ }rÎ (h%M®h&hh}rÏ (h]j j h ]h ]U testnodetypeX doctestUgroups]rÐ j ah ]h ]j }uh ]rÑ hBX~ >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class I3(Interface): pass
...
>>> class I4(Interface): pass
...
>>> class A(object):
... implements(I3)
>>> class B(object):
... implements(I4)
>>> class C(A, B):
... pass
>>> classImplementsOnly(C, I1, I2)
>>> [i.getName() for i in implementedBy(C)]
['I1', 'I2']rÒ
rÓ }rÔ (hU hFjÍ ubahj$ hhhX~ >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class I3(Interface): pass
...
>>> class I4(Interface): pass
...
>>> class A(object):
... implements(I3)
>>> class B(object):
... implements(I4)
>>> class C(A, B):
... pass
>>> classImplementsOnly(C, I1, I2)
>>> [i.getName() for i in implementedBy(C)]
['I1', 'I2']hFjµ ubh)rÕ }rÖ (h%MÃh&hh}r× (h]h ]h ]h ]h ]uh ]rØ (hBX
Instances of rÙ
rÚ }rÛ (hX
Instances of hFjÕ ubh>)rÜ }rÝ (h ]rÞ hBX C
rß }rà (hU hFjÜ ubahhGhX ``C``hFjÕ h}rá (h]h ]h ]h ]h ]uubhBX provide only râ
rã }rä (hX provide only hFjÕ ubh>)rå }ræ (h ]rç hBX I1rè
ré }rê (hU hFjå ubahhGhX ``I1``hFjÕ h}rë (h]h ]h ]h ]h ]uubhBX , rì
rí }rî (hX , hFjÕ ubh>)rï }rð (h ]rñ hBX I2rò
ró }rô (hU hFjï ubahhGhX ``I2``hFjÕ h}rõ (h]h ]h ]h ]h ]uubhBX5 , and regardless of
whatever interfaces instances of rö
r÷ }rø (hX5 , and regardless of
whatever interfaces instances of hFjÕ ubh>)rù }rú (h ]rû hBX A
rü }rý (hU hFjù ubahhGhX ``A``hFjÕ h}rþ (h]h ]h ]h ]h ]uubhBX and rÿ
r }r (hX and hFjÕ ubh>)r }r (h ]r hBX B
r }r (hU hFj ubahhGhX ``B``hFjÕ h}r (h]h ]h ]h ]h ]uubhBX implement.r
r }r
(hX implement.hFjÕ ubehhhhhX} Instances of ``C`` provide only ``I1``, ``I2``, and regardless of
whatever interfaces instances of ``A`` and ``B`` implement.hFjµ ubehjý hhhU hFj jþ Kubehjý hhhU hFh#ubh")r }r (h%MÈh&hh}r
(h]h ]r U+zope-interface-declarations-classimplementsr ah ]h ]r X- zope.interface.declarations.classimplements()r ah ]uh ]r (h-)r }r (h%MÈh&hh}r (h]h ]h ]h ]h ]uh ]r h2)r }r (h%MÇh&hh}r (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX funch9X+ zope.interface.declarations.classImplementsh:h ]h ]U refexplicith;h<uh ]r h>)r }r (h ]r hBX- zope.interface.declarations.classImplements()r
r }r! (hU hFj ubahhGhX3 :func:`zope.interface.declarations.classImplements`r" hFj h}r# (h]h ]h ]h ]h ]r$ (hKj X py-funcr% euubahhMhj" hFj ubahhRhhhj" hFj ubh")r& }r' (h%MËh&hh}r( (h]r) X apir* ah ]r+ Uid9r, ah ]h ]h ]uh ]r- (h-)r. }r/ (h%MËh&hh}r0 (h]h ]h ]h ]h ]uh ]r1 hBX APIr2
r3 }r4 (hX APIr5 hFj. ubahhRhhhj5 hFj& ubh)r6 }r7 (h%Nh&X« /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.classImplementsr8 h}r9 (h]h ]h ]Uentries]r: (hX9 classImplements() (in module zope.interface.declarations)X+ zope.interface.declarations.classImplementsr; U tr< ah ]h ]uh ]hh¡hhhU hFj& ubh¢)r= }r> (h%Nh&j8 h}r? (h]h¦X pyh ]h ]h§X functionr@ h©j@ hªh ]h ]uh ]rA (h¬)rB }rC (h%Nh&h¯h}rD (h]h ]h ]rE j; ah²h³U h ]rF j; ahµh¶X zope.interface.declarationsrG
rH }rI bh ]hºX classImplementsrJ uh ]rK (hÆ)rL }rM (h%Nh&h¯h}rN (h]h ]h ]h ]h ]uh ]rO hBX zope.interface.declarations.rP
rQ }rR (hU hFjL ubahhÎhhhX zope.interface.declarations.hFjB ubhÏ)rS }rT (h%Nh&h¯h}rU (h]h ]h ]h ]h ]uh ]rV hBX classImplementsrW
rX }rY (hU hFjS ubahh×hhhjJ hFjB ubj )rZ }r[ (h%Nh&h¯h}r\ (h]h ]h ]h ]h ]uh ]r] (j )r^ }r_ (h ]r` hBX clsra
rb }rc (hU hFj^ ubahj$ hX clshFjZ h}rd (h]h ]h ]h ]h ]uubj )re }rf (h ]rg hBX *interfacesrh
ri }rj (hU hFje ubahj$ hX *interfaceshFjZ h}rk (h]h ]h ]h ]h ]uubehj& hhhU hFjB ubhØ)rl }rm (h%Nh&Nh}rn (h]UexprhÜh ]h ]h ]h ]uh ]ro h2)rp }rq (h ]rr há)rs }rt (h ]ru hBX [source]rv
rw }rx (hU hFjs ubahhèhU hFjp h}ry (h]h ]h ]h ]h ]rz hëauubahhMhU hFjl h}r{ (h]UrefidjJ h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFjB ubehhðhhhX! classImplements(cls, *interfaces)hFj= ubhñ)r| }r} (h%Nh&h¯h}r~ (h]h ]h ]h ]h ]uh ]r (h)r }r (h%Kh&j8 h}r (h]h ]h ]h ]h ]uh ]r hBXB Declare additional interfaces implemented for instances of a classr
r
}r (hXB Declare additional interfaces implemented for instances of a classr hFj ubahhhhhj hFj| ubh)r }r (h%Kh&j8 h}r (h]h ]h ]h ]h ]uh ]r (hBXV The arguments after the class are one or more interfaces or
interface specifications (r
r }r (hXV The arguments after the class are one or more interfaces or
interface specifications (hFj ubh>)r }r (h ]r hBX IDeclarationr
r }r (hU hFj ubahhGhX ``IDeclaration``hFj h}r (h]h ]h ]h ]h ]uubhBX
objects).r
r }r (hX
objects).hFj ubehhhhhXp The arguments after the class are one or more interfaces or
interface specifications (``IDeclaration`` objects).hFj| ubh)r }r (h%Kh&j8 h}r (h]h ]h ]h ]h ]uh ]r hBXv The interfaces given (including the interfaces in the specifications)
are added to any interfaces previously declared.r
r }r (hXv The interfaces given (including the interfaces in the specifications)
are added to any interfaces previously declared.r hFj ubahhhhhj hFj| ubehj; hhhU hFj= ubehj< hhhU hFj& ubehjý hhhU hFj jþ Kubh")r¡ }r¢ (h%MÑh&hh}r£ (h]r¤ X usager¥ ah ]r¦ Uid10r§ ah ]h ]h ]uh ]r¨ (h-)r© }rª (h%MÑh&hh}r« (h]h ]h ]h ]h ]uh ]r¬ hBX Usager
r® }r¯ (hX Usager° hFj© ubahhRhhhj° hFj¡ ubh)r± }r² (h%MÓh&hh}r³ (h]h ]h ]h ]h ]uh ]r´ hBX Consider the following example:rµ
r¶ }r· (hX Consider the following example:r¸ hFj± ubahhhhhj¸ hFj¡ ubj )r¹ }rº (h%MÕh&hh}r» (h]j j h ]h ]U testnodetypeX doctestUgroups]r¼ j ah ]h ]j }uh ]r½ hBX >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class I3(Interface): pass
...
>>> class I4(Interface): pass
...
>>> class I5(Interface): pass
...
>>> class A(object):
... implements(I3)
>>> class B(object):
... implements(I4)
>>> class C(A, B):
... pass
>>> classImplements(C, I1, I2)
>>> [i.getName() for i in implementedBy(C)]
['I1', 'I2', 'I3', 'I4']
>>> classImplements(C, I5)
>>> [i.getName() for i in implementedBy(C)]
['I1', 'I2', 'I5', 'I3', 'I4']r¾
r¿ }rÀ (hU hFj¹ ubahj$ hhhX >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class I3(Interface): pass
...
>>> class I4(Interface): pass
...
>>> class I5(Interface): pass
...
>>> class A(object):
... implements(I3)
>>> class B(object):
... implements(I4)
>>> class C(A, B):
... pass
>>> classImplements(C, I1, I2)
>>> [i.getName() for i in implementedBy(C)]
['I1', 'I2', 'I3', 'I4']
>>> classImplements(C, I5)
>>> [i.getName() for i in implementedBy(C)]
['I1', 'I2', 'I5', 'I3', 'I4']hFj¡ ubh)rÁ }r (h%Mïh&hh}rà (h]h ]h ]h ]h ]uh ]rÄ (hBX
Instances of rÅ
rÆ }rÇ (hX
Instances of hFjÁ ubh>)rÈ }rÉ (h ]rÊ hBX C
rË }rÌ (hU hFjÈ ubahhGhX ``C``hFjÁ h}rÍ (h]h ]h ]h ]h ]uubhBX provide rÎ
rÏ }rÐ (hX provide hFjÁ ubh>)rÑ }rÒ (h ]rÓ hBX I1rÔ
rÕ }rÖ (hU hFjÑ ubahhGhX ``I1``hFjÁ h}r× (h]h ]h ]h ]h ]uubhBX , rØ
rÙ }rÚ (hX , hFjÁ ubh>)rÛ }rÜ (h ]rÝ hBX I2rÞ
rß }rà (hU hFjÛ ubahhGhX ``I2``hFjÁ h}rá (h]h ]h ]h ]h ]uubhBX , râ
rã }rä (hX , hFjÁ ubh>)rå }ræ (h ]rç hBX I5rè
ré }rê (hU hFjå ubahhGhX ``I5``hFjÁ h}rë (h]h ]h ]h ]h ]uubhBX' , and whatever
interfaces instances of rì
rí }rî (hX' , and whatever
interfaces instances of hFjÁ ubh>)rï }rð (h ]rñ hBX A
rò }ró (hU hFjï ubahhGhX ``A``hFjÁ h}rô (h]h ]h ]h ]h ]uubhBX and rõ
rö }r÷ (hX and hFjÁ ubh>)rø }rù (h ]rú hBX B
rû }rü (hU hFjø ubahhGhX ``B``hFjÁ h}rý (h]h ]h ]h ]h ]uubhBX provide.rþ
rÿ }r
(hX provide.hFjÁ ubehhhhhXp Instances of ``C`` provide ``I1``, ``I2``, ``I5``, and whatever
interfaces instances of ``A`` and ``B`` provide.hFj¡ ubehjý hhhU hFj jþ Kubehjý hhhU hFh#ubh")r
}r
(h%Môh&hh}r
(h]r
X' zope.interface.declarations.implementerr
ah ]r
U'zope-interface-declarations-implementerr
ah ]h ]h ]uh ]r
(h-)r
}r
(h%Môh&hh}r
(h]h ]h ]h ]h ]uh ]r
h2)r
}r
(h%Móh&hh}r
(h]h6Nh ]h ]U refdomainX pyr
h8NUreftypeX classh9X' zope.interface.declarations.implementerh:h ]h ]U refexplicith;h<uh ]r
h>)r
}r
(h ]r
hBX' zope.interface.declarations.implementerr
r
}r
(hU hFj
ubahhGhX0 :class:`zope.interface.declarations.implementer`r
hFj
h}r
(h]h ]h ]h ]h ]r
(hKj
X py-classr
euubahhMhj
hFj
ubahhRhhhj
hFj
ubh")r
}r
(h%M÷h&hh}r
(h]r
X apir
ah ]r!
Uid11r"
ah ]h ]h ]uh ]r#
(h-)r$
}r%
(h%M÷h&hh}r&
(h]h ]h ]h ]h ]uh ]r'
hBX APIr(
r)
}r*
(hX APIr+
hFj$
ubahhRhhhj+
hFj
ubh)r,
}r-
(h%Nh&X§ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.implementerr.
h}r/
(h]h ]h ]Uentries]r0
(hX2 implementer (class in zope.interface.declarations)j
U tr1
ah ]h ]uh ]hh¡hhhU hFj
ubh¢)r2
}r3
(h%Nh&j.
h}r4
(h]h¦X pyh ]h ]h§X classr5
h©j5
hªh ]h ]uh ]r6
(h¬)r7
}r8
(h%Nh&h¯h}r9
(h]h ]h ]r:
j
ah²h³U h ]r;
j
ahµh¶X zope.interface.declarationsr<
r=
}r>
bh ]hºX implementerr?
uh ]r@
(h½)rA
}rB
(h%Nh&h¯h}rC
(h]h ]h ]h ]h ]uh ]rD
hBX class rE
rF
}rG
(hU hFjA
ubahhÅhhhX class hFj7
ubhÆ)rH
}rI
(h%Nh&h¯h}rJ
(h]h ]h ]h ]h ]uh ]rK
hBX zope.interface.declarations.rL
rM
}rN
(hU hFjH
ubahhÎhhhX zope.interface.declarations.hFj7
ubhÏ)rO
}rP
(h%Nh&h¯h}rQ
(h]h ]h ]h ]h ]uh ]rR
hBX implementerrS
rT
}rU
(hU hFjO
ubahh×hhhj?
hFj7
ubj )rV
}rW
(h%Nh&h¯h}rX
(h]h ]h ]h ]h ]uh ]rY
j )rZ
}r[
(h ]r\
hBX *interfacesr]
r^
}r_
(hU hFjZ
ubahj$ hX *interfaceshFjV
h}r`
(h]h ]h ]h ]h ]uubahj& hhhU hFj7
ubhØ)ra
}rb
(h%Nh&Nh}rc
(h]UexprhÜh ]h ]h ]h ]uh ]rd
h2)re
}rf
(h ]rg
há)rh
}ri
(h ]rj
hBX [source]rk
rl
}rm
(hU hFjh
ubahhèhU hFje
h}rn
(h]h ]h ]h ]h ]ro
hëauubahhMhU hFja
h}rp
(h]Urefidj?
h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFj7
ubehhðhhhX implementer(*interfaces)hFj2
ubhñ)rq
}rr
(h%Nh&h¯h}rs
(h]h ]h ]h ]h ]uh ]rt
(h)ru
}rv
(h%Kh&j.
h}rw
(h]h ]h ]h ]h ]uh ]rx
hBX; Declare the interfaces implemented by instances of a class.ry
rz
}r{
(hX; Declare the interfaces implemented by instances of a class.r|
hFju
ubahhhhhj|
hFjq
ubh)r}
}r~
(h%Kh&j.
h}r
(h]h ]h ]h ]h ]uh ]r
hBX- This function is called as a class decorator.r
r
}r
(hX- This function is called as a class decorator.r
hFj}
ubahhhhhj
hFjq
ubh)r
}r
(h%Kh&j.
h}r
(h]h ]h ]h ]h ]uh ]r
hBX\ The arguments are one or more interfaces or interface
specifications (IDeclaration objects).r
r
}r
(hX\ The arguments are one or more interfaces or interface
specifications (IDeclaration objects).r
hFj
ubahhhhhj
hFjq
ubh)r
}r
(h%Kh&j.
h}r
(h]h ]h ]h ]h ]uh ]r
hBXv The interfaces given (including the interfaces in the
specifications) are added to any interfaces previously
declared.r
r
}r
(hXv The interfaces given (including the interfaces in the
specifications) are added to any interfaces previously
declared.r
hFj
ubahhhhhj
hFjq
ubh)r
}r
(h%K h&j.
h}r
(h]h ]h ]h ]h ]uh ]r
hBX[ Previous declarations include declarations for base classes
unless implementsOnly was used.r
r
}r
(hX[ Previous declarations include declarations for base classes
unless implementsOnly was used.r
hFj
ubahhhhhj
hFjq
ubh)r
}r
(h%Kh&j.
h}r
(h]h ]h ]h ]h ]uh ]r
hBXr This function is provided for convenience. It provides a more
convenient way to call classImplements. For example:r¡
r¢
}r£
(hXr This function is provided for convenience. It provides a more
convenient way to call classImplements. For example:hFj
ubahhhhhXs This function is provided for convenience. It provides a more
convenient way to call classImplements. For example::hFjq
ubj )r¤
}r¥
(h%Kh&j.
h}r¦
(h]h ]h ]j j h ]h ]uh ]r§
hBX* @implementer(I1)
class C(object):
passr¨
r©
}rª
(hU hFj¤
ubahj$ hhhX* @implementer(I1)
class C(object):
passhFjq
ubh)r«
}r¬
(h%Kh&j.
h}r
(h]h ]h ]h ]h ]uh ]r®
hBX is equivalent to calling:r¯
r°
}r±
(hX is equivalent to calling:hFj«
ubahhhhhX is equivalent to calling::hFjq
ubj )r²
}r³
(h%K h&j.
h}r´
(h]h ]h ]j j h ]h ]uh ]rµ
hBX classImplements(C, I1)r¶
r·
}r¸
(hU hFj²
ubahj$ hhhX classImplements(C, I1)hFjq
ubh)r¹
}rº
(h%Kh&j.
h}r»
(h]h ]h ]h ]h ]uh ]r¼
hBX! after the class has been created.r½
r¾
}r¿
(hX! after the class has been created.rÀ
hFj¹
ubahhhhhjÀ
hFjq
ubehj; hhhU hFj2
ubehj< hhhU hFj
ubehjý hhhU hFj
jþ Kubehjý hhhU hFh#jþ Kubh")rÁ
}rÂ
(h%Mÿh&hh}rÃ
(h]rÄ
X, zope.interface.declarations.implementer_onlyrÅ
ah ]rÆ
U,zope-interface-declarations-implementer-onlyrÇ
ah ]h ]h ]uh ]rÈ
(h-)rÉ
}rÊ
(h%Mÿh&hh}rË
(h]h ]h ]h ]h ]uh ]rÌ
h2)rÍ
}rÎ
(h%Mþh&hh}rÏ
(h]h6Nh ]h ]U refdomainX pyrÐ
h8NUreftypeX classh9X, zope.interface.declarations.implementer_onlyh:h ]h ]U refexplicith;h<uh ]rÑ
h>)rÒ
}rÓ
(h ]rÔ
hBX, zope.interface.declarations.implementer_onlyrÕ
rÖ
}r×
(hU hFjÒ
ubahhGhX5 :class:`zope.interface.declarations.implementer_only`rØ
hFjÍ
h}rÙ
(h]h ]h ]h ]h ]rÚ
(hKjÐ
X py-classrÛ
euubahhMhjØ
hFjÉ
ubahhRhhhjØ
hFjÁ
ubh")rÜ
}rÝ
(h%Mh&hh}rÞ
(h]rß
X apirà
ah ]rá
Uid12râ
ah ]h ]h ]uh ]rã
(h-)rä
}rå
(h%Mh&hh}ræ
(h]h ]h ]h ]h ]uh ]rç
hBX APIrè
ré
}rê
(hX APIrë
hFjä
ubahhRhhhjë
hFjÜ
ubh)rì
}rí
(h%Nh&X¬ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.implementer_onlyrî
h}rï
(h]h ]h ]Uentries]rð
(hX7 implementer_only (class in zope.interface.declarations)jÅ
U trñ
ah ]h ]uh ]hh¡hhhU hFjÜ
ubh¢)rò
}ró
(h%Nh&jî
h}rô
(h]h¦X pyh ]h ]h§X classrõ
h©jõ
hªh ]h ]uh ]rö
(h¬)r÷
}rø
(h%Nh&h¯h}rù
(h]h ]h ]rú
jÅ
ah²h³U h ]rû
jÅ
ahµh¶X zope.interface.declarationsrü
rý
}rþ
bh ]hºX implementer_onlyrÿ
uh ]r (h½)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX class r
r }r (hU hFj ubahhÅhhhX class hFj÷
ubhÆ)r }r (h%Nh&h¯h}r
(h]h ]h ]h ]h ]uh ]r hBX zope.interface.declarations.r
r
}r (hU hFj ubahhÎhhhX zope.interface.declarations.hFj÷
ubhÏ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX implementer_onlyr
r }r (hU hFj ubahh×hhhjÿ
hFj÷
ubj )r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r j )r }r (h ]r hBX *interfacesr
r }r (hU hFj ubahj$ hX *interfaceshFj h}r (h]h ]h ]h ]h ]uubahj& hhhU hFj÷
ubhØ)r! }r" (h%Nh&Nh}r# (h]UexprhÜh ]h ]h ]h ]uh ]r$ h2)r% }r& (h ]r' há)r( }r) (h ]r* hBX [source]r+
r, }r- (hU hFj( ubahhèhU hFj% h}r. (h]h ]h ]h ]h ]r/ hëauubahhMhU hFj! h}r0 (h]Urefidjÿ
h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFj÷
ubehhðhhhX implementer_only(*interfaces)hFjò
ubhñ)r1 }r2 (h%Nh&h¯h}r3 (h]h ]h ]h ]h ]uh ]r4 (h)r5 }r6 (h%Kh&jî
h}r7 (h]h ]h ]h ]h ]uh ]r8 hBX? Declare the only interfaces implemented by instances of a classr9
r: }r; (hX? Declare the only interfaces implemented by instances of a classr< hFj5 ubahhhhhj< hFj1 ubh)r= }r> (h%Kh&jî
h}r? (h]h ]h ]h ]h ]uh ]r@ hBX- This function is called as a class decorator.rA
rB }rC (hX- This function is called as a class decorator.rD hFj= ubahhhhhjD hFj1 ubh)rE }rF (h%Kh&jî
h}rG (h]h ]h ]h ]h ]uh ]rH hBX\ The arguments are one or more interfaces or interface
specifications (IDeclaration objects).rI
rJ }rK (hX\ The arguments are one or more interfaces or interface
specifications (IDeclaration objects).rL hFjE ubahhhhhjL hFj1 ubh)rM }rN (h%Kh&jî
h}rO (h]h ]h ]h ]h ]uh ]rP hBXM Previous declarations including declarations for base classes
are overridden.rQ
rR }rS (hXM Previous declarations including declarations for base classes
are overridden.rT hFjM ubahhhhhjT hFj1 ubh)rU }rV (h%K h&jî
h}rW (h]h ]h ]h ]h ]uh ]rX hBXv This function is provided for convenience. It provides a more
convenient way to call classImplementsOnly. For example:rY
rZ }r[ (hXv This function is provided for convenience. It provides a more
convenient way to call classImplementsOnly. For example:hFjU ubahhhhhXw This function is provided for convenience. It provides a more
convenient way to call classImplementsOnly. For example::hFj1 ubj )r\ }r] (h%Kh&jî
h}r^ (h]h ]h ]j j h ]h ]uh ]r_ hBX+ @implementer_only(I1)
class C(object): passr`
ra }rb (hU hFj\ ubahj$ hhhX+ @implementer_only(I1)
class C(object): passhFj1 ubh)rc }rd (h%Kh&jî
h}re (h]h ]h ]h ]h ]uh ]rf hBX is equivalent to calling:rg
rh }ri (hX is equivalent to calling:hFjc ubahhhhhX is equivalent to calling::hFj1 ubj )rj }rk (h%Kh&jî
h}rl (h]h ]h ]j j h ]h ]uh ]rm hBX classImplementsOnly(I1)rn
ro }rp (hU hFjj ubahj$ hhhX classImplementsOnly(I1)hFj1 ubh)rq }rr (h%Kh&jî
h}rs (h]h ]h ]h ]h ]uh ]rt hBX! after the class has been created.ru
rv }rw (hX! after the class has been created.rx hFjq ubahhhhhjx hFj1 ubehj; hhhU hFjò
ubehj< hhhU hFjÜ
ubehjý hhhU hFjÁ
jþ Kubehjý hhhU hFh#jþ Kubh")ry }rz (h%M
h&hh}r{ (h]h ]r| U&zope-interface-declarations-implementsr} ah ]h ]r~ X( zope.interface.declarations.implements()r ah ]uh ]r (h-)r }r (h%M
h&hh}r (h]h ]h ]h ]h ]uh ]r h2)r
}r (h%M h&hh}r (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX funch9X& zope.interface.declarations.implementsh:h ]h ]U refexplicith;h<uh ]r h>)r }r (h ]r hBX( zope.interface.declarations.implements()r
r }r (hU hFj ubahhGhX. :func:`zope.interface.declarations.implements`r hFj
h}r (h]h ]h ]h ]h ]r (hKj X py-funcr euubahhMhj hFj ubahhRhhhj hFjy ubh")r }r (h%M
h&hh}r (h]r X apir ah ]r Uid13r ah ]h ]h ]uh ]r (h-)r }r (h%M
h&hh}r (h]h ]h ]h ]h ]uh ]r hBX APIr
r¡ }r¢ (hX APIr£ hFj ubahhRhhhj£ hFj ubh)r¤ }r¥ (h%Nh&X¦ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.implementsr¦ h}r§ (h]h ]h ]Uentries]r¨ (hX4 implements() (in module zope.interface.declarations)X& zope.interface.declarations.implementsr© U trª ah ]h ]uh ]hh¡hhhU hFj ubh¢)r« }r¬ (h%Nh&j¦ h}r (h]h¦X pyh ]h ]h§X functionr® h©j® hªh ]h ]uh ]r¯ (h¬)r° }r± (h%Nh&h¯h}r² (h]h ]h ]r³ j© ah²h³U h ]r´ j© ahµh¶X zope.interface.declarationsrµ
r¶ }r· bh ]hºX
implementsr¸ uh ]r¹ (hÆ)rº }r» (h%Nh&h¯h}r¼ (h]h ]h ]h ]h ]uh ]r½ hBX zope.interface.declarations.r¾
r¿ }rÀ (hU hFjº ubahhÎhhhX zope.interface.declarations.hFj° ubhÏ)rÁ }r (h%Nh&h¯h}rà (h]h ]h ]h ]h ]uh ]rÄ hBX
implementsrÅ
rÆ }rÇ (hU hFjÁ ubahh×hhhj¸ hFj° ubj )rÈ }rÉ (h%Nh&h¯h}rÊ (h]h ]h ]h ]h ]uh ]rË j )rÌ }rÍ (h ]rÎ hBX *interfacesrÏ
rÐ }rÑ (hU hFjÌ ubahj$ hX *interfaceshFjÈ h}rÒ (h]h ]h ]h ]h ]uubahj& hhhU hFj° ubhØ)rÓ }rÔ (h%Nh&Nh}rÕ (h]UexprhÜh ]h ]h ]h ]uh ]rÖ h2)r× }rØ (h ]rÙ há)rÚ }rÛ (h ]rÜ hBX [source]rÝ
rÞ }rß (hU hFjÚ ubahhèhU hFj× h}rà (h]h ]h ]h ]h ]rá hëauubahhMhU hFjÓ h}râ (h]Urefidj¸ h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFj° ubehhðhhhX implements(*interfaces)hFj« ubhñ)rã }rä (h%Nh&h¯h}rå (h]h ]h ]h ]h ]uh ]ræ (h)rç }rè (h%Kh&j¦ h}ré (h]h ]h ]h ]h ]uh ]rê hBX6 Declare interfaces implemented by instances of a classrë
rì }rí (hX6 Declare interfaces implemented by instances of a classrî hFjç ubahhhhhjî hFjã ubh)rï }rð (h%Kh&j¦ h}rñ (h]h ]h ]h ]h ]uh ]rò hBX. This function is called in a class definition.ró
rô }rõ (hX. This function is called in a class definition.rö hFjï ubahhhhhjö hFjã ubh)r÷ }rø (h%Kh&j¦ h}rù (h]h ]h ]h ]h ]uh ]rú hBX\ The arguments are one or more interfaces or interface
specifications (IDeclaration objects).rû
rü }rý (hX\ The arguments are one or more interfaces or interface
specifications (IDeclaration objects).rþ hFj÷ ubahhhhhjþ hFjã ubh)rÿ }r (h%Kh&j¦ h}r (h]h ]h ]h ]h ]uh ]r hBXv The interfaces given (including the interfaces in the
specifications) are added to any interfaces previously
declared.r
r }r (hXv The interfaces given (including the interfaces in the
specifications) are added to any interfaces previously
declared.r hFjÿ ubahhhhhj hFjã ubh)r }r (h%K h&j¦ h}r (h]h ]h ]h ]h ]uh ]r
hBX[ Previous declarations include declarations for base classes
unless implementsOnly was used.r
r }r
(hX[ Previous declarations include declarations for base classes
unless implementsOnly was used.r hFj ubahhhhhj hFjã ubh)r }r (h%Kh&j¦ h}r (h]h ]h ]h ]h ]uh ]r hBXr This function is provided for convenience. It provides a more
convenient way to call classImplements. For example:r
r }r (hXr This function is provided for convenience. It provides a more
convenient way to call classImplements. For example:hFj ubahhhhhXs This function is provided for convenience. It provides a more
convenient way to call classImplements. For example::hFjã ubj )r }r (h%Kh&j¦ h}r (h]h ]h ]j j h ]h ]uh ]r hBX implements(I1)r
r }r (hU hFj ubahj$ hhhX implements(I1)hFjã ubh)r }r (h%Kh&j¦ h}r (h]h ]h ]h ]h ]uh ]r hBX is equivalent to calling:r!
r" }r# (hX is equivalent to calling:hFj ubahhhhhX is equivalent to calling::hFjã ubj )r$ }r% (h%Kh&j¦ h}r& (h]h ]h ]j j h ]h ]uh ]r' hBX classImplements(C, I1)r(
r) }r* (hU hFj$ ubahj$ hhhX classImplements(C, I1)hFjã ubh)r+ }r, (h%Kh&j¦ h}r- (h]h ]h ]h ]h ]uh ]r. hBX! after the class has been created.r/
r0 }r1 (hX! after the class has been created.r2 hFj+ ubahhhhhj2 hFjã ubehj; hhhU hFj« ubehj< hhhU hFj ubehjý hhhU hFjy jþ Kubehjý hhhU hFh#ubh")r3 }r4 (h%Mh&hh}r5 (h]h ]r6 U*zope-interface-declarations-implementsonlyr7 ah ]h ]r8 X, zope.interface.declarations.implementsonly()r9 ah ]uh ]r: (h-)r; }r< (h%Mh&hh}r= (h]h ]h ]h ]h ]uh ]r> h2)r? }r@ (h%Mh&hh}rA (h]h6Nh ]h ]U refdomainX pyrB h8NUreftypeX funch9X* zope.interface.declarations.implementsOnlyh:h ]h ]U refexplicith;h<uh ]rC h>)rD }rE (h ]rF hBX, zope.interface.declarations.implementsOnly()rG
rH }rI (hU hFjD ubahhGhX2 :func:`zope.interface.declarations.implementsOnly`rJ hFj? h}rK (h]h ]h ]h ]h ]rL (hKjB X py-funcrM euubahhMhjJ hFj; ubahhRhhhjJ hFj3 ubh")rN }rO (h%Mh&hh}rP (h]rQ X apirR ah ]rS Uid14rT ah ]h ]h ]uh ]rU (h-)rV }rW (h%Mh&hh}rX (h]h ]h ]h ]h ]uh ]rY hBX APIrZ
r[ }r\ (hX APIr] hFjV ubahhRhhhj] hFjN ubh)r^ }r_ (h%Nh&Xª /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.implementsOnlyr` h}ra (h]h ]h ]Uentries]rb (hX8 implementsOnly() (in module zope.interface.declarations)X* zope.interface.declarations.implementsOnlyrc U trd ah ]h ]uh ]hh¡hhhU hFjN ubh¢)re }rf (h%Nh&j` h}rg (h]h¦X pyh ]h ]h§X functionrh h©jh hªh ]h ]uh ]ri (h¬)rj }rk (h%Nh&h¯h}rl (h]h ]h ]rm jc ah²h³U h ]rn jc ahµh¶X zope.interface.declarationsro
rp }rq bh ]hºX implementsOnlyrr uh ]rs (hÆ)rt }ru (h%Nh&h¯h}rv (h]h ]h ]h ]h ]uh ]rw hBX zope.interface.declarations.rx
ry }rz (hU hFjt ubahhÎhhhX zope.interface.declarations.hFjj ubhÏ)r{ }r| (h%Nh&h¯h}r} (h]h ]h ]h ]h ]uh ]r~ hBX implementsOnlyr
r }r (hU hFj{ ubahh×hhhjr hFjj ubj )r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r
j )r }r (h ]r hBX *interfacesr
r }r (hU hFj ubahj$ hX *interfaceshFj h}r (h]h ]h ]h ]h ]uubahj& hhhU hFjj ubhØ)r }r (h%Nh&Nh}r (h]UexprhÜh ]h ]h ]h ]uh ]r h2)r }r (h ]r há)r }r (h ]r hBX [source]r
r }r (hU hFj ubahhèhU hFj h}r (h]h ]h ]h ]h ]r hëauubahhMhU hFj h}r (h]Urefidjr h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFjj ubehhðhhhX implementsOnly(*interfaces)hFje ubhñ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r (h)r¡ }r¢ (h%Kh&j` h}r£ (h]h ]h ]h ]h ]uh ]r¤ hBX? Declare the only interfaces implemented by instances of a classr¥
r¦ }r§ (hX? Declare the only interfaces implemented by instances of a classr¨ hFj¡ ubahhhhhj¨ hFj ubh)r© }rª (h%Kh&j` h}r« (h]h ]h ]h ]h ]uh ]r¬ hBX. This function is called in a class definition.r
r® }r¯ (hX. This function is called in a class definition.r° hFj© ubahhhhhj° hFj ubh)r± }r² (h%Kh&j` h}r³ (h]h ]h ]h ]h ]uh ]r´ hBX\ The arguments are one or more interfaces or interface
specifications (IDeclaration objects).rµ
r¶ }r· (hX\ The arguments are one or more interfaces or interface
specifications (IDeclaration objects).r¸ hFj± ubahhhhhj¸ hFj ubh)r¹ }rº (h%Kh&j` h}r» (h]h ]h ]h ]h ]uh ]r¼ hBXM Previous declarations including declarations for base classes
are overridden.r½
r¾ }r¿ (hXM Previous declarations including declarations for base classes
are overridden.rÀ hFj¹ ubahhhhhjÀ hFj ubh)rÁ }r (h%K h&j` h}rà (h]h ]h ]h ]h ]uh ]rÄ hBXv This function is provided for convenience. It provides a more
convenient way to call classImplementsOnly. For example:rÅ
rÆ }rÇ (hXv This function is provided for convenience. It provides a more
convenient way to call classImplementsOnly. For example:hFjÁ ubahhhhhXw This function is provided for convenience. It provides a more
convenient way to call classImplementsOnly. For example::hFj ubj )rÈ }rÉ (h%Kh&j` h}rÊ (h]h ]h ]j j h ]h ]uh ]rË hBX implementsOnly(I1)rÌ
rÍ }rÎ (hU hFjÈ ubahj$ hhhX implementsOnly(I1)hFj ubh)rÏ }rÐ (h%Kh&j` h}rÑ (h]h ]h ]h ]h ]uh ]rÒ hBX is equivalent to calling:rÓ
rÔ }rÕ (hX is equivalent to calling:hFjÏ ubahhhhhX is equivalent to calling::hFj ubj )rÖ }r× (h%Kh&j` h}rØ (h]h ]h ]j j h ]h ]uh ]rÙ hBX classImplementsOnly(I1)rÚ
rÛ }rÜ (hU hFjÖ ubahj$ hhhX classImplementsOnly(I1)hFj ubh)rÝ }rÞ (h%Kh&j` h}rß (h]h ]h ]h ]h ]uh ]rà hBX! after the class has been created.rá
râ }rã (hX! after the class has been created.rä hFjÝ ubahhhhhjä hFj ubehj; hhhU hFje ubehj< hhhU hFjN ubehjý hhhU hFj3 jþ Kubehjý hhhU hFh#ubh")rå }ræ (h%M h&hh}rç (h]h ]rè U)zope-interface-declarations-providesclassré ah ]h ]rê X) zope.interface.declarations.providesclassrë ah ]uh ]rì (h-)rí }rî (h%M h&hh}rï (h]h ]h ]h ]h ]uh ]rð h2)rñ }rò (h%M h&hh}ró (h]h6Nh ]h ]U refdomainX pyrô h8NUreftypeX classh9X) zope.interface.declarations.ProvidesClassh:h ]h ]U refexplicith;h<uh ]rõ h>)rö }r÷ (h ]rø hBX) zope.interface.declarations.ProvidesClassrù
rú }rû (hU hFjö ubahhGhX2 :class:`zope.interface.declarations.ProvidesClass`rü hFjñ h}rý (h]h ]h ]h ]h ]rþ (hKjô X py-classrÿ euubahhMhjü hFjí ubahhRhhhjü hFjå ubh")r }r (h%M!h&hh}r (h]r X apir ah ]r Uid15r ah ]h ]h ]uh ]r (h-)r }r (h%M!h&hh}r
(h]h ]h ]h ]h ]uh ]r hBX APIr
r
}r (hX APIr hFj ubahhRhhhj hFj ubh)r }r (h%Nh&U h}r (h]h ]h ]Uentries]r (hX5 ProvidesClass (in module zope.interface.declarations)X) zope.interface.declarations.ProvidesClassr U tr ah ]h ]uh ]hh¡hhhU hFj ubh¢)r }r (h%Nh&U h}r (h]h¦X pyh ]h ]h§X attributer h©j hªh ]h ]uh ]r (h¬)r }r (h%Nh&h¯h}r (h]h ]h ]r j ah²h³U h ]r j ahµh¶X zope.interface.declarationsr
r! }r" bh ]hºX
ProvidesClassr# uh ]r$ (hÆ)r% }r& (h%Nh&h¯h}r' (h]h ]h ]h ]h ]uh ]r( hBX zope.interface.declarations.r)
r* }r+ (hU hFj% ubahhÎhhhX zope.interface.declarations.hFj ubhÏ)r, }r- (h%Nh&h¯h}r. (h]h ]h ]h ]h ]uh ]r/ hBX
ProvidesClassr0
r1 }r2 (hU hFj, ubahh×hhhj# hFj ubehhðhhhj# hFj ubhñ)r3 }r4 (h%Nh&h¯h}r5 (h]h ]h ]h ]h ]uh ]r6 h)r7 }r8 (h%Kh&U h}r9 (h]h ]h ]h ]h ]uh ]r: (hBX alias of r;
r< }r= (hX alias of hFj7 ubh2)r> }r? (h%Kh&hh}r@ (h]h6Nh ]h ]U refdomainX pyrA h8NUreftypeX classh9X Providesh:h ]h ]U refexplicith;h<uh ]rB h>)rC }rD (h ]rE hBX ProvidesrF
rG }rH (hU hFjC ubahhGhX :class:`Provides`rI hFj> h}rJ (h]h ]h ]h ]h ]rK (hKjA X py-classrL euubahhMhjI hFj7 ubehhhhhX alias of :class:`Provides`hFj3 ubahj; hhhU hFj ubehj< hhhU hFj ubehjý hhhU hFjå jþ Kubh")rM }rN (h%M)h&hh}rO (h]rP X usagerQ ah ]rR Uid16rS ah ]h ]h ]uh ]rT (h-)rU }rV (h%M)h&hh}rW (h]h ]h ]h ]h ]uh ]rX hBX UsagerY
rZ }r[ (hX Usager\ hFjU ubahhRhhhj\ hFjM ubh)r] }r^ (h%M+h&hh}r_ (h]h ]h ]h ]h ]uh ]r` (hBX Descriptor semantics (via ra
rb }rc (hX Descriptor semantics (via hFj] ubh>)rd }re (h ]rf hBX Provides.__get__rg
rh }ri (hU hFjd ubahhGhX ``Provides.__get__``hFj] h}rj (h]h ]h ]h ]h ]uubhBX ):rk
rl }rm (hX ):hFj] ubehhhhhX0 Descriptor semantics (via ``Provides.__get__``):rn hFjM ubj )ro }rp (h%M-h&hh}rq (h]j j h ]h ]U testnodetypeX doctestUgroups]rr j ah ]h ]j }uh ]rs hBX@ >>> from zope.interface import Interface
>>> class IFooFactory(Interface): pass
...
>>> class C(object):
... pass
>>> from zope.interface.declarations import ProvidesClass
>>> C.__provides__ = ProvidesClass(C, IFooFactory)
>>> [i.getName() for i in C.__provides__]
['IFooFactory']
>>> getattr(C(), '__provides__', 0)
0rt
ru }rv (hU hFjo ubahj$ hhhX@ >>> from zope.interface import Interface
>>> class IFooFactory(Interface): pass
...
>>> class C(object):
... pass
>>> from zope.interface.declarations import ProvidesClass
>>> C.__provides__ = ProvidesClass(C, IFooFactory)
>>> [i.getName() for i in C.__provides__]
['IFooFactory']
>>> getattr(C(), '__provides__', 0)
0hFjM ubehjý hhhU hFjå jþ Kubehjý hhhU hFh#ubh")rw }rx (h%M>h&hh}ry (h]h ]rz U$zope-interface-declarations-providesr{ ah ]h ]r| X& zope.interface.declarations.provides()r} ah ]uh ]r~ (h-)r }r (h%M>h&hh}r (h]h ]h ]h ]h ]uh ]r h2)r }r (h%M=h&hh}r
(h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX funch9X$ zope.interface.declarations.Providesh:h ]h ]U refexplicith;h<uh ]r h>)r }r (h ]r hBX& zope.interface.declarations.Provides()r
r }r (hU hFj ubahhGhX, :func:`zope.interface.declarations.Provides`r hFj h}r (h]h ]h ]h ]h ]r (hKj X py-funcr euubahhMhj hFj ubahhRhhhj hFjw ubh")r }r (h%MAh&hh}r (h]r X apir ah ]r Uid17r ah ]h ]h ]uh ]r (h-)r }r (h%MAh&hh}r (h]h ]h ]h ]h ]uh ]r hBX APIr
r }r (hX APIr¡ hFj ubahhRhhhj¡ hFj ubh)r¢ }r£ (h%Nh&X¤ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.Providesr¤ h}r¥ (h]h ]h ]Uentries]r¦ (hX2 Provides() (in module zope.interface.declarations)X$ zope.interface.declarations.Providesr§ U tr¨ ah ]h ]uh ]hh¡hhhU hFj ubh¢)r© }rª (h%Nh&j¤ h}r« (h]h¦X pyh ]h ]h§X functionr¬ h©j¬ hªh ]h ]uh ]r (h¬)r® }r¯ (h%Nh&h¯h}r° (h]h ]h ]r± j§ ah²h³U h ]r² j§ ahµh¶X zope.interface.declarationsr³
r´ }rµ bh ]hºX Providesr¶ uh ]r· (hÆ)r¸ }r¹ (h%Nh&h¯h}rº (h]h ]h ]h ]h ]uh ]r» hBX zope.interface.declarations.r¼
r½ }r¾ (hU hFj¸ ubahhÎhhhX zope.interface.declarations.hFj® ubhÏ)r¿ }rÀ (h%Nh&h¯h}rÁ (h]h ]h ]h ]h ]uh ]r hBX ProvidesrÃ
rÄ }rÅ (hU hFj¿ ubahh×hhhj¶ hFj® ubj )rÆ }rÇ (h%Nh&h¯h}rÈ (h]h ]h ]h ]h ]uh ]rÉ j )rÊ }rË (h ]rÌ hBX *interfacesrÍ
rÎ }rÏ (hU hFjÊ ubahj$ hX *interfaceshFjÆ h}rÐ (h]h ]h ]h ]h ]uubahj& hhhU hFj® ubhØ)rÑ }rÒ (h%Nh&Nh}rÓ (h]UexprhÜh ]h ]h ]h ]uh ]rÔ h2)rÕ }rÖ (h ]r× há)rØ }rÙ (h ]rÚ hBX [source]rÛ
rÜ }rÝ (hU hFjØ ubahhèhU hFjÕ h}rÞ (h]h ]h ]h ]h ]rß hëauubahhMhU hFjÑ h}rà (h]Urefidj¶ h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFj® ubehhðhhhX Provides(*interfaces)hFj© ubhñ)rá }râ (h%Nh&h¯h}rã (h]h ]h ]h ]h ]uh ]rä (h)rå }ræ (h%Kh&j¤ h}rç (h]h ]h ]h ]h ]uh ]rè hBX Cache instance declarationsré
rê }rë (hX Cache instance declarationsrì hFjå ubahhhhhjì hFjá ubh)rí }rî (h%Kh&j¤ h}rï (h]h ]h ]h ]h ]uh ]rð hBX Instance declarations are shared among instances that have the same
declaration. The declarations are cached in a weak value dictionary.rñ
rò }ró (hX Instance declarations are shared among instances that have the same
declaration. The declarations are cached in a weak value dictionary.rô hFjí ubahhhhhjô hFjá ubehj; hhhU hFj© ubehj< hhhU hFj ubehjý hhhU hFjw jþ Kubh")rõ }rö (h%MGh&hh}r÷ (h]rø X usagerù ah ]rú Uid18rû ah ]h ]h ]uh ]rü (h-)rý }rþ (h%MGh&hh}rÿ (h]h ]h ]h ]h ]uh ]r hBX Usager
r }r (hX Usager hFjý ubahhRhhhj hFjõ ubh)r }r (h%MIh&hh}r (h]h ]h ]h ]h ]uh ]r hBXp In the examples below, we are going to make assertions about
the size of the weakvalue dictionary. For the assertions to be
meaningful, we need to force garbage collection to make sure garbage
objects are, indeed, removed from the system. Depending on how Python
is run, we may need to make multiple calls to be sure. We provide a
collect function to help with this:r
r
}r (hXp In the examples below, we are going to make assertions about
the size of the weakvalue dictionary. For the assertions to be
meaningful, we need to force garbage collection to make sure garbage
objects are, indeed, removed from the system. Depending on how Python
is run, we may need to make multiple calls to be sure. We provide a
collect function to help with this:r hFj ubahhhhhj hFjõ ubj )r
}r (h%MPh&hh}r (h]j j h ]h ]U testnodetypeX doctestUgroups]r j ah ]h ]j }uh ]r hBX© >>> import gc
>>> def collect():
... for i in range(4):
... gc.collect()
>>> collect()
>>> from zope.interface.declarations import InstanceDeclarations
>>> before = len(InstanceDeclarations)
>>> class C(object):
... pass
>>> from zope.interface import Interface
>>> class I(Interface):
... pass
>>> c1 = C()
>>> c2 = C()
>>> len(InstanceDeclarations) == before
True
>>> directlyProvides(c1, I)
>>> len(InstanceDeclarations) == before + 1
True
>>> directlyProvides(c2, I)
>>> len(InstanceDeclarations) == before + 1
True
>>> del c1
>>> collect()
>>> len(InstanceDeclarations) == before + 1
True
>>> del c2
>>> collect()
>>> len(InstanceDeclarations) == before
Truer
r }r (hU hFj
ubahj$ hhhX© >>> import gc
>>> def collect():
... for i in range(4):
... gc.collect()
>>> collect()
>>> from zope.interface.declarations import InstanceDeclarations
>>> before = len(InstanceDeclarations)
>>> class C(object):
... pass
>>> from zope.interface import Interface
>>> class I(Interface):
... pass
>>> c1 = C()
>>> c2 = C()
>>> len(InstanceDeclarations) == before
True
>>> directlyProvides(c1, I)
>>> len(InstanceDeclarations) == before + 1
True
>>> directlyProvides(c2, I)
>>> len(InstanceDeclarations) == before + 1
True
>>> del c1
>>> collect()
>>> len(InstanceDeclarations) == before + 1
True
>>> del c2
>>> collect()
>>> len(InstanceDeclarations) == before
TruehFjõ ubehjý hhhU hFjw jþ Kubehjý hhhU hFh#ubh")r }r (h%Msh&hh}r (h]h ]r U,zope-interface-declarations-directlyprovidesr ah ]h ]r X. zope.interface.declarations.directlyprovides()r ah ]uh ]r (h-)r }r (h%Msh&hh}r (h]h ]h ]h ]h ]uh ]r h2)r! }r" (h%Mrh&hh}r# (h]h6Nh ]h ]U refdomainX pyr$ h8NUreftypeX funch9X, zope.interface.declarations.directlyProvidesh:h ]h ]U refexplicith;h<uh ]r% h>)r& }r' (h ]r( hBX. zope.interface.declarations.directlyProvides()r)
r* }r+ (hU hFj& ubahhGhX4 :func:`zope.interface.declarations.directlyProvides`r, hFj! h}r- (h]h ]h ]h ]h ]r. (hKj$ X py-funcr/ euubahhMhj, hFj ubahhRhhhj, hFj ubh")r0 }r1 (h%Mvh&hh}r2 (h]r3 X apir4 ah ]r5 Uid19r6 ah ]h ]h ]uh ]r7 (h-)r8 }r9 (h%Mvh&hh}r: (h]h ]h ]h ]h ]uh ]r; hBX APIr<
r= }r> (hX APIr? hFj8 ubahhRhhhj? hFj0 ubh)r@ }rA (h%Nh&X¬ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.directlyProvidesrB h}rC (h]h ]h ]Uentries]rD (hX: directlyProvides() (in module zope.interface.declarations)X, zope.interface.declarations.directlyProvidesrE U trF ah ]h ]uh ]hh¡hhhU hFj0 ubh¢)rG }rH (h%Nh&jB h}rI (h]h¦X pyh ]h ]h§X functionrJ h©jJ hªh ]h ]uh ]rK (h¬)rL }rM (h%Nh&h¯h}rN (h]h ]h ]rO jE ah²h³U h ]rP jE ahµh¶X zope.interface.declarationsrQ
rR }rS bh ]hºX directlyProvidesrT uh ]rU (hÆ)rV }rW (h%Nh&h¯h}rX (h]h ]h ]h ]h ]uh ]rY hBX zope.interface.declarations.rZ
r[ }r\ (hU hFjV ubahhÎhhhX zope.interface.declarations.hFjL ubhÏ)r] }r^ (h%Nh&h¯h}r_ (h]h ]h ]h ]h ]uh ]r` hBX directlyProvidesra
rb }rc (hU hFj] ubahh×hhhjT hFjL ubj )rd }re (h%Nh&h¯h}rf (h]h ]h ]h ]h ]uh ]rg (j )rh }ri (h ]rj hBX objectrk
rl }rm (hU hFjh ubahj$ hX objecthFjd h}rn (h]h ]h ]h ]h ]uubj )ro }rp (h ]rq hBX *interfacesrr
rs }rt (hU hFjo ubahj$ hX *interfaceshFjd h}ru (h]h ]h ]h ]h ]uubehj& hhhU hFjL ubhØ)rv }rw (h%Nh&Nh}rx (h]UexprhÜh ]h ]h ]h ]uh ]ry h2)rz }r{ (h ]r| há)r} }r~ (h ]r hBX [source]r
r }r (hU hFj} ubahhèhU hFjz h}r (h]h ]h ]h ]h ]r hëauubahhMhU hFjv h}r
(h]UrefidjT h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFjL ubehhðhhhX% directlyProvides(object, *interfaces)hFjG ubhñ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r (h)r }r (h%Kh&jB h}r (h]h ]h ]h ]h ]uh ]r hBX2 Declare interfaces declared directly for an objectr
r }r (hX2 Declare interfaces declared directly for an objectr hFj ubahhhhhj hFj ubh)r }r (h%Kh&jB h}r (h]h ]h ]h ]h ]uh ]r (hBXW The arguments after the object are one or more interfaces or interface
specifications (r
r }r (hXW The arguments after the object are one or more interfaces or interface
specifications (hFj ubh>)r }r (h ]r hBX IDeclarationr
r }r (hU hFj ubahhGhX ``IDeclaration``hFj h}r (h]h ]h ]h ]h ]uubhBX
objects).r
r¡ }r¢ (hX
objects).hFj ubehhhhhXq The arguments after the object are one or more interfaces or interface
specifications (``IDeclaration`` objects).hFj ubh)r£ }r¤ (h%Kh&jB h}r¥ (h]h ]h ]h ]h ]uh ]r¦ hBX| The interfaces given (including the interfaces in the specifications)
replace interfaces previously declared for the object.r§
r¨ }r© (hX| The interfaces given (including the interfaces in the specifications)
replace interfaces previously declared for the object.rª hFj£ ubahhhhhjª hFj ubehj; hhhU hFjG ubehj< hhhU hFj0 ubehjý hhhU hFj jþ Kubh")r« }r¬ (h%M|h&hh}r (h]r® X usager¯ ah ]r° Uid20r± ah ]h ]h ]uh ]r² (h-)r³ }r´ (h%M|h&hh}rµ (h]h ]h ]h ]h ]uh ]r¶ hBX Usager·
r¸ }r¹ (hX Usagerº hFj³ ubahhRhhhjº hFj« ubh)r» }r¼ (h%M~h&hh}r½ (h]h ]h ]h ]h ]uh ]r¾ hBX Consider the following example:r¿
rÀ }rÁ (hX Consider the following example:r hFj» ubahhhhhj hFj« ubj )rà }rÄ (h%Mh&hh}rÅ (h]j j h ]h ]U testnodetypeX doctestUgroups]rÆ j ah ]h ]j }uh ]rÇ hBXm >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class IA1(Interface): pass
...
>>> class IA2(Interface): pass
...
>>> class IB(Interface): pass
...
>>> class IC(Interface): pass
...
>>> class A(object):
... implements(IA1, IA2)
>>> class B(object):
... implements(IB)
>>> class C(A, B):
... implements(IC)
>>> ob = C()
>>> directlyProvides(ob, I1, I2)
>>> int(I1 in providedBy(ob))
1
>>> int(I2 in providedBy(ob))
1
>>> int(IA1 in providedBy(ob))
1
>>> int(IA2 in providedBy(ob))
1
>>> int(IB in providedBy(ob))
1
>>> int(IC in providedBy(ob))
1rÈ
rÉ }rÊ (hU hFjà ubahj$ hhhXm >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class IA1(Interface): pass
...
>>> class IA2(Interface): pass
...
>>> class IB(Interface): pass
...
>>> class IC(Interface): pass
...
>>> class A(object):
... implements(IA1, IA2)
>>> class B(object):
... implements(IB)
>>> class C(A, B):
... implements(IC)
>>> ob = C()
>>> directlyProvides(ob, I1, I2)
>>> int(I1 in providedBy(ob))
1
>>> int(I2 in providedBy(ob))
1
>>> int(IA1 in providedBy(ob))
1
>>> int(IA2 in providedBy(ob))
1
>>> int(IB in providedBy(ob))
1
>>> int(IC in providedBy(ob))
1hFj« ubh)rË }rÌ (h%M¤h&hh}rÍ (h]h ]h ]h ]h ]uh ]rÎ (hBX The object, rÏ
rÐ }rÑ (hX The object, hFjË ubh>)rÒ }rÓ (h ]rÔ hBX obrÕ
rÖ }r× (hU hFjÒ ubahhGhX ``ob``hFjË h}rØ (h]h ]h ]h ]h ]uubhBX
provides rÙ
rÚ }rÛ (hX
provides hFjË ubh>)rÜ }rÝ (h ]rÞ hBX I1rß
rà }rá (hU hFjÜ ubahhGhX ``I1``hFjË h}râ (h]h ]h ]h ]h ]uubhBX , rã
rä }rå (hX , hFjË ubh>)ræ }rç (h ]rè hBX I2ré
rê }rë (hU hFjæ ubahhGhX ``I2``hFjË h}rì (h]h ]h ]h ]h ]uubhBXH , and whatever interfaces
instances have been declared for instances of rí
rî }rï (hXH , and whatever interfaces
instances have been declared for instances of hFjË ubh>)rð }rñ (h ]rò hBX C
ró }rô (hU hFjð ubahhGhX ``C``hFjË h}rõ (h]h ]h ]h ]h ]uubhBX .
rö }r÷ (hX .hFjË ubehhhhhXx The object, ``ob`` provides ``I1``, ``I2``, and whatever interfaces
instances have been declared for instances of ``C``.hFj« ubh)rø }rù (h%M§h&hh}rú (h]h ]h ]h ]h ]uh ]rû (hBX, To remove directly provided interfaces, use rü
rý }rþ (hX, To remove directly provided interfaces, use hFjø ubh>)rÿ }r (h ]r hBX directlyProvidedByr
r }r (hU hFjÿ ubahhGhX ``directlyProvidedBy``hFjø h}r (h]h ]h ]h ]h ]uubhBX3 and
subtract the unwanted interfaces. For example:r
r }r (hX3 and
subtract the unwanted interfaces. For example:hFjø ubehhhhhXu To remove directly provided interfaces, use ``directlyProvidedBy`` and
subtract the unwanted interfaces. For example:hFj« ubj )r }r
(h%Mªh&hh}r (h]j j h ]h ]U testnodetypeX doctestUgroups]r j ah ]h ]j }uh ]r
hBXs >>> directlyProvides(ob, directlyProvidedBy(ob)-I2)
>>> int(I1 in providedBy(ob))
1
>>> int(I2 in providedBy(ob))
0r
r }r (hU hFj ubahj$ hhhXs >>> directlyProvides(ob, directlyProvidedBy(ob)-I2)
>>> int(I1 in providedBy(ob))
1
>>> int(I2 in providedBy(ob))
0hFj« ubh)r }r (h%M²h&hh}r (h]h ]h ]h ]h ]uh ]r (hBX4 removes I2 from the interfaces directly provided by r
r }r (hX4 removes I2 from the interfaces directly provided by hFj ubh>)r }r (h ]r hBX obr
r }r (hU hFj ubahhGhX ``ob``hFj h}r (h]h ]h ]h ]h ]uubhBX . The object,
r
r }r! (hX . The object,
hFj ubh>)r" }r# (h ]r$ hBX obr%
r& }r' (hU hFj" ubahhGhX ``ob``hFj h}r( (h]h ]h ]h ]h ]uubhBX no longer directly provides r)
r* }r+ (hX no longer directly provides hFj ubh>)r, }r- (h ]r. hBX I2r/
r0 }r1 (hU hFj, ubahhGhX ``I2``hFj h}r2 (h]h ]h ]h ]h ]uubhBX" , although it might still
provide r3
r4 }r5 (hX" , although it might still
provide hFj ubh>)r6 }r7 (h ]r8 hBX I2r9
r: }r; (hU hFj6 ubahhGhX ``I2``hFj h}r< (h]h ]h ]h ]h ]uubhBX if it's class implements r=
r> }r? (hX if it's class implements hFj ubh>)r@ }rA (h ]rB hBX I2rC
rD }rE (hU hFj@ ubahhGhX ``I2``hFj h}rF (h]h ]h ]h ]h ]uubhBX .
rG }rH (hX .hFj ubehhhhhXº removes I2 from the interfaces directly provided by ``ob``. The object,
``ob`` no longer directly provides ``I2``, although it might still
provide ``I2`` if it's class implements ``I2``.hFj« ubh)rI }rJ (h%M¶h&hh}rK (h]h ]h ]h ]h ]uh ]rL (hBX) To add directly provided interfaces, use rM
rN }rO (hX) To add directly provided interfaces, use hFjI ubh>)rP }rQ (h ]rR hBX directlyProvidedByrS
rT }rU (hU hFjP ubahhGhX ``directlyProvidedBy``hFjI h}rV (h]h ]h ]h ]h ]uubhBX1 and
include additional interfaces. For example:rW
rX }rY (hX1 and
include additional interfaces. For example:hFjI ubehhhhhXp To add directly provided interfaces, use ``directlyProvidedBy`` and
include additional interfaces. For example:hFj« ubj )rZ }r[ (h%M¹h&hh}r\ (h]j j h ]h ]U testnodetypeX doctestUgroups]r] j ah ]h ]j }uh ]r^ hBXT >>> int(I2 in providedBy(ob))
0
>>> directlyProvides(ob, directlyProvidedBy(ob), I2)r_
r` }ra (hU hFjZ ubahj$ hhhXT >>> int(I2 in providedBy(ob))
0
>>> directlyProvides(ob, directlyProvidedBy(ob), I2)hFj« ubh)rb }rc (h%M¿h&hh}rd (h]h ]h ]h ]h ]uh ]re (hBX adds rf
rg }rh (hX adds hFjb ubh>)ri }rj (h ]rk hBX I2rl
rm }rn (hU hFji ubahhGhX ``I2``hFjb h}ro (h]h ]h ]h ]h ]uubhBX+ to the interfaces directly provided by ob:rp
rq }rr (hX+ to the interfaces directly provided by ob:hFjb ubehhhhhX6 adds ``I2`` to the interfaces directly provided by ob:rs hFj« ubj )rt }ru (h%MÁh&hh}rv (h]j j h ]h ]U testnodetypeX doctestUgroups]rw j ah ]h ]j }uh ]rx hBX >>> int(I2 in providedBy(ob))
1ry
rz }r{ (hU hFjt ubahj$ hhhX >>> int(I2 in providedBy(ob))
1hFj« ubh)r| }r} (h%MÆh&hh}r~ (h]h ]h ]h ]h ]uh ]r hBXW We need to avoid setting this attribute on meta classes that
don't support descriptors.r
r }r (hXW We need to avoid setting this attribute on meta classes that
don't support descriptors.r hFj| ubahhhhhj hFj« ubh)r }r
(h%MÉh&hh}r (h]h ]h ]h ]h ]uh ]r hBX< We can do away with this check when we get rid of the old ECr
r }r (hX< We can do away with this check when we get rid of the old ECr hFj ubahhhhhj hFj« ubehjý hhhU hFj jþ Kubehjý hhhU hFh#ubh")r }r (h%MÍh&hh}r (h]h ]r U(zope-interface-declarations-alsoprovidesr ah ]h ]r X* zope.interface.declarations.alsoprovides()r ah ]uh ]r (h-)r }r (h%MÍh&hh}r (h]h ]h ]h ]h ]uh ]r h2)r }r (h%MÌh&hh}r (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX funch9X( zope.interface.declarations.alsoProvidesh:h ]h ]U refexplicith;h<uh ]r h>)r }r (h ]r hBX* zope.interface.declarations.alsoProvides()r
r¡ }r¢ (hU hFj ubahhGhX0 :func:`zope.interface.declarations.alsoProvides`r£ hFj h}r¤ (h]h ]h ]h ]h ]r¥ (hKj X py-funcr¦ euubahhMhj£ hFj ubahhRhhhj£ hFj ubh")r§ }r¨ (h%MÐh&hh}r© (h]rª X apir« ah ]r¬ Uid21r ah ]h ]h ]uh ]r® (h-)r¯ }r° (h%MÐh&hh}r± (h]h ]h ]h ]h ]uh ]r² hBX APIr³
r´ }rµ (hX APIr¶ hFj¯ ubahhRhhhj¶ hFj§ ubh)r· }r¸ (h%Nh&X¨ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.alsoProvidesr¹ h}rº (h]h ]h ]Uentries]r» (hX6 alsoProvides() (in module zope.interface.declarations)X( zope.interface.declarations.alsoProvidesr¼ U tr½ ah ]h ]uh ]hh¡hhhU hFj§ ubh¢)r¾ }r¿ (h%Nh&j¹ h}rÀ (h]h¦X pyh ]h ]h§X functionrÁ h©jÁ hªh ]h ]uh ]r (h¬)rà }rÄ (h%Nh&h¯h}rÅ (h]h ]h ]rÆ j¼ ah²h³U h ]rÇ j¼ ahµh¶X zope.interface.declarationsrÈ
rÉ }rÊ bh ]hºX alsoProvidesrË uh ]rÌ (hÆ)rÍ }rÎ (h%Nh&h¯h}rÏ (h]h ]h ]h ]h ]uh ]rÐ hBX zope.interface.declarations.rÑ
rÒ }rÓ (hU hFjÍ ubahhÎhhhX zope.interface.declarations.hFjà ubhÏ)rÔ }rÕ (h%Nh&h¯h}rÖ (h]h ]h ]h ]h ]uh ]r× hBX alsoProvidesrØ
rÙ }rÚ (hU hFjÔ ubahh×hhhjË hFjà ubj )rÛ }rÜ (h%Nh&h¯h}rÝ (h]h ]h ]h ]h ]uh ]rÞ (j )rß }rà (h ]rá hBX objectrâ
rã }rä (hU hFjß ubahj$ hX objecthFjÛ h}rå (h]h ]h ]h ]h ]uubj )ræ }rç (h ]rè hBX *interfacesré
rê }rë (hU hFjæ ubahj$ hX *interfaceshFjÛ h}rì (h]h ]h ]h ]h ]uubehj& hhhU hFjà ubhØ)rí }rî (h%Nh&Nh}rï (h]UexprhÜh ]h ]h ]h ]uh ]rð h2)rñ }rò (h ]ró há)rô }rõ (h ]rö hBX [source]r÷
rø }rù (hU hFjô ubahhèhU hFjñ h}rú (h]h ]h ]h ]h ]rû hëauubahhMhU hFjí h}rü (h]UrefidjË h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFjà ubehhðhhhX! alsoProvides(object, *interfaces)hFj¾ ubhñ)rý }rþ (h%Nh&h¯h}rÿ (h]h ]h ]h ]h ]uh ]r (h)r }r (h%Kh&j¹ h}r (h]h ]h ]h ]h ]uh ]r hBX2 Declare interfaces declared directly for an objectr
r }r (hX2 Declare interfaces declared directly for an objectr hFj ubahhhhhj hFjý ubh)r }r
(h%Kh&j¹ h}r (h]h ]h ]h ]h ]uh ]r (hBXW The arguments after the object are one or more interfaces or interface
specifications (r
r }r (hXW The arguments after the object are one or more interfaces or interface
specifications (hFj ubh>)r }r (h ]r hBX IDeclarationr
r }r (hU hFj ubahhGhX ``IDeclaration``hFj h}r (h]h ]h ]h ]h ]uubhBX
objects).r
r }r (hX
objects).hFj ubehhhhhXq The arguments after the object are one or more interfaces or interface
specifications (``IDeclaration`` objects).hFjý ubh)r }r (h%Kh&j¹ h}r (h]h ]h ]h ]h ]uh ]r hBX
The interfaces given (including the interfaces in the specifications) are
added to the interfaces previously declared for the object.r
r }r (hX
The interfaces given (including the interfaces in the specifications) are
added to the interfaces previously declared for the object.r! hFj ubahhhhhj! hFjý ubehj; hhhU hFj¾ ubehj< hhhU hFj§ ubehjý hhhU hFj jþ Kubh")r" }r# (h%MÖh&hh}r$ (h]r% X usager& ah ]r' Uid22r( ah ]h ]h ]uh ]r) (h-)r* }r+ (h%MÖh&hh}r, (h]h ]h ]h ]h ]uh ]r- hBX Usager.
r/ }r0 (hX Usager1 hFj* ubahhRhhhj1 hFj" ubh)r2 }r3 (h%MØh&hh}r4 (h]h ]h ]h ]h ]uh ]r5 hBX Consider the following example:r6
r7 }r8 (hX Consider the following example:r9 hFj2 ubahhhhhj9 hFj" ubj )r: }r; (h%MÚh&hh}r< (h]j j h ]h ]U testnodetypeX doctestUgroups]r= j ah ]h ]j }uh ]r> hBXD >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class IA1(Interface): pass
...
>>> class IA2(Interface): pass
...
>>> class IB(Interface): pass
...
>>> class IC(Interface): pass
...
>>> class A(object):
... implements(IA1, IA2)
>>> class B(object):
... implements(IB)
>>> class C(A, B):
... implements(IC)
>>> ob = C()
>>> directlyProvides(ob, I1)
>>> int(I1 in providedBy(ob))
1
>>> int(I2 in providedBy(ob))
0
>>> int(IA1 in providedBy(ob))
1
>>> int(IA2 in providedBy(ob))
1
>>> int(IB in providedBy(ob))
1
>>> int(IC in providedBy(ob))
1
>>> alsoProvides(ob, I2)
>>> int(I1 in providedBy(ob))
1
>>> int(I2 in providedBy(ob))
1
>>> int(IA1 in providedBy(ob))
1
>>> int(IA2 in providedBy(ob))
1
>>> int(IB in providedBy(ob))
1
>>> int(IC in providedBy(ob))
1r?
r@ }rA (hU hFj: ubahj$ hhhXD >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class IA1(Interface): pass
...
>>> class IA2(Interface): pass
...
>>> class IB(Interface): pass
...
>>> class IC(Interface): pass
...
>>> class A(object):
... implements(IA1, IA2)
>>> class B(object):
... implements(IB)
>>> class C(A, B):
... implements(IC)
>>> ob = C()
>>> directlyProvides(ob, I1)
>>> int(I1 in providedBy(ob))
1
>>> int(I2 in providedBy(ob))
0
>>> int(IA1 in providedBy(ob))
1
>>> int(IA2 in providedBy(ob))
1
>>> int(IB in providedBy(ob))
1
>>> int(IC in providedBy(ob))
1
>>> alsoProvides(ob, I2)
>>> int(I1 in providedBy(ob))
1
>>> int(I2 in providedBy(ob))
1
>>> int(IA1 in providedBy(ob))
1
>>> int(IA2 in providedBy(ob))
1
>>> int(IB in providedBy(ob))
1
>>> int(IC in providedBy(ob))
1hFj" ubh)rB }rC (h%M h&hh}rD (h]h ]h ]h ]h ]uh ]rE (hBX The object, rF
rG }rH (hX The object, hFjB ubh>)rI }rJ (h ]rK hBX obrL
rM }rN (hU hFjI ubahhGhX ``ob``hFjB h}rO (h]h ]h ]h ]h ]uubhBX
provides rP
rQ }rR (hX
provides hFjB ubh>)rS }rT (h ]rU hBX I1rV
rW }rX (hU hFjS ubahhGhX ``I1``hFjB h}rY (h]h ]h ]h ]h ]uubhBX , rZ
r[ }r\ (hX , hFjB ubh>)r] }r^ (h ]r_ hBX I2r`
ra }rb (hU hFj] ubahhGhX ``I2``hFjB h}rc (h]h ]h ]h ]h ]uubhBXH , and whatever interfaces
instances have been declared for instances of rd
re }rf (hXH , and whatever interfaces
instances have been declared for instances of hFjB ubh>)rg }rh (h ]ri hBX C
rj }rk (hU hFjg ubahhGhX ``C``hFjB h}rl (h]h ]h ]h ]h ]uubhBXD . Notice that the
alsoProvides just extends the provided interfaces.rm
rn }ro (hXD . Notice that the
alsoProvides just extends the provided interfaces.hFjB ubehhhhhX» The object, ``ob`` provides ``I1``, ``I2``, and whatever interfaces
instances have been declared for instances of ``C``. Notice that the
alsoProvides just extends the provided interfaces.hFj" ubehjý hhhU hFj jþ Kubehjý hhhU hFh#ubh")rp }rq (h%Mh&hh}rr (h]h ]rs U,zope-interface-declarations-nolongerprovidesrt ah ]h ]ru X. zope.interface.declarations.nolongerprovides()rv ah ]uh ]rw (h-)rx }ry (h%Mh&hh}rz (h]h ]h ]h ]h ]uh ]r{ h2)r| }r} (h%Mh&hh}r~ (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX funch9X, zope.interface.declarations.noLongerProvidesh:h ]h ]U refexplicith;h<uh ]r h>)r }r (h ]r hBX. zope.interface.declarations.noLongerProvides()r
r
}r (hU hFj ubahhGhX4 :func:`zope.interface.declarations.noLongerProvides`r hFj| h}r (h]h ]h ]h ]h ]r (hKj X py-funcr euubahhMhj hFjx ubahhRhhhj hFjp ubh")r }r (h%Mh&hh}r (h]r X apir ah ]r Uid23r ah ]h ]h ]uh ]r (h-)r }r (h%Mh&hh}r (h]h ]h ]h ]h ]uh ]r hBX APIr
r }r (hX APIr hFj ubahhRhhhj hFj ubh)r }r (h%Nh&X¬ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.noLongerProvidesr h}r (h]h ]h ]Uentries]r (hX: noLongerProvides() (in module zope.interface.declarations)X, zope.interface.declarations.noLongerProvidesr U tr¡ ah ]h ]uh ]hh¡hhhU hFj ubh¢)r¢ }r£ (h%Nh&j h}r¤ (h]h¦X pyh ]h ]h§X functionr¥ h©j¥ hªh ]h ]uh ]r¦ (h¬)r§ }r¨ (h%Nh&h¯h}r© (h]h ]h ]rª j ah²h³U h ]r« j ahµh¶X zope.interface.declarationsr¬
r }r® bh ]hºX noLongerProvidesr¯ uh ]r° (hÆ)r± }r² (h%Nh&h¯h}r³ (h]h ]h ]h ]h ]uh ]r´ hBX zope.interface.declarations.rµ
r¶ }r· (hU hFj± ubahhÎhhhX zope.interface.declarations.hFj§ ubhÏ)r¸ }r¹ (h%Nh&h¯h}rº (h]h ]h ]h ]h ]uh ]r» hBX noLongerProvidesr¼
r½ }r¾ (hU hFj¸ ubahh×hhhj¯ hFj§ ubj )r¿ }rÀ (h%Nh&h¯h}rÁ (h]h ]h ]h ]h ]uh ]r (j )rà }rÄ (h ]rÅ hBX objectrÆ
rÇ }rÈ (hU hFjà ubahj$ hX objecthFj¿ h}rÉ (h]h ]h ]h ]h ]uubj )rÊ }rË (h ]rÌ hBX interfacerÍ
rÎ }rÏ (hU hFjÊ ubahj$ hX interfacehFj¿ h}rÐ (h]h ]h ]h ]h ]uubehj& hhhU hFj§ ubhØ)rÑ }rÒ (h%Nh&Nh}rÓ (h]UexprhÜh ]h ]h ]h ]uh ]rÔ h2)rÕ }rÖ (h ]r× há)rØ }rÙ (h ]rÚ hBX [source]rÛ
rÜ }rÝ (hU hFjØ ubahhèhU hFjÕ h}rÞ (h]h ]h ]h ]h ]rß hëauubahhMhU hFjÑ h}rà (h]Urefidj¯ h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFj§ ubehhðhhhX# noLongerProvides(object, interface)hFj¢ ubhñ)rá }râ (h%Nh&h¯h}rã (h]h ]h ]h ]h ]uh ]rä h)rå }ræ (h%Kh&j h}rç (h]h ]h ]h ]h ]uh ]rè hBX5 Removes a directly provided interface from an object.ré
rê }rë (hX5 Removes a directly provided interface from an object.rì hFjå ubahhhhhjì hFjá ubahj; hhhU hFj¢ ubehj< hhhU hFj ubehjý hhhU hFjp jþ Kubh")rí }rî (h%Mh&hh}rï (h]rð X usagerñ ah ]rò Uid24ró ah ]h ]h ]uh ]rô (h-)rõ }rö (h%Mh&hh}r÷ (h]h ]h ]h ]h ]uh ]rø hBX Usagerù
rú }rû (hX Usagerü hFjõ ubahhRhhhjü hFjí ubh)rý }rþ (h%M h&hh}rÿ (h]h ]h ]h ]h ]uh ]r hBX& Consider the following two interfaces:r
r }r (hX& Consider the following two interfaces:r hFjý ubahhhhhj hFjí ubj )r }r (h%M h&hh}r (h]j j h ]h ]U testnodetypeX doctestUgroups]r j ah ]h ]j }uh ]r hBXl >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...r
r }r (hU hFj ubahj$ hhhXl >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...hFjí ubh)r
}r (h%M&h&hh}r (h]h ]h ]h ]h ]uh ]r (h>)r }r (h ]r hBX I1r
r }r (hU hFj ubahhGhX ``I1``hFj
h}r (h]h ]h ]h ]h ]uubhBX is provided through the class, r
r }r (hX is provided through the class, hFj
ubh>)r }r (h ]r hBX I2r
r }r (hU hFj ubahhGhX ``I2``hFj
h}r! (h]h ]h ]h ]h ]uubhBX$ is directly provided
by the object:r"
r# }r$ (hX$ is directly provided
by the object:hFj
ubehhhhhXP ``I1`` is provided through the class, ``I2`` is directly provided
by the object:hFjí ubj )r% }r& (h%M)h&hh}r' (h]j j h ]h ]U testnodetypeX doctestUgroups]r( j ah ]h ]j }uh ]r) hBXh >>> class C(object):
... implements(I1)
>>> c = C()
>>> alsoProvides(c, I2)
>>> I2.providedBy(c)
Truer*
r+ }r, (hU hFj% ubahj$ hhhXh >>> class C(object):
... implements(I1)
>>> c = C()
>>> alsoProvides(c, I2)
>>> I2.providedBy(c)
TruehFjí ubh)r- }r. (h%M2h&hh}r/ (h]h ]h ]h ]h ]uh ]r0 hBX Remove I2 from c again:r1
r2 }r3 (hX Remove I2 from c again:r4 hFj- ubahhhhhj4 hFjí ubj )r5 }r6 (h%M4h&hh}r7 (h]j j h ]h ]U testnodetypeX doctestUgroups]r8 j ah ]h ]j }uh ]r9 hBX6 >>> noLongerProvides(c, I2)
>>> I2.providedBy(c)
Falser:
r; }r< (hU hFj5 ubahj$ hhhX6 >>> noLongerProvides(c, I2)
>>> I2.providedBy(c)
FalsehFjí ubh)r= }r> (h%M:h&hh}r? (h]h ]h ]h ]h ]uh ]r@ hBXI Removing an interface that is provided through the class is not possible:rA
rB }rC (hXI Removing an interface that is provided through the class is not possible:rD hFj= ubahhhhhjD hFjí ubj )rE }rF (h%M<h&hh}rG (h]j j h ]h ]U testnodetypeX doctestUgroups]rH j ah ]h ]j }uh ]rI hBX| >>> noLongerProvides(c, I1)
Traceback (most recent call last):
...
ValueError: Can only remove directly provided interfaces.rJ
rK }rL (hU hFjE ubahj$ hhhX| >>> noLongerProvides(c, I1)
Traceback (most recent call last):
...
ValueError: Can only remove directly provided interfaces.hFjí ubehjý hhhU hFjp jþ Kubehjý hhhU hFh#ubh")rM }rN (h%MEh&hh}rO (h]h ]rP U.zope-interface-declarations-directlyprovidedbyrQ ah ]h ]rR X0 zope.interface.declarations.directlyprovidedby()rS ah ]uh ]rT (h-)rU }rV (h%MEh&hh}rW (h]h ]h ]h ]h ]uh ]rX h2)rY }rZ (h%MDh&hh}r[ (h]h6Nh ]h ]U refdomainX pyr\ h8NUreftypeX funch9X. zope.interface.declarations.directlyProvidedByh:h ]h ]U refexplicith;h<uh ]r] h>)r^ }r_ (h ]r` hBX0 zope.interface.declarations.directlyProvidedBy()ra
rb }rc (hU hFj^ ubahhGhX6 :func:`zope.interface.declarations.directlyProvidedBy`rd hFjY h}re (h]h ]h ]h ]h ]rf (hKj\ X py-funcrg euubahhMhjd hFjU ubahhRhhhjd hFjM ubh")rh }ri (h%MHh&hh}rj (h]rk X apirl ah ]rm Uid25rn ah ]h ]h ]uh ]ro (h-)rp }rq (h%MHh&hh}rr (h]h ]h ]h ]h ]uh ]rs hBX APIrt
ru }rv (hX APIrw hFjp ubahhRhhhjw hFjh ubh)rx }ry (h%Nh&X® /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.directlyProvidedByrz h}r{ (h]h ]h ]Uentries]r| (hX< directlyProvidedBy() (in module zope.interface.declarations)X. zope.interface.declarations.directlyProvidedByr} U tr~ ah ]h ]uh ]hh¡hhhU hFjh ubh¢)r }r (h%Nh&jz h}r (h]h¦X pyh ]h ]h§X functionr h©j hªh ]h ]uh ]r (h¬)r }r
(h%Nh&h¯h}r (h]h ]h ]r j} ah²h³U h ]r j} ahµh¶X zope.interface.declarationsr
r }r bh ]hºX directlyProvidedByr uh ]r (hÆ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX zope.interface.declarations.r
r }r (hU hFj ubahhÎhhhX zope.interface.declarations.hFj ubhÏ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX directlyProvidedByr
r }r (hU hFj ubahh×hhhj hFj ubj )r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r j )r }r¡ (h ]r¢ hBX objectr£
r¤ }r¥ (hU hFj ubahj$ hX objecthFj h}r¦ (h]h ]h ]h ]h ]uubahj& hhhU hFj ubhØ)r§ }r¨ (h%Nh&Nh}r© (h]UexprhÜh ]h ]h ]h ]uh ]rª h2)r« }r¬ (h ]r há)r® }r¯ (h ]r° hBX [source]r±
r² }r³ (hU hFj® ubahhèhU hFj« h}r´ (h]h ]h ]h ]h ]rµ hëauubahhMhU hFj§ h}r¶ (h]Urefidj h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFj ubehhðhhhX directlyProvidedBy(object)hFj ubhñ)r· }r¸ (h%Nh&h¯h}r¹ (h]h ]h ]h ]h ]uh ]rº (h)r» }r¼ (h%Kh&jz h}r½ (h]h ]h ]h ]h ]uh ]r¾ hBX; Return the interfaces directly provided by the given objectr¿
rÀ }rÁ (hX; Return the interfaces directly provided by the given objectr hFj» ubahhhhhj hFj· ubh)rà }rÄ (h%Kh&jz h}rÅ (h]h ]h ]h ]h ]uh ]rÆ (hBX The value returned is an rÇ
rÈ }rÉ (hX The value returned is an hFjà ubh>)rÊ }rË (h ]rÌ hBX IDeclarationrÍ
rÎ }rÏ (hU hFjÊ ubahhGhX ``IDeclaration``hFjà h}rÐ (h]h ]h ]h ]h ]uubhBX .
rÑ }rÒ (hX .hFjà ubehhhhhX* The value returned is an ``IDeclaration``.hFj· ubehj; hhhU hFj ubehj< hhhU hFjh ubehjý hhhU hFjM jþ Kubehjý hhhU hFh#ubh")rÓ }rÔ (h%MNh&hh}rÕ (h]h ]rÖ U)zope-interface-declarations-classprovidesr× ah ]h ]rØ X+ zope.interface.declarations.classprovides()rÙ ah ]uh ]rÚ (h-)rÛ }rÜ (h%MNh&hh}rÝ (h]h ]h ]h ]h ]uh ]rÞ h2)rß }rà (h%MMh&hh}rá (h]h6Nh ]h ]U refdomainX pyrâ h8NUreftypeX funch9X) zope.interface.declarations.classProvidesh:h ]h ]U refexplicith;h<uh ]rã h>)rä }rå (h ]ræ hBX+ zope.interface.declarations.classProvides()rç
rè }ré (hU hFjä ubahhGhX1 :func:`zope.interface.declarations.classProvides`rê hFjß h}rë (h]h ]h ]h ]h ]rì (hKjâ X py-funcrí euubahhMhjê hFjÛ ubahhRhhhjê hFjÓ ubh")rî }rï (h%MQh&hh}rð (h]rñ X apirò ah ]ró Uid26rô ah ]h ]h ]uh ]rõ (h-)rö }r÷ (h%MQh&hh}rø (h]h ]h ]h ]h ]uh ]rù hBX APIrú
rû }rü (hX APIrý hFjö ubahhRhhhjý hFjî ubh)rþ }rÿ (h%Nh&X© /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.classProvidesr h}r (h]h ]h ]Uentries]r (hX7 classProvides() (in module zope.interface.declarations)X) zope.interface.declarations.classProvidesr U tr ah ]h ]uh ]hh¡hhhU hFjî ubh¢)r }r (h%Nh&j h}r (h]h¦X pyh ]h ]h§X functionr h©j hªh ]h ]uh ]r (h¬)r
}r (h%Nh&h¯h}r (h]h ]h ]r
j ah²h³U h ]r j ahµh¶X zope.interface.declarationsr
r }r bh ]hºX
classProvidesr uh ]r (hÆ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX zope.interface.declarations.r
r }r (hU hFj ubahhÎhhhX zope.interface.declarations.hFj
ubhÏ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX
classProvidesr
r }r! (hU hFj ubahh×hhhj hFj
ubj )r" }r# (h%Nh&h¯h}r$ (h]h ]h ]h ]h ]uh ]r% j )r& }r' (h ]r( hBX *interfacesr)
r* }r+ (hU hFj& ubahj$ hX *interfaceshFj" h}r, (h]h ]h ]h ]h ]uubahj& hhhU hFj
ubhØ)r- }r. (h%Nh&Nh}r/ (h]UexprhÜh ]h ]h ]h ]uh ]r0 h2)r1 }r2 (h ]r3 há)r4 }r5 (h ]r6 hBX [source]r7
r8 }r9 (hU hFj4 ubahhèhU hFj1 h}r: (h]h ]h ]h ]h ]r; hëauubahhMhU hFj- h}r< (h]Urefidj h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFj
ubehhðhhhX classProvides(*interfaces)hFj ubhñ)r= }r> (h%Nh&h¯h}r? (h]h ]h ]h ]h ]uh ]r@ (h)rA }rB (h%Kh&j h}rC (h]h ]h ]h ]h ]uh ]rD hBX/ Declare interfaces provided directly by a classrE
rF }rG (hX/ Declare interfaces provided directly by a classrH hFjA ubahhhhhjH hFj= ubh)rI }rJ (h%Kh&j h}rK (h]h ]h ]h ]h ]uh ]rL hBX. This function is called in a class definition.rM
rN }rO (hX. This function is called in a class definition.rP hFjI ubahhhhhjP hFj= ubh)rQ }rR (h%Kh&j h}rS (h]h ]h ]h ]h ]uh ]rT (hBXF The arguments are one or more interfaces or interface specifications
(rU
rV }rW (hXF The arguments are one or more interfaces or interface specifications
(hFjQ ubh>)rX }rY (h ]rZ hBX IDeclarationr[
r\ }r] (hU hFjX ubahhGhX ``IDeclaration``hFjQ h}r^ (h]h ]h ]h ]h ]uubhBX
objects).r_
r` }ra (hX
objects).hFjQ ubehhhhhX` The arguments are one or more interfaces or interface specifications
(``IDeclaration`` objects).hFj= ubh)rb }rc (h%Kh&j h}rd (h]h ]h ]h ]h ]uh ]re hBX9 The given interfaces (including the interfaces in the specifications)
are used to create the class's direct-object interface specification.
An error will be raised if the module class has an direct interface
specification. In other words, it is an error to call this function more
than once in a class definition.rf
rg }rh (hX9 The given interfaces (including the interfaces in the specifications)
are used to create the class's direct-object interface specification.
An error will be raised if the module class has an direct interface
specification. In other words, it is an error to call this function more
than once in a class definition.ri hFjb ubahhhhhji hFj= ubh)rj }rk (h%Kh&j h}rl (h]h ]h ]h ]h ]uh ]rm hBXl Note that the given interfaces have nothing to do with the interfaces
implemented by instances of the class.rn
ro }rp (hXl Note that the given interfaces have nothing to do with the interfaces
implemented by instances of the class.rq hFjj ubahhhhhjq hFj= ubh)rr }rs (h%Kh&j h}rt (h]h ]h ]h ]h ]uh ]ru hBX This function is provided for convenience. It provides a more convenient
way to call directlyProvides for a class. For example:rv
rw }rx (hX This function is provided for convenience. It provides a more convenient
way to call directlyProvides for a class. For example:hFjr ubahhhhhX This function is provided for convenience. It provides a more convenient
way to call directlyProvides for a class. For example::hFj= ubj )ry }rz (h%Kh&j h}r{ (h]h ]h ]j j h ]h ]uh ]r| hBX classProvides(I1)r}
r~ }r (hU hFjy ubahj$ hhhX classProvides(I1)hFj= ubh)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r hBX is equivalent to calling:r
r
}r (hX is equivalent to calling:hFj ubahhhhhX is equivalent to calling::hFj= ubj )r }r (h%K h&j h}r (h]h ]h ]j j h ]h ]uh ]r hBX directlyProvides(theclass, I1)r
r }r (hU hFj ubahj$ hhhX directlyProvides(theclass, I1)hFj= ubh)r }r (h%Kh&j h}r (h]h ]h ]h ]h ]uh ]r hBX! after the class has been created.r
r }r (hX! after the class has been created.r hFj ubahhhhhj hFj= ubehj; hhhU hFj ubehj< hhhU hFjî ubehjý hhhU hFjÓ jþ Kubh")r }r (h%MWh&hh}r (h]r X usager ah ]r Uid27r ah ]h ]h ]uh ]r (h-)r }r (h%MWh&hh}r (h]h ]h ]h ]h ]uh ]r¡ hBX Usager¢
r£ }r¤ (hX Usager¥ hFj ubahhRhhhj¥ hFj ubh)r¦ }r§ (h%MYh&hh}r¨ (h]h ]h ]h ]h ]uh ]r© hBX For example:rª
r« }r¬ (hX For example:r hFj¦ ubahhhhhj hFj ubj )r® }r¯ (h%M[h&hh}r° (h]j j h ]h ]U testnodetypeX doctestUgroups]r± j ah ]h ]j }uh ]r² hBXu >>> from zope.interface import Interface
>>> from zope.interface.declarations import implementer
>>> class IFooFactory(Interface):
... pass
>>> class IFoo(Interface):
... pass
>>> @implementer(IFoo)
... class C(object):
... classProvides(IFooFactory)
>>> [i.getName() for i in C.__provides__]
['IFooFactory']
>>> [i.getName() for i in C().__provides__]
['IFoo']r³
r´ }rµ (hU hFj® ubahj$ hhhXu >>> from zope.interface import Interface
>>> from zope.interface.declarations import implementer
>>> class IFooFactory(Interface):
... pass
>>> class IFoo(Interface):
... pass
>>> @implementer(IFoo)
... class C(object):
... classProvides(IFooFactory)
>>> [i.getName() for i in C.__provides__]
['IFooFactory']
>>> [i.getName() for i in C().__provides__]
['IFoo']hFj ubh)r¶ }r· (h%Mkh&hh}r¸ (h]h ]h ]h ]h ]uh ]r¹ hBX Which is equivalent to:rº
r» }r¼ (hX Which is equivalent to:r½ hFj¶ ubahhhhhj½ hFj ubj )r¾ }r¿ (h%Mmh&hh}rÀ (h]j j h ]h ]U testnodetypeX doctestUgroups]rÁ j ah ]h ]j }uh ]r hBXF >>> from zope.interface import Interface
>>> class IFoo(Interface): pass
...
>>> class IFooFactory(Interface): pass
...
>>> @implementer(IFoo)
... class C(object):
... pass
>>> directlyProvides(C, IFooFactory)
>>> [i.getName() for i in C.__providedBy__]
['IFooFactory']
>>> [i.getName() for i in C().__providedBy__]
['IFoo']rÃ
rÄ }rÅ (hU hFj¾ ubahj$ hhhXF >>> from zope.interface import Interface
>>> class IFoo(Interface): pass
...
>>> class IFooFactory(Interface): pass
...
>>> @implementer(IFoo)
... class C(object):
... pass
>>> directlyProvides(C, IFooFactory)
>>> [i.getName() for i in C.__providedBy__]
['IFooFactory']
>>> [i.getName() for i in C().__providedBy__]
['IFoo']hFj ubehjý hhhU hFjÓ jþ Kubehjý hhhU hFh#ubh")rÆ }rÇ (h%Mh&hh}rÈ (h]rÉ X$ zope.interface.declarations.providerrÊ ah ]rË U$zope-interface-declarations-providerrÌ ah ]h ]h ]uh ]rÍ (h-)rÎ }rÏ (h%Mh&hh}rÐ (h]h ]h ]h ]h ]uh ]rÑ h2)rÒ }rÓ (h%M~h&hh}rÔ (h]h6Nh ]h ]U refdomainX pyrÕ h8NUreftypeX classh9X$ zope.interface.declarations.providerh:h ]h ]U refexplicith;h<uh ]rÖ h>)r× }rØ (h ]rÙ hBX$ zope.interface.declarations.providerrÚ
rÛ }rÜ (hU hFj× ubahhGhX- :class:`zope.interface.declarations.provider`rÝ hFjÒ h}rÞ (h]h ]h ]h ]h ]rß (hKjÕ X py-classrà euubahhMhjÝ hFjÎ ubahhRhhhjÝ hFjÆ ubh")rá }râ (h%Mh&hh}rã (h]rä X apirå ah ]ræ Uid28rç ah ]h ]h ]uh ]rè (h-)ré }rê (h%Mh&hh}rë (h]h ]h ]h ]h ]uh ]rì hBX APIrí
rî }rï (hX APIrð hFjé ubahhRhhhjð hFjá ubh)rñ }rò (h%Nh&X¤ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.providerró h}rô (h]h ]h ]Uentries]rõ (hX/ provider (class in zope.interface.declarations)jÊ U trö ah ]h ]uh ]hh¡hhhU hFjá ubh¢)r÷ }rø (h%Nh&jó h}rù (h]h¦X pyh ]h ]h§X classrú h©jú hªh ]h ]uh ]rû (h¬)rü }rý (h%Nh&h¯h}rþ (h]h ]h ]rÿ jÊ ah²h³U h ]r jÊ ahµh¶X zope.interface.declarationsr
r }r bh ]hºX providerr uh ]r (h½)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX class r
r }r (hU hFj ubahhÅhhhX class hFjü ubhÆ)r
}r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX zope.interface.declarations.r
r }r (hU hFj
ubahhÎhhhX zope.interface.declarations.hFjü ubhÏ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX providerr
r }r (hU hFj ubahh×hhhj hFjü ubj )r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r j )r }r (h ]r! hBX *interfacesr"
r# }r$ (hU hFj ubahj$ hX *interfaceshFj h}r% (h]h ]h ]h ]h ]uubahj& hhhU hFjü ubhØ)r& }r' (h%Nh&Nh}r( (h]UexprhÜh ]h ]h ]h ]uh ]r) h2)r* }r+ (h ]r, há)r- }r. (h ]r/ hBX [source]r0
r1 }r2 (hU hFj- ubahhèhU hFj* h}r3 (h]h ]h ]h ]h ]r4 hëauubahhMhU hFj& h}r5 (h]Urefidj h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFjü ubehhðhhhX provider(*interfaces)hFj÷ ubhñ)r6 }r7 (h%Nh&h¯h}r8 (h]h ]h ]h ]h ]uh ]r9 h)r: }r; (h%Kh&jó h}r< (h]h ]h ]h ]h ]uh ]r= hBX( Class decorator version of classProvidesr>
r? }r@ (hX( Class decorator version of classProvidesrA hFj: ubahhhhhjA hFj6 ubahj; hhhU hFj÷ ubehj< hhhU hFjá ubehjý hhhU hFjÆ jþ Kubehjý hhhU hFh#jþ Kubh")rB }rC (h%Mh&hh}rD (h]h ]rE U*zope-interface-declarations-moduleprovidesrF ah ]h ]rG X, zope.interface.declarations.moduleprovides()rH ah ]uh ]rI (h-)rJ }rK (h%Mh&hh}rL (h]h ]h ]h ]h ]uh ]rM h2)rN }rO (h%Mh&hh}rP (h]h6Nh ]h ]U refdomainX pyrQ h8NUreftypeX funch9X* zope.interface.declarations.moduleProvidesh:h ]h ]U refexplicith;h<uh ]rR h>)rS }rT (h ]rU hBX, zope.interface.declarations.moduleProvides()rV
rW }rX (hU hFjS ubahhGhX2 :func:`zope.interface.declarations.moduleProvides`rY hFjN h}rZ (h]h ]h ]h ]h ]r[ (hKjQ X py-funcr\ euubahhMhjY hFjJ ubahhRhhhjY hFjB ubh")r] }r^ (h%Mh&hh}r_ (h]r` X apira ah ]rb Uid29rc ah ]h ]h ]uh ]rd (h-)re }rf (h%Mh&hh}rg (h]h ]h ]h ]h ]uh ]rh hBX APIri
rj }rk (hX APIrl hFje ubahhRhhhjl hFj] ubh)rm }rn (h%Nh&Xª /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.moduleProvidesro h}rp (h]h ]h ]Uentries]rq (hX8 moduleProvides() (in module zope.interface.declarations)X* zope.interface.declarations.moduleProvidesrr U trs ah ]h ]uh ]hh¡hhhU hFj] ubh¢)rt }ru (h%Nh&jo h}rv (h]h¦X pyh ]h ]h§X functionrw h©jw hªh ]h ]uh ]rx (h¬)ry }rz (h%Nh&h¯h}r{ (h]h ]h ]r| jr ah²h³U h ]r} jr ahµh¶X zope.interface.declarationsr~
r }r bh ]hºX moduleProvidesr uh ]r (hÆ)r }r (h%Nh&h¯h}r
(h]h ]h ]h ]h ]uh ]r hBX zope.interface.declarations.r
r }r (hU hFj ubahhÎhhhX zope.interface.declarations.hFjy ubhÏ)r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r hBX moduleProvidesr
r }r (hU hFj ubahh×hhhj hFjy ubj )r }r (h%Nh&h¯h}r (h]h ]h ]h ]h ]uh ]r j )r }r (h ]r hBX *interfacesr
r }r (hU hFj ubahj$ hX *interfaceshFj h}r (h]h ]h ]h ]h ]uubahj& hhhU hFjy ubhØ)r }r (h%Nh&Nh}r (h]UexprhÜh ]h ]h ]h ]uh ]r h2)r }r¡ (h ]r¢ há)r£ }r¤ (h ]r¥ hBX [source]r¦
r§ }r¨ (hU hFj£ ubahhèhU hFj h}r© (h]h ]h ]h ]h ]rª hëauubahhMhU hFj h}r« (h]Urefidj h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFjy ubehhðhhhX moduleProvides(*interfaces)hFjt ubhñ)r¬ }r (h%Nh&h¯h}r® (h]h ]h ]h ]h ]uh ]r¯ (h)r° }r± (h%Kh&jo h}r² (h]h ]h ]h ]h ]uh ]r³ hBX' Declare interfaces provided by a moduler´
rµ }r¶ (hX' Declare interfaces provided by a moduler· hFj° ubahhhhhj· hFj¬ ubh)r¸ }r¹ (h%Kh&jo h}rº (h]h ]h ]h ]h ]uh ]r» hBX- This function is used in a module definition.r¼
r½ }r¾ (hX- This function is used in a module definition.r¿ hFj¸ ubahhhhhj¿ hFj¬ ubh)rÀ }rÁ (h%Kh&jo h}r (h]h ]h ]h ]h ]uh ]rà (hBXF The arguments are one or more interfaces or interface specifications
(rÄ
rÅ }rÆ (hXF The arguments are one or more interfaces or interface specifications
(hFjÀ ubh>)rÇ }rÈ (h ]rÉ hBX IDeclarationrÊ
rË }rÌ (hU hFjÇ ubahhGhX ``IDeclaration``hFjÀ h}rÍ (h]h ]h ]h ]h ]uubhBX
objects).rÎ
rÏ }rÐ (hX
objects).hFjÀ ubehhhhhX` The arguments are one or more interfaces or interface specifications
(``IDeclaration`` objects).hFj¬ ubh)rÑ }rÒ (h%Kh&jo h}rÓ (h]h ]h ]h ]h ]uh ]rÔ hBX7 The given interfaces (including the interfaces in the specifications) are
used to create the module's direct-object interface specification. An
error will be raised if the module already has an interface specification.
In other words, it is an error to call this function more than once in a
module definition.rÕ
rÖ }r× (hX7 The given interfaces (including the interfaces in the specifications) are
used to create the module's direct-object interface specification. An
error will be raised if the module already has an interface specification.
In other words, it is an error to call this function more than once in a
module definition.rØ hFjÑ ubahhhhhjØ hFj¬ ubh)rÙ }rÚ (h%Kh&jo h}rÛ (h]h ]h ]h ]h ]uh ]rÜ hBXs This function is provided for convenience. It provides a more convenient
way to call directlyProvides. For example:rÝ
rÞ }rß (hXs This function is provided for convenience. It provides a more convenient
way to call directlyProvides. For example:hFjÙ ubahhhhhXt This function is provided for convenience. It provides a more convenient
way to call directlyProvides. For example::hFj¬ ubj )rà }rá (h%Kh&jo h}râ (h]h ]h ]j j h ]h ]uh ]rã hBX moduleImplements(I1)rä
rå }ræ (hU hFjà ubahj$ hhhX moduleImplements(I1)hFj¬ ubh)rç }rè (h%Kh&jo h}ré (h]h ]h ]h ]h ]uh ]rê hBX is equivalent to:rë
rì }rí (hX is equivalent to:hFjç ubahhhhhX is equivalent to::hFj¬ ubj )rî }rï (h%Kh&jo h}rð (h]h ]h ]j j h ]h ]uh ]rñ hBX+ directlyProvides(sys.modules[__name__], I1)rò
ró }rô (hU hFjî ubahj$ hhhX+ directlyProvides(sys.modules[__name__], I1)hFj¬ ubehj; hhhU hFjt ubehj< hhhU hFj] ubehjý hhhU hFjB jþ Kubehjý hhhU hFh#ubh")rõ }rö (h%Mh&hh}r÷ (h]h ]rø U/zope-interface-declarations-objectspecificationrù ah ]h ]rú X1 zope.interface.declarations.objectspecification()rû ah ]uh ]rü (h-)rý }rþ (h%Mh&hh}rÿ (h]h ]h ]h ]h ]uh ]r h2)r }r (h%Mh&hh}r (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX funch9X/ zope.interface.declarations.ObjectSpecificationh:h ]h ]U refexplicith;h<uh ]r h>)r }r (h ]r hBX1 zope.interface.declarations.ObjectSpecification()r
r
}r (hU hFj ubahhGhX7 :func:`zope.interface.declarations.ObjectSpecification`r hFj h}r
(h]h ]h ]h ]h ]r (hKj X py-funcr euubahhMhj hFjý ubahhRhhhj hFjõ ubh")r }r (h%Mh&hh}r (h]r X apir ah ]r Uid30r ah ]h ]h ]uh ]r (h-)r }r (h%Mh&hh}r (h]h ]h ]h ]h ]uh ]r hBX APIr
r }r (hX APIr hFj ubahhRhhhj hFj ubh)r }r! (h%Nh&X¯ /home/tseaver/projects/Zope/Z3/zope.interface/.tox/docs/lib/python2.7/site-packages/zope/interface/declarations.py:docstring of zope.interface.declarations.ObjectSpecificationr" h}r# (h]h ]h ]Uentries]r$ (hX= ObjectSpecification() (in module zope.interface.declarations)X/ zope.interface.declarations.ObjectSpecificationr% U tr& ah ]h ]uh ]hh¡hhhU hFj ubh¢)r' }r( (h%Nh&j" h}r) (h]h¦X pyh ]h ]h§X functionr* h©j* hªh ]h ]uh ]r+ (h¬)r, }r- (h%Nh&h¯h}r. (h]h ]h ]r/ j% ah²h³U h ]r0 j% ahµh¶X zope.interface.declarationsr1
r2 }r3 bh ]hºX ObjectSpecificationr4 uh ]r5 (hÆ)r6 }r7 (h%Nh&h¯h}r8 (h]h ]h ]h ]h ]uh ]r9 hBX zope.interface.declarations.r:
r; }r< (hU hFj6 ubahhÎhhhX zope.interface.declarations.hFj, ubhÏ)r= }r> (h%Nh&h¯h}r? (h]h ]h ]h ]h ]uh ]r@ hBX ObjectSpecificationrA
rB }rC (hU hFj= ubahh×hhhj4 hFj, ubj )rD }rE (h%Nh&h¯h}rF (h]h ]h ]h ]h ]uh ]rG (j )rH }rI (h ]rJ hBX directrK
rL }rM (hU hFjH ubahj$ hX directhFjD h}rN (h]h ]h ]h ]h ]uubj )rO }rP (h ]rQ hBX clsrR
rS }rT (hU hFjO ubahj$ hX clshFjD h}rU (h]h ]h ]h ]h ]uubehj& hhhU hFj, ubhØ)rV }rW (h%Nh&Nh}rX (h]UexprhÜh ]h ]h ]h ]uh ]rY h2)rZ }r[ (h ]r\ há)r] }r^ (h ]r_ hBX [source]r`
ra }rb (hU hFj] ubahhèhU hFjZ h}rc (h]h ]h ]h ]h ]rd hëauubahhMhU hFjV h}re (h]Urefidj4 h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFj, ubehhðhhhX ObjectSpecification(direct, cls)hFj' ubhñ)rf }rg (h%Nh&h¯h}rh (h]h ]h ]h ]h ]uh ]ri (h)rj }rk (h%Kh&j" h}rl (h]h ]h ]h ]h ]uh ]rm hBX Provide object specificationsrn
ro }rp (hX Provide object specificationsrq hFjj ubahhhhhjq hFjf ubh)rr }rs (h%Kh&j" h}rt (h]h ]h ]h ]h ]uh ]ru hBX> These combine information for the object and for it's classes.rv
rw }rx (hX> These combine information for the object and for it's classes.ry hFjr ubahhhhhjy hFjf ubehj; hhhU hFj' ubehj< hhhU hFj ubehjý hhhU hFjõ jþ Kubh")rz }r{ (h%Mh&hh}r| (h]r} X usager~ ah ]r Uid31r ah ]h ]h ]uh ]r (h-)r }r (h%Mh&hh}r (h]h ]h ]h ]h ]uh ]r
hBX Usager
r }r (hX Usager hFj ubahhRhhhj hFjz ubh)r }r (h%Mh&hh}r (h]h ]h ]h ]h ]uh ]r hBX For example:r
r }r (hX For example:r hFj ubahhhhhj hFjz ubj )r }r (h%M¡h&hh}r (h]j j h ]h ]U testnodetypeX doctestUgroups]r j ah ]h ]j }uh ]r hBXà >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class I3(Interface): pass
...
>>> class I31(I3): pass
...
>>> class I4(Interface): pass
...
>>> class I5(Interface): pass
...
>>> class A(object):
... implements(I1)
>>> class B(object): __implemented__ = I2
...
>>> class C(A, B):
... implements(I31)
>>> c = C()
>>> directlyProvides(c, I4)
>>> [i.getName() for i in providedBy(c)]
['I4', 'I31', 'I1', 'I2']
>>> [i.getName() for i in providedBy(c).flattened()]
['I4', 'I31', 'I3', 'I1', 'I2', 'Interface']
>>> int(I1 in providedBy(c))
1
>>> int(I3 in providedBy(c))
0
>>> int(providedBy(c).extends(I3))
1
>>> int(providedBy(c).extends(I31))
1
>>> int(providedBy(c).extends(I5))
0
>>> class COnly(A, B):
... implementsOnly(I31)
>>> class D(COnly):
... implements(I5)
>>> c = D()
>>> directlyProvides(c, I4)
>>> [i.getName() for i in providedBy(c)]
['I4', 'I5', 'I31']
>>> [i.getName() for i in providedBy(c).flattened()]
['I4', 'I5', 'I31', 'I3', 'Interface']
>>> int(I1 in providedBy(c))
0
>>> int(I3 in providedBy(c))
0
>>> int(providedBy(c).extends(I3))
1
>>> int(providedBy(c).extends(I1))
0
>>> int(providedBy(c).extends(I31))
1
>>> int(providedBy(c).extends(I5))
1r
r }r (hU hFj ubahj$ hhhXà >>> from zope.interface import Interface
>>> class I1(Interface): pass
...
>>> class I2(Interface): pass
...
>>> class I3(Interface): pass
...
>>> class I31(I3): pass
...
>>> class I4(Interface): pass
...
>>> class I5(Interface): pass
...
>>> class A(object):
... implements(I1)
>>> class B(object): __implemented__ = I2
...
>>> class C(A, B):
... implements(I31)
>>> c = C()
>>> directlyProvides(c, I4)
>>> [i.getName() for i in providedBy(c)]
['I4', 'I31', 'I1', 'I2']
>>> [i.getName() for i in providedBy(c).flattened()]
['I4', 'I31', 'I3', 'I1', 'I2', 'Interface']
>>> int(I1 in providedBy(c))
1
>>> int(I3 in providedBy(c))
0
>>> int(providedBy(c).extends(I3))
1
>>> int(providedBy(c).extends(I31))
1
>>> int(providedBy(c).extends(I5))
0
>>> class COnly(A, B):
... implementsOnly(I31)
>>> class D(COnly):
... implements(I5)
>>> c = D()
>>> directlyProvides(c, I4)
>>> [i.getName() for i in providedBy(c)]
['I4', 'I5', 'I31']
>>> [i.getName() for i in providedBy(c).flattened()]
['I4', 'I5', 'I31', 'I3', 'Interface']
>>> int(I1 in providedBy(c))
0
>>> int(I3 in providedBy(c))
0
>>> int(providedBy(c).extends(I3))
1
>>> int(providedBy(c).extends(I1))
0
>>> int(providedBy(c).extends(I31))
1
>>> int(providedBy(c).extends(I5))
1hFjz ubehjý hhhU hFjõ jþ Kubehjý hhhU hFh#ubh")r }r (h%Mßh&hh}r (h]h ]r U&zope-interface-declarations-providedbyr ah ]h ]r X( zope.interface.declarations.providedby()r ah ]uh ]r¡ (h-)r¢ }r£ (h%Mßh&hh}r¤ (h]h ]h ]h ]h ]uh ]r¥ h2)r¦ }r§ (h%MÞh&hh}r¨ (h]h6Nh ]h ]U refdomainX pyr© h8NUreftypeX funch9X& zope.interface.declarations.providedByh:h ]h ]U refexplicith;h<uh ]rª h>)r« }r¬ (h ]r hBX( zope.interface.declarations.providedBy()r®
r¯ }r° (hU hFj« ubahhGhX. :func:`zope.interface.declarations.providedBy`r± hFj¦ h}r² (h]h ]h ]h ]h ]r³ (hKj© X py-funcr´ euubahhMhj± hFj¢ ubahhRhhhj± hFj ubh")rµ }r¶ (h%Mâh&hh}r· (h]r¸ X apir¹ ah ]rº Uid32r» ah ]h ]h ]uh ]r¼ (h-)r½ }r¾ (h%Mâh&hh}r¿ (h]h ]h ]h ]h ]uh ]rÀ hBX APIrÁ
r }rà (hX APIrÄ hFj½ ubahhRhhhjÄ hFjµ ubh)rÅ }rÆ (h%Nh&X3 docstring of zope.interface.declarations.providedByrÇ h}rÈ (h]h ]h ]Uentries]rÉ (hX4 providedBy() (in module zope.interface.declarations)X& zope.interface.declarations.providedByrÊ U trË ah ]h ]uh ]hh¡hhhU hFjµ ubh¢)rÌ }rÍ (h%Nh&jÇ h}rÎ (h]h¦X pyh ]h ]h§X functionrÏ h©jÏ hªh ]h ]uh ]rÐ (h¬)rÑ }rÒ (h%Nh&h¯h}rÓ (h]h ]h ]rÔ jÊ ah²h³U h ]rÕ jÊ ahµh¶X zope.interface.declarationsrÖ
r× }rØ bh ]hºX
providedByrÙ uh ]rÚ (hÆ)rÛ }rÜ (h%Nh&h¯h}rÝ (h]h ]h ]h ]h ]uh ]rÞ hBX zope.interface.declarations.rß
rà }rá (hU hFjÛ ubahhÎhhhX zope.interface.declarations.hFjÑ ubhÏ)râ }rã (h%Nh&h¯h}rä (h]h ]h ]h ]h ]uh ]rå hBX
providedByræ
rç }rè (hU hFjâ ubahh×hhhjÙ hFjÑ ubj )ré }rê (h%Nh&h¯h}rë (h]h ]h ]h ]h ]uh ]hj& hhhU hFjÑ ubehhðhhhjÙ hFjÌ ubhñ)rì }rí (h%Nh&h¯h}rî (h]h ]h ]h ]h ]uh ]rï h)rð }rñ (h%Kh&jÇ h}rò (h]h ]h ]h ]h ]uh ]ró hBX Get an object's interfacesrô
rõ }rö (hX Get an object's interfacesr÷ hFjð ubahhhhhj÷ hFjì ubahj; hhhU hFjÌ ubehj< hhhU hFjµ ubehjý hhhU hFj jþ Kubehjý hhhU hFh#ubh")rø }rù (h%Mèh&hh}rú (h]h ]rû U9zope-interface-declarations-objectspecificationdescriptorrü ah ]h ]rý X9 zope.interface.declarations.objectspecificationdescriptorrþ ah ]uh ]rÿ (h-)r }r (h%Mèh&hh}r (h]h ]h ]h ]h ]uh ]r h2)r }r (h%Mçh&hh}r (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX classh9X9 zope.interface.declarations.ObjectSpecificationDescriptorh:h ]h ]U refexplicith;h<uh ]r h>)r }r
(h ]r hBX9 zope.interface.declarations.ObjectSpecificationDescriptorr
r
}r (hU hFj ubahhGhXB :class:`zope.interface.declarations.ObjectSpecificationDescriptor`r hFj h}r (h]h ]h ]h ]h ]r (hKj X py-classr euubahhMhj hFj ubahhRhhhj hFjø ubh")r }r (h%Mëh&hh}r (h]r X apir ah ]r Uid33r ah ]h ]h ]uh ]r (h-)r }r (h%Mëh&hh}r (h]h ]h ]h ]h ]uh ]r hBX APIr
r }r! (hX APIr" hFj ubahhRhhhj" hFj ubh)r# }r$ (h%Nh&XF docstring of zope.interface.declarations.ObjectSpecificationDescriptorr% h}r& (h]h ]h ]Uentries]r' (hXD ObjectSpecificationDescriptor (class in zope.interface.declarations)X9 zope.interface.declarations.ObjectSpecificationDescriptorr( U tr) ah ]h ]uh ]hh¡hhhU hFj ubh¢)r* }r+ (h%Nh&j% h}r, (h]h¦X pyh ]h ]h§X classr- h©j- hªh ]h ]uh ]r. (h¬)r/ }r0 (h%Nh&h¯h}r1 (h]h ]h ]r2 j( ah²h³U h ]r3 j( ahµh¶X zope.interface.declarationsr4
r5 }r6 bh ]hºX ObjectSpecificationDescriptorr7 uh ]r8 (h½)r9 }r: (h%Nh&h¯h}r; (h]h ]h ]h ]h ]uh ]r< hBX class r=
r> }r? (hU hFj9 ubahhÅhhhX class hFj/ ubhÆ)r@ }rA (h%Nh&h¯h}rB (h]h ]h ]h ]h ]uh ]rC hBX zope.interface.declarations.rD
rE }rF (hU hFj@ ubahhÎhhhX zope.interface.declarations.hFj/ ubhÏ)rG }rH (h%Nh&h¯h}rI (h]h ]h ]h ]h ]uh ]rJ hBX ObjectSpecificationDescriptorrK
rL }rM (hU hFjG ubahh×hhhj7 hFj/ ubehhðhhhj7 hFj* ubhñ)rN }rO (h%Nh&h¯h}rP (h]h ]h ]h ]h ]uh ]rQ h)rR }rS (h%Kh&j% h}rT (h]h ]h ]h ]h ]uh ]rU hBX Object Specification DescriptorrV
rW }rX (hX Object Specification DescriptorrY hFjR ubahhhhhjY hFjN ubahj; hhhU hFj* ubehj< hhhU hFj ubehjý hhhU hFjø jþ Kubh")rZ }r[ (h%Mòh&hh}r\ (h]r] X usager^ ah ]r_ Uid34r` ah ]h ]h ]uh ]ra (h-)rb }rc (h%Mòh&hh}rd (h]h ]h ]h ]h ]uh ]re hBX Usagerf
rg }rh (hX Usageri hFjb ubahhRhhhji hFjZ ubh)rj }rk (h%Môh&hh}rl (h]h ]h ]h ]h ]uh ]rm hBX For example:rn
ro }rp (hX For example:rq hFjj ubahhhhhjq hFjZ ubj )rr }rs (h%Möh&hh}rt (h]j j h ]h ]U testnodetypeX doctestUgroups]ru j ah ]h ]j }uh ]rv hBX7 >>> from zope.interface import Interface
>>> class IFoo(Interface): pass
...
>>> class IFooFactory(Interface): pass
...
>>> @implementer(IFoo)
... class C(object):
... classProvides(IFooFactory)
>>> [i.getName() for i in C.__providedBy__]
['IFooFactory']
>>> [i.getName() for i in C().__providedBy__]
['IFoo']rw
rx }ry (hU hFjr ubahj$ hhhX7 >>> from zope.interface import Interface
>>> class IFoo(Interface): pass
...
>>> class IFooFactory(Interface): pass
...
>>> @implementer(IFoo)
... class C(object):
... classProvides(IFooFactory)
>>> [i.getName() for i in C.__providedBy__]
['IFooFactory']
>>> [i.getName() for i in C().__providedBy__]
['IFoo']hFjZ ubh)rz }r{ (h%Mh&hh}r| (h]h ]h ]h ]h ]uh ]r} hBXe Get an ObjectSpecification bound to either an instance or a class,
depending on how we were accessed.r~
r }r (hXe Get an ObjectSpecification bound to either an instance or a class,
depending on how we were accessed.r hFjz ubahhhhhj hFjZ ubehjý hhhU hFjø jþ Kubehjý hhhU hFh#ubh")r }r (h%M
h&hh}r (h]r
X! zope.interface.declarations.namedr ah ]r U!zope-interface-declarations-namedr ah ]h ]h ]uh ]r (h-)r }r (h%M
h&hh}r (h]h ]h ]h ]h ]uh ]r h2)r }r (h%M h&hh}r (h]h6Nh ]h ]U refdomainX pyr h8NUreftypeX classh9X! zope.interface.declarations.namedh:h ]h ]U refexplicith;h<uh ]r h>)r }r (h ]r hBX! zope.interface.declarations.namedr
r }r (hU hFj ubahhGhX* :class:`zope.interface.declarations.named`r hFj h}r (h]h ]h ]h ]h ]r (hKj X py-classr euubahhMhj hFj ubahhRhhhj hFj ubh")r }r (h%M
h&hh}r (h]r X apir¡ ah ]r¢ Uid35r£ ah ]h ]h ]uh ]r¤ (h-)r¥ }r¦ (h%M
h&hh}r§ (h]h ]h ]h ]h ]uh ]r¨ hBX APIr©
rª }r« (hX APIr¬ hFj¥ ubahhRhhhj¬ hFj ubh)r }r® (h%Nh&Nh}r¯ (h]h ]h ]Uentries]r° (hX, named (class in zope.interface.declarations)j U tr± ah ]h ]uh ]hh¡hhhU hFj ubh¢)r² }r³ (h%Nh&Nh}r´ (h]h¦X pyh ]h ]h§X classrµ h©jµ hªh ]h ]uh ]r¶ (h¬)r· }r¸ (h%Nh&h¯h}r¹ (h]h ]h ]rº j ah²h³U h ]r» j ahµh¶X zope.interface.declarationsr¼
r½ }r¾ bh ]hºX namedr¿ uh ]rÀ (h½)rÁ }r (h%Nh&h¯h}rà (h]h ]h ]h ]h ]uh ]rÄ hBX class rÅ
rÆ }rÇ (hU hFjÁ ubahhÅhhhX class hFj· ubhÆ)rÈ }rÉ (h%Nh&h¯h}rÊ (h]h ]h ]h ]h ]uh ]rË hBX zope.interface.declarations.rÌ
rÍ }rÎ (hU hFjÈ ubahhÎhhhX zope.interface.declarations.hFj· ubhÏ)rÏ }rÐ (h%Nh&h¯h}rÑ (h]h ]h ]h ]h ]uh ]rÒ hBX namedrÓ
rÔ }rÕ (hU hFjÏ ubahh×hhhj¿ hFj· ubj )rÖ }r× (h%Nh&h¯h}rØ (h]h ]h ]h ]h ]uh ]rÙ j )rÚ }rÛ (h ]rÜ hBX namerÝ
rÞ }rß (hU hFjÚ ubahj$ hX namehFjÖ h}rà (h]h ]h ]h ]h ]uubahj& hhhU hFj· ubhØ)rá }râ (h%Nh&Nh}rã (h]UexprhÜh ]h ]h ]h ]uh ]rä h2)rå }ræ (h ]rç há)rè }ré (h ]rê hBX [source]rë
rì }rí (hU hFjè ubahhèhU hFjå h}rî (h]h ]h ]h ]h ]rï hëauubahhMhU hFjá h}rð (h]Urefidj¿ h ]U refdomainhíh ]UreftypehîUrefdoch<h ]h ]U refexplicitU reftargetU$_modules/zope/interface/declarationsuubahhïhhhU hFj· ubehhðhhhX named(name)rñ hFj² ubhñ)rò }ró (h%Nh&h¯h}rô (h]h ]h ]h ]h ]uh ]hj; hhhU hFj² ubehj< hhhU hFj ubehjý hhhU hFj jþ Kubh")rõ }rö (h%Mh&hh}r÷ (h]rø X usagerù ah ]rú Uid36rû ah ]h ]h ]uh ]rü (h-)rý }rþ (h%Mh&hh}rÿ (h]h ]h ]h ]h ]uh ]r hBX Usager
r }r (hX Usager hFjý ubahhRhhhj hFjõ ubh)r }r (h%Mh&hh}r (h]h ]h ]h ]h ]uh ]r hBX For example:r
r
}r (hX For example:r hFj ubahhhhhj hFjõ ubj )r
}r (h%Mh&hh}r (h]j j h ]h ]U testnodetypeX doctestUgroups]r j ah ]h ]j }uh ]r hBX >>> from zope.interface.declarations import named
>>> @named('foo')
... class Foo(object):
... pass
>>> Foo.__component_name__
'foo'r
r }r (hU hFj
ubahj$ hhhX >>> from zope.interface.declarations import named
>>> @named('foo')
... class Foo(object):
... pass
>>> Foo.__component_name__
'foo'hFjõ ubh)r }r (h%M#h&hh}r (h]h ]h ]h ]h ]uh ]r (hBXM When registering an adapter or utility component, the registry looks for the
r
r }r (hXM When registering an adapter or utility component, the registry looks for the
hFj ubj )r }r (h ]r hBX __component_name__r
r }r! (hU hFj ubahj hX `__component_name__`hFj h}r" (h]h ]h ]h ]h ]uubhBX; attribute and uses it, if no name was explicitly
provided.r#
r$ }r% (hX; attribute and uses it, if no name was explicitly
provided.hFj ubehhhhhX When registering an adapter or utility component, the registry looks for the
`__component_name__` attribute and uses it, if no name was explicitly
provided.hFjõ ubehjý hhhU hFj jþ Kubehjý hhhU hFh#jþ Kubehjý hhhU hFhubaU citationsr& ]r' Usymbol_footnote_startr( K U
footnote_refsr) }r* Uidsr+ }r, (jæ jí j© j° j% j, jÊ jü j j jQ jM jí jô jc jj j¼ jà hhjÇ jÎ j® jµ jw j~ j; jB j» jµ j j j j jF jB j j j¶ j½ jï jö j- j4 j j© j¥ j¬ j# j jM jT j§ j® j j j
j7
j} j jz j jà jÊ jó jí jô jî jÌ jÆ j{ jw j» jµ j, j& j) j0 j j j< j7 j j jÉ jÄ j
j
j@ j: jW jQ j'
j!
jû jõ j` jZ j£ j jé jå j j j j j jz j
j
j× jÓ j} jy j j j j jñ jø jü jø jt jp ju j| jk jg jù jõ j( j/ jÇ
jÁ
h)h#j j jO jV huhoj jÿ j j
j j j
j
jÊ jÑ jW j^ j j
jB jI jE jL jû jõ j6 j0 jr jy j j j§ j¡ j"
j
jâ
jÜ
j j jT jN j j jS jM j j j6
j=
j j§ j j jn jh jÅ
j÷
j j jª j± j j§ j± j« hXhTj( j" jc j] jç já j? jF j7 j3 j j· uUsymbol_footnote_refsr- ]r. Urefnamesr/ }r0 Uautofootnote_refsr1 ]r2 Ucurrent_sourcer3 NU current_liner4 NhhU nametypesr5 }r6 (j j© j) jæ jH Nh+NjW j j¶ jO j NjB j- j jë Nj¼ j¯ Njv Njí j Njr j j NX! zope.interface.declarations.namedr7 j( jc hZNjM jÙ Nj§ jE j} NjS Nj j6
j Nj hj j j; jû Nj® ju X' zope.interface.declarations.implementerr8 j} X, zope.interface.declarations.implementer_onlyr9 jª jm Njz j9 NX$ zope.interface.declarations.providerr: jÇ j% Njà jÊ j? j
NX apir; Njñ X usager< Nj¥ jw j j% jþ Nj Njï uUtransform_messagesr= ]r> Uid_startr? K%Unameidsr@ }rA (j j j© j© j) j) jæ jæ jH jF h+h)jW jW j j j¶ j¶ jO jO j j} jB jB j- j- j j jë jé j¼ j¼ j¯ j jv jt jí jí j j jr jr j j j j j7 j j( j( jc jc hZhXjM jM jÙ j× j§ j§ jE jE j} j{ jS jQ j j j6
j6
j j j j hhj j j j j; j; jû jù j® j® ju ju j8 j
j} j} j9 jÅ
jª jª jm jk jz jz j9 j7 j: jÊ jÇ jÇ j% j# jà jà jÊ jÊ j? j? j
j
j; Njñ jñ j< Nj¥ j¥ jw jw j j j% j% jþ jü j j jï jï uU
decorationrB NUindirect_targetsrC ]rD UsettingsrE (cdocutils.frontend
Values
rF orG }rH (Uoutput_encodingrI Uutf-8rJ Udump_internalsrK NU _destinationrL NUstrip_commentsrM NU
halt_levelrN KU
strip_classesrO NUexpose_internalsrP NUauto_id_prefixrQ UidrR Urecord_dependenciesrS NU pep_base_urlrT U https://www.python.org/dev/peps/rU UdebugrV NUinput_encodingrW U utf-8-sigrX Uexit_status_levelrY KUpep_file_url_templaterZ Upep-%04dr[ Usectsubtitle_xformr\ U
sectnum_xformr] KU
language_coder^ Uenr_ Ugettext_compactr` U raw_enabledra KU report_levelrb KU
toc_backlinksrc Uentryrd U
source_urlre NU rfc_base_urlrf U https://tools.ietf.org/html/rg Uerror_encodingrh UUTF-8ri U_disable_configrj NUembed_stylesheetrk Uwarning_streamrl NUrfc_referencesrm NU
dump_settingsrn NUconfigro NU datestamprp NUpep_referencesrq NUdump_transformsrr NUenvrs NU error_encoding_error_handlerrt Ubackslashreplaceru Ufootnote_backlinksrv KU
docinfo_xformrw KU output_encoding_error_handlerrx Ustrictry Ucloak_email_addressesrz Udump_pseudo_xmlr{ NUdoctitle_xformr| U id_prefixr} U U tracebackr~ U smart_quotesr U generatorr NU trim_footnote_reference_spacer hRNU
_config_filesr ]U_sourcer hU source_linkr NU tab_widthr
KUstrict_visitorr NUstrip_elements_with_classesr NUsyntax_highlightr Ulongr Ufile_insertion_enabledr U input_encoding_error_handlerr jy ubUparse_messagesr ]r (cdocutils.nodes
system_message
r )r }r (h%K¢h&hh}r (h]UlineK¢UlevelKUsourcehh ]h ]UtypeUINFOr h ]h ]r jÉ auh ]r h)r }r (h ]r hBX& Duplicate implicit target name: "api".r
r }r (hU hFj ubahhhU hFj h}r (h]h ]h ]h ]h ]uubahUsystem_messager hhhU hFjÄ ubj )r }r (h%Kh&hh}r (h]UlineKUlevelKUsourcehh ]h ]Utypej h ]h ]r j< auh ]r¡ h)r¢ }r£ (h ]r¤ hBX( Duplicate implicit target name: "usage".r¥
r¦ }r§ (hU hFj¢ ubahhhU hFj h}r¨ (h]h ]h ]h ]h ]uubahj hhhU hFj7 ubj )r© }rª (h%KÂh&hh}r« (h]UlineKÂUlevelKUsourcehh ]h ]Utypej h ]h ]r¬ j auh ]r h)r® }r¯ (h ]r° hBX& Duplicate implicit target name: "api".r±
r² }r³ (hU hFj® ubahhhU hFj© h}r´ (h]h ]h ]h ]h ]uubahj hhhU hFj ubj )rµ }r¶ (h%KÍh&hh}r· (h]UlineKÍUlevelKUsourcehh ]h ]Utypej h ]h ]r¸ jW auh ]r¹ h)rº }r» (h ]r¼ hBX( Duplicate implicit target name: "usage".r½
r¾ }r¿ (hU hFjº ubahhhU hFjµ h}rÀ (h]h ]h ]h ]h ]uubahj hhhU hFjQ ubj )rÁ }r (h%MYh&hh}rà (h]UlineMYUlevelKUsourcehh ]h ]Utypej h ]h ]rÄ j'
auh ]rÅ h)rÆ }rÇ (h ]rÈ hBX& Duplicate implicit target name: "api".rÉ
rÊ }rË (hU hFjÆ ubahhhU hFjÁ h}rÌ (h]h ]h ]h ]h ]uubahj hhhU hFj!
ubj )rÍ }rÎ (h%M_h&hh}rÏ (h]UlineM_UlevelKUsourcehh ]h ]Utypej h ]h ]rÐ j
auh ]rÑ h)rÒ }rÓ (h ]rÔ hBX( Duplicate implicit target name: "usage".rÕ
rÖ }r× (hU hFjÒ ubahhhU hFjÍ h}rØ (h]h ]h ]h ]h ]uubahj hhhU hFj
ubj )rÙ }rÚ (h%M¤h&hh}rÛ (h]UlineM¤UlevelKUsourcehh ]h ]Utypej h ]h ]rÜ j@ auh ]rÝ h)rÞ }rß (h ]rà hBX& Duplicate implicit target name: "api".rá
râ }rã (hU hFjÞ ubahhhU hFjÙ h}rä (h]h ]h ]h ]h ]uubahj hhhU hFj: ubj )rå }ræ (h%Mªh&hh}rç (h]UlineMªUlevelKUsourcehh ]h ]Utypej h ]h ]rè j» auh ]ré h)rê }rë (h ]rì hBX( Duplicate implicit target name: "usage".rí
rî }rï (hU hFjê ubahhhU hFjå h}rð (h]h ]h ]h ]h ]uubahj hhhU hFjµ ubj )rñ }rò (h%MËh&hh}ró (h]UlineMËUlevelKUsourcehh ]h ]Utypej h ]h ]rô j, auh ]rõ h)rö }r÷ (h ]rø hBX& Duplicate implicit target name: "api".rù
rú }rû (hU hFjö ubahhhU hFjñ h}rü (h]h ]h ]h ]h ]uubahj hhhU hFj& ubj )rý }rþ (h%MÑh&hh}rÿ (h]UlineMÑUlevelKUsourcehh ]h ]Utypej h ]h ]r j§ auh ]r h)r }r (h ]r hBX( Duplicate implicit target name: "usage".r
r }r (hU hFj ubahhhU hFjý h}r (h]h ]h ]h ]h ]uubahj hhhU hFj¡ ubj )r }r
(h%M÷h&hh}r (h]UlineM÷UlevelKUsourcehh ]h ]Utypej h ]h ]r j"
auh ]r
h)r }r (h ]r hBX& Duplicate implicit target name: "api".r
r }r (hU hFj ubahhhU hFj h}r (h]h ]h ]h ]h ]uubahj hhhU hFj
ubj )r }r (h ]r h)r }r (h ]r hBXJ Duplicate implicit target name: "zope.interface.declarations.implementer".r
r }r (hU hFj ubahhhU hFj h}r (h]h ]h ]h ]h ]uubahj hU h}r (h]UlevelKUsourceh¯h ]h ]Utypej h ]h ]r j
auubj )r! }r" (h%Mh&hh}r# (h]UlineMUlevelKUsourcehh ]h ]Utypej h ]h ]r$ jâ
auh ]r% h)r& }r' (h ]r( hBX& Duplicate implicit target name: "api".r)
r* }r+ (hU hFj& ubahhhU hFj! h}r, (h]h ]h ]h ]h ]uubahj hhhU hFjÜ
ubj )r- }r. (h ]r/ h)r0 }r1 (h ]r2 hBXO Duplicate implicit target name: "zope.interface.declarations.implementer_only".r3
r4 }r5 (hU hFj0 ubahhhU hFj- h}r6 (h]h ]h ]h ]h ]uubahj hU h}r7 (h]UlevelKUsourceh¯h ]h ]Utypej h ]h ]r8 jÅ
auubj )r9 }r: (h%M
h&hh}r; (h]UlineM
UlevelKUsourcehh ]h ]Utypej h ]h ]r< j auh ]r= h)r> }r? (h ]r@ hBX& Duplicate implicit target name: "api".rA
rB }rC (hU hFj> ubahhhU hFj9 h}rD (h]h ]h ]h ]h ]uubahj hhhU hFj ubj )rE }rF (h%Mh&hh}rG (h]UlineMUlevelKUsourcehh ]h ]Utypej h ]h ]rH jT auh ]rI h)rJ }rK (h ]rL hBX& Duplicate implicit target name: "api".rM
rN }rO (hU hFjJ ubahhhU hFjE h}rP (h]h ]h ]h ]h ]uubahj hhhU hFjN ubj )rQ }rR (h%M!h&hh}rS (h]UlineM!UlevelKUsourcehh ]h ]Utypej h ]h ]rT j auh ]rU h)rV }rW (h ]rX hBX& Duplicate implicit target name: "api".rY
rZ }r[ (hU hFjV ubahhhU hFjQ h}r\ (h]h ]h ]h ]h ]uubahj hhhU hFj ubj )r] }r^ (h%M)h&hh}r_ (h]UlineM)UlevelKUsourcehh ]h ]Utypej h ]h ]r` jS auh ]ra h)rb }rc (h ]rd hBX( Duplicate implicit target name: "usage".re
rf }rg (hU hFjb ubahhhU hFj] h}rh (h]h ]h ]h ]h ]uubahj hhhU hFjM ubj )ri }rj (h%MAh&hh}rk (h]UlineMAUlevelKUsourcehh ]h ]Utypej h ]h ]rl j auh ]rm h)rn }ro (h ]rp hBX& Duplicate implicit target name: "api".rq
rr }rs (hU hFjn ubahhhU hFji h}rt (h]h ]h ]h ]h ]uubahj hhhU hFj ubj )ru }rv (h%MGh&hh}rw (h]UlineMGUlevelKUsourcehh ]h ]Utypej h ]h ]rx jû auh ]ry h)rz }r{ (h ]r| hBX( Duplicate implicit target name: "usage".r}
r~ }r (hU hFjz ubahhhU hFju h}r (h]h ]h ]h ]h ]uubahj hhhU hFjõ ubj )r }r (h%Mvh&hh}r (h]UlineMvUlevelKUsourcehh ]h ]Utypej h ]h ]r j6 auh ]r
h)r }r (h ]r hBX& Duplicate implicit target name: "api".r
r }r (hU hFj ubahhhU hFj h}r (h]h ]h ]h ]h ]uubahj hhhU hFj0 ubj )r }r (h%M|h&hh}r (h]UlineM|UlevelKUsourcehh ]h ]Utypej h ]h ]r j± auh ]r h)r }r (h ]r hBX( Duplicate implicit target name: "usage".r
r }r (hU hFj ubahhhU hFj h}r (h]h ]h ]h ]h ]uubahj hhhU hFj« ubj )r }r (h%MÐh&hh}r (h]UlineMÐUlevelKUsourcehh ]h ]Utypej h ]h ]r j auh ]r h)r }r (h ]r hBX& Duplicate implicit target name: "api".r¡
r¢ }r£ (hU hFj ubahhhU hFj h}r¤ (h]h ]h ]h ]h ]uubahj hhhU hFj§ ubj )r¥ }r¦ (h%MÖh&hh}r§ (h]UlineMÖUlevelKUsourcehh ]h ]Utypej h ]h ]r¨ j( auh ]r© h)rª }r« (h ]r¬ hBX( Duplicate implicit target name: "usage".r
r® }r¯ (hU hFjª ubahhhU hFj¥ h}r° (h]h ]h ]h ]h ]uubahj hhhU hFj" ubj )r± }r² (h%Mh&hh}r³ (h]UlineMUlevelKUsourcehh ]h ]Utypej h ]h ]r´ j auh ]rµ h)r¶ }r· (h ]r¸ hBX& Duplicate implicit target name: "api".r¹
rº }r» (hU hFj¶ ubahhhU hFj± h}r¼ (h]h ]h ]h ]h ]uubahj hhhU hFj ubj )r½ }r¾ (h%Mh&hh}r¿ (h]UlineMUlevelKUsourcehh ]h ]Utypej h ]h ]rÀ jó auh ]rÁ h)r }rà (h ]rÄ hBX( Duplicate implicit target name: "usage".rÅ
rÆ }rÇ (hU hFj ubahhhU hFj½ h}rÈ (h]h ]h ]h ]h ]uubahj hhhU hFjí ubj )rÉ }rÊ (h%MHh&hh}rË (h]UlineMHUlevelKUsourcehh ]h ]Utypej h ]h ]rÌ jn auh ]rÍ h)rÎ }rÏ (h ]rÐ hBX& Duplicate implicit target name: "api".rÑ
rÒ }rÓ (hU hFjÎ ubahhhU hFjÉ h}rÔ (h]h ]h ]h ]h ]uubahj hhhU hFjh ubj )rÕ }rÖ (h%MQh&hh}r× (h]UlineMQUlevelKUsourcehh ]h ]Utypej h ]h ]rØ jô auh ]rÙ h)rÚ }rÛ (h ]rÜ hBX& Duplicate implicit target name: "api".rÝ
rÞ }rß (hU hFjÚ ubahhhU hFjÕ h}rà (h]h ]h ]h ]h ]uubahj hhhU hFjî ubj )rá }râ (h%MWh&hh}rã (h]UlineMWUlevelKUsourcehh ]h ]Utypej h ]h ]rä j auh ]rå h)ræ }rç (h ]rè hBX( Duplicate implicit target name: "usage".ré
rê }rë (hU hFjæ ubahhhU hFjá h}rì (h]h ]h ]h ]h ]uubahj hhhU hFj ubj )rí }rî (h%Mh&hh}rï (h]UlineMUlevelKUsourcehh ]h ]Utypej h ]h ]rð jç auh ]rñ h)rò }ró (h ]rô hBX& Duplicate implicit target name: "api".rõ
rö }r÷ (hU hFjò ubahhhU hFjí h}rø (h]h ]h ]h ]h ]uubahj hhhU hFjá ubj )rù }rú (h ]rû h)rü }rý (h ]rþ hBXG Duplicate implicit target name: "zope.interface.declarations.provider".rÿ
r }r (hU hFjü ubahhhU hFjù h}r (h]h ]h ]h ]h ]uubahj hU h}r (h]UlevelKUsourceh¯h ]h ]Utypej h ]h ]r jÊ auubj )r }r (h%Mh&hh}r (h]UlineMUlevelKUsourcehh ]h ]Utypej h ]h ]r jc auh ]r h)r
}r (h ]r hBX& Duplicate implicit target name: "api".r
r }r (hU hFj
ubahhhU hFj h}r (h]h ]h ]h ]h ]uubahj hhhU hFj] ubj )r }r (h%Mh&hh}r (h]UlineMUlevelKUsourcehh ]h ]Utypej h ]h ]r j auh ]r h)r }r (h ]r hBX& Duplicate implicit target name: "api".r
r }r (hU hFj ubahhhU hFj h}r (h]h ]h ]h ]h ]uubahj hhhU hFj ubj )r }r (h%Mh&hh}r (h]UlineMUlevelKUsourcehh ]h ]Utypej h ]h ]r j auh ]r! h)r" }r# (h ]r$ hBX( Duplicate implicit target name: "usage".r%
r& }r' (hU hFj" ubahhhU hFj h}r( (h]h ]h ]h ]h ]uubahj hhhU hFjz ubj )r) }r* (h%Mâh&hh}r+ (h]UlineMâUlevelKUsourcehh ]h ]Utypej h ]h ]r, j» auh ]r- h)r. }r/ (h ]r0 hBX& Duplicate implicit target name: "api".r1
r2 }r3 (hU hFj. ubahhhU hFj) h}r4 (h]h ]h ]h ]h ]uubahj hhhU hFjµ ubj )r5 }r6 (h%Mëh&hh}r7 (h]UlineMëUlevelKUsourcehh ]h ]Utypej h ]h ]r8 j auh ]r9 h)r: }r; (h ]r< hBX& Duplicate implicit target name: "api".r=
r> }r? (hU hFj: ubahhhU hFj5 h}r@ (h]h ]h ]h ]h ]uubahj hhhU hFj ubj )rA }rB (h%Mòh&hh}rC (h]UlineMòUlevelKUsourcehh ]h ]Utypej h ]h ]rD j` auh ]rE h)rF }rG (h ]rH hBX( Duplicate implicit target name: "usage".rI
rJ }rK (hU hFjF ubahhhU hFjA h}rL (h]h ]h ]h ]h ]uubahj hhhU hFjZ ubj )rM }rN (h%M
h&hh}rO (h]UlineM
UlevelKUsourcehh ]h ]Utypej h ]h ]rP j£ auh ]rQ h)rR }rS (h ]rT hBX& Duplicate implicit target name: "api".rU
rV }rW (hU hFjR ubahhhU hFjM h}rX (h]h ]h ]h ]h ]uubahj hhhU hFj ubj )rY }rZ (h ]r[ h)r\ }r] (h ]r^ hBXD Duplicate implicit target name: "zope.interface.declarations.named".r_
r` }ra (hU hFj\ ubahhhU hFjY h}rb (h]h ]h ]h ]h ]uubahj hU h}rc (h]UlevelKUsourceh¯h ]h ]Utypej h ]h ]rd j auubj )re }rf (h%Mh&hh}rg (h]UlineMUlevelKUsourcehh ]h ]Utypej h ]h ]rh jû auh ]ri h)rj }rk (h ]rl hBX( Duplicate implicit target name: "usage".rm
rn }ro (hU hFjj ubahhhU hFje h}rp (h]h ]h ]h ]h ]uubahj hhhU hFjõ ubeub.