Your IP : 216.73.216.172
U
jP�^�. �
@ s6 d dl mZ d dlZd dlZd dlZz d dlZW n ek
rL d dlZY nX z^d dlZzd dl m
Z
dZ W n$ ek
r� d dlm
Z
dZ Y nX d dlm Z d dlm
Z
W n. ek
r� Z zeee���W 5 dZ[X Y nX d dlmZ d d lmZ d d
lmZ d d d
dgZddgZdZdd� ZG dd� de
j�ZdS )� )�logN)�apidocFT)� application)�
setup_command)�git)�options)�version�autodoc_tree_index_modules�autodoc_index_modules�autodoc_tree_excludes�autodoc_exclude_modules�AUTODOC_TREE_INDEX_MODULES�AUTODOC_INDEX_MODULESzi%(heading)s
%(underline)s
.. automodule:: %(module)s
:members:
:undoc-members:
:show-inheritance:
c C s@ |D ]6}|� d�r|dkrd| d|�dd�|d d� f < qd S )Nz.pyz __init__.pyTz%s.%s�/�.���)�endswith�replace)�arg�dirname�files�filename� r �./usr/lib/python3/dist-packages/pbr/builddoc.py�
_find_modulesI s �
�r c @ sT e Zd ZdgZdZdZdd� Zddd�Zd d
� Zd d � Z d
d� Z
dd� Z dd� Z dS )�
LocalBuildDoc�html� build_sphinxFc C sj | j �d�}| j �d�}|�dd�\}}d|krHtj�|d d |�}nd| }tj�|�sft�|� |S )Nr �pbr� api_doc_dir)NZapi�
source_dir� z doc/source/)� distribution�get_option_dict�get�os�path�join�exists�makedirs)�self� option_dictZpbr_option_dict�_r r r r r �_get_source_dirV s �
z LocalBuildDoc._get_source_dirNc s2 t �dtj�tj� � i }| �� }| jjD ].}d|kr,t� |�D ]\}}}t
|||� qBq,� fdd��t �fdd�|� � D ��}tj�
|d�} t| d���}
|
�d � |D ]x} tj�
|d
| �} d | }
d t|
� }t| |
|d
�}t �d| � t| d��}|�t| � W 5 Q R X |
�d| � q�W 5 Q R X d S )Nz [pbr] Autodocumenting from %sr c s t � fdd��D �� S )Nc 3 s | ]}t � � |�V qd S �N)�fnmatch)�.0Zpat��moduler r � <genexpr>n s �zDLocalBuildDoc.generate_autoindex.<locals>.include.<locals>.<genexpr>)�anyr1 )�excluded_modulesr1 r �includem s �z1LocalBuildDoc.generate_autoindex.<locals>.includec 3 s | ]}� |�r|V qd S r. r )r0 �mod)r6 r r r3 q s z3LocalBuildDoc.generate_autoindex.<locals>.<genexpr>z
autoindex.rst�wz .. toctree::
:maxdepth: 1
z%s.rstzThe :mod:`%s` Module�=)r2 �heading� underlinez[pbr] Generating %sz
%s.rst
)r �infor% r& �abspath�curdirr- r" Zpackages�walkr �sorted�keysr' �open�write�len�dict�
_rst_template)r* r5 �modulesr �pkg�dirpathZdirnamesr Z module_listZautoindex_filenameZ autoindexr2 Zoutput_filenamer: r; �valuesZ output_filer )r5 r6 r �generate_autoindexc s: �
� �� z LocalBuildDoc.generate_autoindexc C s: | � � }ddd|dg}tr&|�dd� t�|| j � d S )Nz-HZModulesz-or r r )r- �apidoc_use_padding�insertr �mainr )r* r �cmdr r r � _sphinx_tree� s
zLocalBuildDoc._sphinx_treec C s^ | j st�� }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
� W nt tk
�r( } zTddlm} t||j��rtj�d� tj �|j d � dd�� tj �d� n� W 5 d }~X Y nX | j �rZ|j j!|jj" }|j�#d�}t$�%||� d S )N�projectr �release�todayzapp.add_directivez app.add_rolezapp.add_generic_rolez app.add_nodezimage.nonlocal_uriZsuppress_warnings)ZfreshenvZwarningiserrorT)Z force_allr )�utilszreST markup error:
�ascii�backslashreplace�
�index)&�verbose� cStringIO�StringIO�sys�stdoutrQ r rR rS �sphinx_initializedr ZSphinxr Z
config_dirZbuilder_target_dirZ doctree_dir�builderZ fresh_env�warning_is_errorZbuildZ all_files� ExceptionZdocutilsrT �
isinstanceZ
SystemMessageZstderrC �stderr�args�encodeZ
link_indexZconfigZ
master_docZ
out_suffixZget_outfilenamer% �symlink)r* Z
status_streamZ
confoverridesZapp�errrT �srcZdstr r r � _sphinx_run� s\
� � � zLocalBuildDoc._sphinx_runc C st | j �d�}t|�� ��t�}ttdd� t��}|s8|rjd}|rP|dt|� 7 }|r`|d| 7 }t �
|� t � � r�t j
|d� t j|d� t�|dd �}t�|d
d �}t�d �s�|r�| �� |r�| �t|�d
d dg�d �� �� | �� tj�tj �t�dd�k}|�st �
d� | j dgk�r:t �
d� |�r:| j | _ |�rLt j �!| �S | j D ] }|| _ | �� | �"� �qRd S )Nr c S s
t �| �S r. )r% �getenv)�xr r r �<lambda>� � z#LocalBuildDoc.run.<locals>.<lambda>z�The 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
r Z SPHINX_DEBUGr � r! � zQ[pbr] Support for Sphinx < 1.6 will be dropped in pbr 4.0. Upgrade to Sphinx 1.6+r a' [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_options�list�filter�_deprecated_envsr �warnr Z_git_is_installedZwrite_git_changelogZgenerate_authorsr Zget_boolean_optionr% rj rP rK r$ �split�finalize_optionsr ZSemanticVersionZfrom_pip_string�sphinx� __version__�buildersr_ r �BuildDoc�runri ) r* r+ Z warn_optsZwarn_env�msgZ
tree_indexZ
auto_indexZis_multibuilder_sphinxr_ r r r r} � sf
��
����
�
zLocalBuildDoc.runc C s t j�| � dg| _d S )Nzsetup.py)r r| �initialize_optionsr )r* r r r r s z LocalBuildDoc.initialize_optionsc C s� ddl m} tj�| � | j�d�}d|�dg g�d krH|d d | _t | jt
�sh| jrh| j� d�| _| j� � | _
| j�� | _| j�� | _d}| j�d �}||kr�|�|| d �| _t| d
�s�d | _d S ) Nr )�utilr z command liner_ r! �,r r r` F)r r� r r| rx r" r# r$ r{ rb rs rw Zget_namerQ Z get_versionr rR Zsplit_multiliner �hasattrr` )r* r� r+ Zoptr r r rx s$
�
z LocalBuildDoc.finalize_options)N)
�__name__�
__module__� __qualname__r{ Z command_namer^ r- rK rP ri r} r rx r r r r r P s
#,Gr )Z distutilsr r/ r% r\ rZ � ImportError�iory Z
sphinx.extr rL r r ra �e�strr r r r rr ru rF r r| r r r r r �<module> s<
