allow building docs with python 3.8 (xmlsec#227)

Signed-off-by: oleg.hoefling <[email protected]>

Signed-off-by: oleg.hoefling <[email protected]>

Author: hoefling

doc/source/conf.py

@@ -1,7 +1,9 @@
 # -*- coding: utf-8 -*-
 
-import sys
+from __future__ import annotations
+
 import urllib.request
+import importlib.metadata
 
 import lxml
 from docutils.nodes import Text, reference
@@ -11,11 +13,6 @@
 from sphinx.environment import BuildEnvironment
 from sphinx.errors import ExtensionError
 
-if sys.version_info >= (3, 8):
-    from importlib import metadata as importlib_metadata
-else:
-    import importlib_metadata
-
 
 extensions = ['sphinx.ext.autodoc', 'sphinx.ext.viewcode', 'sphinx.ext.intersphinx']
 
@@ -28,11 +25,10 @@
 project = u'python-xmlsec'
 copyright = u'2020, Oleg Hoefling <[email protected]>'  # noqa: A001
 author = u'Bulat Gaifullin <[email protected]>'
-release = importlib_metadata.version('xmlsec')
+release = importlib.metadata.version('xmlsec')
 parsed: Version = parse(release)
 version = '{}.{}'.format(parsed.major, parsed.minor)
 
-language = None
 exclude_patterns: list[str] = []
 pygments_style = 'sphinx'
 todo_include_todos = False
@@ -69,6 +65,12 @@
 autodoc_member_order = 'groupwise'
 autodoc_docstring_signature = True
 
+
+rst_prolog = '''
+.. role:: xml(code)
+   :language: xml
+'''
+
 # LXML crossref'ing stuff:
 # LXML doesn't have an intersphinx docs,
 # so we link to lxml.etree._Element explicitly

doc/source/index.rst

@@ -3,9 +3,6 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root ``toctree`` directive.
 
-.. role:: xml(code)
-   :language: xml
-
 Welcome to python-xmlsec's documentation!
 =========================================