pangea-sdk 5.0.0__py3-none-any.whl → 5.2.0__py3-none-any.whl

pangea/utils.py

@@ -5,7 +5,7 @@ import copy
 import datetime
 import io
 import json
-from hashlib import new, sha1, sha256, sha512
+from hashlib import md5, new, sha1, sha256, sha512
 
 from google_crc32c import Checksum as CRC32C
 from pydantic import BaseModel
@@ -66,33 +66,97 @@ def canonicalize(data: dict) -> str:
         return str(data)
 
 
-def hash_sha256(data: str) -> str:
-    # Return sha256 hash in hex format
-    return sha256(data.encode("ascii")).hexdigest()
+def hash_sha256(input: str | io.BufferedReader) -> str:
+    # Return SHA256 hash in hex format
+    hash = sha256()
+    if isinstance(input, io.BufferedReader):
+        input.seek(0)  # restart reading
+        while True:
+            chunk = input.read(1024 * 1024)
+            if not chunk:
+                break
+            hash.update(chunk)
 
+        input.seek(0)  # restart reading
+    else:
+        hash.update(input.encode("utf-8"))
 
-def hash_256_filepath(filepath: str) -> str:
-    data = open(filepath, "rb")
-    hash = sha256(data.read()).hexdigest()
-    data.close()
-    return hash
+    return hash.hexdigest()
+
+
+def hash_sha1(input: str | io.BufferedReader) -> str:
+    # Return SHA1 hash in hex format
+    hash = sha1()
+    if isinstance(input, io.BufferedReader):
+        input.seek(0)  # restart reading
+        while True:
+            chunk = input.read(1024 * 1024)
+            if not chunk:
+                break
+            hash.update(chunk)
 
+        input.seek(0)  # restart reading
+    else:
+        hash.update(input.encode("utf-8"))
+
+    return hash.hexdigest()
 
-def hash_sha1(data: str) -> str:
-    # Return sha1 hash in hex format
-    return sha1(data.encode("ascii")).hexdigest()
 
+def hash_sha512(input: str | io.BufferedReader) -> str:
+    # Return SHA512 hash in hex format
+    hash = sha512()
+    if isinstance(input, io.BufferedReader):
+        input.seek(0)  # restart reading
+        while True:
+            chunk = input.read(1024 * 1024)
+            if not chunk:
+                break
+            hash.update(chunk)
+
+        input.seek(0)  # restart reading
+    else:
+        hash.update(input.encode("utf-8"))
 
-def hash_sha512(data: str) -> str:
-    # Return sha512 hash in hex format
-    return sha512(data.encode("ascii")).hexdigest()
+    return hash.hexdigest()
 
 
-def hash_ntlm(data: str):
-    # Calculate the NTLM hash
+def hash_ntlm(data: str) -> str:
+    # Return NTLM hash in hex format
     return new("md4", data.encode("utf-16le")).hexdigest()
 
 
+def hash_md5(input: str | io.BufferedReader) -> str:
+    # Return MD5 hash in hex format
+    hash = md5()
+    if isinstance(input, io.BufferedReader):
+        input.seek(0)  # restart reading
+
+        while True:
+            chunk = input.read(1024 * 1024)
+            if not chunk:
+                break
+            hash.update(chunk)
+
+        input.seek(0)  # restart reading
+    else:
+        hash.update(input.encode("utf-8"))
+
+    return hash.hexdigest()
+
+
+def get_crc32c(data: str) -> str:
+    crc = CRC32C()
+    crc.update(data)
+    return crc.hexdigest().decode("utf-8")
+
+
+def hash_256_filepath(filepath: str) -> str:
+    data = open(filepath, "rb")
+    hash = sha256(data.read()).hexdigest()
+    data.close()
+    return hash
+
+
 def get_prefix(hash: str, len: int = 5):
     return hash[0:len]
 
@@ -122,3 +186,10 @@ def get_file_upload_params(file: io.BufferedReader) -> FileUploadParams:
 
     file.seek(0)  # restart reading
     return FileUploadParams(crc_hex=crc.hexdigest().decode("utf-8"), sha256_hex=sha.hexdigest(), size=size)
+
+
+def get_file_size(file: io.BufferedReader) -> int:
+    file.seek(0, io.SEEK_END)
+    size = file.tell()
+    file.seek(0)  # restart reading
+    return size

