Skip to main content

LowerResult

Struct LowerResult 

Source
pub struct LowerResult {
    pub document: Document,
    pub diagnostics: Vec<Diagnostic>,
    pub metadata: DocumentMetadata,
    pub reads_external_resources: bool,
}
Expand description

Result of lowering a [SyntaxTree] into a [Document].

§Examples

use std::path::Path;

use mos_core::CollectingSink;
use mos_eval::{Evaluator, LowerResult};

let mut sink = CollectingSink::new();
let parse_result = mos_parse::parse("= Hello\n", Path::new("main.mos"), &mut sink);
assert!(
    parse_result.is_ok(),
    "parse structurally aborted: {parse_result:?}"
);
if let Ok(tree) = parse_result {
    let result: LowerResult = Evaluator::new().evaluate(&tree);

    assert!(!result.has_errors());
}

Fields§

§document: Document§diagnostics: Vec<Diagnostic>§metadata: DocumentMetadata§reads_external_resources: bool

Whether lowering this document read external files: #image / #figure image loads and #bibliography source reads. Such a lowering is not a pure function of the source text: the same (src, file) can lower differently as referenced files appear, change, or fail to load. Callers that cache a LowerResult across time (e.g. the language server’s per-document memo) must not reuse one with this set, since an external change would make it stale without any source edit to invalidate it.

Implementations§

Source§

impl LowerResult

Source

pub fn has_errors(&self) -> bool

Return whether any lowering diagnostic is an error.

§Examples
use std::path::Path;

let result = mos_eval::lower("= Hello\n", Path::new("main.mos"));

assert!(!result.has_errors());

Trait Implementations§

Source§

impl Debug for LowerResult

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.