U jP^. @s6ddlmZddlZddlZddlZz ddlZWnek rLddlZYnXz^ddlZzddl m Z dZ Wn$ek rddlm Z dZ YnXddlm Z ddlm Z Wn.ek rZzeeeW5dZ[XYnXddlmZdd lmZdd lmZd d d dgZddgZdZddZGddde jZdS))logN)apidocFT) application) setup_command)git)options)versionautodoc_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: cCs@|D]6}|dr|dkrd|d|dd|ddf<qdS)Nz.pyz __init__.pyTz%s.%s/.)endswithreplace)argdirnamefilesfilenamer./usr/lib/python3/dist-packages/pbr/builddoc.py _find_modulesIs  rc@sTeZdZdgZdZdZddZdddZd d Zd d Z d dZ ddZ ddZ dS) LocalBuildDochtml build_sphinxFcCsj|jd}|jd}|dd\}}d|krHtj|dd|}nd|}tj|sft||S)Nrpbr api_doc_dir)NZapi source_dirz doc/source/) distributionget_option_dictgetospathjoinexistsmakedirs)self option_dictZpbr_option_dict_rr rrr_get_source_dirVs    zLocalBuildDoc._get_source_dirNc s2tdtjtji}|}|jjD].}d|kr,t |D]\}}}t |||qBq,fddt fdd| D}tj |d} t| d} | d |D]x} tj |d | } d | } d t| }t| | |d }td| t| d}|t|W5QRX| d| qW5QRXdS)Nz[pbr] Autodocumenting from %srcstfddD S)Nc3s|]}t|VqdSN)fnmatch).0Zpatmodulerr nszDLocalBuildDoc.generate_autoindex..include..)anyr1)excluded_modulesr1rincludems z1LocalBuildDoc.generate_autoindex..includec3s|]}|r|VqdSr.r)r0mod)r6rrr3qsz3LocalBuildDoc.generate_autoindex..z autoindex.rstwz.. toctree:: :maxdepth: 1 z%s.rstzThe :mod:`%s` Module=)r2heading underlinez[pbr] Generating %sz %s.rst )rinfor%r&abspathcurdirr-r"Zpackageswalkrsortedkeysr'openwritelendict _rst_template)r*r5modulesr pkgdirpathZdirnamesrZ module_listZautoindex_filenameZ autoindexr2Zoutput_filenamer:r;valuesZ output_filer)r5r6rgenerate_autoindexcs:       z LocalBuildDoc.generate_autoindexcCs:|}ddd|dg}tr&|ddt||jdS)Nz-HZModulesz-orrr)r-apidoc_use_paddinginsertrmainr )r*r cmdrrr _sphinx_trees  zLocalBuildDoc._sphinx_treec Cs^|jst}ntj}i}|jr*|j|d<|jr:|j|d<|jrJ|j|d<|jrZ|j|d<|j rrddddd g|d <t j |j |j |j|j|j|||j|jd }d |_ z|j|jd Wnttk r(}zTddlm}t||jrtjdtj|jdddtjdnW5d}~XYnX|jrZ|j j!|jj"}|j#d}t$%||dS)Nprojectrreleasetodayzapp.add_directivez app.add_rolezapp.add_generic_rolez app.add_nodezimage.nonlocal_uriZsuppress_warnings)ZfreshenvZwarningiserrorT)Z force_allr)utilszreST markup error: asciibackslashreplace index)&verbose cStringIOStringIOsysstdoutrQrrRrSsphinx_initializedrZSphinxr Z config_dirZbuilder_target_dirZ doctree_dirbuilderZ fresh_envwarning_is_errorZbuildZ all_files ExceptionZdocutilsrT isinstanceZ SystemMessageZstderrCstderrargsencodeZ link_indexZconfigZ master_docZ out_suffixZget_outfilenamer%symlink)r*Z status_streamZ confoverridesZapperrrTsrcZdstrrr _sphinx_runs\        zLocalBuildDoc._sphinx_runc Cst|jd}t|t}ttddt}|s8|rjd}|rP|dt|7}|r`|d|7}t |t rt j |dt j|dt|dd }t|d d }td s|r||r|t|d ddgd|tjtjtddk}|st d|jdgkr:t d|r:|j|_|rLtj !|S|jD]}||_||"qRdS)NrcSs t|Sr.)r%getenv)xrrrz#LocalBuildDoc.run..zThe 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)r+r r r rZ 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#setrA intersection_deprecated_optionslistfilter_deprecated_envsrwarnrZ_git_is_installedZwrite_git_changelogZgenerate_authorsrZget_boolean_optionr%rjrPrKr$splitfinalize_optionsrZSemanticVersionZfrom_pip_stringsphinx __version__buildersr_rBuildDocrunri) r*r+Z warn_optsZwarn_envmsgZ tree_indexZ auto_indexZis_multibuilder_sphinxr_rrrr}sf           zLocalBuildDoc.runcCstj|dg|_dS)Nzsetup.py)rr|initialize_optionsr )r*rrrrs z LocalBuildDoc.initialize_optionscCsddlm}tj||jd}d|dggdkrH|dd|_t |jt sh|jrh|j d|_|j |_ |j|_|j|_d}|jd }||kr|||d|_t|d sd |_dS) Nr)utilrz command liner_r!,r rr`F)rrrr|rxr"r#r$r{rbrsrwZget_namerQZ get_versionrrRZsplit_multiliner hasattrr`)r*rr+Zoptrrrrxs$         zLocalBuildDoc.finalize_options)N) __name__ __module__ __qualname__r{Z command_namer^r-rKrPrir}rrxrrrrrPs #,Gr)Z distutilsrr/r%r\rZ ImportErrorioryZ sphinx.extrrLrrraestrrrrrrrrurFrr|rrrrrs<