File: __init__.py

package info (click to toggle)
sphinx-qt-documentation 0.4.1-2
  • links: PTS
  • area: main
  • in suites: forky, sid, trixie
  • size: 104 kB
  • sloc: python: 307; makefile: 3
file content (46 lines) | stat: -rw-r--r-- 1,842 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
"""
This module contains sphinx extension supporting for build PartSeg documentation.

this extension provides one configuration option:

`qt_documentation` with possible values:

 * PyQt5 - linking to PyQt documentation on https://www.riverbankcomputing.com/static/Docs/PyQt5/api/ (incomplete)
 * Qt5 - linking to Qt5 documentation on "https://doc.qt.io/qt-5/" (default)
 * PySide2 - linking to PySide6 documentation on  "https://doc.qt.io/qtforpython-5/"
 * PyQt6 - linking to PyQt documentation on https://www.riverbankcomputing.com/static/Docs/PyQt6/api/ (incomplete)
 * Qt6 - linking to Qt5 documentation on "https://doc.qt.io/qt-6/"
 * PySide6 - linking to PySide6 documentation on  "https://doc.qt.io/qtforpython/PySide6/"
"""
from typing import Any, Dict

from sphinx.application import Sphinx
from sphinx.config import ENUM

from sphinx_qt_documentation.utils import (
    autodoc_process_signature,
    missing_reference,
    patch_intersphinx_mapping,
)


def setup(app: Sphinx) -> Dict[str, Any]:
    app.setup_extension("sphinx.ext.autodoc")
    app.setup_extension("sphinx.ext.intersphinx")
    app.add_config_value(
        "qt_documentation",
        "Qt5",
        True,
        ENUM("Qt5", "PySide2", "PyQt5", "Qt6", "PySide6", "PyQt6"),
    )

    app.connect("missing-reference", missing_reference)
    app.connect("autodoc-process-signature", autodoc_process_signature)
    app.connect("config-inited", patch_intersphinx_mapping, priority=800)
    # app.connect('doctree-read', doctree_read)
    return {"version": "0.1", "env_version": 1, "parallel_read_safe": True}


# https://doc.qt.io/qtforpython/PySide6/QtWidgets/QListWidget.html#PySide6.QtWidgets.QListWidget.itemDoubleClicked
# https://doc.qt.io/qtforpython/PySide6/QtWidgets/QListWidget.html#
# PySide6.QtWidgets.PySide6.QtWidgets.QListWidget.itemDoubleClicked