kbasic 0.3.17__tar.gz → 0.3.18__tar.gz

{kbasic-0.3.17 → kbasic-0.3.18}/PKG-INFO

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

{kbasic-0.3.17 → kbasic-0.3.18}/pyproject.toml

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

{kbasic-0.3.17 → kbasic-0.3.18}/src/kbasic/parsing/basic.py

@@ -1,10 +1,13 @@
-"""the bulk of kbasics path logic lives here."""
-# !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
-# >-|===|>                             Imports                             <|===|-<
-# !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
-from os import remove, system, walk
-from os.path import split, splitext, splitroot, exists, isdir, isfile, abspath, \
-    expanduser, expandvars, basename
+"""
+the bulk of kbasics path logic lives here. File and Folder will both work for anything that accepts
+an os.PathLike argument, such as the builtin open function.
+"""
+# !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
+# >-|===|>                                    Imports                                     <|===|-<
+# !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
+from os import remove, system
+from os.path import split, splitext, splitroot, exists, isdir, isfile, abspath, expanduser,\
+    expandvars
 from shutil import copy, move, copytree, rmtree
 from typing import Self, Optional
 from glob import glob
@@ -49,11 +52,8 @@ class File:
         self.drive, self.root, _ = splitroot(self.path)
         self.parent = Folder(parentpath)
         self.lines = []
-    def __repr__(self) -> str:
-        return self.path
-    def __str__(self) -> str:
-        if not self.loaded: self.read()
-        return "\n".join(self.lines)
+    def __repr__(self) -> str: return self.path
+    def __str__(self) -> str: return self.path
     def __eq__(self, other) -> bool:
         if type(other) != File: return False
         return (self.path == other.path) & (self.lines == other.lines)
@@ -89,7 +89,8 @@ class File:
         Args:
             destination (str): _description_
         """
-        if destination is None: destination = str(self.parent / f"{self.title}-copy{self.extension}")
+        if destination is None:
+            destination = str(self.parent / f"{self.title}-copy{self.extension}")
         copy(self.path, destination)
         return File(destination, verbose=self.verbose, master=self)
     def move(self, destination:str):
@@ -168,13 +169,7 @@ class Folder:
         self.master = master if not isinstance(master, str) else Folder(master)
         self.parentpath, self.name = split(self.path)
     def __repr__(self) -> str: return self.path
-    def __str__(self) -> str:
-        output = []
-        for root, dirs, files in walk(self.path):
-            level = root.replace(self.path, '').count('/')
-            output.append(f'{'----'*level}{basename(root)}')
-            for f in files: output.append(f'|{'----'*(level+1)}> {f}')
-        return '\n'.join(output)
+    def __str__(self) -> str: return self.path
     def __len__(self) -> int: return len(self.children)
     def __iter__(self):
         self.index = 0

{kbasic-0.3.17 → kbasic-0.3.18}/src/kbasic/vectors.py

@@ -1,10 +1,12 @@
+# !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
+# =>> KBASIC.VECTOR <<=
+# !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
 """Implement vector classes for vector analysis"""
 # !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
 # >-|===|>                                    Imports                                     <|===|-<
 # !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
 from typing import Self
 from collections.abc import Generator
-from functools import total_ordering
 from numpy import array, cos, sin, sqrt, exp, sum
 from kbasic.typing import Number, Array
 
@@ -135,6 +137,8 @@ class VectorBase:
                 return type(self)(other//c for c in self)
             case Array():
                 return type(self)(c2//c1 for c1, c2 in zip(self, other))
+
+
 class Vector(VectorBase):
     def __new__(cls, *components) -> Self: # the vector factory
         match components:
@@ -161,11 +165,15 @@ class Vector(VectorBase):
                 return VectorBase(*components)
             case x:
                 raise TypeError(f"given components:\n{components}\nof type: {type(x)}")
+
+
 class Norm(VectorBase):
     def __init__(self, *components):
         self.components = components
         gen = (x/abs(self) for x in self)
         super().__init__(gen)
+
+
 class Quaternion(Norm):
     def __init__(self, angle, axis):
         q0 = cos(angle/2)
@@ -173,6 +181,8 @@ class Quaternion(Norm):
         self.axis *= sin(angle/2)
         self.axis *= sqrt(1-q0**2)/abs(self.axis)
         super().__init__(q0, *self.axis.components)
+
+
 class R2(VectorBase):
     def __init__(self, *components):
         super().__init__(*components)
@@ -185,6 +195,8 @@ class R2(VectorBase):
         r_rotated = r * exp(1j*angle)
         self.__init__(r_rotated.real, r_rotated.imag)
         return self
+
+
 class R3(VectorBase):
     def __init__(self, *components):
         super().__init__(*components)