Юнит Лямбда: Прототип

Вы слышали о Юнит Лямбда ? Я надеюсь на это, потому что эти ребята определяют будущее тестирования на JVM. Слишком преувеличено? Может быть, но не намного. Это следующая версия нашего любимого JUnit, безусловно, наиболее используемой библиотеки Java , в процессе создания.

Я экспериментировал с новым прототипом и представляю свои результаты здесь. В настоящее время проект собирает отзывы, так что это наш шанс оценить.

обзор

После быстрого погружения в фон проекта я представлю документированные функции. Каждый закончится парой строк моего личного мнения по теме. Не стесняйтесь громко соглашаться или не соглашаться.

Я создал небольшой демонстрационный проект, из которого взято большинство примеров кода. Существует демонстрационный класс для каждой из представленных функций, и ссылки на них указаны в заголовках.

Обратите внимание, что прототип находится в стадии интенсивной разработки, поэтому он является движущейся целью. Из-за этого все ссылки на мой демонстрационный код, а также код проекта привязаны к их текущей версии. Со времени, когда я писал и вы читали это, все могло значительно измениться, и эти версии могли быть довольно устаревшими. Будьте лектором.

Фон

JUnit Lambda — проект группы энтузиастов тестирования Java, включая основной коммиттер JUnit.

Цель состоит в том, чтобы создать современную основу для тестирования на стороне разработчика в JVM. Это включает в себя фокусировку на Java 8 и выше, а также включение множества различных стилей тестирования.

Сайт проекта JUnit Lambda

Они собирали средства с июля по октябрь, начали свою работу над этим на совещании с 20 по 22 октября и выпустили свой прототип в прошлую среду (18 ноября).

Если вы хотите внести свой вклад в промежуточный период, пожалуйста, используйте трекер проблем проекта или отправьте нам комментарии через Twitter .

JUnit Lambda Wiki

Проект собирает отзывы до 30 ноября, а затем начнет работу над альфа-версией. Это также подразумевает, что текущая версия даже не альфа. Имейте это в виду при формировании вашего мнения.

Характеристики

Настройка, Тест, Разрушение

Наиболее важной частью API JUnit является аннотация @Test, и здесь ничего не меняется: только методы, аннотированные этим, будут рассматриваться как тесты.

Испытанные и проверенные аннотации для установки и разборки тестов практически не меняются, но имеют новые названия:

• @Before и @After, которые выполняются до и после каждого метода тестирования, теперь называются @BeforeEach и @AfterEach.
• @BeforeClass и @AfterClass, которые запускаются до первого и после последнего теста класса, теперь называются @BeforeAll и @AfterAll

Мне нравятся новые имена. Они больше раскрывают намерения и, следовательно, легче понять — особенно для начинающих.

Затем есть новое @Name, которое можно использовать, чтобы дать более удобочитаемые имена для тестирования классов и методов. Пример из документации :

@Name("A special test case")
class CanHaveAnyNameTest {

  @Test
  @Name("A nice name, isn't it?")
  void testWithANiceName() {}

}

@Test
void interestingAssertions() {
    String mango = "Mango";

    // message comes last
    assertEquals("Mango", mango, "Y U no equal?!");

    // message can be created lazily
    assertEquals("Mango", mango,
            () -> "Expensive string, creation deferred until needed.");

    // for 'assert[True|False]' it is possible
    // to directly test a supplier that exists somewhere in the code
    BooleanSupplier existingBooleanSupplier = () -> true;
    assertTrue(existingBooleanSupplier);
}

@Test
void exceptionAssertions() {
    IOException exception = expectThrows(
            IOException.class,
            () -> { throw new IOException("Something bad happened"); });
    assertTrue(exception.getMessage().contains("Something bad"));
}

@Test
void groupedAssertions() {
    assertAll("Multiplication",
            () -> assertEquals(15, 3 * 5, "3 x 5 = 15"),
            // this fails on purpose to see what the message looks like
            () -> assertEquals(15, 5 + 3, "5 x 3 = 15")
    );
}

@TestInstance(Lifecycle.PER_CLASS)
class _2_PerClassLifecycle {

