PyDataToolsKit 1.0.0__py3-none-any.whl

PyData/classes/repository.py

@@ -0,0 +1,154 @@
+import json
+import os
+
+from datetime import date, timedelta
+from typing import Generic, TypeVar, Any
+
+from Decorators.functions.retry import Retry #type: ignore
+from Decorators.functions.validateType import ValidateType #type: ignore
+
+T = TypeVar("T")
+
+
+class Repository(Generic[T]):
+    """Persists entities as a JSON list and provides basic CRUD operations."""
+
+    def __init__(self, path: str, entity_type: type[T]):
+        self.path = path
+        self.entity_type = entity_type
+
+        try:
+            self.last_time = os.path.getmtime(self.path)
+        except FileNotFoundError:
+            self.last_time = 0
+
+        self.loaded = None
+        self.load()
+
+    def load(self):
+
+        if os.path.getmtime(self.path) != self.last_time and self.loaded is not None or self.loaded is None:
+            with open(self.path, "r", encoding="utf-8") as f:
+                datas = json.load(f)
+                self.last_time = os.path.getmtime(self.path)
+
+                instances = []
+
+                for data in datas:
+
+                    if callable(getattr(self.entity_type, "builder", None)):
+                        instance = self.entity_type.builder(data)
+
+                        if isinstance(data, dict) and data.get("ID") is not None and hasattr(instance, "ID"):
+                            instance.ID = data["ID"]
+                            reserve_id = getattr(type(instance), "_reserve_id", None)
+                            if callable(reserve_id):
+                                reserve_id(data["ID"])
+
+                        instances.append(instance)
+
+                self.loaded = instances    
+                return self.loaded
+        else:
+            return self.loaded
+
+    @Retry(cathed_exception=json.JSONDecodeError, amount=3)
+    def save(self):
+
+        if self.loaded is not None:
+            with open(self.path, "w", encoding="utf-8") as f:
+                json.dump([e.toJson() for e in self.loaded if callable(getattr(e, "toJson", None))], f, indent=4)
+
+    def create(self, entity: Any):
+
+        if isinstance(entity, self.entity_type):
+            if self.loaded is None:
+                self.loaded = self.load()
+
+            self.loaded.append(entity)
+            self.save()
+        else:
+            raise TypeError(f"L'entité est de type {type(entity)}. Le type de la base de données est {self.entity_type}")
+
+    @ValidateType()
+    def update(self, given_id: int, entity: Any):
+
+        if isinstance(entity, self.entity_type):
+
+            if self.loaded is None:
+                self.loaded = self.load()
+
+            target = next((e for e in self.loaded if hasattr(e, "ID") and e.ID == given_id), None)
+
+            if target is not None:
+                for index, targets in enumerate(self.loaded):
+                    if targets.ID == target.ID:
+                        entity.ID = target.ID
+                        self.loaded[index] = entity
+                        break
+            
+                self.save()
+
+            else:
+                raise NameError("Le nom donné ne correspond à aucune entité") 
+
+        else:
+            raise TypeError(f"L'entité est de type {type(entity)}. Le type de la base de données est {self.entity_type}")
+
+    @ValidateType()
+    def find_by_id(self, given_id: int):
+
+        if self.loaded is None:
+            self.loaded = self.load()
+
+        target = next((e for e in self.loaded if hasattr(e, "ID") and e.ID == given_id), None)
+        if target is None:
+            raise ValueError(f"L'id {given_id} ne correspond à aucune entité")
+
+        else:
+            return target
+
+    def clear_from_date(self):
+
+        if self.loaded is None:
+            self.loaded = self.load()
+
+        today = date.today
+
+        targets = []
+
+        for entity in self.loaded:
+            if hasattr(entity, "date"):
+
+                if entity.date < today:
+                    targets.append(entity)
+
+        for target in targets:
+            self.loaded.remove(target)
+
+        self.save()
+
+    @ValidateType()
+    def delete(self, given_id: int):
+
+        if self.loaded is None:
+            self.loaded = self.load()
+
+        target_index = next(
+            (index for index, entity in enumerate(self.loaded) if hasattr(entity, "ID") and entity.ID == given_id),
+            None,
+        )
+
+        if target_index is None:
+            raise ValueError(f"L'id {given_id} ne correspond à aucune entité")
+
+        del self.loaded[target_index]
+        self.save()
+
+    def ensure_file(self):
+        try:
+            with open(self.path, "r", encoding="utf-8") as f:
+                pass
+        except FileNotFoundError:
+            with open(self.path, "w", encoding="utf-8") as f:
+                json.dump([], f, indent=4)

