1. RENDEZ VOS ASSERTIONS
LISIBLES AVEC FEST ASSERT

2. QUI SUIS JE ?
• Nicolas François @nicofrancois
• Développeur Java chez Sfeir
• Contributeur Fest Assert 2.0

3. QUESTIONS FRÉQUENTES
• TDD/BDD ?
• JUnit ou TestNG ?
• EasyMock ou Mockito ?

4. ET LES ASSERTIONS ?
• Définition : Proposition donnée et soutenue comme vraie
• Se doit d’exprimer une règle à vérifier : au coeur du test

5. VOCABULAIRE LIMITÉ
• Fournies par JUnit et TestNG :
• assertTrue/assertFalse(maProposition);
• assertEquals(valeur, monObject);
• assertNull/NotNull(monObject);
• assertSame(monObject1, monObject2)

6. SYNTAXE «YODA»
• assertEquals(51, breizhCampSpeakers.size());
Egale à 51 doit être la taille de
la liste des speakers

7. LE PROBLÈME....
• Exprimerune proposition avec un vocabulaire pauvre et
syntaxe non naturelle.

8. HAMCREST
assertThat(breizhCampSpeakers, hasSize(51));
• Vocabulaire plus riche
• Meilleure syntaxe
• Repose sur les Matcher
• Ne dépend pas du type
• Il faut connaitre le matcher à utiliser

9. FEST ASSERT
assertThat(breizhCampSpeakers).hasSize(51);
• Vocabulaire plus riche
• Meilleure syntaxe
• Repose sur les méthodes
• Dépend du type
• Découverte des méthodes par

10. ORIENTÉ SUR LE TYPE
• assertThat(XXX) => retourne un XXXAssert
• Différents
types supportés : ListAssert, StringAssert,
IntegerAssert, FileAssert, ThrowableAssert, ...

11. FLUENT API
assertThat(breizhCampSpeakers).isNotNull()
.hasSize(51)
.doesNotContainNull()
.doesNotHaveDuplicates();

12. EXTENSIBLE

13. CONDITION
• Etendre l’existant
private final Condition<String> jedi = new Condition<String>("jedi") {
private final Set<String> jedis = set("Luke", "Yoda", "Obiwan");
@Override
public boolean matches(String value) {
return jedis.contains(value);
}
};
assertThat("Yoda").is(jedi);
assertThat("Vader").isNot(jedi);
assertThat("Yoda").has(jediPower);
assertThat("Solo").doesNotHave(jediPower);

14. ASSERTIONS
PERSONNALISÉES
• Propres aux objets métiers
public class TolkienCharacterAssert extends AbstractAssert<TolkienCharacterAssert, TolkienCharacter> {
public TolkienCharacterAssert(TolkienCharacter actual) {
super(actual, TolkienCharacterAssert.class);
}
public TolkienCharacterAssert hasName(String name) {
// check that actual TolkienCharacter we want to make assertions on is not null.
isNotNull();
// we overrides the default error message with a more explicit one
String errorMessage = format("Expected character's name to be <%s> but was <%s>", name, actual.getName());
// raw assertion : no WritableAssertionInfo usage - simpler but not friendly with custom comparison strategy (i.e.
usingComparator method)
if (!actual.getName().equals(name)) { throw new AssertionError(errorMessage); }
return this; // return the current assertion for method chaining
}
}

15. FEST ASSERT 2.0
• Ré-écriture complète
• En cours de développement (Actuellement M5)
• Vos idées sont les bienvenues

16. NOUVEAUTÉS (1/2)
• Nouveau type d’assertions :
Date, Image, InputStream, Iterable, ...
• Filtrage
assertThat(filter(players).having(mvpStats).get()).containsOnly(rose, james);
• Extraction
assertThat(extractProperty("id", Long.class).from(fellowshipOfTheRing)).contains(1L, 2L, 3L);
assertThat(extractProperty("race.name").from(fellowshipOfTheRing)).contains("Hobbit", "Elf")

17. NOUVEAUTÉ (2/2)
• Egalité clémente
TolkienCharacter mysteriousHobbit = new TolkienCharacter(null, 33, HOBBIT);
assertThat(sam).isLenientEqualsToByIgnoringNullFields(mysteriousHobbit);
assertThat(frodo).isLenientEqualsToByIgnoringFields(sam, "name", "age");
assertThat(frodo).isLenientEqualsToByAcceptingFields(sam, "race");
• Meilleur support des conditions
assertThat(set("Luke", "Yoda", "Leia")).areExactly(2, jedi);
assertThat("Vader").is(anyOf(jedi, sith));
assertThat("Solo").is(allOf(not(jedi), not(sith)));

18. CONCLUSION
• Ne faite plus d’assertions avec JUnit ou TestNG
• Expressivité lisibilité
• Fest Assert fait partie du projet Fixtures for Easy Software
Testing. Il n’est pas seul :
A voir aussi Fest Reflect, Fest Swing

19. RESSOURCES
• Code source
https://github.com/alexruiz/fest-assert-2.x
• Guide utilisateur
https://github.com/alexruiz/fest-assert-2.x/wiki
• Page Google+
http://gplus.to/fest
• Exemple
https://github.com/joel-costigliola/fest-examples

20. QUESTIONS ?