powerline-podman


Namepowerline-podman JSON
Version 1.0.3 PyPI version JSON
download
home_pagehttps://github.com/j4ckofalltrades/powerline-podman
SummaryA custom Powerline segment for displaying the current state of Podman containers
upload_time2024-01-10 14:30:52
maintainer
docs_urlNone
authorJordan Duabe
requires_python>=3.9,<4.0
licenseMIT
keywords powerline podman
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ![powerline-podman-social-preview](https://res.cloudinary.com/j4ckofalltrades/image/upload/v1697278938/foss/gh-social-icons/powerline-podman_ubesku.png)

[![PyPI](https://img.shields.io/pypi/v/powerline-podman)](https://pypi.org/project/powerline-podman/)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/powerline-podman)

A custom [Powerline](https://github.com/powerline/powerline) segment for displaying the current state of Podman containers. Inspired by [powerline-docker](https://github.com/adrianmo/powerline-docker).

![powerline-podman](https://res.cloudinary.com/j4ckofalltrades/image/upload/v1680430170/foss/powerline-podman_v4mbms.png)

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

`podman system service -t 0 &`

See [Podman docs](https://docs.podman.io/en/latest/_static/api.html) for more details.

## Installation

### 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](https://powerline.readthedocs.io/en/master/configuration/reference.html#colorschemes) for more info.

```json
{
  "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](https://powerline.readthedocs.io/en/master/configuration/segments.html#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`.

```json
{
  "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`.


            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/j4ckofalltrades/powerline-podman",
    "name": "powerline-podman",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.9,<4.0",
    "maintainer_email": "",
    "keywords": "powerline,podman",
    "author": "Jordan Duabe",
    "author_email": "me@jduabe.dev",
    "download_url": "https://files.pythonhosted.org/packages/32/78/579f41ba87b36c85209698493d97fd6c968d2d9e4c0b8506e6cb8285d45b/powerline_podman-1.0.3.tar.gz",
    "platform": null,
    "description": "![powerline-podman-social-preview](https://res.cloudinary.com/j4ckofalltrades/image/upload/v1697278938/foss/gh-social-icons/powerline-podman_ubesku.png)\n\n[![PyPI](https://img.shields.io/pypi/v/powerline-podman)](https://pypi.org/project/powerline-podman/)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/powerline-podman)\n\nA custom [Powerline](https://github.com/powerline/powerline) segment for displaying the current state of Podman containers. Inspired by [powerline-docker](https://github.com/adrianmo/powerline-docker).\n\n![powerline-podman](https://res.cloudinary.com/j4ckofalltrades/image/upload/v1680430170/foss/powerline-podman_v4mbms.png)\n\nThis segment also requires the Podman REST API service to be running:\n\n`podman system service -t 0 &`\n\nSee [Podman docs](https://docs.podman.io/en/latest/_static/api.html) for more details.\n\n## Installation\n\n### Using pip\n\n`$ pip install powerline-podman`\n\n## Configuration\n\n### Colorscheme\n\nAdd the following config items to your Powerline colorscheme config file (usually located at `~/.config/powerline/colorschemes/`),\nsee [Powerline Colorschemes](https://powerline.readthedocs.io/en/master/configuration/reference.html#colorschemes) for more info.\n\n```json\n{\n  \"podman\":         { \"fg\": \"gray8\",           \"bg\": \"darkestpurple\", \"attrs\": [] },\n  \"podman_created\": { \"fg\": \"yellow\",          \"bg\": \"darkestpurple\", \"attrs\": [] },\n  \"podman_exited\":  { \"fg\": \"brightred\",       \"bg\": \"darkestpurple\", \"attrs\": [] },\n  \"podman_paused\":  { \"fg\": \"brightestorange\", \"bg\": \"darkestpurple\", \"attrs\": [] },\n  \"podman_running\": { \"fg\": \"green\",           \"bg\": \"darkestpurple\", \"attrs\": [] },\n  \"podman_unknown\": { \"fg\": \"gray10\",          \"bg\": \"darkestpurple\", \"attrs\": [] },\n  \"podman:divider\": { \"fg\": \"gray4\",           \"bg\": \"darkestpurple\", \"attrs\": [] } \n}\n```\n\n### Segment\n\nAdd the following config item to your Powerline segments config file,\nsee [Powerline Segment reference](https://powerline.readthedocs.io/en/master/configuration/segments.html#segment-reference) for more info.\n\nThe 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.\n\nAdditionally, you can hide containers with specific states e.g. don't show `exited` containers by adding it to the `ignore_states` argument list.\nThe valid states are `created`, `exited`, `paused`, `running`, and `unknown`.\n\n```json\n{\n  \"function\": \"powerline_podman.podman\",\n  \"priority\": 30,\n  \"args\": {\n    \"uri\": \"unix:///run/user/1000/podman.sock\",\n    \"ignore_states\": [\"exited\", \"paused\"]\n  }\n}\n```\n\n- If adding the segment to the shell, edit `~/.config/powerline/themes/shell/default.json`.\n- If adding the segment to the tmux status line, edit `~/.config/powerline/themes/tmux/default.json`.\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A custom Powerline segment for displaying the current state of Podman containers",
    "version": "1.0.3",
    "project_urls": {
        "Bug Tracker": "https://github.com/j4ckofalltrades/powerline-podman/issues",
        "Homepage": "https://github.com/j4ckofalltrades/powerline-podman",
        "Repository": "https://github.com/j4ckofalltrades/powerline-podman"
    },
    "split_keywords": [
        "powerline",
        "podman"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "df8c9f8935d63811320ef405595b1250d7420c7368fc617eac81fd06b46f5128",
                "md5": "1036eaa53a03bf29de395d6d505e434e",
                "sha256": "1ee1b936b24c6a4bb6e84a5160033801368966509a78e4d36c3e7effb6579c1f"
            },
            "downloads": -1,
            "filename": "powerline_podman-1.0.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1036eaa53a03bf29de395d6d505e434e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9,<4.0",
            "size": 4555,
            "upload_time": "2024-01-10T14:30:51",
            "upload_time_iso_8601": "2024-01-10T14:30:51.627759Z",
            "url": "https://files.pythonhosted.org/packages/df/8c/9f8935d63811320ef405595b1250d7420c7368fc617eac81fd06b46f5128/powerline_podman-1.0.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3278579f41ba87b36c85209698493d97fd6c968d2d9e4c0b8506e6cb8285d45b",
                "md5": "dc44dd9d887e0c99e656cd92adc155f9",
                "sha256": "ebc554a66bea67b711ce0b8a12644f6165be3fa8d5141d54ef92e2947afde4ae"
            },
            "downloads": -1,
            "filename": "powerline_podman-1.0.3.tar.gz",
            "has_sig": false,
            "md5_digest": "dc44dd9d887e0c99e656cd92adc155f9",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9,<4.0",
            "size": 3739,
            "upload_time": "2024-01-10T14:30:52",
            "upload_time_iso_8601": "2024-01-10T14:30:52.694275Z",
            "url": "https://files.pythonhosted.org/packages/32/78/579f41ba87b36c85209698493d97fd6c968d2d9e4c0b8506e6cb8285d45b/powerline_podman-1.0.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-10 14:30:52",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "j4ckofalltrades",
    "github_project": "powerline-podman",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "powerline-podman"
}
        
Elapsed time: 0.16278s