https://github.com/bytemechanics/test-drive

Pure Java, zero dependencies testing library
https://github.com/bytemechanics/test-drive

java test-drive unit-testing

Last synced: 1 day ago
JSON representation

Pure Java, zero dependencies testing library

• Host: GitHub
• URL: https://github.com/bytemechanics/test-drive
• Owner: bytemechanics
• License: apache-2.0
• Created: 2018-10-18T05:49:36.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2019-02-19T19:13:13.000Z (almost 6 years ago)
• Last Synced: 2024-12-19T07:10:04.656Z (about 2 months ago)
• Topics: java, test-drive, unit-testing
• Language: Java
• Size: 562 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Copy Commons

[![Latest version](https://maven-badges.herokuapp.com/maven-central/org.bytemechanics/test-drive/badge.svg)](https://maven-badges.herokuapp.com/maven-central/org.bytemechanics/test-drive/badge.svg)

[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=org.bytemechanics%3Atest-drive-parent&metric=alert_status)](https://sonarcloud.io/dashboard/index/org.bytemechanics%3Atest-drive-parent)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=org.bytemechanics%3Atest-drive-parent&metric=coverage)](https://sonarcloud.io/dashboard/index/org.bytemechanics%3Atest-drive-parent)

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

Pure java testing framework implementation

## Motivation

Spock framework is fantastic but use groovy to test java always will be become a mess. After executing a test that should fail and does not fail. Decided that this must be done in pure java.

## Quick start

(Please read our [Javadoc](https://test-drive.bytemechanics.org/docs/javadoc/index.html) for further information)

1. First of all include the Jar file in your compile and execution classpath.

   **Maven**

   ```xml

   

	   org.bytemechanics

	   test-drive

	   X.X.X

	   test

   

   ```

2. In your maven pom.xml activate the surefire test-drive provider by adding the corresponding dependency

   ```xml

	

		

			

				org.apache.maven.plugins

				maven-surefire-plugin

				X.XX.X

				(...)

				

					

						org.bytemechanics

						testdrive-surefire

						X.X.X

					

				

			

		

	

   ```

3. In your maven pom.xml activate the suffix you will use (tipically Spec)

   ```xml

	

		

			

				org.apache.maven.plugins

				maven-surefire-plugin

				X.XX.X

				

					

						*Spec.java

						(...)

					

				

				(...)

			

		

	

   ```

4. Create your first spec

   * Option 1: non-driven

     ```Java

     import org.bytemechanics.testdrive.Specification;

     import org.bytemechanics.testdrive.annotations.Evaluation;

     import org.bytemechanics.testdrive.annotations.Test;

     import org.bytemechanics.testdrive.Assert;

     public class AddIntegerSpec implements Specification {

        (...)

     	@Test(name="accumulate {} and {} should result with {} with driven test", evaluations = {

     		@Evaluation(name = "one",args = {"1","1","0","2"}),

     		@Evaluation(name = "zero",args = {"0","0","0","0"})

     	})

     	public void accumulate(final int _base,final int _val1,final int _val2,final int _expected){

			int base=_base;

			int actual=base+_val1+_val2;

			Assert.assertEquals(actual,_expected);

     	}

        (...)

     }

     ```

   * Option 2: non-driven with labels

     ```Java

     import org.bytemechanics.testdrive.Specification;

     import org.bytemechanics.testdrive.annotations.Evaluation;

     import org.bytemechanics.testdrive.annotations.Test;

     import org.bytemechanics.testdrive.Assert;

     public class AddIntegerSpec implements Specification {

        (...)

     	@Test(name="accumulate {} and {} should result with {} with driven test", evaluations = {

     		@Evaluation(name = "one",args = {"1","1","0","2"}),

     		@Evaluation(name = "zero",args = {"0","0","0","0"})

     	})

     	public void accumulate(final int _base,final int _val1,final int _val2,final int _expected){

			int base,actual;

			given:

				base=_base;

			when:

				actual=base+_val1+_val2;

			then:

				Assert.assertEquals(actual,_expected);

     	}

        (...)

     }

     ```

   * Option 3: driven

     ```Java

     import org.bytemechanics.testdrive.DrivenTest;

     import org.bytemechanics.testdrive.Specification;

     import org.bytemechanics.testdrive.annotations.Evaluation;

     import org.bytemechanics.testdrive.annotations.Test;

     import org.bytemechanics.testdrive.example.AddInteger;

     import org.bytemechanics.testdrive.exceptions.AssertException;

     import org.bytemechanics.testdrive.Assert;

     public class AddIntegerSpec implements Specification {

        (...)

     	@Test(name="accumulate {} and {} should result with {} with driven test", evaluations = {

     		@Evaluation(name = "one",args = {"1","1","0","2"}),

     		@Evaluation(name = "zero",args = {"0","0","0","0"})

     	})

		public DrivenTest accumulateDriven(final int _base,final int _val1,final int _val2,final int _expected){

			return new DrivenTest() {

				int base,actual;

				@Override

				public void given() {

					this.base=_base;

				}

				@Override

				public void when() {

					this.actual=this.base+_val1+_val2;

				}

				@Override

				public void then() throws AssertException {

					Assert.assertEquals(this.actual,_expected);

				}

			};

		}

        (...)

     }

     ```

For additional information please refer example project