securefilehandler-abs 0.1.4__tar.gz

securefilehandler_abs-0.1.4/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: securefilehandler-abs
+Version: 0.1.4
+Summary: Librería de manejo seguro de datos (criptografia) sobre archivos
+Author: Specter
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown

securefilehandler_abs-0.1.4/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "securefilehandler-abs"
+version = "0.1.4" 
+description = "Librería de manejo seguro de datos (criptografia) sobre archivos"
+readme = "README.md"
+authors = [{ name="Specter" }]
+requires-python = ">=3.10"
+
+[tool.setuptools.packages.find]
+include = ["securefilehandler*"]
+exclude = ["docs*"]

securefilehandler_abs-0.1.4/securefilehandler/__init__.py

@@ -0,0 +1,110 @@
+# Library import
+from abc import ABC, abstractmethod
+from typing import Any
+import os
+from cryptography.hazmat.primitives.ciphers.aead import AESGCM
+from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC
+from cryptography.hazmat.primitives import hashes
+from cryptography.hazmat.backends import default_backend
+import handlers
+from handlers import FileHandlerInterface
+from handlers import *
+
+# Classes definition
+class SecureFileHandler(FileHandlerInterface):
+    # Class properties definition
+    MAGIC: bytes = b"SFILEv1"
+    SALT_SIZE: int = 16
+    NONCE_SIZE: int = 12
+    ITERATIONS: int = 200_000
+
+    def __init__(self,
+        file_handler: FileHandlerInterface,
+        password: str
+    ) -> None:
+        # Instance properties assignment
+        self._file_handler = file_handler
+        self._password = password.encode("UTF-8")
+    
+    @property
+    def is_opened(self) -> bool:
+        return self._file_handler.is_opened
+
+    # Private methods
+    def _derive_key(self, salt: bytes) -> bytes:
+        KDF = PBKDF2HMAC(
+            algorithm=hashes.SHA256(),
+            length=32,  # AES-256
+            salt=salt,
+            iterations=self.ITERATIONS,
+            backend=default_backend()
+        )
+
+        return KDF.derive(self._password)
+
+    # Public methods
+    def open(self):
+        self._file_handler.open()
+    
+    def close(self):
+        self._file_handler.close()
+        
+    def write(self, data: bytes):
+        if not self.is_opened:
+            raise RuntimeError("File not opened")
+
+        encrypted = self.encrypt(data)
+        self._file_handler.write(encrypted)
+
+    def append_write(self, data: bytes):
+        if not self.is_opened:
+            raise RuntimeError("File not opened")
+
+        try:
+            decrypted = self.read()
+        except:
+            decrypted = b""
+
+        new_encrypted_data = self.encrypt(decrypted + data)
+        self._file_handler.write(new_encrypted_data)
+
+    def read(self) -> bytes:
+        if not self.is_opened:
+            raise RuntimeError("File not opened")
+
+        encrypted = self._file_handler.read()
+        return self.decrypt(encrypted)
+
+    def encrypt(self, data: bytes) -> bytes:
+        salt = os.urandom(self.SALT_SIZE)
+        key = self._derive_key(salt)
+
+        aesgcm = AESGCM(key)
+        nonce = os.urandom(self.NONCE_SIZE)
+
+        ciphertext = aesgcm.encrypt(nonce, data, self.MAGIC)
+
+        return self.MAGIC + salt + nonce + ciphertext
+
+    def decrypt(self, data: bytes) -> bytes:
+        if not data.startswith(self.MAGIC):
+            raise ValueError("Invalid or corrupted file format")
+
+        min_size = len(self.MAGIC) + self.SALT_SIZE + self.NONCE_SIZE + 16  # tag mínimo
+        if len(data) < min_size:
+            raise ValueError("File too small or corrupted")
+
+        offset = len(self.MAGIC)
+
+        salt = data[offset:offset + self.SALT_SIZE]
+        offset += self.SALT_SIZE
+
+        nonce = data[offset:offset + self.NONCE_SIZE]
+        offset += self.NONCE_SIZE
+
+        ciphertext = data[offset:]
+
+        key = self._derive_key(salt)
+        aesgcm = AESGCM(key)
+
+        return aesgcm.decrypt(nonce, ciphertext, self.MAGIC)

