(*\c@`sfdZddlmZmZmZddlZddlZddlZddlZyddl m Z Wn!e k rddl m Z nXddl Z ddlZddlmZmZmZmZmZddlZddlmZmZddlmZejdkred nd d lmad d lm Z d d l!mZej"e#Z$ej%ddkrxdZ&n dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.tdZ/dZ0ddl1m2Z2ddl3m4Z4ddl5m6Z6de7fdYZ8d e8e6fd!YZ9d"e8e4fd#YZ:d$Z;d%Z<dS(&sk ======== numpydoc ======== Sphinx extension that handles docstrings in the Numpy standard format. [1] It will: - Convert Parameters etc. sections to field lists. - Convert See Also section to a See also entry. - Renumber references. - Extract the signature from the docstring, if it can't be determined otherwise. .. [1] https://github.com/numpy/numpydoc i(tdivisiontabsolute_importtprint_functionN(tCallable(tcitationtTexttsectiontcommentt reference(t pending_xreft desc_content(tloggings1.0.1s!Sphinx 1.0.1 or newer is requiredi(tget_doc_object(t DEFAULT_LINKS(t __version__icC`s|S(N((ts((s0lib/python2.7/site-packages/numpydoc/numpydoc.pyt/tcC`s t|dS(Ntunicode_escape(tunicode(R((s0lib/python2.7/site-packages/numpydoc/numpydoc.pyR1Ri cC`sHt}xa|D]Y}|j}tjtd|jj|tj}|r|j|j dqqW|rDt j } | j |j dd| jt } x|D]} | d| } xvt|D]h\} }|| jtd| td| || <|| jtd| td| || tcopy( R)tdocRHt label_nodeR3t_t new_labeltnew_texttid_trefRQt xref_node((RPs0lib/python2.7/site-packages/numpydoc/numpydoc.pytrelabel_referencesns  "   "cC`st}x?|jtdtD](}x|dD]}|j|q0WqWxJ|jtdtD]3}g|dD]}||krr|^qr|d>> lines = ['', 'A', '', 'B', ' ', '', 'C', 'D'] >>> lines_old = ['a', '', '', 'b', '', 'c'] >>> items_old = [('file1.py', 0), ('file1.py', 1), ('file1.py', 2), ... ('file2.py', 0), ('file2.py', 1), ('file2.py', 2)] >>> content_old = ViewList(lines_old, items=items_old) >>> match_items(lines, content_old) # doctest: +NORMALIZE_WHITESPACE [('file1.py', 0), ('file1.py', 0), ('file2.py', 0), ('file2.py', 0), ('file2.py', 2), ('file2.py', 2), ('file2.py', 2), ('file2.py', 2)] >>> # first 2 ``lines`` are matched to 'a', second 2 to 'b', rest to 'c' >>> # actual content is completely ignored. Notes ----- The algorithm tries to match any line in ``lines`` with one in ``lines_old``. It skips over all empty lines in ``lines_old`` and assigns this line number to all lines in ``lines``, unless a non-empty line is found in ``lines`` in which case it goes to the next line in ``lines_old``. ii(tdataRR'RSRtappendRT(R.t content_oldt items_newt lines_oldt items_oldtjR6R0((s0lib/python2.7/site-packages/numpydoc/numpydoc.pyt match_items9s(  *"c`s#dffdY}|S(Nt directivec`seZfdZRS(c`s|jjjj}d}|jrRtjd|jd}|jdj }n|sh|jd}nt |j }t |j |dd||j rt||j }t|d|d|j j|_ nj|S(Ns^(.*\s+)?(.*?)(\(.*)?iiRR>(tstatetdocumenttsettingstenvR?t argumentsRRR RRtcontentRR)RRR>trun(RRR+R1R.R(tbase_directiveR(s0lib/python2.7/site-packages/numpydoc/numpydoc.pyRss  (RnRoR((RR(s0lib/python2.7/site-packages/numpydoc/numpydoc.pyRrs((RRR((RRs0lib/python2.7/site-packages/numpydoc/numpydoc.pyRqs(=Rt __future__RRRRRRRtcollections.abcRt ImportErrort collectionsR!RAtdocutils.nodesRRRRRtsphinxtsphinx.addnodesR R t sphinx.utilR Rt RuntimeErrortdocscrape_sphinxR txrefR Rt getLoggerRnRRRR&R7RMR_RbRGRRRRtdocutils.statemachineRtsphinx.domains.cRtsphinx.domains.pythonRRRRRRR(((s0lib/python2.7/site-packages/numpydoc/numpydoc.pytsT       (        6  #   8