Struct OperationContext 

pub struct OperationContext { /* private fields */ }

Implementations

impl OperationContext

pub fn context(&self) -> &CallContext

pub fn result(&self) -> &OperationResult

pub fn exit_log(&self) -> &bool

pub fn mod_path(&self) -> &String

pub fn target(&self) -> &Option<String>

pub fn action(&self) -> &Option<String>

pub fn locator(&self) -> &Option<String>

pub fn path(&self) -> &[String]

pub fn metadata(&self) -> &ErrorMetadata

pub fn new() -> Self

pub fn want<S: Into<String>>(target: S) -> Self

👎Deprecated since 0.7.0:

use doing(…) for action contexts; use at(…) for locator/resource contexts

pub fn doing<S: Into<String>>(action: S) -> Self

pub fn at<S: Into<String>>(locator: S) -> Self

pub fn with_exit_log(self) -> Self

👎Deprecated since 0.5.4:

use with_auto_log

pub fn with_auto_log(self) -> Self

pub fn with_mod_path<S: Into<String>>(self, path: S) -> Self

pub fn with<S1: Into<String>, S2: Into<String>>(&mut self, key: S1, val: S2)

👎Deprecated since 0.5.4:

use record

pub fn with_path<S1: Into<String>, S2: Into<PathBuf>>( &mut self, key: S1, val: S2, )

👎Deprecated since 0.5.4:

use record

pub fn with_want<S: Into<String>>(&mut self, target: S)

👎Deprecated since 0.7.0:

use with_doing(…) for action path segments; use with_at(…) for locator segments

pub fn with_doing<S: Into<String>>(&mut self, action: S)

pub fn with_at<S: Into<String>>(&mut self, locator: S)

pub fn set_target<S: Into<String>>(&mut self, target: S)

别名：设置目标资源/操作名；首次设置根 want，后续调用仅追加 path

pub fn path_string(&self) -> Option<String>

pub fn record_field<S1, S2>(&mut self, key: S1, val: S2)

where Self: ContextRecord<S1, S2>,

Record a human-readable key-value pair into the context stack.

The entry will appear in the error’s Display output. For typed metadata hidden from console output, use [record_meta()] instead.

pub fn with_field<S1, S2>(self, key: S1, val: S2) -> Self

where Self: ContextRecord<S1, S2>,

Builder-pattern version of [record_field].

pub fn record_meta<K, V>(&mut self, key: K, value: V)

where K: Into<String>, V: Into<MetadataValue>,

Record typed metadata that is not included in Display output.

Use this for structured fields intended for serialization, snapshots, or API responses. For user-visible context entries, use [record_field()].

pub fn with_meta<K, V>(self, key: K, value: V) -> Self

where K: Into<String>, V: Into<MetadataValue>,

Builder-pattern version of [record_meta].

pub fn mark_suc(&mut self)

pub fn mark_cancel(&mut self)

pub fn scope(&mut self) -> OperationScope<'_>

创建作用域 guard，默认为失败状态，需显式 mark_success()

pub fn scoped_success(&mut self) -> OperationScope<'_>

创建作用域 guard，在作用域结束时自动标记成功

pub fn info<S: AsRef<str>>(&self, message: S)

pub fn debug<S: AsRef<str>>(&self, message: S)

pub fn warn<S: AsRef<str>>(&self, message: S)

pub fn error<S: AsRef<str>>(&self, message: S)

pub fn trace<S: AsRef<str>>(&self, message: S)

pub fn log_info<S: AsRef<str>>(&self, message: S)

与文档示例一致的别名方法（调用上面的同名方法）

pub fn log_debug<S: AsRef<str>>(&self, message: S)

pub fn log_warn<S: AsRef<str>>(&self, message: S)

pub fn log_error<S: AsRef<str>>(&self, message: S)

pub fn log_trace<S: AsRef<str>>(&self, message: S)

Trait Implementations

impl Clone for OperationContext

fn clone(&self) -> OperationContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S1> ContextRecord<S1, &Path> for OperationContext

where S1: Into<String>,

fn record_field(&mut self, key: S1, val: &Path)

fn record(&mut self, key: S1, val: S2)

where Self: Sized,

impl<S1> ContextRecord<S1, &PathBuf> for OperationContext

where S1: Into<String>,

fn record_field(&mut self, key: S1, val: &PathBuf)

fn record(&mut self, key: S1, val: S2)

where Self: Sized,

impl<S1> ContextRecord<S1, &str> for OperationContext

where S1: Into<String>,

fn record_field(&mut self, key: S1, val: &str)

fn record(&mut self, key: S1, val: S2)

where Self: Sized,

impl<S1> ContextRecord<S1, String> for OperationContext

where S1: Into<String>,

fn record_field(&mut self, key: S1, val: String)

fn record(&mut self, key: S1, val: S2)

where Self: Sized,

impl Debug for OperationContext

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

Formats the value using the given formatter.

impl Default for OperationContext

fn default() -> Self

Returns the “default value” for a type.

impl Display for OperationContext

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

Formats the value using the given formatter.

impl Drop for OperationContext

fn drop(&mut self)

Executes the destructor for this type.

impl From<&OperationContext> for OperationContext

fn from(value: &OperationContext) -> Self

Converts to this type from the input type.

impl From<&Path> for OperationContext

fn from(value: &Path) -> Self

Converts to this type from the input type.

impl From<&PathBuf> for OperationContext

fn from(value: &PathBuf) -> Self

Converts to this type from the input type.

impl From<&StableSnapshotContextFrame> for OperationContext

fn from(value: &StableSnapshotContextFrame) -> Self

Converts to this type from the input type.

impl From<&str> for OperationContext

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<(&str, &str)> for OperationContext

fn from(value: (&str, &str)) -> Self

Converts to this type from the input type.

impl From<(&str, String)> for OperationContext

fn from(value: (&str, String)) -> Self

Converts to this type from the input type.

impl<V> From<(&str, V)> for OperationContext

where V: NotAsRefStr + AsRef<Path>,

fn from(value: (&str, V)) -> Self

Converts to this type from the input type.

impl From<(String, String)> for OperationContext

fn from(value: (String, String)) -> Self

Converts to this type from the input type.

impl From<OperationContext> for SnapshotContextFrame

fn from(value: OperationContext) -> Self

Converts to this type from the input type.

impl From<SnapshotContextFrame> for OperationContext

fn from(value: SnapshotContextFrame) -> Self

Converts to this type from the input type.

impl From<StableSnapshotContextFrame> for OperationContext

fn from(value: StableSnapshotContextFrame) -> Self

Converts to this type from the input type.

impl From<String> for OperationContext

fn from(value: String) -> Self

Converts to this type from the input type.

impl PartialEq for OperationContext

fn eq(&self, other: &OperationContext) -> 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 OperationContext