2018-02-03 18:39:55 -07:00
2018-02-03 18:39:55 -07:00
2016-10-28 19:44:10 -06:00
2018-02-01 23:03:57 -07:00

rusty-wam

Phase 1

Produce an implementation of the Warren Abstract Machine in Rust, done according to the progression of languages in Warren's Abstract Machine: A Tutorial Reconstruction.

Phase 1 has been completed in that rusty-wam implements in some form all of the WAM book, including lists, cuts, Debray allocation, first argument indexing, last call optimization and conjunctive queries.

Phase 2

Extend rusty-wam to include the following, among other features:

  • call/N as a built-in meta-predicate (done).
  • ISO Prolog compliant throw/catch (done).
  • Built-in and user-defined operators of all fixities, with custom associativity and precedence (done).
  • Bignum, rational number and floating point arithmetic (done).
  • Built-in control operators (,, ;, ->, etc.) (done).
  • Built-in predicates for list processing and top-level declarative control (setup_call_control/3, call_with_inference_limit/3, etc.) (in progress).
  • Add a rudimentary module system.
  • Attributed variables using the SICStus Prolog interface and semantics. Adding coroutines like dif/2, freeze/2, etc. is straightforward with attributed variables.
  • An occurs check.
  • Mode declarations.
  • Extensions for clp(FD).
  • if_ and related predicates, following the developments of the paper "Indexing dif/2".
  • Strings, blobs, and other data types.

Phase 3

Use the WAM code produced by the completed code generator to target LLVM IR to get JIT-compiled and -executed Prolog programs.

It's my hope to use rusty-wam as the logic engine of a low level (and ideally, very fast) Shen implementation.

Nice to have features

There are no current plans to implement any of these, but they might be nice to have in the future. They'd make a good project for anyone wanting to contribute code to rusty-wam.

  1. Implement the global analysis techniques described in Peter van Roy's thesis, "Can Logic Programming Execute as Fast as Imperative Programming?"

  2. Add unum representation and arithmetic, using either an existing unum implementation or an ad hoc one. Unums are described in Gustafson's book "The End of Error."

  3. Add support for shift/reset delimited continuations, see "Delimited Continuations for Prolog."

  4. Add an incremental compacting garbage collector for the heap.

  5. Add concurrent tables to manage shared references to atoms and strings.

  6. Add optional SLG resolution for fast memoization of predicates.

  7. Add some form of JIT predicate indexing.

Built-in predicates

The following predicates are built-in to rusty-wam.

  • Arithmetic support:
    • is/2 works for (+)/2, (-)/{1,2}, (*)/2, (//)/2, (div)/2, (/)/2, (rdiv)/2, (xor)/2, (rem)/2, (mod)/2, (/\)/2, (\/)/2, (>>)/2, (<<)/2.
    • Comparison operators: >, <, =<, >=, =:=, =\=.
  • (\+)/1
  • (=)/2
  • (=..)/2
  • (->)/2
  • (;)/2
  • append/3
  • arg/3
  • atomic/1
  • between/3
  • call/1..63
  • catch/3
  • display/1
  • duplicate_term/2
  • false/0
  • functor/3
  • integer/1
  • length/2
  • maplist/1..8
  • member/2
  • memberchk/2
  • once/1
  • reverse/2
  • select/3
  • setup_call_cleanup/3
  • throw/1
  • true/0
  • var/1

Tutorial

To enter a multi-clause predicate, the brackets ":{" and "}:" are used as delimiters. They must be contained entirely within their own lines.

For example,

prolog> :{
p(f(f(X)), h(W), Y) :- g(W), h(W), f(X).
p(X, Y, Z) :- h(Y), z(Z).
}:
prolog> :{
h(x).
h(y).
h(z).
}:

Single clause predicates can be entered without brackets, as in

prolog> p(X) :- q(X).
prolog> f(s).
prolog> z(Z).

Queries are issued as

prolog> ?- p(X, Y, Z).

Given the above work, the result of the query will be

prolog> ?- p(X, Y, Z).
true
Y = x
X = _0
Z = _2

Pressing SPACE will backtrack through other possible answers, if any exist. Pressing . will abort the search and return to the prompt.

Wildcards work as well:

prolog> :{
member(X, [X|_]).
member(X, [_|Xs]) :- member(X, Xs).
}:
prolog> ?- member(X, [a, b, c]).      
true .
X = a ;
X = b ;
X = c ;
false.

and so do conjunctive queries:

prolog> f(X) :- g(X).
prolog> g(x). g(y). g(z).
prolog> h(call(f, X)).
prolog> ?- h(X), X.
true .
X = call(f, x) ;
X = call(f, y) ;
X = call(f, z).

Note that the values of variables belonging to successful queries are printed out, on one line each. Uninstantiated variables are denoted by a number preceded by an underscore (X = _0 in an example above).

Lastly, rusty-wam supports dynamic operators. Using the built-in arithmetic operators with the usual precedences,

prolog> ?- display(-5 + 3 - (2 * 4) // 8).
'-'('+'('-'(5), 3), '//'('*'(2, 4), 8))
true.
Description
Mirror of mthom/scryer-prolog + exian patch branch (v0.10.0 + cherry-picked Heap::clear fix 6ec8c906; see exian#13)
Readme BSD-3-Clause 12 MiB
Languages
Rust 63.7%
Prolog 36.1%
Emacs Lisp 0.1%