Schreib' die Tests, die du auch lesen magst! · 2019-12-20 · © 2018 andrena objects ag...

Experts in agile software engineering

andrena objects ag

Schreib‘ die Tests, die du auch lesen magst!

6. November 2019

XP Days Germany 2019

Claudia Fuhrmann

André Kappes

Wer von Euch hat…

… schon einmal an einem roten Test gesessen und nicht

verstanden, was er eigentlich bewirken soll?

… diesen Test selbst geschrieben?

Code-Typografie

Experts in agile software engineering 3

Namensgebung

Übersichtlichkeit Prägnanz

Lesbare Tests

Das Projekt

Online - Obstversand

Warenkorb

Banane Orange

Ananas Kiwi

Vorkasse

PayPal

Rechnung

Kreditkarte

Lastschrift

Preisberechnung

Preisreduzierungen,

z.B. ab der X-ten

Birne kostet jede

weitere nur noch Y €

Code-Typografie

Namensgebung

Lesbare Tests

Regeln aus der Typografie

• Lange Zeilen bzw. Umbrüche vermeiden

• Durch Absätze strukturieren

• AAA-Pattern zur Orientierung: Gliederung des Tests in Abschnitten nach Arrange – Act – Assert

Strukturierung mit dem AAA-Pattern

void testAdd() {

PreisRepository preisRepository = new PreisRepository();

preisRepository.save(ObstTyp.BIRNE,

PreisStrategyFactory.createNormalPreisStrategy(Money.of(0.70)));

Warenkorb warenkorb = new Warenkorb(preisRepository);

warenkorb.add(5, ObstTyp.BIRNE);

List<Posten> posten = warenkorb.getPosten();

assertEquals(ObstTyp.BIRNE, posten.get(0).getTyp());

assertEquals(8, posten.get(0).getAnzahl());

assertEquals(Money.of(5.60), posten.get(0).getPreis());

Strukturierung mit dem AAA-Pattern

void testAdd() {

Arrange

Assert

Code-Typografie

Namensgebung

Lesbare Tests

Wie soll sie denn heißen? Sprechende Namen finden

*) Variable, Testmethode

Sprechende Namen finden

class BestellServiceTest {

private KundenRepository repositoryMock = mock(KundenRepository.class);

private BestellService service = new BestellService(repositoryMock);

void berechnePreis() {

PreisRepository repository = new PreisRepository();

repository.save(BIRNE, reduzierterPreisAb(5, of(0.70), of(0.50)));

Warenkorb input = new Warenkorb(repository);

input.add(5, BIRNE);

BestellUebersicht bU = service.getBestellUebersicht(input);

assertEquals(Money.of(3.30), bU.getGesamtpreis());

Gute Namen

• Zweck der Variablen / des Felds in diesem Testfall erklären

• Generische Namen vermeiden – spezifische Namen bevorzugen

• Lesbar / aussprechbar

• Je kleiner der Scope, desto kürzer der Name

• Unterscheidbare Namen verwenden

13 Experts in agile software engineering

Magic Values

preisRepository.save(BIRNE, reduzierterPreisAb(5, of(0.70), of(0.50)));

Warenkorb mit5Birnen = new Warenkorb(preisRepository);

mit5Birnen.add(5, BIRNE);

BestellUebersicht uebersicht = bestellService.getBestellUebersicht(mit5Birnen);

assertEquals(Money.of(3.30), uebersicht.getGesamtpreis());

Warum 3.30?

Magic Values

preisRepository.save(BIRNE, reduzierterPreisAb(5, of(0.70), of(0.50)));

Warenkorb mit5Birnen = new Warenkorb(preisRepository);

mit5Birnen.add(5, BIRNE);

BestellUebersicht uebersicht = bestellService.getBestellUebersicht(mit5Birnen);

assertEquals(PREIS_FUER_VIER_BIRNEN.plus(REDUZIERTER_PREIS_FUER_FUENFTE_BIRNE),

uebersicht.getGesamtpreis());

Erklärende Konstanten

Testmethoden benennen

Namenskonvention von Roy Osherove:

Function/Feature – Input/State – Outcome/Behaviour

17 Experts in agile software engineering

@Test void berechnePreis_reduktionAb5Birnen_wirdBeachtet() { ... }

@Test void berechnePreis () { ... }

Empfehlungen

• Erklärende Namen für lokale Variablen und Felder wählen

• Testmethode aussagekräftig benennen

• Magic Values vermeiden

Code-Typografie

Namensgebung

Lesbare Tests

Prägnanz

private Posten EINE_ANANAS = Posten.of(1, ANANAS, Money.of(3.00));

private Posten EINE_BANANE = Posten.of(1, BANANE, Money.of(2.00));

private Posten EIN_APFEL = Posten.of(1, APFEL, Money.of(1.50));

private Posten EINE_BIRNE = Posten.of(1, BIRNE, Money.of(1.00));

private Posten EINE_KIWI = Posten.of(1, KIWI, Money.of(3.50));

private Posten EINE_ORANGE = Posten.of(1, ORANGE, Money.of(2.50));

private PreisRepository preisRepository;

private KundenRepository kundenRepository;

@BeforeEach

void setUp() {

preisRepository = new PreisRepository();

PreisRepositoryInitializer.create(preisRepository).init();

kundenRepository = new KundenRepository();

void testWarenkorb() {

warenkorb.add(1, ANANAS);

warenkorb.add(1, BANANE);

warenkorb.add(1, APFEL);

warenkorb.add(1, BIRNE);

warenkorb.add(1, KIWI);

warenkorb.add(1, ORANGE);

UUID kundenId = warenkorb.getKundenId();

assertThat(kundenId).isNotNull();

assertThat(posten).contains(EINE_ANANAS);

assertThat(posten).contains(EINE_BANANE);

assertThat(posten).contains(EIN_APFEL);

assertThat(posten).contains(EINE_BIRNE);

assertThat(posten).contains(EINE_KIWI);

assertThat(posten).contains(EINE_ORANGE);

KundenId setzen

Posten im Warenkorb

Zu lang und unübersichtlich!

Fragen, die ich mir stellen sollte, wenn der Test zu lang ist:

• Kann man den Test aufteilen, weil nicht alles in diesen Test gehört?

• Gehören die einzelnen Asserts in eine andere Testklasse?

• Hat die getestete Klasse zu viele Verantwortlichkeiten?

Prägnanz

@Test void kundenIdIstNichtNull() { Warenkorb warenkorb = new Warenkorb(preisRepository);

UUID kundenId = warenkorb.getKundenId();

assertThat(kundenId).isNotNull(); } @Test void getPosten() { Warenkorb warenkorb = WarenkorbBuilder.get() .addAnanas(1) .addBananen(1).create();

assertThat(posten).containsExactlyInAnyOrder(EINE_ANANAS, EINE_BANANE); }

Kurze Tests

Wenige Zusicherungen

Empfehlungen

Tests sollten:

• kurz sein

• wenige Zusicherungen haben, am besten nur eine

• in den dazugehörigen Testklassen sein

Wenn dein Test nicht mehr auf deinen Bildschirm passt, ist er definitiv zu lang!

Sprechende Zusicherungen und Fehlermeldungen

void testZahlungsService() {

BestellUebersicht ueberLimit = mock(BestellUebersicht.class);

when(ueberLimit.getGesamtpreis()).thenReturn(UEBER_LIMIT_FUER_RECHNUNG);

ZahlungsService zahlungsService = new ZahlungsService(new KundenRepository());

List<ZahlungsArt> angeboteneZahlungsArten = zahlungsService.getZahlungsarten(ueberLimit);

assertTrue(!angeboteneZahlungsArten.contains(ZahlungsArt.RECHNUNG));

Negation Keine Informationen über den Grund eines Fehlschlags

assertTrue(!angeboteneZahlungsArten.contains(ZahlungsArt.RECHNUNG),"Zahlart 'Rechnung‘ nicht enthalten!");

Aussagekräftiger Kommentarstring

assertThat(angeboteneZahlungsArten).doesNotContain(ZahlungsArt.RECHNUNG);

Assertj Matcher

Empfehlungen

• Zusicherungen möglichst präzise formulieren

• Auf sprechende Fehlermeldung im Testfehlschlags-Fall achten

Code-Typografie

Namensgebung

Lesbare Tests

Hin- und Herspringen

public class BestellUebersichtTest extends WarenkorbTest { private Posten EINE_BANANE = Posten.of(1, BANANE, Money.of(2.00)); private Posten EINE_ANANAS = Posten.of(1, ANANAS, Money.of(3.00)); private PreisRepository preisRepository = new PreisRepository(); private KundenRepository kundenRepository; private BestellService underTest; @BeforeEach void setUp() { PreisRepositoryInitializer.create(preisRepository).init(); underTest = new BestellService(kundenRepository); }

Wie sehen die Preise aus?

Warum? Was gibt es dort?

@Test void getBestellUebersicht_eineAnanasUndEineBanane_BestelluebersichtOk() { Warenkorb warenkorb = createWarenkorbWithAnanasUndBanane(preisRepository);

BestellUebersicht bestellUebersicht = underTest.getBestellUebersicht(warenkorb);

assertBestellUebersicht(bestellUebersicht, warenkorb.getKundenId(), Money.of(5.00), EINE_ANANAS, EINE_BANANE); } private void assertBestellUebersicht(BestellUebersicht bestellUebersicht, UUID kundenId, Money preis, Posten... posten) { assertThat(bestellUebersicht.getGesamtpreis()).isEqualTo(preis); assertThat(bestellUebersicht.getPosten()).containsExactlyInAnyOrder(posten); assertThat(bestellUebersicht.getKundenId()).isEqualTo(kundenId); }

Wo finde ich diese Methode?

Was testet dieses Assert?

public class BestellServiceTest {

private Money PREIS_EINE_ANANAS = Money.of(3.00);

private Money PREIS_EINE_BANANE = Money.of(2.00);

private Posten EINE_ANANAS = Posten.of(1, ANANAS, PREIS_EINE_ANANAS);

private Posten EINE_BANANE = Posten.of(1, BANANE, PREIS_EINE_BANANE);

private KundenRepository kundenRepository;

private BestellService underTest;

@BeforeEach

void setUp() {

kundenRepository = new KundenRepository();

underTest = new BestellService(kundenRepository);

Keine magische Preiserstellung

void getBestellUebersicht_eineAnanasUndEineBanane_BestelluebersichtOk() {

Warenkorb warenkorb = WarenkorbBuilder.warenkorb().withKundenId(KUNDEN_ID)

.addAnanas(1, PREIS_EINE_ANANAS)

.addBananen(1, PREIS_EINE_BANANE).create();

BestellUebersicht bestellUebersicht = underTest.getBestellUebersicht(warenkorb);

assertThat(bestellUebersicht)

.hasGesamtpreis(PREIS_EINE_ANANAS.plus(PREIS_EINE_BANANE))

.hasPosten(EINE_ANANAS, EINE_BANANE)

.hasKundenId(KUNDEN_ID);

Builder, der den Warenkorb samt Preise erstellt

Custom matcher

Empfehlungen und Lösungsansätze

• Relevantes sichtbar machen, Irrelevantes verbergen

• Builder Pattern

• Custom Matchers

Noise stört die Lesbarkeit

void testAdd() {

Weniger Noise durch Syntactic Sugar

void testAdd() {

PreisRepository repository = new PreisRepository();

repository.save(BIRNE, normalPreis(0.70));

Warenkorb warenkorb = new Warenkorb(repository);

Posten soleItem = warenkorb.getPosten().get(0);

assertEquals(BIRNE, soleItem.getTyp());

assertEquals(8, soleItem.getAnzahl());

assertEquals(Money.of(5.60), soleItem.getPreis());

Static imports verwenden

Erklärende Variablen einführen

private PreisStrategy normalPreis(double value) { return PreisStrategyFactory.createNormalPreisStrategy(of(value)); }

Syntactic sugar-Methoden extrahieren

Zusammenfassung

Code-Typografie

Namensgebung

Lesbare Tests

Kümmere Dich um Eure Tests!

Nimm Dein Team mit!

Referenzen

Bücher

• Roy Osherove, The Art of Unit Testing (Manning, 2013)

• Gerard Meszaros, xUnit Test Patterns: Refactoring Test Code (Addison Wesley, 2007) http://xunitpatterns.com/

• Petri Kainulainen, Writing Clean Tests https://www.petrikainulainen.net/writing-clean-tests/

• Thomas Countz, Essential & Relevant: A Unit Test Balancing Act https://8thlight.com/blog/thomas-countz/2019/02/19/essential-and-relevant-unit-tests.html

Vielen Dank!

Euer Feedback

Schreib‘ die Tests, die du auch lesen magst!

Schreib' die Tests, die du auch lesen magst! · 2019-12-20 · © 2018 andrena objects ag...

Documents

r] DU! Mach mit beim Musikwettbewerb Schreib' einenSong ... · r] DU! Mach mit beim Musikwettbewerb Schreib' einenSong über deine Stadt und gewinne einen Liveauftritt und tolle Preise

Schreib- und Sprachkompetenz im Geschichtsunterricht · Schreib- und Sprachkompetenz im Geschichtsunterricht Sven Oleschko Bezirksregierung Arnsberg / Universität Duisburg-Essen

Jnhalt des Krakauer Schreib-Kalenders.€¦ · Jnhalt des Krakauer Schreib-Kalenders. 6:11: Summacigcr 111: 1938 nub 1939 . . 2 Rnlcuhnrmm , . . . . . .s-sa Ongoriuniirber 1111b SulianiMcr

Agile Ressourcenplanung - OIO€¦ · 1 Orientation in Objects GmbH Weinheimer Str. 68 68309 Mannheim Version: info@oio.de Agile Ressourcenplanung 1.0 © 2012 Orientation in Objects

Anwendungsentwicklung mit ABAP Objects

Testgetriebene Entwicklung mit Vulcan.NETund Visual Objects · 2006. 11. 22. · Testgetriebene Entwicklung mit Vulcan.NETund Visual Objects 1. Grundlagen Testgetriebene Entwicklung

Schreib Kultur

Acquisition, Transmission and Rendering of Objects …hss.ulb.uni-bonn.de/2015/4222/4222a.pdf · Objects with Optically Complicated Material Appearance Dissertation zur Erlangung

Manuscript cataloguing in comparative perspective State of ... · Common challenges for mss - Unique cultural heritage objects - Individual cultural heritage objects - Valuable cultural

Einführung in die Astronomie und Astrophysik I · Camenzind: Compact Objects, Vorlesungsskript, Uni Heidelberg 2001 Compact Objects in Astrophysics, Springer 2007 Albert Einstein

Schreib l Ehr Gang

Schreib Did Ak Tik

ABAP® Objects - Willkommen — Verbundzentrale des … · Horst Keller, Sascha Krüger ABAP® Objects ABAP-Programmierung mit SAP NetWeaver Galileo Press

SAP Integration von Business Objects am Beispiel von SAP ... · PDF fileAnbindung von Business Objects Werkzeugen an SAP-Systeme • Crystal Reports • Direkte Anbindung an SAP mittels

Wegweiser bei Schreib-, Lese- oder Rechenschwierigkeiten

Andreas Boes, ISF München - andrena objects...2020/04/15 · kritischer Erfolgsfaktor Mind Maps Andreas Boes: Rationalisiert Scrum die Architekten weg? München, 20.04.15 000 1

Sandras Schreib- und Lernwerkstatt, Grasberg · 2017. 9. 12. · Übungen zu den doppelten Konsonanten © Sandras Schreib- und Lernwerkstatt & Fern-Coaching ~ Sandra Gau ~ 3 Vorwort:

Towards a Classification of Neoclassical Objects in

PRAXISBUCH FÜR LEHRERINNEN 1./2. Klasse SCHREIB- UND ...€¦ · SCHREIB- UND GRAPHOMOTORIK ISBN 978-3-946508-33-5 € 39,95 [D] € 41,10 [A] ED/1011-19 1065207 SCHREIBEN LERNEN

Teil I ABAP Objects Grundlagen - · PDF file7 Teil I ABAP Objects Grundlagen Grundlagen der objektorientierten Programmierung unter ABAP Frank Wolf, ABAP® Objects, dpunkt.verlag,