Your IP : 216.73.216.213
B
�V|# �
@ s d dl mZ d dlZd dlZd dlZd dlZd dlZy d dlZW n ek
r\ d dl ZY nX y4d dl
m Z d dl
m Z d dl
m
Z
d dl
mZ W n. ek
r� Z zeee���W ddZ[X Y nX d dlmZ d dlmZ d Zd
d � ZG d d
� d
ej�ZG dd� de�ZdS )� )�logN)�apidoc)� application)�config)�
setup_command)�git)�optionszi%(heading)s
%(underline)s
.. automodule:: %(module)s
:members:
:undoc-members:
:show-inheritance:
c C sD x>|D ]6}|� d�r|dkrd| d|�dd�|d d� f < qW d S )Nz.pyz __init__.pyTz%s.%s�/�.���)�endswith�replace)�arg�dirname�files�filename� r �=/opt/alt/python37/lib/python3.7/site-packages/pbr/builddoc.py�
_find_modules< s
r c @ sR e Zd ZdZddgZdd� Zddd�Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dS )�
LocalBuildDoc� build_sphinx�html�manc C sJ | j �d�}d|kr,tj�|d d d�}nd}tj�|�sFt�|� |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 �dtj�tj� � i }| �� }x>| jjD ]2}d|kr.x$t� |�D ]\}}}t
|||� qFW q.W � fdd��t �fdd�|� � D ��}tj�
|d�} t| d���}
|
�d � x�|D ]x} tj�
|d
| �} d | }
d t|
� }t| |
|d
�}t �d| � t| d��}|�t| � W d Q R X |
�d| � q�W W d 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)�.0�pat)�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|V qd 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 �packages�walkr �sorted�keysr �open�write�len�dict�
_rst_template)r" r+ �modulesr �pkg�dirpath�dirnamesr Z module_listZautoindex_filenameZ autoindexr( �output_filenamer0 r1 �values� output_filer )r+ r, r �generate_autoindexR s4
z LocalBuildDoc.generate_autoindexc C s, | � � }ddddd|g}t�|| 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 st�� }ntj}i }| jr*| j|d< | jr:| j|d< | jrJ| j|d< t� | j
di g �}t � d�j}t �
|�t �
d�kr�|�tj� n|�� | jdkr�t|j�dkr�d S tj| j| j
| j| j| j||| jd d
� }y|j| jd � W nt t k
�r\ } zTdd l m } t ||j ��rJtj!�"d
� tj#�"|j$d �%dd�� tj#�"d� n� W d d }~X Y nX | j&�r�|jj'|jj( }|j�)d�} t*�+|| � d S )N�version�release�todayzconf.py�sphinxz1.3.1r r F)ZfreshenvZwarningiserror)Z force_all)�utilszreST markup error:
�ascii�backslashreplace�
�index),�verbose� cStringIO�StringIO�sys�stdoutrK rL rM r ZConfigZ
config_dir�
pkg_resources�get_distribution�
parse_versionZ init_values�warnings�warn�builderr; Z man_pagesr ZSphinxr �builder_target_dirZ doctree_dirZ fresh_env�buildZ all_files� ExceptionZdocutilsrO �
isinstanceZ
SystemMessageZstderr: �stderr�args�encodeZ
link_indexZ
master_docZ
out_suffixZget_outfilenamer �symlink)
r" Z
status_streamZ
confoverridesZ
sphinx_configZ
sphinx_verZapp�errrO �src�dstr r r � _sphinx_runz sJ
zLocalBuildDoc._sphinx_runc C s� | j �d�}t�� r,tj|d� tj|d� t�|dd�}t�|dd�}t� d�s�|r^| �
� |r�| � t |�
dd d g�d
�� �� xd| jD ]Z}|| _| �� | j �� | _| j �� | _| j �� | _t�|d d �r�| �� q�tj�| � q�W d S )
N�pbr)r# Zautodoc_tree_index_modulesZAUTODOC_TREE_INDEX_MODULESZautodoc_index_modulesZAUTODOC_INDEX_MODULESZ SPHINX_DEBUGZautodoc_exclude_modules� r Z
warnerrorsZ
WARNERRORS)r r r �_git_is_installed�write_git_changelog�generate_authorsr �get_boolean_optionr �getenvrJ rE �set�get�split�buildersr^ �finalize_options�get_name�project� get_versionrK rL rj r �BuildDoc�run)r" r# Z
tree_indexZ
auto_indexr^ r r r r{ � s8
zLocalBuildDoc.runc C s t j�| � dg| _d S )Nzsetup.py)r rz �initialize_optionsrH )r" r r r r| � s z LocalBuildDoc.initialize_optionsc C s� t j�| � | j�d�}d|�dg g�d kr<|d d | _t| jt�s\| jr\| j� d�| _d}| j�d�}||kr�|| d | _
| � |� d S ) Nr z command liner^ r r �,rH rk ) r rz rv r r rs ru rb �listrt rH �ensure_string_list)r" r# �optr r r rv � s z LocalBuildDoc.finalize_options)N) �__name__�
__module__� __qualname__� command_nameru r$ rE rJ rj r{ r| rv r r r r r C s
#,"r c @ s e Zd ZdgZdZdS )�LocalBuildLatexZlatexZbuild_sphinx_latexN)r� r� r� ru r� r r r r r� � s r� )� distutilsr r% r rY rW r\ rU � ImportError�iorN r r r r ra �e�strrk r r r= r rz r r� r r r r �<module> s.
"