\c@sdZddlZddlZddlZddlZddlmZddlmZddl m Z m Z m Z m Z mZddlZddlmZmZddlmZddlmZmZmZdd lmZdd lmZmZdd lmZmZdd l m!Z!m"Z"dd l#m$Z$ddl#m%Z%m&Z&ddl'm(Z(ddl)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6e7rkddl8m9Z9ddlmZm:Z:m;Z;m<Z<m=Z=m>Z>m?Z?m@Z@mAZAmBZBddlCmDZDddlEmFZFddlGmHZHddlImJZJddlKmLZLddlMmNZNne$jOePZQeReRjSZTejUdejVZWdZXeYZZeYZ[dZ\dZ]eYZ^dZ_dZ`dZad eYfd!YZbd"ecd#Zdece7e7d$Zed%effd&YZgd'eYfd(YZhd)ehfd*YZid+ehfd,YZjd-ehfd.YZkd/eYfd0YZld1elfd2YZmd3elejfd4YZnd5elejfd6YZod7eofd8YZpd9ejfd:YZqd;elekfd<YZrd=emekfd>YZsd?esfd@YZtdAeffdBYZudCeYfdDYZvevZwdEZxdFZydGZzdHZ{dIZ|dS(Jsp sphinx.ext.autodoc ~~~~~~~~~~~~~~~~~~ Automatically insert docstrings for functions, classes or whole modules into the doctree, thus avoiding duplication between docstrings and documentation for those who like elaborate docstrings. :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. iN(tAny(tViewList(t iteritemst itervaluest text_typet class_typest string_types(tRemovedInSphinx20WarningtRemovedInSphinx30Warning(tExtensionError(tmockt import_objecttget_object_members(t _MockImporter(tformat_annotationt formatargspec(t_t__(tModuleAnalyzert PycodeError(tlogging(t rpartitiont force_decode(tprepare_docstring( t Signaturet isdescriptortsafe_getmemberst safe_getattrtobject_descriptiontis_builtin_class_methodtisenumattributet isclassmethodtisstaticmethodt isfunctiont isbuiltint ispartialtgetdoc(t ModuleType( RtCallabletDicttIteratortListtSequencetSettTupletTypetUnion(tnodes(tReporter(tSphinx(tConfig(tBuildEnvironment(tDocumenterBridgesQ^ ([\w.]+::)? # explicit module name ([\w.]+\.)? # module and/or class name(s) (\w+) \s* # thing name (?: \((.*)\) # optional: arguments (?:\s* -> \s* (.*))? # return annotation )? $ # and nothing more cCs|S(N((tx((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytidentityDscCs6|dkrtSg|jdD]}|j^q S(s8Used to convert the :members: option to auto directives.t,N(tNonetALLtsplittstrip(targR5((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytmembers_optionMs cCs-|dkrtStd|jdDS(s8Used to convert the :members: option to auto directives.css|]}|jVqdS(N(R;(t.0R5((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pys ZsR7N(R8R9tsetR:(R<((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytmembers_set_optionUs cCs|dkrtS|SdS(N(R8tSUPPRESS(R<((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytannotation_option`s cCstS(snUsed to convert flag options to auto directives. (Instead of directives.flag(), which returns None). (tTrue(R<((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyt bool_optioniscCsd|kr|dtk r|jdtkr4q|jdrxG|dD]*}||dkrN|dj|qNqNWq|d|dA dict/attribute hybrid that returns None on nonexisting keys.cCs1y||jddSWntk r,dSXdS(NRt-(treplacetKeyErrorR8(RQRT((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRUs (RfRgRhRU(((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRst DocumentercBs&eZdZdZdZdZdZeZie d6Z dZ e dZ ddZed Zd Zd Zd Zd ZdZdZdZdZdZdZdddZdZdZedZdZ dZ!edZ"ddeedZ#RS(se A Documenter knows how to autodocument a single object type. When registered with the AutoDirective, it will be used to document objects of that type when needed by autodoc. Its *objtype* attribute selects what auto directive it is assigned to (the directive name is 'auto' + objtype), and what directive it generates by default, though that can be overridden by an attribute called *directivetype*. A Documenter has an *option_spec* that works like a docutils directive's; in fact, it will be used to parse an auto directive's options that matches the documenter. tobjectu itnoindexcGst|jj|||S(s5getattr() override for types such as Zope interfaces.(tautodoc_attrgettertenvRk(RQRmRTtdefargs((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytget_attrscCstddS(s?Called to see if a member can be documented by this documenter.s!must be implemented in subclassesN(tNotImplementedError(tclsRIt membernametisattrtparent((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytcan_document_member$sucCs||_|j|_|j|_||_||_d|_d|_d|_ d|_ d|_ d|_ d|_ d|_d|_d|_dS(N(t directiveRtgenoptRHRTtindentR8tmodnametmoduletobjpathtfullnameR`tretannRt object_nameRtanalyzer(RQRRTR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRR*s              cCst|jjS(s%Returns registered Documenter classes(tget_documentersRRk(RQ((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyt documentersCscGs$|jjj|j|||dS(s0Append one line of generated reST to the output.N(RtresultRGR(RQRVRWtlineno((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytadd_lineIscCstddS(s@Resolve the module and name of the object to document given by the arguments and the current module/class. Must return a pair of the module name and a chain of attributes; for example, it would return ``('zipfile', ['ZipFile', 'open'])`` for the ``zipfile.ZipFile.open`` method. s!must be implemented in subclassesN(R(RQRtparentstpathtbase((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyt resolve_nameNs cCs(y+tj|jj\}}}}}Wn5tk rbtjtd|j|jft SX|dk r|d }|r|j dj dpg}n d}g}|j ||||\|_|_|jst S||_||_|jpd|jrddj|jpd|_tS(sDetermine what module to import and what attribute to document. Returns True and sets *self.modname*, *self.objpath*, *self.fullname*, *self.args* and *self.retann* if parsing and resolving was successful. s!invalid signature for auto%s (%r)it.RiN(t py_ext_sig_reRuRTtgroupstAttributeErrortloggerRcRtobjtypetFalseR8trstripR:RRRR`RtjoinRRC(RQtexplicit_modnameRRR`RRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyt parse_nameYs$ + #  '$    )c Cst|jjjyYt|j|j|jd|jd|jjj }|\|_ |_ |_ |_ tSWn5tk r}tj|jd|jjtSXWdQXdS(sImport the object given by *self.modname* and *self.objpath* and set it as *self.object*. Returns True if successful, False if an error occurred. t attrgettertwarningiserroriN(R Rtconfigtautodoc_mock_importsR RRRRtautodoc_warningiserrorRRRRRCt ImportErrorRRcR`t note_rereadR(RQtrettexc((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR }s  cCs|j|jddp|jS(sGet the real module name of an object to document. It can differ from the name of the module through which the object was imported. RgN(RRR8R(RQ((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytget_real_modnamescCsd|jjrtS|j|jdd}t|jrG|dkrGtS|r`||jkr`tStS(s`Check if *self.object* is really defined in the module given by *self.modname*. Rgt _functoolsN( RHtimported_membersRCRRR8R#RR(RQR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyt check_modules cCsdS(s}Format the argument signature of *self.object*. Should return None if the object does not have a signature. N(R8(RQ((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyt format_argsscCsdj|jp|jS(sFormat the name of *self.object*. This normally should be something that can be parsed by the generated directive, but doesn't need to be (Sphinx will display it unparsed then). R(RRR(RQ((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyt format_names cCs|jdk rd|j}nLy|j}Wn9tk rj}tjtd|j|fd}nX|j}|j j j d|j |j|j |j||}|r|\}}n|dk r||rd|pdSdSdS(sFormat the signature (arguments and return annotation) of the object. Let the user process it via the ``autodoc-process-signature`` event. s(%s)s+error while formatting arguments for %s: %ssautodoc-process-signatures -> %sRiN(R`R8Rt ExceptionRRcRRRRRktemit_firstresultRRRH(RQR`terrRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytformat_signatures"    cCst|dd}t|d|j}|j}|j}|jd||||f||jjr~|jd|n|jr|jd|j|ndS(s>Add the directive header and options to the generated content.tdomaintpyt directivetypeu.. %s:%s:: %s%su :noindex:u :module: %sN( RSRRtget_sourcenameRRHRRR(RQtsigRRRTt sourcename((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytadd_directive_headers    icCslt|j|j|jjj}t|tr@t||gSt|t rhtt |||gSgS(s;Decode and return lines of the docstring(s) for the object.( R$RRRRtautodoc_inherit_docstringst isinstanceRRtstrR(RQtencodingtignoret docstring((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytget_docs ccshxa|D]Y}|jjrJ|jjjd|j|j|j|j|nx|D] }|VqQWqWdS(s7Let the user process the docstrings before adding them.sautodoc-process-docstringN(RRktemitRRRRH(RQt docstringstdocstringlinesRV((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyt process_docs   cCsg|jr\t|jjts?t|jjtjd}n |jj}d||jfSd|jS(NRu%s:docstring of %sudocstring of %s(RRtsrcnameRtsystgetfilesystemencodingR(RQtfilename((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs   c Cs{|j}|jr|jj}|jrdj|jd |jdf}||krt}||g}x9t|j|D]\}}|j|||qWqqn|s-|jo|jj } |j | }|s|j gnx9t|j|D]\}}|j|||qWn|rwxAt |j |jD]'\}} |j|| d| dqIWndS(s>Add content from docstrings, attribute documentation and user.RiiiN(RRtfind_attr_docsRRRCRtRRRRRGtziptdataRX( RQt more_contentt no_docstringRt attr_docstkeyRRyRVRtsrc((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyt add_contents(   #  " ""cCst|j|j|j|j}|s|jjs=tgfSg}x]|jjD]O}||kr|j|||j fqPt j t d||j fqPWtt|fS|jjrttdt|DfSttdt|DfSdS(s+Return `(members_check_module, members)` where `members` is a list of `(membername, member)` pairs of the members of *self.object*. If *want_all* is True, return all members. Else, only return those members given by *self.options.members* (which may also be none). s!missing attribute %s in object %scss!|]}|j|jfVqdS(N(RTtvalue(R>tm((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pys Hscss*|] }|jr|j|jfVqdS(N(tdirectly_definedRTR(R>R((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pys JsN(R RRRRRHRERRGRRRcRRtsortedtinherited_membersR(RQtwant_allREtselectedRT((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR 2s!     cCsg}dj|j}|jr3|jj}ni}xx|D]p\}}t}t||j|jjj } |j|dd } | r|j| dd } | | krd } qnt | } t} |r{|j dr{|j dr{t|dkr{|jjtkr3|dkr3| p-|jj} q|jjr|jjtk r||jjkr| pr|jj} qn||f|kr|r|j dr|jj} nt} t}nH|r|j dr|jjo| p|jj} n| p|jj} |jjryE|jjjd|j||| |j}|d k rX| } nWqtk r}tjtd||t} qXn| r@|j|||fq@q@W|S( sFilter the given member list. Members are skipped if - they are private (except if given explicitly or the private-members option is set) - they are special methods (except if given explicitly or the special-members option is set) - they are undocumented (except if the undoc-members option is set) The user can override the skipping decision by connecting to the ``autodoc-skip-member`` event. Rt __class__RhRiRsautodoc-skip-membersWautodoc: failed to determine %r to be documented.the following exception was raised: %sN(RRRRRR$RRRRR8tboolt startswithtendswithtlenRHtspecial_membersR9t undoc_memberstprivate_membersRCRkRRRRRcRRG(RQRERRt namespaceRRRIRtdocRtcls_docthas_doctkeept skip_userR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytfilter_membersMs^    !         cs|j|jjd<|jr6|jd|jjdss::Rit groupwisecSs |djS(Ni(t member_order(te((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRstbysourcecs0|djjdd}j|tS(Nis::i(RTR:RFR(tentryR(ttagorder(s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytkeyfuncst all_memberst real_modnameRN(RRt temp_dataRRHRRER9R texclude_membersRRRRtsortRRRRGRRtautodoc_member_orderRRtgenerateRCRR8(RQRRtmembers_check_moduleRERRItmemberdocumenterstmnameRRtclassest full_mnamet documenterRR((Rs:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pytdocument_memberssF  '"$     cCs|js*tjtd|jdS|js:dS|pI|j|_y&tj |j|_ |j j Wnft k r}tj d|d|_ t|jdr|jjr|jjj|jjqnX|jjj|j j|r|jsdSn|j}|jd||j}|j||jd||j|j7_|j||j|dS(sGenerate reST for the object given by *self.name*, and possibly for its members. If *more_content* is given, include that content. If *real_modname* is given, use that module name to find attribute docs. If *check_module* is True, only generate if the object is defined in the module name it is imported from. If *all_members* is True, document all members. sdon't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)Ns$[autodoc] module analyzer failed: %st__file__u(RRRcRRTR RRRt for_moduleRRRRaR8thasattrRRRt filename_settaddRRRRRRRtcontent_indentRR(RQRRRRRRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs8           N($RfRgRhRRRRRttitles_allowedRDt option_specRt classmethodRRRtpropertyRRRRR RRRRRRR8RRRRR RRR(((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs<     $       Y DtModuleDocumentercBseZdZdZdZeZied6ed6ed6ed6ed6e d6e d 6ed 6e d 6e d 6ed 6ed6ed6ed6Z dZ e dZdZdZdZdZRS(s6 Specialized Documenter subclass for modules. RuREs undoc-membersRsinherited-memberssshow-inheritancetsynopsistplatformt deprecateds member-ordersexclude-memberssprivate-memberssspecial-memberssimported-memberssignore-module-allcGs'tt|j|t|jdS(N(tsuperRRRRJRH(RQR`((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRRHscCstS(N(R(RRIRRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRMscCs6|dk r"tjtdn|p+d|gfS(Ns*"::" in automodule name doesn't make senseRi(R8RRcR(RQRRRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRSs cCsBtj|}|js!|jr>tjtd|jn|S(Ns@signature arguments or return annotation given for automodule %s(RRR`RRRcRR(RQR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRYs cCstj|||j}|jjrE|jd|jj|n|jjrn|jd|jj|n|jjr|jd|ndS(Nu :synopsis: u :platform: u :deprecated:(RRRRHRRRR(RQRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRas    cCs=|r|jjs%t|jd r8tt|jfS|jj}t|tt f sqt d|D rt j t d||jftt|jfSn|jjpg}g}xq|D]i}y#|j|t|j|fWqtk r.t j t dt|jdd|fqXqWt|fS(Nt__all__css|]}t|tVqdS(N(RR(R>R((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pys }ssN__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__sLmissing attribute mentioned in :members: or __all__: module %s, attribute %sRfs???(RHtignore_module_allRRRCRRRtlistttupletallRRcRRRERGRRR(RQRt memberlistRR ((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR qs*    #  %(RfRgRhRRRCRR=RDR6R@RRRRRRRRR (((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR6s$    tModuleLevelDocumentercBseZdZdZRS(so Specialized Documenter subclass for objects on module level (functions, classes, data/constants). cCsk|dkrZ|r$|jd}qZ|jjjd}|sZ|jjjd}qZn|||gfS(NRsautodoc:modules py:module(R8RRRRFt ref_context(RQRRRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs (RfRgRhR(((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR$stClassLevelDocumentercBseZdZdZRS(s_ Specialized Documenter subclass for objects on class level (methods, attributes). cCs|dkr|r$|jd}nUd}|jjjd}|dkrc|jjjd}n|dkrydgfSt|d\}}|g}|s|jjjd}n|s|jjjd}qn|||gfS(NRs autodoc:classspy:classsautodoc:modules py:module(R8RRRRFR%R(RQRRRRtmod_clsR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs      (RfRgRhR(((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR&stDocstringSignatureMixincBs2eZdZddZdddZdZRS(s Mixin for FunctionDocumenter and MethodDocumenter to provide the feature of reading the signature from the docstring. c Cs&|j|}||_d}xt|D]\}}|sDq,ntj|d}|scq,n|j\}}} } } |jdg} t|t r| j dt |j dr| j d|j jDqn| | krq,ntdj|d|j|<| | f}Pq,W|S(NiiRRt__mro__css|]}|jVqdS(N(Rf(R>R((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pys ss i(Rt_new_docstringsR8RtRRuRRRtClassDocumenterRGRRtextendR)RR( RQRRRRytdoclinesRutexmodRRR`Rt valid_names((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyt_find_signatures*  #   icCs5t|dd}|dk r"|Stj|||S(NR*(RSR8RR(RQRRRn((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs cCs[|jdkrN|jjjrN|j}|dk rN|\|_|_qNntj|S(N( R`R8RRtautodoc_docstring_signatureR0RRR(RQR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs   N(RfRgRhR8R0RR(((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR(s tDocstringStripSignatureMixincBseZdZdZRS(sz Mixin for AttributeDocumenter to provide the feature of stripping any function signature from the docstring. cCsX|jdkrK|jjjrK|j}|dk rK|\}|_qKntj|S(N( R`R8RRR1R0RRR(RQRt_args((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs   (RfRgRhR(((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR2stFunctionDocumentercBs>eZdZdZdZedZdZedZ RS(s8 Specialized Documenter subclass for functions. tfunctionicCst|pt|S(N(R!R"(RRIRRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRscCst|js!tj|jr%dSyt|j rtj|j rt|j rtj|j rt|jdrt |jj j }nt |jj }Wnt k rjt |jdrt |jdrt d|jny.t |jjdtdt}|j }Wqkt k rft |jjdtdt}|j }qkXnX|jdd}|S( Nt__call__t__new__RRs%r is a builtin classt bound_methodt has_retvals\s\\(R"RtinspecttismethoddescriptorR8R!tismethodtisclassRRR6Rt TypeErrorRR7RCRRRR(RQR`R((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs,!  cCsdS(N((RQR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR=s( RfRgRhRRRRRRR(((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR4s  !R+cBseZdZdZdZi ed6ed6ed6ed6ed6ed6ed 6ed 6ed 6Z d Z e d Z dZ dZdZdZdddZedZedZddeedZRS(s6 Specialized Documenter subclass for classes. tclassiREs undoc-membersRsinherited-memberssshow-inheritances member-ordersexclude-memberssprivate-memberssspecial-memberscGs'tt|j|t|jdS(N(RR+RRRJRH(RQR`((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRRPscCs t|tS(N(RR(RRIRRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRUscCsVtj|}|rRt|jdrF|jd|jjk|_qRt|_n|S(NRfi(R$R RRRRft doc_as_attrRC(RQR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR Zs  cCs|j|jdd}|dksRt|jdsRtj|pNt| rVdSy t|dtdt j SWnt k rdSXdS(NRRR8R9( RRR8RR:R<R!RRCRRR>(RQtinitmeth((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRfs   cCs|jr dStj|S(NRi(R@R(R(RQ((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRws cCs|jrd|_ntj|||j r|jjr|j}|jd|t|j drt |j j rg|j j D]8}|j d krd|j pd|j |j f^q}|jdtd d j||qndS( Nt attributeut __bases__t __builtin__tbuiltinsu :class:`%s`u:class:`%s.%s`u u Bases: %ss, (RDRE(R@RRRRHtshow_inheritanceRRRRRRCRgRfRR(RQRRtbtbases((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR~s   $H ic Cst|dd}|dk r"|S|jjj}g}|j|jdd}|re|j|n|dkrq|j|j|jddd}|dk r|tjj ks|j tjj krd}n|s@|j|j|jddd}|dk r@|tj j ks4|j tj j kr@d}q@n|rq|dkr^|g}qn|j|qqng}xg|D]_} t | t r|jt| |q~t | tr~|jtt| ||q~q~W|S(NR*RhtbothtinitRRR7(RIRJ(RSR8RRtautoclass_contentRRRGRRRhR;R7RRRRR( RQRRRntcontentRt attrdocstringt initdocstringRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRsD         cCs|jrt|jdd}|s<t|jdd}n|rt|jdd}t|jdd}|r||krt|dt|}nttd|gdd}tj ||dt qntj ||dS( Nt __qualname__RfRgu.salias of :class:`%s`RWRiR( R@RRR8RRRRR$RRC(RQRRt classnameRt parentmoduleRL((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs  cCs!|jr dStj||dS(N(R@R$R(RQR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs cCs%tt|jd|d|d|S(NRRR(RR+R(RQRRRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRsN(RfRgRhRRR=RDR6R@RRRRRR RRRR8RRRRR(((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyR+Bs(    .  tExceptionDocumentercBs/eZdZdZdZdZedZRS(s> Specialized ClassDocumenter subclass for exceptions. t exceptioni cCst|tot|tS(N(RRt issubclasst BaseException(RRIRRR((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRs(RfRgRhRRRRR(((s:lib/python2.7/site-packages/sphinx/ext/autodoc/__init__.pyRRs tDataDocumentercBsfeZdZdZdZdZeejZe ed s    ( XF        6& 6\!52*7R