jam¶

jam ¶

JAM - Universal auth* library.

Source code: https://github.com/lyaguxafrog/jam Documentation: https://jam.makridenko.ru

Modules:

Name	Description
`aio`	Async Jam package.
`cli`	CLI tool for Jam.
`encoders`
`exceptions`	All Jam exceptions
`ext`	Extensions and integrations.
`instance`
`jose`	JOSE tools.
`jwt`
`logger`
`oauth2`	OAuth2 module.
`otp`	*OTP auth module
`paseto`	PASETO auth* tokens.
`plugins`	Jam plugin system.
`sessions`	Module for making server auth sessions.
`tests`	Test clients for simplified unit and integration testing.
`utils`	Various utilities that help with authorization.

Classes:

Name	Description
`BaseJam`	Base jam instance.
`Jam`	Main instance.

BaseJam ¶

BaseJam(
    config: str | dict[str, Any] = "pyproject.toml",
    pointer: str = "jam",
    *,
    logger: type[BaseLogger] = JamLogger,
    log_level: Literal[
        "DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"
    ] = "INFO",
    serializer: BaseEncoder
    | type[BaseEncoder] = JsonEncoder,
    plugins: list[type[BasePlugin]] = [],
)

Bases: ABC

Base jam instance.

Parameters:

Name	Type	Description	Default
`config`	`Union[str, dict[str, Any]]`	Configuration	`'pyproject.toml'`
`pointer`	`str`	Pointer	`'jam'`
`logger`	`BaseLogger`	Logger	`JamLogger`
`log_level`	`Literal['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL']`	Log level	`'INFO'`
`serializer`	`Union[BaseEncoder, type[BaseBrowser]]`	Serializer	`JsonEncoder`
`plugins`	`list[type[BasePlugin]]`	List of plugins	`[]`

Returns:

Type	Description
`None`	None

Methods:

Name	Description
`emit`	Emit event.
`jwe_decrypt`	Decrypt JWE token.
`jwe_encrypt`	Encrypt data using JWE.
`jws_sign`	Sign data using JWS.
`jws_verify`	Verify JWS token.
`jwt_decode`	Verify and decode JWT token.
`jwt_encode`	Encode the JWT with the given expire, header, and payload.
`oauth2_client_credentials_flow`	Obtain access token using client credentials flow (no user interaction).
`oauth2_fetch_token`	Exchange authorization code for access token.
`oauth2_get_authorized_url`	Generate full OAuth2 authorization URL.
`oauth2_refresh_token`	Use refresh token to obtain a new access token.
`otp_code`	Generates an OTP.
`otp_uri`	Generates an otpauth:// URI for Google Authenticator.
`otp_verify_code`	Checks the OTP code, taking into account the acceptable window.
`paseto_create`	Create new PASETO.
`paseto_decode`	Decode PASETO and return payload and footer.
`paseto_make_payload`	Generate payload for PASETO.
`session_clear`	Delete all sessions by key.
`session_create`	Create new session.
`session_delete`	Delete session.
`session_get`	Get data from session.
`session_rework`	Rework session.
`session_update`	Update session data.

__build_instance ¶

__build_instance(config: dict[str, Any]) -> None

Build instance.

Load modules from configuration and initialize them. Supports both flat modules (name -> path) and nested modules (name -> {subname -> path}).

Parameters:

Name	Type	Description	Default
`config`	`dict[str, Any]`	Configuration	required

Returns:

Type	Description
`None`	None

__build_main_config ¶

__build_main_config(
    config: dict[str, Any],
    default_logger: type[BaseLogger],
    default_log_level: Literal[
        "DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"
    ],
    default_serializer: BaseEncoder | type[BaseEncoder],
) -> dict[str, Any]

Build main params from config like logger, loglevel, etc.

Parameters:

