CodeFormatter.DevToys 1.1.2

Code Formatter for DevToys

A code formatting extension for DevToys 2.0 that supports 22 programming languages with automatic live formatting.

Features

• Live Auto-Format: Code is automatically formatted as you type (500ms debounce)
• 22 Languages: Python, JavaScript, TypeScript, JSON, Markdown, TOML, CSS, SCSS, Less, HTML, Vue, Svelte, Astro, YAML, GraphQL, Dockerfile, Java, SQL, C, C++, Go, Shell/Bash
• Per-Language Settings: Configure formatting options for each language
• Swap & Clear: Quickly swap input/output or clear both editors
• File Loading: Load code directly from files

Supported Languages & Formatters

Requirements

• DevToys 2.0 (Preview or later)
• For Java/SQL formatting: Node.js with npm packages:

  npm install -g prettier prettier-plugin-java sql-formatter
  

Installation

From NuGet Package

1. Download the .nupkg file from Releases
2. In DevToys, go to Manage Extensions
3. Click Install from file and select the .nupkg
4. Restart DevToys

Manual Installation

1. Extract the .nupkg (it's a ZIP file) to:
   • Windows: %LocalAppData%\DevToys\Plugins\CodeFormatter.DevToys.1.0.0\
   • macOS: ~/Library/com.devtoys/Plugins/CodeFormatter.DevToys.1.0.0/
   • Linux: ~/.local/share/devtoys/Plugins/CodeFormatter.DevToys.1.0.0/
2. Restart DevToys

Usage

1. Open DevToys and find Code Formatter under the Formatters category
2. Select your language from the dropdown
3. Paste or type code in the left editor
4. Formatted output appears automatically in the right editor

Buttons

• Swap: Move output to input (useful for re-formatting)
• Clear: Clear both editors
• Settings (gear icon): Configure formatter settings for each language
• Load: Load code from a file

Configuration

Click the gear icon to open settings for any language. Available options vary by formatter:

Python (Ruff)

• Line Length (40-400)
• Indent Style (space/tab)
• Quote Style (double/single/preserve)
• Line Ending (auto/lf/cr-lf/native)

JavaScript/TypeScript (dprint)

• Line Width
• Indent Width
• Use Tabs
• Semicolons
• Quote Style

JSON (dprint)

• Line Width
• Indent Width
• Use Tabs
• Trailing Commas

SQL (sql-formatter)

• Language dialect (PostgreSQL, MySQL, SQLite, etc.)
• Tab Width
• Keyword Case
• Data Type Case
• Function Case

C/C++ (clang-format)

• Style (LLVM, Google, Chromium, Mozilla, WebKit, Microsoft, GNU)

Go (gofumpt)

• Extra Rules (stricter formatting)

Shell/Bash (shfmt)

• Indent Width (0 for tabs)
• Binary Next Line
• Case Indent
• Space Redirects
• Keep Padding
• Function Next Line

Settings are saved to ~/.config/code-formatter/config.toml (or equivalent on your OS).

Building from Source

Prerequisites

• .NET 8.0 SDK
• Node.js (for Java/SQL formatting tests)

Build

# Clone the repository
git clone https://github.com/user/cs-f.git
cd cs-f

# Build
dotnet build -c Release

# Run tests
dotnet test

# Create NuGet package
dotnet pack -c Release -o ./nupkg

Development

For development with hot reload:

1. Set environment variables:

   [Environment]::SetEnvironmentVariable("DevToysGuiDebugEntryPoint", "C:\path\to\DevToys.exe", "User")
   

2. Press F5 in Visual Studio/VS Code/Rider to debug with DevToys

The Properties/launchSettings.json is configured for debugging with the EXTRAPLUGIN environment variable.

Project Structure

cs-f/
├── CodeFormatterTool.cs      # Main UI and tool implementation
├── Models/
│   ├── Language.cs           # Language enum and extensions
│   ├── FormatterConfig.cs    # Configuration model
│   └── FormatterSettings.cs  # Per-language setting definitions
├── Services/
│   ├── FormatterService.cs   # Formatting orchestration
│   ├── ConfigManager.cs      # TOML config read/write
│   └── ProcessRunner.cs      # External process execution
├── Resources/
│   └── CodeFormatterStrings.resx  # Localized strings
├── Binaries/                 # Bundled formatter executables
│   ├── ruff.exe
│   ├── dprint.exe
│   ├── clang-format.exe
│   ├── gofumpt.exe
│   └── shfmt.exe
└── CodeFormatter.Tests/      # Integration tests

License

MIT

Acknowledgments

• DevToys - The extensible developer toolbox
• Ruff - Fast Python formatter
• dprint - Pluggable code formatter
• Prettier - Opinionated code formatter
• sql-formatter - SQL formatter
• clang-format - LLVM C/C++ formatter
• gofumpt - Stricter gofmt for Go
• shfmt - Shell script formatter