Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

🐍 basilisp 🐍

A Lisp dialect inspired by Clojure targeting Python 3.

Disclaimer: Basilisp is a project I created to learn about Python, Clojure, and hosted languages generally. It should not be used in a production setting.

PyPI python readthedocs TravisCI Coveralls github license

Getting Started

Basilisp is developed on GitHub and hosted on PyPI. You can fetch Basilisp using a simple:

pip install basilisp

Once Basilisp is installed, you can enter into the REPL using:

basilisp repl

Basilisp documentation can help guide your exploration at the REPL. Additionally, Basilisp features many of the same functions and idioms as Clojure so you may find guides and documentation there helpful for getting started.

Developing on Basilisp

Requirements

This project uses pipenv to manage the Python virtual environment and project dependencies. pipenv can be installed using Homebrew (on OS X) or pip otherwise:

brew install pipenv
pip install --user pipenv

Additionally, pyenv is recommended to manage versions of Python readily on your local development environment. Setup of pyenv is somewhat more specific to your environment, so see the documentation in the repository for more information.

Getting Started

To prepare your pipenv environment, you need to install dependencies and install Basilisp as an editable dependency:

make setup-dev

Afterwards, you can start up the REPL for development with a simple:

make repl

If dependencies are added or changed afterwards, you may need to make setup-dev again before attempting to start the REPL again or run tests.

Linting, Running Tests, and Type Checking

Basilisp automates linting, running tests, and type checking using Tox. All three steps can be performed using a simple make target:

make test

Testing is performed using PyTest. Type checking is performed by MyPy. Linting is performed using Prospector.

License

MIT License

Metadata

Release files for basilisp 0.1.dev6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for basilisp 0.1.dev6
File Size Uploaded
basilisp-0.1.dev6.tar.gz 176.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for basilisp 0.1.dev6
File Interpreter ABI Platform
basilisp-0.1.dev6-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 377.1 kB

Release files / basilisp-0.1.dev6.tar.gz

Download URL basilisp-0.1.dev6.tar.gz
Size 176.7 kB
Tags Source
SHA-256 checksum
How to use checksums
613590a69b8ff3eb81d3e45fc194f4d4a32852057feacfbe222a130b1d3ed7ea
BLAKE2b-256 checksum
How to use checksums
40ed138d7fe2caa0dea4d1f47e3ea09ef6ba461ce69708325a900ade2d032b58
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.6

Release files / basilisp-0.1.dev6-py2.py3-none-any.whl

Download URL basilisp-0.1.dev6-py2.py3-none-any.whl
Size 200.4 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
946913e09b43f604c1a9ab17bbad9cc95310f9a15a9cada1877f727d521f19c9
BLAKE2b-256 checksum
How to use checksums
964025a4acf31d7bf5a419bf5df3e29edff1f876479880645b42e3f59977e563
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.6

Release history Release notifications | RSS feed

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.8

2 release files

0.3.7

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

This release

0.1.dev6 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page