Skip to content

Concepts

This section explains the core design patterns behind Kubex. Read these pages to understand why the library is structured the way it is before diving into the operation and subresource guides.

  • Api[T]

    The generic Api[ResourceType] class, namespace vs cluster scope, the Ellipsis sentinel, and the create_api() factory.

  • Clients

    BaseClient ABC, create_client() auto-detection, and the difference between HttpxClient and AioHttpClient.

  • Configuration

    ClientConfiguration, auto-loading from kubeconfig or in-cluster pod environment, and exec credential providers.

  • Subresources

    The descriptor pattern, marker interfaces (HasLogs, HasExec, …), and how mypy enforces subresource availability at compile time.

  • Exceptions

    The full exception hierarchy from KubexException down to HTTP-specific errors like NotFound and Conflict.