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 poetry to manage the Python virtual environment, project dependencies, and package publication. See the instructions on that repository to install in your local environment. Because basilisp is intended to be used as a library, no poetry.lock file is committed to the repository. Developers should generate their own lock file and update it regularly during development instead.

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 poetry environment, you need to install dependencies:

poetry install

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

make repl

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.0a1.tar.gz (203.6 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.0a1-py3-none-any.whl (225.8 kB view details)

Uploaded Python 3

File details

Details for the file basilisp-0.1.0a1.tar.gz.

File metadata

  • Download URL: basilisp-0.1.0a1.tar.gz
  • Upload date:
  • Size: 203.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.6 CPython/3.9.4 Darwin/20.4.0

File hashes

Hashes for basilisp-0.1.0a1.tar.gz
Algorithm Hash digest
SHA256 0441acef1322e2c23703d0fd76657012a3121247d64de848fb67044f82473b05
MD5 9261596a075846d407ac568812bd6e15
BLAKE2b-256 103b8c070c435a31f89280e94ff9d01c709f25633075fad42a69274a0c9e98e7

See more details on using hashes here.

File details

Details for the file basilisp-0.1.0a1-py3-none-any.whl.

File metadata

  • Download URL: basilisp-0.1.0a1-py3-none-any.whl
  • Upload date:
  • Size: 225.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.6 CPython/3.9.4 Darwin/20.4.0

File hashes

Hashes for basilisp-0.1.0a1-py3-none-any.whl
Algorithm Hash digest
SHA256 373d38a73a0164ea1587776c2c45ba1ee5cc33433e304a7ea2863fb5231f0b75
MD5 f53b3f1d085ef5ff667da05446157c44
BLAKE2b-256 bb7473d7848929cdd539cbb4eb53eb326f72d4a05cc4e4fbfcf3cd9d7f22ce36

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.0a1 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