Skip to content

Conversation

@ajnelson-nist
Copy link
Member

Please see the first patch message for this PR's rationale.

Another PR will be filed soon to exercise doctests, and this PR will be merged into that PR's branch to demonstrate that doctests pass.

@ajnelson-nist ajnelson-nist added this to the 0.11.0 milestone May 4, 2023
This patch enables review of Python code inlined in the `case-utils`
modules' docstrings.

An initial docstring test is also included, because `pytest` reports an
error if it is called and no tests are found.

References:
* https://docs.pytest.org/en/7.1.x/how-to/doctest.html

Signed-off-by: Alex Nelson <[email protected]>
@ajnelson-nist ajnelson-nist marked this pull request as ready for review May 4, 2023 18:44
@ajnelson-nist ajnelson-nist requested a review from a team as a code owner May 4, 2023 18:44
@kchason kchason merged commit aeca9a4 into develop May 4, 2023
@ajnelson-nist ajnelson-nist deleted the enable_doctests branch May 5, 2023 12:35
ajnelson-nist added a commit to usnistgov/CASE-Implementation-PROV-O that referenced this pull request Jun 12, 2025
This patch enables `pytest`'s doctest mode and adds a first doctest to
ensure `pytest` doesn't fail due to finding no tests to run.

Follow-on patches will add new functions with more demanding doctests.

No effects were observed on Make-managed files.

References:
* https://docs.pytest.org/en/7.1.x/how-to/doctest.html
* casework/CASE-Utilities-Python#111

Signed-off-by: Alex Nelson <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants