pyhw 0.2.0b0__py3-none-any.whl → 0.7.4__py3-none-any.whl

pyhw/backend/npu/bsd.py

@@ -0,0 +1,6 @@
+from .linux import NPUDetectLinux
+
+
+class NPUDetectBSD(NPUDetectLinux):
+    def __init__(self):
+        NPUDetectLinux.__init__(self)

pyhw/backend/npu/linux.py

@@ -0,0 +1,38 @@
+from .npuInfo import NPUInfo
+import pypci
+
+
+class NPUDetectLinux:
+    def __init__(self):
+        self._npuInfo = NPUInfo()
+
+    def getNPUInfo(self):
+        self._getNPUInfo()
+        self._sortNPUList()
+        return self._npuInfo
+
+    def _getNPUInfo(self):
+        npu_devices = pypci.PCI().FindAllNPU()
+        if len(npu_devices) == 0:
+            self._handleNonePciDevices()
+        else:
+            for device in npu_devices:
+                if device.subsystem_device_name != "":
+                    device_name = f"{device.vendor_name} {device.device_name} ({device.subsystem_device_name})"
+                else:
+                    device_name = f"{device.vendor_name} {device.device_name}"
+                self._npuInfo.npus.append(self._npuNameClean(device_name))
+                self._npuInfo.number += 1
+
+    def _handleNonePciDevices(self):
+        # Place Holder for unknown NPU
+        self._npuInfo.number = 1
+        self._npuInfo.npus.append("Not found")
+
+    @staticmethod
+    def _npuNameClean(npu_name: str):
+        npu_name_clean = npu_name.replace("Corporation ", "")
+        return npu_name_clean
+
+    def _sortNPUList(self):
+        self._npuInfo.npus.sort()

pyhw/backend/npu/macos.py

@@ -0,0 +1,65 @@
+from .npuInfo import NPUInfo
+from ...pyhwUtil import getArch, getOS
+import json
+import subprocess
+from ..cpu import CPUDetect
+
+
+class NPUDetectMacOS:
+    def __init__(self):
+        self.__npuInfo = NPUInfo()
+        self.__arch = getArch()
+
+    def getNPUInfo(self):
+        self.__npuInfo.npus.append(self.__getNPUbyModelName())
+        self.__npuInfo.number += 1
+        # if self.__arch == "aarch64":
+        #     self.__getNPUAppleSilicon()
+        # else:   # Does not consider powerPC based Macs.
+        #     self.__getNPUIntel()
+        return self.__npuInfo
+
+    def __getNPUAppleSilicon(self):
+        # Place holder
+        self.__npuInfo.npus.append("Apple Neural Engine [SOC Integrated]")
+        self.__npuInfo.number += 1
+
+    def __getNPUIntel(self):
+        # Place holder
+        self.__npuInfo.npus.append("Not Found")
+        self.__npuInfo.number += 1
+
+    @staticmethod
+    def __handleVendor(vendor):
+        if vendor == "sppci_vendor_Apple":
+            return "Apple"
+        elif vendor == "sppci_vendor_intel":
+            return "Intel"
+        elif vendor == "sppci_vendor_amd":
+            return "AMD"
+        else:
+            return vendor
+
+    @staticmethod
+    def __getNPUbyModelName():
+        # Placeholder
+        # see https://apple.fandom.com/wiki/Neural_Engine for more details.
+        model_name = CPUDetect(os=getOS()).getCPUInfo().model
+        npu = {
+            "Apple M1": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M1 Pro": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M1 Max": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M1 Ultra": "Apple Neural Engine 32 Core [SOC Integrated]",
+            "Apple M2": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M2 Pro": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M2 Max": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M2 Ultra": "Apple Neural Engine 32 Core [SOC Integrated]",
+            "Apple M3": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M3 Pro": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M3 Max": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M4": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M4 Pro": "Apple Neural Engine 16 Core [SOC Integrated]",
+            "Apple M4 Max": "Apple Neural Engine 16 Core [SOC Integrated]"
+        }
+        return npu.get(model_name, "Not Found")
+

pyhw/backend/npu/npuBase.py

@@ -0,0 +1,20 @@
+from .linux import NPUDetectLinux
+from .macos import NPUDetectMacOS
+from .bsd import NPUDetectBSD
+
+
+class NPUDetect:
+    def __init__(self, os):
+        self.OS = os
+
+    def getNPUInfo(self):
+        if self.OS == "linux":
+            return NPUDetectLinux().getNPUInfo()
+        elif self.OS == "macos":
+            return NPUDetectMacOS().getNPUInfo()
+        elif self.OS == "freebsd":
+            return NPUDetectBSD().getNPUInfo()
+        else:
+            raise NotImplementedError("Unsupported operating system")
+
+

pyhw/backend/npu/npuInfo.py

@@ -0,0 +1,10 @@
+from dataclasses import dataclass
+
+
+@dataclass
+class NPUInfo:
+    def __init__(self):
+        self.number = 0
+        self.npus = []
+
+

pyhw/backend/os/bsd.py

@@ -0,0 +1,7 @@
+from .linux import OSDetectLinux
+
+
+class OSDetectBSD(OSDetectLinux):
+    def __init__(self):
+        OSDetectLinux.__init__(self)
+

pyhw/backend/os/linux.py

@@ -6,42 +6,47 @@ from .osInfo import OSInfo
 
 class OSDetectLinux:
     def __init__(self):
-        self.__osInfo = OSInfo()
+        self._osInfo = OSInfo()
 
     def getOSInfo(self):
         """
         Detects the os distribution and its version.
         :return: dataclass OSInfoLinux, direct attrs: prettyName
         """
-        self.__getOSInfo()
-        return self.__osInfo
+        self._getOSInfo()
+        self._handleArmbian()
+        return self._osInfo
 
-    def __getOSInfo(self):
+    def _getOSInfo(self):
         try:
             with open("/etc/os-release", "r") as f:
                 for line in f:
                     key, value = line.strip().split("=")
                     if key == "PRETTY_NAME":
-                        self.__osInfo.prettyName = value.strip('"')
+                        self._osInfo.prettyName = value.strip('"')
                     elif key == "NAME":
-                        self.__osInfo.name = value.strip('"')
+                        self._osInfo.name = value.strip('"')
                     elif key == "ID":
-                        self.__osInfo.id = value.strip('"')
+                        self._osInfo.id = value.strip('"')
                     elif key == "ID_LIKE":
-                        self.__osInfo.idLike = value.strip('"')
+                        self._osInfo.idLike = value.strip('"')
                     elif key == "VARIANT":
-                        self.__osInfo.variant = value.strip('"')
+                        self._osInfo.variant = value.strip('"')
                     elif key == "VARIANT_ID":
-                        self.__osInfo.variantID = value.strip('"')
+                        self._osInfo.variantID = value.strip('"')
                     elif key == "VERSION":
-                        self.__osInfo.version = value.strip('"')
+                        self._osInfo.version = value.strip('"')
                     elif key == "VERSION_ID":
-                        self.__osInfo.versionID = value.strip('"')
+                        self._osInfo.versionID = value.strip('"')
                     elif key == "VERSION_CODENAME":
-                        self.__osInfo.versionCodename = value.strip('"')
+                        self._osInfo.versionCodename = value.strip('"')
                     elif key == "CODE_NAME":
-                        self.__osInfo.codeName = value.strip('"')
+                        self._osInfo.codeName = value.strip('"')
                     elif key == "BUILD_ID":
-                        self.__osInfo.buildID = value.strip('"')
+                        self._osInfo.buildID = value.strip('"')
         except Exception:
             pass
+
+    def _handleArmbian(self):
+        if "Armbian" in self._osInfo.prettyName or "armbian" in self._osInfo.prettyName:
+            self._osInfo.id = "armbian"

pyhw/backend/os/macos.py

@@ -13,7 +13,11 @@ class OSDetectMacOS:
 
     def getOSInfo(self):
         self.__getOS()
-        self.__osInfo.prettyName = f"{self.__ProductName} {self.__ProductVersion} {self.__BuildVersion} {getArch()}"
+        self.__handelOSName()
+        if self.__VersionName != "":
+            self.__osInfo.prettyName = f"{self.__ProductName} {self.__VersionName} {self.__ProductVersion} {self.__BuildVersion} {getArch()}"
+        else:
+            self.__osInfo.prettyName = f"{self.__ProductName} {self.__ProductVersion} {self.__BuildVersion} {getArch()}"
         self.__osInfo.id = "macOS"
         return self.__osInfo
 
