Skip to main content

Fatou

CI Crates.io Open VSX VS Code PyPi npm

Fatou is a language server, formatter, and linter for Julia that never has to run Julia itself. It bundles three tools in one:

  • Formatter (fatou format): fast, deterministic, and opinionated
  • Linter (fatou lint): configurable, with auto-fix support for many rules
  • Language server (fatou lsp): both of the above, plus IDE features like completion, hover, go-to-definition, and more

Fatou is fast, safe, and easy to embed in editors and tooling. The architecture follows rust-analyzer: a lossless rowan syntax tree that reconstructs the input byte-for-byte, salsa for incremental recomputation, and lsp-server for the language-server transport. It is named after the French mathematician Pierre Fatou, whose Fatou set is the complement of the Julia set.

Installation

Fatou is available from several sources:

  • crates.io: cargo install fatou
  • Homebrew: brew install jolars/tap/fatou
  • npm: npm install -g fatou-cli (bundles a prebuilt binary)
  • PyPI: uv tool install fatou/pipx install fatou
  • AUR (Arch Linux): paru -S fatou-bin (or any other AUR helper)
  • mise/Aqua: see the installation guide
  • NixOS: the fatou package is available in the Nixpkgs repository
  • Prebuilt binaries: from the releases page
  • VS Code/Open VSX: the Fatou extension (Marketplace, Open VSX); also works in Positron

Install Script

If you prefer a one-liner installer that picks the right release artifact for your platform, you can use the installer scripts below, which download the latest matching Fatou release for your platform, installing to a user-local directory by default. If you prefer, download and inspect the script before running it.

For macOS and Linux:

curl --proto '=https' --tlsv1.2 -sSf https://fatou.dev/install | sh

For Windows PowerShell:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://fatou.dev/install.ps1 | iex"

Usage

fatou format file.jl
fatou lint file.jl

Formatting rewrites the file in place; linting reports findings and exits nonzero if it finds any. See Formatting for directory runs, checks, and preservation verification, and Linting for rule selection, fixes, and suppressions.

Put shared settings in fatou.toml; the configuration guide explains setup and discovery.

Editor Integration

