Skip to content

docs: extract AES-GCM importRawKey example - #394

Open
agustinpabon wants to merge 1 commit into
google:masterfrom
agustinpabon:docs/aes-gcm-import-raw-key-example-283
Open

agustinpabon wants to merge 1 commit into
google:masterfrom
agustinpabon:docs/aes-gcm-import-raw-key-example-283

Conversation

@agustinpabon

Copy link
Copy Markdown

Summary

Extract the existing AesGcmSecretKey.importRawKey example into
example/webcrypto/aes_gcm/import_raw_key.dart and reference its
example region from the API documentation.

This makes the example available to formatting, analysis, and execution
tools while preserving its behavior and leaving the library
implementation unchanged.

Part of #283.

The new file follows the existing example structure, including the
license header and region markers. A file-local avoid_print
suppression preserves the example's demonstrated output.

Validation

Recorded locally on Windows x64 with Dart 3.13.3:

  • Formatting checks passed for the changed Dart files.
  • Full-package analysis completed without diagnostics.
  • Native execution of the extracted example printed hello world.
  • The focused AES-GCM test selection passed all 82 tests.
  • The method's rendered description HTML was unchanged before and after extraction: no documentation errors and the same seven pre-existing warnings as the baseline.
  • Extraction comparison confirmed that the example code was preserved.

The full platform matrix was not run.

AI assistance

OpenAI Codex assisted with extraction and validation. The contributor
personally reviewed the diff and generated API documentation before
submission.

@google-cla

google-cla Bot commented Sep 8, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants