테스트

wippy/test 프레임워크로 Lua 코드의 테스트를 작성하고 실행합니다 — 어설션, 라이프사이클 훅, 모킹을 갖춘 BDD 스타일 러너이며, wippy run test 명령으로 실행됩니다.

무엇을 구축할 것인가

작은 라이브러리와 그것을 커버하는 테스트 스위트:

  1. add 및 div 함수가 있는 calc 라이브러리.
  2. 케이스를 설명하고, 동작을 어설트하며, 보류 중인 케이스를 건너뛰는 테스트 엔트리.
  3. wippy run test를 통한 그린 테스트 실행.

전제 조건

  • Wippy 프로젝트 (app-template 클론, 또는 빈 디렉토리에서 wippy init).

  • 설치된 테스트 프레임워크와 터미널 호스트:

    wippy add wippy/test
wippy add wippy/terminal
wippy install

    러너는 라이브 터미널 UI를 렌더링하므로 wippy/test와 함께 wippy/terminal이 필요합니다.

테스트 대상 코드

-- src/calc.lua
local function add(a, b)
    return a + b
end

local function div(a, b)
    if b == 0 then
        return nil, "division by zero"
    end
    return a / b
end

return { add = add, div = div }

테스트

테스트는 meta.type: test로 태그된 일반적인 function.lua 엔트리입니다. 그 메서드는 test.run_cases(...)가 생성한 값을 반환하며, 러너가 이를 호출합니다:

-- src/calc_test.lua
local test = require("test")
local calc = require("calc")

local function define_tests()
    test.describe("calculator", function()
        local started = false

        test.before_all(function()
            started = true
        end)

        test.it("setup ran", function()
            test.is_true(started)
        end)

        test.it("adds numbers", function()
            test.eq(calc.add(2, 3), 5)
        end)

        test.it("returns error on divide by zero", function()
            local result, err = calc.div(1, 0)
            test.has_error(result, err)
            test.contains(err, "division by zero")
        end)

        test.it_skip("not implemented yet", function()
            test.fail("should not run")
        end)
    end)
end

return { run = test.run_cases(define_tests) }

두 엔트리를 모두 등록합니다. 디스커버리는 meta.type: test를 기준으로 동작합니다; meta.suite는 출력에서 결과를 그룹화합니다:

version: "1.0"
namespace: app

entries:
  - name: calc
    kind: library.lua
    source: file://calc.lua

  - name: calc_test
    kind: function.lua
    meta:
      name: Calculator Test
      type: test
      suite: calculator
    source: file://calc_test.lua
    method: run
    imports:
      test: wippy.test:test
      calc: app:calc

imports 맵은 테스트 내부에서 require(...)가 무엇으로 해석되는지 제어합니다: test는 프레임워크를, calc는 테스트 대상 유닛을 바인딩합니다.

실행하기

wippy run test

반복 작업 중에 단일 스위트로 필터링합니다 (엔트리 id 또는 스위트 이름과 매칭):

wippy run test calculator

위 스위트의 출력:

  calculator (4)  3/4  1 skipped  1ms
    o setup ran
    o adds numbers
    o returns error on divide by zero
    - not implemented yet (skipped)

  PASSED   3 tests   1 skipped   1ms

wippy run test는 모든 케이스가 통과하면 0으로, 실패가 있으면 1로 종료되므로 CI에 바로 적용됩니다.

어설션

각 어설션은 실패 시 에러를 발생시킵니다; 타입 가드는 검증된 값도 반환합니다.

어설션 검사 내용
test.eq(a, b) / test.neq(a, b) 동등성 / 비동등성
test.ok(v) / test.fail(msg) 참 값 / 강제 실패
test.is_nil(v) / test.not_nil(v) Nil / 비-nil
test.is_true(v) / test.is_false(v) 불리언 값
test.is_string/number/table/function/boolean(v) 타입 가드 (v 반환)
test.contains(str, sub) / test.matches(str, pattern) 부분 문자열 / Lua 패턴
test.has_key(tbl, key) / test.len(v, n) 맵 키 / 길이
test.gt/gte/lt/lte(a, b) 숫자 비교
test.throws(fn) / test.has_error(val, err) / test.no_error(val, err) 에러 처리

모두 선택적 후행 메시지 인자를 받습니다.

라이프사이클 및 모킹

이들을 describe 블록 내부에서 호출합니다:

  • test.before_all / test.after_all — 블록당 한 번 실행.
  • test.before_each / test.after_each — 모든 케이스 전후로 실행.
  • test.mock("module.field", fn) — 현재 케이스에 대해 함수를 교체; 모킹은 각 케이스 후 자동으로 복원됩니다. 일찍 제거하려면 test.restore_all_mocks()를 사용하세요.

중첩된 describe 블록은 부모 훅을 상속합니다 (바깥 before_*가 먼저, 안쪽 after_*가 먼저).

다음 단계