🚀 A Fast Configurable Salesforce Apex Formatter

Table of Contents

• 📘 Introduction
• 🌐 Playground
• ⭐ Features
• ✨ vs. Prettier Apex
• 📥 Installation
• 💻 Usage
• 🔧 Configuration
• ❓ FAQ
• 🤝 Contribution

📘 Introduction

afmt (Apex formatting tool) is written in Rust 🦀 and leverages the tree-sitter sfapex parser.

[!NOTE] We're looking for contributors to help create a VSCode plugin! Feel free to join the discussion!

🌐 Playground

Try the browser version playground, and its source code here.

⭐ Features

• Performant
• Configurable: via .afmt.toml.
• Standalone: CLI with no dependencies.
• Open Source

✨ vs. Prettier Apex

While both afmt and Prettier Apex aim to format Salesforce Apex code, they differ fundamentally in their design philosophies:

• Prettier Apex: Maintains an opinionated approach with limited customization to ensure consistency.
• afmt: Focuses on extensibility, offering more configuration options to cater to diverse user preferences.

This means afmt will progressively introduce more configuration options, addressing user customization needs that Prettier's design intentionally avoids.

Other Highlights:

📥 Installation

1. Script Install

For Linux/MacOS

curl -sL https://raw.githubusercontent.com/xixiaofinland/afmt/main/scripts/install-afmt.sh | bash

For Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/xixiaofinland/afmt/main/scripts/install-afmt.ps1 | iex

[!NOTE] If you see an error like "This script contains malicious content and has been blocked by your antivirus software", it means Microsoft Defender flagged it for downloading and executing content from the internet. To proceed, either lower Defender’s protection or break the script into smaller steps:

# Step 1: Review the script manually
Invoke-WebRequest -Uri https://raw.githubusercontent.com/xixiaofinland/afmt/main/scripts/install-afmt.ps1 -OutFile install-afmt.ps1
notepad install-afmt.ps1  # Inspect the content

# Step 2: Run after trust
powershell -ExecutionPolicy Bypass -File install-afmt.ps1

2. Cargo Install

afmt is published in creates.io here. Run cmd below if you have the Cargo tool.

cargo install sf-afmt

3. Manual Download

Visit the release page and download the appropriate binary for your operating system (Linux, macOS, or Windows).

💻 Usage

Create a file.cls file with valid Apex code.

Dry Run:

Run afmt ./file.cls to preview the formatting result.

> afmt ./file.cls
Result 0: Ok
global class PluginDescribeResult {
    {
        [SELECT FIELDS(STANDARD) FROM Organization LIMIT 1];
    }
}

Format and Write:

Run afmt -w ./file.cls to format the file and overwrite it with the formatted code.

> afmt -w ./file.cls
Formatted content written back to: ./file.cls
Afmt completed successfully.

🔧 Configuration:

-c parameter can read configuration settings from a toml file.

Example: afmt -c .afmt.toml

In .afmt.toml config file, two options are supported

# Maximum line width
max_width = 80

# Indentation size in spaces
indent_size = 4

❓ FAQ

• "TLTR, what features afmt has?" Run afmt -h.

• "How do I set up afmt in VSCode?" Setup in VSCode

• "Can afmt formats exactly the same as Prettier Apex?" No.

🤝 Contribution

We greatly value contributions! You can help by reporting issues or submitting PRs.

PR Contribution Guidelines

Scenarios (e.g., new features, bug fixes) must be covered by tests, and cargo test passes. Refer to *.in (before format) and *.cls (after format) files in the test folder.

Also, our CI pipeline ensures high-quality contributions.

CI Rules:

1. Use conventional commit for commit messages. Example: the project commit history
2. Ensure code passes rustfmt and clippy: cargo fmt -- --check and cargo clippy
3. Run and pass all unit tests: cargo test --all-features
4. Pass battle tests by running afmt on a list of popular Apex repos