kodo

Kodo is a test framework that helps you creating Specs with the help of a fluent interface.

License

License

GroupId

GroupId

tools.devnull
ArtifactId

ArtifactId

kodo
Last Version

Last Version

3.5.2
Release Date

Release Date

Type

Type

jar
Description

Description

kodo
Kodo is a test framework that helps you creating Specs with the help of a fluent interface.
Project URL

Project URL

https://github.com/devnull-tools/kodo
Source Code Management

Source Code Management

https://github.com/devnull-tools/kodo

Download kodo

How to add to project

<!-- https://jarcasting.com/artifacts/tools.devnull/kodo/ -->
<dependency>
    <groupId>tools.devnull</groupId>
    <artifactId>kodo</artifactId>
    <version>3.5.2</version>
</dependency>
// https://jarcasting.com/artifacts/tools.devnull/kodo/
implementation 'tools.devnull:kodo:3.5.2'
// https://jarcasting.com/artifacts/tools.devnull/kodo/
implementation ("tools.devnull:kodo:3.5.2")
'tools.devnull:kodo:jar:3.5.2'
<dependency org="tools.devnull" name="kodo" rev="3.5.2">
  <artifact name="kodo" type="jar" />
</dependency>
@Grapes(
@Grab(group='tools.devnull', module='kodo', version='3.5.2')
)
libraryDependencies += "tools.devnull" % "kodo" % "3.5.2"
[tools.devnull/kodo "3.5.2"]

Dependencies

compile (1)

Group / Artifact Type Version
org.hamcrest : hamcrest-core Optional jar 1.3

test (2)

Group / Artifact Type Version
junit : junit jar 4.11
org.mockito : mockito-core jar 2.7.13

Project Modules

There are no modules declared in this project.

Kodo

Kodo is a test framework that helps you defining specifications with the help of a fluent interface. The idea behind is to put some functional interfaces present in Java 8 together to provide a beautiful way to define specifications in pure Java code. Its main use if for testing but you can use for any purposes that requires the writing of a specification.

How To Build

Just make sure you have Maven and run the command maven package. To install kodo on your local maven repository, use the command maven install.

How to Use

Just put the really small kodo jar file on your classpath. You can also install kodo on your local repository and then define it on your pom or gradle build:

  • groupId: io.backpackcloud
  • artifactId: kodo

Kodo is also in Maven Central. Just use the above groupId and artifactId to declare the dependency.

Defining Specifications

To define a new specification, use the Spec class. It defines an entry point to the fluent interface:

Spec.given(someObject);

Spec.begin(); // for specifications without a target 

With the SpecDefinition interface returned, you can use a set of methods to describe behaviours:

Spec.given(someObject)
  .when(obj -> obj.foo())
  .expect(it(), obj -> obj.isValid());

This can be refactored to a more elegant code:

Spec.given(someObject)
  .when(itExecutes()) // an extracted method
  .expect(it(), to().be(valid())); // an extracted method

And messages may be supplied:

Spec.given(someObject)
  .when(itExecutes())
  .expect(it(), to().be(valid()), because("the process should not invalidate the object"));

You can also describe the whole Spec:

Spec.describe("My spec for testing my object")
  .given(myObject)
  .expect ...

Here is more examples:

Account accountA = new Account(500);
Account accountB = new Account(500);

Spec.begin()
  .expect(the(accountA), to().have(balanceOf(500)))
  .expect(the(accountB), to().have(balanceOf(500)))
  
  .when(() -> accountA.transfer(100).to(accountB))
  
  .expect(the(accountA), to().have(balanceOf(400)))
  .expect(the(accountB), to().have(balanceOf(600)))

  .expect(() -> accountA.transfer(1000).to(accountB), to().raise(InsufficientBalanceException.class))
  
  .expect(the(accountA), to().have(balanceOf(400)))
  .expect(the(accountB), to().have(balanceOf(600)));

// helper methods

  public static Predicate<Account> balanceOf(double value) {
    // Please don't use this comparisson in a real case scenario
    // this is just an example
    return account -> account.balance() == value;
  }
Spec.describe("A trader is alerted of status")
  .given(newStock("STK").withThresholdOf(15.0))

  .when(tradeAt(5.0))
  .expect(alert(), to().be("OFF"))

  .when(tradeAt(16.0))
  .expect(alert(), to().be("ON"));

// helper methods omitted

Also, take a look at the Expectation class. It contains a set of useful methods to help you write your awesome specifications!

How To Contribute

Fork it, fire an issue, spread the project, use the project... any help will be great! And, please, let me know if you're liking Kodo (or not).

tools.devnull

/dev/null > tools

Because great ideas may come from nothing!

Versions

Version
3.5.2
3.5.1
3.5.0
3.4.1
3.4.0
3.3.0
3.2.0
3.1.0
3.0.1
3.0.0
2.1.0
2.0.0
1.1.0
1.0.1
1.0.jdk5
1.0
0.4.2.jdk5
0.4.1.jdk5
0.4.1