https://github.com/posit-dev/air
R formatter and language server
https://github.com/posit-dev/air
Last synced: 11 months ago
JSON representation
R formatter and language server
- Host: GitHub
- URL: https://github.com/posit-dev/air
- Owner: posit-dev
- License: mit
- Created: 2024-10-26T18:24:07.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-06T17:35:18.000Z (11 months ago)
- Last Synced: 2025-05-07T11:58:48.687Z (11 months ago)
- Language: Rust
- Homepage: https://posit-dev.github.io/air/
- Size: 3.93 MB
- Stars: 240
- Watchers: 7
- Forks: 13
- Open Issues: 71
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
Air 
============================================================================
[](https://github.com/posit-dev/air/actions)
> [!NOTE]
> Air is currently in beta. Expect breaking changes both in the API and in formatting results. We also recommend that you use a version control system like git so you can easily see the changes that Air makes.
An R formatter and language server, written in Rust.
# Installation
Air is usable both as a command line tool and as a language server inside your favorite code editors. If you'd like to use Air within a code editor, we recommend reading our [editors guide](https://posit-dev.github.io/air/editors.html). If you'd just like to use Air from the command line, you can install Air using our standalone installers.
On macOS and Linux:
```shell
curl -LsSf https://github.com/posit-dev/air/releases/latest/download/air-installer.sh | sh
```
On Windows:
```shell
powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/latest/download/air-installer.ps1 | iex"
```
For a specific version:
```shell
curl -LsSf https://github.com/posit-dev/air/releases/download/0.1.1/air-installer.sh | sh
powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.1.1/air-installer.ps1 | iex"
```
The installer scripts will automatically add Air to your `PATH`. The very first time you install Air, you'll need to restart your shell for the `PATH` modifications to be applied.
# Acknowledgements and inspiration
First and foremost, Air would not exist without the preexisting work and dedication poured into [styler](https://github.com/r-lib/styler). Created by [Lorenz Walthert](https://github.com/lorenzwalthert) and [Kirill Müller](https://github.com/krlmlr), styler proved that the R community does care about how their code is formatted, and had been the primary implementation of the [tidyverse style guide](https://style.tidyverse.org/) for many years.
Additionally, Air draws inspiration from many non-R sources including [rust-analyzer](https://github.com/rust-lang/rust-analyzer), [prettier](https://github.com/prettier/prettier), [biome](https://github.com/biomejs/biome), and [ruff](https://github.com/astral-sh/ruff). These are all excellent tools that provide either formatters, language servers, or both, all of which have influenced design decisions in Air, produced libraries on which we depend, or wrote code that we included in the project.
We are particularly thankful to [biome](https://github.com/biomejs/biome), as Air is built on top of their language agnostic tooling for both building a [rowan](https://github.com/rust-analyzer/rowan) syntax tree and implementing a formatter. Biome is an open source project maintained by community members, please consider [sponsoring them](https://github.com/sponsors/biomejs#sponsors).