What's Changed

• Avoid emitting unnecessary error messages by test cases & remove proc-macro2-diagnostics dependency by @dtolnay in #138

New Contributors

• @dtolnay made their first contribution in #138

Full Changelog: v3.3.0...v3.3.1

Fixes

• Avoid emitting additional misleading error messages by proc-macro2-diagnostics (#138)

What's Changed

• Fix test_matrix example that does not compile in README by @ollien in #133
• Add the ability to have comments in matrix tests by @ollien in #132
• Remove proc-macro-error dependency by @tamird in #136
• .github: replace actions-rs with dtolnay/rust-toolchain, add caching by @tamird in #137

New Contributors

• @tamird made their first contribution in #134
• @ollien made their first contribution in #133

Full Changelog: v3.2.1...v3.3.0

Features

• Allow comments in test-matrix macro (#132)

Improvements

• Drop proc-macro-error dependency & improve error messages (#136)

• Update syn dependency
• Ensure that test-case targets latest core and macros subcrates.

Full Changelog: v3.2.0...v3.2.1

Improvements

• Update syn dependency to 2.0
• Ensure that test-case selects correct version of it's core and macros subcrates

What's Changed

• Retain allow attribute in test_case macro by @JohnPeel in #127
• Add test_matrix macro by @overhacked in #128

New Contributors

• @JohnPeel made their first contribution in #127
• @overhacked made their first contribution in #128

Full Changelog: v3.1.0...v3.2.0

Features

• Add test_matrix macro: generates test cases from Cartesian product of possible test function argument values (#128)

Improvements

• Retain allow attributes on test functions (#127)

What's Changed

• Set MSRV in Cargo.toml to 1.58.1 by @samueltardieu in #116
• Set the span of test function Idents to the span of the origin attribute by @rpwachowski in #119

New Contributors

• @samueltardieu made their first contribution in #116
• @rpwachowski made their first contribution in #119

Full Changelog: v3.0.0...v3.1.0

Features

• Copy attribute span to generated test functions so that IDEs recognize them properly as individual tests

Improvements

• Added LICENSE file to child crates

Overview

This crate provides the #[test_case] procedural macro attribute that generates multiple parametrized tests using one body with different input parameters.
A test is generated for each data set passed in the test_case attribute.
Under the hood, all test cases that share the same body are grouped into a mod, giving clear and readable test results.

Changes

• Split out test-case-core crate, allowing easier reuse in external crates. By @evforde

IMPORTANT

Starting with the 3.0 release, we are changing test-case MSRV policy. We no longer can maintain our goal of only bumping MSRV with major SemVer releases partly due to how fast rust landscape changes and partly to how the rest of the rust ecosystem prefers instead not to keep MSRV breakage treated as SemVer breakage, making stricter policies hard to maintain with limited resources we have. The current goal is to support up to 3 of the latest stable releases.
We hope that with this change, we'll be able to speed up test-case's maintenance processes and add more features in the coming months.

[IMPORTANT] Starting with 3.0 release we are changing test-case MSRV policy to support only 3 latest stable releases.

Improvements

• Split out functional parts of test-case-macros crate into test-case-core for easy reuse by external libraries

What's Changed

• Use fully qualified #[test] attribute path by @alanbriolat in #105

New Contributors

• @alanbriolat made their first contribution in #105

Full Changelog: v2.2.1...v2.2.2

Fixes

• Use fully qualified test macro path to avoid conflicts in workspace (#105)

Bugfix release - ensure test-case depends on correct version of test-case-macros
Full Changelog: v2.2.0...v2.2.1

Fixes

• Ensure test-case depends on correct version of test-case-macros

What's Changed

• Allow ignore reason by @ijc in #103

New Contributors

• @ijc made their first contribution in #103

Full Changelog: v2.1.0...v2.2.0

Features

• Support ignore["reason"] syntax (#102)

What's Changed

• Refactoring: move test-case macro to separate subcrate by @luke-biel in #96
• Add 'len', 'count' and 'empty' complex assertions by @luke-biel in #97
• Add match_regex to complex test-cases by @luke-biel in #98
• Allow keywords in void fn by @luke-biel in #100

Full Changelog: v2.0.2...v2.1.0

Features

• Support matches_regex complex test-case (requires with-regex feature) (#98)
• Support len, count and empty complex test-cases (#97)

Fixes

• Support keyword ignore on void fn (#100)

Improvements

• Move macros to separate subcrate so that test-case can export other things (#96)

Fixes

• Covered missing cases in matches X if Y test_case variant (fixes the fact that previous bug fix didn't produce guard code)

Fixes

• matches Pattern if condition parses correctly (if condition part wasn't allowed)

Features

• => with |x: T| assert!(x) custom inline test assertions
• => using path::to::fn custom fn test assertions
• ignore|inconclusive can be combined with other keywords (eg.: => ignore matches Ok(_))
• => it|is ... syntax is a built-in (previously required hamcrest2 crate integration)
• Tested items are left in place where they were defined #77
• Simple test cases allow Result<(), _> return types similar to native #[test] macro

Improvements

• Significant code refactoring
• Improved test case name selection

Breaking changes

• Deprecation of inconclusive within test description string - it will no longer act like modifier keyword
• Deprecation of hamcrest2 integration
• Deprecation of allow_result feature

Fixes

• Fix regression where panics and inconclusive were not allowed on test_cases returning a value
• Fix case where test_case would allow to return a type when only single attribute was used

Fixes

• test-case no longer allows returning values from tested function without => pattern (thanks to @tarka)
  • Behaviour can be reenabled via allow_result feature

Fixes

• Disabled clippy warning when test-case was generating assert_eq(bool, bool) expression.

Features

• Allow usage of fully qualified attribute #[test_case::test_case] (thanks to @tomprince)

Improvements

• Stopped code from emmiting unneded () expression in test cases with expected fragment (thanks to @martinvonz)

Features

• Added support for using hamcrest2 assertions with test case
• Enabled support of async via tokio or similar
• Enabled attribute passthrough for test cases - it means that you can combine test-case with other testing frameworks, given at least one #[test_case] attribute appears before mentioned framework in testing function

Deprecation

• inconclusive inside test case name will not be supported starting 2.0.0

Features

• Added support for three new keywords: panics, matches and inconclusive which can be applied after => token.

  matches gives possibility to test patterns, like:

  #[test_case("foo" => matches Some(("foo", _)))]
  

  panics gives should_panic(expected="...") for one test_case:

  #[test_case(true  => panics "Panic error message" ; "This should panic")]
  #[test_case(false => None                         ; "But this should return None")]
  

  inconclusive ignores one specific test case.- thanks to @luke_biel

  #[test_case("42")]
  #[test_case("XX" ; "inconclusive - parsing letters temporarily doesn't work, but it's ok")]
  #[test_case("na" => inconclusive ())]
  

Major improvements

• Added extra unit tests - thanks to @luke-biel
• Replace parented_test_case with parsing test_case directly from args - thanks to @luke-biel
• Added keeping trailing underscores in names - thanks to @rzumer

Minor improvements

• Moved lazy-static dependency to dev-dependencies
• Fixed README - thanks to @luke-biel and @drwilco

Upgraded dependencies

• Upgraded insta to 0.12.0

Fixes

• Fixed "inconclusive" feature with different cases.

Fixes

• Added support for impl Trait - it worked in v2.x crate.

Minor improvements

• Added extra test cases

Upgraded dependencies

• Upgraded version_check to v0.9.1

Minor improvements:

• Refreshed readme
• Added CI for stable version of Rust. - thanks to @macisamuele
• Limited crate to Rust 1.29+ - thanks to @macisamuele

Upgraded dependencies:

• Upgraded syn, quote and proc-macro-2 to v1
• Upgraded lazy-static to 1.4.0
• Upgraded insta to 0.11.0

Breaking changes

• Crate has new maintainer: Wojciech Polak :hand: :tada:

• Crate has new name, as test-case-derive had no meaning for derive part.

• Delimiter for test case description is ; instead of ::.

  Reason: :: is valid part of expression and rustc treats const variable as path

New features

• Proper error propagation :tada: When there is for example a typo in function body, rustc can now show location of it instead of test_case location.
• Internally for tests crate uses cargo insta for snapshot testing
• Attribute is now compatible all other attributes like #[should_panic]