hspylib-clitt 0.9.117__py3-none-any.whl → 0.9.119__py3-none-any.whl

build/lib/build/lib/build/lib/clitt/addons/widman/widman.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.addons.widman
+      @file: widman.py
+   @created: Thu, 20 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.addons.widman.widget import Widget
+from clitt.addons.widman.widget_entry import WidgetEntry
+from clitt.core.tui.mdashboard.dashboard_item import DashboardItem
+from clitt.core.tui.mdashboard.mdashboard import mdashboard
+from hspylib.core.exception.exceptions import WidgetExecutionError, WidgetNotFoundError
+from hspylib.core.metaclass.singleton import Singleton
+from hspylib.core.preconditions import check_state
+from hspylib.core.tools.commons import get_path
+from hspylib.core.tools.text_tools import camelcase
+from hspylib.modules.application.application import Application
+from hspylib.modules.application.exit_status import ExitStatus
+
+import atexit
+import os
+import sys
+
+HERE = get_path(__file__)
+
+
+class WidgetManager(metaclass=Singleton):
+    """HsPyLib widget manager that handles HsPyLib widgets."""
+
+    WIDGETS_PATH = HERE / "widgets"
+
+    @staticmethod
+    def _name_matches(expected_name: str, provided_name: str) -> bool:
+        """Check if two names matches using defined naming rules.
+        :param expected_name the expected widget name.
+        :param provided_name the provided widget name (read from file).
+        """
+
+        return (
+            expected_name.lower() == provided_name.lower()
+            or expected_name == provided_name.capitalize()
+            or expected_name == camelcase(provided_name, capitalized=True)
+            or expected_name.lower() == provided_name.lower().replace("_", "")
+        )
+
+    def __init__(self, parent_app: Application):
+        self._parent_app = parent_app
+        self._widgets = []
+        self._lookup_paths = os.environ.get("HHS_WIDGETS_PATH", "").split(":")
+        self._lookup_paths.insert(0, str(WidgetManager.WIDGETS_PATH))
+        list(map(sys.path.append, self._lookup_paths))
+        check_state(self._search_widgets() > 0, "Unable to find any widgets from: {}", self._lookup_paths)
+
+    def execute(self, widget_name: str, *widget_args) -> None:
+        """Execute the specified widget.
+        :param widget_name the widget name.
+        :param widget_args the arguments to be provided to the widget.
+        """
+
+        widget = self._import_widget(camelcase(widget_name, capitalized=True))
+        try:
+            atexit.register(widget.cleanup)
+            exit_code = widget.execute(*widget_args)
+            if exit_code in [ExitStatus.ERROR, ExitStatus.FAILED]:
+                raise WidgetExecutionError(f"Widget '{widget_name}' failed to execute. exit_code={exit_code}")
+        except Exception as err:
+            raise WidgetExecutionError(f"Unable to execute widget '{widget_name}' -> {err}") from err
+
+    def dashboard(self) -> None:
+        """Display all available widgets from the widget lookup paths on a dashboard."""
+
+        items = []
+        try:
+            for widget_entry in self._widgets:
+                widget = self._import_widget(widget_entry.name)
+                item = DashboardItem(
+                    widget.icon(), f"{widget.name()} v{widget.version()}: {widget.tooltip()}", widget.execute
+                )
+                items.append(item)
+            check_state(len(items) > 0, "No widgets found from: {}", str(self._lookup_paths))
+            mdashboard(items, "Please select a widget to execute")
+        except Exception as err:
+            raise WidgetExecutionError(f"Failed to execute widget :: {str(err)}") from err
+
+    # pylint: disable=cell-var-from-loop
+    def _search_widgets(self) -> int:
+        """Search and load all widgets from the widget lookup paths."""
+
+        for path in self._lookup_paths:
+            for root, _, files in os.walk(path):
+                filtered = list(filter(lambda p: p.startswith(WidgetEntry.MODULE_PREFIX) and p.endswith("py"), files))
+                widgets = list(map(lambda w: WidgetEntry(w, f"{root}/{w}"), filtered))
+                self._widgets.extend(widgets)
+
+        return len(self._widgets)
+
+    def _import_widget(self, widget_name: str) -> Widget:
+        """Find, import and return a widget specified by the widget name.
+        :param widget_name the widget name.
+        """
+        widget_entry = next((w for w in self._widgets if self._name_matches(widget_name, w.name)), None)
+        if not widget_entry:
+            raise WidgetNotFoundError(
+                f"Widget '{widget_name}' was not found on widget lookup paths: {str(self._lookup_paths)}"
+            )
+        try:
+            widget_module = __import__(widget_entry.module)
+        except ModuleNotFoundError as err:
+            raise WidgetNotFoundError(
+                f"Widget '{widget_name}' was not found on widget lookup paths: {str(self._lookup_paths)}"
+            ) from err
+        widget_clazz = getattr(widget_module, widget_entry.clazz)
+        widget = widget_clazz()
+        check_state(isinstance(widget, Widget), 'All widgets must inherit from "clitt.addons.widman.Widget"')
+
+        return widget