Name	Type	Description	Default
`config`	`dict[str, Any]`	Configuration dictionary	required
`default_logger`	`type[BaseLogger]`	Default logger class	required
`default_log_level`	`Literal`	Default log level	required
`default_serializer`	`BaseEncoder \| type[BaseEncoder]`	Default serializer	required

Returns:

Type	Description
`dict[str, Any]`	dict[str, Any]: Dictionary with logger, log_level, and serializer

__otp ¶

__otp(
    type: Literal["totp", "hotp"] | None = None,
) -> type[BaseOTP] | None

Get OTP type.

__setup_plugins ¶

__setup_plugins(plugins: list[type[BasePlugin]]) -> None

Setup plugins.

emit ¶

emit(event: str, **kwargs) -> Any

Emit event.

Parameters:

Name	Type	Description	Default
`event`	`str`	Event name,	required
`**kwargs`		Event data	`{}`

jwe_decrypt `abstractmethod` ¶

jwe_decrypt(token: str) -> bytes

Decrypt JWE token.

Parameters:

Name	Type	Description	Default
`token`	`str`	JWE token.	required

Returns:

Name	Type	Description
`bytes`	`bytes`	Decrypted data.

Raises:

Type	Description
`JamJWEDecryptionError`	If decryption fails.

jwe_encrypt `abstractmethod` ¶

jwe_encrypt(
    data: dict[str, Any] | str,
    header: dict[str, Any] | None = None,
) -> str

Encrypt data using JWE.

Parameters:

Name	Type	Description	Default
`data`	`dict[str, Any] \| str`	Data to encrypt. If dict, will be JSON encoded.	required
`header`	`dict[str, Any] \| None`	JWE header.	`None`

Returns:

Name	Type	Description
`str`	`str`	JWE token.

jws_sign `abstractmethod` ¶

jws_sign(
    data: dict[str, Any] | str,
    header: dict[str, Any] | None = None,
) -> str

Sign data using JWS.

Parameters:

Name	Type	Description	Default
`data`	`dict[str, Any] \| str`	Data to sign. If dict, will be JSON encoded.	required
`header`	`dict[str, Any] \| None`	JWS header.	`None`

Returns:

Name	Type	Description
`str`	`str`	JWS token.

jws_verify `abstractmethod` ¶

jws_verify(token: str) -> dict[str, Any]

Verify JWS token.

Parameters:

Name	Type	Description	Default
`token`	`str`	JWS token.	required

Returns:

Type	Description
`dict[str, Any]`	dict[str, Any]: Decoded payload.

Raises:

Type	Description
`JamJWSVerificationError`	If verification fails.

jwt_decode `abstractmethod` ¶

jwt_decode(
    token: str,
    check_exp: bool = True,
    check_list: bool = True,
    check_nbf: bool = False,
    include_headers: bool = False,
) -> dict[str, Any]

Verify and decode JWT token.

Parameters:

Name	Type	Description	Default
`token`	`str`	JWT token	required
`check_exp`	`bool`	Check expire	`True`
`check_list`	`bool`	Check white/black list. Docs: https://jam.makridenko.ru/jwt/lists/what/	`True`
`check_nbf`	`bool`	Check not-before time	`False`
`include_headers`	`bool`	Include headers in the decoded payload	`False`

Returns:

Type	Description
`dict[str, Any]`	dict[str, Any]: Decoded payload

jwt_encode `abstractmethod` ¶

jwt_encode(
    iss: str | None = None,
    sub: str | None = None,
    aud: str | None = None,
    exp: int | None = None,
    nbf: int | None = None,
    jti: str | None = None,
    *,
    payload: dict[str, Any] | None = None,
    header: dict[str, Any] | None = None,
) -> str

Encode the JWT with the given expire, header, and payload.

Parameters:

