# Configuration file for the Sphinx documentation builder.

import datetime
from pathlib import Path
import subprocess

project = "pmaports"
copyright = str(datetime.date.today().year) + ", postmarketOS contributors"
exclude_patterns = ["_build", "_out", "Thumbs.db", ".DS_Store", ".venv", "README.md"]

extensions = [
    "myst_parser",
    "sphinx.ext.autodoc",
    "sphinx.ext.autosummary",
    "sphinx.ext.doctest",
    "sphinxcontrib.autoprogram",
    "sphinxcontrib.jquery",
]

html_theme = "pmos"
html_theme_options = {
    # FIXME: This should be main once we rename the branch
    "source_edit_link": "https://gitlab.postmarketos.org/postmarketOS/pmaports/-/blob/master/docs/{filename}",
}

# Set the explicit title of the HTML output
html_title = "postmarketOS Packaging"


def run_dint_doc(app):
    with Path(__file__).parent.joinpath("deviceinfo-reference.md").open("w") as f:
        subprocess.call(["dint", "doc"], stdout=f)


def setup(app):
    app.connect("builder-inited", run_dint_doc)
