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/. )endswithreplace)argdirnamefilesfilename 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_sphinxZhtmlmanc 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) distributionget_option_dictospathjoinexistsmakedirs)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).0pat)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.rstwz .. toctree::
:maxdepth: 1
z%s.rstzThe :mod:`%s` Module=r( heading underlinez[pbr] Generating %sz
%s.rst
)r infor r abspathcurdirr$ r Zpackageswalkr sortedkeysr openwritelendict
_rst_template)r" r+ modulesr Zpkgdirpathdirnamesr 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-HModulesz-o)r$ r mainautodoc_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 rt 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)Nversionreleasetodayzconf.pysphinxz1.3.1r r ZfreshenvZwarningiserrorFZ force_all)utilszreST markup error:
asciibackslashreplace
index),verbose cStringIOStringIOsysstdoutrG rH rI r ZConfigZ
config_dir
pkg_resourcesZget_distributionZ
parse_versionZ init_valueswarningswarnbuilderr: Z man_pagesr ZSphinxr Zbuilder_target_dirZ doctree_dirZ fresh_envZbuildZ all_files ExceptionZdocutilsrK
isinstanceZ
SystemMessageZstderr9 stderrargsencodeZ
link_indexZ
master_docZ
out_suffixZget_outfilenamer symlink)
r" Z
status_streamZ
confoverridesZ
sphinx_configZ
sphinx_verZapperrrK srcdstr 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)
Npbrr# 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 setgetsplitbuildersrX finalize_optionsget_nameZprojectZ get_versionrG rH rb r BuildDocrun)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 ImportErroriorJ r r r r rY estrrc r r r< r rl r rv r r r r <module> s,
%