fix: updates from review

- fixup doc genenerator, using config from main. Too many issues
  encountered trying to get a working autoapi version to work with
sphinx. Decided to adopt a more recent version of sphinx and utilized
Connexion/main's docs/conf.py file.
- add pipeline builds for supported python
- snap werkzeug version to address CVE's

Signed-off-by: Mike Marchetti <[email protected]>

.github/workflows/pipeline.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: [3.7, 3.8, 3.9]
+        python-version: ['3.9', '3.10', '3.11', '3.12']
     steps:
     - uses: actions/checkout@v2
     - name: Set up Python ${{ matrix.python-version }}

docs/conf.py

@@ -27,20 +27,16 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['autoapi.extension']
-
-autoapi_type = 'python'
-autoapi_options = ['members',
-                   'inherited-members',
-                   'undoc-members',
-                   'show-inheritance',
-                   'show-module-summary',
-                   'special-members',
-                   'imported-members']
-autoapi_python_class_content = 'both'
-autoapi_dirs = [
-    '../connexion'
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx_copybutton',
+    'sphinx_design',
+    'sphinx.ext.autosectionlabel',
+    'sphinxemoji.sphinxemoji',
 ]
+autosectionlabel_prefix_document = True
+
+autoclass_content = 'both'
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -62,11 +58,12 @@
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
-import connexion
-# The short X.Y version.
-version = connexion.__version__.rsplit('.', 1)[0]
+from importlib.metadata import version
+
 # The full version, including alpha/beta/rc tags.
-release = connexion.__version__
+release = version('connexion')
+# The short X.Y version.
+version = release.rsplit('.', 1)[0]
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -117,6 +114,18 @@
     html_theme = "sphinx_rtd_theme"
 
     html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+
+    html_theme_options = {
+        'navigation_depth': 2
+    }
+
+    html_context = {
+        'display_github': True,
+        'github_user': 'spec-first',
+        'github_repo': 'connexion',
+        'github_version': 'main',
+        'conf_py_path': '/docs/'
+    }
 except:
     pass
 
@@ -147,7 +156,11 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-# html_static_path = ['_static']
+html_static_path = ['_static']
+
+html_css_files = [
+    'css/default.css',
+]
 
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied