A custom Powerline segment for displaying the current Kubernetes context and namespace

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for j4ckofalltrades from gravatar.com j4ckofalltrades
Meta

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: MIT
    SPDX License Expression
  • Tags kubernetes , powerline
  • Requires: Python >=3.10
  • Provides-Extra: docs , test
Classifiers
Report project as malware

Project description

powerline-k8s

PyPI PyPI_Python_Version License Docs CI codecov

A custom Powerline segment for displaying the current Kubernetes context and namespace.

Installation

Using pip

$ pip install powerline-k8s

Configuration

Colorscheme

Add the following config items to your Powerline colorscheme config file (usually located at ~/.config/powerline/colorschemes/), see Powerline Colorschemes for more info.

{
  "k8s":           { "fg": "solarized:blue", "bg": "solarized:base02", "attrs": [] },
  "k8s_namespace": { "fg": "solarized:red",  "bg": "solarized:base02", "attrs": [] },
  "k8s_context":   { "fg": "solarized:blue", "bg": "solarized:base02", "attrs": [] },
  "k8s:divider":   { "fg": "gray4",          "bg": "solarized:base02", "attrs": [] }
}

Segment

Add the following config item to your Powerline segments config file, see Powerline Segment reference for more info.

{
  "function": "powerline_k8s.k8s",
  "priority": 30
}
  • If adding the segment to the shell, edit ~/.config/powerline/themes/shell/default.json.
  • If adding the segment to the tmux status line, edit ~/.config/powerline/themes/tmux/default.json.

Alternative config location

If your Kubernetes config file is not in the default location ~/.kube/config, you can point to it by setting the value of the $KUBECONFIG environment variable to where your config file is.

Toggle visibility

Toggle entire segment or specific section's visibility with the following environment variables:

  • POWERLINE_K8S_SHOW
  • POWERLINE_K8S_SHOW_NS

Note: Full segment visibility takes precedence over namespace section visibility.

# toggle segment visibility
$ POWERLINE_K8S_SHOW=0 powerline-daemon --replace # hide powerline-k8s segment
$ POWERLINE_K8S_SHOW=1 powerline-daemon --replace # show powerline-k8s segment (default)

# toggle namespace section visibility
$ POWERLINE_K8S_SHOW_NS=0 powerline-daemon --replace # hide namespace section
$ POWERLINE_K8S_SHOW_NS=1 powerline-daemon --replace # show namespace section (default)

Alternatively you can add the following function to your shell for easier toggling:

toggle_powerline_k8s() {
  case "$1" in
    # pass the '-ns' flag to toggle namespace visibility
    "-ns" | "--namespace")
      if [[ "${POWERLINE_K8S_SHOW_NS:-1}" -eq 1 ]]; then
        export POWERLINE_K8S_SHOW_NS=0
      else
        export POWERLINE_K8S_SHOW_NS=1
      fi
    ;;
    *)
      # toggle segment visibility
      if [[ "${POWERLINE_K8S_SHOW:-1}" -eq 1 ]]; then
        export POWERLINE_K8S_SHOW=0
      else
        export POWERLINE_K8S_SHOW=1
      fi
    ;;
  esac
}

Demo

asciicast

Stats

Alt

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for j4ckofalltrades from gravatar.com j4ckofalltrades
Meta

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: MIT
    SPDX License Expression
  • Tags kubernetes , powerline
  • Requires: Python >=3.10
  • Provides-Extra: docs , test
Classifiers

Release history Release notifications | RSS feed

This version

1.5.4

1.5.3

1.5.2

1.5.1

1.5.0

1.4.1

1.4.0

1.3.0

1.2.1

1.2.0

1.1.0

1.0.4

1.0.3

1.0.2

1.0.1

1.0.0

Download files

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

Source Distribution

powerline_k8s-1.5.4.tar.gz (37.4 kB view details)

Uploaded Source

Built Distribution

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

powerline_k8s-1.5.4-py3-none-any.whl (5.0 kB view details)

Uploaded Python 3

File details

Details for the file powerline_k8s-1.5.4.tar.gz.

File metadata

  • Download URL: powerline_k8s-1.5.4.tar.gz
  • Upload date:
  • Size: 37.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for powerline_k8s-1.5.4.tar.gz
Algorithm Hash digest
SHA256 4c491b88f3cb872720e38f5890565f6f1c93f228a51f52174ee486a30417807d
MD5 5c8b3cc7ce902843472fd8b18014cb4d
BLAKE2b-256 00701b9640870220b437c919753a485fb465e3d77325588f057f839ebc9d3bfc

See more details on using hashes here.

Provenance

The following attestation bundles were made for powerline_k8s-1.5.4.tar.gz:

Publisher: pypi-publish.yml on j4ckofalltrades/powerline-k8s

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file powerline_k8s-1.5.4-py3-none-any.whl.

File metadata

  • Download URL: powerline_k8s-1.5.4-py3-none-any.whl
  • Upload date:
  • Size: 5.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for powerline_k8s-1.5.4-py3-none-any.whl
Algorithm Hash digest
SHA256 1db3fb31e029b68643fd939a61ec62baf7314f4eb316a3dd6eebf2317f305634
MD5 ca6a554f9355c105fbf393497e5e4fb3
BLAKE2b-256 f65bfed883f1f2dca7f4a11990c7ecb8ba552dde6ac79066b8196ef67b75ca24

See more details on using hashes here.

Provenance

The following attestation bundles were made for powerline_k8s-1.5.4-py3-none-any.whl:

Publisher: pypi-publish.yml on j4ckofalltrades/powerline-k8s

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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