Changelog

2026.07.19

  • Reject --temporary-file-name-template values that could resolve outside the temporary directory, preventing accidental overwrite or deletion of unrelated files. See #1211.

  • Support configured file extensions with more than one dot (for example --rst-extension=.test.rst) for both direct files and directory discovery (#1212).

  • Reject an empty or malformed --command value with a usage error instead of crashing (#1213).

  • Always generate a valid Python module name for temporary files so linters do not flag doccmd’s own filenames (#1214).

  • Support UTF-16 documents by detecting newlines on the decoded text (#1215).

  • Reject an empty --exclude pattern with a usage error instead of crashing.

2026.05.25

No significant changes.

2026.05.19

2026.05.16

2026.05.06

  • Bump sybil-extras to 2026.5.6.

2026.03.26.2

2026.03.26.1

2026.03.26

2026.03.02

2026.03.01

  • Bump sybil-extras to 2026.3.1.

  • Drop support for Python 3.10.

2026.02.27.1

  • Add --detect-pycon-language option (default: python) to automatically detect pycon (Python interactive console) blocks and apply prompt stripping only when a block’s first non-empty line starts with >>>.

2026.02.27

2026.02.26

2026.02.15

2026.01.31.3

2026.01.31.2

2026.01.31.1

2026.01.31

  • Add support for installing with winget on Windows.

2026.01.28

  • Add --temporary-file-name-template option for customizing temporary file names. This allows simpler patterns for linter per-file-ignores, such as doccmd_{unique}{suffix} to produce files like doccmd_a1b2.py.

  • Add --respect-gitignore / --no-respect-gitignore option to respect .gitignore files when discovering files in directories. This is enabled by default. Files passed directly are not affected by this option. This uses dulwich and respects .gitignore, .git/info/exclude, and global gitignore files.

2026.01.27.4

2026.01.27.3

2026.01.27.2

2026.01.27.1

2026.01.27

2026.01.25

2026.01.23.4

2026.01.23.3

2026.01.23.2

2026.01.23.1

2026.01.23

2026.01.22.1

2026.01.22

2026.01.21.2

2026.01.21.1

2026.01.21

2026.01.18

2026.01.12

2026.01.03.2

2026.01.03.1

2026.01.03

2025.12.13

2025.12.10

  • Add support for Norg files.

  • Add support for Djot files.

2025.12.08.5

2025.12.08.4

2025.12.08.3

2025.12.08.2

2025.12.08.1

2025.12.08

2025.12.07

2025.12.05.2

  • Error if a group is started but not ended.

2025.12.05.1

2025.12.05

  • Add support for MDX files.

2025.12.03

  • Add support for MyST code-cell directive.

2025.11.20

  • Add a --group-file option to automatically group all code blocks of the same language within a file.

2025.11.08.1

2025.11.08

  • Add a --write-to-file/--no-write-to-file option to control whether formatter output is written back to documents.

  • Add an --example-workers option to evaluate multiple code blocks in parallel when using --no-write-to-file.

  • Add a --document-workers option to evaluate multiple documents in parallel when using --no-write-to-file.

2025.10.18

  • Add a --continue-on-error flag to collect and display all errors across files before exiting.

2025.09.19

2025.04.08

  • Fix IndexError when using a formatter which changed the number of lines in a code block.

2025.03.27

2025.03.18

  • With --verbose, show the command that will be run before the command is run, not after.

2025.03.06

  • Support files which are not UTF-8 encoded.

  • Support grouping code blocks with doccmd group[all]: start and doccmd group[all]: end comments.

2025.02.18

  • Re-add support for Python 3.10.

2025.02.17

  • Add support for Markdown (not MyST) files.

  • Add support for treating groups of code blocks as one.

  • Drop support for Python 3.10.

2025.01.11

2024.12.26

2024.11.14

  • Skip files where we hit a lexing error.

  • Bump Sybil requirement to >= 9.0.0.

2024.11.06.1

  • Add a --max-depth option for recursing into directories.

2024.11.06

  • Add options to support given file extensions for source files.

  • Add support for passing in directories.

2024.11.05

  • Error if files do not have a rst or md extension.

2024.11.04

  • Add options to control whether a pseudo-terminal is used for running commands in.

  • Rename some options to make it clear that they apply to the temporary files created.

2024.10.14

  • Add documentation and source links to PyPI.

2024.10.13.1

  • Output in color (not yet on Windows).

2024.10.12

  • Only log --verbose messages when the relevant example will be run and is not a skip directive.

2024.10.11

  • Use line endings from the original file.