Name	Type	Description	Default
`exp`	`int \| None`	The expiration time in seconds.	`None`
`nbf`	`int \| None`	The not-before time in seconds.	`None`
`iss`	`str \| None`	The issuer.	`None`
`sub`	`str \| None`	The subject.	`None`
`aud`	`str \| None`	The audience.	`None`
`jti`	`str \| None`	The JWT ID. If none use the JTI fabric function.	`None`
`header`	`dict[str, Any] \| None`	The header to include in the JWT.	`None`
`payload`	`dict[str, Any] \| None`	The payload to include in the JWT.	`None`

Returns:

Name	Type	Description
`str`	`str`	The encoded JWT.

oauth2_client_credentials_flow `abstractmethod` ¶

oauth2_client_credentials_flow(
    provider: str,
    scope: list[str] | None = None,
    **extra_params: Any,
) -> dict[str, Any]

Obtain access token using client credentials flow (no user interaction).

Parameters:

Name	Type	Description	Default
`provider`	`str`	Provider name	required
`scope`	`list[str] \| None`	Auth scope	`None`
`extra_params`	`Any`	Extra auth params if needed	`{}`

Returns:

Name	Type	Description
`dict`	`dict[str, Any]`	JSON with access token

oauth2_fetch_token `abstractmethod` ¶

oauth2_fetch_token(
    provider: str,
    code: str,
    grant_type: str = "authorization_code",
    **extra_params: Any,
) -> dict[str, Any]

Exchange authorization code for access token.

Parameters:

Name	Type	Description	Default
`provider`	`str`	Provider name	required
`code`	`str`	OAuth2 code	required
`grant_type`	`str`	Type of oauth2 grant	`'authorization_code'`
`extra_params`	`Any`	Extra auth params if needed	`{}`

Returns:

Name	Type	Description
`dict`	`dict[str, Any]`	OAuth2 token

oauth2_get_authorized_url `abstractmethod` ¶

oauth2_get_authorized_url(
    provider: str, scope: list[str], **extra_params: Any
) -> str

Generate full OAuth2 authorization URL.

Parameters:

Name	Type	Description	Default
`provider`	`str`	Provider name	required
`scope`	`list[str]`	Auth scope	required
`extra_params`	`Any`	Extra ath params	`{}`

Returns:

Name	Type	Description
`str`	`str`	Authorization url

oauth2_refresh_token `abstractmethod` ¶

oauth2_refresh_token(
    provider: str,
    refresh_token: str,
    grant_type: str = "refresh_token",
    **extra_params: Any,
) -> dict[str, Any]

Use refresh token to obtain a new access token.

Parameters:

Name	Type	Description	Default
`provider`	`str`	Provider name	required
`refresh_token`	`str`	Refresh token	required
`grant_type`	`str`	Grant type	`'refresh_token'`
`extra_params`	`Any`	Extra auth params if needed	`{}`

Returns:

Name	Type	Description
`dict`	`dict[str, Any]`	Refresh token

otp_code `abstractmethod` ¶

otp_code(
    secret: str | bytes, factor: int | None = None
) -> str

Generates an OTP.

Parameters:

Name	Type	Description	Default
`secret`	`str \| bytes`	User secret key.	required
`factor`	`int \| None`	Unixtime for TOTP(if none, use now time) / Counter for HOTP.	`None`

Returns:

Name	Type	Description
`str`	`str`	OTP code (fixed-length string).

otp_uri `abstractmethod` ¶

otp_uri(
    secret: str,
    name: str,
    issuer: str,
    counter: int | None = None,
) -> str

Generates an otpauth:// URI for Google Authenticator.

Parameters:

Name	Type	Description	Default
`secret`	`str`	User secret key.	required
`name`	`str`	Account name (e.g., email).	required
`issuer`	`str`	Service name (e.g., "GitHub").	required
`counter`	`int \| None`	Counter (for HOTP). Default is None.	`None`

Returns:

Name	Type	Description
`str`	`str`	A string of the form "otpauth://..."

otp_verify_code `abstractmethod` ¶

