Skip to content

feat(auth): graduate the Auth utility from auth_alpha to auth - #8818

Merged
leandrodamascena merged 2 commits into
developfrom
feat/auth-ga
Nov 15, 2026
Merged

leandrodamascena merged 2 commits into
developfrom
feat/auth-ga

Conversation

@leandrodamascena

@leandrodamascena leandrodamascena commented Nov 15, 2026 •

Copy link
Copy Markdown
Contributor

Issue number:
closes #8816

Summary

Changes

Auth leaves alpha. The package moves from aws_lambda_powertools.utilities.auth_alpha to aws_lambda_powertools.utilities.auth with the same public surface: JWTVerifier, OAuth2Client, AuthErrorContext, AuthFailureReason, the exceptions, the integrations and jwt.testing. No behaviour change in any of them.

  • The auth_alpha namespace is removed, no alias. It shipped with an alpha label that said the API could change before GA, and keeping a compatibility path would only let people stay on the wrong import. An old import fails with ModuleNotFoundError; the fix is changing one line.
  • Docs: Auth (alpha) and OAuth2 client (alpha) lose the alpha title and the warning, plus a short note for people coming from auth_alpha. Examples move to examples/auth/, the API reference page to api_doc/auth.md, the nox sessions and tests follow the rename.
  • The jwt extra is unchanged.

User experience

New code imports from aws_lambda_powertools.utilities.auth. Code on auth_alpha stops importing and the docs say what to change. This is the one deliberate exception to our compatibility policy, allowed by the alpha label.

Verification

  • tests/functional/auth: 502 passed, including the import probe that checks lazy loading of pyjwt, cryptography and urllib3.
  • nox test_with_auth_required_packages (jwt extra only): 300 passed. nox test_with_oauth2_required_packages: 202 passed.
  • ruff, mypy clean. Every --8<-- snippet path in the two docs pages resolves. The old import path fails with ModuleNotFoundError in a clean interpreter. Agent skill reference regenerated. Written with an AI assistant; I ran everything above myself.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@leandrodamascena
leandrodamascena requested a review from a team as a code owner November 15, 2026 14:07
@leandrodamascena leandrodamascena added this to the 3.41.0 milestone Nov 15, 2026
@leandrodamascena leandrodamascena added feature New feature or functionality internal Maintenance changes labels Nov 15, 2026
@boring-cyborg boring-cyborg Bot added documentation Improvements or additions to documentation tests labels Nov 15, 2026
@powertools-for-aws-oss-automation powertools-for-aws-oss-automation Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Nov 15, 2026
@sonarqubecloud

Copy link
Copy Markdown

@codecov

codecov Bot commented Nov 15, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.17%. Comparing base (ca74726) to head (a79ef74).

Additional details and impacted files
@@           Coverage Diff            @@
##           develop    #8818   +/-   ##
========================================
  Coverage    97.17%   97.17%           
========================================
  Files          323      323           
  Lines        16629    16629           
  Branches      1510     1510           
========================================
  Hits         16160    16160           
  Misses         328      328           
  Partials       141      141           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@leandrodamascena
leandrodamascena merged commit 085707f into develop Nov 15, 2026
15 checks passed
@leandrodamascena
leandrodamascena deleted the feat/auth-ga branch November 15, 2026 14:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation feature New feature or functionality internal Maintenance changes size/L Denotes a PR that changes 100-499 lines, ignoring generated files. tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Maintenance: graduate the Auth utility from auth_alpha to auth

1 participant