build/lib/build/lib/build/lib/clitt/core/__init__.py

@@ -0,0 +1,15 @@
+# _*_ coding: utf-8 _*_
+#
+# hspylib-clitt v0.9.119
+#
+# Package: main.build.lib.build.lib.build.lib.build.lib.clitt.core
+"""Package initialization."""
+
+__all__ = [
+    'exception', 
+    'icons', 
+    'preferences', 
+    'term', 
+    'tui'
+]
+__version__ = '0.9.119'

build/lib/build/lib/build/lib/clitt/core/exception/__init__.py

@@ -0,0 +1,11 @@
+# _*_ coding: utf-8 _*_
+#
+# hspylib-clitt v0.9.119
+#
+# Package: main.build.lib.build.lib.build.lib.build.lib.clitt.core.exception
+"""Package initialization."""
+
+__all__ = [
+    'exceptions'
+]
+__version__ = '0.9.119'

build/lib/build/lib/build/lib/clitt/core/exception/exceptions.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib
+   @package: clitt.core.exceptions
+      @file: exceptions.py
+   @created: Fri, 7 Jul 2023
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+
+
+class NotATerminalError(NotImplementedError):
+    """Raised when a TTY terminal is required"""
+

build/lib/build/lib/build/lib/clitt/core/icons/__init__.py

@@ -0,0 +1,12 @@
+# _*_ coding: utf-8 _*_
+#
+# hspylib-clitt v0.9.119
+#
+# Package: main.build.lib.build.lib.build.lib.build.lib.clitt.core.icons
+"""Package initialization."""
+
+__all__ = [
+    'emojis', 
+    'font_awesome'
+]
+__version__ = '0.9.119'

build/lib/build/lib/build/lib/clitt/core/icons/emojis/__init__.py

@@ -0,0 +1,12 @@
+# _*_ coding: utf-8 _*_
+#
+# hspylib-clitt v0.9.119
+#
+# Package: main.build.lib.build.lib.build.lib.build.lib.clitt.core.icons.emojis
+"""Package initialization."""
+
+__all__ = [
+    'emojis', 
+    'face_smiling'
+]
+__version__ = '0.9.119'

build/lib/build/lib/build/lib/clitt/core/icons/emojis/emojis.py

@@ -0,0 +1,41 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.core.icons.emojis
+      @file: emojis.py
+   @created: Tue, 4 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+
+from emoji.core import emojize
+from hspylib.core.enums.enumeration import Enumeration
+from hspylib.core.tools.commons import sysout
+
+
+class Emoji(Enumeration):
+    """
+    Emoji codes
+    Full list of emojis can be found here:
+      - https://unicode.org/emoji/charts/emoji-list.html
+    """
+
+    @staticmethod
+    def emj_print(emoji_str: str, end: str = "") -> None:
+        """Print an emoji
+        :param emoji_str the emoji to be printed.
+        :param end string appended after the last value, default a newline.
+        """
+        sysout(f"{emojize(emoji_str)} ", end=end)
+
+    def __str__(self) -> str:
+        return str(self.value)
+
+    @property
+    def placeholder(self) -> str:
+        return f":{self.name}:"

