Enum PluginTraceLevel 

pub enum PluginTraceLevel {
    Off,
    Error,
    Warn,
    Info,
    Debug,
    Trace,
}

plugin.trace-level — the global default plugin boundary-trace verbosity. Ordered least→most verbose; a record is kept when its level ≤ this gate. info (the default) drops per-call traces — authors opt a plugin up to debug / trace (globally here, or per-plugin from the :plugins view).

Variants

Off

Silence every plugin’s trace entirely.

Error

Traps only.

Warn

Guest errors and traps.

Info

The default: crash/lifecycle signal only, no per-call traces.

Debug

Every host↔guest call, timed.

Trace

Every call with argument / result detail.

Implementations

impl PluginTraceLevel

pub fn label(&self) -> &'static str

The on-disk / :set spelling (off … trace). Deliberately identical to lattice_plugin_host::TraceLevel’s labels: the loader bridges the two types through this string.

pub fn doc(&self) -> &'static str

One-line description of this level for the :set value completion marginalia.

pub fn all() -> [PluginTraceLevel; 6]

Every level, least → most verbose (the closed value set).

pub fn parse_label(s: &str) -> Result<Self, String>

Parse a Self::label back into a level. Exact match; any other input is an Err naming the accepted forms.

Examples

use lattice_config::PluginTraceLevel;

assert_eq!(PluginTraceLevel::parse_label("debug"), Ok(PluginTraceLevel::Debug));
assert_eq!(PluginTraceLevel::default().label(), "info");
assert!(PluginTraceLevel::parse_label("verbose").is_err());

Trait Implementations

impl Clone for PluginTraceLevel

fn clone(&self) -> PluginTraceLevel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PluginTraceLevel

impl Debug for PluginTraceLevel

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

Formats the value using the given formatter.

impl Default for PluginTraceLevel

fn default() -> PluginTraceLevel

Returns the “default value” for a type.

impl Eq for PluginTraceLevel

impl OptionType for PluginTraceLevel

fn enumerate_is_exhaustive() -> bool

TC.1: closed — parse accepts these forms and nothing else, so the schema is an enum and :customize can offer a picker.

fn parse(s: &str) -> Result<Self, String>

Parse the right-hand side of :set name=value. Errors are surfaced verbatim through the cmdline echo, so the message should read well to the user (mention valid forms when the space is finite). The parser MUST round-trip with format: T::parse(&v.format()) == Ok(v) for every v.

fn format(&self) -> String

Render the current value back to a string (:set foo? echo, the customize buffer view, value comparison). Round-trips with Self::parse.

fn type_label() -> &'static str

Short type label for :describe-option ("boolean", "foldmethod", etc.). Used in help bodies and the customize buffer view.

fn enumerate() -> Option<Vec<&'static str>>

Optional: enumerate valid string forms for :set foo=<Tab> completion. None means “free-form” (no enumerable space – integers, file paths, free strings). The values are &'static str to keep the completion source allocation-free in the common case.

fn enumerate_with_docs() -> Option<Vec<EnumeratedValue>>

Optional: enumerate valid string forms WITH per-value doc strings for the cmdline-completion marginalia column. Default impl wraps Self::enumerate with empty docs; types with rich help override.

fn name_forms(_canonical: &str) -> Vec<String>

Optional: alternative name forms this type accepts for the option name itself. Used by completion to surface the name alongside its negation (:set nu / :set nonu). Default: no extra forms. Booleans return [format!("no{canonical}")].

fn is_bool() -> bool

Whether this type’s option supports :set noFOO. bool returns true; everything else false. Drives the negate path in the cmdline parser.

fn accepts_list() -> bool

Whether this option’s value is list-shaped — i.e. a TOML array at config-load time should be joined into the delimited string Self::parse accepts, rather than rejected as “not applicable to a scalar option”. false for every scalar type (the default); true for list types like crate::ModelineZone. Drives loader::apply_array (ML.5). The :set cmdline path is unaffected — it always passes a string and never sees a TOML array.

fn try_negation_value() -> Result<Self, String>

Negation value (only meaningful for Self::is_bool true). Default: returns Err – the registry guards by checking is_bool() first, so callers that respect the contract won’t observe this. The bool impl returns Ok(false).

fn schema() -> ConfigSchema

The declared shape of this type’s values.

fn to_value(&self) -> ConfigValue

This value as a schema-shaped tree.

fn from_value(value: &ConfigValue) -> Result<Self, String>

Rebuild from a tree. Default: the inverse of Self::to_value, deferring to parse so a type’s validation rules apply on this path exactly as they do on :set.

impl PartialEq for PluginTraceLevel

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PluginTraceLevel