kbasic 0.1.32__tar.gz → 0.1.34__tar.gz

{kbasic-0.1.32 → kbasic-0.1.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kbasic
-Version: 0.1.32
+Version: 0.1.34
 Summary: Keyan's basic utility functions.
 Author: Keyan Gootkin
 Author-email: Keyan Gootkin <keyangootkin@gmail.com>

{kbasic-0.1.32 → kbasic-0.1.34}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kbasic"
-version = "0.1.32"
+version = "0.1.34"
 description = "Keyan's basic utility functions."
 readme = "README.md"
 authors = [

{kbasic-0.1.32 → kbasic-0.1.34}/src/kbasic/parsing.py

@@ -3,8 +3,11 @@
 # !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
 #pysim imports
 from kbasic.user_input import yesno
+from kbasic.typing import Array, Number
 #nonpysim imports
-from typing import Self, Optional
+from time import time
+from datetime import datetime
+from typing import Self, Optional, Callable
 from numpy import ndarray
 from glob import glob 
 from shutil import copy, move, copytree, rmtree
@@ -49,7 +52,10 @@ def could_be_path(path: str) -> bool:
         bool: True if the first two members of the path are valid else False.
     """
     return isdir('/'.join(path.split('/')[:2])) 
-
+def default_log_formater(msg: str) -> str:
+    return f"{str(datetime.now())}: {msg}"
+def delta_log_formater(msg: str, start_time: Number) -> str:
+    return f"Δt: {(time()-start_time)*1e6:.1f} μs | {msg}"
 # !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
 # >-|===|>                             Classes                             <|===|-<
 # !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
@@ -64,7 +70,8 @@ class File:
             verbose (bool, optional): should this file be annoying. Defaults to 
                                         False.
         """
-        if type(path)==type(self): 
+        if path is None: return None
+        elif type(path)==type(self): 
             self = path
             return None
         self.path: str = clean_path(path)
@@ -114,6 +121,14 @@ class File:
         with open(self.path, 'w+') as file:
             if not file.writable: raise PermissionError(f"attempted to save unwritable file: {self.path}")
             file.writelines("\n".join(self.lines))
+class Log(File):
+    def __init__(self, path: str | Self, verbose: bool = False, fmt: Callable[str] = default_log_formater):
+        File.__init__(self, path, verbose=verbose)
+        self.fmt = fmt
+    def __call__(self, msg: Array[str]|str, *args, **kwds):
+        match msg:
+            case str(): self.lines.append(self.fmt(msg, *args, **kwds))
+            case _ if type(msg) in Array.types: self.lines += [self.fmt(m, *args, **kwds) for m in msg]
 class TOML(File):
     def __init__(self, path: str, verbose: bool = False):
         File.__init__(self, path, verbose=verbose)