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 pyimpl readthedocs CircleCI 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

Eclipse Public License 1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

basilisp-0.1.dev8.tar.gz (96.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

basilisp-0.1.dev8-py2.py3-none-any.whl (108.0 kB view details)

Uploaded Python 2Python 3

File details

Details for the file basilisp-0.1.dev8.tar.gz.

File metadata

  • Download URL: basilisp-0.1.dev8.tar.gz
  • Upload date:
  • Size: 96.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.7

File hashes

Hashes for basilisp-0.1.dev8.tar.gz
Algorithm Hash digest
SHA256 a4c094d4547b92644352cf424b7856fcbf7f96f7d19f4910710be80ca02398c4
MD5 23ab67b0dcd7ca9fdef13052ecd7e2bf
BLAKE2b-256 c580626650f7ad1da50a57b82a530cb643f4ae42c8810ebbe4fe8ef3b0ae8e82

See more details on using hashes here.

File details

Details for the file basilisp-0.1.dev8-py2.py3-none-any.whl.

File metadata

  • Download URL: basilisp-0.1.dev8-py2.py3-none-any.whl
  • Upload date:
  • Size: 108.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.2 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.7

File hashes

Hashes for basilisp-0.1.dev8-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 701afdaf798e9ec585fb3d999f15dc4a7d63f8edfc40915f52100eabcc5c5007
MD5 e99fe87deabb6fc9a3e36d1bea13082e
BLAKE2b-256 a9ceaa923733ffc2c5713ad472b415b6f2b53088d4a1dd44c5e9437c0cd3dcf8

See more details on using hashes here.

Release history Release notifications | RSS feed

0.5.1

2 files

0.5.0

2 files

0.4.0

2 files

0.3.8

2 files

0.3.7

2 files

0.3.6

2 files

0.3.5

2 files

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.1

2 files

0.1.0

2 files

This release

0.1.dev8 This release

2 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