    /** There are two test methods, so the value is 2. */
    private static final int EXPECTED_TEST_METHOD_COUNT = 2;

    /** Is incremented by every test method
        AND THE STATE IS KEPT ACROSS METHODS! */
    private int executedTestMethodCount = Integer.MIN_VALUE;

    // Note that the following @[Before|After]All methods are _not_ static!
    // They don't have to be because this test class has a lifecycle PER_CLASS.

    @BeforeAll
    void initializeCounter() {
        executedTestMethodCount = 0;
    }

    @AfterAll
    void assertAllMethodsExecuted() {
        assertEquals(EXPECTED_TEST_METHOD_COUNT, executedTestMethodCount);
    }

    @Test
    void oneMethod() { executedTestMethodCount++; }

    @Test
    void otherMethod() { executedTestMethodCount++; }

}

class _4_InnerClasses {

    @Nested
    class InnerClass {

        @Test
        void someTestMethod() { print("Greetings!"); }

    }

    @Nested
    static class StaticClass {

        @Test
        void someTestMethod() { print("Greetings!"); }

    }

    class UnannotatedInnerClass {

        @Test
        void someTestMethod() { throw new AssertionError(); }

    }

    static class UnannotatedStaticClass {

        @Test
        void someTestMethod() { print("Greetings!"); }

    }

}

@Test
void assumeThat_trueAndFalse() {
    assumingThat(true, () -> executedTestMethodCount++);
    assumingThat(false, () -> {
        String message = "If you can see this, 'assumeFalse(true)' passed, "
                + "which it obviously shouldn't.";
        throw new AssertionError(message);
    });
}

/**
 * We define a custom annotation that:
 * - stands in for '@Test' so that the method gets executed
 * - gives it a default name
 * - has the tag "integration" so we can filter by that,
 *   e.g. when running tests from the command line
 */
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Test
@Name("Evil integration test!   ")
@Tag("integration")
public @interface IntegrationTest { }

@IntegrationTest
void runsWithCustomAnnotation() {
    // this is run even though 'IntegrationTest' is not defined by JUnit
}

static boolean itsFridayAfternoon() {
    LocalDateTime now = LocalDateTime.now();
    return now.getDayOfWeek() == DayOfWeek.FRIDAY
            && 13 <= now.getHour() && now.getHour() <= 18;
}

class NotFridayCondition implements Condition {

    @Override
    public Result evaluate(TestExecutionContext testExecutionContext) {
        return itsFridayAfternoon()
                ? Result.failure("It's Friday afternoon!")
                : Result.success("Just a regular day...");
    }

}

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Conditional({NotFridayCondition.class})
public @interface DontRunOnFridayAfternoon { }

@Test
@DontRunOnFridayAfternoon
void neverRunsOnFridayAfternoon() {
    assertFalse(itsFridayAfternoon());
}

@Test
void injectsTestName(@TestName String testName) {
    // '@TestName' comes with JUnit.
    assertEquals("injectsTestName", testName);
}

public class ServerParameterResolver implements MethodParameterResolver {

    @Override
    public boolean supports(Parameter parameter) {
        // support all parameters of type 'Server'
        return parameter.getType().equals(Server.class);
    }

    @Override
    public Object resolve(Parameter parameter, TestExecutionContext context)
            throws ParameterResolutionException {
        return new Server("http://codefx.org");
    }
}

@Test
void injectsServer(Server server) {
    int statusCode = server.sendRequest("gimme!");
    assertEquals(200, statusCode);
}

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface EMailParameter { }

public class Resolver implements MethodParameterResolver {

    @Override
    public boolean supports(Parameter parameter) {
        // support strings annotated with '@EmailParameter'
        return parameter.getType().equals(String.class)
                && isAnnotated(parameter, EMailParameter.class);
    }

    @Override
    public Object resolve(Parameter parameter, TestExecutionContext context)
            throws ParameterResolutionException {
        return "nipa@codefx.org";
    }
}

@Test
void injectsEMailAddress(@EMailParameter String eMail) {
    assertTrue(eMail.contains("@"));
}