Exceptions#

Here is a list of Ignis exceptions. They may be raised by various components in the case of an error.

To access them, use the ignis.exceptions module.

from ignis.exceptions import SomeException
exception ignis.exceptions.WindowNotFoundError(window_name: str, *args) None#

Raised when a window is not found.

Parameters:

window_name (str) -- The name of the window.

property window_name: str#

The name of the window.

exception ignis.exceptions.WindowAddedError(window_name: str, *args) None#

Raised when a window is already added to the application.

Parameters:

window_name (str) -- The name of the window.

property window_name: str#

The name of the window.

exception ignis.exceptions.GvcNotFoundError(*args) None#

Raised when Gvc is not found.

exception ignis.exceptions.HyprlandIPCNotFoundError(*args: object) None#

Raised when Hyprland IPC is not found.

exception ignis.exceptions.NiriIPCNotFoundError(*args: object) None#

Raised when Niri IPC is not found.

exception ignis.exceptions.NetworkManagerNotFoundError(*args: object) None#

Raised when NetworkManager is not found.

exception ignis.exceptions.GstNotFoundError(*args: object) None#

Raised when GStreamer is not found.

exception ignis.exceptions.GstPluginNotFoundError(plugin_name: str, plugin_package: str, *args) None#

Raised when a GStreamer plugin is not found.

Parameters:
  • plugin_name (str) -- The name of the plugin.

  • plugin_package (str) -- The package name of the plugin.

property plugin_name: str#

The name of the plugin.

property plugin_package: str#

The package name of the plugin.

exception ignis.exceptions.SassCompilationError(stderr: str, *args: object) None#

Raised when the Sass compilation fails.

Parameters:

stderr (str) -- The stderr output from the Sass compiler.

property stderr: str#

The stderr output from the Sass compiler.

exception ignis.exceptions.SassNotFoundError(*args: object) None#

Raised when a compatible Sass compiler is not found.

exception ignis.exceptions.MonitorNotFoundError(monitor_id: int, *args: object) None#

Raised when a monitor with the given ID is not found.

Parameters:

monitor_id (int) -- The ID of the monitor.

property monitor_id: int#

The ID of the monitor.

exception ignis.exceptions.LayerShellNotSupportedError(*args: object) None#

Raised when the Layer Shell protocol is not supported.

exception ignis.exceptions.IgnisNotRunningError(*args: object) None#

Raised when Ignis is not running.

exception ignis.exceptions.DBusMethodNotFoundError(method_name: str, *args: object) None#

Raised when a D-Bus method is not found or not registered.

Parameters:

method_name (str) -- The name of the D-Bus method.

property method_name: str#

The name of the D-Bus method.

exception ignis.exceptions.DBusPropertyNotFoundError(property_name: str, *args: object) None#

Raised when a D-Bus property is not found or not registered.

Parameters:

property_name (str) -- The name of the D-Bus property.

property property_name: str#

The name of the D-Bus property.

exception ignis.exceptions.DisplayNotFoundError(*args: object) None#

Raised when the display is not found (e.g., a Wayland compositor is not running).

exception ignis.exceptions.StylePathNotFoundError(style_path: str, *args: object) None#

Raised when the style path is not found / not applied to the application.

Parameters:

style_path (str) -- Path to the .css/.scss/.sass file.

property style_path: str#

Path to the .css/.scss/.sass file.

exception ignis.exceptions.StylePathAppliedError(style_path: str, *args: object) None#

Raised when the style path is already applied to the application.

Parameters:

style_path (str) -- Path to the .css/.scss/.sass file.

property style_path: str#

Path to the .css/.scss/.sass file.

exception ignis.exceptions.Gtk4LayerShellNotFoundError(*args: object) None#

Raised when GTK4 Layer Shell is not found.

exception ignis.exceptions.CssParsingError(section: gi.repository.Gtk.CssSection, gerror: gi.repository.GLib.Error, *args: object) None#

Raised when a CSS parsing error occurs.

Parameters:
  • section (CssSection) -- The section the error happened in.

  • gerror (Error) -- The parsing error.

property section: gi.repository.Gtk.CssSection#

The section the error happened in.

property gerror: gi.repository.GLib.Error#

The parsing error.

exception ignis.exceptions.AnotherNotificationDaemonRunningError(name: str, *args: object) None#

Raised when another notification daemon is running.

Parameters:

name (str) -- The name of the currenly running notification daemon.

property name: str#

The name of the currenly running notification daemon.

exception ignis.exceptions.AnotherSystemTrayRunningError(name: str, *args: object) None#

Raised when another system tray is running.

Parameters:

name (str) -- The name of the currenly running notification daemon.

property name: str#

The name of the currenly running system tray.

exception ignis.exceptions.UPowerNotRunningError(*args: object) None#

Raised when UPower is not running.

exception ignis.exceptions.GnomeBluetoothNotFoundError(*args: object) None#

Raised when GnomeBluetooth-3.0 is not found.