securefilehandler_abs-0.1.4/securefilehandler/handlers/__init__.py

@@ -0,0 +1,25 @@
+# Library import
+from abc import ABC, abstractmethod
+
+# Classes definition
+class FileHandlerInterface(ABC):
+    # Properties
+    @property
+    @abstractmethod
+    def is_opened(self) -> bool: raise NotImplementedError
+    
+    # Public methods
+    @abstractmethod
+    def open(self) -> None: raise NotImplementedError
+    
+    @abstractmethod
+    def close(self) -> None: raise NotImplementedError
+    
+    @abstractmethod
+    def write(self, data: bytes) -> None: raise NotImplementedError
+    
+    @abstractmethod
+    def read(self) -> bytes: raise NotImplementedError
+
+from localfilehandler import *
+from virtualfilehandler import *

securefilehandler_abs-0.1.4/securefilehandler/handlers/localfilehandler.py

@@ -0,0 +1,39 @@
+# Library import
+from typing import Optional, BinaryIO
+from . import FileHandlerInterface
+
+# Classes definition
+class LocalFileHandler(FileHandlerInterface):
+    def __init__(self,
+        filepath: str,
+        mode: str
+    ) -> None:
+        # Instance properties assignment
+        self._filepath = filepath
+        self._mode = mode
+        self._file_handler: Optional[BinaryIO] = None
+    
+    # Properties
+    @property
+    def is_opened(self) -> bool:
+        return self._file_handler is not None and not self._file_handler.closed
+    
+    # Public methods
+    def open(self):
+        self._file_handler = open(self._filepath, self._mode)
+    
+    def close(self):
+        if self._file_handler and not self._file_handler.closed:
+            self._file_handler.close()
+    
+    def write(self, data: bytes):
+        self._file_handler.seek(0)
+        self._file_handler.truncate(0)
+
+        self._file_handler.write(data)
+        self._file_handler.flush()
+    
+    def read(self):
+        self._file_handler.seek(0)
+        data = self._file_handler.read()
+        return data

securefilehandler_abs-0.1.4/securefilehandler/handlers/virtualfilehandler.py

@@ -0,0 +1,39 @@
+# Library import
+from typing import Optional
+from io import BytesIO
+from . import FileHandlerInterface
+
+class VirtualFileHandler(FileHandlerInterface):
+    def __init__(self) -> None:
+        self._buffer: Optional[BytesIO] = None
+
+    # Properties
+    @property
+    def is_opened(self) -> bool:
+        return self._buffer is not None
+
+    # Public methods
+    def open(self):
+        if not self.is_opened:
+            self._buffer = BytesIO()
+
+    def close(self):
+        if self._buffer is not None:
+            self._buffer.close()
+            self._buffer = None
+
+    def write(self, data: bytes):
+        if not self.is_opened:
+            raise RuntimeError("File not opened")
+
+        # Sobrescritura completa
+        self._buffer.seek(0)
+        self._buffer.truncate(0)
+        self._buffer.write(data)
+
+    def read(self) -> bytes:
+        if not self.is_opened:
+            raise RuntimeError("File not opened")
+
+        self._buffer.seek(0)
+        return self._buffer.read()

securefilehandler_abs-0.1.4/securefilehandler_abs.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: securefilehandler-abs
+Version: 0.1.4
+Summary: Librería de manejo seguro de datos (criptografia) sobre archivos
+Author: Specter
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown

securefilehandler_abs-0.1.4/securefilehandler_abs.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+securefilehandler/__init__.py
+securefilehandler/handlers/__init__.py
+securefilehandler/handlers/localfilehandler.py
+securefilehandler/handlers/virtualfilehandler.py
+securefilehandler_abs.egg-info/PKG-INFO
+securefilehandler_abs.egg-info/SOURCES.txt
+securefilehandler_abs.egg-info/dependency_links.txt
+securefilehandler_abs.egg-info/top_level.txt

securefilehandler_abs-0.1.4/securefilehandler_abs.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

securefilehandler_abs-0.1.4/securefilehandler_abs.egg-info/top_level.txt

@@ -0,0 +1 @@
+securefilehandler

securefilehandler_abs-0.1.4/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+