@@ -32,5 +36,19 @@ class OSDetectMacOS:
                 self.__BuildVersion = sw_ver.split(":")[1].strip()
 
     def __handelOSName(self):
-        # Add os name -- product version conversion logic in the future.
-        pass
+        # Only supports modern macOS
+        macOSVersionMap = {
+            "11": "Big Sur",
+            "12": "Monterey",
+            "13": "Ventura",
+            "14": "Sonoma",
+            "15": "Sequoia"
+        }
+        if "." in self.__ProductVersion:
+            major = self.__ProductVersion.split(".")[0]
+        else:
+            major = self.__ProductVersion
+        version_name = macOSVersionMap.get(major, "")
+        if version_name != "":
+            self.__VersionName = version_name
+

pyhw/backend/os/osBase.py

@@ -1,5 +1,6 @@
 from .linux import OSDetectLinux
 from .macos import OSDetectMacOS
+from .bsd import OSDetectBSD
 from ...pyhwException import OSUnsupportedException
 
 
@@ -12,5 +13,7 @@ class OSDetect:
             return OSDetectLinux().getOSInfo()
         elif self.__OS == "macos":
             return OSDetectMacOS().getOSInfo()
+        elif self.__OS == "freebsd":
+            return OSDetectBSD().getOSInfo()
         else:
             raise OSUnsupportedException("Unsupported operating system")

pyhw/backend/shell/shellBase.py

@@ -7,7 +7,7 @@ class ShellDetect:
         self.OS = os
 
     def getShellInfo(self):
-        if self.OS == "linux" or self.OS == "macos":
+        if self.OS in ["linux", "macos", "freebsd"]:
             return ShellDetectUnix().getShellInfo()
         else:
             raise OSUnsupportedException("Unsupported operating system")

pyhw/backend/shell/unix.py

@@ -1,6 +1,7 @@
 """
     In dev.
 """
+from ...pyhwUtil import getDocker
 from dataclasses import dataclass
 import os
 import subprocess
@@ -19,7 +20,10 @@ class ShellDetectUnix:
         self.__shellInfo = ShellInfoUnix()
 
     def getShellInfo(self):
-        self.__getShell()
+        if getDocker():
+            self.__getShellDocker()
+        else:
+            self.__getShell()
         self.__getVersion()
         self.__shellInfo.info = self.__shellInfo.shell + " " + self.__shellInfo.version
         return self.__shellInfo
@@ -31,6 +35,19 @@ class ShellDetectUnix:
             self.__shellInfo.shell = shell_env.split("/")[-1]
             self.__shellInfo.path = shell_env
 
+    def __getShellDocker(self):
+        try:
+            with open("/etc/passwd", "r") as f:
+                for line in f:
+                    if line.startswith("root:"):
+                        root_shell = line.strip().split(":")[-1]
+                        break
+        except:
+            root_shell = ""
+        if root_shell != "":
+            self.__shellInfo.shell = root_shell.split("/")[-1]
+            self.__shellInfo.path = root_shell
+
     def __getVersion(self):
         shell = self.__shellInfo.shell
         if shell != "":
@@ -39,7 +56,7 @@ class ShellDetectUnix:
             elif shell == "bash":
                 try:
                     result = subprocess.run(["bash", "-c", "echo $BASH_VERSION"], capture_output=True, text=True)
-                    self.__shellInfo.version = result.stdout.strip()
+                    self.__shellInfo.version = result.stdout.strip().split("(")[0]
                 except subprocess.SubprocessError:
                     pass
             elif shell == "zsh":
@@ -54,3 +71,4 @@ class ShellDetectUnix:
 
 
 
+

pyhw/backend/title/titleBase.py

@@ -8,7 +8,7 @@ class TitleDetect:
         self.OS = os
 
     def getTitle(self):
-        if self.OS == "linux" or self.OS == "macos":
+        if self.OS in ["linux", "macos", "freebsd"]:
             return TitleDetectUnix().getTitle()
         elif self.OS == "windows":
             return TitleDetectWindows().getTitle()

pyhw/backend/uptime/bsd.py

@@ -0,0 +1,7 @@
+from .macos import UptimeDetectMacOS
+
+
+class UptimeDetectBSD(UptimeDetectMacOS):
+    def __init__(self):
+        UptimeDetectMacOS.__init__(self)
+

pyhw/backend/uptime/macos.py

@@ -6,13 +6,13 @@ import subprocess
 
 class UptimeDetectMacOS:
     def __init__(self):
-        self.__uptimeInfo = UptimeInfo()
-        self.__boot_time = 0
-        self.__now = 0
+        self._uptimeInfo = UptimeInfo()
+        self._boot_time = 0
+        self._now = 0
 
     def getUptimeInfo(self):
-        self.__getUptime()
-        uptime_seconds = self.__now - self.__boot_time
+        self._getUptime()
+        uptime_seconds = self._now - self._boot_time
         hours, remainder = divmod(uptime_seconds, 3600)
         minutes, seconds = divmod(remainder, 60)
         days, hours = divmod(hours, 24)
@@ -22,19 +22,19 @@ class UptimeDetectMacOS:
         seconds = int(seconds)
         if days == 0:
             if hours == 0:
-                self.__uptimeInfo.uptime = f"{minutes} min {seconds} sec"
+                self._uptimeInfo.uptime = f"{minutes} min {seconds} sec"
             else:
-                self.__uptimeInfo.uptime = f"{hours} hours {minutes} min {seconds} sec"
+                self._uptimeInfo.uptime = f"{hours} hours {minutes} min {seconds} sec"
         else:
-            self.__uptimeInfo.uptime = f"{days} days {hours} hours {minutes} min {seconds} sec"
-        return self.__uptimeInfo
+            self._uptimeInfo.uptime = f"{days} days {hours} hours {minutes} min {seconds} sec"
+        return self._uptimeInfo
 
-    def __getUptime(self):
+    def _getUptime(self):
         result = sysctlGetString("kern.boottime")
         match = re.search(r'sec = (\d+),', result)
         if match:
-            self.__boot_time = int(match.group(1))
+            self._boot_time = int(match.group(1))
         else:
             return
-        self.__now = int(subprocess.check_output(["date", "+%s"]).decode().strip())
+        self._now = int(subprocess.check_output(["date", "+%s"]).decode().strip())
 

pyhw/backend/uptime/uptimeBase.py

@@ -1,5 +1,6 @@
 from .linux import UptimeDetectLinux
 from .macos import UptimeDetectMacOS
+from .bsd import UptimeDetectBSD
 from ...pyhwException import OSUnsupportedException
 
 
@@ -19,5 +20,7 @@ class UptimeDetect:
             return UptimeDetectLinux().getUptimeInfo()
         elif self.OS == "macos":
             return UptimeDetectMacOS().getUptimeInfo()
+        elif self.OS == "freebsd":
+            return UptimeDetectBSD().getUptimeInfo()
         else:
             raise OSUnsupportedException("Unsupported operating system")

pyhw/frontend/color/colorConfig.py

@@ -21,13 +21,62 @@ class ColorConfigSet:
             return ColorConfigSetU.ubuntu
         elif self.__os_name == "ubuntu_small":
             return ColorConfigSetU.ubuntu_small
+        elif self.__os_name == "raspbian":
+            return ColorConfigSetR.raspbian
+        elif self.__os_name == "armbian":
+            return ColorConfigSetA.armbian
+        elif self.__os_name == "alpine":
+            return ColorConfigSetA.alpine
+        elif self.__os_name == "arch":
+            return ColorConfigSetA.arch
+        elif self.__os_name == "centos":
+            return ColorConfigSetC.centos
+        elif self.__os_name == "freebsd":
+            return ColorConfigSetF.freebsd
         else:
             return ColorConfigSetL.linux  # default to Linux
 
 
 @dataclass
 class ColorConfigSetA:
