passphera-core 0.21.0__py3-none-any.whl → 0.23.0__py3-none-any.whl

passphera_core/application/generator.py

@@ -10,29 +10,37 @@ class GetGeneratorUseCase:
         return self.generator_repository.get()
 
 
-class SetGeneratorPropertyUseCase:
+class GetPropertiesUseCase:
     def __init__(self, generator_repository: GeneratorRepository):
         self.generator_repository: GeneratorRepository = generator_repository
 
-    def __call__(self, field: str, value: str) -> Generator:
+    def __call__(self) -> dict:
+        return self.generator_repository.get().get_properties()
+
+
+class SetPropertyUseCase:
+    def __init__(self, generator_repository: GeneratorRepository):
+        self.generator_repository: GeneratorRepository = generator_repository
+
+    def __call__(self, prop: str, value: str) -> Generator:
         generator_entity: Generator = self.generator_repository.get()
-        generator_entity.set_property(field, value)
+        generator_entity.set_property(prop, value)
         self.generator_repository.update(generator_entity)
         return generator_entity
 
 
-class ResetGeneratorPropertyUseCase:
+class ResetPropertyUseCase:
     def __init__(self, generator_repository: GeneratorRepository):
         self.generator_repository: GeneratorRepository = generator_repository
 
-    def __call__(self, field: str) -> Generator:
+    def __call__(self, prop: str) -> Generator:
         generator_entity: Generator = self.generator_repository.get()
-        generator_entity.reset_property(field)
+        generator_entity.reset_property(prop)
         self.generator_repository.update(generator_entity)
         return generator_entity
 
 
-class AddCharacterReplacementUseCase:
+class SetCharacterReplacementUseCase:
     def __init__(self, generator_repository: GeneratorRepository):
         self.generator_repository: GeneratorRepository = generator_repository
 

passphera_core/entities.py

@@ -20,33 +20,57 @@ class Password:
     salt: bytes = field(default_factory=lambda: bytes)
 
     def encrypt(self) -> None:
+        """
+        Encrypts the password using Fernet symmetric encryption.
+
+        This method generates a new salt, derives an encryption key using the password
+        and salt, and then encrypts the password using Fernet encryption. The encrypted
+        password is stored back in the password field as a base64-encoded string.
+        :return: None
+        """
         self.salt = generate_salt()
         key = derive_key(self.password, self.salt)
         self.password = Fernet(key).encrypt(self.password.encode()).decode()
 
     def decrypt(self) -> str:
+        """
+        Decrypts the encrypted password using Fernet symmetric decryption.
+
+        This method uses the stored salt to derive the encryption key and then
+        decrypts the stored encrypted password using Fernet decryption.
+        :return: str: The decrypted original password
+        """
         key = derive_key(self.password, self.salt)
         return Fernet(key).decrypt(self.password.encode()).decode()
 
 
 @dataclass
 class Generator:
-    id: UUID = field(default_factory=uuid4)
-    created_at: datetime = field(default_factory=datetime.now)
-    updated_at: datetime = field(default_factory=datetime.now)
-    shift: int = field(default=3)
-    multiplier: int = field(default=3)
-    key: str = field(default="hill")
-    algorithm: str = field(default="hill")
-    prefix: str = field(default="secret")
-    postfix: str = field(default="secret")
-    characters_replacements: dict[str, str] = field(default_factory=dict[str, str])
     _cipher_registry: dict[str, BaseCipherAlgorithm] = field(default_factory=lambda: {
         'caesar': CaesarCipherAlgorithm,
         'affine': AffineCipherAlgorithm,
         'playfair': PlayfairCipherAlgorithm,
         'hill': HillCipherAlgorithm,
     }, init=False)
+    _default_properties: dict[str, str] = field(default_factory=lambda:{
+        "shift": 3,
+        "multiplier": 3,
+        "key": "hill",
+        "algorithm": "hill",
+        "prefix": "secret",
+        "postfix": "secret"
+    }, init=False)
+    
+    id: UUID = field(default_factory=uuid4)
+    created_at: datetime = field(default_factory=datetime.now)
+    updated_at: datetime = field(default_factory=datetime.now)
+    shift: int = field(default=_default_properties["shift"])
+    multiplier: int = field(default=_default_properties["multiplier"])
+    key: str = field(default=_default_properties["key"])
+    algorithm: str = field(default=_default_properties["algorithm"])
+    prefix: str = field(default=_default_properties["prefix"])
+    postfix: str = field(default=_default_properties["postfix"])
+    characters_replacements: dict[str, str] = field(default_factory=dict[str, str])
 
     def get_algorithm(self) -> BaseCipherAlgorithm:
         """
@@ -57,17 +81,17 @@ class Generator:
             raise InvalidAlgorithmException(self.algorithm)
         return self._cipher_registry[self.algorithm.lower()]
 
-    def get_settings(self) -> dict:
+    def get_properties(self) -> dict:
         """
-        Retrieves the application settings.
+        Retrieves the application properties.
 
         This method is responsible for providing a dictionary containing
-        the current configuration settings of the application. It ensures
-        that the settings are properly assembled and returned for use
+        the current configuration properties of the application. It ensures
+        that the properties are properly assembled and returned for use
         elsewhere in the application.
 
         Returns:
