Fixture Factory alternatives and similar libraries
Based on the "Testing" category
-
TestContainers
Provides throwaway instances of common databases, Selenium web browsers, or anything else that can run in a Docker container. -
PowerMock
Enables mocking of static methods, constructors, final classes and methods, private methods and removal of static initializers. -
PIT
Fast mutation-testing framework for evaluating fault-detection abilities of existing JUnit or TestNG test-suites. -
GreenMail
In-memory email server for integration testing. Supports SMTP, POP3 and IMAP including SSL. -
Mutability Detector
Reports on whether instances of a given class are immutable. -
junit-dataprovider
A TestNG like dataprovider runner for JUnit. -
Randomized Testing
JUnit test runner and plugins for running JUnit tests with pseudo-randomness. -
Scott Test Reporter
Detailed failure reports and hassle free assertions for Java tests - Power Asserts for Java -
J8Spec
J8Spec is a library that allows tests written in Java to follow the BDD style introduced by RSpec and Jasmine.
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest. Visit our partner's website for more details.
Do you think we are missing an alternative of Fixture Factory or a related project?
README
Fixture Factory is a tool to help developers quickly build and organize fake objects for unit tests. The key idea is to create specification limits of the data (templates) instead of hardcoded data. Try using F-F, then you can focus on the behavior of your methods and we manage the data.
Installing
Use it like a maven dependency on your project
<dependency>
<groupId>br.com.six2six</groupId>
<artifactId>fixture-factory</artifactId>
<version>3.1.0</version>
</dependency>
Usage
Writing template rules
Fixture.of(Client.class).addTemplate("valid", new Rule(){{
add("id", random(Long.class, range(1L, 200L)));
add("name", random("Anderson Parra", "Arthur Hirata"));
add("nickname", random("nerd", "geek"));
add("email", "${nickname}@gmail.com");
add("birthday", instant("18 years ago"));
add("address", one(Address.class, "valid"));
}});
Fixture.of(Address.class).addTemplate("valid", new Rule(){{
add("id", random(Long.class, range(1L, 100L)));
add("street", random("Paulista Avenue", "Ibirapuera Avenue"));
add("city", "São Paulo");
add("state", "${city}");
add("country", "Brazil");
add("zipCode", random("06608000", "17720000"));
}});
You can also create a new template based on another existing template. Using this you can override the definition for a property
Fixture.of(Address.class).addTemplate("augustaStreet").inherits("valid", new Rule(){{
add("street", "Augusta Street");
}});
Using on your tests code:
Gimme one object from label "valid"
Client client = Fixture.from(Client.class).gimme("valid");
Gimme N objects from label "valid"
List<Client> clients = Fixture.from(Client.class).gimme(5, "valid");
Gimme N objects each one from one label
List<Client> clients = Fixture.from(Client.class).gimme(2, "valid", "invalid");
Additional helper functions to create generic template:
Managing Templates
Templates can be written within TemplateLoader interface
public class ClientTemplateLoader implements TemplateLoader {
@Override
public void load() {
Fixture.of(Client.class).addTemplate("valid", new Rule(){{
add("id", random(Long.class, range(1L, 200L)));
add("name", random("Anderson Parra", "Arthur Hirata"));
add("nickname", random("nerd", "geek"));
add("email", "${nickname}@gmail.com");
add("birthday", instant("18 years ago"));
add("address", one(Address.class, "valid"));
}});
Fixture.of(Address.class).addTemplate("valid", new Rule(){{
add("id", random(Long.class, range(1L, 100L)));
add("street", random("Paulista Avenue", "Ibirapuera Avenue"));
add("city", "São Paulo");
add("state", "${city}");
add("country", "Brazil");
add("zipCode", random("06608000", "17720000"));
}});
}
}
All templates can be loaded using FixtureFactoryLoader telling what package that contains the templates
FixtureFactoryLoader.loadTemplates("br.com.six2six.template");
Example of loading templates with JUnit tests
@BeforeClass
public static void setUp() {
FixtureFactoryLoader.loadTemplates("br.com.six2six.template");
}
Processors
Fixture-Factory comes with a simple mechanism to execute custom logic after the generation of each object.
To do so, implement the Processor interface:
public class MyCustomProcessor implements Processor {
public void execute(Object object) {
//do something with the created object
}
}
And use it:
Fixture.from(SomeClass.class).uses(new MyCustomProcessor()).gimme("someTemplate");
The #execute method will be called for each object that Fixture-Factory generates. For instance, if a Client has an Address, the framework will generate the Address, call #execute with the generated Address as argument, set the Address into the Client, call #execute with the generated Client as argument and then return it.
In case you want to persist the generated object in your database and you are using Hibernate, we already have a HibernateProcessor that persists all created objects using the provided session:
Fixture.from(Client.class).uses(new HibernateProcessor(session)).gimme("valid");
Relationship (one-to-one and one-to-many)
Fixture.of(Order.class).addTemplate("valid", new Rule(){{
add("id", random(Long.class, range(1L, 200L)));
add("items", has(3).of(Item.class, "valid"));
// add("items", has(3).of(Item.class, "valid", "invalid", "external")); this will generate three Item, each one from one of the given templates
add("payment", one(Payment.class, "valid"));
}});
Fixture.of(Item.class).addTemplate("valid", new Rule(){{
add("productId", random(Integer.class, range(1L, 200L)));
}});
Fixture.of(Payment.class).addTemplate("valid", new Rule(){{
add("id", random(Long.class, range(1L, 200L)));
}});
Regex
Fixture.of(Any.class).addTemplate("valid", new Rule(){{
add("id", regex("\\d{3,5}"));
add("phoneNumber", regex("(\\d{2})-(\\d{4})-(\\d{4})"));
});
Date
Fixture.of(Any.class).addTemplate("valid", new Rule(){{
add("dueDate", beforeDate("2011-04-15", new SimpleDateFormat("yyyy-MM-dd")));
add("payDate", afterDate("2011-04-15", new SimpleDateFormat("yyyy-MM-dd")));
add("birthday", randomDate("2011-04-15", "2011-11-07", new SimpleDateFormat("yyyy-MM-dd")));
add("cutDate", instant("now"));
});
Name
Fixture.of(Any.class).addTemplate("valid", new Rule(){{
add("firstName", firstName());
add("lastName", lastName());
});
Unique random
Fixture.of(Any.class).addTemplate("valid", new Rule() {{
add("country", "Brazil");
add("state", uniqueRandom("São Paulo", "Rio de Janeiro", "Minas Gerais", "Bahia"));
}});
The attribute state of this fixture will contain an unique value each time it is generated. Note that if this fixture is generated more times than there are available state values, the state values will start to repeat.
CNPJ
Fixture.of(User.class).addTemplate("valid", new Rule() {{
add("cnpj", cnpj()); // this will generate an unformatted CNPJ e.g. 11111111111111
add("cnpj", cnpj(true)); this will generate a formatted CNPJ e.g. 11.111.111/1111-11
}});
You can see more utilization on tests!
Contributing
Want to contribute with code, documentation or bug report?
Do it by joining the mailing list on Google Groups.
Credits
Fixture-Factory was written by:
with contributions from several authors, including:
License
Fixture-Factory is released under the Apache 2.0 license. See the LICENSE file included with the distribution for details.
*Note that all licence references and agreements mentioned in the Fixture Factory README section above
are relevant to that project's source code only.