pathpilot 0.3.0__tar.gz → 0.3.2__tar.gz

{pathpilot-0.3.0 → pathpilot-0.3.2}/PKG-INFO

@@ -1,7 +1,8 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.1
 Name: pathpilot
-Version: 0.3.0
+Version: 0.3.2
 Summary: Library that facilitates file and folder manipulation in Python.
+Home-page: https://github.com/zteinck/pathpilot
 License: MIT
 Author: Zachary Einck
 Author-email: zacharyeinck@gmail.com
@@ -13,14 +14,12 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: XlsxWriter
 Requires-Dist: cachegrab (>=0.2.2)
 Requires-Dist: clockwork (>=0.3.4)
 Requires-Dist: numpy
 Requires-Dist: oddments (>=0.3.1)
 Requires-Dist: pandas
-Project-URL: Homepage, https://github.com/zteinck/pathpilot
 Project-URL: Repository, https://github.com/zteinck/pathpilot
 Description-Content-Type: text/markdown
 
@@ -43,7 +42,7 @@ pip install pathpilot
 
 
 ## Main Features
-- `File` ➔ Function that assigns new file instances to the correct child class. Many file types are supported natively including: *.xlsx*, *.csv*, *.txt*, *.pickle*, etc. The mapping of file extensions to their respective classes is managed using the `extension_mapping` global dictionary. Unmapped extensions are assigned to the `FileBase` class.
+- `file_factory` ➔ Function that assigns new file instances to the correct child class. Many file types are supported natively including: *.xlsx*, *.csv*, *.txt*, *.pickle*, etc. The mapping of file extensions to their respective classes is managed using the `extension_mapping` global dictionary. Unmapped extensions are assigned to the `FileBase` class.
 - `Folder` ➔ Class for interacting with folders. It is important to be mindful of the `read_only` parameter which, if set to `True`, allows folders to be created or deleted programically.
 
 
@@ -52,7 +51,7 @@ Please note the examples below represent a small fraction of the functionality o
 
 ### Imports
 ```python
-from pathpilot import Folder, File
+from pathpilot import Folder, file_factory
 ```
 
 ### Folders
@@ -80,10 +79,10 @@ new_years_file = january_folder.join('Happy New Year.txt')
 ```
 
 ### Files
-First, we create an instance of the `ExcelFile` class using the `File` function. This occurs automatically by virtue of the `.xlsx` file extension.
+First, we create an instance of the `ExcelFile` class using the `file_factory` function. This occurs automatically by virtue of the `.xlsx` file extension.
 ```python
 # create ExcelFile instance
-file = File(r'C:\Users\MyID\Documents\MyFolder\MyFile.xlsx')
+file = file_factory(r'C:\Users\MyID\Documents\MyFolder\MyFile.xlsx')
 ```
 
 Next, let's check if the file exists. If not, let's save a `pandas` `DataFrame` as an Excel file.
@@ -101,7 +100,7 @@ Creating MyFile.xlsx
 
 Now let's read the file we created as a `DataFrame`.
 ```python
-# read the file we created as a pd.DataFrame 
+# read the file we created as a pd.DataFrame
 df = file.read()
 ```
 

{pathpilot-0.3.0 → pathpilot-0.3.2}/README.md

@@ -17,7 +17,7 @@ pip install pathpilot
 
 
 ## Main Features
-- `File` ➔ Function that assigns new file instances to the correct child class. Many file types are supported natively including: *.xlsx*, *.csv*, *.txt*, *.pickle*, etc. The mapping of file extensions to their respective classes is managed using the `extension_mapping` global dictionary. Unmapped extensions are assigned to the `FileBase` class.
+- `file_factory` ➔ Function that assigns new file instances to the correct child class. Many file types are supported natively including: *.xlsx*, *.csv*, *.txt*, *.pickle*, etc. The mapping of file extensions to their respective classes is managed using the `extension_mapping` global dictionary. Unmapped extensions are assigned to the `FileBase` class.
 - `Folder` ➔ Class for interacting with folders. It is important to be mindful of the `read_only` parameter which, if set to `True`, allows folders to be created or deleted programically.
 
 
@@ -26,7 +26,7 @@ Please note the examples below represent a small fraction of the functionality o
 
 ### Imports
 ```python
-from pathpilot import Folder, File
+from pathpilot import Folder, file_factory
 ```
 
 ### Folders
@@ -54,10 +54,10 @@ new_years_file = january_folder.join('Happy New Year.txt')
 ```
 
 ### Files
-First, we create an instance of the `ExcelFile` class using the `File` function. This occurs automatically by virtue of the `.xlsx` file extension.
+First, we create an instance of the `ExcelFile` class using the `file_factory` function. This occurs automatically by virtue of the `.xlsx` file extension.
 ```python
 # create ExcelFile instance
-file = File(r'C:\Users\MyID\Documents\MyFolder\MyFile.xlsx')
+file = file_factory(r'C:\Users\MyID\Documents\MyFolder\MyFile.xlsx')
 ```
 
 Next, let's check if the file exists. If not, let's save a `pandas` `DataFrame` as an Excel file.
@@ -75,7 +75,7 @@ Creating MyFile.xlsx
 
 Now let's read the file we created as a `DataFrame`.
 ```python
-# read the file we created as a pd.DataFrame 
+# read the file we created as a pd.DataFrame
 df = file.read()
 ```
 

{pathpilot-0.3.0 → pathpilot-0.3.2}/pathpilot/__init__.py

@@ -3,5 +3,5 @@ from .decorators import *
 from .exceptions import *
 from .utils import *
 
-__version__ = '0.3.0'
+__version__ = '0.3.2'
 __author__ = 'Zachary Einck <zacharyeinck@gmail.com>'

{pathpilot-0.3.0 → pathpilot-0.3.2}/pathpilot/_file/_excel.py

@@ -828,16 +828,19 @@ class ExcelFile(FileBase):
                 fmt if s.sum() - s.round().sum() == 0 \
                 else f'{fmt}_two_decimals'
 
+            clean_abs_numeric = lambda x: \
+                pd.to_numeric(x, errors='coerce').dropna().abs()
+
             for k in numeric_columns:
                 if not df[k].isna().all():
-                    s = df[k].dropna().abs()
+                    s = clean_abs_numeric(df[k])
                     if s.max() >= 1000:
                         data_format[k] = infer_format('commas', s)
 
             for k in percent_columns:
                 if not df[k].isna().all():
-                    s = df[k].dropna().abs()
-                    if s[s > 0].min() >= 1:
+                    s = clean_abs_numeric(df[k])
+                    if s.where(s > 0).min() >= 1:
                         df[k] /= 100
                     else:
                         s *= 100

{pathpilot-0.3.0 → pathpilot-0.3.2}/pathpilot/_file/base.py

@@ -461,7 +461,7 @@ class FileBase(object):
 
 
     def deep_copy(self):
-        ''' create a copy of the File object '''
+        ''' create a copy of the file object '''
         return self.spawn(self.path)
 
 

{pathpilot-0.3.0 → pathpilot-0.3.2}/pathpilot/_folder/base.py

@@ -781,7 +781,7 @@ class Folder(object):
 
         Returns
         ----------
-        out : Folder | File
+        out : object
             folder or file object
         '''
         self.validate_join_args(args)

{pathpilot-0.3.0 → pathpilot-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pathpilot"
-version = "0.3.0"
+version = "0.3.2"
 description = "Library that facilitates file and folder manipulation in Python."
 authors = ["Zachary Einck <zacharyeinck@gmail.com>"]
 license = "MIT"