Trait Mangler 

pub trait Mangler {
    // Required method
    fn mangle(&self, path: &ModulePath, item: &str) -> String;

    // Provided methods
    fn unmangle(&self, _mangled: &str) -> Option<(ModulePath, String)> { ... }
    fn mangle_types(
        &self,
        item: &str,
        variant: u32,
        _types: &[TypeExpression],
    ) -> String { ... }
}

A name mangler is responsible for renaming import-qualified identifiers into valid WGSL identifiers.

Mangler implementations must respect the following constraints:

• A pair {path, item} (aka. fully-qualified name) must be associated with a unique mangled name.
• A mangled name must be associated with a unique pair {path, item} (or at least, the risk of a collision must be negligible).
• The mangled name must be a valid WGSL identifier.

Calls to Mangler::mangle must respect these preconditions:

• the item must be a valid WGSL identifier.

WESL Reference

spec: NameMangling.md

Required Methods

fn mangle(&self, path: &ModulePath, item: &str) -> String

Turn an import path and item name into a mangled WGSL identifier.

Provided Methods

fn unmangle(&self, _mangled: &str) -> Option<(ModulePath, String)>

Reverse the Mangler::mangle operation. Implementing this is optional.

fn mangle_types( &self, item: &str, variant: u32, _types: &[TypeExpression], ) -> String

Used for generics. Is experimental. Implementing is optional.

Trait Implementations

impl From<ManglerKind> for Box<dyn Mangler>

fn from(kind: ManglerKind) -> Self

Converts to this type from the input type.

Implementations on Foreign Types

impl<T: Mangler + ?Sized> Mangler for &T

fn mangle(&self, path: &ModulePath, item: &str) -> String

fn unmangle(&self, mangled: &str) -> Option<(ModulePath, String)>

fn mangle_types( &self, item: &str, variant: u32, types: &[TypeExpression], ) -> String

impl<T: Mangler + ?Sized> Mangler for Box<T>

fn mangle(&self, path: &ModulePath, item: &str) -> String

fn unmangle(&self, mangled: &str) -> Option<(ModulePath, String)>

fn mangle_types( &self, item: &str, variant: u32, types: &[TypeExpression], ) -> String

Implementors

impl Mangler for EscapeMangler

impl Mangler for HashMangler

impl Mangler for NoMangler

impl Mangler for UnicodeMangler

impl<'a> Mangler for SourceMapper<'a>

impl<T: Mangler> Mangler for CacheMangler<'_, T>