Metadata-Version: 2.1
Name: basilisp
Version: 0.2.4
Summary: A Clojure-like lisp written for Python
Home-page: https://github.com/basilisp-lang/basilisp
License: Eclipse Public License 1.0 (EPL-1.0)
Author: Christopher Rink
Author-email: chrisrink10@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Eclipse Public License 1.0 (EPL-1.0)
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Software Development :: Compilers
Provides-Extra: pygments
Provides-Extra: pytest
Requires-Dist: astor (>=0.8.1,<0.9.0) ; python_version < "3.9"
Requires-Dist: attrs (>=22.2.0)
Requires-Dist: graphlib-backport (>=1.1.0,<2.0.0) ; python_version < "3.9"
Requires-Dist: immutables (>=0.20,<1.0.0)
Requires-Dist: prompt-toolkit (>=3.0.0,<4.0.0)
Requires-Dist: pygments (>=2.9.0,<3.0.0) ; extra == "pygments"
Requires-Dist: pyrsistent (>=0.18.0,<1.0.0)
Requires-Dist: pytest (>=7.0.0,<9.0.0) ; extra == "pytest"
Requires-Dist: typing-extensions (>=4.7.0,<5.0.0)
Project-URL: Documentation, https://basilisp.readthedocs.io/
Project-URL: Repository, https://github.com/basilisp-lang/basilisp
Description-Content-Type: text/markdown

# 🐍 basilisp 🐍

A Clojure-compatible(-ish) Lisp dialect targeting Python 3.8+.

[![PyPI](https://img.shields.io/pypi/v/basilisp.svg?style=flat-square)](https://pypi.org/project/basilisp/) [![python](https://img.shields.io/pypi/pyversions/basilisp.svg?style=flat-square)](https://pypi.org/project/basilisp/) [![pyimpl](https://img.shields.io/pypi/implementation/basilisp.svg?style=flat-square)](https://pypi.org/project/basilisp/) [![readthedocs](https://img.shields.io/readthedocs/basilisp.svg?style=flat-square)](https://basilisp.readthedocs.io/) [![Run tests](https://github.com/basilisp-lang/basilisp/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/basilisp-lang/basilisp/actions/workflows/run-tests.yml) [![Coveralls github](https://img.shields.io/coveralls/github/basilisp-lang/basilisp.svg?style=flat-square)](https://coveralls.io/github/basilisp-lang/basilisp) [![license](https://img.shields.io/github/license/basilisp-lang/basilisp.svg?style=flat-square)](https://github.com/basilisp-lang/basilisp/blob/master/LICENSE)

## Getting Started

Basilisp is developed on [GitHub](https://github.com/basilisp-lang/basilisp) and
hosted on [PyPI](https://pypi.python.org/pypi/basilisp). You can fetch Basilisp
using `pip`:

```bash
pip install basilisp
```

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

```bash
basilisp repl
```

Basilisp [documentation](https://basilisp.readthedocs.io) can help guide your
exploration at the REPL. Additionally, Basilisp features many of the same functions
and idioms as [Clojure](https://clojure.org/), so you may find guides and
documentation there helpful for getting started.

## Why does this project exist?

Basilisp is a project I (@chrisrink10) created to learn about Python, Clojure,
hosted  languages, and compilers.

That said, it is generally stable at this point with reasonably high test
coverage, linting, and type checking. Work is ongoing to complete the rest of
standard the library implementations. I suspect it could be used to build small
applications and tools at this point, though I would not recommend it unless you
like being a very early adopter.

_Use in a production setting at your own risk._

## License

Eclipse Public License 1.0

