ablog fails with sphinx 9.0

[daniel-baumann]

Hi,

the latest ablog release fails with newer sphinx, in my case on Debian with sphinx 9.0.4. The output is below.

Running Sphinx v9.0.4
loading translations [en]... done

Extension error!

Versions
========

* Platform:         linux; (Linux-6.12.57+deb13-amd64-x86_64-with-glibc2.41)
* Python version:   3.13.5 (CPython)
* Sphinx version:   9.0.4
* Docutils version: 0.21.2
* Jinja2 version:   3.1.6
* Pygments version: 2.18.0

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

None.

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

None.

Traceback
=========

      File "/usr/lib/python3/dist-packages/sphinx/registry.py", line 546, in load_extension
        raise ExtensionError(
            __('Could not import extension %s') % extname, err
        ) from err
    sphinx.errors.ExtensionError: Could not import extension ablog (exception: No module named 'ablog')


The full traceback has been saved in:
/tmp/sphinx-err-iv07rf4i.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

The full traceback from /tmp/sphinx-err-iv07rf4i.log is:

Traceback
=========

    Traceback (most recent call last):
      File "/usr/lib/python3/dist-packages/sphinx/registry.py", line 543, in load_extension
        mod = import_module(extname)
      File "/usr/lib/python3.13/importlib/__init__.py", line 88, in import_module
        return _bootstrap._gcd_import(name[level:], package, level)
               ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
      File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
      File "<frozen importlib._bootstrap>", line 1324, in _find_and_load_unlocked
    ModuleNotFoundError: No module named 'ablog'
    
    The above exception was the direct cause of the following exception:
    
    Traceback (most recent call last):
      File "/usr/lib/python3/dist-packages/sphinx/cmd/build.py", line 414, in build_main
        app = Sphinx(
            srcdir=args.sourcedir,
        ...<14 lines>...
            exception_on_warning=args.exception_on_warning,
        )
      File "/usr/lib/python3/dist-packages/sphinx/application.py", line 308, in __init__
        self.setup_extension(extension)
        ~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^
      File "/usr/lib/python3/dist-packages/sphinx/application.py", line 514, in setup_extension
        self.registry.load_extension(self, extname)
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
      File "/usr/lib/python3/dist-packages/sphinx/registry.py", line 546, in load_extension
        raise ExtensionError(
            __('Could not import extension %s') % extname, err
        ) from err
    sphinx.errors.ExtensionError: Could not import extension ablog (exception: No module named 'ablog')

[SilverRainZ]

It seems Sphinx simply can't find the ablog module. Have you recently upgraded your Python version? Could you try executing import ablog in the Python interactive shell?

[daniel-baumann]

Hi,

the Python version is the same - installing sphinx 9.0.4 breaks ablog, downgrading back to sphinx 8.2.3 makes it work again.

Importing ablog, regardless of the sphinx version installed, in a Python prompt works just fine.

Regards,
Daniel

[daniel-baumann]

I've just uploaded this to debian, will submit a merge request later today:
https://forgejo.debian.net/sphinx/ablog/src/branch/debian/debian/patches/debian/0001-sphinx-9.patch

Regards,
Daniel

[SilverRainZ]

It seems that the provided backtrace does not show the real fail reason. I get:

     File "/home/la/.local/lib/python3.13/site-packages/sphinx/builders/__init__.py", line 463, in build
        self.finish()
        ~~~~~~~~~~~^^
      File "/home/la/.local/lib/python3.13/site-packages/sphinx/builders/html/__init__.py", line 677, in finish
        self.finish_tasks.add_task(self.gen_pages_from_extensions)
        ~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      File "/home/la/.local/lib/python3.13/site-packages/sphinx/util/parallel.py", line 46, in add_task
        res = task_func()  # type: ignore[call-arg]
      File "/home/la/.local/lib/python3.13/site-packages/sphinx/builders/html/__init__.py", line 698, in gen_pages_from_extensions
        self.handle_page(pagename, context, template)
        ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
      File "/home/la/.local/lib/python3.13/site-packages/sphinx/builders/html/__init__.py", line 1238, in handle_page
        raise ThemeError(msg) from exc
    sphinx.errors.ThemeError: An error happened in rendering the page blog/author/ahmet-bakan.
    Reason: AttributeError("'StandaloneHTMLBuilder' object has no attribute 'docwriter'")

which is introduce in sphinx-doc/sphinx#13683.