Struct PluginTestRunner 

pub struct PluginTestRunner<P: Plugin> { /* private fields */ }

Test runner for plugins.

Provides assertion methods for testing plugin behavior against nginx config strings and fixture directories.

Example

use nginx_lint_plugin::prelude::*;
use nginx_lint_plugin::testing::PluginTestRunner;

let runner = PluginTestRunner::new(MyPlugin);

// Test a config string
runner.assert_has_errors("http {\n    bad on;\n}");
runner.assert_no_errors("http {\n    good on;\n}");
runner.assert_errors("http {\n    bad on;\n    bad on;\n}", 2);
runner.assert_error_on_line("http {\n    bad on;\n}", 2);

Implementations

impl<P: Plugin> PluginTestRunner<P>

pub fn new(plugin: P) -> Self

Create a new test runner for a plugin

pub fn spec(&self) -> PluginSpec

Get plugin spec

pub fn check_string(&self, content: &str) -> Result<Vec<LintError>, String>

Run the plugin check on a config string

pub fn check_file(&self, path: &Path) -> Result<Vec<LintError>, String>

Run the plugin check on a file

pub fn test_fixtures(&self, fixtures_dir: &str)

Test all fixtures in a directory

pub fn assert_errors(&self, content: &str, expected_count: usize)

Assert that a config string produces specific errors

pub fn assert_no_errors(&self, content: &str)

Assert that a config string produces no errors

pub fn assert_has_errors(&self, content: &str)

Assert that a config string produces at least one error

pub fn assert_error_on_line(&self, content: &str, expected_line: usize)

Assert that a config string produces an error on a specific line

pub fn assert_error_message_contains( &self, content: &str, expected_substring: &str, )

Assert that errors contain a specific message substring

pub fn assert_has_fix(&self, content: &str)

Assert that errors have fixes

pub fn assert_fix_produces(&self, content: &str, expected: &str)

Assert that applying fixes produces the expected output

pub fn test_examples(&self, bad_conf: &str, good_conf: &str)

Test using bad.conf and good.conf example content

pub fn test_examples_with_fix(&self, bad_conf: &str, good_conf: &str)

Test using bad.conf and good.conf, and verify fix converts bad to good