Release History

7.0.0

This major release drops support for Python 3.5. This version is not maintained anymore.

Bug Fixes

  • Fixes an issue with ellipsis incorrectly being interpreted as relative imports and triggering a ValueError in the ImportableModuleFilter. See #96 for details.

6.0.0

With this release, sphinxcontrib-spelling moves from beta to stable. It also updates the use of Python 3, including packaging metadata, code style, and test configuration.

New Features

  • Add packaging metadata declaring the project stable.

  • Add packaging metadata declaring support for Python 3 only.

  • Add packaging metadata indicating that this is a sphinx extension.

Bug Fixes

  • Replace use of deprecated imp module with importlib.

  • Update use of pyenchant.get_tokenizer() to pass filters argument as a keyword and avoid a runtime warning message.

  • Remove unused test dependency on fixtures.

  • Use pyupgrade to modernize the source code.

5.4.0

New Features

  • Added a new filter (sphinxcontrib.spelling.filters.ContributorFilter) that treats contributor names extracted from the git history as spelled correctly, making it easier to refer to the names in acknowledgments . Includes a new configuration option, spelling_ignore_contributor_names to enable it.

5.3.0

New Features

  • Add a configuration option spelling_exclude_patterns to manage skipping spell checking for some input files. The option uses a list of glob-style patterns that are matched against the source file names relative to the source directory. See Configuration Options for more details. Contributed by sdelliot.

5.2.2

Bug Fixes

  • Updated to only create .spelling output files for inputs that generate spelling warnings. Fixes #63.

5.2.0

New Features

  • The builder is now registered using an entry point, so that if the spelling directive is not used in a project sphinxcontrib.spelling does not need to be included explicitly in the extensions list in conf.py in order to use it with the project on the command line.

  • PyEnchant is an optional dependency. If it is not installed, the spell checker will not work, but the extension can still be initialized. This allows projects that use spell checking to publish their documentation to readthedocs.org, where it is not possible to install PyEnchant.

  • Restore support for parallel builds. Words that do not appear in any configured dictionary are written to a file named based on the input file, with the .rst extension replaced with .spelling.

5.1.2

  • Mark as unsafe for parallel builds (contributed by Jared Dillard)

  • Add -W arg to sphinx-build in docs so warnings cause error (contributed by Elsa Gonsiorowski, PhD)

5.1.0

  • Add an option to show the line containing a misspelling for context (contributed by Huon Wilson)

5.0.0

4.3.0

  • Logging: use warning() instead of its deprecated alias (contributed by Sergey Kolosov)

  • Support additional contractions (contributed by David Baumgold)

  • require Sphinx >= 2.0.0

  • declare support for Python 3.6

4.2.1

  • fix remaining logging issue (contributed by Timotheus Kampik)

  • Remove usage of deprecated logging API (contributed by Tim Graham)

4.2.0

  • Fix a bug with empty word lists (contributed by FabioRosado)

  • Update dependency management to use setuptools extras

  • Document how to create multiple wordfiles (contributed by FabioRosado)

  • Note that PyEnchant is unmaintained and fix links (contributed by Marti Raudsepp)

  • Don’t use mutable default argument (contributed by Daniele Tricoli)

4.1.0

  • Make it possible to provide several wordlists (contributed by Tobias Olausson)

  • Update developer documentation (contributed by Tobias Olausson)

  • Update home page link (contributed by Devin Sevilla)

4.0.1

  • use the right method to emit warnings

  • disable smart quotes so that we can recognize contractions/possessives correctly (contributed by Alex Gaynor)

4.0.0

  • Don’t fail by default (contributed by Stephen Finucane)

  • Mark the extension as safe for parallel reading (contributed by Alex Gaynor)

  • be more verbose about configuration options

  • switch to testrepository for running tests

  • update Python 3.3 to 3.5

2.3.0

  • make it possible to specify tokenizer #7 (contributed by Timotheus Kampik)

2.2.0

  • Use https with pypi.python.org package name checker (contributed by John-Scott Atlakson)

  • Removed unnecessary shebang lines from non-script files (contributed by Avram Lubkin)

  • Re-enable the PyEnchant dependency (contributed by Julian Berman)

2.1.2

  • Fixed issue with six under Python 3.4

2.1.1

  • Use str.isupper() instead of ad-hoc method

  • fix syntax for tags directive

  • Removed no more used CHANGES file

2.1

  • Fix unicode error in PythonBuiltinsFilter.

  • Make error output useful in emacs compiler mode

  • Only show the words being added to a local dictionary if debugging is enabled.

2.0

  • Add Python 3.3 support.

  • Add PyPy support.

  • Use pbr for packaging.

  • Update tox config to work with forked version of PyEnchant until changes are accepted upstream.

1.4

1.3

  • Handle text nodes without parents. (#19)

  • Include the input document name in the console output.

  • Use the Sphinx wrapper for registering a directive.

1.2

  • Add the document name to the messages showing the contents of a local dictionary created by the spelling directive.

  • Add title nodes to the list of node types checked for spelling. Resolves issue #17.

  • Add test/test_wordlist.txt to the manifest so it is included in the source distribution and the tests will pass. Resolves issue #17.

  • Documentation patch from Hank Gay.

1.1.1

  • Fix initialization so the per-document filters work even if no spelling directive is used.

1.1

  • Add an option treat the names of packages on PyPI as spelled properly.

  • Add an option to treat CamelCase names as spelled properly.

  • Add an option to treat acronyms as spelled properly.

  • Add an option to treat Python built-ins as spelled properly.

  • Add an option to treat names that can be found as modules as spelled properly.

  • Add an option to let the user provide a list of other filter classes for the tokenizer.

  • Add spelling directive for passing local configuration settings to the spelling checker. This version allows setting a list of words known to be spelled correctly.

1.0

  • Re-implement using just a Builder, without a separate visitor class.

  • Show the file and line number of any words not appearing in the dictionary, instead of the section title.

  • Log the file, line, and unknown words as the documents are processed.

0.2

  • Warn but otherwise ignore unknown node types.

0.1

  • First public release.