Biçimlendiriciler

opencode dile özgü biçimlendiriciler kullanır.

opencode, dosyaları dile özgü formatlayıcılar kullanılarak yazıldıktan veya düzenlendikten sonra otomatik olarak formatlar. Bu, oluşturulan kodun projenizin kod stillerine uymasını sağlar.

Built-in

opencode, popüler diller ve çerçeveler için çeşitli yerleşik biçimlendiricilerle birlikte gelir. Aşağıda ihtiyaç duyduğu biçimlendiricilerin, desteklenen dosya uzantılarının ve komutların veya yapılandırma seçeneklerinin bir listesi bulunmaktadır.

Formatter	Extensions	Requirements
gofmt	.go	`gofmt` komutu mevcut
mix	.ex, .exs, .eex, .heex, .leex, .neex, .sface	`mix` komutu mevcut
prettier	.js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml ve more	`package.json` içinde `prettier` bağımlılığı
biome	.js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml ve more	`biome.json(c)` yapılandırma dosyası
zig	.zig, .zon	`zig` komutu mevcut
clang-format	.c, .cpp, .h, .hpp, .ino ve more	`.clang-format` yapılandırma dosyası
ktlint	.kt, .kts	`ktlint` komutu mevcut
ruff	.py, .pyi	`ruff` komutu yapılandırmayla kullanılabilir
rustfmt	.rs	`rustfmt` komutu mevcut
cargofmt	.rs	`cargo fmt` komutu mevcut
uv	.py, .pyi	`uv` komutu mevcut
rubocop	.rb, .rake, .gemspec, .ru	`rubocop` komutu mevcut
standardrb	.rb, .rake, .gemspec, .ru	`standardrb` komutu mevcut
htmlbeautifier	.erb, .html.erb	`htmlbeautifier` komutu mevcut
air	.R	`air` komutu mevcut
dart	.dart	`dart` komutu mevcut
ocamlformat	.ml, .mli	`ocamlformat` komutu mevcut ve `.ocamlformat` yapılandırma dosyası
terraform	.tf, .tfvars	`terraform` komutu mevcut
gleam	.gleam	`gleam` komutu mevcut
nixfmt	.nix	`nixfmt` komutu mevcut
shfmt	.sh, .bash	`shfmt` komutu mevcut
pint	.php	`composer.json` içinde `laravel/pint` bağımlılığı
oxfmt (Experimental)	.js, .jsx, .ts, .tsx	`package.json` içinde `oxfmt` bağımlılığı ve experimental env variable flag
ormolu	.hs	`ormolu` komutu mevcut

Yani eğer projenizin prettier dosyasında package.json varsa, opencode bunu otomatik olarak kullanacaktır.

Nasıl çalışır?

opencode bir dosyayı yazdığında veya düzenlediğinde:

Dosya uzantısını tüm etkin formatlayıcılara göre kontrol eder.
Dosyada uygun biçimlendirici komutunu çalıştırır.
Biçimlendirme değişikliklerini otomatik olarak uygular.

Bu işlem arka planda gerçekleşir ve kod stillerinizin herhangi bir manuel adım olmadan korunmasını sağlar.

Yapılandır

Biçimlendiricileri opencode yapılandırmanızdaki formatter bölümü aracılığıyla özelleştirebilirsiniz.

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": {}
}

Her formatlayıcı yapılandırması aşağıdakileri destekler:

Property	Type	Açıklama
`disabled`	boolean	Biçimlendiriciyi devre dışı bırakmak için bunu `true` olarak ayarlayın
`command`	string[]	Biçimlendirme için çalıştırılacak komut
`environment`	object	Biçimlendiriciyi çalıştırırken ayarlanacak ortam değişkenleri
`extensions`	string[]	Bu formatlayıcının işlemesi gereken dosya uzantıları

Bazı örneklere bakalım.

Biçimlendiricileri devre dışı bırakma

tüm biçimlendiricileri genel olarak devre dışı bırakmak için formatter değerini false olarak ayarlayın:

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": false
}

Belirli bir biçimlendiriciyi devre dışı bırakmak için disabled değerini true olarak ayarlayın:

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

Özel biçimlendiriciler

Komutu, ortam değişkenlerini ve dosya uzantılarını belirterek yerleşik biçimlendiricileri geçersiz kılabilir veya yenilerini ekleyebilirsiniz:

{
  "$schema": "https://opencode.ai/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"]
    }
  }
}

Komuttaki $FILE yer tutucusu, biçimlendirilen dosyanın yolu ile değiştirilecektir.