PyData/database.py

@@ -0,0 +1,39 @@
+import json
+from typing import TypeVar
+
+from .classes.repository import Repository
+
+T = TypeVar("T")
+
+def Database(path: str, entity_type: type[T]):
+    """
+    Mets à disposition:
+    - save : Sauvegarde d'entité
+    - delete_by_name: Suppression par le nom si l'entité a cet attribut
+    - load: Renvoie la base complète
+    - find_by_name : Renvoie une entité par son nom si elle a cet attribut
+    - update_by_name: Modifie une entité existante par son nom si elle a cet attribut
+    - clear_from_date: Supprime les entité ayant une date dépassée
+    - ensure_file: Créer le fichier json à partir du chemin préciser
+    """
+    def decorator(cls):
+
+        def __init__(self, *args, **kwargs):
+            return Repository.__init__(
+                self,
+                path=path,
+                entity_type=entity_type
+            )
+
+        repository = type(
+            cls.__name__,
+            (cls, Repository),
+            {
+                "__init__" : __init__,
+                "path" : path,
+                "entity_type" : entity_type
+            }
+        )
+
+        return repository
+    return decorator

PyData/entity.py

@@ -0,0 +1,31 @@
+import pygame
+from enum import Enum
+
+def Entity():
+
+    def decorator(cls):
+
+        def toJson(self):
+            result = {}
+
+            for key, value in vars(self).items():
+                if isinstance(value, pygame.Rect):
+                    result[key] = {
+                        "x": value.x,
+                        "y": value.y,
+                        "width": value.width,
+                        "height": value.height
+                    }
+
+                elif isinstance(value, Enum):
+                    result[key] = value.value
+
+                elif hasattr(value, "toJson"):
+                    result[key] = value.toJson()
+                else:
+                    result[key] = value
+
+            return result
+        cls.toJson = toJson
+        return cls
+    return decorator

PyData/id.py

@@ -0,0 +1,38 @@
+import json
+
+def Id(file: str):
+    def decorator(cls):
+        cls._ID = 1
+
+        def reserve_id(entity_id):
+            if isinstance(entity_id, int):
+                cls._ID = max(cls._ID, entity_id + 1)
+
+        cls._reserve_id = staticmethod(reserve_id)
+
+        with open(file, "r", encoding="utf-8") as f:
+
+            for entity in json.load(f):
+
+                entity_id = entity.get("ID", None)
+
+                if entity_id is not None:
+                    reserve_id(entity_id)
+
+        original_init = cls.__init__
+
+        def __init__(self, *args, **kwargs):
+            original_init(self, *args, **kwargs)
+
+            entity_id = getattr(self, "ID", None)
+            if entity_id is not None:
+                reserve_id(entity_id)
+                return
+
+            self.ID = cls._ID
+            cls._ID += 1
+
+        cls.__init__ = __init__
+        return cls
+
+    return decorator

pydatatoolskit-1.0.0.dist-info/METADATA

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: PyDataToolsKit
+Version: 1.0.0
+Summary: Bibliothèque facilitant les transitions Entity/Repository
+Requires-Dist: DecoratorsToolKit>=1.0.0

pydatatoolskit-1.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+PyData/database.py,sha256=arGKuv1T6lRxABSpyvPYX_DXcZJ8mnQb54SFhu4CjWY,1175
+PyData/entity.py,sha256=850bck_8Yh9EneDSwuUL3SbV2zntHmdZGIguB5eWHTc,832
+PyData/id.py,sha256=qfIfi-tFYrEw0eVu_iwPFg4b2qXJJrecN6od-MvlkzA,942
+PyData/classes/repository.py,sha256=sQu_if8_N9dQGCpiekAmW7QiIM3AvXD2MHzq8alTlJg,4897
+pydatatoolskit-1.0.0.dist-info/METADATA,sha256=F-9nmZQ9dK4yQHA_mGhBTJusY7VCK8oDk3R0D2kXJoY,171
+pydatatoolskit-1.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+pydatatoolskit-1.0.0.dist-info/top_level.txt,sha256=sjkXs1KOSOZFRyjGnuA56SAYB48pQ_RWqKA5j7sFBZ4,7
+pydatatoolskit-1.0.0.dist-info/RECORD,,

pydatatoolskit-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pydatatoolskit-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+PyData