-    pass
+    armbian = {
+        "colors": [
+            ColorSet.COLOR_FG_RED
+        ],
+        "colorKeys": ColorSet.COLOR_FG_YELLOW,
+        "colorTitle": ColorSet.COLOR_FG_YELLOW
+    }
+    alpine = {
+        "colors": [
+            ColorSet.COLOR_FG_BLUE,
+            ColorSet.COLOR_FG_WHITE
+        ],
+        "colorKeys": ColorSet.COLOR_FG_MAGENTA,
+        "colorTitle": ColorSet.COLOR_FG_BLUE
+    }
+    arch = {
+        "colors": [
+            ColorSet.COLOR_FG_CYAN,
+            ColorSet.COLOR_FG_CYAN
+        ],
+        "colorKeys": ColorSet.COLOR_FG_CYAN,
+        "colorTitle": ColorSet.COLOR_FG_CYAN
+    }
+
+
+@dataclass
+class ColorConfigSetC:
+    centos = {
+        "colors": [
+            ColorSet.COLOR_FG_YELLOW,
+            ColorSet.COLOR_FG_GREEN,
+            ColorSet.COLOR_FG_BLUE,
+            ColorSet.COLOR_FG_MAGENTA,
+            ColorSet.COLOR_FG_WHITE
+        ],
+        "colorKeys": ColorSet.COLOR_FG_GREEN,
+        "colorTitle": ColorSet.COLOR_FG_YELLOW
+    }
 
 
 @dataclass
@@ -60,6 +109,14 @@ class ColorConfigSetF:
         "colorKeys": ColorSet.COLOR_FG_BLUE,
         "colorTitle": ColorSet.COLOR_FG_BLUE
     }
+    freebsd = {
+        "colors": [
+            ColorSet.COLOR_FG_WHITE,
+            ColorSet.COLOR_FG_RED
+        ],
+        "colorKeys": ColorSet.COLOR_FG_RED,
+        "colorTitle": ColorSet.COLOR_FG_RED
+    }
 
 
 @dataclass
@@ -90,6 +147,18 @@ class ColorConfigSetM:
     }
 
 
+@dataclass
+class ColorConfigSetR:
+    raspbian = {
+        "colors": [
+            ColorSet.COLOR_FG_RED,
+            ColorSet.COLOR_FG_GREEN
+        ],
+        "colorKeys": ColorSet.COLOR_FG_RED,
+        "colorTitle": ColorSet.COLOR_FG_GREEN
+    }
+
+
 @dataclass
 class ColorConfigSetU:
     ubuntu = {

pyhw/frontend/frontendBase.py

@@ -1,5 +1,8 @@
 from .logo import Logo
 from .color import ColorConfigSet, colorPrefix, colorSuffix, ColorSet
+from ..pyhwUtil import getOS
+from ..pyhwException import BackendException
+import os
 import re
 
 
@@ -16,6 +19,7 @@ class Printer:
         self.__combined_lines = []
         self.__logo_color_indexes = {}
         self.__reg = r'\$(\d)'
+        self.__columns = self.__getColumns()
 
     def cPrint(self):
         self.__LogoPreprocess()
@@ -29,10 +33,39 @@ class Printer:
             self.__combined_lines.append(logo_line)
 
         for data_line in self.__processed_data_lines[len(self.__processed_logo_lines):]:
-            self.__combined_lines.append(" " * max_len_logo + data_line)
+            self.__combined_lines.append(" " * (max_len_logo + 1) + data_line)
+
+        self.__dropLongString()
 
         print("\n".join(self.__combined_lines))
 
+    def __dropLongString(self):
+        # Need more accurate way to drop long strings
+        if getOS() == "linux":
+            fixed_lines = list()
+            for line in self.__combined_lines:
+                if len(line) > self.__columns+20:
+                    fixed_lines.append(line[:self.__columns+20])
+                else:
+                    fixed_lines.append(line)
+            self.__combined_lines = fixed_lines
+        else:
+            pass
+
+
+    @staticmethod
+    def __getColumns() -> int:
+        if getOS() == "linux":
+            try:
+                _, columns_str = os.popen('stty size', 'r').read().split()
+                columns = int(columns_str)
+            except:
+                columns = 80  # default terminal size is 80 columns
+        else:
+            # macOS default terminal size is 80 columns
+            columns = 80
+        return columns
+
     def __LogoPreprocess(self):
         global_color = self.__config.get("colors")[0]
         for logo_line in self.__logo_lines:
@@ -63,7 +96,13 @@ class Printer:
                                            self.__data_lines[0].split("@")[1] + colorSuffix())
         self.__processed_data_lines.append(colorSuffix() + self.__data_lines[1])
         for data_line in self.__data_lines[2:]:
