Struct Directive 

pub struct Directive {
    pub name: String,
    pub name_span: Span,
    pub args: Vec<Argument>,
    pub block: Option<Block>,
    pub span: Span,
    pub trailing_comment: Option<Comment>,
    pub leading_whitespace: String,
    pub space_before_terminator: String,
    pub trailing_whitespace: String,
}

A directive — either a simple directive (listen 80;) or a block directive (server { … }).

The span covers the entire directive from the first character of the name to the terminating ; or closing }.

Fields

name: String

Directive name (e.g. "server", "listen", "more_set_headers").

name_span: Span

Span of the directive name token.

args: Vec<Argument>

Arguments following the directive name.

block: Option<Block>

Block body, present for block directives like server { … }.

span: Span

Span covering the entire directive (name through terminator).

trailing_comment: Option<Comment>

Optional comment at the end of the directive line.

leading_whitespace: String

Leading whitespace before the directive name (for indentation checking)

space_before_terminator: String

Whitespace before the terminator (; or {)

trailing_whitespace: String

Trailing whitespace after the terminator (; or {) to end of line

Implementations

impl Directive

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

Check if this directive has a specific name

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

Get the first argument value as a string (useful for simple directives)

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

Check if the first argument equals a specific value

Trait Implementations

impl Clone for Directive

fn clone(&self) -> Directive

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Directive

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Directive

fn deserialize<__D>( __deserializer: __D, ) -> Result<Directive, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl DirectiveExt for Box<Directive>

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.

impl DirectiveExt for Directive

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.

impl Serialize for Directive

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.