pytest-iam

pytest-iam spawns a lightweight OAuth2 / OpenID Server (OIDC) / SCIM in a thread to be used in your test suite. The machinery involves Canaille and Authlib.

Installation

uv add pytest-iam

Usage

pytest-iam provides tools to test your application authentication mechanism against a OAuth2/OIDC server, with SCIM support:

It launches a Canaille instance on a random port;
It provides a iam_server fixture that comes with several features:
- the URL of the IAM server to configure your application
- IAM models (Users, groups, clients, tokens etc.) to prepare your tests and check the side effects. More details on the reference
- utilities to log-in users and give their consent to your application
- utilities to generate random users and groups

To run a full authentication process for a client application in your test, you can write something like this:

def test_authentication(iam_server, test_client):
    # create a random user on the IAM server
    user = iam_server.random_user()

    # log the user in and make it consent all the clients
    iam_server.login(user)
    iam_server.consent(user)

    # 1. attempt to access a protected page, returns a redirection to the IAM
    res = test_client.get("/protected")

    # 2. authorization code request
    res = iam_server.test_client.get(res.location)

    # 3. load your application authorization endpoint
    res = test_client.get(res.location)

    # 4. now you have access to the protected page
    res = test_client.get("/protected")

    assert "Hello, world!" in res.text

Check the client application or resource server tutorials for more usecases.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest_iam-0.2.4.tar.gz (76.8 kB view details)

Uploaded Jul 25, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pytest_iam-0.2.4-py3-none-any.whl (5.7 kB view details)

Uploaded Jul 25, 2025 Python 3

File details

Details for the file pytest_iam-0.2.4.tar.gz.

File metadata

Download URL: pytest_iam-0.2.4.tar.gz
Upload date: Jul 25, 2025
Size: 76.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pytest_iam-0.2.4.tar.gz
Algorithm	Hash digest
SHA256	`03541f9eb98d4fba639b3bbd78bd388de2521740be878ff19d024451379df0b0`
MD5	`d6943ca8577a3bc27b27ee5e587d447c`
BLAKE2b-256	`ad09527a39882841883ea5e4893460f7aaf07834597cf96487df2bd065eb0281`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytest_iam-0.2.4.tar.gz:

Publisher: release.yml on pytest-dev/pytest-iam

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pytest_iam-0.2.4.tar.gz
- Subject digest: 03541f9eb98d4fba639b3bbd78bd388de2521740be878ff19d024451379df0b0
- Sigstore transparency entry: 311761480
- Sigstore integration time: Jul 25, 2025
Source repository:
- Permalink: pytest-dev/pytest-iam@806084e190092cc22db62c6ed9dd5d29c244cdaf
- Branch / Tag: refs/tags/0.2.4
- Owner: https://github.com/pytest-dev
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@806084e190092cc22db62c6ed9dd5d29c244cdaf
- Trigger Event: push