pathpilot 0.4.6__tar.gz → 0.6.0__tar.gz

{pathpilot-0.4.6 → pathpilot-0.6.0}/PKG-INFO

@@ -1,7 +1,7 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: pathpilot
-Version: 0.4.6
-Summary: Library that facilitates file and folder manipulation in Python.
+Version: 0.6.0
+Summary: Simplifies file and folder manipulation
 Project-URL: repository, https://github.com/zteinck/pathpilot
 Project-URL: homepage, https://github.com/zteinck/pathpilot
 Author-email: Zachary Einck <zacharyeinck@gmail.com>

{pathpilot-0.4.6 → pathpilot-0.6.0}/pathpilot/__init__.py

@@ -7,7 +7,12 @@ from .core import (
 
 from ._folder import *
 from ._file import *
-from .decorators import check_read_only
+
+from .decorators import (
+    check_read_only,
+    assert_exists,
+    )
+
 from .exceptions import ReadOnlyError
 
 from .utils import (
@@ -21,5 +26,5 @@ from .utils import (
     get_modified_date,
     )
 
-__version__ = '0.4.6'
+__version__ = '0.6.0'
 __author__ = 'Zachary Einck <zacharyeinck@gmail.com>'

{pathpilot-0.4.6 → pathpilot-0.6.0}/pathpilot/_file/kinds/_csv.py

@@ -3,7 +3,11 @@ import oddments as odd
 import pandas as pd
 import polars as pl
 
-from ...decorators import check_read_only
+from ...decorators import (
+    assert_exists,
+    check_read_only,
+    )
+
 from ..base import DfDispatchFile
 
 
@@ -21,6 +25,16 @@ class CsvFile(DfDispatchFile):
     #| Instance Methods                                                        |
     #╰-------------------------------------------------------------------------╯
 
+    @assert_exists
+    def scan(self, **kwargs):
+        return pl.scan_csv(self.path, **kwargs)
+
+
+    @check_read_only
+    def sink(self, lf, **kwargs):
+        lf.sink_csv(self.path, **kwargs)
+
+
     def _read_with_pandas(self, **kwargs):
         defaults = {
             'encoding': 'ISO-8859-1',
@@ -41,13 +55,4 @@ class CsvFile(DfDispatchFile):
 
 
     def _save_with_polars(self, obj, **kwargs):
-        obj.write_csv(self.path, **kwargs)
-
-
-    def scan(self, **kwargs):
-        return pl.scan_csv(self.path, **kwargs)
-
-
-    @check_read_only
-    def sink(self, lf, **kwargs):
-        lf.sink_csv(self.path, **kwargs)
+        obj.write_csv(self.path, **kwargs)

{pathpilot-0.4.6 → pathpilot-0.6.0}/pathpilot/_file/kinds/_excel.py

@@ -507,6 +507,10 @@ class ExcelFile(DfDispatchFile):
         char_limit = 31
         name = name[:char_limit]
 
+        # Excel forbids certain characters
+        forbidden_chars = {':','\\','/','?','*','[',']'}
+        name = ''.join('-' if x in forbidden_chars else x for x in name)
+
         # ensure truncated sheet names are unique
         sheet_names = set(self.sheet_names)
 

{pathpilot-0.4.6 → pathpilot-0.6.0}/pathpilot/_file/kinds/_parquet.py

@@ -1,5 +1,10 @@
 import polars as pl
 
+from ...decorators import (
+    assert_exists,
+    check_read_only,
+    )
+
 from ..base import File
 
 
@@ -17,11 +22,17 @@ class ParquetFile(File):
     #| Instance Methods                                                        |
     #╰-------------------------------------------------------------------------╯
 
+    @assert_exists
     def scan(self, **kwargs):
         lf = pl.scan_parquet(self.path, **kwargs)
         return lf
 
 
+    @check_read_only
+    def sink(self, lf, **kwargs):
+        lf.sink_parquet(self.path, **kwargs)
+
+
     def read(self, **kwargs):
         df = pl.read_parquet(self.path, **kwargs)
         return df

{pathpilot-0.4.6 → pathpilot-0.6.0}/pathpilot/decorators.py

@@ -21,4 +21,18 @@ def inject_read_only(func):
         params = {'read_only': self.read_only} | kwargs
         return func(self, *args, **params)
 
+    return wrapper
+
+
+def assert_exists(func):
+
+    @wraps(func)
+    def wrapper(self, *args, **kwargs):
+        if not self.exists:
+            raise FileNotFoundError(
+                f"Cannot execute '{func.__name__}()' because the path does "
+                f"not exist:\n{self.path}"
+                )
+        return func(self, *args, **kwargs)
+
     return wrapper

{pathpilot-0.4.6 → pathpilot-0.6.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "pathpilot"
-version = "0.4.6"
-description = "Library that facilitates file and folder manipulation in Python."
+version = "0.6.0"
+description = "Simplifies file and folder manipulation"
 authors = [
     { name = "Zachary Einck", email = "zacharyeinck@gmail.com" }
 ]

{pathpilot-0.4.6 → pathpilot-0.6.0}/uv.lock

@@ -202,7 +202,7 @@ wheels = [
 
 [[package]]
 name = "pathpilot"
-version = "0.4.6"
+version = "0.6.0"
 source = { editable = "." }
 dependencies = [
     { name = "cachegrab" },