Sybil

-------------------

- The public interface is now fully typed and checked with ``mypy``.

- Official support for Python 3.12 with Python 3.7 now being the minimum
supported version.

- :doc:`Markdown <markdown>` is now supported separately to
:doc:`MyST <myst>`.

- :any:`ReST <sybil.parsers.rest.lexers.DirectiveLexer>` and
:any:`MyST <sybil.parsers.myst.lexers.DirectiveLexer>` directives
now have their options extracted as part of the lexing process.

- Added support for MyST single-line html-style comment directives.

- Fixed parsing of MyST directive options with no leading whitespace.

- Fixed parsing of Markdown and MyST fenced codeblocks at the end of documents with no
trailing newline.

- Rework document evaluators to be more flexible and structured.

- :ref:`skip <skip-parser>` has been reworked to check validity of operations
and allow a reason to be provided for an unconditional skip so it can be
highlighted as a skipped test in test runner output. The skip parsers
are also now lexer-based.

- Make :attr:`Region.evaluator` optional, removing the need for the separate
``LexedRegion`` class.

Huge thanks to Adam Dangoor for all his work on typing!

-------------------

- Fix bug in traceback trimming on the latest release of pytest.

-------------------

- Fixed bug in the :func:`repr` of ``LexedRegion`` instances where a lexeme was ``None``.

- Fixed lexing of ReST directives, such as :rst:dir:`code-block`, where they occurred
at the end of a docstring.

- Ensure the :class:`~sybil.Document.namespace` in which doctests are evaluated always has a
``__name__``. This is required by an implementation detail of :any:`typing.runtime_checkable`.

------------------

- Fix a bug that prevent r-prefixed docstrings from being correctly parsed from ``.py`` files.

-------------------

- By default, on Python 3.8 and above, when parsing ``.py`` files, only examples in docstrings
will be parsed.

- The :attr:`~sybil.Document.namespace` can now be cleared in both
:ref:`ReST <clear-namespace>` and
:ref:`MyST <myst-clear-namespace>`.

- Support for Python 3.6 has been dropped.

- Support for pytest versions earlier than 7.1 has been dropped.

------------------

- Switch :func:`sybil.parsers.myst.SkipParser` to use the correct comment character.

- Note that the :external+sphinx:doc:`doctest extension <usage/extensions/doctest>` needs to be
enabled to render :rst:dir:`doctest` directives.

- Warn about :ref:`ReST <doctest-parser>` and :ref:`MyST <myst-doctest-parser>` doctest parsers
and overlapping blocks.