#typenum #uuid #memquery

tylisp

A domain-specific language for expressing complex type bounds

1 unstable release

0.1.0 May 22, 2021

#675 in Programming languages


Used in mem-query

MIT/Apache

78KB
2K SLoC

TyLisp: a domain-specific language for type-system calculations

This crate is still experimental and likely to undergo significant changes. It is developed primarily to support the needs of memquery.

tylisp is a programming language embedded in Rust's macro and type systems. Its main purpose is to ease the burden of writing extremely-generic Rust code that comes from a proliferation of trait bounds. Because tylisp calculations occur entirely within the type system, any object that the used operations support will automatically be accepted.

tylisp has two distinct operating modes:

  • Eval mode will calculate a type, but doesn't provide any means to produce a value of that type. It's mostly used to convey extra context informtion that can help select one of several implementations.
  • Calc additionally provides a mechanism to apply the same actions to runtime values, which will produce a result value of the specified type. This allows us to define overloaded functions that have a return type dependent on argument types.

Semver Hazards

Writing code this way poses unique challenges to versioning. All of the Rust functions defined via tylisp expose their internal algorithm in the public API. Thus, any change to the internal workings of a function have the potential to break downstream code.

Best practice is to specify traditional trait bounds that constrain the input and output types, and manually verify that the tylisp code always satisfies these constraints.

Dependencies

~0.4–1MB
~20K SLoC