kbasic 0.1.38__tar.gz → 0.1.39__tar.gz

{kbasic-0.1.38 → kbasic-0.1.39}/PKG-INFO

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

{kbasic-0.1.38 → kbasic-0.1.39}/pyproject.toml

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

{kbasic-0.1.38 → kbasic-0.1.39}/src/kbasic/parsing/basic.py

@@ -3,13 +3,14 @@
 # >-|===|>                             Imports                             <|===|-<
 # !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
 from os import remove
-from os.path import split, splitext, splitroot, exists, isdir, isfile
+from os.path import split, splitext, splitroot, exists, isdir, isfile, abspath
 from shutil import copy, move, copytree, rmtree
 from typing import Self, Optional
 from glob import glob
 from pathlib import Path as builtinPath
 from kbasic.parsing.utils import ensure_path
 from kbasic.user_input import yesno
+from kbasic.typing import Array
 
 # !==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==!==
 # >-|===|>                           Definitions                           <|===|-<
@@ -37,7 +38,7 @@ class File:
         if type(path)==type(self):
             self = path
             return None
-        self.path: str = str(builtinPath(path).resolve())
+        self.path: str = abspath(str(builtinPath(path).resolve()))
         self.master = master if not isinstance(master, str) else File(master)
         self.verbose = verbose
         self.loaded: bool = False
@@ -45,10 +46,9 @@ class File:
         self.title, self.extension = splitext(self.name)
         self.drive, self.root, _ = splitroot(self.path)
         self.parent = Folder(parentpath)
-        self.grandparent = self.parent.parent
-        self.greatgrandparent = self.parent.parent.parent
         self.lines = []
-    def __repr__(self) -> str: return self.path
+    def __repr__(self) -> str: 
+        return self.path
     def __str__(self) -> str:
         if not self.loaded: self.read()
         return "\n".join(self.lines)
@@ -73,6 +73,10 @@ class File:
             bool: _description_
         """
         return exists(self.path)
+    @property
+    def writeable(self) -> bool:
+        """whether or not we can write this type of file with this object"""
+        return self.extension in unreadable_file_types
     def copy(self, destination:str):
         """_summary_
 
@@ -112,7 +116,7 @@ class File:
     def load(self) -> None:
         """docstring"""
         self.read()
-    def save(self, interactive=True):
+    def save(self, interactive=True) -> None:
         """summary"""
         if interactive and not yesno(
             f"Are you sure you want to permanently overwrite {self.path}?\n"
@@ -124,15 +128,26 @@ class File:
                     f"attempted to save unwritable file: {self.path}"
                     )
             file.writelines("\n".join(self.lines))
+    def write(self, text: str | Array, interactive=False) -> None:
+        """add text to this File.lines then save the file"""
+        match text:
+            case str(): 
+                self.lines.append(text)
+            case _ if type(text) in Array.types: 
+                self.lines += list(text)
+            case _: 
+                raise TypeError(f"must supply either string or an array of strings\nwas given text of type: {type(text)}")
+        self.save(interactive=interactive)
 
 class Folder:
     def __init__(
         self, path: str|Self,
         master: Optional[Self] = None
     ) -> None:
+        if path is None: return None
         if type(path)==type(self):
             path = path.path
-        self.path = str()
+        self.path = abspath(str(builtinPath(path).resolve()))
         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
@@ -161,6 +176,9 @@ class Folder:
     def __radd__(self, other):
         if other==0: return [self]
         return self.__add__(other)
+    def __div__(self, other):
+        match other:
+            case str(): return Path(f"{self.path}/{other}")
     @property
     def parent(self) -> Self:
         """summary"""