4 stable releases

new 1.2.1 Apr 21, 2025
1.1.0 Apr 16, 2025
1.0.0 Mar 24, 2025

#178 in Testing

Download history 104/week @ 2025-03-23 13/week @ 2025-03-30 5/week @ 2025-04-06 130/week @ 2025-04-13

252 downloads per month

BSD-2-Clause and LGPL-3.0

34KB
328 lines

Test framework for Picodata plugin

CI

Описание

Picotest - это фреймворк для тестирования плагинов, созданных в окружении pike.

Для использования Picotest требуется выполнить следующие действия:

  • Установить pike:
cargo install picodata-pike
  • Добавить зависимости в Cargo.toml плагина:
cargo add --dev picotest
cargo add --dev rstest

Совместимость с Picodata

Picotest поддерживает версии Picodata, начиная с 25.1.1 и выше.

Интеграционное тестирование

Макрос #[picotest] используется для написания интеграционных тестов и может применяться как к функциям, так и к модулям.

Использование #[picotest]

При использовании макроса на модуле picotest автоматически пометит все функции модуля, названия которых начинаются с test_, как rstest-функции.

use picotest::*;

#[picotest]
mod test_mod {

    fn test_foo() {
        assert_eq!("foo", "foo");
    }

    fn test_bar() {
        assert_eq!("bar", "bar");
    }
}

Совместимость с rstest

Макрос #[picotest] является оберткой над rstest, поэтому поддерживает использование: fixture. once case

use picotest::picotest;

#[picotest]
mod test_mod {
    #[fixture]
    fn foo() -> String {
        "foo".to_string()
    }

    #[fixture]
    #[once]
    fn bar() -> String {
        "bar".to_string()
    }

    fn test_foo(foo: String) {
        assert_eq!(foo, "foo".to_string());
    }

    fn test_bar(bar: String) {
        assert_eq!(bar, "bar".to_string());
    }

    fn test_foo_bar(foo: String, bar: String) {
        assert_ne!(foo, bar);
    }

    #[case(0, 0)]
    #[case(1, 1)]
    #[case(2, 1)]
    #[case(3, 2)]
    #[case(4, 3)]
    fn test_fibonacci(#[case] input: u32, #[case] expected: u32) {
        assert_eq!(expected, fibonacci(input))
    }

Атрибуты макроса #[picotest]

Attribute Description Default
path Путь до директории, содержащей файл топологии плагина (topology.toml) Определяется автоматически
timeout Таймаут перед запуском первого теста (seconds) 5

Управление кластером в Picotest

Жизненный цикл и изоляция кластера

Picotest обеспечивает полную изоляцию тестовых окружений за счет автоматического управления жизненным циклом кластера:

Архитектура тестирования

my_pike_plugin/
├── topology.toml    # Файл топологии плагина
├── src/
│   └── lib.rs       # Основной код
└── tests/
    ├── common/      # Вспомогательные модули (не тесты)
    │   └── mod.rs
    ├── integration_test1.rs
    └── integration_test2.rs
...
...
...

Ключевые особенности:

Изоляция на уровне файлов:

  • Каждый .rs файл в tests/ компилируется как самостоятельный исполняемый модуль
  • Для каждого файла создается отдельный экземпляр кластера

Создание кластера вручную

Picotest позволяет создавать и удалять кластер без использования макроса #[picotest].

use rstest::rstest;

#[rstest]
fn test_without_picotest_macro() {
    let cluster = picotest::cluster(".", 0);
    assert!(cluster.path == ".");
}

Модульное тестирование

Макрос #[picotest_unit] используется для написания юнит-тестов для плагинов, созданных с помощью утилиты pike.

#[picotest_unit]
fn test_my_http_query() {
    let http_client = fibreq::ClientBuilder::new().build();

    let http_request = http_client.get("http://example.com").unwrap();
    let http_response = http_request.send().unwrap();

    assert!(http_response.status() == http_types::StatusCode::Ok);
}

Запуск тестов

Тесты запускаются через интерфейс cargo test:

cargo test

Ограничения

  1. #[picotest_unit] не может использоваться в модуле под #[cfg(test)].

Пример неверного использования макроса:

#[cfg(test)]
mod tests {
    #[picotest_unit]
    fn test_declared_under_test_cfg() {}
}

Пример верного использования макроса:

mod tests {

    #[picotest_unit]
    fn test_is_NOT_declared_under_test_cfg() {}
}

По скольку каждый юнит-тест компилируется и линкуется в динамическую библиотеку плагина (см. Структура плагина), он не должен быть задан в конфигурации, отличной от debug. В противном случае при сборке тестов они будут проигнорированы компилятором.

  1. #[picotest_unit] не может использоваться совместно с другими атрибутами.

Все атрибуты используемые совместно с макросом будут отброшены.

В примере ниже #[should_panic] будет отброшен в процессе компиляции.

#[should_panic]
#[picotest_unit]
fn test_will_ignore_should_panic_attribute() {}

Dependencies

~13–24MB
~391K SLoC