Metadata-Version: 2.4
Name: air-formatter
Version: 0.8.2
Summary: An R formatter, written in Rust.
Author: Davis Vaughan, Lionel Henry, Posit Software, PBC
Author-email: Davis Vaughan <davis@posit.co>, Lionel Henry <lionel@posit.co>
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
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 :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.8
Project-URL: Changelog, https://github.com/posit-dev/air/blob/main/CHANGELOG.md
Project-URL: Documentation, https://posit-dev.github.io/air/
Project-URL: Repository, https://github.com/posit-dev/air
Description-Content-Type: text/markdown

# air-formatter

An R formatter. Written in Rust.

This package provides the `air` command-line tool as a Python package, making it easy to install via `pip` or `uv`.

## Installation

Install a global installation of `air` with [uv](https://docs.astral.sh/uv/):

```bash
uv tool install air-formatter
```

or with pip

```bash
pip install air-formatter
```

This puts `air` on the PATH, so you can run:

```bash
# Format R file
air format path/to/file.R

# Format all R files in a directory
air format path/to/directory/
```

Alternatively, invoke air via `uvx` for one-off formatting without a global install:

```bash
uvx --from air-formatter air format path/to/file.R
```

To use a specific version of air:

```bash
# Global install
uv tool install air-formatter@0.8.2

# One off runs
uvx --from air-formatter@0.8.2 air format path/to/file.R
```

## About

Air is an opinionated R formatter built by [Posit](https://posit.co). For more information, see the [main repository](https://github.com/posit-dev/air).
