0.8.1

Release Notes

• Added color to Air's terminal help. Disable by setting the environment variable NO_COLOR=1 (#447, @etiennebacher).

• Fixed an issue with Unicode elements and table alignment (#449).

Install air 0.8.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/posit-dev/air/releases/download/0.8.1/air-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.8.1/air-installer.ps1 | iex"

Download air 0.8.1

File	Platform	Checksum
air-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
air-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
air-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
air-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
air-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
air-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.8.0

Release Notes

• Added support for table formatting of tribble() and fcase() calls (#113).
  You can also opt into table formatting for any other call with the # fmt: table comment directive, or the table TOML option. See also the default-table option to turn off Air's defaults for tribble() and fcase().

  Note: This feature is experimental. We'd be grateful for any feedback!

• Formulas are now treated like assignment operators rather than like comparison operators, which means they now left-align expression chains on the right-hand side of the formula, respect persistent line breaks, and never automatically break around the ~ operator itself (#336, #402).

  With model formulas:

  # Before:
  y ~
    year +
      age +
      size
  
  # After:
  y ~
    year +
    age +
    size

  With complex case_when() calls:

  # Before:
  case_when(
    x %in% c(1, 2) ~
      {
        this + complex + thing
      },
    x %in% c(3, 4) ~
      {
        that + thing
      }
  )
  
  # After:
  case_when(
    x %in% c(1, 2) ~ {
      this + complex + thing
    },
    x %in% c(3, 4) ~ {
      that + thing
    }
  )

Install air 0.8.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/posit-dev/air/releases/download/0.8.0/air-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.8.0/air-installer.ps1 | iex"

Download air 0.8.0

File	Platform	Checksum
air-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
air-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
air-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
air-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
air-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
air-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.7.1

Release Notes

• We now recommend using Tombi for air.toml autocompletion and validation instead of Even Better TOML. Tombi is easily installable from the VS Code Marketplace, the OpenVSX Marketplace, as a Zed extension, or using some other supported installation method. We've improved on our air.toml configuration documentation to help tombi provide the best air.toml editing experience (#371).

Install air 0.7.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/posit-dev/air/releases/download/0.7.1/air-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.7.1/air-installer.ps1 | iex"

Download air 0.7.1

File	Platform	Checksum
air-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
air-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
air-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
air-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
air-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
air-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.7.0

Release Notes

• Autobracing is a new feature applied to if statements, for loops, while loops, repeat loops, and function definitions. This feature will automatically add {} around the body of these code elements in certain cases to maximize readability, consistency, and portability (#225, #334).

  For example:

  if (condition)
    a
  
  # Becomes:
  if (condition) {
    a
  }

  fn <- function(
    a, b
  ) a + b
  
  # Becomes:
  fn <- function(
    a,
    b
  ) {
    a + b
  }

  Single line if statements and function definitions are still allowed in certain contexts:

  list(a = if (is.null(x)) NA else x)
  
  map(xs, function(x) x + 1)

• Empty {} are no longer ever expanded (#43).

  This allows for syntax like:

  dummy <- function() {}
  
  while (waiting()) {}
  
  switch(x, a = {}, b = 2)
  
  function(
    expr = {}
  ) {
    this_first()
    expr
  }

• Binary exponents are now supported in hexadecimal constants (#357).

• NULL is now allowed in function call argument name position (#357).

• Fixed a case where some valid raw strings would cause a parse error (#255).

Install air 0.7.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/posit-dev/air/releases/download/0.7.0/air-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.7.0/air-installer.ps1 | iex"

Download air 0.7.0

File	Platform	Checksum
air-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
air-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
air-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
air-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
air-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
air-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.6.0

Release Notes

• Added documentation on using Air's GitHub Action, setup-air.

• Added documentation on using Air in Zed.

Install air 0.6.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/posit-dev/air/releases/download/0.6.0/air-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.6.0/air-installer.ps1 | iex"

Download air 0.6.0

File	Platform	Checksum
air-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
air-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
air-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
air-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
air-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
air-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.5.0

Release Notes

• Added support for a skip field in air.toml (#273).

  This is an extension of the # fmt: skip comment feature that provides a single place for you to list functions you never want formatting for. For example:

  skip = ["tribble", "graph_from_literal"]

  This skip configuration would skip formatting for these function calls, even without a # fmt: skip comment:

  tribble(
    ~x, ~y,
     1,  2,
     3,  4
  )
  
  igraph::graph_from_literal(A +-+ B +---+ C ++ D + E)

  We expect this to be useful when working with packages that provide domain specific languages that come with their own unique formatting conventions.

• Fixed an issue where air.toml settings were not being applied to the correct R files (#294).

Install air 0.5.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/posit-dev/air/releases/download/0.5.0/air-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.5.0/air-installer.ps1 | iex"

Download air 0.5.0

File	Platform	Checksum
air-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
air-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
air-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
air-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
air-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
air-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.4.1

Release Notes

• Language server configuration variables are now fully optional, avoiding issues in editors like Zed or Helix (#246).

Install air 0.4.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/posit-dev/air/releases/download/0.4.1/air-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.4.1/air-installer.ps1 | iex"

Download air 0.4.1

File	Platform	Checksum
air-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
air-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
air-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
air-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
air-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
air-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.4.0

Release Notes

• Parenthesized expressions now tightly hug (#248).

• We now allow up to 2 lines between top-level elements of a file. This makes it possible to separate long scripts into visually distinct sections (#40).

• Unary formulas (i.e. anonymous functions) like ~ .x + 1 now add a space between the ~ and the right-hand side, unless the right-hand side is very simple, like ~foo or ~1 (#235).

• Semicolons at the very start or very end of a file no longer cause the parser to panic (#238).

• Assigned pipelines no longer double-indent when a persistent line break is used (#220).

• Hugging calls like:

  list(c(
    1,
    2
  ))

  are no longer fully expanded (#21).

• Assigned pipelines no longer double-indent (#220).

• Added support for special "skip" comments.

  Use # fmt: skip to avoid formatting the following node and all of its children. In this case, the tribble() call and all of its arguments (#52).

  # fmt: skip
  tribble(
    ~a, ~b,
     1,  2
  )

  Use # fmt: skip file to avoid formatting an entire file. This comment must appear at the top of the file before any non-comment R code (#219).

Install air 0.4.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/posit-dev/air/releases/download/0.4.0/air-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.4.0/air-installer.ps1 | iex"

Download air 0.4.0

File	Platform	Checksum
air-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
air-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
air-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
air-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
air-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
air-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.3.0

Release Notes

• Air has gained support for excluding files and folders (#128).

  • Air now excludes a set of default R files and folders by default. These
    include generated files such as cpp11.R and RcppExports.R, as well as
    folders that may contain such files, like renv/ and revdep/. If you'd
    prefer to have Air format these files as well, set the new
    default-exclude option to false.

  • To add additional files or folders to exclude, use the new exclude option.
    This accepts a list of .gitignore style patterns, such as
    exclude = ["file.R", "folder/", "files-like-*-this.R"].

• Linux binaries are now available. Note that your Linux distribution must
  support glibc 2.31+ for the binary to work (#71).

• ARM Windows binaries are now available (#170).

Install air 0.3.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/posit-dev/air/releases/download/0.3.0/air-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.3.0/air-installer.ps1 | iex"

Download air 0.3.0

File	Platform	Checksum
air-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
air-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
air-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
air-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
air-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
air-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.2.0

Release Notes

• Initial public release, yay!

  Note that we first released 0.2.0 as 1.0.0. If you have installed the VS Code extension or the CLI program as 1.0.0, please uninstall it.

• Fixed an issue where the language server failed to start due to logging
  being initialized twice.

• Added a synchronization mechanism between IDE and Air settings. See documentation for more information https://posit-dev.github.io/air/configuration.html#settings-synchronization.

• Renamed ignore-magic-line-break to persistent-line-breaks (#177).

• In the CLI, errors and warnings are now written to stderr. This allows you to
  see issues that occur during air format, such as parse errors or file not
  found errors (#155).

• New global CLI option --log-level to control the log level. The default is
  warn (#155).

• New global CLI option --no-color to disable colored output (#155).

• Air now supports .air.toml files in addition to air.toml files. If both
  are in the same directory, air.toml is preferred, but we don't recommend
  doing that (#152).

Install air 0.2.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/posit-dev/air/releases/download/0.2.0/air-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/posit-dev/air/releases/download/0.2.0/air-installer.ps1 | iex"

Download air 0.2.0

File	Platform	Checksum
air-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
air-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
air-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
air-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum