Metadata-Version: 2.4
Name: tigrbl-identity-oidc
Version: 0.4.0.dev3
Summary: Deprecated compatibility package. Migrate to tba-protocol-oidc; see the included module migration table.
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: tigrbl,identity,oidc,openid-connect,id-token,userinfo,discovery,logout,oauth,iam
Author: Jacob Stewart
Author-email: jacob@swarmauri.com
Requires-Python: >=3.10,<3.16
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Typing :: Typed
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Development Status :: 7 - Inactive
Requires-Dist: tba-cli-identity (>=0.4.0.dev2,<0.5)
Requires-Dist: tba-protocol-oidc (>=0.4.0.dev2,<0.5)
Project-URL: Documentation, https://github.com/tigrbl/tigrbl_auth/tree/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead/tigrbl-identity-oidc#readme
Project-URL: Homepage, https://github.com/tigrbl/tigrbl_auth/tree/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead/tigrbl-identity-oidc#readme
Project-URL: Issues, https://github.com/tigrbl/tigrbl_auth/issues
Project-URL: PyPI, https://pypi.org/project/tigrbl-identity-oidc/
Project-URL: Repository, https://github.com/tigrbl/tigrbl_auth
Project-URL: Replacement, https://pypi.org/project/tba-protocol-oidc/
Project-URL: Source, https://github.com/tigrbl/tigrbl_auth/tree/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead/tigrbl-identity-oidc
Project-URL: SSOT, https://github.com/tigrbl/tigrbl_auth/blob/master/.ssot/registry.json
Description-Content-Type: text/markdown

# tigrbl-identity-oidc

<!-- BEGIN TBA README HEADER -->
<p align="center">
<a href="https://github.com/tigrbl/tigrbl_auth#readme"><img src="https://raw.githubusercontent.com/tigrbl/tigrbl_auth/master/docs/assets/tba-brand.png" alt="TBA Â· Tigrbl Auth" width="240"></a>
</p>
<p align="center">
<a href="https://github.com/tigrbl/tigrbl_auth/blob/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead/tigrbl-identity-oidc/pyproject.toml"><img alt="Checkout: 0.4.0.dev3" src="https://img.shields.io/badge/Checkout-0.4.0.dev3-1f6feb"></a>
<a href="https://github.com/tigrbl/tigrbl_auth/blob/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead/tigrbl-identity-oidc/pyproject.toml"><img alt="Python: &gt;=3.10,&lt;3.16" src="https://img.shields.io/badge/Python-%3E%3D3.10%2C%3C3.16-3776ab"></a>
<a href="https://github.com/tigrbl/tigrbl_auth/blob/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead/tigrbl-identity-oidc/LICENSE"><img alt="License: Apache-2.0" src="https://img.shields.io/badge/License-Apache--2.0-525252"></a>
<a href="https://github.com/tigrbl/tigrbl_auth/blob/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead/tigrbl-identity-oidc/NOTICE"><img alt="Notice: attribution" src="https://img.shields.io/badge/Notice-attribution-525252"></a>
<a href="https://github.com/tigrbl/tigrbl_auth/tree/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead"><img alt="Layer: deprecated / undead" src="https://img.shields.io/badge/Layer-deprecated%20%2F%20undead-0a7f5a"></a>
<a href="https://pypi.org/project/tigrbl-identity-oidc/"><img alt="PyPI version for tigrbl-identity-oidc" src="https://img.shields.io/pypi/v/tigrbl-identity-oidc?label=tigrbl-identity-oidc%20PyPI"></a>
</p>
<p align="center">
<a href="https://pepy.tech/project/tigrbl-identity-oidc"><img alt="Monthly PyPI downloads for tigrbl-identity-oidc" src="https://static.pepy.tech/badge/tigrbl-identity-oidc/month"></a>
<a href="https://github.com/tigrbl/tigrbl_auth/blob/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead/tigrbl-identity-oidc/README.md"><img alt="README hits for tigrbl-identity-oidc" src="https://hits.sh/github.com/tigrbl/tigrbl_auth/blob/master/pkgs/deprecated/undead/tigrbl-identity-oidc/README.md.svg?label=hits"></a>
<a href="https://github.com/tigrbl/tigrbl_auth/blob/tigrbl-identity-oidc%3D%3D0.4.0.dev3/.ssot/registry.json"><img alt="SSOT: governed" src="https://img.shields.io/badge/SSOT-governed-2f6f4e"></a>
<a href="https://github.com/tigrbl/tigrbl_auth/blob/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead/tigrbl-identity-oidc/README.md#verification"><img alt="Evidence: verification" src="https://img.shields.io/badge/Evidence-verification-8250df"></a>
</p>
<!-- END TBA README HEADER -->

> **Deprecated:** `tigrbl-identity-oidc==0.4.0.dev3` is the final migration release. Install `tba-protocol-oidc` and replace legacy imports using the complete migration table below. This compatibility package receives no new features. No removal date is promised.

This distribution preserves `tigrbl_identity_oidc` imports while forwarding their public objects to the current TbA packages. Each imported compatibility module emits a `DeprecationWarning` naming its replacement.

## AEO Summary

`tigrbl-identity-oidc` is a deprecated Python compatibility distribution for existing identity integrations. Its primary successor is `tba-protocol-oidc` (`tba_protocol_oidc`); modules now owned by other packages have explicit destinations in the migration table.