otp_verify_code(
    secret: str | bytes,
    code: str,
    factor: int | None = None,
    look_ahead: int | None = 1,
) -> bool

Checks the OTP code, taking into account the acceptable window.

Parameters:

Name	Type	Description	Default
`secret`	`str \| bytes`	User secret key.	required
`code`	`str`	The code entered.	required
`factor`	`int \| None`	Unixtime for TOTP(if none, use now time) / Counter for HOTP.	`None`
`look_ahead`	`int`	Acceptable deviation in intervals (±window(totp) / ±look ahead(hotp)). Default is 1.	`1`

Returns:

Name	Type	Description
`bool`	`bool`	True if the code matches, otherwise False.

paseto_create `abstractmethod` ¶

paseto_create(
    payload: dict[str, Any],
    footer: dict[str, Any] | str | None,
) -> str

Create new PASETO.

Parameters:

Name	Type	Description	Default
`payload`	`dict[str, Any]`	Payload	required
`footer`	`dict[str, Any] \| str \| None`	Payload if needed	required

Returns:

Name	Type	Description
`str`	`str`	PASETO

paseto_decode `abstractmethod` ¶

paseto_decode(
    token: str,
) -> dict[str, dict[str, Any] | str | None]

Decode PASETO and return payload and footer.

Parameters:

Name	Type	Description	Default
`token`	`str`	PASETO	required

Returns:

Name	Type	Description
`dict`	`dict[str, dict[str, Any] \| str \| None]`	{"payload": PAYLOAD, "footer": FOOTER}

paseto_make_payload `abstractmethod` ¶

paseto_make_payload(
    exp: int | None = None, **data: dict[str, Any]
) -> dict[str, Any]

Generate payload for PASETO.

Parameters:

Name	Type	Description	Default
`exp`	`int \| None`	Custom expire if needed	`None`
`data`	`dict[str, Any]`	Data in payload	`{}`

Returns:

Type	Description
`dict[str, Any]`	dict[str, Any]: New payload

session_clear `abstractmethod` ¶

session_clear(session_key: str) -> None

Delete all sessions by key.

Parameters:

Name	Type	Description	Default
`session_key`	`str`	Key of session	required

session_create `abstractmethod` ¶

session_create(
    session_key: str, data: dict[str, Any]
) -> str

Create new session.

Parameters:

Name	Type	Description	Default
`session_key`	`str`	Key for session	required
`data`	`dict[str, Any]`	Session data	required

Returns:

Name	Type	Description
`str`	`str`	New session ID

session_delete `abstractmethod` ¶

session_delete(session_id: str) -> None

Delete session.

Parameters:

Name	Type	Description	Default
`session_id`	`str`	Session ID	required

session_get `abstractmethod` ¶

session_get(session_id: str) -> dict[str, Any] | None

Get data from session.

Parameters:

Name	Type	Description	Default
`session_id`	`str`	Session ID	required

Returns:

Type	Description
`dict[str, Any] \| None`	dict[str, Any] \| None: Session data if exist

session_rework `abstractmethod` ¶

session_rework(old_session_id: str) -> str

Rework session.

Parameters:

Name	Type	Description	Default
`old_session_id`	`str`	Old session id	required

Returns:

Name	Type	Description
`str`	`str`	New session id

session_update `abstractmethod` ¶

session_update(
    session_id: str, data: dict[str, Any]
) -> None

Update session data.

Parameters:

Name	Type	Description	Default
`session_id`	`str`	Session ID	required
`data`	`dict[str, Any]`	New data	required

Jam ¶

Jam(
    config: str | dict[str, Any] = "pyproject.toml",
    pointer: str = "jam",
    *,
    logger: type[BaseLogger] = JamLogger,
    log_level: Literal[
        "DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"
    ] = "INFO",
    serializer: BaseEncoder
    | type[BaseEncoder] = JsonEncoder,
    plugins: list[type[BasePlugin]] = [],
)

