Powerunit - Java Testing framework for JDK 1.8 - Extension to provide matchers based on annotations. 0.1.2 API

This is an extension to Powerunit to generate matchers for POJO.

This library provides several annotation processors :

• Processing of the ProvideMatchers annotation.
  This processor create Matcher for each annotated class, in the following way :
  • For public field, create a dedicated matcher, accessing this field by using direct access.
  • For method named getXXX, which haven't any parameter and return something, assume this is a field and create a dedicated matcher, accessing it by using this method.
  • For method named isXXX, which haven't any parameter and return something, assume this is a field and create a dedicated matcher, accessing it by using this method.
  • If this class extends another one (outside Object), a special matcher will be created to check the super class information.
  • Create one (or two if a super class exists) methods to build the matcher. These method are named based on the class name, followed by with.
  • Create dedicated method to compare, using matcher, on object with another.
  • For some specific type, add method to do some matching with more clean name, like XXXIsPresent for an Optional.
  • If some library are available, add special matchers.
• Generating class with all the matchers, directly during annotation processing
  This processor requires to set the parameter ch.powerunit.extensions.matchers.provideprocessor.ProvidesMatchersAnnotationsProcessor.factory (-A parameter).
  This processor create DSL interface for each factory method of the matchers, in the interface defined by this parameter.
• Processing of the Factory annotation (from hamcrest).
  This processor requires to set the parameter ch.powerunit.extensions.matchers.factoryprocessor.FactoryAnnotationsProcessor.targets (-A parameter).
  This processor create DSL interface for each method annotated, in the following way :
  • Static method annotated with the Factory annotation are exposed in an interface, based on the mapping defined by the parameter.
  • The parameter is a list (; separated) on target block, which defines a mapping between regular expression (, separated) and a target class (separated with a :)