kopitools 1.0.0__py3-none-any.whl

kopitools/__init__.py

@@ -0,0 +1,10 @@
+from kopitools.logs import (
+    log, Log
+)
+from kopitools.paint import (
+    paint, Paint
+)
+from kopitools.args import (
+    Registry, Option, Args,
+    ArgError, EntryPointNotFoundError,
+)

kopitools/args/__init__.py

@@ -0,0 +1,3 @@
+from kopitools.args.registry import Registry, Args
+from kopitools.args.option import Option
+from kopitools.args.exceptions import ArgError, EntryPointNotFoundError

kopitools/args/exceptions.py

@@ -0,0 +1,5 @@
+class ArgError(Exception):
+    pass
+
+class EntryPointNotFoundError(Exception):
+    pass

kopitools/args/option.py

@@ -0,0 +1,37 @@
+from kopitools.args.exceptions import ArgError
+from typing import Any
+
+class Option:
+    def __init__(
+        self,
+        name: str,
+        receives: Any,
+        default: Any,
+        attribute: str,
+    ):
+        self.name = name
+        self.receives = receives
+        self.default = default
+        self.attribute = attribute
+
+    def get(self, remaining: list[str]) -> Any:
+        try:
+            key = remaining.index(self.name)
+        except ValueError:
+            return self.default
+
+        if self.receives is None:
+            return not self.default
+
+        try:
+            value = remaining[key + 1]
+        except IndexError:
+            raise ValueError(f"Missing value for: {self.name}")
+
+        del remaining[key:key + 2]
+
+        try:
+            return self.receives(value)
+        except ValueError:
+            message = f"[{self.name}] could not convert \"{value}\" to {self.receives}"
+            raise ArgError(message)

kopitools/args/registry.py

@@ -0,0 +1,40 @@
+from kopitools.args.option import Option
+from kopitools.args.exceptions import EntryPointNotFoundError
+
+from typing import Any
+
+class Args:
+    def __init__(self, args: dict[str, Any]):
+        self._args = args
+
+    def __getitem__(self, key: str) -> Any:
+        return self._args.get(key, None)
+
+class Registry:
+    def __init__(self, argv: list[str], entry_point: None | str = None):
+        self.options: list[Option] = []
+        self.argv = argv
+
+        if entry_point is not None:
+            if entry_point not in self.argv:
+                message = f"Entry point: [{entry_point}] not in \"args\"!"
+                raise EntryPointNotFoundError(message)
+
+    def option(
+        self,
+        name: str,
+        receives: Any,
+        default: Any,
+        attribute: str,
+    ):
+        self.options.append(Option(name, receives, default, attribute))
+
+    def collect(self) -> Args:
+        remaining = self.argv.copy()
+        args = {}
+
+        for opt in self.options:
+            value = opt.get(remaining)
+            args[opt.attribute] = value
+
+        return Args(args)

kopitools/logs/__init__.py

@@ -0,0 +1,3 @@
+from kopitools.logs.logs import (
+    Log, log
+)

kopitools/logs/logs.py

@@ -0,0 +1,103 @@
+from kopitools.paint import paint
+
+from typing import Any
+
+class Log:
+    icons = True
+    text = False
+
+    def __init__(self, args: tuple[Any]):
+        self.args = args
+
+    def success(self):
+        icon = "SUCCESS" if Log.text else "&"
+
+        flag = paint(
+            paint("[").bold(),
+            paint(icon).bold().green(),
+            paint("]").bold(),
+            sep=""
+        )
+
+        paint(
+            paint(flag).bold(),
+            paint(*self.args)
+        ).show()
+
+    def error(self):
+        icon = "ERROR" if Log.text else "X"
+
+        flag = paint(
+            paint("[").bold(),
+            paint(icon).bold().red(),
+            paint("]").bold(),
+            sep=""
+        )
+
+        paint(
+            paint(flag).bold(),
+            paint(*self.args)
+        ).show()
+
+    def warning(self):
+        icon = "WARNING" if Log.text else "!"
+
+        flag = paint(
+            paint("[").bold(),
+            paint(icon).bold().yellow(),
+            paint("]").bold(),
+            sep=""
+        )
+
+        paint(
+            paint(flag).bold(),
+            paint(*self.args)
+        ).show()
+
+    def critical(self):
+        icon = "CRITICAL" if Log.text else "#"
+
+        flag = paint(
+            paint("[").bold(),
+            paint(icon).bold().red(),
+            paint("]").bold(),
+            sep=""
+        )
+
+        paint(
+            paint(flag).bold(),
+            paint(*self.args)
+        ).show()
+
+    def unknown(self):
+        icon = "UNKNOWN" if Log.text else "?"
+
+        flag = paint(
+            paint("[").bold(),
+            paint(icon).bold().magenta(),
+            paint("]").bold(),
+            sep=""
+        )
+
+        paint(
+            paint(flag).bold(),
+            paint(*self.args)
+        ).show()
+
+    def info(self):
+        icon = "INFO" if Log.text else "^"
+
+        flag = paint(
+            paint("[").bold(),
+            paint(icon).bold().blue(),
+            paint("]").bold(),
+            sep=""
+        )
+
+        paint(
+            paint(flag).bold(),
+            paint(*self.args)
+        ).show()
+
+def log(*args: Any) -> Log:
+    return Log(args)

kopitools/paint/__init__.py

@@ -0,0 +1,3 @@
+from kopitools.paint.paint import (
+    Paint, paint
+)

kopitools/paint/paint.py

@@ -0,0 +1,88 @@
+from typing import Any
+
+class Paint:
+    def __init__(
+        self,
+        parsed_string: str,
+        end: str,
+        flush: bool,
+    ):
+        self.parsed_string = parsed_string
+        self.end = end
+        self.codes = []
+        self.flush = flush
+
+        self.BLACK     = "\033[30m"
+        self.RED       = "\033[31m"
+        self.GREEN     = "\033[32m"
+        self.YELLOW    = "\033[33m"
+        self.BLUE      = "\033[34m"
+        self.MAGENTA   = "\033[35m"
+        self.CYAN      = "\033[36m"
+        self.WHITE     = "\033[37m"
+
+        self.BOLD      = "\033[1m"
+        self.ITALIC    = "\033[3m"
+        self.UNDERLINE = "\033[4m"
+
+        self.RESET     = "\033[0m"
+
+    def show(self):
+        print(self, end=self.end, flush=True)
+
+    def black(self):
+        self.codes.append(self.BLACK)
+        return self
+
+    def red(self):
+        self.codes.append(self.RED)
+        return self
+
+    def green(self):
+        self.codes.append(self.GREEN)
+        return self
+
+    def yellow(self):
+        self.codes.append(self.YELLOW)
+        return self
+
+    def blue(self):
+        self.codes.append(self.BLUE)
+        return self
+
+    def magenta(self):
+        self.codes.append(self.MAGENTA)
+        return self
+
+    def cyan(self):
+        self.codes.append(self.CYAN)
+        return self
+
+    def white(self):
+        self.codes.append(self.WHITE)
+        return self
+
+    def bold(self):
+        self.codes.append(self.BOLD)
+        return self
+
+    def underline(self):
+        self.codes.append(self.UNDERLINE)
+        return self
+
+    def italic(self):
+        self.codes.append(self.ITALIC)
+        return self
+
+    def __str__(self) -> str:
+        self.codes.extend([self.parsed_string, self.RESET])
+        return "".join(self.codes)
+
+def paint(
+    *args: Any,
+    sep: str = " ",
+    end: str = "\n",
+    flush: bool = False,
+) -> Paint:
+    parsed_string = sep.join([str(arg) for arg in args])
+    return Paint(parsed_string, end, flush)

kopitools-1.0.0.dist-info/METADATA

@@ -0,0 +1,5 @@
+Metadata-Version: 2.5
+Name: kopitools
+Version: 1.0.0
+Summary: Logs, painted strings, system arguments...
+Requires-Python: >=3.9

kopitools-1.0.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+kopitools/__init__.py,sha256=_r8exNX21kB4rjMSyQEUF0vlMLwVKoYTAeKJ-gwDhh4,191
+kopitools/args/__init__.py,sha256=D6is6KRejlaw3lQAwOLX1lyXKiJD84Bz_W7WAEyeDtM,164
+kopitools/args/exceptions.py,sha256=yAY-jJDZDVjIJs1IFLPPrdtI_GbtI1NMxJMH8gKlcrM,88
+kopitools/args/option.py,sha256=pqT8x2WhB8Sqfk0RV4DDOQd0RQrcZMWCrq1TSG2-xRQ,958
+kopitools/args/registry.py,sha256=BF5kW29DjVwr5RjKIDdZzXi383nuFni9E3Bd3eR297E,1090
+kopitools/logs/__init__.py,sha256=vuxBTm-H1ZEPtVNMDCEKElqNFoOLViyO3oIgbCRNZyo,49
+kopitools/logs/logs.py,sha256=0CV7VUI17qLC0AVRfR5p9ANsztIfTy1KjL4PwSjD390,2126
+kopitools/paint/__init__.py,sha256=7g4JB1I2Lb0_SUqn-gTaxYLIPrAOya0C0J1PJMRPnKE,55
+kopitools/paint/paint.py,sha256=Ox0ta6UCUFdQL6IE7jXbOc6uwvY_pL30Nf5G02RkRhU,1977
+kopitools-1.0.0.dist-info/METADATA,sha256=n-gHuhNmbdGgm3TqIgFzvFehP-FgL7OHZoDKELNXlNQ,128
+kopitools-1.0.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+kopitools-1.0.0.dist-info/RECORD,,

kopitools-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any