pypomes-crypto 0.1.1__tar.gz

pypomes_crypto-0.1.1/.gitignore

@@ -0,0 +1,10 @@
+.idea
+.env
+temp
+tmp
+**/__pycache__
+/dist
+/env
+.vscode
+*.py[cod]
+deploy.txt

pypomes_crypto-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 GT Nunes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pypomes_crypto-0.1.1/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.1
+Name: pypomes_crypto
+Version: 0.1.1
+Summary: A collection of Python pomes, pennyeach (cryptography modules)
+Project-URL: Homepage, https://github.com/TheWiseCoder/PyPomes-Crypto
+Project-URL: Bug Tracker, https://github.com/TheWiseCoder/PyPomes-Crypto/issues
+Author-email: GT Nunes <wisecoder01@gmail.com>
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: asn1crypto>=1.5.1
+Requires-Dist: cryptography>=41.0.1
+Requires-Dist: pip>=23.1.2
+Requires-Dist: pypomes-core>=0.1.1
+Requires-Dist: setuptools>=68.0.0
+Requires-Dist: wheel>=0.40.0

pypomes_crypto-0.1.1/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = [
+    "hatchling"
+]
+build-backend = "hatchling.build"
+
+[project]
+name = "pypomes_crypto"
+version = "0.1.1"
+authors = [
+  { name="GT Nunes", email="wisecoder01@gmail.com" },
+]
+description = "A collection of Python pomes, pennyeach (cryptography modules)"
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "asn1crypto>=1.5.1",
+    "cryptography>=41.0.1",
+    "pip>=23.1.2",
+    "pypomes_core>=0.1.1",
+    "setuptools>=68.0.0",
+    "wheel>=0.40.0"
+]
+
+[project.urls]
+"Homepage" = "https://github.com/TheWiseCoder/PyPomes-Crypto"
+"Bug Tracker" = "https://github.com/TheWiseCoder/PyPomes-Crypto/issues"

pypomes_crypto-0.1.1/src/pypomes_crypto/__init__.py

@@ -0,0 +1,11 @@
+from .crypto_pomes import (
+    CRYPTO_HASH_ALGORITHM, crypto_hash
+)
+
+__all__ = [
+    # crypto_pomes
+    CRYPTO_HASH_ALGORITHM, crypto_hash
+]
+
+__version__ = "0.1.1"
+__version_info__ = (0, 1, 1)

pypomes_crypto-0.1.1/src/pypomes_crypto/crypto_pomes.py

@@ -0,0 +1,39 @@
+import hashlib
+import os
+from typing import Final
+from pypomes_core.env_pomes import APP_PREFIX, env_get_str
+
+CRYPTO_HASH_ALGORITHM: Final[str] = env_get_str(f"{APP_PREFIX}_DEFAULT_HASH_ALGORITHM", "sha256")
+
+
+def crypto_hash(msg: str | bytes, alg: str = CRYPTO_HASH_ALGORITHM) -> bytes:
+    """
+    Compute the hash of *msg*, using the algorithm specified in *alg*.
+    Return *None* if computing the hash not possible.
+
+    Supported algorithms: md5, blake2b, blake2s, sha1, sha224, sha256, sha384 sha512,
+    sha3_224, sha3_256, sha3_384, sha3_512, shake_128, shake_256.
+
+    :param msg: The message to calculate the hash for, or a path to a file.
+    :param alg: The algorithm to use, or a default value (either 'sha256', or an environment-defined value).
+    :return: The hash value obtained, or None if the hash could not be computed.
+    """
+
+    hasher = hashlib.new(alg.lower())
+
+    # what is the type of the argument ?
+    if isinstance(msg, bytes):
+        # argument is type 'bytes'
+        hasher.update(msg)
+
+    elif os.path.isfile(msg):
+        # argument is the path to a file
+        buf_size: int = 128 * 1024
+        with open(msg, "rb") as f:
+            while True:
+                file_bytes: bytes = f.read(buf_size)
+                if not file_bytes:
+                    break
+                hasher.update(file_bytes)
+
+    return hasher.digest()