Testijiet Awtomatiċi tal-Unità u tal-Integrazzjoni
F'din il-paġna
Awtomatizza l-Kitba tat-Testijiet
It-testijiet huma l-ewwel ħaġa li taqta’ meta jkun hemm nuqqas ta’ ħin, u d-dejn li jiswa l-aktar flus aktar tard. Codex ibiddel il-bilanċ: li tiġġenera kopertura sħiħa għal modulu jsir kwistjoni ta’ minuti minflok wara nofsinhar sħiħ. Iżda trid titlob aktar minn sempliċiment “ikteb testijiet”, istruzzjoni li tipproduċi ftit każijiet nominali—ħodor, li jagħtuk kunfidenza, iżda bla valur.
Iġġenera Testijiet tal-Unità
Il-leva prinċipali hija li semmi int stess il-każijiet limitu (edge cases). Int taf id-dominju tan-negozju tiegħek; l-aġent ma jafx li skont ta’ aktar minn 100% iseħħ darba kull tliet xhur fid-data tiegħek.
"Generate unit tests for src/lib/pricing.ts.
Use Vitest. Cover all edge cases: negative price,
discount > 100%, invalid currency, zero quantity."
Codex janalizza l-kodiċi sors, jidentifika l-funzjonijiet esportati, jifhem il-loġika tagħhom, u mbagħad jipproduċi suite li tkopri kemm il-mogħdijiet normali kif ukoll il-każijiet li semmejt.
// src/lib/pricing.test.ts
import { describe, it, expect } from "vitest";
import { calculatePrice, applyDiscount, formatPrice } from "./pricing";
describe("calculatePrice", () => {
it("calculates total price for a positive quantity", () => {
expect(calculatePrice(10, 3)).toBe(30);
});
it("returns 0 for a quantity of zero", () => {
expect(calculatePrice(10, 0)).toBe(0);
});
it("throws an error for a negative price", () => {
expect(() => calculatePrice(-5, 1)).toThrow("Invalid price");
});
});
describe("applyDiscount", () => {
it("applies a standard discount", () => {
expect(applyDiscount(100, 20)).toBe(80);
});
it("rejects a discount greater than 100%", () => {
expect(() => applyDiscount(100, 150)).toThrow();
});
});
Dettall wieħed jistħoqqilha spezzjoni: il-messaġġ ta’ żball mistenni, “Invalid price”, ittieħed mill-implimentazzjoni attwali, mhux inventat. Din hija s-sinjalatura ta’ test miktub mill-kodiċi aktar milli minn mudell, u l-ewwel ħaġa li għandek tiċċekkja meta tirrevedi suite ġġenerata.
Iġġenera Testijiet tal-Integrazzjoni
Għal rotta tal-API jew servizz li jmiss id-database, għandek bżonn tipprovdi aktar kuntest, speċjalment dwar x’għandu jiġi simulat (mocked).
"Generate integration tests for src/api/routes/orders.ts.
Use supertest for HTTP requests. Mock the Stripe
service with vi.mock. Test scenarios: order creation,
order with non-existent product, failed payment."
Codex jagħmel distinzjoni ċara bejn iż-żewġ livelli ta’ test: jikkonfigura l-mocks xierqa, jittratta t-twaqqif u t-tneħħija (setup and teardown) tad-database tat-test, u jissimula servizzi esterni. Li semmi Stripe u supertest b’mod espliċitu jipprevjenih milli jinventa infrastruttura parallela għal dik li t-tim tiegħek diġà juża.
Kopri Proġett Sħiħ
Fuq proġett li strutturalment jonqsu t-testijiet, kompitu globali huwa aktar effettiv minn serje ta’ talbiet fajl b’fajl.
"Analyze all .ts files in src/lib/ and src/services/.
For each file without a corresponding .test.ts file,
generate unit tests. Aim for branch coverage > 80%."
Codex imbagħad jipproċessa l-fajls wieħed wieħed, jadatta t-testijiet għal kull modulu; għodd diversi minuti ta’ eżekuzzjoni għal suite sħiħa. Ħaddem dan il-kompitu fuq folder wieħed kull darba minflok fuq id-direttorju src/ kollu: lil hinn minn hekk, il-pull request isir kbir wisq biex jiġi rrevedut, u suite ta’ testijiet approvata mingħajr ma tinqara ma tipproteġi lil ħadd.
Tejjeb it-Testijiet Eżistenti
Codex mhux biss joħloq; jista’ wkoll jiddijanjoštika suite li tagħtik kunfidenza mingħajr ma tipproteġi.
"Analyze tests in src/__tests__/. Identify:
- Tests that check only one path (happy path)
- Vague assertions (toBeTruthy instead of toBe)
- Tests that share mutable state
Fix these issues."
Dawn it-tliet sintomi jispjegaw il-biċċa l-kbira tas-suites ħodor li jħallu l-bugs jgħaddu. It-tielet waħda hija l-aktar insidjuża: it-testijiet li jaqsmu stat mutabbli (mutable state) jgħaddu sakemm jiġu esegwiti fl-ordni tas-soltu, u jibdew ifallu b’mod każwali l-jum li tattivaw il-paralleliżmu.
Testijiet skont it-Tip ta’ Komponent
It-tip ta’ test li għandek titlob jiddependi direttament fuq in-natura tal-kodiċi, u l-istruzzjoni tinbidel miegħu.
| Tip ta’ Kodiċi | Tip ta’ Test | Istruzzjoni ta’ Codex |
|---|---|---|
| Funzjoni ta’ utilità | Unità | ”Test all possible inputs and outputs” |
| Rotta tal-API | Integrazzjoni | ”Test with supertest, mock external services” |
| Komponent React | Rendering | ”Test rendering and interactions with Testing Library” |
| Servizz b’DB | Integrazzjoni | ”Use a test DB, reset between each test” |
Ikkonfigura AGENTS.md għat-Testijiet
Minflok ma tirrepeti dawn l-għażliet għal kull kompitu, iktebhom darba għal dejjem f’taqsima ddedikata ta’ AGENTS.md.
## Tests
- Framework: Vitest
- Command: `npm run test`
- Coverage: `npm run test:coverage`
- Convention: .test.ts files next to source code
- Mocks: use vi.mock(), no manual mocks
- Assertions: prefer toBe/toEqual over toBeTruthy/toBeFalsy
- Each test must be independent (no shared state)
B’dawn is-seba’ linji, Codex japplika l-konvenzjonijiet tiegħek għal kull test li jiġġenera, anke meta żviluppatur imħaffef jifformula t-talba tiegħu f’tliet kliem. Din hija l-aktar mod ekonomiku biex tagħmel il-kwalità tat-testijiet tiegħek indipendenti mill-kwalità tal-istruzzjonijiet.
Punti Ewlenin
- Codex jiġġenera testijiet adattati għall-kodiċi tiegħek, mhux testijiet ġeneriċi
- Speċifika l-każijiet limitu li trid tkopri fl-istruzzjonijiet tiegħek
- Codex jagħmel distinzjoni bejn testijiet tal-unità u testijiet tal-integrazzjoni
- Uża
AGENTS.mdbiex tiddefinixxi l-konvenzjonijiet tat-testijiet tiegħek - Codex jista’ jtejjeb it-testijiet eżistenti, mhux biss joħloq ġodda