-            name, value = data_line.split(": ")
+            try:
+                spl = data_line.split(": ")
+                name = spl[0]
+                value = "".join(spl[1:])
+            except:
+                print(data_line)
+                raise BackendException("Invalid data format")
             self.__processed_data_lines.append(colorPrefix(ColorSet.COLOR_MODE_BOLD) + colorPrefix(keys_color) + name + ": " + colorSuffix() + value)
 
 

pyhw/frontend/logo/ascii/alpine.pyhw

@@ -0,0 +1,6 @@
+   /\ /\
+  // \  \
+ //   \  \
+///    \  \
+//      \  \
+         \

pyhw/frontend/logo/ascii/arch.pyhw

@@ -0,0 +1,19 @@
+                  ▄
+                 ▟█▙
+                ▟███▙
+               ▟█████▙
+              ▟███████▙
+             ▂▔▀▜██████▙
+            ▟██▅▂▝▜█████▙
+           ▟█████████████▙
+          ▟███████████████▙
+         ▟█████████████████▙
+        ▟███████████████████▙
+$2       ▟█████████▛▀▀▜████████▙
+      ▟████████▛      ▜███████▙
+     ▟█████████        ████████▙
+    ▟██████████        █████▆▅▄▃▂
+   ▟██████████▛        ▜█████████▙
+  ▟██████▀▀▀              ▀▀██████▙
+ ▟███▀▘                       ▝▀███▙
+▟▛▀                               ▀▜▙

pyhw/frontend/logo/ascii/armbian.pyhw

@@ -0,0 +1,14 @@
+   █ █ █ █ █ █ █ █ █ █ █
+  ███████████████████████
+▄▄██                   ██▄▄
+▄▄██    ███████████    ██▄▄
+▄▄██   ██         ██   ██▄▄
+▄▄██   ██         ██   ██▄▄
+▄▄██   ██         ██   ██▄▄
+▄▄██   █████████████   ██▄▄
+▄▄██   ██         ██   ██▄▄
+▄▄██   ██         ██   ██▄▄
+▄▄██   ██         ██   ██▄▄
+▄▄██                   ██▄▄
+  ███████████████████████
+   █ █ █ █ █ █ █ █ █ █ █

pyhw/frontend/logo/ascii/centos.pyhw

@@ -0,0 +1,19 @@
+                 ..
+               .PLTJ.
+              <><><><>
+     $2KKSSV' 4KKK $1LJ$4 KKKL.'VSSKK
+     $2KKV' 4KKKKK $1LJ$4 KKKKAL 'VKK
+     $2V' ' 'VKKKK $1LJ$4 KKKKV' ' 'V
+     $2.4MA.' 'VKK $1LJ$4 KKV' '.4Mb.
+   $4. $2KKKKKA.' 'V $1LJ$4 V' '.4KKKKK $3.
+ $4.4D $2KKKKKKKA.'' $1LJ$4 ''.4KKKKKKK $3FA.
+$4<QDD ++++++++++++  $3++++++++++++ GFD>
+ '$4VD $3KKKKKKKK'.. $2LJ $1..'KKKKKKKK $3FV
+   $4' $3VKKKKK'. .4 $2LJ $1K. .'KKKKKV $3'
+      $3'VK'. .4KK $2LJ $1KKA. .'KV'
+     $3A. . .4KKKK $2LJ $1KKKKA. . .4
+     $3KKA. 'KKKKK $2LJ $1KKKKK' .4KK
+     $3KKSSA. VKKK $2LJ $1KKKV .4SSKK
+              $2<><><><>
+               $2'MKKM'
+                 $2''

pyhw/frontend/logo/ascii/freebsd.pyhw

@@ -0,0 +1,15 @@
+```                        $2`
+  $1` `.....---...$2....--.```   -/
+  $1+o   .--`         $2/y:`      +.
+   $1yo`:.            $2:o      `+-
+    $1y/               $2-/`   -o/
+   $1.-                  $2::/sy+:.
+   $1/                     $2`--  /
+  $1`:                          $2:`
+  $1`:                          $2:`
+   $1/                          $2/
+   $1.-                        $2-.
+    $1--                      $2-.
+     $1`:`                  $2`:`
+       .--             `--.
+          .---.....----.