Skip to content

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

Merged
celinval merged 3 commits into
model-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 into
model-checking:mainfrom
celinval:chores-doc-tests

Conversation

@celinval

@celinvalcelinval commented Oct 1, 2024

Copy link
Copy Markdown
Contributor

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 ownerOctober 1, 2024 00:54
@github-actionsgithub-actionsBot added the Z-EndToEndBenchCI Tag a PR to run benchmark CI label Oct 1, 2024
Comment threadlibrary/kani_core/src/lib.rs Outdated
Comment threadlibrary/kani_core/src/lib.rs Outdated
Comment threadlibrary/kani/src/invariant.rs Outdated
@celinval
celinval added this pull request to the merge queueOct 2, 2024
Merged via the queue into model-checking:main with commit 68387e4Oct 2, 2024
@celinvalcelinval mentioned this pull request Oct 8, 2024
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Z-EndToEndBenchCITag a PR to run benchmark CI

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@celinval@tautschnig@zhassan-aws