Lua Academy · Lekcja

Bloki describe i it

Zorganizuje Pan/Pani zestaw testów.

Bloki describe i it to bezpłatna lekcja Lua Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Lua Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Lua Academy zawiera 4 lekcji w sumie.

Struktura specyfikacji

busted organizuje testy za pomocą dwóch podstawowych funkcji: describe i it. Blok describe grupuje powiązane testy, a każdy blok it jest pojedynczym przypadkiem testowym.

Ta struktura wywodzi się z programowania sterowanego zachowaniem i przypomina zwykły język angielski.

describe("Stack", function()
  it("starts empty", function()
    assert.are.equal(0, Stack.new():size())
  end)
end)

Blok describe

describe przyjmuje ciąg znaków z nazwą oraz funkcję. Nazwa powinna wskazywać testowaną jednostkę lub funkcję, na przykład moduł albo klasę.

Wszystko, co znajduje się wewnątrz funkcji, należy do tej grupy. Nazwa pojawia się w wynikach testów i porządkuje je.

describe("calculator", function()
  -- tests live here
end)

Blok it

Każdy blok it opisuje jedno konkretne zachowanie. Ciąg znaków powinien uzupełniać zdanie rozpoczęte przez describe.

„calculator” wraz z „dodaje dwie liczby” tworzą czytelną specyfikację zamierzonego działania.

describe("calculator", function()
  it("adds two numbers", function()
    assert.are.equal(5, calc.add(2, 3))
  end)
end)

Zagnieżdżanie bloków describe

Bloki describe można zagnieżdżać, aby wyrażać kontekst. Wewnętrzny blok może opisywać konkretną metodę lub szczególny warunek.

Zagnieżdżanie utrzymuje powiązane przypadki razem i tworzy czytelne, wcięte wyniki.

describe("List", function()
  describe("push", function()
    it("adds an item", function()
      assert.are.equal(1, list:push("a"):size())
    end)
  end)
end)

Konfiguracja za pomocą before_each

before_each uruchamia funkcję przed każdym blokiem it znajdującym się w jego obrębie. Należy używać go do tworzenia świeżych danych testowych, aby testy nie współdzieliły stanu.

Dzięki temu każdy test pozostaje odizolowany. Zmiana w jednym teście nie może przedostać się do następnego.

describe("Stack", function()
  local s
  before_each(function()
    s = Stack.new()
  end)
  it("pushes", function()
    s:push(1)
    assert.are.equal(1, s:size())
  end)
end)

Sprzątanie za pomocą after_each

after_each uruchamia się po każdym teście. Należy używać go do sprzątania zasobów, takich jak pliki tymczasowe, otwarte połączenia lub stan globalny.

Połączenie konfiguracji i sprzątania gwarantuje zresetowanie środowiska między testami.

after_each(function()
  os.remove("temp.db")
end)

setup i teardown

busted udostępnia również setup i teardown, które uruchamiają się raz na blok describe, a nie raz na test.

Należy używać ich do kosztownych operacji wykonywanych jednorazowo, takich jak otwarcie współdzielonego połączenia, gdy konfiguracja dla każdego testu byłaby nieefektywna.

describe("db", function()
  setup(function()
    db = connect()
  end)
  teardown(function()
    db:close()
  end)
end)

Oczekujące testy

Czasami warto odnotować test, który nie został jeszcze napisany. Należy wywołać pending z opisem albo napisać blok it bez funkcji.

busted zgłasza je jako oczekujące, a nie pomyślne lub niepomyślne, przypominając o konieczności ich ukończenia.

it("handles unicode", function()
  pending("not implemented yet")
end)

Skupianie i wykluczanie testów

Podczas debugowania można skupić się na podzbiorze testów. Oznaczanie testów opcją --tags w wierszu poleceń albo używanie funkcji pomocniczych busted pozwala uruchamiać tylko istotne przypadki.

Dzięki temu nie trzeba uruchamiać całego zestawu podczas pracy nad jednym obszarem, w którym występuje błąd.

-- run only tests tagged 'fast'
-- busted --tags=fast

Konwencje nazewnictwa

Dobre nazwy sprawiają, że przyczyny niepowodzeń są oczywiste. Nazwę describe należy rozpoczynać od przedmiotu testu, a nazwę it od czasownika opisującego zachowanie.

Należy unikać niejasnych nazw, takich jak „works” lub „test1”. Niepomyślny test powinien przypominać zgłoszenie błędu, na podstawie którego można podjąć działanie.

describe("parser", function()
  it("rejects malformed input", function()
    assert.has_error(function() parser.parse("{") end)
  end)
end)

Połączenie wszystkich elementów

Kompletna specyfikacja łączy grupy describe, konfigurację before_each i skoncentrowane przypadki it. Taki szkielet można rozbudować od jednego testu do setek testów.

Bloki powinny być niewielkie, a każdy it powinien skupiać się na jednym zachowaniu, aby wyniki były jak najbardziej czytelne.

describe("Account", function()
  local acc
  before_each(function() acc = Account.new(100) end)
  it("withdraws funds", function()
    acc:withdraw(40)
    assert.are.equal(60, acc.balance)
  end)
end)

Szybki sprawdzian

Proszę sprawdzić, czy rozumieją Państwo strukturę bloków busted.

Podsumowanie

describe grupuje powiązane testy, a it definiuje pojedynczy przypadek, tworząc strukturę przypominającą specyfikację. Bloki describe należy zagnieżdżać, aby wyrażać kontekst.

before_each i after_each służą do izolowania poszczególnych testów, a setup i teardown do pracy wykonywanej raz na blok. Niedokończoną pracę należy oznaczać za pomocą pending.

Często zadawane pytania

Czy lekcja „Bloki describe i it” jest bezpłatna?

Tak — pełny tekst „Bloki describe i it” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Lua Academy, przejdź na CoddyKit PRO. Kurs Lua Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Bloki describe i it”?

Zorganizuje Pan/Pani zestaw testów. Ćwiczysz Lua Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Lua Academy?

Nie wymagamy żadnego doświadczenia. Lua Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Bloki describe i it”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Lua Academy?

Tak. Każda lekcja Lua Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Lua Academy