The language server (fatou lsp) runs over stdio and provides a broad set of features:

  • formatting (whole-document and range),
  • linting (push and pull),
  • completion (including the REPL's LaTeX and emoji input sequences), hover,
  • go-to-definition, -find references,
  • document highlights,
  • rename (of symbols, and of files and folders),
  • document and workspace symbols,
  • call and type hierarchy,
  • signature help,
  • code actions,
  • folding and selection ranges,
  • document links, and
  • semantic tokens.

Static docstrings participate in those features: decoded local and indexed documentation renders as Markdown, headings appear in the outline and fold as sections, external and internal Markdown links navigate, explicit Documenter @ref targets complete and jump to definitions, and Julia-declared fences get completion, hover, signature help, definition, selection, folding, and semantic highlighting.

The Fatou extension for VS Code and Open VSX (Marketplace, Open VSX) bundles the binary and starts the server automatically; it also works in Positron. See editors/code for the extension, or the editor setup guide for Neovim and other editors.

Fatou is also available from Zed's extension registry. Install Julia, then Fatou, from Zed's extensions view. See the Zed setup guide for configuration.

Integrations

Format Julia files with dprint using dprint-plugin-fatou. The plugin bundles the formatter and uses the fatou settings in dprint.json. See the integrations guide for setup, configuration, and updates.

Run format and lint checks in GitHub Actions with fatou-action, which installs a prebuilt, checksum- and provenance-verified binary. See the GitHub Actions guide for a complete workflow and configuration options.

Run Fatou through pre-commit hooks with fatou-pre-commit. See the pre-commit guide for installation, autofixes, and updates.

Library Crates

The parser and formatter are published as standalone, wasm-compatible crates for embedding in other tools:

  • fatou-parser: lossless CST parser, typed AST wrappers, and incremental reparser.
  • fatou-formatter: the formatting engine, with optional serde/schema features.

Documentation

See https://fatou.dev/ for the full documentation.

Contributing

See CONTRIBUTING.md.

License

MIT, see LICENSE.

Metadata

Release files for fatou 0.26.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fatou 0.26.0
File Size Uploaded Provenance Actions
fatou-0.26.0.tar.gz 1.0 MB With provenance Details for fatou-0.26.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for fatou 0.26.0
File Actions
fatou-0.26.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for fatou-0.26.0-py3-none-win_arm64.whl
fatou-0.26.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for fatou-0.26.0-py3-none-win_amd64.whl
fatou-0.26.0-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for fatou-0.26.0-py3-none-musllinux_1_2_x86_64.whl
fatou-0.26.0-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for fatou-0.26.0-py3-none-musllinux_1_2_aarch64.whl
fatou-0.26.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for fatou-0.26.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
fatou-0.26.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for fatou-0.26.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
fatou-0.26.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for fatou-0.26.0-py3-none-macosx_11_0_arm64.whl
fatou-0.26.0-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for fatou-0.26.0-py3-none-macosx_10_12_x86_64.whl

Total release size: 34.6 MB

Release files / fatou-0.26.0.tar.gz

Download URL fatou-0.26.0.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
bc5dbd63abde38154408bf81b06085fb73be609691f4246e9b57d0ac37e882ca
BLAKE2b-256 checksum
How to use checksums
46541e40b8ddfa639bd98337154643211e0ca1c5107dcc06dc297aeb5dab69d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / fatou-0.26.0-py3-none-win_arm64.whl

Download URL fatou-0.26.0-py3-none-win_arm64.whl
Size 4.2 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
6ab6da5de608311d69fa7803710e98340f17adf77dad56d590f813f3af5f91c2
BLAKE2b-256 checksum
How to use checksums
7e5ea4ec76b106c1b155498c31be42f5fe892d72b24d9ab60f6294926e272b68
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / fatou-0.26.0-py3-none-win_amd64.whl

Download URL fatou-0.26.0-py3-none-win_amd64.whl
Size 4.6 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
5427cd9b0fd603ac3aa31769204f8f6ffd96e11c8294b17210bb45d3879ea4b1
BLAKE2b-256 checksum
How to use checksums
7c7c29c1f238db87f9bc5e93b54f17f66098c64e15fbc294005112e7949e10d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / fatou-0.26.0-py3-none-musllinux_1_2_x86_64.whl

Download URL fatou-0.26.0-py3-none-musllinux_1_2_x86_64.whl
Size 4.4 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
e30203106ff832478652593cf931361d6f719255d2cb04dd16471e1dd60bc481
BLAKE2b-256 checksum
How to use checksums
cb3d1962ae97547e8d45bf06bea1a435dd9312fa8706a80cd1fcf0dde3682511
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / fatou-0.26.0-py3-none-musllinux_1_2_aarch64.whl

Download URL fatou-0.26.0-py3-none-musllinux_1_2_aarch64.whl
Size 4.0 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
4404b3dc890fb490e73a4f15c5fd74be0e7ef01012da5d0ecdc13754031e0c13
BLAKE2b-256 checksum
How to use checksums
a111d6b150b7bfd775643a34149e679aac60035c399de2f782adcb0f4be161a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / fatou-0.26.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL fatou-0.26.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 4.3 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
e9aec7163305ad5e82c5fe5eea8d07702ef57ff35050828327b1677c74d68402
BLAKE2b-256 checksum
How to use checksums
5ae214c7c1da400ff137e6a8a4818e631df15b6508f2b97753e97f25b2440dfb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / fatou-0.26.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL fatou-0.26.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 4.0 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
ccc700894ee4b07310e09ce5bf3a7855471f9a2a6e7554d0db9da113430f941f
BLAKE2b-256 checksum
How to use checksums
e977594f86b278396b6632eb4deb18b69403cf242ecac9bb054a759c6e4dd2b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / fatou-0.26.0-py3-none-macosx_11_0_arm64.whl

Download URL fatou-0.26.0-py3-none-macosx_11_0_arm64.whl
Size 3.9 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
bca47bd9ce87d9ecdd674048fa8cb1dc1593016f1a72d673e1d0e4d0ee9f2ec4
BLAKE2b-256 checksum
How to use checksums
412705579ca3a16e9ef3da0f0f4129c2d5b37995c4f9e00f2d26d7027100deb7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / fatou-0.26.0-py3-none-macosx_10_12_x86_64.whl

Download URL fatou-0.26.0-py3-none-macosx_10_12_x86_64.whl
Size 4.2 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
24cba9fa4a0151dfba18d2cfd512dcc545562637da61dbc445feb010ae37e92e
BLAKE2b-256 checksum
How to use checksums
4817c14f68469d8e17e131d95fec9de932a020bbecb259cd2efd0fef26d4d640
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Security for fatou 0.26.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 9 files in this release have been uploaded with provenance metadata.

Select from 9 files

Attestation for fatou-0.26.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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