uvloop/docs/conf.py

85 lines
2.0 KiB
Python

#!/usr/bin/env python3
import alabaster
import os
import re
import sys
sys.path.insert(0, os.path.abspath('..'))
with open(os.path.abspath('../setup.py'), 'rt') as f:
_m = re.search(r'''version=(?P<q>'|")(?P<ver>[\d\.]+)(?P=q)''', f.read())
if not _m:
raise RuntimeError('unable to read the version from setup.py')
version = _m.group('ver')
# -- General configuration ------------------------------------------------
extensions = [
'sphinx.ext.autodoc',
'alabaster',
]
templates_path = ['_templates']
source_suffix = '.rst'
master_doc = 'index'
project = 'uvloop'
copyright = '2016-present, MagicStack, Inc'
author = 'Yury Selivanov'
release = version
language = None
exclude_patterns = ['_build']
pygments_style = 'sphinx'
todo_include_todos = False
# -- Options for HTML output ----------------------------------------------
html_theme = 'alabaster'
html_theme_options = {
'description': 'uvloop is an ultra fast implementation of the '
'asyncio event loop on top of libuv.',
'show_powered_by': False,
}
html_theme_path = [alabaster.get_path()]
html_title = 'uvloop Documentation'
html_short_title = 'uvloop'
html_static_path = []
html_sidebars = {
'**': [
'about.html',
'navigation.html',
]
}
html_show_sourcelink = False
html_show_sphinx = False
html_show_copyright = True
htmlhelp_basename = 'uvloopdoc'
# -- Options for LaTeX output ---------------------------------------------
latex_elements = {}
latex_documents = [
(master_doc, 'uvloop.tex', 'uvloop Documentation',
'Yury Selivanov', 'manual'),
]
# -- Options for manual page output ---------------------------------------
man_pages = [
(master_doc, 'uvloop', 'uvloop Documentation',
[author], 1)
]
# -- Options for Texinfo output -------------------------------------------
texinfo_documents = [
(master_doc, 'uvloop', 'uvloop Documentation',
author, 'uvloop', 'One line description of project.',
'Miscellaneous'),
]