このドキュメントでは、Rust 用 Cloud クライアント ライブラリで列挙型(enum)を使用する方法について説明します。これには、ライブラリのリリース後に導入された列挙型の値の処理も含まれます。
背景
Google Cloud サービスでは、個別の限定された値セットを受け入れるか、提供するフィールドに列挙型を使用します。許可される値はいつでも確認できますが、サービスは時間の経過とともに新しい値を追加できます。
Rust 用の Cloud クライアント ライブラリは、ライブラリのリリース後に導入された値を含む列挙値を送受信できます。
始める前に
このドキュメントの例はローカルで実行され、 Google Cloudサービスを呼び出さないため、 Google Cloud プロジェクトやアカウントは必要ありません。この例では Secret Manager クライアント ライブラリを使用していますが、同じ原則が他のクライアント ライブラリの列挙型にも適用されます。
依存関係
Secret Manager クライアント ライブラリとサポート クレートを Cargo.toml ファイルに追加します。
cargo add google-cloud-secretmanager-v1 serde_json anyhow
既知の値を処理する
既知の値を扱う場合は、列挙型バリアントを直接作成するか、整数または文字列の表現から変換できます。
不明な値を処理する
列挙型が認識されない文字列値を受け取ると、.value() は None を返しますが、.name() と JSON シリアル化は引き続き想定どおりに機能します。
不明な整数値の場合、JSON シリアル化も想定どおりに機能し、.value() は整数を返し、.name() は None を返します。
アップグレードの準備
Rust 用 Cloud クライアント ライブラリの列挙型は、今後のリリースで新しいバリアントが追加される可能性があります。サービスが新しいバリアントを追加したときにアプリケーションが破損しないように、ライブラリは生成された列挙型を #[non_exhaustive] としてマークします。
State 列挙型がスコープにインポートされているとします。
すべてを網羅していない列挙型に対して match 式を記述する場合は、ワイルドカード パターン(_)を含めて、サービスが新しいバリアントを追加したときに下位互換性を維持します。
新しいバリアントが表示されたときに linter 警告を表示して、match アームを確認して更新できるようにするには、wildcard_enum_match_arm Clippy lint を有効にします。
不安定な non_exhaustive_omitted_patterns lint を検討することもできます。