dcicutils 8.8.4.1b20__py3-none-any.whl → 8.8.4.1b21__py3-none-any.whl

dcicutils/file_utils.py

@@ -10,6 +10,8 @@ from tempfile import gettempdir as get_temporary_directory
 from typing import List, Optional, Union
 from uuid import uuid4 as uuid
 
+HOME_DIRECTORY = str(pathlib.Path().home())
+
 
 def search_for_file(file: str,
                     location: Union[str, Optional[List[str]]] = None,
@@ -77,24 +79,43 @@ def search_for_file(file: str,
     return None if single is True else []
 
 
-def normalize_file_path(path: str, home_directory: bool = True) -> str:
+def normalize_path(value: Union[str, pathlib.Path], absolute: bool = False, home: Optional[bool] = None) -> str:
     """
-    Normalizes the given file path name and returns. Does things like remove multiple
-    consecutive slashes and redundant/unnecessary parent paths; if the home_directory
-    argument is True (the default) then also handles the special tilde home directory
-    component/convention and uses this in the result if applicable.
+    Normalizes the given path value and returns the result; does things like remove redundant
+    consecutive directory separators and redundant parent paths. If the given absolute argument
+    is True than converts the path to an absolute path. If the given home argument is True and
+    if the path can reasonably be represented with a home directory indicator (i.e. "~"), then
+    converts it to such. If the home argument is False and path starts with the home directory
+    indicator then expands it to the actual (absolute) home path. If the given value is not
+    actually even a string (or pathlib.Path) then returns an empty string.
     """
-    if not isinstance(path, str) or not path:
-        path = os.getcwd()
-    path = os.path.normpath(path)
-    home_directory = os.path.expanduser("~") if home_directory is True else None
-    if home_directory and path.startswith("~"):
-        path = os.path.join(home_directory, path[2 if path.startswith("~/") else 1:])
-    path = os.path.abspath(path)
-    if home_directory and (os.name == "posix"):
-        if path.startswith(home_directory) and path != home_directory:
-            path = "~/" + pathlib.Path(path).relative_to(home_directory).as_posix()
-    return path
+    if isinstance(value, pathlib.Path):
+        value = str(value)
+    elif not isinstance(value, str):
+        return ""
+    if not (value := value.strip()) or not (value := os.path.normpath(value)):
+        return ""
+    if home is False:
+        value = os.path.expanduser(value)
+    elif (home is True) and (os.name == "posix") and value.startswith(home := HOME_DIRECTORY + os.sep):
+        value = "~/" + value[len(home):]
+    if absolute is True:
+        value = os.path.abspath(value)
+    return value
+
+
+def get_file_size(file: str) -> Optional[int]:
+    try:
+        return os.path.getsize(file) if isinstance(file, str) else None
+    except Exception:
+        return None
+
+
+def get_file_modified_datetime(file: str) -> Optional[datetime]:
+    try:
+        return datetime.fromtimestamp(os.path.getmtime(file)) if isinstance(file, str) else None
+    except Exception:
+        return None
 
 
 def are_files_equal(filea: str, fileb: str) -> bool:

dcicutils/misc_utils.py

@@ -2551,6 +2551,19 @@ def normalize_spaces(value: str) -> str:
     return re.sub(r"\s+", " ", value).strip()
 
 
+def normalize_string(value: Optional[str]) -> Optional[str]:
+    """
+    Strips leading/trailing spaces, and converts multiple consecutive spaces to a single space
+    in the given string value and returns the result. If the given value is None returns an
+    empty string. If the given value is not actually even a string then return None.
+    """
+    if value is None:
+        return ""
+    elif isinstance(value, str):
+        return value.strip()
+    return None
+
+
 def find_nth_from_end(string: str, substring: str, nth: int) -> int:
     """
     Returns the index of the nth occurrence of the given substring within

{dcicutils-8.8.4.1b20.dist-info → dcicutils-8.8.4.1b21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dcicutils
-Version: 8.8.4.1b20
+Version: 8.8.4.1b21
 Summary: Utility package for interacting with the 4DN Data Portal and other 4DN resources
 Home-page: https://github.com/4dn-dcic/utils
 License: MIT

{dcicutils-8.8.4.1b20.dist-info → dcicutils-8.8.4.1b21.dist-info}/RECORD

@@ -28,7 +28,7 @@ dcicutils/es_utils.py,sha256=ZksLh5ei7kRUfiFltk8sd2ZSfh15twbstrMzBr8HNw4,7541
 dcicutils/exceptions.py,sha256=4giQGtpak-omQv7BP6Ckeu91XK5fnDosC8gfdmN_ccA,9931
 dcicutils/ff_mocks.py,sha256=6RKS4eUiu_Wl8yP_8V0CaV75w4ZdWxdCuL1CVlnMrek,36918
 dcicutils/ff_utils.py,sha256=oIhuZPnGtfwj6bWyCc1u23JbMB_6InPp01ZqUOljd8M,73123
-dcicutils/file_utils.py,sha256=Z80vdJD438hRIgIw__8emWb-75drGcRlGoYGOw-aCJk,9181
+dcicutils/file_utils.py,sha256=haP4JIqE5T0pmAY_pjibEIN8a98_B3v-BXq8fTifzL0,9905
 dcicutils/function_cache_decorator.py,sha256=XMyiEGODVr2WoAQ68vcoX_9_Xb9p8pZXdXl7keU8i2g,10026
 dcicutils/glacier_utils.py,sha256=Q4CVXsZCbP-SoZIsZ5NMcawDfelOLzbQnIlQn-GdlTo,34149
 dcicutils/http_utils.py,sha256=Je5ErNjR5e6lfSXGRncK_lcR_-zP38PIpmHjApy9Wi4,1289
@@ -44,7 +44,7 @@ dcicutils/license_policies/park-lab-gpl-pipeline.jsonc,sha256=vLZkwm3Js-kjV44nug
 dcicutils/license_policies/park-lab-pipeline.jsonc,sha256=9qlY0ASy3iUMQlr3gorVcXrSfRHnVGbLhkS427UaRy4,283
 dcicutils/license_utils.py,sha256=d1cq6iwv5Ju-VjdoINi6q7CPNNL7Oz6rcJdLMY38RX0,46978
 dcicutils/log_utils.py,sha256=7pWMc6vyrorUZQf-V-M3YC6zrPgNhuV_fzm9xqTPph0,10883
-dcicutils/misc_utils.py,sha256=eVZ3lEkDebweKCeza2GIo7x3qEqqkj61Ilr17eMFlR0,105744
+dcicutils/misc_utils.py,sha256=ZW2ElovbsrPoMFco6GmZ24zJHyvx6Ky-csr3TDlOli4,106213
 dcicutils/obfuscation_utils.py,sha256=fo2jOmDRC6xWpYX49u80bVNisqRRoPskFNX3ymFAmjw,5963
 dcicutils/opensearch_utils.py,sha256=V2exmFYW8Xl2_pGFixF4I2Cc549Opwe4PhFi5twC0M8,1017
 dcicutils/portal_object_utils.py,sha256=gDXRgPsRvqCFwbC8WatsuflAxNiigOnqr0Hi93k3AgE,15422
@@ -73,8 +73,8 @@ dcicutils/trace_utils.py,sha256=g8kwV4ebEy5kXW6oOrEAUsurBcCROvwtZqz9fczsGRE,1769
 dcicutils/validation_utils.py,sha256=cMZIU2cY98FYtzK52z5WUYck7urH6JcqOuz9jkXpqzg,14797
 dcicutils/variant_utils.py,sha256=2H9azNx3xAj-MySg-uZ2SFqbWs4kZvf61JnK6b-h4Qw,4343
 dcicutils/zip_utils.py,sha256=_Y9EmL3D2dUZhxucxHvrtmmlbZmK4FpSsHEb7rGSJLU,3265
-dcicutils-8.8.4.1b20.dist-info/LICENSE.txt,sha256=qnwSmfnEWMl5l78VPDEzAmEbLVrRqQvfUQiHT0ehrOo,1102
-dcicutils-8.8.4.1b20.dist-info/METADATA,sha256=dJrn_TgvyVIDnlFSUa0Ac2hiltJCAUr05WE6GcHPnlA,3440
-dcicutils-8.8.4.1b20.dist-info/WHEEL,sha256=7Z8_27uaHI_UZAc4Uox4PpBhQ9Y5_modZXWMxtUi4NU,88
-dcicutils-8.8.4.1b20.dist-info/entry_points.txt,sha256=51Q4F_2V10L0282W7HFjP4jdzW4K8lnWDARJQVFy_hw,270
-dcicutils-8.8.4.1b20.dist-info/RECORD,,
+dcicutils-8.8.4.1b21.dist-info/LICENSE.txt,sha256=qnwSmfnEWMl5l78VPDEzAmEbLVrRqQvfUQiHT0ehrOo,1102
+dcicutils-8.8.4.1b21.dist-info/METADATA,sha256=L64XCFbcLBijgZiY6g823l5rAh7tFDsYU1OmsD1KuKo,3440
+dcicutils-8.8.4.1b21.dist-info/WHEEL,sha256=7Z8_27uaHI_UZAc4Uox4PpBhQ9Y5_modZXWMxtUi4NU,88
+dcicutils-8.8.4.1b21.dist-info/entry_points.txt,sha256=51Q4F_2V10L0282W7HFjP4jdzW4K8lnWDARJQVFy_hw,270
+dcicutils-8.8.4.1b21.dist-info/RECORD,,