Struct Directive 

pub struct Directive {
    pub span: Span,
    pub leading_comments: Vec<String>,
    pub trailing_comment: Option<String>,
    pub kind: DirectiveKind,
}

A single chrony directive with its source location and comments.

Each directive carries its original source location (Span), any leading comments (comment lines immediately preceding the directive), an optional trailing comment (inline comment after the directive), and the parsed directive body (DirectiveKind).

Comments are preserved for lossless round-trip serialization.

Examples

use chrony_confile::ChronyConfig;

let config: ChronyConfig = "# My NTP server\nserver ntp.example.com iburst  # preferred\n".parse()?;

let directive = config.directives().next().unwrap();
assert_eq!(directive.leading_comments[0], "My NTP server");
assert_eq!(directive.trailing_comment.as_deref(), Some("preferred"));

Fields

span: Span

Source location of the directive.

leading_comments: Vec<String>

Comments on lines immediately preceding the directive.

trailing_comment: Option<String>

An inline comment after the directive, if present.

kind: DirectiveKind

The parsed directive body.

Implementations

impl Directive

pub fn new(kind: DirectiveKind, span: Span) -> Self

Creates a new directive with the given kind and source span.

pub fn with_leading_comment(self, comment: impl Into<String>) -> Self

Builder-style method to add a leading comment.

pub fn with_trailing_comment(self, comment: impl Into<String>) -> Self

Builder-style method to add a trailing comment.

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

Formats the value using the given formatter.

impl From<Directive> for ConfigNode

fn from(d: Directive) -> Self

Converts to this type from the input type.

impl From<DirectiveKind> for Directive

fn from(kind: DirectiveKind) -> Self

Converts to this type from the input type.

impl PartialEq for Directive

fn eq(&self, other: &Directive) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Directive