micrOSDevToolKit 2.22.0__tar.gz → 2.22.4__tar.gz

{microsdevtoolkit-2.22.0/micrOSDevToolKit.egg-info → microsdevtoolkit-2.22.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: micrOSDevToolKit
-Version: 2.22.0
+Version: 2.22.4
 Summary: Development and deployment environment for micrOS, the diy micropython automation OS (IoT)
 Home-page: https://github.com/BxNxM/micrOS
 Author: Marcell Ban
@@ -86,14 +86,15 @@ Access rest api over browser: `http://<nodename>.local`
 ## ◉ Shortcuts:
 1. 📲 micrOS Client Application [link](https://github.com/BxNxM/micrOS/#micros-client-application)
 2. micrOS Installer [link](https://github.com/BxNxM/micrOS/#installing-micros-with-devtoolkit-esp32-and-more)
-3. micrOS Tutorials [link](https://github.com/BxNxM/micrOS/#micros-video-tutorials)
+3. ▶️ micrOS Tutorials [link](https://github.com/BxNxM/micrOS/#micros-video-tutorials)
 4. micrOS System and features [link](https://github.com/BxNxM/micrOS/#micros-framework-features)
 5. 🎮 Built-in app modules: [link](https://htmlpreview.github.io/?https://github.com/BxNxM/micrOS/blob/master/micrOS/client/sfuncman/sfuncman.html)
 5. Pin mapping - GPIO [link](https://github.com/BxNxM/micrOS/#device-pinouts-for-wiring)
-6. micrOS Node configuration [link](https://github.com/BxNxM/micrOS/#micros-node-configuration-parameters-with-description)
+6. ⚙️ micrOS Node configuration [link](https://github.com/BxNxM/micrOS/#micros-node-configuration-parameters-with-description)
 7. 🧑‍💻 micrOS create custom Load Modules: [link](./APPLICATION_GUIDE.md)
-8. micrOS Gateway server with Prometheus&Grafana: [link](https://github.com/BxNxM/micrOS/#micros-gateway-in-docker)
-9. Release notes: [release-note](https://github.com/BxNxM/micrOS/#release-note)
+8. 📦 micrOS Package Management: [link](https://github.com/BxNxM/micrOSPackages)
+9. micrOS Gateway server with Prometheus&Grafana: [link](https://github.com/BxNxM/micrOS/#micros-gateway-in-docker)
+10. Release notes: [release-note](https://github.com/BxNxM/micrOS/#release-note)
 
 ----------------------------------------
 ----------------------------------------
@@ -120,13 +121,19 @@ I would suggest to use micrOS GUI as a primary interface for micrOS development
 
 ## 1. Prerequisites
 
-### 1.1 Install python3.9+
+### 1.1 Install python3.12+
 
-Link for python 3.9+ [download](https://www.python.org/downloads/release/python-390/)
+Download Python 3.12+ [link](https://www.python.org/downloads/release/python-3120/)
 
 > Note: **Allow extend system path** with that python version (installation parameter) </br>
 > On **Windows**: RUN AS ADMINISTARTOR
 
+Check Python3 version
+
+```bash
+python3 --version
+```
+
 ----------------------------------------
 
 ### 2. Install micrOS devToolKit GUI

{microsdevtoolkit-2.22.0 → microsdevtoolkit-2.22.4}/README.md

@@ -48,14 +48,15 @@ Access rest api over browser: `http://<nodename>.local`
 ## ◉ Shortcuts:
 1. 📲 micrOS Client Application [link](https://github.com/BxNxM/micrOS/#micros-client-application)
 2. micrOS Installer [link](https://github.com/BxNxM/micrOS/#installing-micros-with-devtoolkit-esp32-and-more)
-3. micrOS Tutorials [link](https://github.com/BxNxM/micrOS/#micros-video-tutorials)
+3. ▶️ micrOS Tutorials [link](https://github.com/BxNxM/micrOS/#micros-video-tutorials)
 4. micrOS System and features [link](https://github.com/BxNxM/micrOS/#micros-framework-features)
 5. 🎮 Built-in app modules: [link](https://htmlpreview.github.io/?https://github.com/BxNxM/micrOS/blob/master/micrOS/client/sfuncman/sfuncman.html)
 5. Pin mapping - GPIO [link](https://github.com/BxNxM/micrOS/#device-pinouts-for-wiring)
-6. micrOS Node configuration [link](https://github.com/BxNxM/micrOS/#micros-node-configuration-parameters-with-description)
+6. ⚙️ micrOS Node configuration [link](https://github.com/BxNxM/micrOS/#micros-node-configuration-parameters-with-description)
 7. 🧑‍💻 micrOS create custom Load Modules: [link](./APPLICATION_GUIDE.md)
-8. micrOS Gateway server with Prometheus&Grafana: [link](https://github.com/BxNxM/micrOS/#micros-gateway-in-docker)
-9. Release notes: [release-note](https://github.com/BxNxM/micrOS/#release-note)
+8. 📦 micrOS Package Management: [link](https://github.com/BxNxM/micrOSPackages)
+9. micrOS Gateway server with Prometheus&Grafana: [link](https://github.com/BxNxM/micrOS/#micros-gateway-in-docker)
+10. Release notes: [release-note](https://github.com/BxNxM/micrOS/#release-note)
 
 ----------------------------------------
 ----------------------------------------
@@ -82,13 +83,19 @@ I would suggest to use micrOS GUI as a primary interface for micrOS development
 
 ## 1. Prerequisites
 
-### 1.1 Install python3.9+
+### 1.1 Install python3.12+
 
-Link for python 3.9+ [download](https://www.python.org/downloads/release/python-390/)
+Download Python 3.12+ [link](https://www.python.org/downloads/release/python-3120/)
 
 > Note: **Allow extend system path** with that python version (installation parameter) </br>
 > On **Windows**: RUN AS ADMINISTARTOR
 
+Check Python3 version
+
+```bash
+python3 --version
+```
+
 ----------------------------------------
 
 ### 2. Install micrOS devToolKit GUI

{microsdevtoolkit-2.22.0 → microsdevtoolkit-2.22.4}/micrOS/release_info/micrOS_ReleaseInfo/system_analysis_sum.json

@@ -5,8 +5,8 @@
             6
         ],
         "Pacman.py": [
-            9.8,
-            1
+            9.48,
+            2
         ],
         "Files.py": [
             9.69,
@@ -41,12 +41,12 @@
             2
         ],
         "Notify.py": [
-            9.74,
-            3
+            9.78,
+            4
         ],
         "Types.py": [
-            8.91,
-            29
+            9.21,
+            30
         ],
         "Logger.py": [
             8.84,
@@ -54,7 +54,7 @@
         ],
         "Common.py": [
             9.85,
-            35
+            36
         ],
         "InterConnect.py": [
             9.63,
@@ -78,7 +78,7 @@
         ],
         "microIO.py": [
             9.35,
-            44
+            45
         ],
         "micrOS.py": [
             9.3,
@@ -113,7 +113,7 @@
             0
         ],
         "modules/LM_pacman.py": [
-            7.61,
+            7.66,
             0
         ],
         "modules/LM_genIO.py": [
@@ -125,7 +125,7 @@
             0
         ],
         "modules/LM_system.py": [
-            8.46,
+            8.49,
             0
         ],
         "modules/LM_robustness.py": [
@@ -140,6 +140,10 @@
             8.5,
             0
         ],
+        "modules/LM_mh_z19c.py": [
+            9.78,
+            0
+        ],
         "modules/LM_rest.py": [
             8.6,
             0
@@ -253,7 +257,7 @@
             0
         ],
         "modules/LM_telegram.py": [
-            9.62,
+            9.67,
             0
         ],
         "modules/LM_OV2640.py": [
@@ -289,7 +293,7 @@
             0
         ],
         "modules/LM_mqtt_client.py": [
-            8.72,
+            9.55,
             0
         ],
         "modules/LM_dashboard_be.py": [
@@ -323,12 +327,12 @@
     },
     "summary": {
         "core": [
-            4338,
+            4475,
             25
         ],
         "load": [
-            9874,
-            55
+            10096,
+            56
         ],
         "core_dep": [
             true,
@@ -339,7 +343,7 @@
             4
         ],
         "core_score": 9.29,
-        "load_score": 8.41,
-        "version": "2.22.0-0"
+        "load_score": 8.46,
+        "version": "2.21.4-0"
     }
 }

{microsdevtoolkit-2.22.0 → microsdevtoolkit-2.22.4}/micrOS/source/Common.py

@@ -80,18 +80,26 @@ def exec_cmd(cmd:list, jsonify:bool=None, secure=False):
     return lm_exec(cmd, jsonify=jsonify)
 
 
-def notify(text=None) -> bool:
+def notify(*args, **kwargs) -> bool:
     """
-    [LM] micrOS common notification handler (Telegram)
-    :param text: notification text / None (return notification state)
+    [LM] micrOS common notification handler (Telegram, etc.)
+    text (0): notification text / None (return notification state)
+    :param channels (optional): select communication interface(s) by class name or an iterable of these.
+                                If omitted or empty, sends over all available channels.
+    Examples (optional parameters):
+        Telegram params:
+            reply_to: message id to reply to (optional) - default: None
+             chat_id: chat identifier - default: None -> auto resolve in child class
+        MQTTClient params:
+            topic: mqtt topic to send the message - default: None -> auto resolve in child class
     return: verdict: True/False
     """
-    # (1) Return notification state
-    if text is None:
+    # (1) Return notification state (if no text input given)
+    if kwargs.get("text", args[0] if args else None) is None:
         return Notify.GLOBAL_NOTIFY
     # (2) Send notification
     try:
-        out = Notify.notify(text)
+        out = Notify.notify(*args, **kwargs)
     except Exception as e:
         debug_syslog(f"[ERR] Notify: {e}")
         out = str(e)

{microsdevtoolkit-2.22.0 → microsdevtoolkit-2.22.4}/micrOS/source/Espnow.py

@@ -32,10 +32,8 @@ def render_packet(tid: str, oper: str, data: str, prompt: str) -> str:
     """
     if oper not in ("REQ", "RSP"):
         syslog(f"[ERR] espnow render_response, unknown oper: {oper}")
-    tmp = "{tid}|{oper}|{data}|{prompt}$"
-    tmp = (tmp.replace("{tid}", tid).replace("{oper}", oper)
-           .replace("{data}", str(data)).replace("{prompt}", prompt))
-    return tmp
+    return f"{tid}|{oper}|{str(data)}|{prompt}$"
+
 
 def parse_packet(msg: bytes) -> tuple[bool, dict | str]:
     """
@@ -251,15 +249,19 @@ class ESPNowSS:
         ESPNow client task: send a command to a peer and update task status.
         """
         with NativeTask.TASKS.get(tag, None) as my_task:
-            router = ResponseRouter(peer, tid)
-            # rendered_output: "{tid}|{oper}|{data}|{prompt}$"
-            rendered_out = render_packet(tid=tid, oper="REQ", data=msg, prompt=self.devfid)
-            if await self.__asend_raw(peer, rendered_out):
-                my_task.out = f"[ESPNOW SEND] {rendered_out}"
-                my_task.out = await router.get_response()
-            else:
-                my_task.out = "[ESPNOW SEND] Peer not responding"
-            router.close()
+            try:
+                router = ResponseRouter(peer, tid)
+                # rendered_output: "{tid}|{oper}|{data}|{prompt}$"
+                rendered_out = render_packet(tid=tid, oper="REQ", data=msg, prompt=self.devfid)
+                if await self.__asend_raw(peer, rendered_out):
+                    my_task.out = f"[ESPNOW SEND] {rendered_out}"
+                    my_task.out = await router.get_response()
+                else:
+                    my_task.out = "[ESPNOW SEND] Peer not responding"
+            except Exception as e:
+                my_task.out = f"[ERR][ESPNOW SEND] {e}"
+            finally:
+                router.close()
 
     def mac_by_peer_name(self, peer_name: str) -> bytes | None:
         matches = [k for k, v in self.devices.items() if v == peer_name]
@@ -325,6 +327,9 @@ class ESPNowSS:
             sender = self.send(peer, "hello")
             task_key = list(sender.keys())[0]
             sender_task = NativeTask.TASKS.get(task_key, None)
+            if sender_task is None:
+                my_task.out = "Handshake Error: No sender task"
+                return
             result = await sender_task.await_result(timeout=10)
             expected_response =  f"hello {self.devfid}"
             is_ok = False

{microsdevtoolkit-2.22.0 → microsdevtoolkit-2.22.4}/micrOS/source/InterConnect.py

@@ -174,7 +174,7 @@ class InterCon:
             return {None: f"[ERR] ESPNow auto handshake: task list >>{host}: {response}"}
 
         active_tasks = loads(response).get("active")
-        if "espnow.server" in active_tasks:
+        if active_tasks and "espnow.server" in active_tasks:
             response = await self.send_cmd(host, ["system", "info", ">json"])
             if not response:
                 return {None: "[ERR] ESPNow auto handshake: system info"}

microsdevtoolkit-2.22.4/micrOS/source/Notify.py

@@ -0,0 +1,102 @@
+"""
+Module is responsible for Notification handling
+Common:
+    - notifications None/True/False
+    - notify 'text'
+    - lm_execute
+Supported notification subscribers (add_subscriber)
+    - LM_telegram
+    - LM_mqtt_client
+Designed by Marcell Ban aka BxNxM
+"""
+
+from Config import cfgget
+from Tasks import lm_exec, lm_is_loaded
+from Debug import syslog
+
+#########################################
+#          micrOS Notifications         #
+#          with Telegram Class          #
+#########################################
+class Notify:
+    GLOBAL_NOTIFY = True            # Enable Global notifications
+    _DEVFID = cfgget('devfid')      # For reply message (pre text)
+    _SUBSCRIBERS = set()            # Store set of notification objects: send_msg
+
+    @staticmethod
+    def add_subscriber(instance):
+        """
+        Add Notification agent like: Telegram
+        """
+        if isinstance(instance, Notify):
+            Notify._SUBSCRIBERS.add(instance)
+            return True
+        raise Exception("Subscribe error, Notify parent missing")
+
+    @staticmethod
+    def send_msg(text, *args, **kwargs):
+        """
+        This method has to be implemented by the child class
+        """
+        raise NotImplementedError("Child class must implement send_msg method")
+
+    @staticmethod
+    def message(text, *args, **kwargs):
+        """
+        Send message to all subscribers - Notify send_msg(text, ...) agents
+        :param text: text message to send
+        :param channels (optional): select communication interface(s) by class name
+               e.g. "Telegram", "MQTT" or an iterable of these.
+               If omitted or empty, sends over all available channels.
+        Telegram params (optional):
+            reply_to: message id to reply to (optional) - default: None
+             chat_id: chat identifier - default: None -> auto resolve in child class
+        MQTT client params (optional):
+            topic: mqtt topic to send the message - default: None -> auto resolve in child class
+        return: verdict and metrics
+        """
+        errors, channels, interfaces = 0, kwargs.get("channels", ()), set()
+        channels = (channels,) if isinstance(channels, str) else tuple(channels)
+        for s in Notify._SUBSCRIBERS:
+            name = s.__class__.__name__
+            try:
+                if len(channels) == 0 or name in channels:
+                    s.send_msg(text, *args, **kwargs)
+                    interfaces.add(name)
+            except Exception as e:
+                syslog(f"[ERR] Notify.{name}: {e}")
+                errors+=1
+        return (f"Sent over {', '.join(interfaces)} ({len(interfaces)}/{len(Notify._SUBSCRIBERS)}) client(s)"
+                f" - errors: ({errors})")
+
+    @staticmethod
+    def notifications(state=None):
+        """
+        Setter for disable/enable notification messages (over LM_system)
+        :param state: True/False/ None(default) - show current state
+        """
+        if isinstance(state, bool):
+            Notify.GLOBAL_NOTIFY = state
+        targets = ", ".join(s.__class__.__name__ for s in Notify._SUBSCRIBERS)
+        return f"Notifications[{targets}]: {'enabled' if Notify.GLOBAL_NOTIFY else 'disabled'}"
+
+    @staticmethod
+    def notify(text, *args, **kwargs):
+        """
+        Notification sender for Load Modules
+        """
+        if Notify.GLOBAL_NOTIFY:
+            return Notify.message(text, *args, **kwargs)
+        return "Notifications disabled"
+
+    @staticmethod
+    def lm_execute(cmd_args, jsonify=False, secure=True):
+        """Load Module Executor with basic access handling"""
+        state = False
+        if secure and not lm_is_loaded(cmd_args[0]):
+            return state, f"NotAllowed {cmd_args[0]}"
+        try:
+            state, out = lm_exec(cmd_args, jsonify)
+        except Exception as e:
+            out = str(e)
+        return state, out

{microsdevtoolkit-2.22.0 → microsdevtoolkit-2.22.4}/micrOS/source/Pacman.py

@@ -15,9 +15,10 @@ Load Modules in /lib/LM_* will be automatically moved to /modules/LM_* as post i
 Designed by Marcell Ban aka BxNxM
 """
 
-from mip import install
-from uos import rename
-from Files import OSPath, path_join, is_file, ilist_fs
+from json import load as jload
+from mip import install as mipstall
+from uos import rename, mkdir
+from Files import OSPath, path_join, is_file, ilist_fs, is_dir, remove_file, remove_dir
 from Debug import syslog
 
 
@@ -77,6 +78,56 @@ def _normalize_source(ref):
         return str(ref), None
 
 
+def _protected_resource(source_name):
+    return source_name.split(".")[0] in ("LM_system", "LM_pacman", "LM_cluster")
+
+
+def _unpack_from_pacman_json(path:str, packages:tuple) -> tuple[bool, str]:
+    """
+    Unpack Load Modules and other resources based on pacman.json
+    :param path: packages library path (default: /lib)
+    :param packages: list of package names, but least one to unpack
+    """
+    verdict = ""
+    # Check all input packages
+    for pack in packages:
+        pack_meta_path = path_join(path, pack, 'pacman.json')
+        if is_file(pack_meta_path):
+            verdict += f"\n    UNPACKING {pack_meta_path}"
+            # Load package layout metadata
+            try:
+                with open(pack_meta_path, 'r') as p:
+                    layout = jload(p).get('layout', {})
+            except Exception as e:
+                syslog(f"[ERR] Package unpack {pack_meta_path}: {e}")
+                layout = {}
+            # Unpack files based on layout metadata
+            for target, source_list in layout.items():
+                target_dir = path_join(OSPath._ROOT, target)
+                for source in source_list:
+                    source_path = path_join(path, source)
+                    source_name = source.split('/')[-1] if '/' in source else source
+                    if _protected_resource(source_name):
+                        verdict += f"\n  ! Unpack skip - protected target: {source_name}"
+                        continue
+                    if is_file(source_path):
+                        try:
+                            if not is_dir(target_dir):
+                                # Support single-level child dir
+                                mkdir(target_dir)
+                        except Exception as e:
+                            verdict += f"\n  ✗ Unpack subdir error {target_dir}: {e}"
+                        try:
+                            rename(source_path, path_join(target_dir, source_name))
+                            verdict += f"\n  ✓ Unpacked {source} -> {target_dir}"
+                        except Exception as e:
+                            verdict += f"\n  ✗ Unpack error {source}: {e}"
+                    elif not is_file(path_join(target_dir, source)):
+                        # Check already unpacked target resource
+                        verdict += f"\n  ✗ Unpack error: {source} not exists"
+    return "\nNothing to unpack" if verdict == "" else verdict
+
+
 # ---------------------------------------------------------------------
 # Core installer
 # ---------------------------------------------------------------------
@@ -92,8 +143,8 @@ def _install_any(ref, target=None):
         kwargs["target"] = target or OSPath.LIB
         verdict = f"[mip] Installing: {ref} {kwargs}\n"
         # MIP Install
-        install(ref, **kwargs)
-        verdict += f"  ✓ Installed successfully under {kwargs['target']}"
+        mipstall(ref, **kwargs)
+        verdict += f"  ✓ Installed under {kwargs['target']}"
     except Exception as e:
         err = f"  ✗ Failed to install '{ref}': {e}"
         syslog(f"[ERR][pacman] {err}")
@@ -126,30 +177,31 @@ def install_requirements(source="requirements.txt"):
     return verdict
 
 
-def unpack(path:str):
+def unpack(ref:str=None):
     """
-    Unpack Load Modules from downloaded package (move under /modules)
+    Unpack downloaded package from /lib
+    - use pacman.json metadata layout to unpack files to multiple targets
+    :param ref: install reference (extract package name from this)
     """
-    verdict = ""
-    for mod in ilist_fs(path, type_filter='f', select="LM"):
-        mod_name = mod.split(".")[0]
-        if mod_name in ("system", "pacman"):
-            verdict += f"\n  ✗ Unpack skipped: {mod} (protected)\n"
-            continue
-        try:
-            rename(path_join(path, mod), path_join(OSPath.MODULES, mod))
-            verdict += f"\n  ✓ Unpack {mod}\n"
-        except Exception as e:
-            verdict += f"\n  ✗ Unpack error {mod}: {e}\n"
-    return verdict
+
+    if ref is None:
+        # Collect all package names under /lib and unpack all
+        packages = tuple(ilist_fs(OSPath.LIB, type_filter='d'))
+    else:
+        # Handle single explicit ref for unpacking
+        ref_parts = ref.split("/")
+        pack_name = ref_parts[-2] if '.' in ref_parts[-1] else ref_parts[-1]
+        packages = (pack_name, )
+
+    return _unpack_from_pacman_json(OSPath.LIB, packages)
 
 # ---------------------------------------------------------------------
 # Unified entry point
 # ---------------------------------------------------------------------
 
-def download(ref):
+def install(ref):
     """
-    Unified mip-based downloader for micrOS.
+    Unified mip-based installer for micrOS.
     Automatically detects:
       - requirements.txt files (local)
       - Single-file load modules (LM_/IO_ names or URLs)
@@ -158,23 +210,61 @@ def download(ref):
     """
 
     if not ref:
-        return "[mip] Nothing to download (empty input)"
+        return "[mip] Nothing to install (empty input)"
 
-    # 1. requirements.txt
+    # 1. Install from requirements.txt
     if ref == "requirements.txt":
         verdict = install_requirements(ref)
-        verdict += unpack(OSPath.LIB)
+        verdict += unpack()
         return verdict
 
+    # 2. Install from URL or Shorthand file / package reference
     if ref.startswith("github") or ref.startswith("http"):
-        # 2. LM_/IO_ load modules → /modules
+        # 2.1. Exact file ref: LM_/IO_ load modules → /modules
         if ref.endswith("py") and ("LM_" in ref or "IO_" in ref):
             return _install_any(ref, target=OSPath.MODULES)
 
-        # 3. GitHub or raw URLs → /lib
+        # 2.2. Package ref: GitHub or raw URLs → /lib
         verdict = _install_any(ref, target=OSPath.LIB)
-        verdict += unpack(OSPath.LIB)
+        verdict += unpack(ref)
         return verdict
 
-    # 4. Fallback: official micropython package → /lib
+    # 3. Fallback/Official micropython package → /lib
     return _install_any(ref, target=OSPath.LIB)
+
+
+def uninstall(package_name):
+    """
+    Uninstalls package from /lib with its dependencies
+    """
+    pack_path = path_join(OSPath.LIB, package_name)
+    pack_meta = path_join(pack_path, "pacman.json")
+
+    if not is_dir(pack_path):
+        return f"No packaged found: {pack_path}"
+
+    verdict = f"Uninstall {package_name}\n"
+    if is_file(pack_meta):
+        # Load package layout metadata
+        try:
+            with open(pack_meta, 'r') as p:
+                layout = jload(p).get('layout', {})
+        except Exception as e:
+            syslog(f"[ERR] Package uninstall {pack_meta}: {e}")
+            layout = {}
+
+        for target, source_list in layout.items():
+            target_dir = path_join(OSPath._ROOT, target)
+            for source in source_list:
+                source_name = source.split('/')[-1] if '/' in source else source
+                if _protected_resource(source_name):
+                    verdict += f"  ✗ Remove skip - protected target: {source_name}\n"
+                    continue
+                unpacked_path = path_join(target_dir, source_name)
+                if is_file(unpacked_path):
+                    remove_file(unpacked_path)
+                    verdict += f"  ✓ Removed: {unpacked_path}\n"
+
+    # Delete package
+    verdict += "  " + remove_dir(pack_path)
+    return verdict

{microsdevtoolkit-2.22.0 → microsdevtoolkit-2.22.4}/micrOS/source/Shell.py

@@ -25,7 +25,7 @@ from Debug import syslog
 
 class Shell:
     __slots__ = ['__devfid', '__auth_mode', '__hwuid', '__auth_ok', '__conf_mode']
-    MICROS_VERSION = '2.22.0-0'
+    MICROS_VERSION = '2.21.4-0'
 
     def __init__(self):
         """