Sphinx 7.2 support

[AA-Turner]

Hi,

This is a reference to sphinx-doc/sphinx#11605, where a user has reported an incompatability in:

        self._default_build_dir = os.path.dirname(app.doctreedir.rstrip(os.sep))

with the following reproducer:

$ echo "Test" > index.rst
$ echo "extensions = ['breathe']" > conf.py
$ sphinx-build -M html . _build
Running Sphinx v7.2.0

Exception occurred:
  File "/Users/simon/.local/share/virtualenvs/fob-HUh8Hd7H/lib/python3.11/site-packages/breathe/project.py", line 116, in __init__
    self._default_build_dir = os.path.dirname(app.doctreedir.rstrip(os.sep))
                                              ^^^^^^^^^^^^^^^^^^^^^
AttributeError: 'PosixPath' object has no attribute 'rstrip'
The full traceback has been saved in /var/folders/x6/97fjm0c540s7yn9zlv7fp9k00000gn/T/sphinx-err-0d2v5eaa.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!

Sphinx 7.2 changed all internal paths to pathlib -- this could be resolved by either calling os.fspath on app.doctreedir or by calling Path(app.doctreedir).parent to also support pre-7.2 Sphinx.

A

[AA-Turner]

Note, I've released Sphinx 7.2.3 which contains a work-around for this issue. Projects are still heavily encouraged to use pathlib.Path objects over str based paths.

A

[mattip]

Thanks!