perl-tdd-support 0.13.1

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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

//! Test-driven development helpers and generators for Perl.
//!
//! This crate provides tools to support TDD workflows when working with Perl code,
//! including test generation, execution runners, and validation utilities for
//! Perl parser and LSP development.
//!
//! # Overview
//!
//! The TDD support crate offers:
//! - Test case generators for Perl syntax patterns
//! - Test execution runners with result capture
//! - Basic TDD workflow helpers for parser development
//! - Utilities for validating parser behavior against expected outcomes
//!
//! # Example
//!
//! ```no_run
//! use perl_tdd_support::tdd_basic;
//!
//! // Use TDD helpers to validate parser behavior
//! // (specific APIs depend on tdd module implementation)
//! ```

#![deny(unsafe_code)]
#![deny(unreachable_pub)]
#![warn(rust_2018_idioms)]
#![warn(missing_docs)]
#![warn(clippy::all)]
// This crate provides test helpers that intentionally panic on failure.
// The must/must_some/must_err helpers are designed to panic in tests.
#![allow(clippy::panic)]
#![allow(
    clippy::too_many_lines,
    clippy::module_name_repetitions,
    clippy::cast_possible_truncation,
    clippy::cast_sign_loss,
    clippy::cast_precision_loss,
    clippy::cast_possible_wrap,
    clippy::must_use_candidate,
    clippy::missing_errors_doc,
    clippy::missing_panics_doc,
    clippy::wildcard_imports,
    clippy::enum_glob_use,
    clippy::match_same_arms,
    clippy::if_not_else,
    clippy::struct_excessive_bools,
    clippy::items_after_statements,
    clippy::return_self_not_must_use,
    clippy::unused_self,
    clippy::collapsible_match,
    clippy::collapsible_if,
    clippy::only_used_in_recursion,
    clippy::items_after_test_module,
    clippy::while_let_loop,
    clippy::single_range_in_vec_init,
    clippy::arc_with_non_send_sync,
    clippy::needless_range_loop,
    clippy::result_large_err,
    clippy::if_same_then_else,
    clippy::should_implement_trait,
    clippy::manual_flatten,
    clippy::needless_raw_string_hashes,
    clippy::single_char_pattern,
    clippy::uninlined_format_args
)]

pub use perl_parser_core::{Node, NodeKind, SourceLocation};
pub use perl_parser_core::{ParseError, ParseResult, error, parser};
pub use perl_parser_core::{Parser, ast, position};

/// Test-driven development helpers and generators.
pub mod tdd;

pub use tdd::tdd_basic;
pub use tdd::tdd_workflow;
pub use tdd::test_generator;
/// Test execution and TDD support functionality.
pub use tdd::test_runner;

/// Safe unwrap replacements for tests.
/// Re-exported from `perl-test-must` for backward compatibility.
pub use perl_test_must::{must, must_err, must_some};

/// CI Guardrail Ignored Test Monitoring and Governance.
pub mod governance;