Struct lalrpop_snap::Configuration

pub struct Configuration {
    // some fields omitted
}

Configure various aspects of how LALRPOP works. Intended for use within a build.rs script. To get the default configuration, use Configuration::new.

Methods

impl Configuration

fn new() -> Configuration

Creates the default configuration; equivalent to Configuration::default.

fn always_use_colors(&mut self) -> &mut Configuration

Always use ANSI colors in output, even if output does not appear to be a TTY.

fn never_use_colors(&mut self) -> &mut Configuration

Never use ANSI colors in output, even if output appears to be a TTY.

fn use_colors_if_tty(&mut self) -> &mut Configuration

Use ANSI colors in output if output appears to be a TTY, but not otherwise. This is the default.

fn set_in_dir<P>(&mut self, dir: P) -> &mut Self where P: Into<PathBuf>

Specify a custom directory to search for input files. This directory is recursively searched for .lalrpop files to be considered as input files. This configuration setting also impacts where output files are placed; paths are made relative to the input path before being resolved relative to the output path. By default, the input directory is the current working directory.

fn set_out_dir<P>(&mut self, dir: P) -> &mut Self where P: Into<PathBuf>

Specify a custom directory to use when writing output files. By default, the output directory is the same as the input directory.

fn use_cargo_dir_conventions(&mut self) -> &mut Self

Apply cargo directory location conventions, by setting the input directory to src and the output directory to $OUT_DIR.

fn force_build(&mut self, val: bool) -> &mut Configuration

If true, always convert .lalrpop files into .rs files, even if the .rs file is newer. Default is false.

fn emit_comments(&mut self, val: bool) -> &mut Configuration

If true, emit comments into the generated code. This makes the generated code significantly larger. Default is false.

fn log_quiet(&mut self) -> &mut Configuration

Minimal logs: only for errors that halt progress.

fn log_info(&mut self) -> &mut Configuration

Informative logs: give some high-level indications of progress (default).

fn log_verbose(&mut self) -> &mut Configuration

Verbose logs: more than info, but still not overwhelming.

fn log_debug(&mut self) -> &mut Configuration

Debug logs: better redirect this to a file. Intended for debugging LALRPOP itself.

fn process(&self) -> Result<(), Box<Error>>

Process all files according to the set_in_dir and set_out_dir configuration.

fn process_current_dir(&self) -> Result<(), Box<Error>>

Process all files in the current directory, which -- unless you have changed it -- is typically the root of the crate being compiled.

fn process_dir<P: AsRef<Path>>(&self, path: P) -> Result<(), Box<Error>>

Process all .lalrpop files in path.

fn process_file<P: AsRef<Path>>(&self, path: P) -> Result<(), Box<Error>>

Process the given .lalrpop file.

Trait Implementations

impl Default for Configuration

fn default() -> Configuration

Returns the "default value" for a type.

impl Clone for Configuration

fn clone(&self) -> Configuration

Returns a copy of the value.

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

Performs copy-assignment from source.