Merge branch 'release/4.5.0'

docs/conf.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 #
 # Progress Bar documentation build configuration file, created by
 # sphinx-quickstart on Tue Aug 20 11:47:33 2013.
@@ -9,7 +11,6 @@
 #
 # All configuration values have a default; values that are commented out
 # serve to show the default.
-
 import datetime
 import os
 import sys
@@ -59,17 +60,17 @@
 
 # General information about the project.
 project = 'Progress Bar'
-project_slug = ''.join(project.capitalize().split())
+project_slug: str = ''.join(project.capitalize().split())
 copyright = f'{datetime.date.today().year},  <a href="http://wol.ph/">{metadata.__author__}</a>'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = metadata.__version__
+version: str = metadata.__version__
 # The full version, including alpha/beta/rc tags.
-release = metadata.__version__
+release: str = metadata.__version__
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -202,7 +203,7 @@
 
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).
-latex_documents = [
+latex_documents: list[tuple[str, ...]] = [
     (
         'index',
         f'{project_slug}.tex',
@@ -237,7 +238,7 @@
 
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [
+man_pages: list[tuple[str, str, str, list[str], int]] = [
     (
         'index',
         project_slug.lower(),
@@ -256,7 +257,7 @@
 # Grouping the document tree into Texinfo files. List of tuples
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
-texinfo_documents = [
+texinfo_documents: list[tuple[str, ...]] = [
     (
         'index',
         project_slug,
@@ -284,10 +285,10 @@
 # -- Options for Epub output ---------------------------------------------
 
 # Bibliographic Dublin Core info.
-epub_title = project
-epub_author = metadata.__author__
-epub_publisher = metadata.__author__
-epub_copyright = copyright
+epub_title: str = project
+epub_author: str = metadata.__author__
+epub_publisher: str = metadata.__author__
+epub_copyright: str = copyright
 
 # The language of the text. It defaults to the language option
 # or en if the language is not set.
@@ -340,4 +341,6 @@
 
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'python': ('https://docs.python.org/3', None)}
+intersphinx_mapping: dict[str, tuple[str, None]] = {
+    'python': ('https://docs.python.org/3', None)
+}