Skip to content

42BV/beanie

Repository files navigation

Build Status Codacy Badge BCH compliance Codecov Maven central Javadocs Apache 2

Beanie

Testing is important to guarantee the functionality of an application. These tests often rely on complex data structure as input.

Beanie helps with the construction of these input beans, making tests as readable and understandable as possible, promoting reuse of input data over multiple tests. Beans are constructed using the BeanBuilder API:

Person person = 
    builder.start(Person.class) // Construct person
           .withValue("email", "[email protected]") // Set email
           .withValue("hobbies", "coding") // Add hobbies
           .withValue("hobbies", "gaming") // Add hobbies
           .generateValue("name", new RandomStringGenerator(8, 12)) // Generate name
           .fill() // Generate other values (irrelevant for this test)
           .save(); // Construct and persist the person

Or define a custom builder interface for your data type. This allows for more type-safe data creation and even allows us to define default 'convenience' methods:

public interface PersonBuilder extends EditableBeanBuildCommand<Person> {
    
    PersonBuilder withEmail(String email);
    
    PersonBuilder withName();
    PersonBuilder withName(String name);
    PersonBuilder withName(ValueGenerator generator);
    
    PersonBuilder withHobbies(String hobby);
    PersonBuilder withHobbies(Set<String> hobbies);
    
    default PersonBuilder coder() {
        return this.withHobbies("coding");
    }
    
}

Custom builders are also started using the BeanBuilder:

Person person = 
    builder.startAs(PersonBuilder.class)
           .withEmail("[email protected]")
           .withName("Jan")
           .coder()
           .save();
                             

Specific builder

It is recommended to create a specific builder per type of bean. This type specific builder can have factory methods, such as jan(), which get used in multiple unit tests:

@Component
@AllArgsConstructor
public class Persons {
    
    private final BeanBuilder builder;
    
    public Person jan() {
        return builder.startAs(PersonBuilder.class)
                      .withEmail("[email protected]")
                      .withName("Jan")
                      .coder()
                      .save();
    }
    
}                             

Usage of builders keeps our unit test simple and concise:

public class PersonServiceTest {
    
    private PersonService personService;
    private Persons persons;
    
    @Test
    public void change_email() {
        Person jan = persons.jan();
        
        Person updated = personService.changeEmail(jan, "[email protected]");
        assertEquals("[email protected]", updated.getEmail());
    }
    
}

Getters and setters

Test the getter and setter methods for all beans in a package, using this one liner:

new BeanTester().includeAll().verifyBeans("some.package");

Bean tester will scan the package for beans and verify the getter/setter methods, using both null and non-null generated values. This way we test the consistency of changing a property and retrieving it afterwards.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

Test data generation

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages