Struct Session 

pub struct Session {
    pub opts: Options,
    pub target: TargetInfo,
    pub interner: Interner,
    pub sources: SourceMap,
    /* private fields */
}

One compilation.

Holds the options, the string interner and the diagnostics raised so far. Passing a &mut Session is how a stage reports a problem, and the return value of a stage says what it produced, never whether it succeeded: that question is answered by Session::has_errors.

Fields

opts: Options

What this compilation was asked to do.

target: TargetInfo

Everything known about the target.

interner: Interner

The one interner for the compilation.

sources: SourceMap

Every file read during the compilation, and the flat coordinate space their spans live in.

This is on the session rather than passed around separately because a span is only meaningful against the map that issued it, and one map per compilation is the rule that makes that true by construction.

Implementations

impl Session

pub fn new(opts: Options) -> Self

A session for opts.

pub fn emit(&mut self, diag: Diagnostic)

Records a diagnostic.

Under -Werror a warning is promoted here, once, rather than at every site that raises one.

pub fn diagnostics(&self) -> &[Diagnostic]

Everything raised so far, in the order it was raised.

pub fn has_errors(&self) -> bool

Whether anything fatal has been raised.

pub fn error_count(&self) -> u32

How many errors have been raised.

pub fn warning_count(&self) -> u32

How many warnings have been raised.

pub fn error_limit_reached(&self) -> bool

Whether the error limit has been reached and the caller should stop.

Trait Implementations

impl Debug for Session

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

Formats the value using the given formatter.