Struct Error 

pub struct Error(/* private fields */);

The shim’s error type: a crate::Error rendered the way serde_yaml 0.9 worded and located it.

Since the behavioural-shim rework this is a newtype, not a re-export of crate::Error — the payoff is Display and Error::location parity with upstream on the error classes the serde_yaml contract exercises:

• budget refusals read repetition limit exceeded / recursion limit exceeded, unlocated, exactly as upstream;
• a refused non-scalar key reads invalid type: sequence, expected a string key at the key’s location;
• parse errors adopt libyaml’s phrasing where the class is recognisable (did not find expected node content …, while parsing a flow node; did not find expected ',' or ']' …, while parsing a flow sequence at …), and an error at end-of-input reports the line after the last one, column 1 — libyaml’s EOF convention;
• deserialization errors render suffix-style (field: message at line L column C).

Classes without an upstream equivalent keep noyalib’s own wording. The inner crate::Error stays reachable via Error::into_inner / Error::inner.

Implementations

impl Error

pub fn from_noyalib_with_input(inner: Error, input: &str) -> Self

Wrap a noyalib error, rendering it upstream-style against the input it came from (the input drives the EOF location convention and the flow-sequence context trailer).

Examples

use noyalib::compat::serde_yaml::Error;
let input = "title: [oops";
let inner = noyalib::from_str::<noyalib::Value>(input).unwrap_err();
let e = Error::from_noyalib_with_input(inner, input);
// libyaml's end-of-input convention: the line after the last.
assert_eq!(e.location().unwrap().line(), 2);

pub fn location(&self) -> Option<Location>

The upstream-shaped location, when the error has one. 1-based line and column, 0-based byte index — the exact serde_yaml::Location surface.

Examples

use noyalib::compat::serde_yaml as syml;
let err = syml::from_str::<syml::Value>("a: [unclosed").unwrap_err();
let loc = err.location().unwrap();
assert!(loc.line() >= 1 && loc.column() >= 1);
let _: usize = loc.index();

pub fn inner(&self) -> &Error

Borrow the underlying crate::Error.

Examples

use noyalib::compat::serde_yaml as syml;
let err = syml::from_str::<syml::Value>("a: [unclosed").unwrap_err();
assert!(matches!(err.inner().kind(), noyalib::ErrorKind::Syntax));

pub fn into_inner(self) -> Error

Unwrap into the underlying crate::Error — the way back to noyalib’s own diagnostics (miette/ariadne adapters included).

Examples

use noyalib::compat::serde_yaml as syml;
let err = syml::from_str::<syml::Value>("a: [unclosed").unwrap_err();
let inner: noyalib::Error = err.into_inner();
assert!(inner.location().is_some());

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(inner: Error) -> Self

Converts to this type from the input type.