dcicutils 8.8.4.1b7__tar.gz → 8.8.4.1b9__tar.gz

{dcicutils-8.8.4.1b7 → dcicutils-8.8.4.1b9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dcicutils
-Version: 8.8.4.1b7
+Version: 8.8.4.1b9
 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.1b7 → dcicutils-8.8.4.1b9}/dcicutils/file_utils.py

@@ -1,7 +1,10 @@
 import glob
 import os
 import pathlib
+import random
+import string
 from typing import List, Optional, Union
+from dcicutils.tmpfile_utils import create_temporary_file_name
 
 
 def search_for_file(file: str,
@@ -76,3 +79,36 @@ def normalize_file_path(path: str, home_directory: bool = True) -> str:
         if path.startswith(home_directory) and path != home_directory:
             path = "~/" + pathlib.Path(path).relative_to(home_directory).as_posix()
     return path
+
+
+def are_files_equal(filea: str, fileb: str) -> bool:
+    """
+    Returns True iff the contents of the two given files are exactly the same.
+    """
+    try:
+        with open(filea, "rb") as fa:
+            with open(fileb, "rb") as fb:
+                chunk_size = 4096
+                while True:
+                    chunka = fa.read(chunk_size)
+                    chunkb = fb.read(chunk_size)
+                    if chunka != chunkb:
+                        return False
+                    if not chunka:
+                        break
+        return True
+    except Exception:
+        return False
+
+
+def create_random_file(file: Optional[str] = None,
+                       prefix: Optional[str] = None, suffix: Optional[str] = None,
+                       nbytes: int = 1024, binary: bool = False) -> str:
+    if not file:
+        file = create_temporary_file_name(prefix=prefix, suffix=suffix)
+    with open(file, "wb" if binary is True else "w") as f:
+        if binary is True:
+            f.write(os.urandom(nbytes))
+        else:
+            f.write(''.join(random.choices(string.ascii_letters + string.digits, k=nbytes)))
+    return file

{dcicutils-8.8.4.1b7 → dcicutils-8.8.4.1b9}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "dcicutils"
-version = "8.8.4.1b7"  # TODO: To become 8.8.5
+version = "8.8.4.1b9"  # TODO: To become 8.8.5
 description = "Utility package for interacting with the 4DN Data Portal and other 4DN resources"
 authors = ["4DN-DCIC Team <support@4dnucleome.org>"]
 license = "MIT"