philiprehberger-jwt-lite 0.2.0

Minimal JWT creation and validation with zero dependencies.

philiprehberger-jwt-lite

Minimal JWT creation and validation with zero dependencies.

Installation

pip install philiprehberger-jwt-lite

Usage

from philiprehberger_jwt_lite import create_token, verify_token

token = create_token({"sub": "user123"}, "my-secret")
payload = verify_token(token, "my-secret")

Token Expiration

from philiprehberger_jwt_lite import create_token, verify_token, ExpiredTokenError

token = create_token({"sub": "user123"}, "my-secret", expires_in=3600)

try:
    payload = verify_token(token, "my-secret")
except ExpiredTokenError:
    print("Token has expired")

Custom Algorithm

from philiprehberger_jwt_lite import create_token, verify_token

token = create_token({"sub": "user123"}, "my-secret", algorithm="HS512")
payload = verify_token(token, "my-secret", algorithm="HS512")

Custom Claims Validation

from philiprehberger_jwt_lite import create_token, verify_token

token = create_token({"sub": "user123", "role": "admin"}, "my-secret")

payload = verify_token(
    token,
    "my-secret",
    validators={"role": lambda r: r == "admin"},
)

Token Refresh

from philiprehberger_jwt_lite import create_token, refresh_token

token = create_token({"sub": "user123"}, "my-secret", expires_in=3600)
new_token = refresh_token(token, "my-secret", extends_by=7200)

Decode Without Verification

from philiprehberger_jwt_lite import decode_token

payload = decode_token(token)

API

Function / Class	Description
create_token(payload, secret, algorithm, expires_in)	Create a signed JWT token
verify_token(token, secret, algorithm, validators)	Verify signature and expiration, run custom claim validators, return payload
refresh_token(token, secret, extends_by, algorithm)	Verify and re-sign a token with a new expiration
decode_token(token)	Decode payload without signature verification
ExpiredTokenError	Raised when a token's exp claim is in the past
InvalidTokenError	Raised when a token is malformed or signature is invalid

Development

pip install -e .
python -m pytest tests/ -v

Support

If you find this package useful, consider starring the repository.

License

MIT