Bases: BaseJam

Main instance.

Methods:

Name	Description
`jwe_decrypt`	Decrypt JWE token.
`jwe_encrypt`	Encrypt data using JWE.
`jws_sign`	Sign data using JWS.
`jws_verify`	Verify JWS token.
`jwt_create`	Create JWT token.
`jwt_decode`	Verify and decode JWT token.
`jwt_encode`	Encode the JWT with the given expire, header, and payload.
`jwt_make_payload`	Make JWT-specific payload.
`oauth2_client_credentials_flow`	Obtain access token using client credentials flow (no user interaction).
`oauth2_fetch_token`	Exchange authorization code for access token.
`oauth2_get_authorized_url`	Generate full OAuth2 authorization URL.
`oauth2_refresh_token`	Use refresh token to obtain a new access token.
`otp_code`	Generates an OTP.
`otp_uri`	Generates an otpauth:// URI for Google Authenticator.
`otp_verify_code`	Checks the OTP code, taking into account the acceptable window.
`paseto_create`	Create new PASETO.
`paseto_decode`	Decode PASETO.
`paseto_make_payload`	Generate payload for PASETO.
`session_clear`	Delete all sessions by key.
`session_create`	Create new session.
`session_delete`	Delete session.
`session_get`	Get data from session.
`session_rework`	Rework session.
`session_update`	Update session data.

jwe_decrypt ¶

jwe_decrypt(token: str) -> bytes

Decrypt JWE token.

Parameters:

Name	Type	Description	Default
`token`	`str`	JWE token.	required

Returns:

Name	Type	Description
`bytes`	`bytes`	Decrypted data.

jwe_encrypt ¶

jwe_encrypt(
    data: dict[str, Any] | str,
    header: dict[str, Any] | None = None,
) -> str

Encrypt data using JWE.

Parameters:

Name	Type	Description	Default
`data`	`dict[str, Any] \| str`	Data to encrypt. If dict, will be JSON encoded.	required
`header`	`dict[str, Any] \| None`	JWE header.	`None`

Returns:

Name	Type	Description
`str`	`str`	JWE token.

jws_sign ¶

jws_sign(
    data: dict[str, Any] | str,
    header: dict[str, Any] | None = None,
) -> str

Sign data using JWS.

Parameters:

Name	Type	Description	Default
`data`	`dict[str, Any] \| str`	Data to sign. If dict, will be JSON encoded.	required
`header`	`dict[str, Any] \| None`	JWS header.	`None`

Returns:

Name	Type	Description
`str`	`str`	JWS token.

jws_verify ¶

jws_verify(token: str) -> dict[str, Any]

Verify JWS token.

Parameters:

Name	Type	Description	Default
`token`	`str`	JWS token.	required

Returns:

Type	Description
`dict[str, Any]`	dict[str, Any]: Decoded payload.

jwt_create ¶

jwt_create(payload: dict[str, Any]) -> str

Create JWT token.

Deprecated

Use Jam.jwt_encode

Parameters:

Name	Type	Description	Default
`payload`	`dict[str, Any]`	Data payload	required

Returns:

Name	Type	Description
`str`	`str`	New token

jwt_decode ¶

jwt_decode(
    token: str,
    check_exp: bool = True,
    check_list: bool = True,
    check_nbf: bool = False,
    include_headers: bool = False,
) -> dict[str, Any]

Verify and decode JWT token.

Parameters:

Name	Type	Description	Default
`token`	`str`	JWT token	required
`check_exp`	`bool`	Check expire	`True`
`check_list`	`bool`	Check white/black list. Docs: https://jam.makridenko.ru/jwt/lists/what/	`True`
`check_nbf`	`bool`	Check not-before time	`False`
`include_headers`	`bool`	Include headers in the decoded payload	`False`

Returns:

Type	Description
`dict[str, Any]`	dict[str, Any]: Decoded payload