build/lib/build/lib/build/lib/clitt/core/icons/emojis/face_smiling.py

@@ -0,0 +1,40 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.core.icons.emojis
+      @file: face_smiling.py
+   @created: Tue, 4 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.icons.emojis.emojis import Emoji
+
+
+class FaceSmiling(Emoji):
+    """
+    Face smiling emojis.
+    Codes can be found here:
+    - https://unicode.org/emoji/charts/emoji-list.html#face-smiling
+    """
+
+    # fmt: off
+    _CUSTOM         = ''
+    DEFAULT         = '\U0001F600'      # 😀
+    BEAMING         = '\U0001F601'      # 😁
+    TEARS_OF_JOY    = '\U0001F602'      # 😂
+    BIG_EYES        = '\U0001F603'      # 😃
+    SMILING_EYES    = '\U0001F604'      # 😄
+    SWEAT           = '\U0001F605'      # 😅
+    SQUINTING       = '\U0001F606'      # 😆
+    HALO            = '\U0001F607'      # 😇
+    WINKING         = '\U0001F609'      # 😉
+    BLUSHING        = '\U0001F60A'      # 😊
+    SLIGHTLY        = '\U0001F642'      # 🙂
+    UPSIDE_DOWN     = '\U0001F643'      # 🙃
+    ROFL            = '\U0001F923'      # 🤣
+    # fmt: on

build/lib/build/lib/build/lib/clitt/core/icons/font_awesome/__init__.py

@@ -0,0 +1,18 @@
+# _*_ coding: utf-8 _*_
+#
+# hspylib-clitt v0.9.119
+#
+# Package: main.build.lib.build.lib.build.lib.build.lib.clitt.core.icons.font_awesome
+"""Package initialization."""
+
+__all__ = [
+    'app_icons', 
+    'awesome', 
+    'dashboard_icons', 
+    'form_icons', 
+    'game_icons', 
+    'nav_icons', 
+    'trickplay_icons', 
+    'widget_icons'
+]
+__version__ = '0.9.119'

build/lib/build/lib/build/lib/clitt/core/icons/font_awesome/app_icons.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.core.icons.font_awesome
+      @file: app_icons.py
+   @created: Tue, 4 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.icons.font_awesome.awesome import Awesome
+from enum import auto
+
+
+class AppIcons(Awesome):
+    """
+    Application icons.
+    Codes can be found here:
+    - https://fontawesome.com/cheatsheet?from=io
+    """
+
+    # fmt: off
+    _CUSTOM         = auto()
+    AMAZON          = '\uF270'  # 
+    APPLE           = '\uF179'  # 
+    AWS             = '\uF375'  # 
+    CPLUSPLUS       = '\uF38C'  # 
+    DOCKER          = '\uF308'  # 
+    DROPBOX         = '\uF16B'  # 
+    GIT             = '\uF813'  # 
+    GITHUB          = '\uF408'  # 
+    GOOGLE          = '\uF1A0'  # 
+    GOOGLE_DRIVE    = '\uF3AA'  # 
+    FACEBOOK        = '\uF082'  # 
+    FIREBASE        = '\uF1D0'  # 
+    IE              = '\uF7FF'  # 
+    INSTAGRAM       = '\uF16D'  # 
+    JAVA            = '\uF4E4'  # 
+    LINKED_IN       = '\uF08C'  # 
+    LINUX           = '\uF31A'  # 
+    PAYPAL          = '\uF1ED'  # 
+    PYTHON          = '\uF3E2'  # 
+    STACK_OVERFLOW  = '\uF16C'  # 
+    TWITTER         = '\uF081'  # 
+    UBUNTU          = '\uF31B'  # 
+    VS_CODE         = '\uF3AB'  # 
+    YOUTUBE         = '\uF16A'  # 
+    WHATSAPP        = '\uFAA2'  # 甆
+    WINDOWS         = '\uF17A'  # 
+    ALPINE          = '\uF7F4'  # 
+    # fmt: on

build/lib/build/lib/build/lib/clitt/core/icons/font_awesome/awesome.py

@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.core.icons.font_awesome
+      @file: awesome.py
+   @created: Tue, 4 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+
+from hspylib.core.enums.enumeration import Enumeration
+from hspylib.core.tools.commons import sysout
+from typing import Union
+
+import re
+import struct
+
+
+class Awesome(Enumeration):
+    """
+    Font awesome codes
+    Full list of font awesome icons can be found here:
+      - https://fontawesome.com/cheatsheet?from=io
+    """
+
+    @classmethod
+    def no_icon(cls) -> "Awesome":
+        """No awesome icon specified."""
+
+        def _str(self) -> str:
+            return " "
+
+        def _len(self) -> int:
+            return 1
+
+        def _fmt(self, fmt) -> str:
+            return " "
+
+        no_icon_cls = type("NoIcon", (object,), {"name": "NO_ICON", "value": ""})
+        setattr(no_icon_cls, "__str__", _str)
+        setattr(no_icon_cls, "__len__", _len)
+        setattr(no_icon_cls, "__format__", _fmt)
+        return no_icon_cls()
+
+    @staticmethod
+    def print_unicode(uni_code: Union[str, int], end: str = "") -> None:
+        """Print the specified unicode character.
+        :param uni_code: the unicode to be printed.
+        :param end string appended after the last value, default a newline.
+        """
+        if isinstance(uni_code, str) and re.match(r"^[a-fA-F0-9]{1,4}$", uni_code):
+            hex_val = bytes.decode(struct.pack("!I", int(uni_code.zfill(4), 16)), "utf_32_be")
+            sysout(f"{hex_val:2s}", end=end)
+        elif isinstance(uni_code, int):
+            hex_val = bytes.decode(struct.pack("!I", uni_code), "utf_32_be")
+            sysout(f"{hex_val:2s}", end=end)
+        else:
+            raise TypeError(f"Invalid unicode value: {uni_code}")
+
+    def __str__(self) -> str:
+        return str(self.value)
+
+    def __repr__(self) -> str:
+        return str(self)
+
+    def __len__(self) -> int:
+        return len(str(self.value))
+
+    @property
+    def unicode(self) -> str:
+        return str(self.value)

build/lib/build/lib/build/lib/clitt/core/icons/font_awesome/dashboard_icons.py

