dkLab | Конструктор | PGUnit: unit-test фреймворк для хранимых процедур PostgreSQL 8.3
|
2008-11-03
Скачать дистрибутив PGUnit для PostgreSQL 8.3:
Что такое PGUnit?Как и в традиционном xUnit, набор тестов группируется в "тест-кейсы"; каждый кейс может иметь свой собственный код инициализации окружения, общего для всех тестов группы ("код подготовки фикстуры" или "блок setUp"). Главное преимущество PGUnit в том, что блок setUp (часто довольно тяжеловесный) выполняется только один раз в рамках тест-кейса, а эффект от его выполнения сохраняется в savepoint базы данных. В дальнейшем все тесты исполняются начиная с этой savepoint, так что накладные расходы на инициализацию фикстуры минимальны. (Иными словами, фикстура инициализируется только однажды, но результат этой инициализации сохраняется и применяется многократно.) При этом все тесты по прежнему запускаются независимо друг от друга, потому что эффект от запуска теста автоматически "откатывается" после его исполнения. Как установитьЭто просто: скачайте и запустите как обычный SQL-скрипт. В вашей базе данных появится новая схема с именем "pgunit"; она содержит все необходимые функции.
Как пользоватьсяСобственно, PGUnit работает точно так же, как и любые xUnit-фреймворки (например, PHPUnit). Так что, научившись работать с тем же PHPUnit, вы легко поймете и принципы PGUnit.
Типичный процесс использования PGUnit заключается в следующем.
Пример тестового кодаВсе достаточно просто. Вам нужно создать специальную функцию на языке SQL и определить в ней тестовые кусочки кода. Как и в традиционных unit-тестах, имеется секция setUp, выполняющаяся перед каждым тестом и запускающая общую для всех тестов инициализацию, и набор именованных кусков тестового кода, которые работают изолированно друг от друга.
CREATE FUNCTION pgunit.test_sample () RETURNS testfunc[]
AS
$body$
SELECT pgunit.testcase(
$setUp$
-- setUp code is executed before ANY test function code (see below).
-- Effect of this execution is persistent only during the code
-- block execution and rolled back after the test is finished.
CREATE TABLE tst(id INTEGER);
$setUp$,
ARRAY[
-- This is a first test function code. Just check if we can insert
-- into the table created in setUp.
'first test: insert is okay', $sql$
INSERT INTO tst VALUES(1);
PERFORM pgunit.assert_same(1, (SELECT * FROM tst));
$sql$,
-- This is a second test function code.
-- Illustrates that the effect of the first function is not visible.
'second test: effect of previous function is not visible here', $sql$
PERFORM pgunit.assert_same(NULL, (SELECT * FROM tst));
$sql$,
-- This is a third test function code. Illustrate that we may use DECLARE.
'first test: you may use DECLARE in tests', $sql$
DECLARE
i INTEGER;
BEGIN
FOR i IN 1 .. 10 LOOP
INSERT INTO tst VALUES(i);
PERFORM pgunit.assert_same(i, (SELECT * FROM tst WHERE id = i));
END LOOP;
END;
$sql$
]
);
$body$
LANGUAGE sql;
Пример результата работыА вот пример результата работы тестов, запущенных командой NOTICE: PGUnit 2008-11-03 by Dmitry Koterov. NOTICE: NOTICE: pgunit.test_assert_same NOTICE: - OK matchedValues NOTICE: - OK mismatchedValues NOTICE: pgunit.test_exec NOTICE: ! FAIL executed NOTICE: pgunit.test_runtest NOTICE: - OK executed NOTICE: - OK exception hook NOTICE: pgunit.test_sample NOTICE: - OK first test: insert is okay NOTICE: - OK second test: effect of previous function is not visible here NOTICE: pgunit.test_wildcard_match NOTICE: - OK one value NOTICE: - OK two values NOTICE: - OK no matches NOTICE: NOTICE: Time: 00:00:00 NOTICE: NOTICE: There was 1 failure NOTICE: NOTICE: 1) executed(pgunit.test_exec) NOTICE: Failed asserting that two things are same. NOTICE: expected string <2> NOTICE: got string <1> NOTICE: NOTICE: FAILURES! NOTICE: Tests: 10, Failures: 1. Changelog2008-11-09
- A little code simplification (undocumented "WHEN others THEN ..."
instead of exception class enumeration).
2008-11-07
- Great speed-up while running a bunch of test with a single setUp block.
In this case setUp is executed ONLY ONCE, and the effect of its
execution is stored in a savepoint which is used for all
individually-rollbacked tests. (All tests are still running
independently and are not intersected with each other.)
- Time measurnment of each test execution (thanks to Garrynja).
- Supress NOTICEs generated by a setUp or test code to keep the
execution log clean.
2008-11-03
- First release.
|
 Обсудить статью в форуме Скачать исходные кодыНа странице: Что такое PGUnit? Как установить Как пользоваться Пример тестового кода Пример результата работы Changelog
Пользуетесь? Нравится?.. Пожертвуйте!
Пожертвование пойдет в качестве "спасибо" прямиком на поддержание мотивации автора. А то он даже не знает, какое количество людей пользуется той или иной библиотекой или утилитой... |
