skillfed

kubernetes-stubs

Type stubs for the Kubernetes Python API client

kubernetes-stubs v22.6.0.post1 654.6K downloads/30d#5,522 on PyPI
Permissive license Apache-2.0 Abandoned released

What it is and what it does

kubernetes-stubs is a type-stub package that mirrors the Kubernetes Python API client's public interface, allowing static type checkers and IDEs to understand the types and signatures of client calls. Type stubs are metadata-only files that describe what types a library exposes; they don't add runtime behavior.

The package is useful if you write type-checked Python code that uses the Kubernetes client library. Its version numbers track the upstream package, so version 22.6.0.post1 corresponds to Kubernetes client 22.6.0. However, the package has not been updated since 2022-04-20 and is no longer maintained, meaning it will not reflect API changes in newer client releases.

Use it for:

  • Enable type checking in scripts that call the Kubernetes Python client
  • Get IDE autocompletion and inline type hints when writing Kubernetes client code
  • Verify at development time that your API calls match the client's expected signatures
  • Maintain a typed codebase that depends on the Kubernetes client without type errors

Worth the install?

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

Provides Python type stubs for the Kubernetes API client, enabling static type checking and IDE autocompletion when working with the upstream kubernetes package.

Yes, if you are using Kubernetes client version 22.6.x and need type checking support. No, if you use a newer client version—the stubs are outdated and will not reflect current API. Check whether the upstream package now includes inline type hints or whether an actively maintained alternative exists before installing.

Install

kubernetes-stubs on PyPI

pip

pip install kubernetes-stubs

uv

uv add kubernetes-stubs

poetry

poetry add kubernetes-stubs

Installing kubernetes-stubs

Before you install

Installation is straightforward with no runtime dependencies. However, the package is abandoned—last release was 1577 days ago—so it will not track upstream Kubernetes API changes or receive maintenance.

License in practice

Licensed under Apache-2.0 (permissive), so you can use it freely in commercial and open-source projects without copyleft obligations.

Quickstart

pip install kubernetes-stubs

Verify before relying

  • Whether these stubs remain accurate for current versions of the Kubernetes Python API client
  • Compatibility with Python versions beyond 3.10 (the newest explicitly declared in classifiers)

Package facts

License Apache-2.0 (permissive)
Python support not specified
Install friction low — pure-Python wheel
Runtime dependencies none
Maintenance abandoned — 1,577 days since the last release
First released
Downloads 654,583/month — #5,522 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: kubernetes_stubs-22.6.0.post1-py2.py3-none-any.whl

License :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9

Tags

kubernetes type stubskubernetes python typingk8s api client typeskubernetes type hintsstatic type checking kuberneteskubernetes mypy stubskubernetes client type annotations
type-stubskubernetesabandoned

More Software Development packages