httk.core.docs.config
=====================

.. py:module:: httk.core.docs.config

.. autoapi-nested-parse::

   Load the strict ``docs/versioning.toml`` site configuration.

   The supported shape is::

       [site]
       slug = "httk-atomistic"
       repository-url = "https://github.com/httk/httk-atomistic"
       main-branch = "main"
       import-roots = ["httk/atomistic", "httk/handlers"]

       [[internal-dependency]]
       distribution = "httk-core"
       slug = "httk-core"
       repository-url = "https://github.com/httk/httk-core"
       main-branch = "main"



Exceptions
----------

.. autoapisummary::

   httk.core.docs.config.ConfigError


Classes
-------

.. autoapisummary::

   httk.core.docs.config.InternalDependency
   httk.core.docs.config.VersioningConfig


Functions
---------

.. autoapisummary::

   httk.core.docs.config.load_versioning_config


Module Contents
---------------

.. py:exception:: ConfigError

   Bases: :py:obj:`ValueError`


   Raised when a versioning TOML file is missing, malformed, or unsafe.


.. py:class:: InternalDependency

   Documentation-site metadata for one internal httk distribution.


   .. py:attribute:: distribution
      :type:  str


   .. py:attribute:: slug
      :type:  str


   .. py:attribute:: repository_url
      :type:  str


   .. py:attribute:: main_branch
      :type:  str
      :value: 'main'



.. py:class:: VersioningConfig

   Configuration for one versioned documentation site.


   .. py:attribute:: slug
      :type:  str


   .. py:attribute:: repository_url
      :type:  str


   .. py:attribute:: main_branch
      :type:  str
      :value: 'main'



   .. py:attribute:: import_roots
      :type:  tuple[str, Ellipsis]
      :value: ()



   .. py:attribute:: internal_dependencies
      :type:  tuple[InternalDependency, Ellipsis]
      :value: ()



.. py:function:: load_versioning_config(path: str | pathlib.Path) -> VersioningConfig

   Read and validate a versioning TOML file, rejecting unknown keys.