maleo-foundation 0.1.76__py3-none-any.whl → 0.1.77__py3-none-any.whl

maleo_foundation/client/manager.py

@@ -14,6 +14,7 @@ from maleo_foundation.client.services.hash import (
 from maleo_foundation.client.services import (
     MaleoFoundationEncryptionServices,
     MaleoFoundationHashServices,
+    MaleoFoundationKeyClientService,
     MaleoFoundationSignatureClientService,
     MaleoFoundationTokenClientService,
     MaleoFoundationServices
@@ -35,6 +36,7 @@ class MaleoFoundationClientManager(ClientManager):
             aes=aes_encryption_service,
             rsa=rsa_encryption_service
         )
+        key_service = MaleoFoundationKeyClientService(logger=self._logger)
         bcrypt_hash_service = MaleoFoundationBcryptHashClientService(logger=self._logger)
         hmac_hash_service = MaleoFoundationHMACHashClientService(logger=self._logger)
         sha256_hash_service = MaleoFoundationSHA256HashClientService(logger=self._logger)
@@ -48,6 +50,7 @@ class MaleoFoundationClientManager(ClientManager):
         self._services = MaleoFoundationServices(
             encryption=encryption_services,
             hash=hash_services,
+            key=key_service,
             signature=signature_service,
             token=token_service
         )

maleo_foundation/client/services/__init__.py

@@ -3,11 +3,13 @@ from pydantic import Field
 from maleo_foundation.managers.client.base import ClientServices
 from maleo_foundation.client.services.encryption import MaleoFoundationEncryptionServices
 from maleo_foundation.client.services.hash import MaleoFoundationHashServices
+from maleo_foundation.client.services.key import MaleoFoundationKeyClientService
 from maleo_foundation.client.services.signature import MaleoFoundationSignatureClientService
 from maleo_foundation.client.services.token import MaleoFoundationTokenClientService
 
 class MaleoFoundationServices(ClientServices):
     encryption:MaleoFoundationEncryptionServices = Field(..., description="Encryption's services")
     hash:MaleoFoundationHashServices = Field(..., description="Hash's services")
+    key:MaleoFoundationKeyClientService = Field(..., description="Key's service")
     signature:MaleoFoundationSignatureClientService = Field(..., description="Signature's service")
     token:MaleoFoundationTokenClientService = Field(..., description="Token's service")

maleo_foundation/client/services/key.py

@@ -0,0 +1,113 @@
+from cryptography.hazmat.backends import default_backend
+from cryptography.hazmat.primitives.asymmetric import rsa
+from cryptography.hazmat.primitives import serialization
+from maleo_foundation.expanded_types.key import BaseKeyResultsTypes
+from maleo_foundation.managers.client.base import ClientService
+from maleo_foundation.models.transfers.general.key import BaseKeyGeneralTransfers
+from maleo_foundation.models.transfers.parameters.key import BaseKeyParametersTransfers
+from maleo_foundation.models.transfers.results.key import BaseKeyResultsTransfers
+from maleo_foundation.utils.exceptions import BaseExceptions
+
+class MaleoFoundationKeyClientService(ClientService):
+    def create_private(self, parameters:BaseKeyParametersTransfers.CreatePrivateOrPair) -> BaseKeyResultsTypes.CreatePrivate:
+        """Create an RSA private key with X.509 encoding in .pem format."""
+        @BaseExceptions.service_exception_handler(
+            operation="creating private key",
+            logger=self._logger,
+            fail_result_class=BaseKeyResultsTransfers.Fail
+        )
+        def _impl():
+            #* Create private key
+            private_key = rsa.generate_private_key(
+                public_exponent=65537,
+                key_size=parameters.key_size,
+                backend=default_backend()
+            )
+
+            if parameters.password is None:
+                encryption_algorithm = serialization.NoEncryption()
+            else:
+                encryption_algorithm = serialization.BestAvailableEncryption(parameters.password.encode())
+
+            #* Serialize private key to PEM format
+            private_key_bytes = private_key.private_bytes(
+                encoding=serialization.Encoding.PEM,
+                format=serialization.PrivateFormat.PKCS8,
+                encryption_algorithm=encryption_algorithm
+            )
+
+            self._logger.info("Successfully created private key")
+            data = BaseKeyGeneralTransfers.PrivateKey(value=private_key_bytes.decode())
+            return BaseKeyResultsTransfers.CreatePrivate(data=data)
+        return _impl()
+
+    def create_public(self, parameters:BaseKeyParametersTransfers.CreatePublic) -> BaseKeyResultsTypes.CreatePublic:
+        """Create an RSA public key with X.509 encoding in .pem format."""
+        @BaseExceptions.service_exception_handler(
+            operation="creating public key",
+            logger=self._logger,
+            fail_result_class=BaseKeyResultsTransfers.Fail
+        )
+        def _impl():
+            #* Serialize private key
+            private_key_bytes = parameters.value.encode()
+            private_key = serialization.load_pem_private_key(
+                private_key_bytes,
+                password=parameters.password.encode() if parameters.password else None,
+                backend=default_backend()
+            )
+
+            public_key = private_key.public_key() #* Create public key
+
+            #* Serialize public key to PEM format
+            public_key_bytes = public_key.public_bytes(
+                encoding=serialization.Encoding.PEM,
+                format=serialization.PublicFormat.SubjectPublicKeyInfo
+            )
+
+            self._logger.info("Successfully created public key")
+            data = BaseKeyGeneralTransfers.PublicKey(value=public_key_bytes.decode())
+            return BaseKeyResultsTransfers.CreatePublic(data=data)
+        return _impl()
+
+    def create_pair(self, parameters:BaseKeyParametersTransfers.CreatePrivateOrPair) -> BaseKeyResultsTypes.CreatePair:
+        """Create an RSA key pair with X.509 encoding in .pem format."""
+        @BaseExceptions.service_exception_handler(
+            operation="creating key pair",
+            logger=self._logger,
+            fail_result_class=BaseKeyResultsTransfers.Fail
+        )
+        def _impl():
+            #* Create private key
+            private_key = rsa.generate_private_key(
+                public_exponent=65537,
+                key_size=parameters.key_size,
+                backend=default_backend()
+            )
+
+            if parameters.password is None:
+                encryption_algorithm = serialization.NoEncryption()
+            else:
+                encryption_algorithm = serialization.BestAvailableEncryption(parameters.password.encode())
+
+            #* Serialize private key to PEM format
+            private_key_bytes = private_key.private_bytes(
+                encoding=serialization.Encoding.PEM,
+                format=serialization.PrivateFormat.PKCS8,
+                encryption_algorithm=encryption_algorithm
+            )
+            private = BaseKeyGeneralTransfers.PrivateKey(value=private_key_bytes.decode())
+
+            public_key = private_key.public_key() #* Create public key
+
+            #* Serialize public key to PEM format
+            public_key_bytes = public_key.public_bytes(
+                encoding=serialization.Encoding.PEM,
+                format=serialization.PublicFormat.SubjectPublicKeyInfo
+            )
+            public = BaseKeyGeneralTransfers.PublicKey(value=public_key_bytes.decode())
+
+            self._logger.info("Successfully created key pair")
+            data = BaseKeyGeneralTransfers.KeyPair(private=private, public=public)
+            return BaseKeyResultsTransfers.CreatePair(data=data)
+        return _impl()

maleo_foundation/expanded_types/key.py

@@ -0,0 +1,18 @@
+from typing import Union
+from maleo_foundation.models.transfers.results.key import BaseKeyResultsTransfers
+
+class BaseKeyResultsTypes:
+    CreatePrivate = Union[
+        BaseKeyResultsTransfers.Fail,
+        BaseKeyResultsTransfers.CreatePrivate
+    ]
+
+    CreatePublic = Union[
+        BaseKeyResultsTransfers.Fail,
+        BaseKeyResultsTransfers.CreatePublic
+    ]
+
+    CreatePair = Union[
+        BaseKeyResultsTransfers.Fail,
+        BaseKeyResultsTransfers.CreatePair
+    ]

maleo_foundation/models/schemas/key.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+from pydantic import BaseModel, Field
+from maleo_foundation.enums import BaseEnums
+from maleo_foundation.types import BaseTypes
+
+class BaseKeySchemas:
+    class KeySize(BaseModel):
+        key_size:int = Field(2048, ge=2048, le=16384, description="Key's size")
+
+    class Password(BaseModel):
+        password:BaseTypes.OptionalString = Field(None, min_length=32, max_length=1024, description="password")
+
+    class Key(BaseModel):
+        type:BaseEnums.KeyType = Field(..., description="Key's type")
+        value:str = Field(..., description="Key's value")

maleo_foundation/models/transfers/general/key.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+from pydantic import BaseModel, Field
+from maleo_foundation.enums import BaseEnums
+from maleo_foundation.models.schemas.key import BaseKeySchemas
+
+class BaseKeyGeneralTransfers:
+    class PrivateKey(BaseKeySchemas.Key):
+        type:BaseEnums.KeyType = Field(BaseEnums.KeyType.PRIVATE, description="Private key's type")
+
+    class PublicKey(BaseKeySchemas.Key):
+        type:BaseEnums.KeyType = Field(BaseEnums.KeyType.PUBLIC, description="Public key's type")
+
+    class KeyPair(BaseModel):
+        private:BaseKeyGeneralTransfers.PrivateKey = Field(..., description="Private key's data")
+        public:BaseKeyGeneralTransfers.PublicKey = Field(..., description="Public key's data")

maleo_foundation/models/transfers/parameters/key.py

@@ -0,0 +1,13 @@
+from maleo_foundation.models.schemas.key import BaseKeySchemas
+from maleo_foundation.models.transfers.general.key import BaseKeyGeneralTransfers
+
+class BaseKeyParametersTransfers:
+    class CreatePrivateOrPair(
+        BaseKeySchemas.Password,
+        BaseKeySchemas.KeySize
+    ): pass
+
+    class CreatePublic(
+        BaseKeySchemas.Password,
+        BaseKeyGeneralTransfers.PrivateKey
+    ): pass

maleo_foundation/models/transfers/results/key.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+from pydantic import Field
+from maleo_foundation.models.transfers.results.service.general import BaseServiceGeneralResultsTransfers
+from maleo_foundation.models.transfers.general.key import BaseKeyGeneralTransfers
+
+class BaseKeyResultsTransfers:
+    class Fail(BaseServiceGeneralResultsTransfers.Fail): pass
+
+    class CreatePrivate(BaseServiceGeneralResultsTransfers.SingleData):
+        data:BaseKeyGeneralTransfers.PrivateKey = Field(..., description="Private key data")
+
+    class CreatePublic(BaseServiceGeneralResultsTransfers.SingleData):
+        data:BaseKeyGeneralTransfers.PublicKey = Field(..., description="Private key data")
+
+    class CreatePair(BaseServiceGeneralResultsTransfers.SingleData):
+        data:BaseKeyGeneralTransfers.KeyPair = Field(..., description="Key pair data")

{maleo_foundation-0.1.76.dist-info → maleo_foundation-0.1.77.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maleo_foundation
-Version: 0.1.76
+Version: 0.1.77
 Summary: Foundation package for Maleo
 Author-email: Agra Bima Yuda <agra@nexmedis.com>
 License: MIT

{maleo_foundation-0.1.76.dist-info → maleo_foundation-0.1.77.dist-info}/RECORD

@@ -5,8 +5,9 @@ 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=NYvy6jyrDGeAaSXafUHQailAeaQCkcCKMRIZ-uq8Bu8,2479
-maleo_foundation/client/services/__init__.py,sha256=IjTZw2T-1SCEtcxx1uMjD00HVeQoPDIXs9m7qdCQ5Vo,888
+maleo_foundation/client/manager.py,sha256=pFWLFYW4eE9MLyFmFS05IgnMBdqqUHbdyTkSbnBtm5E,2620
+maleo_foundation/client/services/__init__.py,sha256=uIBnAeQ9a2otQbUAbKBQfYrkEUugXjxXoV8W5QYHuic,1051
+maleo_foundation/client/services/key.py,sha256=RtbLlbdafsl_LKgqbcZjkvj9Is37wTsll2s9oQdSBS8,5306
 maleo_foundation/client/services/signature.py,sha256=ePO0T9cJ8BIIYbFw2ZJSW4MUM96Sk-Vu-ha0X7XTSGw,4300
 maleo_foundation/client/services/token.py,sha256=p1cA60ofeFJeL2MVKnAjnggIFniVSp2Hbd7VTYE255E,3880
 maleo_foundation/client/services/encryption/__init__.py,sha256=qK9-RwivJ2xkMIwXI8XM8LmYboRTX6R3G9Nh3RxSdCM,594
@@ -20,6 +21,7 @@ maleo_foundation/expanded_types/__init__.py,sha256=lm_r7rxlLA0sgSTGQBMR9ZbZbVDpD
 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/key.py,sha256=pn3HWvSBg63j_84UqHbkfRCf5vj10OyOrlzIDMuvjj4,479
 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
@@ -48,17 +50,20 @@ maleo_foundation/models/schemas/__init__.py,sha256=Xj8Ahsqyra-fmEaVcGPok5GOOsPQl
 maleo_foundation/models/schemas/encryption.py,sha256=6fZU8uadQp-2pLAChuYAVoG7sAm7BuCea79QxuV-wYo,647
 maleo_foundation/models/schemas/general.py,sha256=KGPP67ciKeL8cvOS3kYrVwmRx3kD33OcS88UmMn1JPE,3822
 maleo_foundation/models/schemas/hash.py,sha256=ieRrAwp9ssYP74xQybv1_gT2gDyAcXLNMwqbYEcLwvg,430
+maleo_foundation/models/schemas/key.py,sha256=7FZxVqTL5qRK48AXL1odrMNhAwhwtCwSkBUPsJwuBII,594
 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
 maleo_foundation/models/schemas/token.py,sha256=u71kPXJyCxqn_INK05MSNFhQr9MaLfQM-icYc536xik,551
 maleo_foundation/models/transfers/__init__.py,sha256=oJLJ3Geeme6vBw7R2Dhvdvg4ziVvzEYAGJaP-tm_90w,299
 maleo_foundation/models/transfers/general/__init__.py,sha256=0yW67vJvKgJmZ9htteOVatG7mb-YEpHF62dpwH2g_Bk,146
+maleo_foundation/models/transfers/general/key.py,sha256=GLwNLvNoe7mtjJjfS-WdG1cH32z_4R0N_uFhBvoybis,718
 maleo_foundation/models/transfers/general/signature.py,sha256=EFcr-QC3QcDLZivkmL89ERVc5ZDGe_SYH5dMItll5Bs,264
 maleo_foundation/models/transfers/general/token.py,sha256=QZNGG5DdmQDTYIqNFMqBQDJoeahIHgzBzyXiMoTS-JA,2414
 maleo_foundation/models/transfers/parameters/__init__.py,sha256=oKW4RPIEISISRjsJzD8lsCGY1HhZRTzshPpWHcJu86k,353
 maleo_foundation/models/transfers/parameters/client.py,sha256=tn_Hwa-k-Utp5rODe7GylqZB8djIKKupgkUFscYCyLc,4059
 maleo_foundation/models/transfers/parameters/general.py,sha256=WoekZJCIoAllhXdRIJkNRdNq0QEIn0bteiHJLtzkCxU,579
+maleo_foundation/models/transfers/parameters/key.py,sha256=smDAjgSOGXQ8elEUA9cChw2TaZb3k14xOS64Qms3s3M,399
 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
@@ -71,6 +76,7 @@ maleo_foundation/models/transfers/parameters/hash/hmac.py,sha256=vCEVQPh51wXrbOf
 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/key.py,sha256=evVH-KfaNRxQdX31lOJdrYiMLp46o1WVgNFgBM7nCSM,829
 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
@@ -99,7 +105,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.76.dist-info/METADATA,sha256=e0ynWXIw0cKzJZp7wjbqUfbgty_LUb2mL_uBaOU7DSM,3419
-maleo_foundation-0.1.76.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-maleo_foundation-0.1.76.dist-info/top_level.txt,sha256=_iBos3F_bhEOdjOnzeiEYSrCucasc810xXtLBXI8cQc,17
-maleo_foundation-0.1.76.dist-info/RECORD,,
+maleo_foundation-0.1.77.dist-info/METADATA,sha256=aghCWBHf3ZaF2o6gUDHlVeEnQIw-iZjT16rbEdluO-E,3419
+maleo_foundation-0.1.77.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+maleo_foundation-0.1.77.dist-info/top_level.txt,sha256=_iBos3F_bhEOdjOnzeiEYSrCucasc810xXtLBXI8cQc,17
+maleo_foundation-0.1.77.dist-info/RECORD,,