Raises:

Type	Description
`JamJWTExpired`	If token is expired
`JamJWTNotYetValid`	If token is not yet valid (nbf claim)
`JamConfigurationError`	If JWT list is not connected
`JamJWTNotInWhiteList`	If token is not in white list
`JamJWTInBlackList`	If token is in black list

jwt_encode ¶

jwt_encode(
    iss: str | None = None,
    sub: str | None = None,
    aud: str | None = None,
    exp: int | None = None,
    nbf: int | None = None,
    jti: str | None = None,
    *,
    payload: dict[str, Any] | None = None,
    header: dict[str, Any] | None = None,
) -> str

Encode the JWT with the given expire, header, and payload.

Parameters:

Name	Type	Description	Default
`exp`	`int \| None`	The expiration time in seconds.	`None`
`nbf`	`int \| None`	The not-before time in seconds.	`None`
`iss`	`str \| None`	The issuer.	`None`
`sub`	`str \| None`	The subject.	`None`
`aud`	`str \| None`	The audience.	`None`
`jti`	`str \| None`	The JWT ID. If none use the JTI fabric function.	`None`
`header`	`dict[str, Any] \| None`	The header to include in the JWT.	`None`
`payload`	`dict[str, Any] \| None`	The payload to include in the JWT.	`None`

Returns:

Name	Type	Description
`str`	`str`	The encoded JWT.

jwt_make_payload ¶

jwt_make_payload(
    exp: int | None, data: dict[str, Any]
) -> dict[str, Any]

Make JWT-specific payload.

Deprecated

This method is deprecated; the JWT payload is generated automatically in accordance with the specification.

Parameters:

Name	Type	Description	Default
`exp`	`int \| None`	Token expire	required
`data`	`dict[str, Any]`	Data to payload	required

Returns:

Type	Description
`dict[str, Any]`	dict[str, Any]: Payload

oauth2_client_credentials_flow ¶

oauth2_client_credentials_flow(
    provider: str,
    scope: list[str] | None = None,
    **extra_params: Any,
) -> dict[str, Any]

Obtain access token using client credentials flow (no user interaction).

Parameters:

Name	Type	Description	Default
`provider`	`str`	OAuth2 provider	required
`scope`	`list[str] \| None`	Auth scope	`None`
`extra_params`	`Any`	Extra auth params if needed	`{}`

Raises:

Type	Description
`JamOAuth2EmptyRaw`	If response is empty
`JamOAuth2Error`	HTTP error

Returns:

Name	Type	Description
`dict`	`dict[str, Any]`	JSON with access token

oauth2_fetch_token ¶

oauth2_fetch_token(
    provider: str,
    code: str,
    grant_type: str = "authorization_code",
    **extra_params: Any,
) -> dict[str, Any]

Exchange authorization code for access token.

Parameters:

Name	Type	Description	Default
`provider`	`str`	Provider name	required
`code`	`str`	OAuth2 code	required
`grant_type`	`str`	Type of oauth2 grant	`'authorization_code'`
`extra_params`	`Any`	Extra auth params if needed	`{}`

Returns:

Name	Type	Description
`dict`	`dict[str, Any]`	OAuth2 token

oauth2_get_authorized_url ¶

oauth2_get_authorized_url(
    provider: str, scope: list[str], **extra_params: Any
) -> str

Generate full OAuth2 authorization URL.

Parameters:

Name	Type	Description	Default
`provider`	`str`	Provider name	required
`scope`	`list[str]`	Auth scope	required
`extra_params`	`Any`	Extra ath params	`{}`

Returns:

Name	Type	Description
`str`	`str`	Authorization url

oauth2_refresh_token ¶

oauth2_refresh_token(
    provider: str,
    refresh_token: str,
    grant_type: str = "refresh_token",
    **extra_params: Any,
) -> dict[str, Any]

