dotenvy を dotenv-ng にフォークします
We Are Forking dotenvy into dotenv-ng (secretspec.dev)
要約
SecretSpecチームは、環境変数ローディングライブラリであるdotenvyのフォークとして、Rustで書かれたdotenv-ngをリリースしました。dotenvyが.envファイルを読み込む際に、秘密鍵の一部を環境変数として誤解釈するバグを発見したことがきっかけです。dotenv-ngは、この問題に対処し、より堅牢で安全な.envファイル解析とレンダリング機能を提供します。
全文翻訳
dotenvyをdotenv-ngにフォークします
2026年8月15日
私たちは、.envファイルを読み込みレンダリングするためのモダンなRust実装であるdotenv-ng 1.0をリリースしました。これは、パーサーが値を読み取る際に秘密情報を変更してしまう問題が発生したため、dotenvyのフォークとして始まりました。
これは矛盾しているように聞こえるかもしれません。SecretSpecは依然として環境変数をシークレットインターフェースとして排除するという使命を遂行しており、また.envがどこで間違ったかについても記述してきました。.envは秘密情報の最終的な保管場所であるべきではありません。
しかし、.envからの移行は、それを正しく読み取ることから始まります。
なぜdotenvyをフォークしたのか?
「なぜdotenvyをフォークしたのか?」というタイトルのセクション
直接的な失敗は、SecretSpec issue #73でした。dotenvファイルにはbcryptフラグメントを含む値が含まれていました。
TEST="foo:$2a$10$TWoviNHS27HJMw1PKe4tBeIMlms6tWdYS9hKoHANKCQhluDlEt/gu"
ファイル自体は無傷でした。dotenvプロバイダー経由で読み取ったところ、dotenvyがドル記号で始まるフラグメントを変数置換として扱ったため、異なる値が返されました。この失敗は、パースエラーではなく、後になって認証エラーとして現れました。
置換機能を設定可能にするためのアップストリームへのリクエストは、2024年からオープンされていました。2026年にはプルリクエストが登場しましたが、リリースされていないAPIを対象としていました。移行ツールは、ユーザーに秘密情報内のパーサー構文を認識させ、エスケープさせることを要求できません。
メンテナンスのギャップ
オリジナルのRust dotenvクレートは2020年にリリースを停止し、最終的にRustSecによってメンテナンスされていないとマークされました。RustSecはdotenvyを代替として挙げていました。
Dotenvyの説明では、依然として「よくメンテナンスされているフォーク」と呼んでいます。その最新の公開バージョンである0.15.7は、2023年3月22日にリリースされました。Rustフォーラムの議論では、2025年に2年間のリリースギャップが指摘されていました。bcryptバグがSecretSpecをブロックした時点では、3年以上経過していました。
メンテナンスされているフォークが、そのアップストリームと同じリリース問題を繰り返すというのは、不快な皮肉です。そのメンテナーは私たちにリリースを提供する義務はありませんが、SecretSpecは私たちが管理できるスケジュールで、破壊的な修正を必要としていました。
dotenv-ngは何を改善したか?
「dotenv-ngは何を改善したか?」というタイトルのセクション
当初は小さなパッチを検討していました。パーサーの監査により、JSON、Windowsパス、Unicode名、優先順位、および部分的な環境ミューテーションに関するさらなる問題が明らかになりました。
したがって、dotenv-ngはdotenvy 0.15.7から開始しますが、正確性が要求される箇所では意図的に互換性を破壊しています。バージョン1.0では以下が追加されています。
- ソースを認識するパーサーと構造化されたエラー
- デフォルトでリテラルのドル記号を扱い、置換は呼び出し元が明示的に有効にした場合にのみ利用可能
- ダッシュ、先頭の数字、先頭のドット、Unicodeをサポートする、より広範なキー文法
- 値をそのままパースするために必要な引用符とエスケープのみを追加するレンダラー
- プロセス環境のミューテーション前の検証
- そのミューテーションを囲む明示的な
unsafe境界線
プロパティテストは、任意のUnicodeや構文的に複雑な値を実行し、引用符が必要な場合にのみ使用されているかを確認し、完全なドキュメントをラウンドトリップします。パーサーとレンダラーは、リライトのコアであり、どちらも100%のカバレッジを持っています。
完全な互換性とAPIの変更は、dotenv-ng 1.0 changelogに記録されています。
dotenv-ng 1.0を試す
「dotenv-ng 1.0を試す」というタイトルのセクション
パッケージはcrates.ioで利用可能です。アプリケーションは、依存関係エイリアスを使用して、おなじみのdotenvクレート名を使用し続けることができます。
[dependencies]
dotenv = { package = "dotenv-ng", version = "1" }
SecretSpec 0.20以降、dotenv-ngはSecretSpec全体でdotenvのパースとレンダリングを強化しています。