Skip to content

Latest commit

 

History

History
59 lines (41 loc) · 2.76 KB

README-model-26.rst

File metadata and controls

59 lines (41 loc) · 2.76 KB

Hikaru

Version 1.1.1

travis GitHub license   :target: https://github.com/haxsaw/hikaru/blob/main/LICENSE PyPI - Python Version coverage

Try it: see Hikaru convert your K8s YAML

Release notes

Full documentation at Read the Docs

Hikaru is a collection of tools that allow you to work with Kubernetes resources from within Python in a variety of ways:

  • Hikaru provides type-annotated classes that model all of the Kubernetes resources in Python and supports CRUD operations on those classes to manage their lifecycle in your Kubernetes cluster.
  • Hikaru also provides tooling to shift formats for these objects, allowing you to turn K8s YAML into Python objects, JSON, or Python dicts, and vice-versa. It can also generate Python source code for K8s objects loaded from non-Python sources.
  • Hikaru also supports a number of features that aid in the management of your objects such as searching for specific fields or diffing two instances of a K8s resource.
  • Hikaru includes support for creating 'watches' on your objects, providing a means to monitor events on your provisioned K8s resources.
  • Hikaru provides support for creation of CRDs which support all the above features such as CRUD operations and watches.
  • Finally, Hikaru includes a facility to specify a collection of resources as an 'application', similar in spirit to a Helm chart, and provides the same CRUD, watch, and management capabilities on the entire application as it does on single resource objects (full format shifting support to come).

This package supports resources from the Kubernetes Python client version 26.x. It depends on the hikaru-core package which will be installed automatically when this packages is installed. This package will work with any version of the Kubernetes Python client >= 26.x; if you need to constrain which release is installed then you should establish your own requirement limts on the Kubernetes Python client package.

See README-core.rst for the main README and links to overall documentation.

About

Hikaru is Mr. Sulu’s first name, a famed fictional helmsman.