Metadata-Version: 2.4
Name: basilisk-python
Version: 0.34.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
License-File: LICENSE
License-File: NOTICES
License-File: THIRD-PARTY-LICENSES
Summary: Basilisk — the only Python type checker scoring 100% on the official python/typing conformance suite (https://github.com/python/typing/blob/main/conformance/results/results.html) — and the fastest we've measured. Complete open-source Python dev environment in Rust: type checker, language server, debugger, profiler, plus VS Code, Cursor, Zed & Neovim extensions. Strict by default.
Keywords: type-checker,typing,static-analysis,lsp,pep,python
Author-email: Nimblesite <cftools@nimblesite.co>
License-Expression: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Changelog, https://github.com/Nimblesite/Basilisk/releases
Project-URL: Documentation, https://www.basilisk-python.dev/docs/
Project-URL: Homepage, https://www.basilisk-python.dev
Project-URL: Repository, https://github.com/Nimblesite/Basilisk

# Basilisk

**Basilisk is the only Python type checker scoring 100%** on the
[official `python/typing` conformance suite](https://github.com/python/typing/blob/main/conformance/results/results.html) —
and the fastest we've measured. A complete, open-source Python development
environment in Rust: type checker, language server, debugger, profiler, plus
VS Code, Cursor, Zed & Neovim extensions. Strict by default.

- Website: <https://www.basilisk-python.dev>
- Conformance: <https://www.basilisk-python.dev/docs/conformance/>
- Source: <https://github.com/Nimblesite/Basilisk>

This package (`basilisk-python`) bundles the native `basilisk` binary as a
Python wheel so it can be installed with `pip`/`uv`. It is the **same binary**
distributed via GitHub Releases, Homebrew and Scoop — the wheel is a convenience
for Python-managed environments, not a separate build.

> The distribution is named `basilisk-python` because the name `basilisk` was
> already taken on PyPI. The installed command is still `basilisk`.

## Install

```bash
pip install basilisk-python
# or
uv tool install basilisk-python
```

## Use

```bash
basilisk check path/to/your_code.py
basilisk --version
```

Machine-readable output for tooling:

```bash
basilisk check path/to/your_code.py --output json --color never
```

## Acknowledgments

The bundled binary is built on [Ruff](https://github.com/astral-sh/ruff) by
[Astral](https://astral.sh/) (MIT) and [typeshed](https://github.com/python/typeshed)
(Apache-2.0), among other open-source projects. Full third-party notices:
<https://github.com/Nimblesite/Basilisk/blob/main/NOTICES>.

## License

MIT

