Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/chuckcscccl/lambdascript

educational tool illustrating beta reduction of untyped lamba terms, also uses rustlr parser generator
https://github.com/chuckcscccl/lambdascript

Last synced: about 1 month ago
JSON representation

educational tool illustrating beta reduction of untyped lamba terms, also uses rustlr parser generator

Lists

README 

        
## Lambdascript



**Lambdascript** executes beta-reduction steps on terms of the lambda calculus,

with the option of inferring polymorphic types before reduction.

It is not a high-performance implementation of lambda

calculus. Rather, the tool serves three primary purposes, all of which

are illustrational or educational in nature:



  1. It demonstrates the usage of the **[rustlr](https://docs.rs/rustlr/latest/rustlr/index.html)** *parser generator*.  The LALR(1) grammar for lambdascript in rustlr format

  is given [here](https://cs.hofstra.edu/~cscccl/rustlr_project/lambdascript/untyped.grammar).



  2. For introductory level students in a programming languages class, the

  tools show every step of beta reduction, including alpha-conversions where

  necessary, in reducing a term to normal form.  It includes both full

  beta-normalization using the normal order (call-by-name) strategy as well

  as weak normalization using call-by-value.  Definitions can be given

  for terms such as S, K, I.



  3. For more advanced students, the source code of the program demonstrates

  how lambda terms can be represented in abstract syntax and how

  reductions can be implemented.  The typing module demonstrates

  how types can be inferred using the unification algorithm.



### Usage

The program was written in Rust and should be installed as an executable: **`cargo install lambdascript`**. You must have Rust installed (from ) to execute the cargo command.



The program can read from a script, or interactively from stdin.

By default, terms are evaluated in the untyped mode.

Given a file `simple.ls` with the following contents:

```

define I = lambda x.x;

define K = lambda x.lambda y.x;

define S = lambda x.lambda y.lambda z.x z (y z);

define lazy INFINITY = (lambda x.x x) (lambda x.x x);

lambda y.K y INFINITY;

```

**`lambdascript untyped simple.ls`** evaluates the input as a script.

The 'untyped' directive is optional since it's the default.  It then enters

interactive mode with the definitions still loaded.  Without the optional

file name, lambda script will just start in interactive mode.

Here is a sample session from executing `simple.ls`:

```

λy.K y INFINITY

= λy.(λxλy.x) y INFINITY

 < alpha conversion of y to y1 >

 =>  λy.(λy1.y) INFINITY

= λy.(λy1.y) ((λx.x x) (λx.x x))

 =>  λy.y



Entering interactive mode, enter 'exit' to quit...

<<< typed

TERMS DEFINED IN THE UNTYPED MODE WILL NOW BE TYPE-CHECKED BEFORE EVALUATION    

<<< K I INFINITY

TYPE INFERENCE FOR  FAILED : UNTYPABLE

EVALUATION CANCELED

<<< I I

THE INFERRED TYPE OF  IS e -> e

I I

= (λx.x) I

 =>  I

= λx.x

```

The reduction terminated in the untyped mode because normal-order

(call-by-name) evaluation is applied by default.  If the the last line

of the file was replaced with `weak (K I INFINITY x)`, then weak

reduction using call-by-value will take place, resulting in an

infinite loop.  There will likewise be an infinite loop if `lazy` was

missing from the definition of `INFINITY`.  Full, normal-order

evaluation and weak call-by-value are the only reduction strategies

implemented in lambdascript.



One can switch from typed to untyped mode with the `typed` directive.

There is no syntax for types in terms.  Most general types are always

inferred.  Undefined free variables are not considered typable. Notice

that `I I` is well-typed because the type *scheme* inferred for `I` can

be instantiated twice.  One can also execute the script directly in the

typed mode. **`lambdascript typed simple.ls`** will show the types

inferred for all definitions:

```

THE INFERRED TYPE OF I IS: Π(a -> a)

THE INFERRED TYPE OF K IS: Π(a -> b -> a)

THE INFERRED TYPE OF S IS: Π((h -> f -> g) -> (h -> f) -> h -> g)

TYPE INFERENCE FOR <(λx.x x) (λx.x x)> FAILED : UNTYPABLE

DEFINITION OF INFINITY NOT ACCEPTED

In the typed mode, the undefined free variable INFINITY cannot be typed

TYPE INFERENCE FOR <λy.K y INFINITY> FAILED : e -> UNTYPABLE

EVALUATION CANCELED

```

Here, `Π` quantifies all type variables in its scope.



Types are always inferred *before* beta-reduction, so it can be called

*static* typing.



Lambdascript uses standard syntax for lambda terms: application

associates to the left and application binds tighter than abstraction,

meaning that the scope of a λ extends to the right as far as possible

unless bounded by parentheses.  However, lambda expressions inside

applications must always by bound by parentheses: so `x lambda y.y`

should be replaced with `x (lambda y.y)`. Defintions and terms to be

evaluated in a script must be separated by ; (semicolon).  All

variables and identifiers are limited to a length of 15 characters.



The file

**[pure.ls](https://cs.hofstra.edu/~cscccl/rustlr_project/lambdascript/pure.ls)**

contains a full list of definitions of well-known (untyped)

lambda-calculus combinators.



#### Interactive Interpreter Directives



At the `<<<` prompt the following special directives can be given:



  * `exit` or `quit` : exits the program

  * `typed` : switch to typed mode: types will be inferred and untypable

    terms will not be reduced.

  * `untyped` : switch to untyped mode

  * `use lambda` or `use lam` or `use Lam` or `use \` : On some systems,

    the Greek character λ (unicode 0x03BB) may fail to display properly.

    To change the symbol displayed for lambda, you can choose between one

    of four alternatives (the choices are limited to these four because the

    symbol must be a statically allocated string).

  * `use greek` or `use unicode`: reverts to displaying λ, which is the default

  * `trace off`: turns off the displaying of intermediate reduction steps: only the initial term and the final normal form are shown

  * `trace medium`: Beta-reduction steps are shown, but not the expansion

    of defintions nor alpha-conversion

  * `trace on` or `trace max`: restore displaying of all steps: this is the

    default



-----------------------------