{pangea_sdk-5.0.0.dist-info → pangea_sdk-5.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pangea-sdk
-Version: 5.0.0
+Version: 5.2.0
 Summary: Pangea API SDK
 Home-page: https://pangea.cloud/docs/sdk/python/
 License: MIT
@@ -17,11 +17,11 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Libraries
-Requires-Dist: aiohttp (>=3.10.10,<4.0.0)
-Requires-Dist: cryptography (>=43.0.1,<44.0.0)
-Requires-Dist: deprecated (>=1.2.14,<2.0.0)
+Requires-Dist: aiohttp (>=3.11.10,<4.0.0)
+Requires-Dist: cryptography (>=43.0.3,<44.0.0)
+Requires-Dist: deprecated (>=1.2.15,<2.0.0)
 Requires-Dist: google-crc32c (>=1.5.0,<2.0.0)
-Requires-Dist: pydantic (>=2.9.2,<3.0.0)
+Requires-Dist: pydantic (>=2.10.3,<3.0.0)
 Requires-Dist: python-dateutil (>=2.9.0,<3.0.0)
 Requires-Dist: requests (>=2.31.0,<3.0.0)
 Requires-Dist: requests-toolbelt (>=1.0.0,<2.0.0)
@@ -64,20 +64,21 @@ $ poetry add pangea-sdk
 #### Beta releases
 
 Pre-release versions may be available with the `b` (beta) denotation in the
-version number. These releases serve to preview beta services and APIs. Per
-Semantic Versioning, they are considered unstable and do not carry the same
-compatibility guarantees as stable releases. [Beta changelog](https://github.com/pangeacyber/pangea-python/blob/beta/CHANGELOG.md).
+version number. These releases serve to preview Beta and Early Access services
+and APIs. Per Semantic Versioning, they are considered unstable and do not carry
+the same compatibility guarantees as stable releases.
+[Beta changelog](https://github.com/pangeacyber/pangea-python/blob/beta/CHANGELOG.md).
 
 Via pip:
 
 ```bash
-$ pip3 install pangea-sdk==3.8.0b2
+$ pip3 install pangea-sdk==5.2.0b1
 ```
 
 Via poetry:
 
 ```bash
-$ poetry add pangea-sdk==3.8.0b2
+$ poetry add pangea-sdk==5.2.0b1
 ```
 
 ## Usage

{pangea_sdk-5.0.0.dist-info → pangea_sdk-5.2.0.dist-info}/RECORD

@@ -1,44 +1,47 @@
-pangea/__init__.py,sha256=Zdds_5hmg83isP-j_8g2vwcc4OKEfAo1e-7_8TV087Y,246
+pangea/__init__.py,sha256=9eKOhXARZe6eGTwrLyOBGfDQV02cZF1aQ4GVGjL1yyc,246
 pangea/asyncio/__init__.py,sha256=kjEMkqMQ521LlMSu5jn3_WgweyArwVZ2C-s3x7mR6Pk,45
 pangea/asyncio/file_uploader.py,sha256=wI7epib7Rc5jtZw4eJ1L1SlmutDG6CPv59C8N2UPhtY,1436
-pangea/asyncio/request.py,sha256=gsYH-pXZ6HRgOQeA4SwahCqqWnPN5j3yAPx8Vl-Vdys,17333
-pangea/asyncio/services/__init__.py,sha256=hMeTMnksGimg-fS_XMpRgh02a7BNcLYCt56tnChYeC4,356
-pangea/asyncio/services/audit.py,sha256=bZ7gdkVWkzqLqUVc1Wnf3oDAaCLg97-zTWhY8UdX0_Y,26549
+pangea/asyncio/request.py,sha256=BREsLY8_MCxGSplHbdKFZTzr4TX5ya0-BsXLffZhsco,17849
+pangea/asyncio/services/__init__.py,sha256=3IkiTqY_RtFndI7aoDTrb1yLv8xos_cKhmGS1TULcmw,386
+pangea/asyncio/services/audit.py,sha256=rPaCx4cMzj-g9WFMRIysFCJAz6Btp6YrhcKe_exky8k,26283
 pangea/asyncio/services/authn.py,sha256=rPeLJweL8mYH_t4ebcQn4n_Wglr3kClKNnCXNCimZU4,46622
-pangea/asyncio/services/authz.py,sha256=HgW9R8DeW19wS7fpgq0NWOx41wZWcn6NYS4NMbi8p1A,9482
-pangea/asyncio/services/base.py,sha256=4FtKtlq74NmE9myrgIt9HMA6JDnP4mPZ6krafWr286o,2663
+pangea/asyncio/services/authz.py,sha256=B_0_nhDMJcjNpjpCx3Vi2LDRhlmfV9325GKbUZ8reos,10025
+pangea/asyncio/services/base.py,sha256=vRFVcO_uEAGJte3OUUBLD43RoiiFB1vC7SPyN6yEMoA,3158
 pangea/asyncio/services/embargo.py,sha256=ctzj3kip6xos-Eu3JuOskrCGYC8T3JlsgAopZHiPSXM,3068
 pangea/asyncio/services/file_scan.py,sha256=PLG1O-PL4Yk9uY9D6NbMrZ5LHg70Z311s7bFe46UMZA,7108
-pangea/asyncio/services/intel.py,sha256=cCm3VwWxUzEUCNhuPCeejJvr4uOeLXuYDbDwTzNG6Aw,38121
+pangea/asyncio/services/intel.py,sha256=Iwz_DleAPtmd1taekT4W8lVo65uHjIvA4TQ7WUQGrRk,38306
 pangea/asyncio/services/redact.py,sha256=jRNtXr_DZ_cY7guhut-eZmOEhy2uN_VCXrjGH6bkh74,7265
-pangea/asyncio/services/sanitize.py,sha256=bf98J-s-P51oSKqNBgR0wj5mlHOCBwpjWz7k0NdXCKQ,7899
+pangea/asyncio/services/sanitize.py,sha256=4pRWBH595kFUXBkmu8euyk6H7F1M_-xXB2Qxnz6St6c,8627
+pangea/asyncio/services/share.py,sha256=YPJm_Gc4tfcx2cX6P_vLWIsHOR6M3RYy9LdU2UzEZbk,26791
 pangea/asyncio/services/vault.py,sha256=VqrJGSEdq6MlZRI6cJpkthhIsqLClSQdgVxwYCbIwEk,77079
 pangea/audit_logger.py,sha256=gRkCfUUT5LDNaycwxkhZUySgY47jDfn1ZeKOul4XCQI,3842
 pangea/config.py,sha256=mQUu8GX_6weIuv3vjNdG5plppXskXYASmxMWtFQh-hc,1662
 pangea/crypto/rsa.py,sha256=mwSiNy571KAGr3F6oEM0CXWkl9D023ch8ldbZZeLj_4,4747
-pangea/deep_verify.py,sha256=mocaGbC6XLbMTVWxTpMv4oJtXGPWpT-SbFqT3obpiZs,8443
+pangea/deep_verify.py,sha256=ZGraaL7TCxwRBIDqjBFR0clKlhAC-Yce6kD-1LClhG8,8616
 pangea/deprecated.py,sha256=IjFYEVvY1E0ld0SMkEYC1o62MAleX3nnT1If2dFVbHo,608
-pangea/dump_audit.py,sha256=1Je8D2fXwU4PWcZ-ZD4icfO3DNFvWqJkwsac4qFEhOo,7025
+pangea/dump_audit.py,sha256=IevqaUUh7GDepdIW7slSxeZbkPrWIVbcX3sr4DgpJXI,7090
 pangea/exceptions.py,sha256=OBtzUECpNa6vNp8ySkHC-tm4QjFRCOAHBkMHqzAlOu8,5656
 pangea/file_uploader.py,sha256=4RQ44xt-faApC61nn2PlwHT7XYrJ4GeQA8Ug4tySEAg,1227
 pangea/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pangea/request.py,sha256=So4sCa59ejlqpdhrGJ8Qj6JLmd2U8-YMrOnngCZykOs,24318
-pangea/response.py,sha256=rjQuTAHLSAB0m2uAsdbt11xUVL5cCGT4uTRzQhUz9hE,7321
-pangea/services/__init__.py,sha256=YPXqGGUlAm2oHQNArhDVfr6Y1Gq2o4nhwx_dpdKe74c,309
-pangea/services/audit/audit.py,sha256=IFv7jANA8S2SypQVS47x94_Cr5Z9zSsL9Dp9eXw9RHk,39593
+pangea/request.py,sha256=zxFvqbeGYtxN29nS8SPPZKlcGCqdUtenxaq84pQ4cxs,24807
+pangea/response.py,sha256=lPAcYsF9Xg166CiyhCofVmQA-W4jevh0MQXxUa8Re68,7737
+pangea/services/__init__.py,sha256=-QsZxRzRq_V1x1lmS_mu4310MNm0DkM4r6g6rfVGnOc,340
+pangea/services/audit/audit.py,sha256=7-c9l7jyGtpG7SqRUMpqsAzcUDhMZ5izgPalxHXsUvM,39320
 pangea/services/audit/exceptions.py,sha256=bhVuYe4ammacOVxwg98CChxvwZf5FKgR2DcgqILOcwc,471
 pangea/services/audit/models.py,sha256=1h1B9eSYQMYG3f8WNi1UcDX2-impRrET_ErjJYUnj7M,14678
 pangea/services/audit/signing.py,sha256=5A4hvPtpfP2kMz8bsiiKUACriXbh5dv9gb_rbqiUtuI,5583
 pangea/services/audit/util.py,sha256=Zq1qvfeplYfhCP_ud5YMvntSB0UvnCdsuYbOzZkHbjg,7620
 pangea/services/authn/authn.py,sha256=cZKl2Ixc6HwHnkRecpSaAGTQUgaZUtxfLa0T3S03HMs,45478
 pangea/services/authn/models.py,sha256=HH5su6jx3O9AwVGzASXZ99-eIWjgXEP5LhIVdewM13s,22394
-pangea/services/authz.py,sha256=HfDnovAokzAHvnjYdOCwceM-1sCmzODnjNEbQBUSfo8,12222
-pangea/services/base.py,sha256=lwhHoe5Juy28Ir3Mfj2lHdM58gxZRaxa2SRFi4_DBRw,3453
+pangea/services/authz.py,sha256=bB0ZEUuXLT7Xjs5kZef1hZK6Du6VUusHe5aekNaxamw,12746
+pangea/services/base.py,sha256=43pWQcR9CeT4sGzgctF3Sy4M_h7DaUzkuZD2Z7CcDUU,3845
 pangea/services/embargo.py,sha256=9Wfku4td5ORaIENKmnGmS5jxJJIRfWp6Q51L36Jsy0I,3897
 pangea/services/file_scan.py,sha256=QiO80uKqB_BnAOiYQKznXfxpa5j40qqETE3-zBRT_QE,7813
-pangea/services/intel.py,sha256=CziBhC5K6O_kBXpD8zgJLpDtLHzBRgATGW4gHHFJT48,52039
-pangea/services/redact.py,sha256=ZYXkzEoriLJyCqaj5dqmgsC56mIz4T3pPToZ7TcNfhg,11465
-pangea/services/sanitize.py,sha256=XP5D4CcbCZfzgU567X6H5eFBWwZuYSsHdvsdrQAZekY,12767
+pangea/services/intel.py,sha256=flVdK4WhllPutCkWh7H-MuBxMMz0f4Bl-fz2f-hPuWM,52679
+pangea/services/redact.py,sha256=nst-mfxI7ewkDSSVVoY9cznMgb7EY9TGCjD6ZpPGvY4,12128
+pangea/services/sanitize.py,sha256=D_R_XIe9FvRCX40b8b_3gouhAGduDdxI9bT2w-kiVHU,13444
+pangea/services/share/file_format.py,sha256=1svO1ee_aenA9zoO_AaU-Rk5Ulp7kcPOc_KwNoluyQE,2797
+pangea/services/share/share.py,sha256=8N4zXQJjkVDf2iR62pz6xpmxlbXRPNfHgYfOuEdNaZ8,46333
 pangea/services/vault/models/asymmetric.py,sha256=vspijmEvHm5WXri_fjOWfQc4maYyZfhDkLuaTM8-PZo,4991
 pangea/services/vault/models/common.py,sha256=PSZRFqHTUtEMJJGwywEFM2AU3aV8S-sbcoo3LLQ6uTc,17981
 pangea/services/vault/models/keys.py,sha256=duAuTiOby_D7MloRvN4gNj0P-b-jx9sdtplAWFxsShw,2786
@@ -46,8 +49,8 @@ pangea/services/vault/models/secret.py,sha256=ItGdkulM-SEySfcm4a5yGxMvo_omjC7kCh
 pangea/services/vault/models/symmetric.py,sha256=t8xCM1wGGKDBpOqTggFueO4-4-2IFmyxqcs7_PDr7U0,2562
 pangea/services/vault/vault.py,sha256=ow-Zm7PYzfWIfUcA4UNnpeL2DHfZM4C7inRDmNR3zQU,76196
 pangea/tools.py,sha256=2-Y4SAHWFv6Ocj42J_bWrVy27M5G3wi7a8LJn0dabHc,6427
-pangea/utils.py,sha256=TmrlLjnyfQyXoLjhAWp1AGtGW1uMQ57fPgJZ5LhvTJk,3199
+pangea/utils.py,sha256=dZ6MwFVEWXUgXvvDg-k6JnvVfsgslvtaBd7ez7afrqk,4983
 pangea/verify_audit.py,sha256=nSP17OzoSPdvezRExwfcf45H8ZPZnxZu-CbEp3qFJO0,17354
-pangea_sdk-5.0.0.dist-info/METADATA,sha256=OprGX1fUL_TfybyBl6SHQhr0Pze0Mzeuo_8TGt5qzys,7495
-pangea_sdk-5.0.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-pangea_sdk-5.0.0.dist-info/RECORD,,
+pangea_sdk-5.2.0.dist-info/METADATA,sha256=0_T3gGYHKgvjYYIsf9UgTtm5B5tWAqLx8DtPqm4ny0E,7513
+pangea_sdk-5.2.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+pangea_sdk-5.2.0.dist-info/RECORD,,