types-hvac
Typing stubs for hvac
Decision gist · record as of 2026-08-14
Yes, if you use hvac and run static type checking. It adds no runtime overhead and enables type safety for Vault client code. Install it alongside hvac in projects where mypy or pyright is part of the development workflow. Not necessary if you do not use static type checking or do not use hvac.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; hvac package itself must be installed separately for runtime use.
- Low friction installation with a single runtime dependency (requests).
- Actively maintained as part of the typeshed project with recent releases; last commit was 2026-08-14.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows use in most projects without restriction, including proprietary software.
last release 2026-07-31 (14 days) · last repo commit 2026-08-14 · 37 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 458,996 downloads/mo, #6,544 on PyPI
Alternatives
Verify before relying
pip install types-hvac
import hvac
# Type checker now understands hvac methods and attributes- Whether this stub package is automatically installed as a dependency of hvac or must be installed separately.
- Coverage completeness for hvac 2.4.* API surface beyond the tested type checkers.
- Typical Vault server configuration details needed for hvac client initialization.
What it is and what it does
types-hvac is a type stub package that provides static type annotations for the hvac library, a Python client for HashiCorp Vault. It allows type checkers like mypy and pyright to understand the types and signatures of hvac's API, catching type errors at development time rather than runtime. The stubs are maintained as part of the typeshed project and target hvac version 2.4.*.
This package is intended for developers who use hvac and want to enable static type checking in their codebase. It has no runtime effect—it only provides metadata for type checkers. Installation is straightforward with low friction, requiring only the requests dependency that hvac itself uses.
Use it for
- Enable mypy or pyright to catch type errors in code that calls hvac methods for Vault authentication and secret retrieval.
- Provide IDE autocomplete and type hints when writing hvac client code in editors that support type stubs.
- Validate that Vault client initialization and API calls match expected signatures during CI/CD type-checking passes.
- Document the expected types and return values of hvac's public API for developers unfamiliar with the library.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use hvac and run static type checking.
It adds no runtime overhead and enables type safety for Vault client code. Install it alongside hvac in projects where mypy or pyright is part of the development workflow. Not necessary if you do not use static type checking or do not use hvac.
Install
types-hvac on PyPI
Before you install
Low friction installation with a single runtime dependency (requests). Actively maintained as part of the typeshed project with recent releases; last commit was 2026-08-14.
Requires Python 3.10 or later; hvac package itself must be installed separately for runtime use.
License in practice
Apache-2.0 permissive license allows use in most projects without restriction, including proprietary software.
Quickstart
pip install types-hvac
import hvac
# Type checker now understands hvac methods and attributesVerify before relying
- Whether this stub package is automatically installed as a dependency of hvac or must be installed separately.
- Coverage completeness for hvac 2.4.* API surface beyond the tested type checkers.
- Typical Vault server configuration details needed for hvac client initialization.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagerequests |
| Maintenance | Actively maintained 14 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 458,996 / month, #6,544 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Typing :: Stubs Only |
Evidence: types_hvac-2.4.0.20260731-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “type stubs hvac”
- types-hvacProvides type hints for the hvac package, enabling static type…
- aioairzone-cloudAsync Python library for controlling Airzone Cloud HVAC devices using…
- aioairzoneAn async Python library for controlling and monitoring Airzone HVAC…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also types-docker · types-gunicorn · types-grpcio · types-paramiko · hvac · types-mypy-extensions · types-decorator · types-cachetools · types-boltons · bacpypes