← Back
Editing: builddoc.cpython-38.pyc
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< �
Save File
Cancel