Trait DirectiveExt 

pub trait DirectiveExt {
    // Required methods
    fn is(&self, name: &str) -> bool;
    fn first_arg(&self) -> Option<&str>;
    fn first_arg_is(&self, value: &str) -> bool;
    fn arg_at(&self, index: usize) -> Option<&str>;
    fn last_arg(&self) -> Option<&str>;
    fn has_arg(&self, value: &str) -> bool;
    fn arg_count(&self) -> usize;
    fn line(&self) -> usize;
    fn column(&self) -> usize;
    fn full_start_offset(&self) -> usize;
    fn replace_with(&self, new_text: &str) -> Fix;
    fn delete_line(&self) -> Fix;
    fn insert_after(&self, new_text: &str) -> Fix;
    fn insert_after_many(&self, lines: &[&str]) -> Fix;
    fn insert_before(&self, new_text: &str) -> Fix;
    fn insert_before_many(&self, lines: &[&str]) -> Fix;
}

Extension trait for Directive providing inspection and fix-generation helpers.

This trait adds convenience methods to Directive for:

• Inspection: is(), first_arg(), has_arg(), etc.
• Fix generation: replace_with(), delete_line(), insert_after(), etc.

Example

use nginx_lint_plugin::prelude::*;

let config = nginx_lint_plugin::parse_string(
    "proxy_pass http://backend;"
).unwrap();
let directive = config.all_directives().next().unwrap();

assert!(directive.is("proxy_pass"));
assert_eq!(directive.first_arg(), Some("http://backend"));
assert_eq!(directive.arg_count(), 1);

// Generate a fix to replace the directive
let fix = directive.replace_with("proxy_pass http://new-backend;");
assert!(fix.is_range_based());

Required Methods

fn is(&self, name: &str) -> bool

Check if the directive has the given name.

fn first_arg(&self) -> Option<&str>

Get the first argument’s string value, if any.

fn first_arg_is(&self, value: &str) -> bool

Check if the first argument equals the given value.

fn arg_at(&self, index: usize) -> Option<&str>

Get the argument at the given index.

fn last_arg(&self) -> Option<&str>

Get the last argument’s string value, if any.

fn has_arg(&self, value: &str) -> bool

Check if any argument equals the given value.

fn arg_count(&self) -> usize

Return the number of arguments.

fn line(&self) -> usize

Get the start line number (1-based).

fn column(&self) -> usize

Get the start column number (1-based).

fn full_start_offset(&self) -> usize

Get the byte offset including leading whitespace.

fn replace_with(&self, new_text: &str) -> Fix

Create a Fix that replaces this directive with new text, preserving indentation.

fn delete_line(&self) -> Fix

Create a Fix that deletes this directive’s line.

fn insert_after(&self, new_text: &str) -> Fix

Create a Fix that inserts a new line after this directive, matching indentation.

fn insert_after_many(&self, lines: &[&str]) -> Fix

Create a Fix that inserts multiple new lines after this directive.

fn insert_before(&self, new_text: &str) -> Fix

Create a Fix that inserts a new line before this directive, matching indentation.

fn insert_before_many(&self, lines: &[&str]) -> Fix

Create a Fix that inserts multiple new lines before this directive.

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl DirectiveExt for Box<Directive>

fn is(&self, name: &str) -> bool

fn first_arg(&self) -> Option<&str>

fn first_arg_is(&self, value: &str) -> bool

fn arg_at(&self, index: usize) -> Option<&str>

fn last_arg(&self) -> Option<&str>

fn has_arg(&self, value: &str) -> bool

fn arg_count(&self) -> usize

fn line(&self) -> usize

fn column(&self) -> usize

fn full_start_offset(&self) -> usize

fn replace_with(&self, new_text: &str) -> Fix

fn delete_line(&self) -> Fix

fn insert_after(&self, new_text: &str) -> Fix

fn insert_after_many(&self, lines: &[&str]) -> Fix

fn insert_before(&self, new_text: &str) -> Fix

fn insert_before_many(&self, lines: &[&str]) -> Fix

impl<T: DirectiveExt + ?Sized> DirectiveExt for &T

fn is(&self, name: &str) -> bool

fn first_arg(&self) -> Option<&str>

fn first_arg_is(&self, value: &str) -> bool

fn arg_at(&self, index: usize) -> Option<&str>

fn last_arg(&self) -> Option<&str>

fn has_arg(&self, value: &str) -> bool

fn arg_count(&self) -> usize

fn line(&self) -> usize

fn column(&self) -> usize

fn full_start_offset(&self) -> usize

fn replace_with(&self, new_text: &str) -> Fix

fn delete_line(&self) -> Fix

fn insert_after(&self, new_text: &str) -> Fix

fn insert_after_many(&self, lines: &[&str]) -> Fix

fn insert_before(&self, new_text: &str) -> Fix

fn insert_before_many(&self, lines: &[&str]) -> Fix

Implementors

impl DirectiveExt for Directive