Formattatori

Dropstone utilizza formattatori specifici per linguaggio.

Dropstone può formattare i file dopo che sono stati scritti o modificati utilizzando formattatori specifici per linguaggio. I formattatori sono disabilitati per impostazione predefinita; abilitali nella tua configurazione prima che Dropstone li esegua.

Built-in

Dropstone viene fornito con diversi formattatori built-in per linguaggi e framework popolari. Di seguito è riportato un elenco dei formattatori, delle estensioni di file supportate e dei comandi o delle opzioni di configurazione di cui ha bisogno.

Formatter	Extensions	Requirements
air	.R	`air` command available
biome	.js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, e altri	`biome.json(c)` config file
cargofmt	.rs	`cargo fmt` command available
clang-format	.c, .cpp, .h, .hpp, .ino, e altri	`.clang-format` config file
cljfmt	.clj, .cljs, .cljc, .edn	`cljfmt` command available
dart	.dart	`dart` command available
dfmt	.d	`dfmt` command available
gleam	.gleam	`gleam` command available
gofmt	.go	`gofmt` command available
htmlbeautifier	.erb, .html.erb	`htmlbeautifier` command available
ktlint	.kt, .kts	`ktlint` command available
mix	.ex, .exs, .eex, .heex, .leex, .neex, .sface	`mix` command available
nixfmt	.nix	`nixfmt` command available
ocamlformat	.ml, .mli	`ocamlformat` command available e `.ocamlformat` config file
ormolu	.hs	`ormolu` command available
pint	.php	`laravel/pint` dependency in `composer.json`
prettier	.js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, e altri	`prettier` dependency in `package.json`
rubocop	.rb, .rake, .gemspec, .ru	`rubocop` command available
ruff	.py, .pyi	`ruff` command available with config
rustfmt	.rs	`rustfmt` command available
shfmt	.sh, .bash	`shfmt` command available
standardrb	.rb, .rake, .gemspec, .ru	`standardrb` command available
terraform	.tf, .tfvars	`terraform` command available
uv	.py, .pyi	`uv` command available
zig	.zig, .zon	`zig` command available

Quando i formattatori sono abilitati, Dropstone utilizzerà prettier per i file corrispondenti se il tuo progetto ha prettier in package.json.

Come funziona

Quando Dropstone scrive o modifica un file e i formattatori sono abilitati, esegue:

Controlla l'estensione del file rispetto a tutti i formattatori abilitati.
Esegue il comando del formattatore appropriato sul file.
Applica le modifiche di formattazione.

Questo processo avviene in background per i formattatori abilitati.

Configura

Puoi abilitare e personalizzare i formattatori tramite la sezione formatter nella tua configurazione Dropstone.

Per abilitare tutti i formattatori built-in, imposta formatter su true.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "formatter": true
}

Utilizza un oggetto per mantenere i built-in abilitati mentre configuri override o formattatori personalizzati.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "formatter": {}
}

Ogni configurazione del formattatore supporta le seguenti proprietà:

Property	Type	Description
`disabled`	boolean	Imposta questo su `true` per disabilitare il formattatore
`command`	string[]	Il comando da eseguire per la formattazione. Obbligatorio per formattatori personalizzati; facoltativo per i built-in.
`environment`	object	Variabili di ambiente da impostare quando si esegue il formattatore
`extensions`	string[]	Estensioni di file che questo formattatore dovrebbe gestire

Diamo un'occhiata ad alcuni esempi.

Disabilitazione dei formattatori

Se formatter viene omesso, tutti i formattatori sono disabilitati. Per disabilitare tutti i formattatori dopo che un'altra configurazione li ha abilitati, imposta formatter su false:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "formatter": false
}

Per disabilitare un formattatore specifico, imposta disabled su true:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "formatter": {
    "prettier": {
      "disabled": true
    }
  }
}

Formattatori personalizzati

Puoi configurare i formattatori built-in con opzioni come environment o extensions. Per aggiungere un formattatore personalizzato, specifica un command e extensions:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "formatter": {
    "prettier": {
      "command": ["npx", "prettier", "--write", "$FILE"],
      "environment": {
        "NODE_ENV": "development"
      },
      "extensions": [".js", ".ts", ".jsx", ".tsx"]
    },
    "custom-markdown-formatter": {
      "command": ["deno", "fmt", "$FILE"],
      "extensions": [".md"]
    }
  }
}

Il placeholder $FILE nel comando verrà sostituito con il percorso del file in fase di formattazione.

LSP

VS Code Extension