Assertion based examples

Достаточно интересный метод демонстрации примеров нашел в книге “Groovy in Action“.

Суть состоит в том, что Dierk-Koenig, в отличии от принятого стиля оформления примеров:
“Вот код, а вот текст/скриншот того, что получается в результате”
или же
“А теперь мы напишем программу с ипользованием цикла while и посмотрим что она выведет на экран”, использует утверждения (assertions) прямо в коде примера.
Причем всегда строит assert-выражение таким образом, чтоб результат был true.

Например:

[java]assert 1=1
assert "Java & the Groovy"=="Java & the Groovy"
// Именно так, потому как в Groovy сравнение проходит по значению[/java]

или

[java]def nick = 'Gina'
def book = 'Groovy in Action'
assert "$nick is $book" == 'Gina is Groovy in Action'[/java]

или

[java]def list = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
list.each() { item ->
assert item == list[item]
}[/java]

Получаются такие себе микро-тесты без тест-фреймворка.
В результате “правильная” программа-пример не выведет на экран ничего.

Такой подход мне кажется куда более удобным, потому как читателю нет необходимости создавать программу из примера или же догадываться о результатах той или иной операции.