[DOC] dynamically get supported python versions + update .css

Author: SimonBlanke

docs/source/_static/css/custom.css

@@ -1,19 +1,26 @@
 /* Custom CSS for Hyperactive documentation */
-/* Landing page styling for a mature, professional appearance */
+/* Purple/Violet theme matching the Hyperactive logo */
 
 /* ============================================
    CSS Variables for consistent theming
    ============================================ */
 :root {
-    --hyperactive-primary: #0eac92;
-    --hyperactive-secondary: #2077b4;
-    --hyperactive-accent: #4c9aff;
-    --hyperactive-dark: #1a1a2e;
+    /* Purple/violet colors from the Hyperactive logo */
+    --hyperactive-primary: #5D5D7A;
+    --hyperactive-secondary: #7070A0;
+    --hyperactive-accent: #8080B0;
+    --hyperactive-dark: #4A4A65;
     --hyperactive-light: #f8f9fa;
-    --hyperactive-gradient: linear-gradient(135deg, #0eac92 0%, #2077b4 100%);
-    --hyperactive-gradient-dark: linear-gradient(135deg, #0a8c76 0%, #1a5a8a 100%);
+    --hyperactive-gradient: linear-gradient(135deg, #5D5D7A 0%, #8080B0 100%);
+    --hyperactive-gradient-dark: linear-gradient(135deg, #4A4A65 0%, #6B6B8E 100%);
     --card-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
     --card-shadow-hover: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
+    /* Neutral separator color */
+    --separator-color: #dee2e6;
+}
+
+html[data-theme="dark"] {
+    --separator-color: #3d3d4d;
 }
 
 /* ============================================
@@ -180,11 +187,11 @@ html[data-theme="dark"] .algo-card {
 }
 
 .optuna-card {
-    border-left-color: #7c4dff !important;
+    border-left-color: var(--hyperactive-accent) !important;
 }
 
 .optuna-card:hover {
-    border-left-color: #651fff !important;
+    border-left-color: var(--hyperactive-primary) !important;
 }
 
 /* ============================================
@@ -303,7 +310,7 @@ html[data-theme="dark"] .algo-card {
 }
 
 .sd-tab-label:hover {
-    background-color: rgba(14, 172, 146, 0.1);
+    background-color: rgba(93, 93, 122, 0.1);
 }
 
 input[name^="sd-tab-set"]:checked + label {
@@ -312,36 +319,27 @@ input[name^="sd-tab-set"]:checked + label {
 }
 
 /* ============================================
-   Section Dividers
+   Section Separators - Full Width Horizontal Lines
    ============================================ */
 hr {
     border: none;
     height: 1px;
-    background: linear-gradient(90deg, transparent, #dee2e6, transparent);
+    background-color: var(--separator-color);
     margin: 2.5rem 0;
-}
-
-html[data-theme="dark"] hr {
-    background: linear-gradient(90deg, transparent, #3d3d4d, transparent);
+    width: 100%;
 }
 
 /* ============================================
-   Section Headers
+   Section Headers - Clean without decorative underlines
    ============================================ */
 h2 {
     position: relative;
-    padding-bottom: 0.5rem;
+    padding-bottom: 0;
 }
 
+/* Remove the short underline pseudo-element */
 h2::after {
-    content: '';
-    position: absolute;
-    left: 0;
-    bottom: 0;
-    width: 60px;
-    height: 3px;
-    background: var(--hyperactive-gradient);
-    border-radius: 2px;
+    display: none;
 }
 
 /* ============================================
@@ -356,7 +354,7 @@ h2::after {
 .sd-btn-primary:hover {
     background: var(--hyperactive-gradient-dark) !important;
     transform: translateY(-1px);
-    box-shadow: 0 4px 12px rgba(14, 172, 146, 0.4);
+    box-shadow: 0 4px 12px rgba(93, 93, 122, 0.4);
 }
 
 /* ============================================

docs/source/conf.py

@@ -3,6 +3,7 @@
 
 import datetime
 import os
+import re
 import sys
 from pathlib import Path
 
@@ -18,6 +19,56 @@
 if not ON_READTHEDOCS:
     sys.path.insert(0, os.path.abspath("../.."))
 
+
+# -- Extract metadata from pyproject.toml ------------------------------------
+# This allows documentation to stay in sync with pyproject.toml automatically
+
+def extract_pyproject_metadata():
+    """Extract metadata from pyproject.toml for use in documentation."""
+    pyproject_path = Path(__file__).parent.parent.parent / "pyproject.toml"
+
+    metadata = {
+        "python_versions": [],
+        "min_python": "3.10",
+        "dependencies": [],
+        "version": hyperactive.__version__,
+    }
+
+    if pyproject_path.exists():
+        content = pyproject_path.read_text()
+
+        # Extract Python versions from classifiers
+        # Pattern: "Programming Language :: Python :: 3.XX"
+        py_version_pattern = r'"Programming Language :: Python :: (3\.\d+)"'
+        versions = re.findall(py_version_pattern, content)
+        if versions:
+            metadata["python_versions"] = sorted(set(versions))
+
+        # Extract requires-python
+        requires_python_match = re.search(r'requires-python\s*=\s*"([^"]+)"', content)
+        if requires_python_match:
+            req = requires_python_match.group(1)
+            # Extract minimum version from ">=3.10" or similar
+            min_match = re.search(r">=\s*([\d.]+)", req)
+            if min_match:
+                metadata["min_python"] = min_match.group(1)
+
+        # Extract core dependencies
+        deps_match = re.search(
+            r"dependencies\s*=\s*\[(.*?)\]", content, re.DOTALL
+        )
+        if deps_match:
+            deps_text = deps_match.group(1)
+            # Extract package names (first word before any version specifier)
+            dep_names = re.findall(r'"([a-zA-Z][a-zA-Z0-9_-]*)', deps_text)
+            metadata["dependencies"] = dep_names
+
+    return metadata
+
+
+# Extract metadata once at configuration time
+PYPROJECT_METADATA = extract_pyproject_metadata()
+
 # -- Project information -----------------------------------------------------
 current_year = datetime.datetime.now().year
 project = "hyperactive"
@@ -311,3 +362,25 @@ def adds(pth):
 copybutton_prompt_text = r">>> |\.\.\. |\$ "
 copybutton_prompt_is_regexp = True
 copybutton_line_continuation_character = "\\"
+
+# -- RST Epilog: Make metadata available as substitutions in RST files -------
+# These can be used as |variable_name| in RST files
+
+# Build Python versions list dynamically
+_py_versions = PYPROJECT_METADATA["python_versions"]
+if _py_versions:
+    _py_versions_list = "\n".join(f"- Python {v}" for v in _py_versions)
+    _py_versions_inline = ", ".join(_py_versions)
+    _py_version_range = f"{_py_versions[0]} through {_py_versions[-1]}"
+else:
+    _py_versions_list = "- Python 3.10+"
+    _py_versions_inline = "3.10+"
+    _py_version_range = "3.10+"
+
+rst_epilog = f"""
+.. |version| replace:: {PYPROJECT_METADATA["version"]}
+.. |min_python| replace:: {PYPROJECT_METADATA["min_python"]}
+.. |python_versions_list| replace:: {_py_versions_inline}
+.. |python_version_range| replace:: {_py_version_range}
+.. |current_year| replace:: {current_year}
+"""

docs/source/installation.rst

@@ -4,7 +4,7 @@
 Installation
 ============
 
-Hyperactive can be installed via pip and supports Python 3.10 through 3.14.
+Hyperactive can be installed via pip and supports Python |python_version_range|.
 
 Installing Hyperactive
 ----------------------
@@ -167,16 +167,13 @@ After installation, verify that Hyperactive is working correctly:
 Python Version Support
 ----------------------
 
-Hyperactive officially supports:
-
-- Python 3.10
-- Python 3.11
-- Python 3.12
-- Python 3.13
-- Python 3.14 (with some optional dependency limitations)
+Hyperactive officially supports Python |python_versions_list|.
 
 .. note::
 
+   The supported Python versions are automatically extracted from the project's
+   ``pyproject.toml`` classifiers.
+
    Some optional integrations (sktime, PyTorch) may have more restrictive
    Python version requirements. Check the specific package documentation
    for details.