hspylib-clitt 0.9.27__tar.gz → 0.9.29__tar.gz

{hspylib-clitt-0.9.27/hspylib_clitt.egg-info → hspylib-clitt-0.9.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hspylib-clitt
-Version: 0.9.27
+Version: 0.9.29
 Summary: HsPyLib - CLI Terminal Tools
 Home-page: https://github.com/yorevs/hspylib
 Author: Hugo Saporetti Junior
@@ -30,7 +30,7 @@ Description-Content-Type: text/markdown
 ## Create professional CLI applications
 
 [![License](https://badgen.net/badge/license/MIT/gray)](LICENSE.md)
-[![Release](https://badgen.net/badge/release/v0.9.27/gray)](CHANGELOG.md#unreleased)
+[![Release](https://badgen.net/badge/release/v0.9.29/gray)](CHANGELOG.md#unreleased)
 [![PyPi](https://badgen.net/badge/icon/python?icon=pypi&label)](https://pypi.org/project/hspylib-cfman)
 [![GitHub](https://badgen.net/badge/icon/github?icon=github&label)](https://github.com/yorevs/hspylib)
 [![Gitter](https://badgen.net/badge/icon/gitter?icon=gitter&label)](https://gitter.im/hspylib/community)

{hspylib-clitt-0.9.27 → hspylib-clitt-0.9.29}/README.md

@@ -3,7 +3,7 @@
 ## Create professional CLI applications
 
 [![License](https://badgen.net/badge/license/MIT/gray)](LICENSE.md)
-[![Release](https://badgen.net/badge/release/v0.9.27/gray)](CHANGELOG.md#unreleased)
+[![Release](https://badgen.net/badge/release/v0.9.29/gray)](CHANGELOG.md#unreleased)
 [![PyPi](https://badgen.net/badge/icon/python?icon=pypi&label)](https://pypi.org/project/hspylib-cfman)
 [![GitHub](https://badgen.net/badge/icon/github?icon=github&label)](https://github.com/yorevs/hspylib)
 [![Gitter](https://badgen.net/badge/icon/gitter?icon=gitter&label)](https://gitter.im/hspylib/community)

hspylib-clitt-0.9.29/clitt/.version

@@ -0,0 +1 @@
+0.9.29

{hspylib-clitt-0.9.27 → hspylib-clitt-0.9.29}/clitt/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.27
+# hspylib-clitt v0.9.29
 #
 # Package: main.clitt
 """Package initialization."""
@@ -9,4 +9,4 @@ __all__ = [
   'addons', 
   'core'
 ]
-__version__ = '0.9.27'
+__version__ = '0.9.29'

{hspylib-clitt-0.9.27 → hspylib-clitt-0.9.29}/clitt/__main__.py

@@ -12,19 +12,23 @@
 
    Copyright 2023, HsPyLib team
 """
-from clitt.__classpath__ import _Classpath
-from clitt.addons.appman.appman import AppManager
-from clitt.addons.appman.appman_enums import AppExtension, AppType
-from clitt.addons.widman.widman import WidgetManager
-from clitt.core.tui.tui_application import TUIApplication
+import sys
+
 from hspylib.core.enums.charset import Charset
 from hspylib.core.enums.enumeration import Enumeration
 from hspylib.core.tools.commons import run_dir, syserr
 from hspylib.core.tools.text_tools import strip_linebreaks
 from hspylib.modules.application.exit_status import ExitStatus
+from hspylib.modules.application.parser_action import ParserAction
 from hspylib.modules.application.version import Version
 
-import sys
+from clitt.__classpath__ import _Classpath
+from clitt.addons.appman.appman import AppManager
+from clitt.addons.appman.appman_enums import AppExtension, AppType
+from clitt.addons.setman.setman import SetMan
+from clitt.addons.setman.setman_enums import SetmanOps, SettingsType
+from clitt.addons.widman.widman import WidgetManager
+from clitt.core.tui.tui_application import TUIApplication
 
 
 class Main(TUIApplication):
@@ -42,6 +46,7 @@ class Main(TUIApplication):
         # fmt: off
         APPMAN      = 'appman'
         WIDGETS     = 'widgets'
+        SETMAN      = 'setman'
         # fmt: on
 
         @property
@@ -65,19 +70,15 @@ class Main(TUIApplication):
                     'the destination directory. If omitted, the current directory will be used.',
                     nargs='?', default=self._run_dir) \
                 .add_parameter(
-                    'app-name',
-                    'the application name', nargs='?') \
+                    'app-name', 'the application name', nargs='?') \
                 .add_parameter(
                     'app-type',
                     'the application type. Appman is going to scaffold a basic application based on the app type',
-                    choices=[
-                        AppType.APP.value, AppType.QT_APP.value, AppType.WIDGET.value
-                    ], nargs='?') \
+                    choices=AppType.choices(), nargs='?') \
                 .add_parameter(
                     'app-ext',
                     '"gradle" is going to initialize you project with gradle (requires gradle). '
-                    '"git" is going to initialize a git repository (requires git)',
-                    nargs='*') \
+                    '"git" is going to initialize a git repository (requires git)', nargs='*') \
             .argument(self.Addon.WIDGETS.val, 'app Widgets Manager: Execute an HsPyLib widget') \
                 .add_parameter(
                     'widget-name',
@@ -85,8 +86,26 @@ class Main(TUIApplication):
                     'presented in a dashboard',
                     nargs='?') \
                 .add_parameter(
-                    'widget-args', "the widget's arguments (if applicable)",
-                    nargs='*')  # fmt: on
+                    'widget-args', "the widget's arguments (if applicable)", nargs='*') \
+            .argument(self.Addon.SETMAN.val, 'app Settings Manager: Manage your terminal settings') \
+                .add_parameter(
+                    'operation',
+                    'the operation to be performed against your settings. ',
+                    choices=SetmanOps.choices()) \
+                .add_option(
+                    'name', 'n', 'name',
+                    'the settings name. ', nargs='?') \
+                .add_option(
+                    'value', 'v', 'value',
+                    'the settings value. ', nargs='?') \
+                .add_option(
+                    'stype', 't', 'type',
+                    'the settings type. ',
+                    choices=SettingsType.choices()) \
+                .add_option(
+                    'simple', 's', 'simple',
+                    'display without formatting. ', action=ParserAction.STORE_TRUE) \
+            # fmt: on
 
     def _main(self, *params, **kwargs) -> ExitStatus:
         """Main entry point handler."""
@@ -100,6 +119,8 @@ class Main(TUIApplication):
             self.start_appman()
         elif app == self.Addon.WIDGETS.val:
             self.start_widman()
+        elif app == self.Addon.SETMAN.val:
+            self.start_setman()
         else:
             syserr(f"### Invalid Addon application: {app}")
             self.usage(ExitStatus.FAILED)
@@ -138,6 +159,16 @@ class Main(TUIApplication):
                     app_ext.append(AppExtension.GIT)
                 addon.create(args.app_name, AppType.of_value(args.app_type), list(app_ext), args.dest_dir or run_dir())
 
+    def start_setman(self) -> None:
+        """Start the Setman application."""
+        addon = SetMan(self)
+        op = SetmanOps.of_value(self.get_arg("operation"), ignore_case=True)
+        name = self.get_arg("name")
+        value = self.get_arg("value")
+        stype = self.get_arg("stype")
+        simple_fmt: bool = bool(self.get_arg("simple"))
+        addon.execute(op, name, value, SettingsType.of_value(stype) if stype else None, simple_fmt)
+
 
 # Application entry point
 if __name__ == "__main__":

{hspylib-clitt-0.9.27 → hspylib-clitt-0.9.29}/clitt/addons/__init__.py

@@ -1,12 +1,13 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.27
+# hspylib-clitt v0.9.29
 #
 # Package: main.clitt.addons
 """Package initialization."""
 
 __all__ = [
   'appman', 
+  'setman', 
   'widman'
 ]
-__version__ = '0.9.27'
+__version__ = '0.9.29'

{hspylib-clitt-0.9.27 → hspylib-clitt-0.9.29}/clitt/addons/appman/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.27
+# hspylib-clitt v0.9.29
 #
 # Package: main.clitt.addons.appman
 """Package initialization."""
@@ -10,4 +10,4 @@ __all__ = [
   'appman_enums', 
   'templates'
 ]
-__version__ = '0.9.27'
+__version__ = '0.9.29'

{hspylib-clitt-0.9.27 → hspylib-clitt-0.9.29}/clitt/addons/appman/appman.py

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 
 """
-   @project: HsPyLib
+   @project: HsPyLib-Clitt
    @package: clitt.addons.appman
       @file: appman.py
    @created: Tue, 4 May 2021

{hspylib-clitt-0.9.27 → hspylib-clitt-0.9.29}/clitt/addons/appman/appman_enums.py

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 
 """
-   @project: HsPyLib
+   @project: HsPyLib-Clitt
    @package: clitt.addons.appman
       @file: appman_enums.py
    @created: Fri, 29 Jul 2022
@@ -12,6 +12,7 @@
 
    Copyright 2023, HsPyLib team
 """
+from typing import List
 
 from hspylib.core.enums.enumeration import Enumeration
 
@@ -33,3 +34,7 @@ class AppType(Enumeration):
     QT_APP  = 'qt-app'
     WIDGET  = 'widget'
     # fmt: on
+
+    @staticmethod
+    def choices() -> List[str]:
+        return AppType.values()

{hspylib-clitt-0.9.27 → hspylib-clitt-0.9.29}/clitt/addons/appman/templates/__init__.py

@@ -1,6 +1,6 @@
 # _*_ coding: utf-8 _*_
 #
-# hspylib-clitt v0.9.27
+# hspylib-clitt v0.9.29
 #
 # Package: main.clitt.addons.appman.templates
 """Package initialization."""
@@ -8,4 +8,4 @@
 __all__ = [
   
 ]
-__version__ = '0.9.27'
+__version__ = '0.9.29'

hspylib-clitt-0.9.29/clitt/addons/setman/__init__.py

@@ -0,0 +1,16 @@
+# _*_ coding: utf-8 _*_
+#
+# hspylib-clitt v0.9.29
+#
+# Package: main.clitt.addons.setman
+"""Package initialization."""
+
+__all__ = [
+  'setman', 
+  'setman_config', 
+  'setman_entry', 
+  'setman_enums', 
+  'setman_repository', 
+  'setman_service'
+]
+__version__ = '0.9.29'

hspylib-clitt-0.9.29/clitt/addons/setman/setman.py

@@ -0,0 +1,203 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib
+   @package: clitt.addons.setman
+      @file: setman.py
+   @created: Fri, 29 May 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 2023, HsPyLib team
+"""
+import atexit
+import binascii
+import contextlib
+import logging as log
+import os
+import uuid
+from typing import Any
+
+from datasource.identity import Identity
+from hspylib.core.enums.charset import Charset
+from hspylib.core.exception.exceptions import ApplicationError
+from hspylib.core.metaclass.singleton import Singleton
+from hspylib.core.tools.commons import file_is_not_empty, safe_delete_file, syserr, sysout, touch_file
+from hspylib.modules.application.application import Application
+from hspylib.modules.security.security import decode_file, encode_file
+
+from clitt.addons.setman.setman_config import SetmanConfig
+from clitt.addons.setman.setman_entry import SetmanEntry
+from clitt.addons.setman.setman_enums import SetmanOps, SettingsType
+from clitt.addons.setman.setman_service import SetmanService
+from clitt.core.tui.table.table_renderer import TableRenderer
+
+
+class SetMan(metaclass=Singleton):
+
+    RESOURCE_DIR = os.environ.get('HHS_DIR', os.environ.get('HOME', '~/'))
+
+    SETMAN_CONFIG_FILE = f"setman.properties"
+
+    SETMAN_DB_FILE = f"{RESOURCE_DIR}/.setman-db"
+
+    def __init__(self, parent_app: Application) -> None:
+        self._parent_app = parent_app
+        cfg_file = f"{self.RESOURCE_DIR}/{self.SETMAN_CONFIG_FILE}"
+        if not file_is_not_empty(cfg_file):
+            self._setup_db(cfg_file)
+        self._configs = SetmanConfig(self.RESOURCE_DIR, self.SETMAN_CONFIG_FILE)
+        self._service = SetmanService(self.configs)
+        if not file_is_not_empty(self.configs.database):
+            self._create_new_database()
+        self._is_open = False
+        safe_delete_file(self.configs.encoded_file)
+        safe_delete_file(self.configs.decoded_file)
+
+    def __str__(self):
+        data = set(self._service.list())
+        vault_str = ""
+        for entry in data:
+            vault_str += entry.key
+        return vault_str
+
+    def __repr__(self):
+        return str(self)
+
+    @property
+    def configs(self) -> SetmanConfig:
+        return self._configs
+
+    def execute(
+        self,
+        operation: SetmanOps,
+        name: str | None,
+        value: Any | None,
+        stype: SettingsType = None,
+        simple_fmt: bool = False) -> None:
+
+        """Execute the specified operation."""
+        log.debug(f"{operation} Name: {name or '*'} Value: {value or '-'} SettingsType: {stype or '*'}")
+        atexit.register(self._close_db)
+        with self._open_db():
+            match operation:
+                case SetmanOps.LIST:
+                    self._list_settings()
+                case SetmanOps.SEARCH:
+                    self._search_settings(name or '%', stype, simple_fmt)
+                case SetmanOps.SET:
+                    self._add_setting(name, value, stype)
+                case SetmanOps.GET:
+                    self._get_setting(name, simple_fmt)
+                case SetmanOps.DEL:
+                    self._del_setting(name)
+                case SetmanOps.TRUNCATE:
+                    self._service.truncate_settings_db()
+                    sysout('%EOL%%ORANGE%!!! All system settings have been removed !!!%EOL%')
+
+    @contextlib.contextmanager
+    def _open_db(self) -> None:
+        """Decode and open the SQL lite database file. Return the context to manipulate it."""
+        try:
+            if not self._is_open:
+                self._is_open = True
+                self._decode_db()
+                log.debug("Settings database open")
+            yield self._is_open
+        except (UnicodeDecodeError, binascii.Error) as err:
+            log.error("Failed to open settings file => %s", err)
+            yield None
+        except Exception as err:
+            raise ApplicationError(f"Unable to open settings file => {self.configs.database}", err) from err
+        finally:
+            self._close_db()
+
+    def _close_db(self) -> None:
+        """Encode and open the SQL lite database file. Return the context to manipulate it."""
+        try:
+            if self._is_open:
+                self._is_open = False
+                self._encode_db()
+                log.debug("Settings database closed")
+        except (UnicodeDecodeError, binascii.Error) as err:
+            log.error("Failed to close settings file => %s", err)
+        except Exception as err:
+            raise ApplicationError(f"Unable to close settings file => {self.configs.database}", err) from err
+
+    def _encode_db(self) -> None:
+        """Decode the Base64 encoded database file."""
+        if file_is_not_empty(self.configs.database):
+            encoded = f"{self.configs.database}-encoded"
+            encode_file(self.configs.database, encoded, binary=True)
+            os.rename(encoded, self.configs.database)
+            self._is_open = False
+            log.debug("Settings file is encoded")
+
+    def _decode_db(self) -> None:
+        """Base64 encode the database file."""
+        if file_is_not_empty(self.configs.database):
+            decoded = f"{self.configs.database}-decoded"
+            decode_file(self.configs.database, decoded, binary=True)
+            os.rename(decoded, self.configs.database)
+            self._is_open = True
+            log.debug("Settings file is decoded")
+
+    def _list_settings(self) -> None:
+        """List all database settings using as a formatted table."""
+        headers = ["uuid", "name", "value", "settings type", "modified"]
+        data = list(map(lambda e: e.values, self._service.list()))
+        tr = TableRenderer(headers, data, "Systems Settings")
+        tr.adjust_auto_fit()
+        tr.set_header_alignment(TableRenderer.TextAlignment.CENTER)
+        tr.set_cell_alignment(TableRenderer.TextAlignment.LEFT)
+        tr.render()
+
+    def _search_settings(self, name: str, stype: SettingsType, simple_fmt: bool) -> None:
+        """Display all settings matching the name and settings type."""
+        data = list(map(lambda e: e.to_string(simple_fmt), self._service.search(name, stype)))
+        sysout(os.linesep.join(data))
+
+    def _del_setting(self, name: str) -> None:
+        """Delete the specified setting."""
+        if name:
+            found = self._service.get(name)
+            if found:
+                self._service.remove(found)
+                sysout('%GREEN%Settings deleted: %ORANGE%', found.name)
+            else:
+                syserr('Settings not found: ', name)
+
+    def _get_setting(self, name: str, simple_fmt: bool) -> None:
+        """Get the specified setting."""
+        if name:
+            found = self._service.get(name)
+            if found:
+                sysout(found.to_string(simple_fmt))
+            else:
+                syserr('Settings not found: ', name)
+
+    def _add_setting(self, name: str, value: Any, stype: SettingsType) -> None:
+        """Upsert the specified setting."""
+        found = self._service.get(name)
+        entry = found or SetmanEntry(Identity(SetmanEntry.SetmanId(uuid.uuid4().hex)), name, value, stype)
+        if not name or not value or not stype:
+            entry = SetmanEntry.prompt(entry)
+        if entry:
+            self._service.save(entry)
+            sysout(f"%GREEN%Settings {'added' if not found else 'saved'}: %BLUE%", repr(entry))
+
+    def _create_new_database(self) -> bool:
+        """Create the settings SQLite DB file."""
+        touch_file(self.configs.database)
+        self._service.create_settings_db()
+        log.info('Settings file has been created')
+        self._is_open = True
+        return os.path.exists(self.configs.database)
+
+    def _setup_db(self, filepath: str) -> bool:
+        """Setup SetMan on the system."""
+        with open(filepath, "w+", encoding=Charset.UTF_8.val) as f_configs:
+            f_configs.write(f"hhs.setman.database = {self.SETMAN_DB_FILE} {os.linesep}")
+        return os.path.exists(filepath)

hspylib-clitt-0.9.29/clitt/addons/setman/setman_config.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.addons.setman
+      @file: setman_config.py
+   @created: Mon, 5 Jun 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 2023, HsPyLib team
+"""
+from datasource.db_configuration import DBConfiguration
+
+
+class SetmanConfig(DBConfiguration):
+    """Holds the SetMan configurations."""
+
+    INSTANCE = None
+
+    def __init__(self, resource_dir: str, filename: str):
+        super().__init__(resource_dir, filename)
+        self._database = self["hhs.setman.database"]
+
+    @property
+    def database(self) -> str:
+        """Return the SetMan database name."""
+        return self._database
+
+    @property
+    def encoded_file(self) -> str:
+        return f"{self.database}-encoded"
+
+    @property
+    def decoded_file(self) -> str:
+        return f"{self.database}-decoded"

hspylib-clitt-0.9.29/clitt/addons/setman/setman_entry.py

@@ -0,0 +1,109 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.addons.setman
+      @file: setman_entry.py
+   @created: Mon, 5 Jun 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 2023, HsPyLib team
+"""
+from collections import namedtuple
+from textwrap import dedent
+from typing import Any, Optional, Union
+
+from datasource.crud_entity import CrudEntity
+from datasource.identity import Identity
+from hspylib.core.tools.text_tools import environ_name
+from hspylib.core.zoned_datetime import now
+
+from clitt.addons.setman.setman_enums import SettingsType
+from clitt.core.tui.minput.menu_input import MenuInput
+from clitt.core.tui.minput.minput import minput
+
+
+class SetmanEntry(CrudEntity):
+    """Represents the Setman domain object."""
+
+    SetmanId = namedtuple("SetmanId", ["uuid"])
+
+    # Setman entry display format.
+    _DISPLAY_FORMAT = dedent(
+        """
+    [%BLUE%{}%NC%]:
+            Type: %GREEN%{}%NC%
+           Value: %GREEN%{}%NC%
+        Modified: %GREEN%{}%NC%
+    """
+    )
+
+    # Setman entry simple format.
+    _SIMPLE_FORMAT = "{}={}"
+
+    @staticmethod
+    def prompt(entry: Union["SetmanEntry", None] = None) -> Optional["SetmanEntry"]:
+        """Create a vault entry from a form input."""
+
+        entry = entry or SetmanEntry()
+        # fmt: off
+        form_fields = MenuInput.builder() \
+            .field() \
+                .label('Name') \
+                .min_max_length(1, 60) \
+                .value(entry.name) \
+                .build() \
+            .field() \
+                .label('Value') \
+                .min_max_length(1, 60) \
+                .value(entry.value) \
+                .build() \
+            .field() \
+                .label('Type') \
+                .itype('select') \
+                .dest('stype') \
+                .value(SettingsType.selectables(entry.stype) if entry.stype else None) \
+                .build() \
+            .build()
+        # fmt: on
+
+        if result := minput(form_fields, "Please fill the settings details"):
+            entry.name = result.name
+            entry.value = result.value
+            entry.stype = result.stype
+            entry.modified = now()
+
+        return entry if result else None
+
+    def __init__(
+        self,
+        entity_id: Identity = SetmanId(Identity.auto().values),
+        name: str = None,
+        value: Any | None = None,
+        stype: SettingsType = None,
+        modified: str = now(),
+    ):
+        super().__init__(entity_id)
+        self.name = name
+        self.value = value
+        self.stype = stype.val if stype else SettingsType.PROPERTY.val
+        self.modified = modified
+
+    def __str__(self) -> str:
+        return str(self.as_dict())
+
+    def __repr__(self) -> str:
+        return str(self)
+
+    def to_string(self, simple: bool = False) -> str:
+        """Return the string representation of this entry.
+        """
+        if simple:
+            return self._SIMPLE_FORMAT.format(environ_name(self.name), self.value) \
+                if self.stype == SettingsType.ENVIRONMENT.val \
+                else self._SIMPLE_FORMAT.format(self.name, self.value)
+        else:
+            return self._DISPLAY_FORMAT.format(self.name, self.stype, self.value, self.modified)

hspylib-clitt-0.9.29/clitt/addons/setman/setman_enums.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+   @project: HsPyLib-Clitt
+   @package: clitt.addons.setman
+      @file: setman_enums.py
+   @created: Fri, 29 May 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 2023, HsPyLib team
+"""
+from typing import List
+
+from hspylib.core.enums.enumeration import Enumeration
+
+
+class SetmanOps(Enumeration):
+    """Setman operations."""
+
+    # fmt: off
+    GET         = 'get'
+    SET         = 'set'
+    DEL         = 'del'
+    LIST        = 'list'
+    SEARCH      = 'search'
+    TRUNCATE    = 'truncate'
+    # fmt: on
+
+    @staticmethod
+    def choices() -> List[str]:
+        return SetmanOps.values()
+
+
+class SettingsType(Enumeration):
+    """Settings types."""
+
+    # fmt: off
+    ENVIRONMENT = 'environment'
+    PROPERTY    = 'property'
+    # fmt: on
+
+    @staticmethod
+    def choices() -> List[str]:
+        return SettingsType.values()
+
+    @staticmethod
+    def selectables(selected: str = None) -> str:
+        return '|'.join([s if not s or s != selected else f"<{s}>" for s in SettingsType.values()])
+
+    @property
+    def val(self) -> str:
+        return str(self.value)