Merge v5 branch into master – Auth0 Python SDK v5.0.0 (#768)

This pull request merges the `v5` branch into `master`, introducing
**version 5.0.0** of the Auth0 Python SDK. This marks a **major,
breaking rewrite** of the SDK, fully generated from Auth0's OpenAPI
specifications using Fern.
The Management API code is now **auto-generated**, featuring a new
hierarchical package structure, improved type safety with Pydantic
models, and updated usage patterns. The Authentication API remains
manually maintained and is **not affected** by these changes.
Additionally, documentation, workflows, and contribution guidelines have
been updated to align with the new structure.
---
## Major Breaking Changes and Improvements
### SDK Rewrite and Breaking Changes
- Complete rewrite of the **Management SDK**, generated from OpenAPI
specs using Fern, introducing: - Hierarchical package structure with
improved organization
- Strongly typed interfaces using Pydantic models
- Automatic token management with client credentials
- Improved pagination with `SyncPager` and `AsyncPager`
- Enhanced error handling with structured exceptions
- All Management API usage patterns have changed, including **client
initialization** and **method signatures**. Refer to the [v5 Migration
Guide](v5_MIGRATION_GUIDE.md) for detailed upgrade steps.

- **Package structure** has changed from dictionary-based responses to
Pydantic models. All imports and response handling must be updated.
- Only the **Authentication API** is manually maintained. Contribution
and code generation instructions have been updated accordingly.
### Documentation and Examples
- `README.md` and badges updated for v5
- Installation instructions revised; new usage examples provided for
both Authentication and Management APIs
- Clarified Python version requirement: **Python 3.8+** (Python 3.7
support dropped)
- Contribution guidelines updated to reflect the new code generation
process and testing instructions
### Build, Linting, and Workflows
- CI workflows updated to use the `master` branch (will be finalized in
this PR)
- v5-specific workflow files (`v5-ci.yml`, `v5-publish.yml`) to be
removed or consolidated
- Linting configuration adjusted for the new structure
- Poetry and dependency management updated
### Changelog
- Added detailed changelog entries describing the rewrite, breaking
changes, migration steps, and beta release notice
---
Please review the [v5 Migration Guide](v5_MIGRATION_GUIDE.md) and
updated documentation to transition your codebase to the new SDK
structure.
---
**Note:** The `v4` branch has been preserved at the pre-v5 state for
reference and potential maintenance releases.

---------

Signed-off-by: Snehil Kishore <snehil.kishore@okta.com>

Author: kishore7snehil

.fern/metadata.json

@@ -0,0 +1,15 @@
+{
+  "cliVersion": "3.24.3",
+  "generatorName": "fernapi/fern-python-sdk",
+  "generatorVersion": "4.46.2",
+  "generatorConfig": {
+    "client": {
+      "class_name": "Auth0"
+    },
+    "package_path": "management",
+    "enable_wire_tests": true,
+    "pydantic_config": {
+      "use_provided_defaults": true
+    }
+  }
+}

.fernignore

@@ -0,0 +1,27 @@
+# Specify files that shouldn't be modified by Fern
+
+# ManagementClient wrapper
+src/auth0/management/management_client.py
+src/auth0/management/token_provider.py
+tests/management/
+
+# Documentation
+v5_MIGRATION_GUIDE.md
+CHANGELOG.md
+
+# Authentication API (copied from auth0-python, not Fern-generated)
+src/auth0/authentication/
+tests/authentication/
+
+# Root auth0 __init__.pys
+src/auth0/__init__.py
+src/auth0/management/__init__.py
+
+# Files edited to incorporate both APIs
+pyproject.toml
+poetry.lock
+requirements.txt
+README.md
+.gitignore
+.github/workflows/ci.yml
+.version

.flake8

@@ -27,6 +27,7 @@ bin/
 .pypirc
 pyvenv.cfg
 .python-version
+poetry.toml
 
 # Installer logs
 pip-log.txt
@@ -42,7 +43,11 @@ nosetests.xml
 coverage.xml
 *,cover
 .hypothesis/
-.pytest_cache
+.pytest_cache/
+.mypy_cache/
+
+# Linting
+.ruff_cache/
 
 # Translations
 *.mo
@@ -51,12 +56,10 @@ coverage.xml
 # Sphinx documentation
 docs/build/
 
-# IDEA
+# IDEs
 .idea/
 *.iml
-
-# VSCode
 .vscode/
 
 # OS-specific files
-.DS_Store
+.DS_Store

.github/workflows/v5-ci.yml

@@ -1 +1 @@
-4.13.0
+5.0.0b0

.github/workflows/v5-publish.yml

@@ -1,5 +1,44 @@
 # Change Log
 
+## [5.0.0b0](https://github.com/auth0/auth0-python/tree/5.0.0b0) (2025-12-18)
+[Full Changelog](https://github.com/auth0/auth0-python/compare/4.13.0...5.0.0b0)
+
+⚠️ **BETA RELEASE** - This is a beta release with significant breaking changes. Please test thoroughly before upgrading production systems.
+
+**Breaking Changes**
+
+- **Complete rewrite of Management API client** - Generated from Auth0's OpenAPI specifications using [Fern](https://buildwithfern.com)
+- **Python 3.7 support dropped** - Minimum required version is now Python 3.8
+- **Management API client restructured** - Methods organized into modular sub-clients for better discoverability
+- **Method signatures changed** - Consistent and predictable naming conventions across all endpoints
+- **Response types changed** - Strongly-typed Pydantic models replace generic dictionaries
+- **Import paths changed** - `from auth0.management.core.api_error import ApiError` instead of `from auth0.exceptions import Auth0Error`
+- **Pagination defaults changed** - `include_totals=True` is now the default for list operations
+- **Client initialization simplified** - `ManagementClient` takes `domain` instead of full `base_url`
+
+**Added**
+
+- First-class async support with `AsyncAuth0` and `AsyncManagementClient`
+- Automatic token management with client credentials in `ManagementClient`
+- Built-in pagination support with `include_totals=True` by default
+- Type-safe request/response objects using Pydantic models
+- Better IntelliSense and code completion support
+- Comprehensive API reference documentation
+- Migration guide for upgrading from v4.x
+
+**Changed**
+
+- Management API client fully regenerated using Fern
+- Package structure reorganized with hierarchical sub-clients
+- Error handling updated to use `ApiError` base class
+- Documentation updated with v5 examples
+
+**Note**
+
+- Authentication API remains **fully backward compatible** - no changes required
+- See [v5_MIGRATION_GUIDE.md](https://github.com/auth0/auth0-python/blob/v5/v5_MIGRATION_GUIDE.md) for detailed upgrade instructions
+
+
 ## [4.13.0](https://github.com/auth0/auth0-python/tree/4.13.0) (2025-09-17)
 [Full Changelog](https://github.com/auth0/auth0-python/compare/4.12.0...4.13.0)