powerunit-extensions-matchers

• Travis ci :
• Vulnerabilities :
• Coverage : -
• Quality : - - -
• Maven :
• Git :

This is an extension to powerunit (a unit test framework for java 8) that doesn't require this framework, but provides generation of hamcrest matchers. Please check the site for more information

Usage

Basic usage is to add this libraray as a dependency and use the annotation :

@ProvideMatchers
public class PojoShort {
  ...
}

Matchers classes must be created by the annotation processor (in this example, named PojoShortMatchers).

Compatibility

Migration

Migration to version 0.2.X

The version 0.2.0 introduces some major changes in the annotation processor. The idea is mainly that this annotation processor must support several version of the hamcrest library.

When migrating to this version, some actions may be needed :

• The library doesn't provide anymore a transitive dependency to the hamcrest library. You may need to add this library as a dependency of your project. Dependency may be : org.hamcrest:hamcrest:2.2 ; org.hamcrest:hamcrest:2.1 ; org.hamcrest:hamcrest-all:1.3.
• The artifacts powerunit-extensions-matchers-factory and powerunit-extensions-matchers-providematchers are not available any more. Only the master artifact powerunit-extensions-matchers is available and only this one can be used.
• The generated classes doesn't use anymore the @Factory annotation. This annotation only exists in hamcrest 1.3. If you use the annotation processor based on the configuration property ch.powerunit.extensions.matchers.factoryprocessor.FactoryAnnotationsProcessor.targets you will have to change your configuration (see below). This feature was based on this annotation and only compatible with hamcrest 1.3
• By default, the annotation processor only generate the Matchers. If a master DSL interface is required (like the ones produced by the old configuration ch.powerunit.extensions.matchers.factoryprocessor.FactoryAnnotationsProcessor.targets you may use the configuration property ch.powerunit.extensions.matchers.provideprocessor.ProvidesMatchersAnnotationsProcessor.factory. This property takes as value the fully qualified name of an interface to be generated, which will expose all the entry DSL methods generated by this annotation processor. This interface only contains these entry DSL methods ; no additional methods may be added (as it was possible before with @Factory annotation).
• The detection of link between classes and related Matcher has been enhanced. It is possible that for some case when before a field or a parent was not linked, now there are correctly linked. It may change the way the matcher operate (using another matcher to compare and not a is Matcher).
• The META-INF xml file is not generated anymore. This should not be an issue, except if you use it. Metadatas information are added directly to the generated matchers.