Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A Twisted-based Kubernetes client.

Project Description

What is this?

txkube is a Twisted-based client library for interacting with Kubernetes.

Usage Sample

from __future__ import print_function
from twisted.internet.task import react

from txkube import network_kubernetes_from_context

@react
def main(reactor):
    k8s = network_kubernetes_from_context(reactor, u"minikube")
    d = k8s.versioned_client()
    d.addCallback(
        lambda client: client.list(client.model.v1.Namespace)
    )
    d.addCallback(print)
    return d

Installing

To install the latest version of txkube using pip:

$ pip install txkube

For additional development dependencies, install the dev extra:

$ pip install txkube[dev]

Testing

txkube uses pyunit-style tests. After installing the development dependencies, you can run the test suite with trial:

$ pip install txkube[dev]
$ trial txkube

txkube also includes integration tests. It is not recommended that you run these against anything but a dedicated testing Kubernetes cluster. Minikube is an easy way to obtain such a thing. Once running:

$ pip install txkube[dev]
$ TXKUBE_INTEGRATION_CONTEXT=minikube trial txkube

This will run the full test suite which includes the integration tests. It will interact with (and make destructive changes to) the identified Kubernetes cluster.

License

txkube is open source software released under the MIT License. See the LICENSE file for more details.

Release History

Release History

This version
History Node

0.2.0

History Node

0.1.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
txkube-0.2.0-py2-none-any.whl (151.6 kB) Copy SHA256 Checksum SHA256 py2 Wheel Jun 5, 2017
txkube-0.2.0.tar.gz (136.9 kB) Copy SHA256 Checksum SHA256 Source Jun 5, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting