Struct Style 

pub struct Style<K> { /* private fields */ }

Formatting rules compiled against one language, ready for format().

Build one with Rules::compile. Style::default is the empty style: every gap keeps its original whitespace.

Examples

use fmt_lang::{Rules, Space, Style, TokenRule};

// Kinds here are plain strings; a real language resolves names to its own
// kind type (for lang-forge: `|name| lang.kind(name)`).
let style: Style<&str> = Rules::new()
    .token(TokenRule::new("+").around(Space::Single))
    .compile(|name| ["+", "num"].into_iter().find(|k| *k == name))?;

Implementations

impl<K> Style<K>

pub fn with_touch(self, touch: fn(&str, &str) -> bool) -> Self

Replaces the test that decides whether two tokens may be written with nothing between them (default: can_touch).

The formatter calls it only where a rule would remove whitespace the source had between two tokens; if it answers false, one space is kept. A language whose lexer would read the touching texts differently (for example one with a -1 literal, where - and 1 must not touch) supplies its own test here.

Examples

use fmt_lang::{can_touch, Style};

fn no_minus_digit(left: &str, right: &str) -> bool {
    let digit = right.starts_with(|c: char| c.is_ascii_digit());
    !(left.ends_with('-') && digit) && can_touch(left, right)
}
let style = Style::<u8>::default().with_touch(no_minus_digit);

Trait Implementations

impl<K: Clone> Clone for Style<K>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<K: Debug> Debug for Style<K>

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

Formats the value using the given formatter.

impl<K> Default for Style<K>

fn default() -> Self

Returns the “default value” for a type.