- Improve error handling for failures in pre-build commands.
- Show the changed paths that triggered the rebuild.
- Fix path filtering on Windows by normalising path separators.
- Filter various directories by default (
.git
,venv
, etc). - Serve the correct directory when using make mode (
-M
).
- Run Sphinx through the Python entry point rather than the binary on PATH.
- Relax checks for paths that aren't required to exist.
- Fix support for Python 3.9.
- Fix running
sphinx-autobuild
via entry point scripts. - Run
sphinx-build
in a subprocess to mitigate autdoc issues. - Support the
-M
'make mode' option forsphinx-build
.
- Add a missing dependency on
watchfiles
. - Adopt Ruff in place of flake8 and black.
- Drop
python-livereload
. - Add
starlette
anduvicorn
as dependencies. - Implement hot reloading via websockets.
- Run Sphinx rebuilds in an asynchronous executor.
- Declare support for Python 3.9, 3.10, 3.11, and 3.12
- Drop support for Python 3.8 and earlier
- Allow passing relative paths to
--ignore
- Support all valid
sphinx-build
options (except Make-mode) - Fix path issues on Windows
- Differentiate pre-build command failures from Sphinx failures
- Change output handling for subprocesses.
- Present helpful error message when the subprocesses fail.
- Skip the main sphinx build, if pre-build commands fail.
- Adopt Calendar Versioning.
- Modernize codebase and require Python 3.6+.
- Directly depend on
sphinx
. - Rewritten documentation.
- Invoke sphinx via
{sys.executable} -m sphinx
instead ofsphinx-build
. - Trim dependencies down to only
livereload
andsphinx
. - Drop custom adapter for
watchdog
. - Drop
--poll
flag. - Drop single letter variants for flags that were specific to sphinx-autobuild.
- Remove spurious virtualenv directory from published packages.
- Add support for python 3.5, 3.6 and deprecate official python 2.6 support.
- Add
__main__
module for python 3. - Add a
--version
argument.
- Support
-p 0
,--port=0
to automatically chose an available port. - Added
-B
,--open-browser
to automatically open the documentation upon build. - Added Kate swap files to the list of files ignored by default
- Automatically build docs on startup (can be disabled with
--no-initial
). - Added
--poll
to force polling the FS for changes (useful for networked/virtualized mountpoints). - Compatibility with livereload >= 2.4.1.
- Added
-r
,--re-ignore
command line argument to exclude paths using regexes.
- Added
-z
,--watch
command line argument to watch arbitrary folders.
- Added
-i
,--ignore
command line argument to ignore files by the glob expression. - Added basic tests for the entry point script.
- PEP 257 improvements.
- Automated tests on travis integration and coverage reporting.
- Compatibility with livereload >= 2.3.0.
- Compatibility with Python 2.6 and 2.7.
- Provisional compatibility with Python 3.3 and 3.4.
- Ignore the paths indicated by the
-w
and-d
arguments when watching for changes to the documentation.
- Catch subprocess PTY reading errors.
- Explicitly parse sphinx-build arguments for better compatibility.
- Initial release.