Hackage :: [Package]

tasty-expected-failure: Mark tasty tests as failure expected

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

With the function Test.Tasty.ExpectedFailure.expectFail in the provided module Test.Tasty.ExpectedFailure, you can mark that you expect test cases to fail, and not to pass.

This can for example be used for test-driven development: Create the tests, mark them with Test.Tasty.ExpectedFailure.expectFail, and you can still push to the main branch, without your continuous integration branch failing.

Once someone implements the feature or fixes the bug (maybe unknowingly), the test suite will tell him so, due to the now unexpectedly passing test, and he can remove the Test.Tasty.ExpectedFailure.expectFail marker.

The module also provides Test.Tasty.ExpectedFailure.ignoreTest to avoid running a test. Both funtions are implemented via the more general Test.Tasty.ExpectedFailure.wrapTest, which is also provided.

[Skip to Readme]

Properties

Versions 0.11, 0.11.0.1, 0.11.0.2, 0.11.0.3, 0.11.0.4, 0.11.1, 0.11.1.1, 0.11.1.2, 0.12, 0.12.1, 0.12.2, 0.12.2, 0.12.3
Change log None available
Dependencies base (>=4.9 && <5), tagged (>=0.7 && <0.9), tasty (>=0.11), unbounded-delays (<0.2) [details]
License MIT
Copyright 2015 Joachim Breitner
Author Joachim Breitner
Maintainer mail@joachim-breitner.de
Category Testing
Home page http://github.com/nomeata/tasty-expected-failure
Source repo head: git clone git://github.com/nomeata/tasty-expected-failure
Uploaded by JoachimBreitner at 2020-12-31T14:23:03Z

Modules

[Index] [Quick Jump]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Readme for tasty-expected-failure-0.12.2

[back to package description]

tasty-expected-failure

What is this?

With the function expectFail in the provided module ExpectedFailure, you can mark that you expect test cases to fail, and not to pass.

This can for example be used for test-driven development: Create the tests, mark them with expectFail, and you can still push to the main branch, without your continuous integration branch failing.

Once someone implements the feature or fixes the bug (maybe unknowingly), the test suite will tell him so, due to the now unexpectedly passing test, and he can remove the expectFail marker.

The module also provides ignoreTest to avoid running a test. Both funtions are implemented via the more general wrapTest, which is also provided.

Why is this not provided by tasty?

<rant>

The author of the tasty library prefers to provide a minimal experience in the tasty library, instead of a batteries-included approach, and chose not to include these 39 lines of code in tasty. See the issue for the discussion.

Instead I wrote 37 lines of cabal file, a similar number of lines of README, created a git repository, created a travis file, run travis to figure out on what versions it builds (something that would have happened automatically with a pull request for tasty), upload to hackage, add to stackage.

Furthermore, there is little discoverability: If it were part of the tasty API, users would stumble over it. Now they likely won’t. And if they do, they have to worry about whether it is still in sync with tasty, they have to add it to their build-depends, they have to import yet another module. Distribution packagers will have yet another package where they have to create the packaging, check the copyright, and run autobuilders for.

Sigh.

</rant>