-            dict: A dictionary containing the application settings.
+            dict: A dictionary containing the application properties.
         """
         return {
             "shift": self.shift,
@@ -79,44 +103,35 @@ class Generator:
             "characters_replacements": self.characters_replacements,
         }
 
-    def set_property(self, property: str, value: str):
+    def set_property(self, prop: str, value: str):
         """
         Update a generator property with a new value
-        :param property: The property name to update; must be one of: shift, multiplier, key, algorithm, prefix, postfix
+        :param prop: The property name to update; must be one of: shift, multiplier, key, algorithm, prefix, postfix
         :param value: The new value to set for the property
         :raises ValueError: If the property name is not one of the allowed properties
         :return: None
         """
-        if property not in {"shift", "multiplier", "key", "algorithm", "prefix", "postfix"}:
-            raise ValueError(f"Invalid property: {property}")
-        if property in ["shift", "multiplier"]:
+        if prop not in {"shift", "multiplier", "key", "algorithm", "prefix", "postfix"}:
+            raise ValueError(f"Invalid property: {prop}")
+        if prop in ["shift", "multiplier"]:
             value = int(value)
-        setattr(self, property, value)
-        if property == "algorithm":
+        setattr(self, prop, value)
+        if prop == "algorithm":
             self.get_algorithm()
         self.updated_at = datetime.now(timezone.utc)
         
-    def reset_property(self, property: str):
+    def reset_property(self, prop: str):
         """
         Reset a generator property to its default value
-        :param property: The property name to reset, it must be one of: shift, multiplier, key, algorithm, prefix, postfix
+        :param prop: The property name to reset, it must be one of: shift, multiplier, key, algorithm, prefix, postfix
         :raises ValueError: If the property name is not one of the allowed properties
         :return: None
         """
-        if property not in {"shift", "multiplier", "key", "algorithm", "prefix", "postfix"}:
-            raise ValueError(f"Invalid property: {property}")
-
-        defaults = {
-            "shift": 3,
-            "multiplier": 3,
-            "key": "hill",
-            "algorithm": "hill",
-            "prefix": "secret",
-            "postfix": "secret"
-        }
+        if prop not in {"shift", "multiplier", "key", "algorithm", "prefix", "postfix"}:
+            raise ValueError(f"Invalid property: {prop}")
 
-        setattr(self, property, defaults[property])
-        if property == "algorithm":
+        setattr(self, prop, self._default_properties[prop])
+        if prop == "algorithm":
             self.get_algorithm()
         self.updated_at = datetime.now(timezone.utc)
 

{passphera_core-0.21.0.dist-info → passphera_core-0.23.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: passphera-core
-Version: 0.21.0
+Version: 0.23.0
 Summary: The core system of passphera project
 Home-page: https://github.com/passphera/core
 Author: Fathi Abdelmalek

{passphera_core-0.21.0.dist-info → passphera_core-0.23.0.dist-info}/RECORD

@@ -1,12 +1,12 @@
 passphera_core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-passphera_core/entities.py,sha256=jaD-ODpnWXZerFzku3i1wwOibSs_wgg7jOClIgQeR20,6389
+passphera_core/entities.py,sha256=ds0BfJPiUoZsv4Sd6mocLfO9cR7wAKvtjswusSe8-Nk,7222
 passphera_core/exceptions.py,sha256=Xir2lYIH7QYHfjDQu8WJ9qIhCvP-mYcPWYN2LbbbDj8,640
 passphera_core/interfaces.py,sha256=DpHFh_vnamORf69P1dwLrZ8AYZPcYIol0Lq_VKRBkXc,855
 passphera_core/utilities.py,sha256=n7cAVox-yGd60595RjLvrGKSGqFQRm279YqKS3-R1X0,748
 passphera_core/application/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-passphera_core/application/generator.py,sha256=PlR4rNIUloHTBgXsCT3OaSRU-KC3xd0le3i74n5VGpk,2202
+passphera_core/application/generator.py,sha256=WnMuv-zBPa6d_eCOKtbtsDl1CmZ_YcnXqH5bpVIXhgs,2452
 passphera_core/application/password.py,sha256=9wsSz3uMWEZCgfnX5V7WYiWp2OqjSmsn6OSWK4HIIfo,2876
-passphera_core-0.21.0.dist-info/METADATA,sha256=j-yR-87oDobuGRE_GzBJZq9ndkby2HkwWLbfV0NB5TU,868
-passphera_core-0.21.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-passphera_core-0.21.0.dist-info/top_level.txt,sha256=aDUX2iWGOyfzyf6XakLWTbgeWqNrypMHO074Qratyds,15
-passphera_core-0.21.0.dist-info/RECORD,,
+passphera_core-0.23.0.dist-info/METADATA,sha256=8ohLZ-JaOXGQMQW7hFhGbYCppJOPWCtyV8BvyUCdZQo,868
+passphera_core-0.23.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+passphera_core-0.23.0.dist-info/top_level.txt,sha256=aDUX2iWGOyfzyf6XakLWTbgeWqNrypMHO074Qratyds,15
+passphera_core-0.23.0.dist-info/RECORD,,