types-uWSGI

What it is and what it does

types-uWSGI is a type stub package that provides type annotations for uWSGI's Python API. It allows static type checkers like mypy and pyright to understand and validate code that calls uWSGI functions and modules, catching type errors before runtime. The stubs are maintained as part of the typeshed project and are tested against mypy 2.1.0 and pyright 1.1.409.

This package is purely for development and type checking—it contains no runtime code and adds no dependencies to your project. It targets uWSGI 2.0.* and is useful only when your code runs inside a uWSGI process, since the uWSGI Python API is only available in that context. Some API features are conditional on uWSGI configuration, which the stubs reflect.

Use it for:

• Enable mypy or pyright to type-check uWSGI application code and catch API misuse before deployment.
• Provide IDE autocomplete and inline documentation for uWSGI functions when writing uWSGI-based applications.
• Validate configuration and plugin code that calls uWSGI's Python API within a uWSGI process.
• Ensure type safety in projects that mix uWSGI calls with other typed Python libraries.

Worth the install?

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

Provides type hints for the uWSGI Python API, enabling type checkers like mypy and pyright to validate code that uses uWSGI.

Yes, if you use uWSGI and want type checking. It has no runtime cost, low friction, and is actively maintained. Install it in your development environment to catch type errors in uWSGI code. Not needed if you don't use uWSGI or don't use a type checker.

Install

types-uwsgi on PyPI

pip install types-uwsgi

uv add types-uwsgi

poetry add types-uwsgi

Installing types-uWSGI

Before you install

Low install friction; a pure stub package with no runtime dependencies. Actively maintained as part of typeshed, with recent updates.

License in practice

Apache-2.0 permissive license allows unrestricted use, modification, and distribution in both open-source and proprietary projects.

Quickstart

pip install types-uwsgi

# In your code, type checkers will now understand uWSGI imports:
import uwsgi

# Type checkers can now validate calls like:
uwsgi.cache_get('key')

Type hints are only meaningful when running Python inside a uWSGI process; some API parts require specific uWSGI configuration options to be enabled.

Verify before relying

• Whether the stubs cover all uWSGI 2.0.* versions or only specific minor releases.
• Whether all uWSGI configuration-dependent API parts are documented in the stubs.

Package facts

Evidence: types_uwsgi-2.0.0.20260518-py3-none-any.whl

Tags

More Software Development packages