ó (*¿\c@`s©ddlmZmZmZddlZddlZddlZddlZddlZyddl m Z Wn!e k rddl m Z nXddl Z ddlmZddlmZddlZddlmZddlmZmZmZdd lmZejdd kr#d „Zn d „Zd Zdefd„ƒYZdeefd„ƒYZdeefd„ƒYZ defd„ƒYZ!e"e"ie"d„Z#dS(i(tdivisiontabsolute_importtprint_functionN(tCallable(tFileSystemLoader(tSandboxedEnvironment(tBuiltinTemplateLoaderi(tNumpyDocStringt FunctionDoctClassDoc(t make_xreficC`s|S(N((ts((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyttcC`s t|dƒS(Ntunicode_escape(tunicode(R ((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyR R s1\b(import +matplotlib|from +matplotlib +import)\btSphinxDocStringcB`sàeZid„Zd„Zdd„Zd„Zdd„Zd„Zd„Zd „Z d d „Z d „Z d „Z e d„Zed„ƒZd„Zd„Zd„Zd„Zd„Zd„Zd„Zddd„ZRS(cC`s'tj||d|ƒ|j|ƒdS(Ntconfig(Rt__init__t load_config(tselft docstringR((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyR scC`s|jdtƒ|_|jdtƒ|_|jdtƒ|_|jdtƒ|_|jdtƒ|_|jdtƒƒ|_ |jdt ƒƒ|_ |jddƒ|_ |j dkrtjjtjjtƒd ƒg}t|ƒ}td |ƒ}|jd ƒ|_ ndS( Nt use_plotstuse_blockquotestclass_members_toctreetattributes_as_param_listtxref_param_typet xref_aliasest xref_ignorettemplatet templatestloadersnumpydoc_docstring.rst(tgettFalseRRtTrueRRRtdictRtsetRtNoneRtostpathtjointdirnamet__file__RRt get_template(RRt template_dirsttemplate_loadert template_env((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyR$s$ t`cC`sd|dgS(Ns .. rubric:: R ((Rtnametsymbol((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt _str_header4scC`sd|dgS(Nt:((RR0((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt_str_field_list7sicC`s0g}x#|D]}|d||g7}q W|S(Nt ((Rtdoctindenttouttline((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt _str_indent:s cC`s2dgS|dr'd|dgdgSdgSdS(NR t Signatures``%s``((R((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt_str_signature@s cC`s|ddgS(NtSummaryR ((R((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt _str_summaryGscC`s|ddgS(NsExtended SummaryR ((R((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt_str_extended_summaryJstReturnscC`sDd}d}g}||r@||j|ƒ7}|dg7}x||D]ò}|j}|r€|jr€t||j|jƒ}n|jrµ||j||jjƒ|fgƒ7}n ||j||jƒgƒ7}|j sú||jdgdƒ7}n2|j r|dg7}n||j|j dƒ7}|dg7}qGWn|S(Ns **%s** : %ss%sR s..i( R4ttypeRR RRR0R:tstriptdescR(RR0t named_fmtt unnamed_fmtR8tparamt param_type((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt _str_returnsMs0       cC`s@|d dkrd|dS|d dkr8d|dS|SdS(Nis**s\*\*it*s\*((RR0((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt_escape_args_and_kwargsjs   c C`s||j|jƒƒ}d|}|s/||fSt|j|d ƒ}t|ƒpzt|tƒpztj |ƒpztj |ƒs†d }nt j |ƒ}|ož|s«||fSt|ddƒ}|rÐd|}nd}d|||f}|rrt jd|jƒdƒd}t jd d j|jƒƒƒ} | rM| jdƒjƒ}n|jd ƒd}|jd ƒ}n||fS( sDetermine how to display a parameter Emulates autosummary behavior if fake_autosummary Parameters ---------- param : str The name of the parameter desc : list of str The parameter description as given in the docstring. This is ignored when autosummary logic applies. fake_autosummary : bool If True, autosummary-style behaviour will apply for params that are attributes of the class and have a docstring. Returns ------- display_param : str The marked up parameter name for display. This may include a link to the corresponding attribute's own documentation. desc : list of str A list of description lines. This may be identical to the input ``desc``, if ``autosum is None`` or ``param`` is not a class attribute, or it will be a summary of the class attribute's docstring. Notes ----- This does not have the autosummary functionality to display a method's signature, and hence is not used to format methods. It may be complicated to incorporate autosummary's signature mangling, as it relies on Sphinx's plugin mechanism. s**%s**t_nameR s%s.s:obj:`%s <%s%s>`s\n\s*\niis^([A-Z].*?\.)(?:\s|$)R5s N(RJRBtgetattrt_objR%tcallablet isinstancetpropertytinspecttisgetsetdescriptortismemberdescriptortpydoctgetdoctretsplittsearchR(tgroupt partition( RRFRCtfake_autosummaryt display_paramt param_objtobj_doctprefixt link_prefixtm((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt_process_paramrs:"         c C`sHg}||rD||j|ƒ7}|dg7}x||D]}|j|j|j|ƒ\}}g}|r~|j|ƒn|j}|rÊ|j}|jrºt||j|j ƒ}n|j|ƒn||j dj |ƒgƒ7}|r|j r|dg7}n|sdg}n||j |dƒ7}|dg7}q;Wn|S(s†Generate RST for a listing of parameters or similar Parameter names are displayed as bold text, and descriptions are in blockquotes. Descriptions may therefore contain block markup as well. Parameters ---------- name : str Section name (e.g. Parameters) fake_autosummary : bool When True, the parameter names may correspond to attributes of the object beign documented, usually ``property`` instances on a class. In this case, names will be linked to fuller descriptions. Returns ------- rst : list of str R s : s..i( R4RbR0RCtappendRARR RRR:R(R( RR0R[R8RFR\RCtpartsRG((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt_str_param_listÁs8       cC`s0t|dƒr|jSt|dƒr,|jSdS(Nt_clst_f(thasattrRfRgR%(R((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyRMõs c C`s‚g}||r~|d|dg7}t|ddƒ}|rId|}ng}g}x·||D]«}|jd|jjƒƒ}t|j|jdƒ}t|ƒpÀt|tƒpÀt j |ƒsÌd}n|rþt j |ƒrþ|d||jfg7}q`|j |ƒq`W|rO|dg7}|jr;|dg7}n|dg|7}n|rntd tg|D]}t|jƒd ^qeƒƒ} td ƒ| td ƒtd ƒd } tdƒ| f} |dd| g7}xƒ|D]{}d|jjƒd}tdƒjd„|jDƒƒjƒ} |jrCd|j| f} n|| || fg7}qßW|| g7}n|dg7}n|S(sp Generate a member listing, autosummary:: table where possible, and a table where not. s.. rubric:: %sR RKs~%s.R0s %s%ss.. autosummary::s :toctree:iit=s i s %%%ds %%s s**R5cs`s|]}|jƒVqdS(N(RB(t.0tx((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pys *ss(%s) %sN(RLt_replaceR0RBRMR%RNRORPRQtisdatadescriptorRTRURcRtmaxtlentsixuR(RCRA( RR0R8R_tautosumtothersRFR]tptmaxlen_0thdrtfmtRC((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt_str_member_listýsL      5(  cC`sfg}||rb||j|ƒ7}tjdj||ƒƒjdƒ}||7}|dg7}n|S(Ns R (R2ttextwraptdedentR(RW(RR0R8tcontent((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt _str_section3s % cC`sRg}|drNtt|ƒj|ƒ}ddg}||j|dƒ7}n|S(NsSee Alsos .. seealso::R i(tsuperRt _str_see_alsoR:(Rt func_roleR8tsee_also((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyR}<s   cC`sGg}|drCddg}||j|dƒ7}|dg7}n|S(NtWarningss .. warning::R (R:(RR8((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt _str_warningsDs   cC`sÌ|d}g}t|ƒdkr&|S|d|jddƒg7}xu|jƒD]g\}}|dkrnqPqP|dkr—|ddj|ƒg7}qP|d |d j|ƒfg7}qPW|dg7}|S( Ntindexis .. index:: %stdefaultR trefguides single: %ss, s %s: %st,(RoR titemsR((RtidxR8tsectiont references((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt _str_indexLs   $ cC`s'g}|dr#||jdƒ7}t|dtƒrJ|dg|d™ss (R<RŠR>R?ReRHRR}R{R“R—RR"RwR#R†RtrenderR(R:RW(RR7R~tnstrendered((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyt__str__s.       (t__name__t __module__RRR2R4R:R<R>R?RHRJRbR!ReRPRMRwR{R}RRŠR“R—Rµ(((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyRs*           O 4 6     tSphinxFunctionDoccB`seZdid„ZRS(cC`s-|j|ƒtj||d|d|ƒdS(NR6R(RRR(RR˜R6R((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyR s N(R¶R·R%R(((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyR¸ŸstSphinxClassDoccB`seZddid„ZRS(c C`s3|j|ƒtj||d|ddd|ƒdS(NR6tfunc_docR(RR RR%(RR˜R6RºR((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyR¦s N(R¶R·R%R(((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyR¹¥st SphinxObjDoccB`seZdid„ZRS(cC`s0||_|j|ƒtj||d|ƒdS(NR(RgRRR(RR˜R6R((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyR¬s  N(R¶R·R%R(((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyR»«scC`sY|dkr]tj|ƒr$d}q]tj|ƒr<d}q]t|tƒrTd}q]d}ntjjtjj t ƒdƒg}|dk r¬t ƒ}|j |d|ƒn t |ƒ}td|ƒ}|jdƒ|d <|dkrt|d td |d |ƒS|dkr$t|d |d |ƒS|dkrBtj|ƒ}nt||d |ƒSdS(NtclasstmoduletfunctiontobjectRtdirsRsnumpydoc_docstring.rstRRºR6Rtmethod(R¾RÁ(R%RQtisclasstismoduleRORR&R'R(R)R*RtinitRRR+R¹R¸RTRUR»(R˜twhatR6RtbuilderR,R-R.((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pytget_doc_object²s.     $      ($t __future__RRRtsysRVRQRxRTtcollections.abcRt ImportErrort collectionsR&tjinja2Rtjinja2.sandboxRRŽtsphinx.jinja2glueRt docscrapeRRR txrefR t version_infoRpR•RR¸R¹R»R%RÇ(((s8lib/python2.7/site-packages/numpydoc/docscrape_sphinx.pyts4          ÿ