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
• Nox (Optional)

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

This project uses nox for automating various tasks like running tests and building documentation.

$ nox

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

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