Skip to main content

Zalando Kubectl

Description

PyPI Downloads

Latest PyPI version License

Kubernetes CLI (kubectl) wrapper in Python with OAuth token authentication.

This wrapper script zkubectl serves as a drop-in replacement for the kubectl binary:

  • it downloads the current kubectl binary from Google
  • it generates a new ~/.kube/config with an OAuth Bearer token acquired via zign.
  • it passes through commands to the kubectl binary

User Facing documentation

Contribute

Setup project

  • It's recommended to use uv for the project.

Go to the project dir and install dependencies with uv

$ cd <project-path>
$ uv sync
  • [Optional] install pre-commit hooks
$ pre-commit install
  • [Optional] The project uses ruff for code formatting, configure your editor to use it.

Unit Tests

Run unit tests with Docker:

docker build --build-arg PYTHON_VERSION=3.10 --build-arg PACKAGE_NAME=zalando_kubectl -f Dockerfile.test .
docker build --build-arg PYTHON_VERSION=3.11 --build-arg PACKAGE_NAME=zalando_kubectl -f Dockerfile.test .
docker build --build-arg PYTHON_VERSION=3.12 --build-arg PACKAGE_NAME=zalando_kubectl --build-arg DEBIAN_DISTRO=bullseye -f Dockerfile.test .
docker build --build-arg PYTHON_VERSION=3.13 --build-arg PACKAGE_NAME=zalando_kubectl --build-arg DEBIAN_DISTRO=bullseye -f Dockerfile.test .

Run Locally

via uv

$ uv run zkubectl

Or first activate the virtualenv

$ source .venv/bin/activate
$ zkubectl login playground

Use as kubectl plugin

The project exposes scripts that use the kubectl plugin format

You can see which ones are available in the scripts section of pyproject.toml

In order for kubectl to detect the subcommands provided by the script, they must be in the PATH, so you need first to activate the virtualenv

$ source .venv/bin/activate
$ kubectl login playground

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zalando_kubectl-1.35.3.418.tar.gz (50.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zalando_kubectl-1.35.3.418-py3-none-any.whl (51.9 kB view details)

Uploaded Python 3

File details

Details for the file zalando_kubectl-1.35.3.418.tar.gz.

File metadata

  • Download URL: zalando_kubectl-1.35.3.418.tar.gz
  • Upload date:
  • Size: 50.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for zalando_kubectl-1.35.3.418.tar.gz
Algorithm Hash digest
SHA256 b8c0089539542a1d5c63148173ad9daa93c2c1cf845cfb159238546188b22bd9
MD5 301de29fdbcce1142be7c697f6138e44
BLAKE2b-256 32f67eafa35da35a85f2459edb2f56ef9cf87eb41da1e7ded03fcd964e63d321

See more details on using hashes here.

File details

Details for the file zalando_kubectl-1.35.3.418-py3-none-any.whl.

File metadata

  • Download URL: zalando_kubectl-1.35.3.418-py3-none-any.whl
  • Upload date:
  • Size: 51.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for zalando_kubectl-1.35.3.418-py3-none-any.whl
Algorithm Hash digest
SHA256 723a49625b1970bf8c644c4021c3c4b76a95230ba09dc827b52b49f3475979c9
MD5 23df7f6192b5425f5c26d1a142661872
BLAKE2b-256 35f493addb6b42afea5200c0fefcee24267dcb6d4b8f5bab8a81111c6d5c1c29

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page