Show HN: Pure Effect – DBなしでラップトップ上で本番環境のバグを再現
Show HN: Pure Effect – Reproduce production bugs on your laptop without a DB (pure-effect.org)
要約
Pure Effectは、TypeScript/JavaScript向けの小さなエフェクトライブラリで、I/O操作をビジネスロジックから分離し、その説明を返すことで、本番環境のバグのデバッグとテストを劇的に改善します。これにより、ビジネスロジックは純粋な関数となり、モックなしでテストでき、完全な実行トレースを無料で提供し、AI生成コードの安全なレビューを可能にするなど、多くの利点をもたらします。わずか1KB未満、依存関係ゼロで、既存のコードに簡単に組み込めるパターンとして利用できます。
全文翻訳
Hi HN,
開発者の大半が、I/O処理をビジネスロジックに絡めてコードを書くことに何の疑問も抱いていないというのは、安全に言えることだと思います。例えば、次のようなコードは非常に一般的です。
const user = findUser(email);
if (!user) await saveUser(user);
さて、これの何が問題なのか、とあなたは尋ねるかもしれません。このようなコードを書くと、二つのことが起こります。
- 本番環境のバグのデバッグが困難になります。全く同じデータベースやリモートAPIサービスに接続しない限り、バグを再現できない可能性があります。
- テストではモックやフェイクを使用するか、テストコンテナを使用する必要がありますが、これらは効果が限定的で、しかも遅いです。
これらの問題を解決するために、私はPure Effectという、ごく小さなTypeScript/JavaScriptのエフェクトライブラリを開発しました。その中心的なアイデアはシンプルです。もし関数がI/Oを実行する場合、それは純粋ではありません。しかし、もしそれが実行したいI/Oの記述を返すのであれば、それは純粋です。したがって、await findUser(email)の代わりに、Commandオブジェクトを返します。これは、「この関数を呼び出したい。それが完了したら、次にこれを実行する」という内容です。あなたのビジネスロジックは純粋関数になります。常に同じ入力に対して、常に同じ出力が得られます。データベースは、インタープリタ(runEffect)が実行されるまで一切触れられません。
このライブラリを最初に始めたとき、この一つのアイデアがどれほど広範囲に適用できるか予想していませんでした。パイプラインが単なるデータになれば、多くの素晴らしいことが可能になります。
- モックライブラリは不要になります。テストではツリーをウォークし、その構造をアサートします:
assert.equal(flow.cmd.name, 'cmdFindUser')。何も実行されません。 - 任意の効果を
Retry(effect, { attempts: 3, delay: 200, backoff: 2 })でラップできます。設定はプレーンなデータなので、テストでアサートできます。 - 各コマンドの入出力はインタープリタを流れるため、完全な実行トレースが無料で得られます。簡単な
timeTravel()関数を書いて、I/Oに一切触れることなくローカルで再生できます。複雑な本番環境のバグのデバッグに最適です。 onBeforeCommandフックが、ビジネスロジックとインタープリタの間に配置されます。これは、意図された全てのサイドエフェクトが実行される前にそれを確認するため、実行時のガードレールを強制するために使用できます。例えば、破壊的な呼び出しが発生する前に隔離することができます。- AIによって生成されたコードを実行前にレビューできます。Pure Effectのパイプラインはプレーンなデータなので、生成されたコードが何かに触れる前に、それが意図していることを検査できます。
Success, Failure, Command, Ask, Retry, Parallelの6つのプリミティブと、effectPipe、runEffectがあります。依存関係はゼロです。最小化・gzip圧縮で1KB未満です。
Effect-TSとの比較
Effect-TSはこの分野のフル機能の選択肢であり、大きなエコシステムを持っています。Pure Effectは異なるトレードオフを提供します。それは80%のケースをカバーします:テスト可能なパイプライン、依存性注入、リトライ、OpenTelemetryフックなど、すべて1KB未満で、依存関係ゼロ、新しい語彙を学ぶ必要もありません。Effect-TSは、あなたが周囲に構築するフレームワークです。一方、Pure Effectは、既存のコードにドロップインできるパターンです。
私は12月から本番環境でPure Effectを使用しています。バージョンはv0.8.0で、まだ1.0ではありませんが、十分安定しているので、皆さんの意見を聞きたくて公開しました。
GitHub: https://github.com/aycangulez/pure-effect
Pure Effectの進化について、5つの記事を書きました。より詳しい話を聞きたい場合は、https://lackofimagination.org/tags/effect/でタグ付けされています。