inspection-testing: GHC plugin to do inspection testing
Some carefully crafted libraries make promises to their users beyond functionality and performance.
Examples are: Fusion libraries promise intermediate data structures to be eliminated. Generic programming libraries promise that the generic implementation is identical to the hand-written one. Some libraries may promise allocation-free or branch-free code.
Conventionally, the modus operandi in all these cases is that the library author manually inspects the (intermediate or final) code produced by the compiler. This is not only tedious, but makes it very likely that some change, either in the library itself or the surrounding eco-system, breaks the library’s promised without anyone noticing.
This package provides a disciplined way of specifying such properties, and have them checked by the compiler. This way, this checking can be part of the ususal development cycle and regressions caught early.
See the documentation in Test.Inspection or the project webpage for more examples and more information.
[Skip to Readme]
Flags
Automatic Flags
Name | Description | Default |
---|---|---|
more-tests | Run tests that pull in specific versions of other packages | Disabled |
old-text-tests | Run tests that exhibits bug in old text package. Only works with older version of GHC. | Disabled |
Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info
Downloads
- inspection-testing-0.5.0.3.tar.gz [browse] (Cabal source package)
- Package description (revised from the package)
Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
Versions [RSS] | 0.1, 0.1.1, 0.1.1.1, 0.1.1.2, 0.1.2, 0.2, 0.2.0.1, 0.3, 0.4, 0.4.1, 0.4.1.1, 0.4.1.2, 0.4.2, 0.4.2.1, 0.4.2.2, 0.4.2.4, 0.4.3.0, 0.4.4.0, 0.4.5.0, 0.4.6.0, 0.4.6.1, 0.5, 0.5.0.1, 0.5.0.2, 0.5.0.3 |
---|---|
Change log | ChangeLog.md |
Dependencies | base (>=4.9 && <4.21), containers, ghc (>=8.0.2 && <9.11), mtl, template-haskell, transformers [details] |
License | MIT |
Copyright | 2017 Joachim Breitner |
Author | Joachim Breitner |
Maintainer | mail@joachim-breitner.de |
Revised | Revision 2 made by JoachimBreitner at 2024-07-09T10:13:07Z |
Category | Testing, Compiler Plugin |
Home page | https://github.com/nomeata/inspection-testing |
Source repo | head: git clone git://github.com/nomeata/inspection-testing.git |
Uploaded | by JoachimBreitner at 2023-12-29T09:33:07Z |
Distributions | Arch:0.5.0.3, Debian:0.4.2.4, LTSHaskell:0.5.0.3, NixOS:0.5.0.3, Stackage:0.5.0.3 |
Reverse Dependencies | 3 direct, 38 indirect [details] |
Downloads | 18549 total (161 in the last 30 days) |
Rating | 2.5 (votes: 4) [estimated by Bayesian average] |
Your Rating | |
Status | Docs available [build log] Last success reported on 2023-12-29 [all 1 reports] |