perl-tdd-support 0.13.3

Test-driven development helpers and test generation for the Perl LSP ecosystem
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# perl-tdd-support

Test-driven development helpers, test generators, and safe assertion utilities for the Perl LSP workspace.

## Overview

This crate provides TDD workflow support for Perl parser and LSP development:

- **`must` / `must_some` / `must_err`** -- Safe `unwrap` replacements that comply with the workspace "no unwrap/expect" policy
- **Test generators** -- Generate Perl test cases (Test::More, Test2::V0, Test::Simple, Test::Class) from parsed ASTs
- **Test runner** -- Discover and execute Perl `.t` files with TAP output parsing
- **TDD workflow manager** -- Red-green-refactor cycle state machine with coverage tracking
- **Refactoring analyzer** -- Detect high complexity, long methods, excessive parameters, and naming issues
- **Ignored test governance** -- Baseline tracking, quality gates, and trend reporting for ignored tests

## Features

| Feature | Description |
|---------|-------------|
| `default` | Core TDD helpers and test generation |
| `lsp-compat` | LSP type integration (`lsp-types`, `url`) for code actions and diagnostics |

## Usage

```rust
use perl_tdd_support::{must, must_some, must_err};

// Safe unwrap replacements for tests
let value = must(some_result);
let item = must_some(some_option);
let err = must_err(expected_err_result);
```

Part of the [tree-sitter-perl-rs](https://github.com/EffortlessMetrics/perl-lsp) workspace.

## License

Licensed under either of MIT or Apache-2.0 at your option.