URL: https://github.com/Pragmatists/JUnitParams
License: Apache License Version 2.0
License File: LICENSE.txt

Description:
Parameterised tests that don't suck

Local Modifications:
      30244565 - Work around the Android API's lack of the class
                 javax.lang.model.type.NullType by replacing
                 with Void.
      30244565 - Work around Android's lack of the
                 java.beans.PropertyEditor and
                 java.beans.PropertyEditorManager classes by
                 removing the usages of them.
      36074730 - Make sure that filters affect the Description.
      36541809 - Hard code the description name to be compatible with CTS
                 and prevent use of @TestCaseName.
                 Ignore tests broken by the above change.
      38419944 - Fix sharding on CTS.
      36541809 - Partially revert 36541809 to allow @TestCaseName to be
                 used as long as it generates a name that is compatible
                 with CTS and AJUR.

# JUnitParams

[![Build Status](https://secure.travis-ci.org/Pragmatists/JUnitParams.png)](http://travis-ci.org/Pragmatists/JUnitParams) [![Coverage Status](https://coveralls.io/repos/Pragmatists/JUnitParams/badge.svg)](https://coveralls.io/r/Pragmatists/JUnitParams) [![Maven Central](https://maven-badges.herokuapp.com/maven-central/pl.pragmatists/JUnitParams/badge.svg)](https://maven-badges.herokuapp.com/maven-central/pl.pragmatists/JUnitParams)

*Parameterised tests that don't suck*

## Example

``` java
@RunWith(JUnitParamsRunner.class)
public class PersonTest {

  @Test
  @Parameters({"17, false",
               "22, true" })
  public void personIsAdult(int age, boolean valid) throws Exception {
    assertThat(new Person(age).isAdult(), is(valid));
  }

}
```
See more [examples](https://github.com/Pragmatists/JUnitParams/blob/master/src/test/java/junitparams/usage/SamplesOfUsageTest.java)


## Latest News

* 2015-01-23 JUnitParams 1.0.4 released. Check [release info.](RELEASES.md)
[more here](https://github.com/Pragmatists/JUnitParams/wiki)

## About
JUnitParams project adds a new runner to JUnit and provides much easier and readable parametrised tests for JUnit >=4.6.

Main differences to standard JUnit Parametrised runner:

* more explicit - params are in test method params, not class fields
* less code - you don't need a constructor to set up parameters
* you can mix parametrised with non-parametrised methods in one class
* params can be passed as a CSV string or from a parameters provider class
* parameters provider class can have as many parameters providing methods as you want, so that you can group different cases
* you can have a test method that provides parameters (no external classes or statics anymore)
* you can see actual parameter values in your IDE (in JUnit's Parametrised it's only consecutive numbers of parameters):

## Quickstart

JUnitParams is available as Maven artifact:
```
<dependency>
  <groupId>pl.pragmatists</groupId>
  <artifactId>JUnitParams</artifactId>
  <version>1.0.4</version>
  <scope>test</scope>
</dependency>
```

If you want to see just one simple test class with all main ways to use JUnitParams see here:
https://github.com/Pragmatists/junitparams/tree/master/src/test/java/junitparams/usage

You can also have a look at [Wiki:Quickstart](https://github.com/Pragmatists/junitparams/wiki/Quickstart)

**Note**: We are currently moving the project from Google Code to Github. Some information may still be accessible only at https://code.google.com/p/junitparams/

URL: https://github.com/Pragmatists/JUnitParams/tree/JUnitParams-1.0.5
Version: 1.0.5
BugComponent: 24949
Owners: paulduffin, jsauer