maleo-foundation 0.1.73__py3-none-any.whl → 0.1.75__py3-none-any.whl

maleo_foundation/client/manager.py

@@ -2,7 +2,13 @@ from __future__ import annotations
 from maleo_foundation.managers.client.base import ClientManager
 from maleo_foundation.types import BaseTypes
 from maleo_foundation.utils.logging import SimpleConfig
+from maleo_foundation.client.services.hash import (
+    MaleoFoundationSHA256HashClientService,
+    MaleoFoundationHMACHashClientService,
+    MaleoFoundationBcryptHashClientService
+)
 from maleo_foundation.client.services import (
+    MaleoFoundationHashServices,
     MaleoFoundationSignatureClientService,
     MaleoFoundationTokenClientService,
     MaleoFoundationServices
@@ -18,11 +24,20 @@ class MaleoFoundationClientManager(ClientManager):
 
     def _initialize_services(self):
         super()._initialize_services()
+        bcrypt_hash_service = MaleoFoundationBcryptHashClientService(logger=self._logger)
+        hmac_hash_service = MaleoFoundationHMACHashClientService(logger=self._logger)
+        sha256_hash_service = MaleoFoundationSHA256HashClientService(logger=self._logger)
+        hash_services = MaleoFoundationHashServices(
+            bcrypt=bcrypt_hash_service,
+            hmac=hmac_hash_service,
+            sha256=sha256_hash_service
+        )
         signature_service = MaleoFoundationSignatureClientService(logger=self._logger)
         token_service = MaleoFoundationTokenClientService(logger=self._logger)
         self._services = MaleoFoundationServices(
             signature=signature_service,
             token=token_service,
+            hash=hash_services
         )
 
     @property

maleo_foundation/client/services/__init__.py

@@ -1,9 +1,11 @@
 from __future__ import annotations
 from pydantic import Field
 from maleo_foundation.managers.client.base import ClientServices
+from maleo_foundation.client.services.hash import MaleoFoundationHashServices
 from maleo_foundation.client.services.signature import MaleoFoundationSignatureClientService
 from maleo_foundation.client.services.token import MaleoFoundationTokenClientService
 
 class MaleoFoundationServices(ClientServices):
+    hash:MaleoFoundationHashServices = Field(..., description="Hash's services")
     signature:MaleoFoundationSignatureClientService = Field(..., description="Signature's service")
     token:MaleoFoundationTokenClientService = Field(..., description="Token's service")

maleo_foundation/client/services/hash/__init__.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+from pydantic import Field
+from maleo_foundation.managers.client.base import ClientServices
+from maleo_foundation.client.services.hash.bcrypt import MaleoFoundationBcryptHashClientService
+from maleo_foundation.client.services.hash.hmac import MaleoFoundationHMACHashClientService
+from maleo_foundation.client.services.hash.sha256 import MaleoFoundationSHA256HashClientService
+
+class MaleoFoundationHashServices(ClientServices):
+    bcrypt:MaleoFoundationBcryptHashClientService = Field(..., description="Bcrypt hash's service")
+    hmac:MaleoFoundationHMACHashClientService = Field(..., description="HMAC hash's service")
+    sha256:MaleoFoundationSHA256HashClientService = Field(..., description="SHA256 hash's service")

maleo_foundation/client/services/hash/bcrypt.py

@@ -0,0 +1,37 @@
+import bcrypt
+from maleo_foundation.expanded_types.hash import BaseHashResultsTypes
+from maleo_foundation.managers.client.base import ClientService
+from maleo_foundation.models.schemas.hash import BaseHashSchemas
+from maleo_foundation.models.transfers.parameters.hash.bcrypt import BaseBcryptHashParametersTransfers
+from maleo_foundation.models.transfers.results.hash import BaseHashResultsTransfers
+from maleo_foundation.utils.exceptions import BaseExceptions
+
+class MaleoFoundationBcryptHashClientService(ClientService):
+    def hash(self, parameters:BaseBcryptHashParametersTransfers.Hash) -> BaseHashResultsTypes.Hash:
+        """Generate a bcrypt hash for the given message."""
+        @BaseExceptions.service_exception_handler(
+            operation="hashing single message",
+            logger=self._logger,
+            fail_result_class=BaseHashResultsTransfers.Fail
+        )
+        def _impl():
+            salt = bcrypt.gensalt()
+            hash = bcrypt.hashpw(parameters.message.encode(), salt).decode()
+            data = BaseHashSchemas.Hash(hash=hash)
+            self._logger.info("Message successfully hashed")
+            return BaseHashResultsTransfers.Hash(data=data)
+        return _impl()
+
+    def verify(self, parameters:BaseBcryptHashParametersTransfers.Verify) -> BaseHashResultsTypes.Verify:
+        """Verify a message against the given message hash."""
+        @BaseExceptions.service_exception_handler(
+            operation="verify single hash",
+            logger=self._logger,
+            fail_result_class=BaseHashResultsTransfers.Fail
+        )
+        def _impl():
+            is_valid = bcrypt.checkpw(parameters.message.encode(), parameters.hash.encode())
+            data = BaseHashSchemas.IsValid(is_valid=is_valid)
+            self._logger.info("Hash successfully verified")
+            return BaseHashResultsTransfers.Verify(data=data)
+        return _impl()

maleo_foundation/client/services/hash/hmac.py

@@ -0,0 +1,37 @@
+from Crypto.Hash import HMAC, SHA256
+from maleo_foundation.expanded_types.hash import BaseHashResultsTypes
+from maleo_foundation.managers.client.base import ClientService
+from maleo_foundation.models.schemas.hash import BaseHashSchemas
+from maleo_foundation.models.transfers.parameters.hash.hmac import BaseHMACHashParametersTransfers
+from maleo_foundation.models.transfers.results.hash import BaseHashResultsTransfers
+from maleo_foundation.utils.exceptions import BaseExceptions
+
+class MaleoFoundationHMACHashClientService(ClientService):
+    def hash(self, parameters:BaseHMACHashParametersTransfers.Hash) -> BaseHashResultsTypes.Hash:
+        """Generate a hmac hash for the given message."""
+        @BaseExceptions.service_exception_handler(
+            operation="hashing single message",
+            logger=self._logger,
+            fail_result_class=BaseHashResultsTransfers.Fail
+        )
+        def _impl():
+            hash = HMAC.new(parameters.key.encode(), parameters.message.encode(), SHA256).hexdigest()
+            data = BaseHashSchemas.Hash(hash=hash)
+            self._logger.info("Message successfully hashed")
+            return BaseHashResultsTransfers.Hash(data=data)
+        return _impl()
+
+    def verify(self, parameters:BaseHMACHashParametersTransfers.Verify) -> BaseHashResultsTypes.Verify:
+        """Verify a message against the given message hash."""
+        @BaseExceptions.service_exception_handler(
+            operation="verify single hash",
+            logger=self._logger,
+            fail_result_class=BaseHashResultsTransfers.Fail
+        )
+        def _impl():
+            computed_hash = HMAC.new(parameters.key.encode(), parameters.message.encode(), SHA256).hexdigest()
+            is_valid = computed_hash == parameters.hash
+            data = BaseHashSchemas.IsValid(is_valid=is_valid)
+            self._logger.info("Hash successfully verified")
+            return BaseHashResultsTransfers.Verify(data=data)
+        return _impl()

maleo_foundation/client/services/hash/sha256.py

@@ -0,0 +1,37 @@
+from Crypto.Hash import SHA256
+from maleo_foundation.expanded_types.hash import BaseHashResultsTypes
+from maleo_foundation.managers.client.base import ClientService
+from maleo_foundation.models.schemas.hash import BaseHashSchemas
+from maleo_foundation.models.transfers.parameters.hash.sha256 import BaseSHA256HashParametersTransfers
+from maleo_foundation.models.transfers.results.hash import BaseHashResultsTransfers
+from maleo_foundation.utils.exceptions import BaseExceptions
+
+class MaleoFoundationSHA256HashClientService(ClientService):
+    def hash(self, parameters:BaseSHA256HashParametersTransfers.Hash) -> BaseHashResultsTypes.Hash:
+        """Generate a sha256 hash for the given message."""
+        @BaseExceptions.service_exception_handler(
+            operation="hashing single message",
+            logger=self._logger,
+            fail_result_class=BaseHashResultsTransfers.Fail
+        )
+        def _impl():
+            hash = SHA256.new(parameters.message.encode()).hexdigest()
+            data = BaseHashSchemas.Hash(hash=hash)
+            self._logger.info("Message successfully hashed")
+            return BaseHashResultsTransfers.Hash(data=data)
+        return _impl()
+
+    def verify(self, parameters:BaseSHA256HashParametersTransfers.Verify) -> BaseHashResultsTypes.Verify:
+        """Verify a message against the given message hash."""
+        @BaseExceptions.service_exception_handler(
+            operation="verify single hash",
+            logger=self._logger,
+            fail_result_class=BaseHashResultsTransfers.Fail
+        )
+        def _impl():
+            computed_hash = SHA256.new(parameters.message.encode()).hexdigest()
+            is_valid = computed_hash == parameters.hash
+            data = BaseHashSchemas.IsValid(is_valid=is_valid)
+            self._logger.info("Hash successfully verified")
+            return BaseHashResultsTransfers.Verify(data=data)
+        return _impl()

maleo_foundation/client/services/signature.py

@@ -38,7 +38,7 @@ class MaleoFoundationSignatureClientService(ClientService):
             return BaseSignatureResultsTransfers.Sign(data=data)
         return _impl()
 
-    def decode(self, parameters:BaseSignatureParametersTransfers.Verify) -> BaseSignatureResultsTypes.Verify:
+    def verify(self, parameters:BaseSignatureParametersTransfers.Verify) -> BaseSignatureResultsTypes.Verify:
         @BaseExceptions.service_exception_handler(
             operation="verify single signature",
             logger=self._logger,

maleo_foundation/expanded_types/hash.py

@@ -0,0 +1,13 @@
+from typing import Union
+from maleo_foundation.models.transfers.results.hash import BaseHashResultsTransfers
+
+class BaseHashResultsTypes:
+    Hash = Union[
+        BaseHashResultsTransfers.Fail,
+        BaseHashResultsTransfers.Hash
+    ]
+
+    Verify = Union[
+        BaseHashResultsTransfers.Fail,
+        BaseHashResultsTransfers.Verify
+    ]

maleo_foundation/models/schemas/hash.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+from pydantic import BaseModel, Field
+
+class BaseHashSchemas:
+    class Key(BaseModel):
+        key:str = Field(..., description="Key")
+
+    class Message(BaseModel):
+        message:str = Field(..., description="Message")
+
+    class Hash(BaseModel):
+        hash:str = Field(..., description="Hash")
+
+    class IsValid(BaseModel):
+        is_valid:bool = Field(..., description="Is valid hash")

maleo_foundation/models/transfers/parameters/hash/__init__.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+from .bcrypt import BaseBcryptHashParametersTransfers
+from .hmac import BaseHMACHashParametersTransfers
+from .sha256 import BaseSHA256HashParametersTransfers
+
+class BaseHashParametersTransfers:
+    Bcrypt = BaseBcryptHashParametersTransfers
+    HMAC = BaseHMACHashParametersTransfers
+    SHA256 = BaseSHA256HashParametersTransfers

maleo_foundation/models/transfers/parameters/hash/bcrypt.py

@@ -0,0 +1,9 @@
+from maleo_foundation.models.schemas.hash import BaseHashSchemas
+
+class BaseBcryptHashParametersTransfers:
+    class Hash(BaseHashSchemas.Message): pass
+
+    class Verify(
+        BaseHashSchemas.Hash,
+        BaseHashSchemas.Message
+    ): pass

maleo_foundation/models/transfers/parameters/hash/hmac.py

@@ -0,0 +1,13 @@
+from maleo_foundation.models.schemas.hash import BaseHashSchemas
+
+class BaseHMACHashParametersTransfers:
+    class Hash(
+        BaseHashSchemas.Message,
+        BaseHashSchemas.Key
+    ): pass
+
+    class Verify(
+        BaseHashSchemas.Hash,
+        BaseHashSchemas.Message,
+        BaseHashSchemas.Key
+    ): pass

maleo_foundation/models/transfers/parameters/hash/sha256.py

@@ -0,0 +1,9 @@
+from maleo_foundation.models.schemas.hash import BaseHashSchemas
+
+class BaseSHA256HashParametersTransfers:
+    class Hash(BaseHashSchemas.Message): pass
+
+    class Verify(
+        BaseHashSchemas.Hash,
+        BaseHashSchemas.Message
+    ): pass

maleo_foundation/models/transfers/results/hash.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+from pydantic import Field
+from maleo_foundation.models.transfers.results.service.general import BaseServiceGeneralResultsTransfers
+from maleo_foundation.models.schemas.hash import BaseHashSchemas
+
+class BaseHashResultsTransfers:
+    class Fail(BaseServiceGeneralResultsTransfers.Fail): pass
+
+    class Hash(BaseServiceGeneralResultsTransfers.SingleData):
+        data:BaseHashSchemas.Hash = Field(..., description="Hash data")
+
+    class Verify(BaseServiceGeneralResultsTransfers.SingleData):
+        data:BaseHashSchemas.IsValid = Field(..., description="Verify data")

{maleo_foundation-0.1.73.dist-info → maleo_foundation-0.1.75.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maleo_foundation
-Version: 0.1.73
+Version: 0.1.75
 Summary: Foundation package for Maleo
 Author-email: Agra Bima Yuda <agra@nexmedis.com>
 License: MIT
@@ -8,6 +8,7 @@ Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 Requires-Dist: annotated-types>=0.7.0
 Requires-Dist: anyio>=4.9.0
+Requires-Dist: bcrypt>=4.3.0
 Requires-Dist: build>=1.2.2.post1
 Requires-Dist: cachetools>=5.5.2
 Requires-Dist: certifi>=2025.1.31

{maleo_foundation-0.1.73.dist-info → maleo_foundation-0.1.75.dist-info}/RECORD

@@ -5,13 +5,18 @@ maleo_foundation/enums.py,sha256=uvwl3dl2r6BoJMEbtSETiLoyJubHup9Lc7VOg7w7zQo,294
 maleo_foundation/extended_types.py,sha256=pIKt-_9tby4rmune3fmWcCW_mohaNRh_1lywBmdc-L4,301
 maleo_foundation/types.py,sha256=aKXnIgEhYGSfFqNMGLc4qIKGkINBRpkOo9R9cb2CbwI,2414
 maleo_foundation/client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-maleo_foundation/client/manager.py,sha256=3YO2uoBLoC9nbe1yNuqPjhgORSDwb5Zu68KLS2zvKXY,1206
-maleo_foundation/client/services/__init__.py,sha256=SUGBVhs_Zu9rNUxWIxcjGmi54W6RRlwSTqW4h8E0vW0,540
-maleo_foundation/client/services/signature.py,sha256=HGFhdva-4FkEx5s4QSwI2U8y0i2hIyRQCCWLWKQwGp8,4300
+maleo_foundation/client/manager.py,sha256=Lx5k34RxI34qP6XVoHZ7PpAw_L28ByPR6fnZCJX04fk,1897
+maleo_foundation/client/services/__init__.py,sha256=_A-jySpCciIVB-VHgjqvJNkRYmAwzcq9SuWWV6iWW7g,699
+maleo_foundation/client/services/signature.py,sha256=ePO0T9cJ8BIIYbFw2ZJSW4MUM96Sk-Vu-ha0X7XTSGw,4300
 maleo_foundation/client/services/token.py,sha256=p1cA60ofeFJeL2MVKnAjnggIFniVSp2Hbd7VTYE255E,3880
+maleo_foundation/client/services/hash/__init__.py,sha256=A4Olb-RpeNFQEfToU9t8LfZ8e2WXeR8c_grot-JCFjI,756
+maleo_foundation/client/services/hash/bcrypt.py,sha256=1pl_X0IREGsGmx83w1cy81-6W-Xr3TcMHuD3u-N4TuA,1902
+maleo_foundation/client/services/hash/hmac.py,sha256=lrmcqU88Rpvixi_1Q9a7RnUoV6OwOEnyHiLz4istjYk,1976
+maleo_foundation/client/services/hash/sha256.py,sha256=Vhgoswo6fBik4s2AwcgvNCKKK1q6rQ5V4CqBLl1CE8c,1920
 maleo_foundation/expanded_types/__init__.py,sha256=lm_r7rxlLA0sgSTGQBMR9ZbZbVDpD7Te-UYb3oRVi1g,364
 maleo_foundation/expanded_types/client.py,sha256=To0kRXp3QTmuSu5rWKaCiTsMK9qkYiyYKYbHfw-y1fY,2396
 maleo_foundation/expanded_types/general.py,sha256=bjIBREYTS73tvS-Key7P7db82a2HHlSJ1XBAvKuYmT0,826
+maleo_foundation/expanded_types/hash.py,sha256=KERzp_Gl2Z7urcw8i0ab1MXxU_BIlCY9V5d8X4Edq5s,344
 maleo_foundation/expanded_types/query.py,sha256=0yUG-JIVsanzB7KAkrRz_OsrhP6J0bRqD9Q3l3atQnk,2384
 maleo_foundation/expanded_types/service.py,sha256=q8jpKdbCbLWwH1UPQavKpVE14rC5rveduk2cFWzuhGw,2416
 maleo_foundation/expanded_types/signature.py,sha256=zNgXRrxVCfEIGXsRANIa1Ljj-ebHjC2pWOTtw_ABJlQ,379
@@ -35,6 +40,7 @@ maleo_foundation/models/responses.py,sha256=yKK_5p0dYCnUx-09mRKHkBv485bcngaCp9lw
 maleo_foundation/models/table.py,sha256=Dk5GXeO0gbBBPN2PJtZhlUx2x3vMbT4dxTBc3YLBbuc,1199
 maleo_foundation/models/schemas/__init__.py,sha256=Xj8Ahsqyra-fmEaVcGPok5GOOsPQlKcknHYMvbjvENA,277
 maleo_foundation/models/schemas/general.py,sha256=KGPP67ciKeL8cvOS3kYrVwmRx3kD33OcS88UmMn1JPE,3822
+maleo_foundation/models/schemas/hash.py,sha256=ieRrAwp9ssYP74xQybv1_gT2gDyAcXLNMwqbYEcLwvg,430
 maleo_foundation/models/schemas/parameter.py,sha256=K47z2NzmTEhUiOfRiRLyRPXoQurbWsKBL7ObXAxIWRY,2100
 maleo_foundation/models/schemas/result.py,sha256=V3dljS2AdtWW4Pf8YsnQuiCylN1bZtEY1AtYC7okWuI,1747
 maleo_foundation/models/schemas/signature.py,sha256=4DVcsBR9TnxD2R28oWk51jMtF1j5ylmorVM3jDNVlrU,609
@@ -49,7 +55,12 @@ maleo_foundation/models/transfers/parameters/general.py,sha256=WoekZJCIoAllhXdRI
 maleo_foundation/models/transfers/parameters/service.py,sha256=d7Xy_R-DtLBRozyD6r8YnTiuKlE3sb9HMDCCq9WmUbY,6757
 maleo_foundation/models/transfers/parameters/signature.py,sha256=Kn6gJrQUHyn2uG6LyYnhbUEMfXJVTLgMG6n3CXZ4hu8,395
 maleo_foundation/models/transfers/parameters/token.py,sha256=WTmCKoP-KJLqZjdwr__BeVnBrnRrsxzHSQ0IBaOKvqw,535
+maleo_foundation/models/transfers/parameters/hash/__init__.py,sha256=ix4AXSS-8EtKTSPwXOzkpIpyfx86QIJIQpp6zTLbIs4,365
+maleo_foundation/models/transfers/parameters/hash/bcrypt.py,sha256=t_VpQL7YXokJf1Yp9TC8-ZD9AGQ0V0ZjFJpZZgfPqSA,245
+maleo_foundation/models/transfers/parameters/hash/hmac.py,sha256=vCEVQPh51wXrbOfIp6ByyZwIKTUJTT02WMBfHOjwmZA,315
+maleo_foundation/models/transfers/parameters/hash/sha256.py,sha256=tc2j-BKJYeLYuwXS19kOsvwTsiMWyWDFORB0vIV0imM,245
 maleo_foundation/models/transfers/results/__init__.py,sha256=0_8uJ1IQW87RZ4nIxzWkQVi3Fxb7B8myZTngXfoxgNc,241
+maleo_foundation/models/transfers/results/hash.py,sha256=W8JMmL1YZsRxpnPsWJEM-RL2LypMgs4A_R3RAGHIolQ,605
 maleo_foundation/models/transfers/results/signature.py,sha256=md3tBOfjJlg-35ICSt8h_EZZett_x7obdlx_GQ3lB00,619
 maleo_foundation/models/transfers/results/token.py,sha256=4zDgj8FWGK6Rcz_pprwnLcpRyyXKRBPbrCl3IOrRvVg,574
 maleo_foundation/models/transfers/results/client/__init__.py,sha256=xBRuY0NUIPpQEGQ2qoBnqLZGX4W1YSrQ0VnDf5OYJBo,290
@@ -75,7 +86,7 @@ maleo_foundation/utils/loaders/json.py,sha256=NsXLq3VZSgzmEf99tV1VtrmiudWdQ8Pzh_
 maleo_foundation/utils/loaders/yaml.py,sha256=jr8v3BlgmRCMTzdNgKhIYt1tnubaJXcDSSGkKVR8pbw,362
 maleo_foundation/utils/loaders/key/__init__.py,sha256=G03cA_Oxu02uDsg0WBPfPkIM2uUsxnjwOPgtBKe02kc,110
 maleo_foundation/utils/loaders/key/rsa.py,sha256=gDhyX6iTFtHiluuhFCozaZ3pOLKU2Y9TlrNMK_GVyGU,3796
-maleo_foundation-0.1.73.dist-info/METADATA,sha256=lKCQj6cm0WqQHHgAkq_cd5dNwJ_WO91SdoRY99crx3A,3390
-maleo_foundation-0.1.73.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-maleo_foundation-0.1.73.dist-info/top_level.txt,sha256=_iBos3F_bhEOdjOnzeiEYSrCucasc810xXtLBXI8cQc,17
-maleo_foundation-0.1.73.dist-info/RECORD,,
+maleo_foundation-0.1.75.dist-info/METADATA,sha256=W-HjQ8Twjp2fr8JTSCBsuKrOqKRhAuI5XGmsH4Ge-KE,3419
+maleo_foundation-0.1.75.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+maleo_foundation-0.1.75.dist-info/top_level.txt,sha256=_iBos3F_bhEOdjOnzeiEYSrCucasc810xXtLBXI8cQc,17
+maleo_foundation-0.1.75.dist-info/RECORD,,