�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 � /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)�.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 | 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�dirpath�dirnamesr Z module_listZautoindex_filenameZ autoindexr( Zoutput_filenamer0 r1 �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�stdoutrG rH rI r ZConfigZ
config_dir�
pkg_resourcesZget_distributionZ
parse_versionZ init_values�warnings�warn�builderr: Z man_pagesr ZSphinxr Zbuilder_target_dirZ doctree_dirZ fresh_envZbuildZ all_files� ExceptionZdocutilsrK �
isinstanceZ
SystemMessageZstderr9 �stderr�args�encodeZ
link_indexZ
master_docZ
out_suffixZget_outfilenamer �symlink)
r" Z
status_streamZ
confoverridesZ
sphinx_configZ
sphinx_verZapp�errrK �src�dstr 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 �getenvrF rA �set�get�split�buildersrX �finalize_options�get_nameZprojectZ get_versionrG rH rb r �BuildDoc�run)r" r# Z
tree_indexZ
auto_indexrX r r r rm � s8
zLocalBuildDoc.runc C s t j j | � d g | _ d S)Nzsetup.py)r rl �initialize_optionsrD )r" r r r rn � 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 linerX r r �,rD rc ) r rl rj r r rg ri rZ �listrh rD Zensure_string_list)r" r# �optr r r rj � s z LocalBuildDoc.finalize_options) �__name__�
__module__� __qualname__� command_nameri r$ rA rF rb rm rn rj r r r r r C s
# , " r c @ s e Z d Z d g Z d Z d S)�LocalBuildLatexZlatexZbuild_sphinx_latexN)rr rs rt ri ru r r r r rv � s rv )Z distutilsr r% r rU rS rV rQ � ImportError�iorJ r r r r rY �e�strrc r r r< r rl r rv r r r r �<module> s,
%
