types-python-jose

What it is and what it does

This is a type-stub package that provides static type information for python-jose, a library used for JWT handling and cryptographic operations. It is part of the typeshed project and allows type checkers like mypy and pyright to understand and validate code that imports and uses python-jose. The stubs are tested against mypy 1.20.0 and pyright 1.1.408 and target python-jose version 3.5.*.

Type stubs are not runtime code—they exist only to help your development tools catch type errors before execution. Installing this package alongside python-jose lets your IDE and CI pipelines perform static analysis on JWT operations and cryptographic calls. The package has low install friction, depending only on types-pyasn1, and is actively maintained through the typeshed repository.

Use it for:

• Enable mypy or pyright to type-check code that calls python-jose JWT functions without runtime overhead.
• Catch type mismatches in token encoding/decoding workflows during development rather than at runtime.
• Provide IDE autocomplete and inline type hints when working with python-jose in an editor that supports type stubs.
• Validate cryptographic key handling and algorithm parameters passed to python-jose functions.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type hints for the python-jose library, enabling static type checkers like mypy and pyright to validate code that uses python-jose for JWT and cryptographic operations.

Yes, if you use python-jose and want static type checking. Install it alongside python-jose in development and CI environments. It has no runtime cost, low friction, and is actively maintained. Not needed if you don't use a type checker or don't use python-jose.

Install

types-python-jose on PyPI

pip install types-python-jose

uv add types-python-jose

poetry add types-python-jose

Installing types-python-jose

Before you install

Low install friction with a single type-stub dependency (types-pyasn1). Actively maintained as part of typeshed; last commit 2026-08-14 with no archived status.

License in practice

Apache-2.0 permissive license allows use in most projects without restriction.

Quickstart

pip install types-python-jose

# In your code using python-jose:
from jose import jwt
token: str = jwt.get_unverified_header(encoded_token)

Requires Python 3.10 or later; python-jose itself must be installed separately for runtime use.

Verify before relying

• Whether this stub package is kept in sync with all python-jose 3.5.x releases or only a subset.
• Coverage completeness of type annotations across the full python-jose API surface.

Package facts

Evidence: types_python_jose-3.5.0.20260408-py3-none-any.whl

Tags

More Software Development packages