1
1
mirror of https://github.com/kanaka/mal.git synced 2024-11-09 18:06:35 +03:00
mal/impls/perl
Nicolas Boulenguez 033892777a Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL
See issue #587.
* Merge eval-ast and eval into a single conditional.
* Expand macros during the apply phase, removing lots of duplicate
  tests, and increasing the overall consistency by allowing the macro
  to be computed instead of referenced by name (`((defmacro! cond
  (...)))` is currently illegal for example).
* Print "EVAL: $ast" at the top of EVAL if DEBUG-EVAL exists in the
  MAL environment.
* Remove macroexpand and quasiquoteexpand special forms.
* Use pattern-matching style in process/step*.txt.

Unresolved issues:
c.2: unable to reproduce with gcc 11.12.0.
elm: the directory is unchanged.
groovy: sometimes fail, but not on each rebuild.
nasm: fails some new soft tests, but the issue is unreproducible when
  running the interpreter manually.
objpascal: unreproducible with fpc 3.2.2.
ocaml: unreproducible with 4.11.1.
perl6: unreproducible with rakudo 2021.09.

Unrelated changes:
Reduce diff betweens steps.
Prevent defmacro! from mutating functions: c forth logo miniMAL vb.
dart: fix recent errors and warnings
ocaml: remove metadata from symbols.

Improve the logo implementation.
Encapsulate all representation in types.lg and env.lg, unwrap numbers.
Replace some manual iterations with logo control structures.
Reduce the diff between steps.
Use native iteration in env_get and env_map
Rewrite the reader with less temporary strings.
Reduce the number of temporary lists (for example, reverse iteration
with butlast requires O(n^2) allocations).
It seems possible to remove a few exceptions: GC settings
(Dockerfile), NO_SELF_HOSTING (IMPLS.yml) and step5_EXCLUDES
(Makefile.impls) .
2024-08-05 11:40:49 -05:00
..
tests Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00
core.pm Change quasiquote algorithm 2020-08-11 01:01:56 +02:00
Dockerfile Update Dockerfiles using ubuntu:vivid to xenial. 2024-08-02 11:10:12 -05:00
env.pm Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL 2024-08-05 11:40:49 -05:00
interop.pm Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00
Makefile Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00
printer.pm Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00
reader.pm Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00
readline.pm Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00
README.md Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00
run Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00
step0_repl.pl Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00
step1_read_print.pl Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00
step2_eval.pl Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL 2024-08-05 11:40:49 -05:00
step3_env.pl Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL 2024-08-05 11:40:49 -05:00
step4_if_fn_do.pl Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL 2024-08-05 11:40:49 -05:00
step5_tco.pl Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL 2024-08-05 11:40:49 -05:00
step6_file.pl Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL 2024-08-05 11:40:49 -05:00
step7_quote.pl Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL 2024-08-05 11:40:49 -05:00
step8_macros.pl Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL 2024-08-05 11:40:49 -05:00
step9_try.pl Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL 2024-08-05 11:40:49 -05:00
stepA_mal.pl Merge eval-ast and macro expansion into EVAL, add DEBUG-EVAL 2024-08-05 11:40:49 -05:00
types.pm Move implementations into impls/ dir 2020-02-10 23:50:16 -06:00

Notes on the mal implementation in Perl5.

This implementation should work in any perl from 5.19.3 onwards. Earlier versions are likely to work too as long as you install a new List::Util. The implementation uses the experimental switch feature, which may make it vulnerable to future changes in perl.

Mal objects are all in subclasses of Mal::Type, and can be treated as scalar, array, or hash references as appropriate.

Metadata support uses Hash::Util::FieldHash to attach external metadata to objects. This means that in the metadata system imposes no overhead on the normal use of objects.

Hash-maps are slightly magical. They're keyed by the stringified versions of mal objects, and Mal::Scalar overloads stringification so that this works properly.

Tail-call optimisation uses Perl's built-in goto &NAME syntax for explicit tail calls. This allows functions defined by fn* to be implemented as functions at the Perl layer.

Perl's garbage-collection is based on reference counting. This means that reference loops will cause memory leaks, and in particular using def! to define a function will cause that function to have a reference to the environment it's defined in, making a small reference loop and hence a memory leak. This can be avoided by carefully undefining any function before it goes out of scope.