@@ -0,0 +1,93 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.core.icons.font_awesome
+      @file: dashboard_icons.py
+   @created: Tue, 4 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.icons.font_awesome.awesome import Awesome
+from enum import auto
+
+
+class DashboardIcons(Awesome):
+    """
+    Dashboard UI icons.
+    Codes can be found here:
+    - https://fontawesome.com/cheatsheet?from=io
+    """
+
+    # fmt: off
+    _CUSTOM         = auto()
+    ADJUSTMENTS     = '\uF1DE'  # 
+    AGENDA          = '\uF073'  # 
+    ALERT           = '\uF071'  # 
+    ARCHIVE         = '\uF01C'  # 
+    BALLOON         = '\uF075'  # 
+    CAMERA          = '\uF030'  # 
+    CHAT            = '\uF78B'  # 
+    CLOUD_DOWNLOAD  = '\uF0ED'  # 
+    CLOUD_UPLOAD    = '\uF0EE'  # 
+    CODE            = '\uFABF'  # 謹
+    COMPASS         = '\uF124'  # 
+    DASHBOARD       = '\uF00A'  # 
+    DATABASE        = '\uF1C0'  # 
+    DELIVERED       = '\uFB3D'  # ﬽
+    DOCUMENT        = '\uF016'  # 
+    DOWNLOAD        = '\uF019'  # 
+    EMAIL           = '\uF003'  # 
+    ERROR           = '\uF06A'  # 
+    EXIT            = '\uF426'  # 
+    EXPORT          = '\uF5F6'  # 
+    FAVORITE        = '\uF02E'  # 
+    FLAG            = '\uF024'  # 
+    FOLDER          = '\uF74A'  # 
+    FOLDER_OPEN     = '\uF07C'  # 
+    FORM            = '\uF233'  # 
+    FORMAT          = '\uF6C8'  # 
+    GRAPHS          = '\uF627'  # 
+    HISTORY         = '\uF017'  # 
+    HOME            = '\uF015'  # 
+    IDENTITY        = '\uF2BB'  # 
+    IMPORT          = '\uF5F9'  # 
+    KILL            = '\uF8C4'  # 
+    LIGHT_ON        = '\uF834'  # 
+    LIGHT_OFF       = '\uF835'  # 
+    LIKE            = '\uF004'  # 
+    LIST            = '\uF03A'  # 
+    LOCATION        = '\uF450'  # 
+    MOBILE          = '\uF61F'  # 
+    MOVIE           = '\uF008'  # 
+    MUSIC           = '\uF3B5'  # 
+    MUTE            = '\uF86C'  # 
+    NOTIFICATION    = '\uF0F3'  # 
+    PICTURE         = '\uF03E'  # 
+    PLAY            = '\uF01D'  # 
+    PLUGIN          = '\uF12E'  # 
+    PLUG_IN         = '\uF1E6'  # 
+    PLUG_OUT        = '\uF492'  # 
+    PLUGGED         = '\uF700'  # 
+    POWER           = '\uF011'  # 
+    PRINTER         = '\uF02F'  # 
+    READ            = '\uF830'  # 
+    SAVE            = '\uF0C7'  # 
+    SEARCH          = '\uF002'  # 
+    SECRET          = '\uF49C'  # 
+    SEND            = '\uF3FE'  # 
+    SENT            = '\uF0FB'  # 
+    SETTINGS        = '\uF013'  # 
+    SHOPPING_CART   = '\uF60F'  # 
+    TERMINAL        = '\uF120'  # 
+    PROMPT          = '\uF054'  # 
+    UN_MUTE         = '\uF86E'  # 
+    UNPLUGGED       = '\uF701'  # 
+    USER            = '\uF007'  # 
+    VERIFIED        = '\uF4A1'  # 
+
+    # fmt: on

build/lib/build/lib/build/lib/clitt/core/icons/font_awesome/form_icons.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.core.icons.font_awesome
+      @file: form_icons.py
+   @created: Tue, 4 May 2021
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.icons.font_awesome.awesome import Awesome
+from enum import auto
+
+
+class FormIcons(Awesome):
+    """
+    Form UI icons.
+    Codes can be found here:
+    - https://fontawesome.com/cheatsheet?from=io
+    """
+
+    # fmt: off
+    _CUSTOM             = auto()
+    ARROW_LEFT          = '\uF060'  # 
+    ARROW_RIGHT         = '\uF061'  # 
+    ARROW_UP            = '\uF062'  # 
+    ARROW_DOWN          = '\uF063'  # 
+    MOVE_ARROWS         = '\uF047'  # 
+    CHECK               = '\uF00C'  # 
+    UNCHECK             = '\uF00D'  # 
+    PLUS_CIRCLE         = '\uF055'  # 
+    MINUS_CIRCLE        = '\uF056'  # 
+    ERROR_CIRCLE        = '\uf057'  # 
+    CHECK_CIRCLE        = '\uF058'  # 
+    QUESTION_CIRCLE     = '\uF059'  # 
+    UNCHECK_CIRCLE      = '\uF111'  # 
+    CHECK_SQUARE        = '\uF14A'  # 
+    UNCHECK_SQUARE      = '\uF0C8'  # 
+    ON                  = '\uF205'  # 
+    OFF                 = '\uF204'  # 
+    MARKED              = '\uF634'  # 
+    UNMARKED            = '\uF630'  # 
+    CLEAR               = '\uF5E1'  # 
+    REFRESH             = '\uF01E'  # 
+    FILTER              = '\uF0B0'  # 
+    ATTACH              = '\uF0C6'  # 
+    HIDDEN              = '\uF070'  # 
+    VISIBLE             = '\uF06E'  # 
+    LOCKED              = '\uF023'  # 
+    UNLOCKED            = '\uF09C'  # 
+    EDITABLE            = '\uF044'  # 
+    MASKED              = '\uF0CE'  # 
+    SELECTABLE          = '\uF150'  # 
+    DESELECT            = '\uF657'  # 
+    DELETE              = '\uF014'  # 
+    EDIT                = '\uF040'  # 
+    CUT                 = '\uF68F'  # 
+    PASTE               = '\uF68E'  # 
+    PLUS                = '\uF067'  # 
+    MINUS               = '\uF068'  # 
+    NUMBERS             = '\uF162'  # 
+    LETTERS             = '\uF15D'  # 
+    WORDS               = '\uF161'  # 
+    CUSTOM              = '\uF45E'  # 
+    # fmt: on

