Skip to content

Enable doctests to avoid coding mistakes in our API documentation#3557

Merged
celinval merged 3 commits intomodel-checking:mainfrom
celinval:chores-doc-tests
Oct 2, 2024
Merged

Enable doctests to avoid coding mistakes in our API documentation#3557
celinval merged 3 commits intomodel-checking:mainfrom
celinval:chores-doc-tests

Conversation

@celinval
Copy link
Contributor

@celinval celinval commented Oct 1, 2024

In order to enable the tests, I had to fix a few tests, enhance tests
with hidden code, and mark a few as no_run instead of rust.

The tests marked as no_run will at least compile, but we cannot
execute them otherwise execution would
be stuck in an infinite loop, since we provide dummy implementation
to a lot of our intrinsics with loop {}.

Finally, as I was cleaning up the documentation, I noticed that we
accidently published an API that was meant to be internal to Kani.
I marked this API as deprecated for now.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 and MIT licenses.

In order to enable the tests, I had to fix a few tests, enhance tests
with hidden code, and mark a few as `no_run` instead of `rust`.

The tests marked as `no_run` will at least compile, but execution would
be stuck in an infinite loop, since we provide dummy implementation
to a lot of our intrinsics with `loop {}`.

Finally, as I was cleaning up the documentation, I noticed that we
accidently published an API that was meant to be internal to Kani.
I marked this API as deprecated for now.
Make it private already for `core`.
@celinval celinval requested a review from a team as a code owner October 1, 2024 00:54
@github-actions github-actions bot added the Z-EndToEndBenchCI Tag a PR to run benchmark CI label Oct 1, 2024
@celinval celinval added this pull request to the merge queue Oct 2, 2024
Merged via the queue into model-checking:main with commit 68387e4 Oct 2, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Z-EndToEndBenchCI Tag a PR to run benchmark CI

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants