c.HddlmZddlZddlZddlZ ddlZ ddlZ ddl m Z dZ ddlm Z ddlm Z ddlmZdd lmZdd lmZgd Zd d gZdZdZGdde j2Zy#e$rddlZYZwxYw#e$r ddlm Z dZ Y_wxYw#e$rZeeedZ[wwxYw))logN)apidocFT) application) setup_command)git)options)version)autodoc_tree_index_modulesautodoc_index_modulesautodoc_tree_excludesautodoc_exclude_modulesAUTODOC_TREE_INDEX_MODULESAUTODOC_INDEX_MODULESzi%(heading)s %(underline)s .. automodule:: %(module)s :members: :undoc-members: :show-inheritance: c||D]7}|jds|dk7sd||jddd|dd<9y)Nz.pyz __init__.pyT/.)endswithreplace)argdirnamefilesfilenames ./usr/lib/python3/dist-packages/pbr/builddoc.py _find_modulesrIsN2   U #M(A-1 7??34#CR=* +2cFeZdZdgZdZdZdZd dZdZdZ d Z d Z d Z y) LocalBuildDochtml build_sphinxFcd|jjd}|jjd}|jdd\}}d|vr'tjj |dd|}nd|z}tjj |stj||S)Nr pbr api_doc_dir)Napi source_dirz doc/source/) distributionget_option_dictgetospathjoinexistsmakedirs)self option_dictpbr_option_dict_r#r%s r_get_source_dirzLocalBuildDoc._get_source_dirVs''77G ++;;EB(,,]MJ; ; &k,&?&B&13J'4Jww~~j) KK #rNctjdtjj tj zi}|j }|jjD]2}d|vstj|D]\}}}t|||4fdtfd|jD}tjj|d} t| d5} | jd|D]} tjj|d| z} d | z} d t!| z}t#| | | }tjd | zt| d5}|jt$|zddd| jd | z dddy#1swY)xYw#1swYyxYw)Nz[pbr] Autodocumenting from %src0tfdD S)Nc3JK|]}tj|ywN)fnmatch).0patmodules r zDLocalBuildDoc.generate_autoindex..include..ns$8"#??6378s #)any)r;excluded_moduless`rincludez1LocalBuildDoc.generate_autoindex..includems"8&6888 8rc34K|]}|s |ywr7)r9modr?s rr<z3LocalBuildDoc.generate_autoindex..qsKSgclSKs z autoindex.rstwz.. toctree:: :maxdepth: 1 z%s.rstzThe :mod:`%s` Module=)r;heading underlinez[pbr] Generating %sz %s.rst )rinfor*r+abspathcurdirr3r'packageswalkrsortedkeysr,openwritelendict _rst_template)r/r>modulesr%pkgdirpathdirnamesr module_listautoindex_filename autoindexr;output_filenamerErFvalues output_filer?s ` @rgenerate_autoindexz LocalBuildDoc.generate_autoindexcs 077??299-. /))+ $$-- ;C#~02 ;,GXu!'7E:; ;  8KGLLNKK WW\\*oF $c * 8i OO & 8"$'',,z/7&/@#B069#g,. VW(13.*+,/3/>;%%mf&<=>  67 8  8 8>> 8 8s%6A?G5F6G6F? ;GG c|j}ddd|dg}tr|jddtj||j zy)Nz-HModulesz-orrr)r3apidoc_use_paddinginsertrmainr )r/r%cmds r _sphinx_treezLocalBuildDoc._sphinx_treesH))+ Yj#6  JJq( # C$4445rc |jstj}ntj}i}|j r|j |d<|j r|j |d<|jr|j|d<|jr|j|d<|jrgd|d<tj|j|j|j|j|j |||j"|j$ }d|_ |j'|j( |j>r_|j@jB|j jDz}|j jGd}tIjJ||yy#t*$r}d d lm}t1||j2r{tj4j7d tj8j7|j:d j=d dtj8j7dnYd}~d}~wwxYw)Nprojectr releasetoday)zapp.add_directivez app.add_rolezapp.add_generic_rolez app.add_nodezimage.nonlocal_urisuppress_warnings)freshenvwarningiserrorT) force_allr)utilszreST markup error: asciibackslashreplace index)&verbose cStringIOStringIOsysstdoutrfr rgrhsphinx_initializedrSphinxr% config_dirbuilder_target_dir doctree_dirbuilder fresh_envwarning_is_errorbuild all_files Exceptiondocutilsrm isinstance SystemMessagestderrOstderrargsencode link_indexconfig master_doc out_suffixget_outfilenamer*symlink)r/ status_stream confoverridesapperrrmsrcdsts r _sphinx_runzLocalBuildDoc._sphinx_runs||%..0MJJM <<'+||M) $ <<'+||M) $ <<'+||M) $ ::%)ZZM' "  " "2M- .   OOT__  # #T%5%5 LL-^^D4I4I K #'  III / ??**''#++*@*@@C++--g6C JJsC    &#u223  67   !!3!3G4F"HI   &'  sF'' I0BIIc |jjd}t|jj t }t tdt}|s|r4d}|r|dt |zz }|r|d|zz }tj|tjr,tj|tj|tj |dd}tj |d d }t#j$d sQ|r|j'|r=|j)t|j+d dd gdj-|j/t0j2j5t6j8t1j2ddk\}|stjd|j:dgk7r(tjd|r|j:|_|rt>j@jC|S|j:D])}||_|j/|jE+y)Nr"c,tj|Sr7)r*getenv)xs rz#LocalBuildDoc.run..s1rzThe autodoc and autodoc_tree features are deprecated in 4.2 and will be removed in a future release. You should use the sphinxcontrib-apidoc Sphinx extension instead. Refer to the pbr documentation for more information.z Deprecated options: %sz% Deprecated environment variables: %s)r0r rr r SPHINX_DEBUGr r&zQ[pbr] Support for Sphinx < 1.6 will be dropped in pbr 4.0. Upgrade to Sphinx 1.6+ra'[pbr] Sphinx 1.6 added native support for specifying multiple builders in the '[sphinx_build] builder' configuration option, found in 'setup.cfg'. As a result, the '[sphinx_build] builders' option has been deprecated and will be removed in pbr 4.0. Migrate to the 'builder' configuration option.)#r'r(setrM intersection_deprecated_optionslistfilter_deprecated_envsrwarnr_git_is_installedwrite_git_changeloggenerate_authorsrget_boolean_optionr*rrdr]r)splitfinalize_optionsr SemanticVersionfrom_pip_stringsphinx __version__buildersr|rBuildDocrunr) r/r0 warn_optswarn_envmsg tree_index auto_indexis_multibuilder_sphinxr|s rrzLocalBuildDoc.runs!''77>  ((*+889LM 57GHI JC04 ?BB>II HHSM  "  # # <  [ 9// 0L0LN // 0G0GI yy(!!#'' 1r $$%'',uw01 !(!8!8!H!H   " #*#:#:1a#@"A& HH7 8 ==VH $ HH> ?&#}} ! ))--d3 3}} G"DL  ! ! #     rcRtjj|dg|_y)Nzsetup.py)rrinitialize_optionsr )r/s rrz LocalBuildDoc.initialize_optionss"11$7'1\"rcddlm}tjj ||j j d}d|jdggdvr |dd|_t|jts,|jr |jjd|_|j j|_ |j j|_|j j|_d}|j j d }||vr|j#||d|_t'|d sd |_yy) Nr)utilr z command liner|r&,r r"r~F)r"rrrrr'r(r)rrrrget_namerf get_versionr rgsplit_multiliner hasattrr~)r/rr0opts rrzLocalBuildDoc.finalize_optionss) //5''77G [__Y=a@ @' 215DM$--.4== MM//4DM((113 ((446 ((446 &''77> + )-)=)=C #*%D &t/0$)D !1rr7) __name__ __module__ __qualname__r command_namerwr3r]rdrrrrrArrrrPs;xH!L !8F6*!XEN2*rr) distutilsrr8r*rurs ImportErrorior sphinx.extrr`rrrestrr"rrr rrrRrrrrArrrs" "%"#$K02IJ 2T*M**T*q "!!"   c!f  sJA'B A6 B ' A32A36 BB BB B!BB!