Cursor rule

1---
2paths:
3  - "**/*.pl"
4  - "**/*.pm"
5  - "**/*.t"
6  - "**/*.psgi"
7  - "**/*.cgi"
8---
9# Perl Testing
10 
11> This file extends [common/testing.md](../common/testing.md) with Perl-specific content.
12 
13## Framework
14 
15Use **Test2::V0** for new projects (not Test::More):
16 
17```perl
18use Test2::V0;
19 
20is($result, 42, 'answer is correct');
21 
22done_testing;
23```
24 
25## Runner
26 
27```bash
28prove -l t/              # adds lib/ to @INC
29prove -lr -j8 t/         # recursive, 8 parallel jobs
30```
31 
32Always use `-l` to ensure `lib/` is on `@INC`.
33 
34## Coverage
35 
36Use **Devel::Cover** — target 80%+:
37 
38```bash
39cover -test
40```
41 
42## Mocking
43 
44- **Test::MockModule** — mock methods on existing modules
45- **Test::MockObject** — create test doubles from scratch
46 
47## Pitfalls
48 
49- Always end test files with `done_testing`
50- Never forget the `-l` flag with `prove`
51 
52## Reference
53 
54See skill: `perl-testing` for detailed Perl TDD patterns with Test2::V0, prove, and Devel::Cover.
55