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.416.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.416-py3-none-any.whl (51.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: zalando_kubectl-1.35.3.416.tar.gz
  • Upload date:
  • Size: 50.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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.416.tar.gz
Algorithm Hash digest
SHA256 7e3c8a1ae97aeb1ece76803c4d99973dcad6e77ce31649eb4809d63bb6e48114
MD5 9edc963385ecff5dfcd0cc4f34317c92
BLAKE2b-256 3afe0b2d1eb2b1bf11063bbe070ce55e4005dadab092650a5f6d74dd4324fee3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: zalando_kubectl-1.35.3.416-py3-none-any.whl
  • Upload date:
  • Size: 51.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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.416-py3-none-any.whl
Algorithm Hash digest
SHA256 8fb1e5a4341502ae10a2e6f39dfe8063b915b14dfee4e2db8d87ea6c4feabc37
MD5 1f2d28742d12604150d7e00c76222185
BLAKE2b-256 e93e648bf8af19804637e973b1b438114ea7b7c369a8c705c771ba969578ba62

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