Skip to main content

A custom Powerline segment for displaying the current state of Podman containers

Project description

powerline-podman-social-preview

PyPI PyPI - Python Version

A custom Powerline segment for displaying the current state of Podman containers. Inspired by powerline-docker.

powerline-podman

This segment also requires the Podman REST API service to be running:

podman system service -t 0 &

See Podman docs for more details.

Installation

Using uv

uv pip install powerline-podman

Using pip

pip install powerline-podman

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.

{
  "podman":         { "fg": "gray8",           "bg": "darkestpurple", "attrs": [] },
  "podman_created": { "fg": "yellow",          "bg": "darkestpurple", "attrs": [] },
  "podman_exited":  { "fg": "brightred",       "bg": "darkestpurple", "attrs": [] },
  "podman_paused":  { "fg": "brightestorange", "bg": "darkestpurple", "attrs": [] },
  "podman_running": { "fg": "green",           "bg": "darkestpurple", "attrs": [] },
  "podman_unknown": { "fg": "gray10",          "bg": "darkestpurple", "attrs": [] },
  "podman:divider": { "fg": "gray4",           "bg": "darkestpurple", "attrs": [] } 
}

Segment

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

The segment tries to connect to the libpod service at unix:///run/user/1000/podman.sock, which is where it lives on most Unix systems. You can change the URI with the uri argument.

Additionally, you can hide containers with specific states e.g. don't show exited containers by adding it to the ignore_states argument list. The valid states are created, exited, paused, running, and unknown.

{
  "function": "powerline_podman.podman",
  "priority": 30,
  "args": {
    "uri": "unix:///run/user/1000/podman.sock",
    "ignore_states": ["exited", "paused"]
  }
}
  • 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.

Project details


Download files

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

Source Distribution

powerline_podman-1.0.4.tar.gz (14.9 kB view details)

Uploaded Source

Built Distribution

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

powerline_podman-1.0.4-py3-none-any.whl (4.5 kB view details)

Uploaded Python 3

File details

Details for the file powerline_podman-1.0.4.tar.gz.

File metadata

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

File hashes

Hashes for powerline_podman-1.0.4.tar.gz
Algorithm Hash digest
SHA256 053fb12684f7922d5e3879857c1537becaf6f1d6c180532decc672dae270a0e8
MD5 b48035749611dc80bc63ddbe194b0e86
BLAKE2b-256 7b385ca3b6c9acb1b149973ef09ce6eab66b512e6b751d1485254c761c7461e8

See more details on using hashes here.

Provenance

The following attestation bundles were made for powerline_podman-1.0.4.tar.gz:

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

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_podman-1.0.4-py3-none-any.whl.

File metadata

File hashes

Hashes for powerline_podman-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 1bc5cbc2b68506952bf8cd34990db3347ff5e908a5008c22c2ec059155d8c10f
MD5 f605b1ee80c26d10c288b22ae2f2034c
BLAKE2b-256 d240b245a4fb357c733820625b6bd61a39e463daebaf6c42fdb9b9e906944be9

See more details on using hashes here.

Provenance

The following attestation bundles were made for powerline_podman-1.0.4-py3-none-any.whl:

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

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