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_sphinxZhtml�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)�.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|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 Zpackages�walkr �sorted�keysr �open�write�len�dict�
_rst_template)r! r) �modulesr Zpkg�dirpathZdirnamesr Z module_listZautoindex_filenameZ autoindexr& Zoutput_filenamer. r/ �valuesZ output_filer )r) r* r �generate_autoindexR s4
z LocalBuildDoc.generate_autoindexc C s, | � � }ddddd|g}t�|| j � d S )Nr r
z-HZModulesz-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�stdoutrC rD rE r ZConfigZ
config_dir�
pkg_resourcesZget_distributionZ
parse_versionZ init_values�warnings�warn�builderr8 Z man_pagesr ZSphinxr Zbuilder_target_dirZ doctree_dirZ fresh_envZbuildZ all_files� ExceptionZdocutilsrG �
isinstanceZ
SystemMessageZstderr7 �stderr�args�encodeZ
link_indexZ
master_docZ
out_suffixZget_outfilenamer �symlink)
r! Z
status_streamZ
confoverridesZ
sphinx_configZ
sphinx_verZapp�errrG �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 Z_git_is_installedZwrite_git_changelogZgenerate_authorsr Zget_boolean_optionr �getenvrB r> �set�get�split�buildersrT �finalize_optionsZget_nameZprojectZ get_versionrC rD r^ r �BuildDoc�run)r! r" Z
tree_indexZ
auto_indexrT r r r rh � s8
zLocalBuildDoc.runc C s t j�| � dg| _d S )Nzsetup.py)r rg �initialize_optionsr@ )r! r r r ri � 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 linerT r r �,r@ r_ ) r rg rf r r rc re rV �listrd r@ Zensure_string_list)r! r" �optr r r rf � s z LocalBuildDoc.finalize_options)N) �__name__�
__module__� __qualname__� command_namere r# r> rB r^ rh ri rf r r r r r C s
#,"r c @ s e Zd ZdgZdZdS )�LocalBuildLatexZlatexZbuild_sphinx_latexN)rm rn ro re rp r r r r rq � s rq )� distutilsr r$ r rQ rO rR rM � ImportError�iorF r r r r rU �e�strr_ r r r: r rg r rq r r r r �<module> s.
"