i3pyblocks.utils
Module Contents
Functions
|
Helper to generate Pango markup for text. |
|
DEPRECATED - Please use asyncio.run instead. |
- i3pyblocks.utils.pango_markup(text: str, tag: str = 'span', **attrib) str
Helper to generate Pango markup for text.
This helper makes it easier to generate Pango markup for arbitrary text, allowing for greater customization of text than the default attributes offered by i3bar protocol.
Simple usage:
>>> pango_markup("Hello, world!", font_weight="bold") '<span font_weight="bold">Hello, world!</span>'
It can also generate markups for other tags supported in Pango:
>>> pango_markup("Italic text", tag="i") '<i>Italic text</i>'
Keep in mind that there is no checks if your code is correct, so you can pass completely nonsense attributes/tags that will be ignored by Pango:
>>> pango_markup("Spam", foo="bar") '<span foo="bar">Spam</span>'
- Parameters
text – Text to be put inside the tag.
tag – XML tag that will be generated. By default it is
<span>.**attrib – Arbitrary attributes that will be added to tag.
See also
Look at https://developer.gnome.org/pango/stable/pango-Markup.html for information about the available tags and attributes.
- i3pyblocks.utils.asyncio_run(awaitable: Awaitable, *, debug: bool = False) Any
DEPRECATED - Please use asyncio.run instead.