Use refresh token to obtain a new access token.

Parameters:

Name	Type	Description	Default
`provider`	`str`	Provider name	required
`refresh_token`	`str`	Refresh token	required
`grant_type`	`str`	Grant type	`'refresh_token'`
`extra_params`	`Any`	Extra auth params if needed	`{}`

Returns:

Name	Type	Description
`dict`	`dict[str, Any]`	Refresh token

otp_code ¶

otp_code(
    secret: str | bytes, factor: int | None = None
) -> str

Generates an OTP.

Parameters:

Name	Type	Description	Default
`secret`	`str \| bytes`	User secret key.	required
`factor`	`int \| None`	Unixtime for TOTP(if none, use now time) / Counter for HOTP.	`None`

Returns:

Name	Type	Description
`str`	`str`	OTP code (fixed-length string).

otp_uri ¶

otp_uri(
    secret: str,
    name: str,
    issuer: str,
    counter: int | None = None,
) -> str

Generates an otpauth:// URI for Google Authenticator.

Parameters:

Name	Type	Description	Default
`secret`	`str`	User secret key.	required
`name`	`str`	Account name (e.g., email).	required
`issuer`	`str`	Service name (e.g., "GitHub").	required
`counter`	`int \| None`	Counter (for HOTP). Default is None.	`None`

Returns:

Name	Type	Description
`str`	`str`	A string of the form "otpauth://..."

otp_verify_code ¶

otp_verify_code(
    secret: str | bytes,
    code: str,
    factor: int | None = None,
    look_ahead: int | None = 1,
) -> bool

Checks the OTP code, taking into account the acceptable window.

Parameters:

Name	Type	Description	Default
`secret`	`str \| bytes`	User secret key.	required
`code`	`str`	The code entered.	required
`factor`	`int \| None`	Unixtime for TOTP(if none, use now time) / Counter for HOTP.	`None`
`look_ahead`	`int`	Acceptable deviation in intervals (±window(totp) / ±look ahead(hotp)). Default is 1.	`1`

Returns:

Name	Type	Description
`bool`	`bool`	True if the code matches, otherwise False.

paseto_create ¶

paseto_create(
    payload: dict[str, Any],
    footer: dict[str, Any] | str | None,
) -> str

Create new PASETO.

Parameters:

Name	Type	Description	Default
`payload`	`dict[str, Any]`	Payload	required
`footer`	`dict \| str \| None`	Footer	required

Returns:

Name	Type	Description
`str`	`str`	New token

paseto_decode ¶

paseto_decode(
    token: str,
    check_exp: bool = True,
    check_list: bool = True,
) -> dict[str, dict[str, Any] | str | None]

Decode PASETO.

Parameters:

Name	Type	Description	Default
`token`	`str`	Token	required
`check_exp`	`bool`	Check exp in payload	`True`
`check_list`	`bool`	Check token in list	`True`

Returns:

Name	Type	Description
`dict`	`dict[str, dict[str, Any] \| str \| None]`	{'payload' PAYLOAD, 'footer': FOOTER}

paseto_make_payload ¶

paseto_make_payload(
    exp: int | None = None, **data: dict[str, Any]
) -> dict[str, Any]

Generate payload for PASETO.

Parameters:

Name	Type	Description	Default
`exp`	`int \| None`	Token expire	`None`
`data`	`dict[str, Any]`	Custom data	`{}`

Returns:

Name	Type	Description
`dict`	`dict[str, Any]`	Payload

session_clear ¶

session_clear(session_key: str) -> None

Delete all sessions by key.

Parameters:

Name	Type	Description	Default
`session_key`	`str`	Key of session	required

session_create ¶

session_create(
    session_key: str, data: dict[str, Any]
) -> str

Create new session.

Parameters:

Name	Type	Description	Default
`session_key`	`str`	Key for session	required
`data`	`dict[str, Any]`	Session data	required

Returns:

