1.Mal是一个受Clojure启发的Lisp解释器
2.MAL是一种学习工具
MAL的每个实现被分成11个增量的、自包含的(且可测试的)步骤，这些步骤演示了Lisp的核心概念。最后一步是能够自托管(运行mal的错误实现)。请参阅make-a-lisp process
Make-a-LISP步骤包括：
每个Make-a-LISP步骤都有一个关联的架构图。该步骤的新元素以红色高亮显示。以下是step A ：
如果您对创建mal实现感兴趣(或者只是对使用mal做某事感兴趣)，欢迎您加入我们的Discord 或加入#mal onlibera.chat 除了make-a-lisp 还有一个mal/make-a-lisp 在这里我试图回答一些常见的问题
3.MAL用86种语言实现(91种不同实现，113种运行模式)
Mal第一次出现在2014年Clojure West的闪电演讲中(不幸的是没有视频)。参见Examples/clojurewest2014.mal了解会议上的演示文稿(是的，该演示文稿是一个MALL程序)
在Midwest.io 2015上，乔尔·马丁(Joel Martin)就MAL做了题为“解锁的成就：一条更好的语言学习之路”的演讲Video ，Slides
最近，乔尔在LambdaConf 2016大会上发表了题为“用10个增量步骤打造自己的Lisp解释器”的演讲：Part 1 ，Part 2 ，Part 3 ，Part 4 ，Slides
运行任何给定实现的最简单方法是使用docker。每个实现都有一个预先构建的停靠器映像，其中安装了语言依赖项。您可以在顶层Makefile中使用一个方便的目标启动REPL(其中impl是实现目录名，stepX是要运行的步骤)：
make DOCKERIZE=1 "repl^IMPL^stepX"
# OR stepA is the default step:
make DOCKERIZE=1 "repl^IMPL"
以下实施作为单独的项目进行维护：
Ada实现是在Debian上使用GNAT4.9开发的。如果您有git、gnat和make(可选)的windows版本，它也可以在windows上编译而不变。没有外部依赖项(未实现ReadLine)
cd impls/ada
make
./stepX_YYY
第二个Ada实现是使用GNAT 8开发的，并与GNU读取线库链接
cd impls/ada
make
./stepX_YYY
Mal的GNU awk实现已经使用GNU awk 4.1.1进行了测试
cd impls/gawk
gawk -O -f stepX_YYY.awk
cd impls/bash
bash stepX_YYY.sh
Basic实现使用一个预处理器，该预处理器可以生成与C64 Basic(CBMv2)和QBasic兼容的Basic代码。C64模式已经过测试cbmbasic (当前需要打补丁的版本来修复线路输入问题)，并且QBasic模式已经过测试qb64
生成C64代码并使用cbmbasic运行：
cd impls/basic
make stepX_YYY.bas
STEP=stepX_YYY ./run
生成QBasic代码并加载到qb64中：
cd impls/basic
make MODE=qbasic stepX_YYY.bas
./qb64 stepX_YYY.bas
感谢Steven Syrek 有关此实现的原始灵感，请参阅
BBC Basic V实现可以在Brandy解释器中运行：
cd impls/bbc-basic
brandy -quit stepX_YYY.bbc
或在RISC OS 3或更高版本下的ARM BBC Basic V中：
*Dir bbc-basic.riscos
*Run setup
*Run stepX_YYY
mal的C实现需要以下库(lib和头包)：glib、libffi6、libgc以及libedit或GNU readline库
cd impls/c
make
./stepX_YYY
mal的第二个C实现需要以下库(lib和头包)：libedit、libgc、libdl和libffi
cd impls/c.2
make
./stepX_YYY
构建mal的C++实现需要g++-4.9或clang++-3.5和readline兼容库。请参阅cpp/README.md有关更多详细信息，请执行以下操作：
cd impls/cpp
make
# OR
make CXX=clang++-3.5
./stepX_YYY
mal的C#实现已经在Linux上使用Mono C#编译器(MCS)和Mono运行时(2.10.8.1版)进行了测试。两者都是构建和运行C#实现所必需的
cd impls/cs
make
mono ./stepX_YYY.exe
Chuck实现已经使用Chuck 1.3.5.2进行了测试
在很大程度上，Clojure实现需要Clojure 1.5，然而，要通过所有测试，则需要Clojure 1.8.0-RC4
cd impls/clojure
lein with-profile +stepX trampoline run
sudo npm install -g coffee-script
cd impls/coffee
coffee ./stepX_YYY
该实现已经在Ubuntu 16.04和Ubuntu 12.04上使用SBCL、CCL、CMUCL、GNU CLISP、ECL和Allegro CL进行了测试，请参阅README 了解更多详细信息。如果您安装了上述依赖项，请执行以下操作来运行实现
cd impls/common-lisp
make
./run
MAL的晶体实现已经用Crystal 0.26.1进行了测试
cd impls/crystal
crystal run ./stepX_YYY.cr
# OR
make # needed to run tests
./stepX_YYY
使用GDC4.8对MAL的D实现进行了测试。它需要GNU读取线库
cd impls/d
make
./stepX_YYY
DART实施已使用DART 1.20进行了测试
cd impls/dart
dart ./stepX_YYY
Emacs Lisp的MAL实现已经使用Emacs 24.3和24.5进行了测试。虽然有非常基本的读数行编辑(<backspace>和C-d工作,C-c取消进程)，建议使用rlwrap
cd impls/elisp
emacs -Q --batch --load stepX_YYY.el
# with full readline support
rlwrap emacs -Q --batch --load stepX_YYY.el
MAL的长生不老的实现已经在长生不老的长生不老的1.0.5中进行了测试
cd impls/elixir
mix stepX_YYY
# Or with readline/line editing functionality:
iex -S mix stepX_YYY
MAL的ELM实现已经用ELM 0.18.0进行了测试
cd impls/elm
make stepX_YYY.js
STEP=stepX_YYY ./run
Mal的Erlang实现需要Erlang/OTP R17 和rebar 要建造
cd impls/erlang
make
# OR
MAL_STEP=stepX_YYY rebar compile escriptize # build individual step
./stepX_YYY
ES6/ECMAScript 2015实施使用babel 用于生成ES5兼容JavaScript的编译器。生成的代码已经在Node 0.12.4上进行了测试
cd impls/es6
make
node build/stepX_YYY.js
mal的F#实现已经在Linux上使用Mono F#编译器(Fsharpc)和Mono运行时(版本3.12.1)进行了测试。单C#编译器(MCS)也是编译readline依赖项所必需的。所有这些都是构建和运行F#实现所必需的
cd impls/fsharp
make
mono ./stepX_YYY.exe
MAL的因子实现已通过因子0.97(factorcode.org )
cd impls/factor
FACTOR_ROOTS=. factor -run=stepX_YYY
MAL的幻象实现已经用幻象1.0.70进行了测试
cd impls/fantom
make lib/fan/stepX_YYY.pod
STEP=stepX_YYY ./run
Mal的Fennel实现已经在Lua5.4上使用Fennel版本0.9.1进行了测试
cd impls/fennel
fennel ./stepX_YYY.fnl
cd impls/forth
gforth stepX_YYY.fs
cd impls/guile
guile -L ./ stepX_YYY.scm
MALL的Smalltalk实现已经在GNU Smalltalk 3.2.91上进行了测试
cd impls/gnu-smalltalk
./run
MALL的GO实现要求在路径上安装GO。该实现已经在GO 1.3.1上进行了测试
cd impls/go
make
./stepX_YYY
mal的Groovy实现需要Groovy才能运行，并且已经使用Groovy 1.8.6进行了测试
cd impls/groovy
make
groovy ./stepX_YYY.groovy
Haskell实现需要GHC编译器版本7.10.1或更高版本以及Haskell parsec和readline(或editline)包
cd impls/haskell
make
./stepX_YYY
Mal的Haxe实现需要编译Haxe3.2版。支持四种不同的Haxe目标：neko、Python、C++和JavaScript
cd impls/haxe
# Neko
make all-neko
neko ./stepX_YYY.n
# Python
make all-python
python3 ./stepX_YYY.py
# C++
make all-cpp
./cpp/stepX_YYY
# JavaScript
make all-js
node ./stepX_YYY.js
MAL的Hy实现已经用Hy 0.13.0进行了测试
cd impls/hy
./stepX_YYY.hy
已使用IO版本20110905测试了MAL的IO实现
cd impls/io
io ./stepX_YYY.io
MAIL的Janet实现已经使用Janet版本1.12.2进行了测试
cd impls/janet
janet ./stepX_YYY.janet
mal的Java实现需要maven2来构建
cd impls/java
mvn compile
mvn -quiet exec:java -Dexec.mainClass=mal.stepX_YYY
# OR
mvn -quiet exec:java -Dexec.mainClass=mal.stepX_YYY -Dexec.args="CMDLINE_ARGS"
这个Java实现可以在OpenJDK上运行，但是多亏了Truffle框架，它在GraalVM上的运行速度可以提高30倍。它已经在OpenJDK 11、GraalVM CE 20.1.0和GraalVM CE 21.1.0上进行了测试
cd impls/java-truffle
./gradlew build
STEP=stepX_YYY ./run
cd impls/js
npm install
node stepX_YYY.js
Mal的Julia实现需要Julia 0.4
cd impls/julia
julia stepX_YYY.jl
针对1.6版进行了测试，IO部门存在大量作弊行为
cd impls/jq
STEP=stepA_YYY ./run
# with Debug
DEBUG=true STEP=stepA_YYY ./run
MAL的Kotlin实现已经使用Kotlin 1.0进行了测试
cd impls/kotlin
make
java -jar stepX_YYY.jar
已使用LiveScript 1.5测试了mal的LiveScript实现
cd impls/livescript
make
node_modules/.bin/lsc stepX_YYY.ls
MAL的Logo实现已经用UCBLogo 6.0进行了测试
cd impls/logo
logo stepX_YYY.lg
Mal的Lua实现已经使用Lua 5.3.5进行了测试。该实现需要安装luarock
cd impls/lua
make # to build and link linenoise.so and rex_pcre.so
./stepX_YYY.lua
运行mal的错误实现包括运行其他实现之一的STEPA，并传递作为命令行参数运行的mal步骤
cd impls/IMPL
IMPL_STEPA_CMD ../mal/stepX_YYY.mal
cd impls/make
make -f stepX_YYY.mk
MAL的NASM实现是为x86-64 Linux编写的，并且已经在Linux 3.16.0-4-AMD64和NASM版本2.11.05上进行了测试
cd impls/nasm
make
./stepX_YYY
MAL的NIM实现已经使用NIM 1.0.4进行了测试
cd impls/nim
make
# OR
nimble build
./stepX_YYY
MAL的对象Pascal实现已经使用Free Pascal编译器版本2.6.2和2.6.4在Linux上构建和测试
cd impls/objpascal
make
./stepX_YYY
Mal的Objective C实现已经在Linux上使用CLANG/LLVM3.6进行了构建和测试。它还使用XCode7在OS X上进行了构建和测试
cd impls/objc
make
./stepX_YYY
cd impls/ocaml
make
./stepX_YYY
MATLAB实现已经在GNU Octave 4.2.1上进行了测试。它还在Linux上用MATLAB版本R2014a进行了测试。请注意，matlab是一个商业产品。
cd impls/matlab
./stepX_YYY
octave -q --no-gui --no-history --eval "stepX_YYY();quit;"
matlab -nodisplay -nosplash -nodesktop -nojvm -r "stepX_YYY();quit;"
# OR with command line arguments
octave -q --no-gui --no-history --eval "stepX_YYY('arg1','arg2');quit;"
matlab -nodisplay -nosplash -nodesktop -nojvm -r "stepX_YYY('arg1','arg2');quit;"
miniMAL 是用不到1024字节的JavaScript实现的小型Lisp解释器。要运行mal的最小实现，您需要下载/安装最小解释器(这需要Node.js)
cd impls/miniMAL
# Download miniMAL and dependencies
npm install
export PATH=`pwd`/node_modules/minimal-lisp/:$PATH
# Now run mal implementation in miniMAL
miniMAL ./stepX_YYY
Perl 5实现应该使用Perl 5.19.3和更高版本
要获得读取行编辑支持，请从CPAN安装Term：：ReadLine：：Perl或Term：：ReadLine：：GNU
cd impls/perl
perl stepX_YYY.pl
Perl6实现在Rakudo Perl6 2016.04上进行了测试
cd impls/perl6
perl6 stepX_YYY.pl
mal的PHP实现需要php命令行界面才能运行
cd impls/php
php stepX_YYY.php
Picolisp实现需要libreadline和Picolisp 3.1.11或更高版本
Pike实现在Pike8.0上进行了测试
cd impls/pike
pike stepX_YYY.pike
mal的PL/pgSQL实现需要一个正在运行的PostgreSQL服务器(“kanaka/mal-test-plpgsql”docker映像自动启动PostgreSQL服务器)。该实现连接到PostgreSQL服务器并创建名为“mal”的数据库来存储表和存储过程。包装器脚本使用psql命令连接到服务器，并默认为用户“postgres”，但可以使用PSQL_USER环境变量覆盖该值。可以使用PGPASSWORD环境变量指定密码。该实现已使用PostgreSQL 9.4进行了测试
cd impls/plpgsql
./wrap.sh stepX_YYY.sql
# OR
PSQL_USER=myuser PGPASSWORD=mypass ./wrap.sh stepX_YYY.sql
mal的PL/SQL实现需要一个正在运行的Oracle DB服务器(“kanaka/mal-test-plsql”docker映像自动启动Oracle Express服务器)。该实现连接到Oracle服务器以创建类型、表和存储过程。默认的SQL*Plus登录值(用户名/口令@CONNECT_IDENTIFIER)是“SYSTEM/ORACLE”，但是可以用ORACLE_LOGON环境变量覆盖该值。该实施已使用Oracle Express Edition 11g Release 2进行了测试。请注意，任何SQL*Plus连接警告(用户密码过期等)都会干扰包装脚本与数据库通信的能力
cd impls/plsql
./wrap.sh stepX_YYY.sql
# OR
ORACLE_LOGON=myuser/mypass@ORCL ./wrap.sh stepX_YYY.sql
mal的PostScript实现需要运行Ghostscript。它已经使用Ghostscript 9.10进行了测试
cd impls/ps
gs -q -dNODISPLAY -I./ stepX_YYY.ps
Mal的PowerShell实现需要PowerShell脚本语言。它已经在Linux上使用PowerShell 6.0.0 Alpha 9进行了测试
cd impls/powershell
powershell ./stepX_YYY.ps1
Prolog实现使用了一些特定于SWI-Prolog的结构，包括READLINE支持，并且已经在8.2.1版的Debian GNU/Linux上进行了测试
cd impls/prolog
swipl stepX_YYY
cd impls/python
python stepX_YYY.py
第二个Python实现大量使用类型注释并使用Arpeggio解析器库
# Recommended: do these steps in a Python virtual environment.
pip3 install Arpeggio==1.9.0
python3 stepX_YYY.py
你一定是rpython 在您的路径上(随附pypy )
cd impls/rpython
make # this takes a very long time
./stepX_YYY
MALL R实现需要R(r-base-core)来运行
cd impls/r
make libs # to download and build rdyncall
Rscript stepX_YYY.r
Mal的racket实现需要运行racket编译器/解释器
cd impls/racket
./stepX_YYY.rkt
Mal的Rexx实现已经使用Regina Rexx 3.6进行了测试
cd impls/rexx
make
rexx -a ./stepX_YYY.rexxpp
cd impls/ruby
ruby stepX_YYY.rb
Mal的Rust实现需要使用Rust编译器和构建工具(Cargo)来构建
cd impls/rust
cargo run --release --bin stepX_YYY
安装Scala和SBT(http://www.scala-sbt.org/0.13/tutorial/Installing-sbt-on-Linux.html )：
cd impls/scala
sbt 'run-main stepX_YYY'
# OR
sbt compile
scala -classpath target/scala*/classes stepX_YYY
MAL的方案实施已在赤壁-方案0.7.3、卡瓦2.4、高车0.9.5、鸡肉4.11.0、人马座0.8.3、气旋0.6.3(Git版本)和Foment 0.4(Git版本)上进行了测试。在弄清库是如何加载的并调整了R7RS实现的基础上，您应该能够让它在其他符合R7RS标准的实现上运行Makefile和run相应地编写脚本
cd impls/scheme
make symlinks
# chibi
scheme_MODE=chibi ./run
# kawa
make kawa
scheme_MODE=kawa ./run
# gauche
scheme_MODE=gauche ./run
# chicken
make chicken
scheme_MODE=chicken ./run
# sagittarius
scheme_MODE=sagittarius ./run
# cyclone
make cyclone
scheme_MODE=cyclone ./run
# foment
scheme_MODE=foment ./run
MAL的不对称实现已经使用不对称0.7.42进行了测试
cd impls/skew
make
node stepX_YYY.js
Mal的标准ML实现需要一个SML97 实施。Makefile支持POLY/ML、MLTON、MOVICO ML，并已在POLY/ML 5.8.1、MLTON 20210117和MOSSIONS ML版本2.10上进行了测试
cd impls/sml
# Poly/ML
make sml_MODE=polyml
./stepX_YYY
# MLton
make sml_MODE=mlton
./stepX_YYY
# Moscow ML
make sml_MODE=mosml
./stepX_YYY
MALL的SWIFT实施需要SWIFT 2.0编译器(XCode 7.0)来构建。由于语言和标准库中的更改，旧版本将无法运行
cd impls/swift
make
./stepX_YYY
MALL的SWIFT 3实施需要SWIFT 3.0编译器。它已经在SWIFT 3预览版3上进行了测试
cd impls/swift3
make
./stepX_YYY
MALL的SWIFT 4实施需要SWIFT 4.0编译器。它已在SWIFT 4.2.3版本中进行了测试
cd impls/swift4
make
./stepX_YYY
MALL的SWIFT 5实施需要SWIFT 5.0编译器。它已在SWIFT 5.1.1版本中进行了测试
cd impls/swift5
swift run stepX_YYY
Mal的Tcl实现需要运行Tcl 8.6。要获得readline行编辑支持，请安装tclreadline
cd impls/tcl
tclsh ./stepX_YYY.tcl
mal的TypeScript实现需要TypeScript 2.2编译器。它已经在Node.js V6上进行了测试
cd impls/ts
make
node ./stepX_YYY.js
MALL的VALA实现已经用VALA0.40.8编译器进行了测试。您将需要安装valac和libreadline-dev或同等的
cd impls/vala
make
./stepX_YYY
用GHDL0.29对mal的vhdl实现进行了测试。
cd impls/vhdl
make
./run_vhdl.sh ./stepX_YYY
Mal的Vimscript实现需要运行Vim 8.0
cd impls/vimscript
./run_vimscript.sh ./stepX_YYY.vim
Mal的VB.NET实现已经在Linux上使用Mono VB编译器(Vbnc)和Mono运行时(2.10.8.1版)进行了测试。构建和运行VB.NET实现需要两者
cd impls/vb
make
mono ./stepX_YYY.exe
WebAssembly实现是用Wam (WebAssembly宏语言)，并在几种不同的非Web嵌入(运行时)下运行：node ，wasmtime ，wasmer ，lucet ，wax ，wace ，warpy
cd impls/wasm
# node
make wasm_MODE=node
./run.js ./stepX_YYY.wasm
# wasmtime
make wasm_MODE=wasmtime
wasmtime --dir=./ --dir=../ --dir=/ ./stepX_YYY.wasm
# wasmer
make wasm_MODE=wasmer
wasmer run --dir=./ --dir=../ --dir=/ ./stepX_YYY.wasm
# lucet
make wasm_MODE=lucet
lucet-wasi --dir=./:./ --dir=../:../ --dir=/:/ ./stepX_YYY.so
# wax
make wasm_MODE=wax
wax ./stepX_YYY.wasm
# wace
make wasm_MODE=wace_libc
wace ./stepX_YYY.wasm
# warpy
make wasm_MODE=warpy
warpy --argv --memory-pages 256 ./stepX_YYY.wasm
mal的XSLT实现是用XSLT3编写的，并在Saxon 9.9.1.6家庭版上进行了测试
cd impls/xslt
STEP=stepX_YY ./run
MAL的WREN实现在WREN 0.2.0上进行了测试
cd impls/wren
wren ./stepX_YYY.wren
MAL的Yorick实现在Yorick 2.2.04上进行了测试
cd impls/yorick
yorick -batch ./stepX_YYY.i
MAL的Zig实现在Zig0.5上进行了测试
cd impls/zig
zig build stepX_YYY
顶层Makefile有许多有用的目标来协助实现、开发和测试。这个helpTarget提供目标和选项的列表：
中几乎有800个通用功能测试(针对所有实现)。tests/目录。每个步骤都有相应的测试文件，其中包含特定于该步骤的测试。这个runtest.py测试工具启动MAL步骤实现，然后将测试一次一个提供给实现，并将输出/返回值与预期的输出/返回值进行比较
make "test^IMPL"
# e.g.
make "test^clojure"
make "test^js"
make "test^stepX"
# e.g.
make "test^step2"
make "test^step7"
要针对单个实施运行特定步骤的测试，请执行以下操作：
make "test^IMPL^stepX"
# e.g
make "test^ruby^step3"
make "test^ps^step4"
若要在自托管模式下运行功能测试，请指定mal作为测试实现，并使用MAL_IMPLMake Variable以更改基础主机语言(默认值为JavaScript)：
make MAL_IMPL=IMPL "test^mal^step2"
# e.g.
make "test^mal^step2" # js is default
make MAL_IMPL=ruby "test^mal^step2"
make MAL_IMPL=python "test^mal^step2"
要在特定步骤中启动实施的REPL，请执行以下操作：
make "repl^IMPL^stepX"
# e.g
make "repl^ruby^step3"
make "repl^ps^step4"
make "repl^IMPL"
# e.g
make "repl^ruby"
make "repl^ps"
若要启动自托管实现的REPL，请指定mal作为REPL实现，并使用MAL_IMPLMake Variable以更改基础主机语言(默认值为JavaScript)：
make MAL_IMPL=IMPL "repl^mal^stepX"
# e.g.
make "repl^mal^step2" # js is default
make MAL_IMPL=ruby "repl^mal^step2"
make MAL_IMPL=python "repl^mal"
警告：这些性能测试在统计上既不有效，也不全面；运行时性能不是mal的主要目标。如果你从这些性能测试中得出任何严肃的结论，那么请联系我，了解堪萨斯州一些令人惊叹的海滨房产，我愿意以低价卖给你
make "perf^IMPL"
# e.g.
make "perf^js"
要报告单个实施的行和字节统计信息，请执行以下操作：
make "stats^IMPL"
# e.g.
make "stats^js"
每个实现目录都包含一个Dockerfile，用于创建包含该实现的所有依赖项的docker映像。此外，顶级Makefile还支持在停靠器容器中通过传递以下参数来运行测试目标(以及perf、stats、repl等“DOCKERIZE=1” 在make命令行上。例如：
make DOCKERIZE=1 "test^js^step3"
现有实现已经构建了坞站映像，并将其推送到坞站注册表。但是，如果您希望在本地构建或重建坞站映像，TopLevel Makefile提供了构建坞站映像的规则：
注意事项 ：
Docker镜像被命名为“Kanaka/mal-test-iml”
基于JVM的语言实现(Groovy、Java、Clojure、Scala)：您可能需要首先手动运行此命令一次make DOCKERIZE=1 "repl^IMPL"然后才能运行测试，因为需要下载运行时依赖项以避免测试超时。这些依赖项被下载到/mal目录中的点文件中，因此它们将在两次运行之间保持不变
MAL(make-a-lisp)是根据MPL 2.0(Mozilla Public License 2.0)许可的。有关更多详细信息，请参阅LICENSE.txt
