# Configuration file for the Sphinx documentation builder.
#
# For the full list of built-in configuration values, see the documentation:
# https://www.sphinx-doc.org/en/master/usage/configuration.html
import os
import sys

sys.path.insert(0, os.path.abspath('../src'))
sys.path.insert(0, os.path.abspath('../src/aare'))
sys.path.insert(0, os.path.abspath('../src/aare/daq'))
sys.path.insert(0, os.path.abspath('../src/aare/common'))
sys.path.insert(0, os.path.abspath('../src/aare/gui'))
# -- Project information -----------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information

project = 'AareDAQ'
copyright = '2026, Paul Scherrer Institute'
author = 'Martin Appleby, Guillaume Gotthard, Filip Leonarski and Dawn (Jiaxin) Daun'
release = '0.3.1'
master_doc = 'index'
root_doc = 'index'

# -- General configuration ---------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

autodoc_mock_imports = [
    'aaredb',
    'jfjoch_client',
    'numpy',
    'requests',
    "pyJW",
    "pyzmq",
    "opencv-python-headless",
    "PySide6",
    "pyepics",
    "redis",
    "python-redis-lock",
    "fastapi",
    "uvicorn",
    "python_multipart",
    "websocket-client",
    "sseclient-py",
    "psi-pshell",
]

exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']

extensions = [
    # 'fuse_search',
    'sphinx.ext.intersphinx',
    'myst_parser',
    'sphinx_immaterial',
    'sphinx.ext.autodoc',
    'sphinx.ext.napoleon',
    'sphinx.ext.viewcode',
]

# Optional: allow includes in Markdown
myst_enable_extensions = [
    "colon_fence",
    "deflist",
    "html_admonition",
    "html_image",
    "linkify",
    "substitution",
    'smartquotes',
    "tasklist",
]

templates_path = ['_templates']
myst_heading_anchor = 3


# -- Options for Fuzzy Search ------------------------------------------------
# Fuse.js configuration
# fuse_js_options = {
#     'includeScore': True,
#     'includeMatches': True,
#     'threshold': 0.3,  # More fuzzy (0.0 = exact, 1.0 = match everything)
#     'distance': 100,
#     'minMatchCharLength': 2,
#     'keys': [
#         {'name': 'title', 'weight': 0.8},
#         {'name': 'content', 'weight': 0.5},
#         {'name': 'tags', 'weight': 0.3},
#     ]
# }

#Static Files
html_static_path = ['_static']
html_css_files = [
    'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css',
    # 'css/fuse-search.css',
]
# html_js_files = [
#     'js/fuse-search.js',
# ]


# -- Options for HTML output -------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output

html_theme = 'sphinx_immaterial'

html_theme_options = {
    "icon": {
        "repo": "fontawesome/brands/github", # or gitlab/gitea icon
    },
    "site_url": "https://gitea.psi.ch/mx/aaredaq",
    "repo_url": "https://gitea.psi.ch/mx/aaredaq",
    "repo_name": "AareDAQ",
    "social": [
        {
            "icon": "fontawesome/brands/github",
            "link": "https://gitea.psi.ch/mx/aaredaq",
            "name": "AareDAQ on Gitea",
        },
    ],
    "palette": [
        {
            "media": "(prefers-color-scheme: light)",
            "scheme": "default",
            "primary": "indigo",
            "accent": "lime",
            "toggle": {
                "icon": "material/lightbulb-outline",
                "name": "Switch to dark mode",
            },
        },
        {
            "media": "(prefers-color-scheme: dark)",
            "scheme": "slate",
            "primary": "indigo",
            "accent": "lime",
            "toggle": {
                "icon": "material/lightbulb",
                "name": "Switch to light mode",
            },
        },
    ],
    "features": [
        "navigation.expand",
        "navigation.sections",
        "navigation.top",
        "search.share",
        "toc.follow",
        "navigation.instant",
        "content.tabs.link",
        "content.code.annotate",
        "content.code.copy",
    ],
    "globaltoc_collapse": False,
    "toc_title": "On this page",
    "toc_title_container": True,
    "font": {
        "code": "JetBrains Mono",
    },
}
html_theme_options["google_fonts"] = []
html_sidebars = {
    "**": ["logo-text.html", "globaltoc.html", "searchbox.html"]
}


html_show_sourcelink = False


# Optional
autodoc_default_options = {
    'members': True,
    'undoc-members': True,
    'show-inheritance': True,
    'member-order': 'bysource',
}