Name	Type	Description
`str`	`str`	New session ID

session_delete ¶

session_delete(session_id: str) -> None

Delete session.

Parameters:

Name	Type	Description	Default
`session_id`	`str`	Session ID	required

session_get ¶

session_get(session_id: str) -> dict[str, Any] | None

Get data from session.

Parameters:

Name	Type	Description	Default
`session_id`	`str`	Session ID	required

Returns:

Type	Description
`dict[str, Any] \| None`	dict[str, Any] \| None: Session data if exist

session_rework ¶

session_rework(old_session_id: str) -> str

Rework session.

Parameters:

Name	Type	Description	Default
`old_session_id`	`str`	Old session id	required

Raises:

Type	Description
`JamSessionNotFound`	If session with given ID does not exist.

Returns:

Name	Type	Description
`str`	`str`	New session id

session_update ¶

session_update(
    session_id: str, data: dict[str, Any]
) -> None

Update session data.

Parameters:

Name	Type	Description	Default
`session_id`	`str`	Session ID	required
`data`	`dict[str, Any]`	New data	required

Raises:

Type	Description
`JamSessionNotFound`	If session with given ID does not exist.

jam¶

jam ¶

BaseJam ¶

__build_instance ¶

__build_main_config ¶

__otp ¶

__setup_plugins ¶

emit ¶

jwe_decrypt abstractmethod ¶

jwe_encrypt abstractmethod ¶

jws_sign abstractmethod ¶

jws_verify abstractmethod ¶

jwt_decode abstractmethod ¶

jwt_encode abstractmethod ¶

oauth2_client_credentials_flow abstractmethod ¶

oauth2_fetch_token abstractmethod ¶

oauth2_get_authorized_url abstractmethod ¶

oauth2_refresh_token abstractmethod ¶

otp_code abstractmethod ¶

otp_uri abstractmethod ¶

otp_verify_code abstractmethod ¶

paseto_create abstractmethod ¶

paseto_decode abstractmethod ¶

paseto_make_payload abstractmethod ¶

session_clear abstractmethod ¶

session_create abstractmethod ¶

session_delete abstractmethod ¶

session_get abstractmethod ¶

session_rework abstractmethod ¶

session_update abstractmethod ¶

Jam ¶

jwe_decrypt ¶

jwe_encrypt ¶

jws_sign ¶

jws_verify ¶

jwt_create ¶

jwt_decode ¶

jwt_encode ¶

jwt_make_payload ¶

oauth2_client_credentials_flow ¶

oauth2_fetch_token ¶

oauth2_get_authorized_url ¶

oauth2_refresh_token ¶

otp_code ¶

otp_uri ¶

otp_verify_code ¶

paseto_create ¶

paseto_decode ¶

paseto_make_payload ¶

session_clear ¶

session_create ¶

session_delete ¶

session_get ¶

session_rework ¶

session_update ¶

jwe_decrypt `abstractmethod` ¶

jwe_encrypt `abstractmethod` ¶

jws_sign `abstractmethod` ¶

jws_verify `abstractmethod` ¶

jwt_decode `abstractmethod` ¶

jwt_encode `abstractmethod` ¶

oauth2_client_credentials_flow `abstractmethod` ¶

oauth2_fetch_token `abstractmethod` ¶

oauth2_get_authorized_url `abstractmethod` ¶

oauth2_refresh_token `abstractmethod` ¶

otp_code `abstractmethod` ¶

otp_uri `abstractmethod` ¶

otp_verify_code `abstractmethod` ¶

paseto_create `abstractmethod` ¶

paseto_decode `abstractmethod` ¶

paseto_make_payload `abstractmethod` ¶

session_clear `abstractmethod` ¶

session_create `abstractmethod` ¶

session_delete `abstractmethod` ¶

session_get `abstractmethod` ¶

session_rework `abstractmethod` ¶

session_update `abstractmethod` ¶