build/lib/build/lib/build/lib/clitt/core/icons/font_awesome/game_icons.py

@@ -0,0 +1,59 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.core.icons.font_awesome
+      @file: game_icons.py
+   @created: Thu, 20 Jul 2023
+    @author: <B>H</B>ugo <B>S</B>aporetti <B>J</B>unior"
+      @site: https://github.com/yorevs/hspylib
+   @license: MIT - Please refer to <https://opensource.org/licenses/MIT>
+
+   Copyright·(c)·2024,·HSPyLib
+"""
+from clitt.core.icons.font_awesome.awesome import Awesome
+from enum import auto
+
+
+# @composable
+class GameIcons(Awesome):
+    """
+    Game icons.
+    Codes can be found here:
+    - https://fontawesome.com/cheatsheet?from=io
+    """
+
+    # fmt: off
+    _CUSTOM             = auto()
+    STEAM               = '\uF9D2'  # 戮
+    XBOX                = '\uFAB8'  # 視
+    CUTLERY             = '\uF9A5'  # 殮
+    BALL                = '\uF9B7'  # 醴
+    HOME                = '\uFAF7'  # 﫷
+    FURNITURE           = '\uF9B8'  # 隸
+    AGENT               = '\uFAF8'  # 﫸
+    GAMEPAD             = '\uFAB9'  # 調
+    SWORD               = '\uF9E4'  # 理
+    GUN                 = '\uFC01'  # ﰁ
+    CANDLE              = '\uFAE1'  # 﫡
+    HORSE               = '\uFCC0'  # ﳀ
+    MUSHROOM            = '\uFCDD'  # ﳝ
+    SHOVEL              = '\uFC0E'  # ﰎ
+    BATTLE              = '\uFCFD'  # ﳽ
+    WALK                = '\uFC0C'  # ﰌ
+    WRITE               = '\uFBD1'  # ﯑
+    LOOK                = '\uFBCE'  # ﯎
+    EXAMINE             = '\uF422'  # 
+    CHAT                = '\uF41F'  # 
+    SNOW                = '\uFC15'  # ﰕ
+    HOT                 = '\uF490'  # 
+    DAY                 = '\uFAA7'  # 盛
+    NIGHT               = '\uFA93'  # 望
+    TREE                = '\uF904'  # 滑
+    KEY                 = '\uF80A'  # 
+    OLD_KEY             = '\uF084'  # 
+    SLEEP               = '\uF9B1'  # 鈴
+    LUCK                = '\uFD14'  # ﴔ
+    ANIMAL              = '\uF8E8'  # 
+    # fmt: on