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.
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0441acef1322e2c23703d0fd76657012a3121247d64de848fb67044f82473b05
|
|
| MD5 |
9261596a075846d407ac568812bd6e15
|
|
| BLAKE2b-256 |
103b8c070c435a31f89280e94ff9d01c709f25633075fad42a69274a0c9e98e7
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
373d38a73a0164ea1587776c2c45ba1ee5cc33433e304a7ea2863fb5231f0b75
|
|
| MD5 |
f53b3f1d085ef5ff667da05446157c44
|
|
| BLAKE2b-256 |
bb7473d7848929cdd539cbb4eb53eb326f72d4a05cc4e4fbfcf3cd9d7f22ce36
|