Ts constrained manual #4985
Open
Ts constrained manual #4985
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
TimSheard
force-pushed
the
ts-constrained-manual
branch
2 times, most recently
from
a04521c to
9f2bb0c
Compare
Soupstraw
approved these changes
Apr 16, 2025
TimSheard
force-pushed
the
ts-constrained-manual
branch
4 times, most recently
from
8c2b867 to
b4d4aee
Compare
This is a manual of how to use the constrained-generators libray in mark-down Tries to address every feature that is accessible from Constrained.API and a bit more.
TimSheard
force-pushed
the
ts-constrained-manual
branch
from
b4d4aee to
9bfb92b
Compare
neilmayhew
reviewed
Apr 22, 2025
carlostome
reviewed
Apr 22, 2025
carlostome
reviewed
Apr 22, 2025
carlostome
reviewed
Apr 22, 2025
Co-authored-by: Neil Mayhew <neil.mayhew@iohk.io>
neilmayhew
reviewed
Apr 23, 2025
| pure $ (w < x && x < y && y < z) ==> property (w < z) | ||
| ``` | ||
|
|
||
| The problem with this is that the probability that the precedant `(w < x && x < y && y < z)` is True, for random |
There was a problem hiding this comment.
I'm not familiar with the word "precedant" (unless it's a typo for "precedent"). Either way, I think "condition" would be a more familiar term for programmers.
Suggested change
| The problem with this is that the probability that the precedant `(w < x && x < y && y < z)` is True, for random | |
| The problem with this is that the probability that the condition `(w < x && x < y && y < z)` is `True`, for random |
| ``` | ||
|
|
||
| A vacuous pass, becomes a QuickCheck `discard`, so we cannot find 100 successful passes. | ||
| We can do a better job by constraining the precedant using `genFromSpec` |
There was a problem hiding this comment.
Suggested change
| We can do a better job by constraining the precedant using `genFromSpec` | |
| We can do a better job by constraining the input using `genFromSpec` |
Comment on lines
+326
to
+327
| Now this isn't a very good test either, since the precedant is alway true. A better solution would be to | ||
| generate a mix, where the precedent is True most of the time, but sometimes False. |
There was a problem hiding this comment.
Suggested change
| Now this isn't a very good test either, since the precedant is alway true. A better solution would be to | |
| generate a mix, where the precedent is True most of the time, but sometimes False. | |
| Now this isn't a very good test either, since the condition is always true. A better solution would be to | |
| generate a mix, where the condition is `True` most of the time, but sometimes `False`. |
| +++ OK, passed 100 tests; 7 discarded. | ||
| ``` | ||
| This makes it possible to write conditional 'implication' properties that have a high probability of | ||
| not being vacuosly true. |
There was a problem hiding this comment.
Suggested change
| not being vacuosly true. | |
| not being vacuously true. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
First draft of a Manual for constrained generators.
Adds two files to docs/constrained-generators
Manual.md and ManualExamples.hs, which is a executable file with the examples used in Manual.md
CHANGELOG.mdfiles updated for packages with externally visible changes.NOTE: New section is never added with the code changes. (See RELEASING.md).
.cabalandCHANGELOG.mdfiles when necessary, according to theversioning process.
.cabalfiles updated when necessary.NOTE: If bounds change in a cabal file, that package itself must have a version increase. (See RELEASING.md).
scripts/fourmolize.sh).scripts/cabal-format.sh).hie.yamlupdated (usescripts/gen-hie.sh).