LISP-like interpreted language implemented in Python.

Installation & Basic Usage

This package can be installed through PyPI:

$ pip install amalgam-lisp

This makes the amalgam command-line script available.

$ amalgam                     # To invoke the REPL
$ amalgam hello.am            # To load and run a file
$ amalgam --expr="(+ 42 42)"  # To evaluate an expression

Development Setup

Install the following dependencies:

• Python 3.7 & 3.8
• Poetry

Clone and then navigate to the repository:

$ git clone https://github.com/PureFunctor/amalgam-lisp.git
$ cd amalgam-lisp

Install the dependencies for the project:

$ poetry install
$ poetry run pre-commit install

Running Tests / Coverage Reports / Building Documentation

nox is used for the automation of the execution of tests, which generates, combines, and reports coverage data for Python 3.7 and 3.8, as well as building documentation for the project.

$ poetry run nox

Alternatively, tests, coverage reports, and the documentation can be generated manually.

$ poetry run coverage run -m pytest
$ poetry run coverage combine
$ poetry run coverage report -m
$ poetry run coverage html
$ poetry run sphinx-build docs docs/build