Update: read docs parameters

Author: Onimock

docs/source/conf.py

@@ -1,8 +1,21 @@
 import os
 import sys
+import tomlkit
 
 sys.path.insert(0, os.path.abspath("../../src"))
 
+
+def get_version():
+    pyproject_path = os.path.abspath("../../pyproject.toml")
+    try:
+        with open(pyproject_path, "r", encoding="utf-8") as f:
+            data = tomlkit.parse(f.read())
+        version = data.get("project", {}).get("version", "0.0.0")
+        return version
+    except (FileNotFoundError, KeyError):
+        return "0.0.0"
+
+
 # Configuration file for the Sphinx documentation builder.
 #
 # For the full list of built-in configuration values, see the documentation:
@@ -11,25 +24,28 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
+full_version = get_version()
+version = ".".join(full_version.split(".")[:2])
+release = full_version
+
 project = "QSS Parser"
 copyright = "2025, OniMock"
 author = "OniMock"
-release = "0.1.3"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
 extensions = ["sphinx.ext.autodoc", "sphinx.ext.viewcode", "sphinx.ext.napoleon"]
 
 templates_path = ["_templates"]
-exclude_patterns = []
-
+exclude_patterns = ["modules.rst"]
 
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 html_theme = "sphinx_rtd_theme"
-html_static_path = ["_static"]
+html_static_path = [""]
+autodoc_member_order = "groupwise"
 
 
 def skip(app, what, name, obj, skip, options):
@@ -38,8 +54,12 @@ def skip(app, what, name, obj, skip, options):
     return skip
 
 
-def setup(app):
-    app.connect("autodoc-skip-member", skip)
+def process_docstring(app, what, name, obj, options, lines):
+    # Strip the 'qss_parser.qss_parser.' prefix from docstrings
+    for i in range(len(lines)):
+        lines[i] = lines[i].replace("qss_parser.qss_parser.", "")
 
 
-autodoc_member_order = "groupwise"
+def setup(app):
+    app.connect("autodoc-skip-member", skip)
+    app.connect("autodoc-process-docstring", process_docstring)

docs/source/index.rst

@@ -1,21 +1,15 @@
-.. QSS Parser documentation master file, created by
-   sphinx-quickstart.
-
 Welcome to QSS Parser's Documentation!
 ======================================
 
 The QSS Parser is a Python library for parsing Qt Style Sheets (QSS) and applying styles to PySide6/PyQt6 widgets.
 
-Contents
---------
-
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
 
-   modules
+   qss_parser
 
-Indices and tables
+Indices and Tables
 ------------------
 
 * :ref:`genindex`

docs/source/modules.rst

@@ -1,21 +1,6 @@
-qss\_parser package
-===================
-
-Submodules
-----------
-
-qss\_parser.qss\_parser module
-------------------------------
+qss_parser.qss_parser module
+============================
 
 .. automodule:: qss_parser.qss_parser
    :members:
-   :undoc-members:
-   :show-inheritance:
-
-Module contents
----------------
-
-.. automodule:: qss_parser
-   :members:
-   :undoc-members:
-   :show-inheritance:
+   :show-inheritance: