Struct Directive 

#[non_exhaustive]
pub struct Directive {
    pub name: String,
    pub raw_value: Option<String>,
}

A single directive within a policy: a name and an optional raw value (CSP3 §2.3, serialized-directive).

raw_value is exactly the substring that followed the directive name, with only the separating whitespace run stripped – it is not yet parsed against any directive-specific grammar.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

The directive name, exactly as it appeared in the input (original casing preserved – CSP3 directive-name matching is ASCII-case- insensitive, see Directive::name_is_valid and crate::registry_lookup).

raw_value: Option<String>

The raw value that followed the directive name, if any.

Implementations

impl Directive

pub fn name_is_valid(&self) -> bool

Whether Directive::name matches the ABNF directive-name production (1*( ALPHA / DIGIT / "-" ), CSP3 §2.3).

A false result does not mean this directive was dropped – csp-parse parses leniently (see plan/DECISIONS.md, 2026-08-22) and still reports it; callers that need strict conformance checking should check this explicitly.

pub fn value_is_valid(&self) -> bool

Whether Directive::raw_value (if present) matches the ABNF directive-value production (CSP3 §2.3): any run of ASCII whitespace or a byte in %x21-2B / %x2D-3A / %x3C-7E (printable ASCII excluding , and ;).

impl Directive

pub fn value(&self) -> DirectiveValue

Interprets Directive::raw_value via the CSP3 directive registry for Directive::name. Computed on demand rather than stored on Directive itself, so crate::parse_policy_list (Phase 02) stays a pure, registry-independent split – see plan/DECISIONS.md, 2026-08-22.

Examples found in repository

examples/parse.rs (line 20)

fn main() {
    let policy = "default-src 'self'; \
                  script-src 'self' 'nonce-2726c7f26c' https://cdn.example.com; \
                  img-src 'self' data:; \
                  frame-ancestors 'none'; \
                  upgrade-insecure-requests; \
                  report-to csp-endpoint";

    println!("Parsing: {policy}\n");

    let policy_list = parse_policy_list(policy);
    for policy in &policy_list.policies {
        for directive in &policy.directives {
            println!("{}:", directive.name);
            match directive.value() {
                DirectiveValue::SourceList(list) => println!("  source list: {list:?}"),
                DirectiveValue::AncestorSourceList(list) => {
                    println!("  ancestor source list: {list:?}");
                }
                DirectiveValue::Boolean => println!("  (no value)"),
                DirectiveValue::Token(token) => println!("  token: {token:?}"),
                other => println!("  {other:?}"),
            }
        }
    }
}

pub fn boolean_value_is_unexpected(&self) -> bool

For a ValueGrammar::Boolean directive (e.g. upgrade-insecure-requests): whether it unexpectedly carries a value. CSP3 defines these directives as valueless – a present value is a caller-visible anomaly (a diagnostic), not silently dropped or a panic. false for non-boolean or unregistered directives.

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 Eq for Directive

impl PartialEq for Directive

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Directive