2024年8月にリリースされた Cloudflare Terraform Provider v4.40.0 で Cloudflare Zero Trust 関連のリソースに変更があって，多くのリソースが deprecated になっている．よって，現在最新の v5 にアップデートするためにはリソースの変更に対応する必要がある．最近 Cloudflare Terraform Provider v4 → v5 にアップデートをする機会があって，個人的に検証したことをまとめておこうと思う📝 今回は以下のバージョンを使う． Cloudflare Terraform Provider v4.52.5 C…

はじめに Claude CodeなどのAI Agentを使ってコーディングを行う際に、プロジェクト固有のUIライブラリやデザインシステムを使ってくれなかった経験はありませんか？ これらを指示文に明記しても、コンテキストが大きいと忘れてしまい、従ってくれない場合があります。 このような場合、ESLintやBiomeなどのLinterを使って、プロジェクト固有のコーディング規約を自動化することができます。 ただし、ESLintは実行速度の問題があり、AI Agentと組み合わせて使う際のiteration速度を遅くする要因となりえます。 そこで、この記事では先日v2.0がリリースされ、B... Source link

An overview of how to use Biome's Linter Plugins

なぜASTツールがリンターにとって重要なのかZennの皆様こんにちは。ast-grepの著者、Herringtonです。大規模プロジェクトで一貫性のある高品質なコードを維持することは、大きな課題です。最新のRustベースのLintingツールは、基本的なコーディング標準を強制する点で素晴らしいパフォーマンスを発揮しますが、開発者が高度にカスタムなプロジェクト固有のパターンや、コードベース全体にわ

なぜASTツールがリンターにとって重要なのか Zennの皆様こんにちは。ast-grepの著者、Herringtonです。 大規模プロジェクトで一貫性のある高品質なコードを維持することは、大きな課題です。最新のRustベースのLintingツールは、基本的なコーディング標準を強制する点で素晴らしいパフォーマンスを発揮しますが、開発者が高度にカスタムなプロジェクト固有のパターンや、コードベース全体にわたる自動化された大規模なリファクタリングを必要とする場合、しばしば不十分です。ここで、AST（Abstract Syntax Tree：抽象構文木）ベースのツール、特にネイティブリンターにおけるプラグインシステムの開発が不可欠になります。 このレポートでは、2つの主要なASTベースのツール、Biomeの新しいGritQLプラグインと、確立されたast-grepについて深く掘り下げていきます。それぞれの構文、パフォーマンス、機能などを比較し、開発者が自身の特定のニーズに最も適したツールを選択できるよう、包括的なガイドを提供します。 競合ツールの紹介: 概要 詳細な比較に入る前に、各ツールを個別に見て、その主要な機能と設計哲学を理解しましょう。 BiomeのGritQLプラグイン: Biomeブロックの新顔 Biomeは、ウェブプロジェクト向けに設計された高速なフォーマッターおよびリンターであり、PrettierやESLintのようなツールの包括的な代替を目指しています。2.0ベータ版のリリースで、BiomeはカスタムLintルールを定義するためにGritQLを最初にサポートするプラグインシステムを導入しました。 このプラグインは、GritQLで書かれたパターンを含む.gritファイルを利用して動作します。GritQL自体は、構文木を検索および変換するために設計された特殊なクエリ言語です。これらの.gritファイルは、Biomeがコードベースに適用できるカスタム診断ルールを定義するために使用されます。設定は簡単で、開発者はbiome.json設定ファイルのplugins配列に.gritファイルのパスを追加することでプラグインを有効にします。 Biome 2.0ベータの時点では、GritQLプラグインは現在診断専用です。これは、特定のコードパターンを識別し報告することには優れていますが、それらを自動的に修正する機能はまだ提供していません。しかし、GritQLのリライト演算子（=>）を活用する修正可能なルールの実装は計画されている機能であり、より包括的な機能に向けた開発が進行中であることを示しています。 ast-grep ast-grepは、高性能なRustプログラミング言語上に構築された、成熟した堅牢なコマンドラインツールです。その操作メカニズムは、YAMLファイルを使用してコードの検索、Lint、および書き換えのためのルールを定義することを含みます。ast-grepは、強力なパースライブラリであるtree-sitterを活用して抽象構文木を構築し、深いコード理解を可能にします。 ast-grepの大きな利点は、包括的な機能セットであり、完全な修正および書き換え機能が最初から提供されていることです。これにより、単純なLintの自動修正から複雑な大規模なリファクタリングまで、自動化されたコード変更のための多用途なツールとなっています。tree-sitterへの依存は、JavaScript、TypeScript、JSX、TSX、HTML、CSSだけでなく、Python、Java、Go、Rustなど、幅広いプログラミング言語をサポートしており、真に多言語対応のツールです。 BiomeのGritQLプラグインは、主にカスタム診断のためにBiomeの既存のリンターを拡張しますが、ast-grepは、堅牢な書き換え機能を含む、より広範なスコープを持つ基盤的で多用途なAST操作ツールです。 直接比較: 詳細な比較 両方のツールの簡単な紹介を終えたところで、それらを並べて、開発者にとって重要な主要な側面での違いを探ってみましょう。 Disclaimer: 記事の執筆者はast-grepの著者でもあります。 構文対決: ルールはどのように書かれるか ルールを記述する方法を理解することは、ASTベースのツールを使用する上で不可欠です。BiomeのGritQLプラグインとast-grepの両方で同等の例を調べて、そのパターン言語とルール定義のアプローチを比較しましょう。 例1: console.log()文の検出 ここでの目標は、console.log(...)が使用されているすべてのインスタンスを見つけることで、通常はデバッグステートメントを特定するためです。 Biome GritQLプラグイン (detect-console-log.grit): より詳細なセットアップ手順については、Isco氏の記事を参照してください。