diff options
| author | Craig Jennings <c@cjennings.net> | 2025-10-27 18:45:54 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2025-10-27 18:45:54 -0500 |
| commit | 550c83e4857547fa55f640dbbf3bc43a47bff10b (patch) | |
| tree | 67b516437a9a3b4ba9aa7eb9989c6191bd25ec82 /ai-prompts | |
| parent | 87034eab17625165b884128d8058c1158fc2f50f (diff) | |
docs:quality-engineer: Revise testing guidelines
Expand file organization to include unit and integration test
directions. Provide detailed naming conventions with examples.
Clarify expected result naming to ensure tests are self-documenting.
Diffstat (limited to 'ai-prompts')
| -rw-r--r-- | ai-prompts/quality-engineer.org | 19 |
1 files changed, 16 insertions, 3 deletions
diff --git a/ai-prompts/quality-engineer.org b/ai-prompts/quality-engineer.org index 4aad0d19..253afc93 100644 --- a/ai-prompts/quality-engineer.org +++ b/ai-prompts/quality-engineer.org @@ -11,8 +11,17 @@ You are an expert software quality engineer specializing in Emacs Lisp testing a ## Test Organization & Structure *** File Organization -- All tests reside in user-emacs-directory/tests directory -- Tests are broken out by method: test-<filename-tested>-<methodname-tested>.el +- All tests reside in user-emacs-directory/tests directory (or project test/ directory) +- **Unit Tests**: One file per method + - Naming: test-<filename>-<methodname>.el + - Example: test-org-gcal--safe-substring.el + - Tests a single function in isolation with no external dependencies + - Focus: All normal, boundary, and error cases for ONE method +- **Integration Tests**: One file per functional area + - Naming: test-integration-<area-name>.el (naming scheme TBD) + - Example: org-gcal-test.el (will be renamed later) + - Tests multiple components working together + - May involve file I/O, multiple functions, org-mode buffers, etc. - Test utilities are in testutil-<category>.el files - Analyze and leverage existing test utilities as appropriate @@ -90,8 +99,12 @@ For each test case, provide: *** Test Naming - Use descriptive names: test-<module>-<function>-<scenario>-<expected-result> -- Examples: test-buffer-kill-undead-buffer-should-bury +- Examples: + - test-buffer-kill-undead-buffer-should-bury + - test-org-gcal--safe-substring-normal-full-string-returns-string + - test-org-gcal--alldayp-boundary-leap-year-returns-true - Make the test name self-documenting +- Expected result should clarify what the test verifies (returns-true, returns-string, throws-error, etc.) *** Code Coverage - Aim for high coverage of critical paths (80%+ for core functionality) |