mirrormocks

Set of mock classes for javax.lang.model interfaces. For use in unit testing annotation processors.

License	The MIT License (MIT)
Categories	Mirror Application Layer Libs Introspection ORM Data
GroupId	com.flarestarsoftware
ArtifactId	mirrormocks
Last Version	0.2.0
Release Date	Jan 12, 2016
Type	jar
Description	mirrormocks Set of mock classes for javax.lang.model interfaces. For use in unit testing annotation processors.
Project URL	https://github.com/diosmosis/java-mirror-mocks
Source Code Management	https://github.com/diosmosis/java-mirror-mocks

Download mirrormocks

Filename	Size
mirrormocks-0.2.0.pom
mirrormocks-0.2.0.jar	37 KB
mirrormocks-0.2.0-sources.jar	19 KB
mirrormocks-0.2.0-javadoc.jar	155 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.flarestarsoftware/mirrormocks/ -->
<dependency>
    <groupId>com.flarestarsoftware</groupId>
    <artifactId>mirrormocks</artifactId>
    <version>0.2.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.flarestarsoftware/mirrormocks/
implementation 'com.flarestarsoftware:mirrormocks:0.2.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.flarestarsoftware/mirrormocks/
implementation ("com.flarestarsoftware:mirrormocks:0.2.0")

Apache Buildr

'com.flarestarsoftware:mirrormocks:jar:0.2.0'

Apache Ivy

<dependency org="com.flarestarsoftware" name="mirrormocks" rev="0.2.0">
  <artifact name="mirrormocks" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.flarestarsoftware', module='mirrormocks', version='0.2.0')
)

Scala SBT

libraryDependencies += "com.flarestarsoftware" % "mirrormocks" % "0.2.0"

Leiningen

[com.flarestarsoftware/mirrormocks "0.2.0"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.reflections : reflections	jar	0.9.10

Project Modules

There are no modules declared in this project.

java-mirror-mocks

Description

A set of mock classes for the interfaces in the javax.lang.model package. For use in unit testing code in annotation processors.

Usage

The implementations provided by this package use reflection to mimic the mirror API as closely as possible. So to use it during tests, first create a test class that you'd want a Element for, eg:

@MyAnnotationToProcess
public class TestClassWithAnnotation {
    // ...
}

then create the Element using ElementFactory:

import flarestar.mirror.mock.element.ElementFactory;

public class MyAnnotationProcessorComponentTest {

    private MyAnnotationProcessorComponent instance = new MyAnnotationProcessorComponent();

    @Test
    public void testSomething() {
        TypeElement mockElement = ElementFactory.make(TestClassWithAnnotation.class);

        instance.doSomething(mockElement);
    }

This should result in viable unit tests w/o the verbosity that comes hand in hand w/ using mocking frameworks like mockito.

Caveat

The mirror API is very strange. There are many corner cases that are either impossible to replicate via reflection or are cases where I am not positive what the actual behavior should be. So in some cases these mocks may not behave as expected.

It is thus recommended to couple unit tests w/ integration tests that invoke annotation processors through the compiler API. This way, you can get a larger amount of code coverage and the confidence for success in the real world from integration tests, plus easier debugging when performing refactoring from your unit tests.

Versions

Version
0.2.0 Jan 12, 2016
0.1.0 Jan 9, 2016