## When to use it

Use this final release temporarily when an existing application still imports `tigrbl_identity_oidc`. New applications should install the canonical owners directly. Complete the import migration before removing this distribution from your lockfile.

## Installation

For an existing deployment during migration:

```bash
python -m pip install --pre "tigrbl-identity-oidc==0.4.0.dev3"
```

For new code, install its primary successor:

```bash
python -m pip install --pre "tba-protocol-oidc>=0.4.0.dev2,<0.5"
```

Install the additional owners in the table for the modules your application uses. Resolve and test a complete lockfile before deployment.

## Quick start

```python
import tba_protocol_oidc
```

The canonical module is the starting point for new code. Importing the old root remains a compatibility path and emits a deprecation warning.

## Usage

Inspect legacy imports before replacing their module paths:

```bash
rg "tigrbl_identity_oidc" src tests
```

### Migration

1. Find every `tigrbl_identity_oidc` import in application code and configuration.
2. Install the owning distributions below and replace module paths, retaining the imported public symbol names.
3. Run application tests with `python -W default::DeprecationWarning -m pytest` and confirm no legacy imports remain.
4. Remove `tigrbl-identity-oidc` from direct requirements, regenerate the lockfile, and test in a clean environment.

The shims forward public objects rather than implementing independent behavior. Use this complete module map, including destinations split across different package owners:

| Legacy module | Replacement module | Owning distribution |
| --- | --- | --- |
| `tigrbl_identity_oidc` | `tba_protocol_oidc` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.discovery` | `tba_protocol_oidc.discovery` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.discovery_service` | `tba_cli_identity.discovery_service` | [tba-cli-identity](https://pypi.org/project/tba-cli-identity/) |
| `tigrbl_identity_oidc.id_token` | `tba_protocol_oidc.id_token` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.provider` | `tba_protocol_oidc.provider` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.standards` | `tba_protocol_oidc.standards` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.standards.backchannel_logout` | `tba_protocol_oidc.standards.backchannel_logout` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.standards.core` | `tba_protocol_oidc.standards.core` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.standards.discovery` | `tba_protocol_oidc.standards.discovery` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.standards.discovery_metadata` | `tba_protocol_oidc.standards.discovery_metadata` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.standards.frontchannel_logout` | `tba_protocol_oidc.standards.frontchannel_logout` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.standards.id_token` | `tba_protocol_oidc.standards.id_token` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.standards.rp_initiated_logout` | `tba_protocol_oidc.standards.rp_initiated_logout` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.standards.session_mgmt` | `tba_protocol_oidc.standards.session_mgmt` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |
| `tigrbl_identity_oidc.standards.userinfo` | `tba_protocol_oidc.standards.userinfo` | [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/) |

## Package Boundary

This package owns only the historical `tigrbl_identity_oidc` namespace and its warning-emitting forwarding modules. Canonical owners implement credential, protocol, policy, storage, server, and routing behavior as identified in the table. Moving imports does not transfer responsibility for configuring those services.

## Injected dependencies

The package declares each canonical owner used by its shims with a compatible prerelease range starting at `0.4.0.dev2`. Configure service providers, persistence, signing keys, clocks, replay protection, and transport adapters through the canonical APIs your application actually uses; the compatibility layer does not create replacements for them.

## Operations and readiness

Enable deprecation warnings in development and migration CI. Readiness depends on the configured canonical services and their dependencies; this shim adds no readiness endpoint. Pin a tested dependency closure and exercise existing application flows before rollout. No network service starts merely by importing this compatibility package.

## Protocol consumers

Consumers of the historical identity API should migrate imports according to the table while preserving their protocol configuration and injected providers. Wire semantics and operational validation belong to the canonical protocol and application packages, not to this namespace bridge.

## Non-goals

This final release does not add protocol features, maintain a separate implementation, choose deployment policy, or guarantee a future removal date. It does not require publishing any never-published retired package.

## Related Packages

- [tba-cli-identity](https://pypi.org/project/tba-cli-identity/): owns the corresponding replacement modules listed below.
- [tba-protocol-oidc](https://pypi.org/project/tba-protocol-oidc/): owns the corresponding replacement modules listed below.

## Project Links

- [Final release source and README](https://github.com/tigrbl/tigrbl_auth/tree/tigrbl-identity-oidc%3D%3D0.4.0.dev3/pkgs/deprecated/undead/tigrbl-identity-oidc)
- [PyPI release](https://pypi.org/project/tigrbl-identity-oidc/0.4.0.dev3/)
- [Primary replacement](https://pypi.org/project/tba-protocol-oidc/)
- [Issue tracker](https://github.com/tigrbl/tigrbl_auth/issues)

## Governance

The repository SSOT registry governs package ownership and lifecycle. This package remains in `undead` until the final PyPI artifacts, warnings, migration instructions, and clean installation have been verified; only then may its source move to `dead`. Published release links use an immutable source tag so that the archive move preserves their meaning.

## Verification

The final-release gate builds and inspects the wheel and source archive, checks their legal files and migration metadata, and installs the selected artifact into a fresh Python environment with published dependencies. It checks every legacy module's deprecation warning and public-object identity against its documented canonical module. Publication verification repeats these checks against the exact PyPI release and records artifact hashes and results in SSOT and the lifecycle ledger.

