Your IP : 216.73.216.213
�V|# � @ s` d d l m Z d d l Z d d l Z d d l Z d d l Z d d l Z y d d l Z Wn e k
r| d d l Z Yn XyD d d l
m Z d d l
m Z d d l
m
Z
d d l
m Z Wn7 e k
r� Z z e e e � � � WYd d Z [ Xn Xd d l m Z d d l m Z d Z d
d � Z Gd d
� d
e j � Z Gd d � d e � Z d S)� )�logN)�apidoc)� application)�config)�
setup_command)�git)�optionszi%(heading)s
%(underline)s
.. automodule:: %(module)s
:members:
:undoc-members:
:show-inheritance:
c C sZ xS | D]K } | j d � r | d k r d | d | j d d � | d d � f <q Wd S) Nz.pyz __init__.pyTz%s.%s�/�.� ���)�endswith�replace)�arg�dirname�files�filename� r �=/opt/alt/python35/lib/python3.5/site-packages/pbr/builddoc.py�
_find_modules< s
r c @ sy e Z d Z d Z d d g Z d d � Z d d d � Z d d
� Z d d � Z d
d � Z d d � Z
d d � Z d S)�
LocalBuildDoc� build_sphinxZhtml�manc C sg | j j d � } d | k r> t j j | d d d � } n d } t j j | � sc t j | � | S)Nr �
source_dir� Zapizdoc/source/api)� distribution�get_option_dict�os�path�join�exists�makedirs)�self� option_dictr r r r �_get_source_dirH s
z LocalBuildDoc._get_source_dirNc s� t j d t j j t j � � i } | j � } xS | j j D]E } d | k r? x0 t j | � D] \ } } } t
| | | � qa Wq? W� f d d � � t � f d d � | j � D� � } t j j
| d � } t | d � �� }
|
j d � x� | D]� } t j j
| d
| � } d | }
d t |
� } t d
| d |
d | � } t j d | � t | d � � } | j t | � Wd QRX|
j d | � q� WWd QRXd S)Nz [pbr] Autodocumenting from %sr
c s t � f d d � � D� � S)Nc 3 s! | ] } t j � | � Vq d S)N)�fnmatch)�.0Zpat)�moduler r � <genexpr>] s zDLocalBuildDoc.generate_autoindex.<locals>.include.<locals>.<genexpr>)�any)r' )�excluded_modules)r' r �include\ s z1LocalBuildDoc.generate_autoindex.<locals>.includec 3 s! | ] } � | � r | Vq d S)Nr )r& �mod)r+ r r r( ` s z3LocalBuildDoc.generate_autoindex.<locals>.<genexpr>z
autoindex.rst�wz .. toctree::
:maxdepth: 1
z%s.rstzThe :mod:`%s` Module�=r' �heading� underlinez[pbr] Generating %sz
%s.rst
)r �infor r �abspath�curdirr$ r Zpackages�walkr �sorted�keysr �open�write�len�dict�
_rst_template)r" r* �modulesr Zpkg�dirpathZdirnamesr Z module_listZautoindex_filenameZ autoindexr' Zoutput_filenamer/ r0 �valuesZ output_filer )r* r+ r �generate_autoindexR s4 %
z LocalBuildDoc.generate_autoindexc C s< | j � } d d d d d | g } t j | | j � d S)Nr r
z-H�Modulesz-o)r$ r �main�autodoc_tree_excludes)r" r �cmdr r r � _sphinx_treeu s zLocalBuildDoc._sphinx_treec
C s' | j s t j � } n t j } i } | j r= | j | d <| j rS | j | d <| j ri | j | d <t j | j
d i g � } t j d � j } t j
| � t j
d � k r� | j t j � n
| j � | j d k r� t | j � d k r� d St j | j | j
| j | j | j | | d | j d
d �} y | j d | j � Wn� t k
r�} zp d d
l m } t | | j � r�t j! j" d � t j# j" | j$ d j% d d � � t j# j" d � n � WYd d } ~ Xn X| j& r#| j j' | j j( } | j j) d � } t* j+ | | � d S)N�version�release�todayzconf.py�sphinxz1.3.1r r ZfreshenvZwarningiserrorFZ force_all)�utilszreST markup error:
�ascii�backslashreplace�
�index),�verbose� cStringIO�StringIO�sys�stdoutrE rF rG r ZConfigZ
config_dir�
pkg_resourcesZget_distributionZ
parse_versionZ init_values�warnings�warn�builderr9 Z man_pagesr ZSphinxr Zbuilder_target_dirZ doctree_dirZ fresh_envZbuildZ all_files� ExceptionZdocutilsrI �
isinstanceZ
SystemMessageZstderr8 �stderr�args�encodeZ
link_indexZ
master_docZ
out_suffixZget_outfilenamer �symlink)
r" Z
status_streamZ
confoverridesZ
sphinx_configZ
sphinx_verZapp�errrI �srcZdstr r r � _sphinx_runz sJ
$
zLocalBuildDoc._sphinx_runc C sO | j j d � } t j � r> t j d | � t j d | � t j | d d � } t j | d d � } t j d � s� | r� | j
� | r� | j t | j
d d d g � d
j � � � x� | j D]� } | | _ | j � | j j � | _ | j j � | _ | j j � | _ t j | d d � r7| j � q� t j j | � q� Wd S)
N�pbrr# Zautodoc_tree_index_modulesZAUTODOC_TREE_INDEX_MODULESZautodoc_index_modulesZAUTODOC_INDEX_MODULESZ SPHINX_DEBUGZautodoc_exclude_modules� r Z
warnerrorsZ
WARNERRORS)r r r Z_git_is_installedZwrite_git_changelogZgenerate_authorsr Zget_boolean_optionr �getenvrD r? �set�get�split�buildersrV �finalize_optionsZget_nameZprojectZ get_versionrE rF r_ r �BuildDoc�run)r" r# Z
tree_indexZ
auto_indexrV r r r ri � s8
zLocalBuildDoc.runc C s t j j | � d g | _ d S)Nzsetup.py)r rh �initialize_optionsrB )r" r r r rj � s z LocalBuildDoc.initialize_optionsc C s� t j j | � | j j d � } d | j d g g � d k rR | d d | _ t | j t � r� | j r� | j j d � | _ d } | j j d � } | | k r� | | d | _
| j | � d S) Nr z command linerV r r �,rB r` ) r rh rg r r rd rf rX �listre rB Zensure_string_list)r" r# �optr r r rg � s z LocalBuildDoc.finalize_options) �__name__�
__module__� __qualname__� command_namerf r$ r? rD r_ ri rj rg r r r r r C s
# , " r c @ s e Z d Z d g Z d Z d S)�LocalBuildLatexZlatexZbuild_sphinx_latexN)rn ro rp rf rq r r r r rr � s rr )� distutilsr r% r rS rQ rT rO � ImportError�iorH r r r r rW �e�strr` r r r; r rh r rr r r r r �<module> s,
%
