This release is a pre-release and may not be stable for production use.
Jam
Jam (Jam Auth Module) - Jam (Jam Auth Module) - A universal auth* framework that provides popular auth mechanisms strictly according to the specification.
- Documentation: jam.makridenko.com
- Changelog: CHANGELOG.md
Install
pip install jamlib
Quick example
from dataclasses import dataclass
from jam import BaseSubject, Jam
@dataclass
class User(BaseSubject):
id: int
email: str
jam = Jam(config="config.toml", subject=User)
user = User(id=1, email="user@example.com")
token = jam.issue(subject=user, via="jwt")
principal = jam.authenticate(token, via="jwt")
user = principal.subject
allowed: bool = jam.authorize(
principal=principal,
permission="post:create"
)
Why Jam?
Jam is a library that provides the most popular AUTH* mechanisms right out of the box.
Authorization
Jam combines permissions granted to one credential with server-side policy rules. This makes it possible to issue two tokens for the same user with different permissions and to restrict those permissions using the current time, resource or request.
principal = jam.authenticate(token, via="jwt")
if jam.authorize(principal, "user:delete"):
...
Framework integrations
Jam provides ready-to-use integrations for the most popular frameworks:
Each integration offers built-in middleware or plugin support for JWT and session-based authentication.
Why choose Jam?
Jam supports many authentication methods out of the box with minimal dependencies. Here is a comparison with other libraries:
| Features / Library | Jam | Authx | PyJWT | AuthLib | OTP Auth |
|---|---|---|---|---|---|
| JOSE | ✅ | ❌ only JWT | ❌ only JWT | ✅ | ❌ |
| JWT black/white lists | ✅ | ❌ | ❌ | ❌ | ❌ |
| PASETO | ✅ | ❌ | ❌ | ❌ | ❌ |
| Server side sessions | ✅ | ✅ | ❌ | ❌ | ❌ |
| OTP | ✅ | ❌ | ❌ | ❌ | ✅ |
| OAuth2 | ✅ | ✅ | ❌ | ✅ | ❌ |
| SAML 2.0 | ✅ | ❌ | ❌ | ❌ | ❌ |
| Flexible config | ✅ | ❌ | ❌ | ❌ | ❌ |
| Modularity | ✅ | ❌ | ❌ | ❌ | ❌ |
Release files for jamlib 4.2.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jamlib-4.2.0a1.tar.gz | 146.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jamlib-4.2.0a1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 353.8 kB
Release files / jamlib-4.2.0a1.tar.gz
| Download URL | jamlib-4.2.0a1.tar.gz |
|---|---|
| Size | 146.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0304b14a884e379881e179106678c2482179f3a3a546b61b1e31a516729cde99
|
|
BLAKE2b-256 checksum How to use checksums |
37df9bb33186e137d6b106d5eeef2c21419f3cab5efb2f541ddec35caf362f60
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / jamlib-4.2.0a1-py3-none-any.whl
| Download URL | jamlib-4.2.0a1-py3-none-any.whl |
|---|---|
| Size | 206.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df85c74531bb8cb981834f4b6ffa40a62d0f31fbb71a3ff59487d60433b36572
|
|
BLAKE2b-256 checksum How to use checksums |
9ef458b73d7396baf35256ba054e995a388b4ddd91647da3bf55681c2346f1be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
