Struct netsblox_ast::ParserBuilder

pub struct ParserBuilder { /* private fields */ }

Builder for Parser.

Implementations

impl ParserBuilder

pub fn optimize(&mut self, value: bool) -> &mut Self

If true, the emitted syntax tree will be processed by static optimizations. Defaults to false.

pub fn omit_nonhat_scripts(&mut self, value: bool) -> &mut Self

If true, the parser will skip script blocks that lack a hat block. This is typically desirable since free floating blocks are never automatically executed, and thus are typically not needed for translation efforts. Defaults to true.

pub fn adjust_to_zero_index(&mut self, value: bool) -> &mut Self

If true, the emitted syntax tree will be automatically adjusted to support convenient translation into languages with zero-based indexing. For instance, with this enabled, an item X of _ block will emit X-1 as the index rather than X, and similar for other list-based blocks. Defaults to false.

pub fn name_transformer(
    &mut self,
    value: Rc<dyn Fn(&str) -> Result<String, ()>>
) -> &mut Self

All symbol names in the program will be passed through this function, allowing easy conversion of Snap! names to, e.g., valid C-like identifiers. The default operation performs no conversion. Note that non-default transform strategies may also require a custom ParserBuilder::autofill_generator.

pub fn autofill_generator(
    &mut self,
    value: Rc<dyn Fn(usize) -> Result<String, ()>>
) -> &mut Self

A generator used to produce symbol names for auto-fill closure arguments. The function receives a number that can be used to differentiate different generated arguments. It is expected that multiple calls to this function with the same input will produce the same output symbol name. The default is to produce a string of format %n where n is the input number. Note that, after generation, symbol names are still passed through ParserBuilder::name_transformer as usual.

pub fn build(&self) -> Result<Parser, ParserBuilderError>

Builds a new Parser.

Errors

If a required field has not been initialized.

Trait Implementations

impl Clone for ParserBuilder

fn clone(&self) -> ParserBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for ParserBuilder

fn default() -> Self

Returns the “default value” for a type.