make html fails

[LocutusOfBorg]

# make html
Running Sphinx v9.1.0

Configuration error!

Versions
========

* Platform:         linux; (Linux-6.17.0-1030-oem-x86_64-with-glibc2.42)
* Python version:   3.14.6 (CPython)
* Sphinx version:   9.1.0
* Docutils version: 0.22.4
* Jinja2 version:   3.1.6
* Pygments version: 2.20.0

Last Messages
=============

None.

Loaded Extensions
=================

None.

Traceback
=========

      File "/usr/lib/python3/dist-packages/sphinx/config.py", line 611, in eval_config_file
        raise ConfigError(msg % traceback.format_exc()) from exc
    sphinx.errors.ConfigError: There is a programmable error in your configuration file:
    
    Traceback (most recent call last):
      File "/usr/lib/python3.14/importlib/metadata/__init__.py", line 407, in from_name
        return next(iter(cls.discover(name=name)))
    StopIteration
    
    During handling of the above exception, another exception occurred:
    
    Traceback (most recent call last):
      File "/usr/lib/python3/dist-packages/sphinx/config.py", line 596, in eval_config_file
        exec(code, namespace)  # NoQA: S102
        ~~~~^^^^^^^^^^^^^^^^^
      File "/borgstore/docs/conf.py", line 14, in <module>
        release = pkg_version("borgstore")
      File "/usr/lib/python3.14/importlib/metadata/__init__.py", line 987, in version
        return distribution(distribution_name).version
               ~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^
      File "/usr/lib/python3.14/importlib/metadata/__init__.py", line 960, in distribution
        return Distribution.from_name(distribution_name)
               ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^
      File "/usr/lib/python3.14/importlib/metadata/__init__.py", line 409, in from_name
        raise PackageNotFoundError(name)
    importlib.metadata.PackageNotFoundError: No package metadata was found for borgstore


The full traceback has been saved in:
/tmp/sphinx-err-8ci3w573.log

To report this error to the developers, please open an issue at <https://github.com/sphinx-doc/sphinx/issues/>. Thanks!
Please also report this if it was a user error, so that a better error message can be provided next time.
make: *** [Makefile:20: html] Error 2

[ThomasWaldmann]

Can you pip install borgstore first, e.g. to a virtual env, e.g.:

pip install -e .  # from git workdir or similar
pip install borgstore.tgz  # from pypi package

[ThomasWaldmann]

Or try this patch:

diff --git a/docs/conf.py b/docs/conf.py
index 3a3a0cb..d776a35 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -6,12 +6,32 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-from importlib.metadata import version as pkg_version
+import os
+import sys
+from importlib.metadata import PackageNotFoundError, version as pkg_version
+
+
+def get_release():
+    """Determine the borgstore version, without requiring borgstore to be installed."""
+    try:
+        return pkg_version("borgstore")
+    except PackageNotFoundError:
+        pass
+    # not installed - maybe we are in a source tree where setuptools_scm already generated _version.py.
+    sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "src")))
+    try:
+        from borgstore._version import version  # noqa
+
+        return version
+    except ImportError:
+        # neither installed nor built - the docs do not really need the version, so just go on without it.
+        return ""
+
 
 project = "BorgStore"
 copyright = "2026, Thomas Waldmann"
 author = "Thomas Waldmann"
-release = pkg_version("borgstore")
+release = get_release()
 version = ".".join(release.split(".")[:2])
 
 # -- General configuration ---------------------------------------------------

[LocutusOfBorg]

Worked like a charm! thanks!