ramifice 0.8.29__py3-none-any.whl → 0.8.31__py3-none-any.whl

ramifice/__init__.py

@@ -23,21 +23,20 @@ The project is more concentrated for web development or for applications with a
 
 __all__ = (
     "NamedTuple",
+    "to_human_size",
     "model",
     "translations",
     "Migration",
-    "to_human_size",
     "Unit",
 )
 
 import logging
 
-from xloft import NamedTuple
+from xloft import NamedTuple, to_human_size
 
 from ramifice.models.decorator import model
 from ramifice.utils import translations
 from ramifice.utils.migration import Migration
-from ramifice.utils.tools import to_human_size
 from ramifice.utils.unit import Unit
 
 logging.basicConfig(

ramifice/fields/file_field.py

@@ -15,7 +15,11 @@ from anyio import Path, open_file, to_thread
 from ramifice.fields.general.field import Field
 from ramifice.fields.general.file_group import FileGroup
 from ramifice.utils import constants
-from ramifice.utils.constants import MEDIA_ROOT, MEDIA_URL
+from ramifice.utils.constants import (
+    MEDIA_ROOT,
+    MEDIA_URL,
+    UTC_TIMEZONE,
+)
 from ramifice.utils.errors import FileHasNoExtensionError
 from ramifice.utils.mixins import JsonMixin
 
@@ -147,7 +151,7 @@ class FileField(Field, FileGroup, JsonMixin):
             # Create new (uuid) file name.
             f_uuid_name = f"{uuid.uuid4()}{extension}"
             # Create the current date for the directory name.
-            date_str: str = str(datetime.now().date())  # noqa: DTZ005
+            date_str: str = str(datetime.now(UTC_TIMEZONE).date())
             # Create path to target directory.
             dir_target_path = f"{MEDIA_ROOT}/uploads/{self.target_dir}/{date_str}"
             # Create target directory if it does not exist.
@@ -193,7 +197,7 @@ class FileField(Field, FileGroup, JsonMixin):
             # Create new (uuid) file name.
             f_uuid_name = f"{uuid.uuid4()}{extension}"
             # Create the current date for the directory name.
-            date_str: str = str(datetime.now().date())  # noqa: DTZ005
+            date_str: str = str(datetime.now(UTC_TIMEZONE).date())
             # Create path to target directory.
             dir_target_path = f"{MEDIA_ROOT}/uploads/{self.target_dir}/{date_str}"
             # Create target directory if it does not exist.

ramifice/fields/image_field.py

@@ -15,7 +15,11 @@ from anyio import Path, open_file, to_thread
 from ramifice.fields.general.field import Field
 from ramifice.fields.general.file_group import FileGroup
 from ramifice.utils import constants
-from ramifice.utils.constants import MEDIA_ROOT, MEDIA_URL
+from ramifice.utils.constants import (
+    MEDIA_ROOT,
+    MEDIA_URL,
+    UTC_TIMEZONE,
+)
 from ramifice.utils.errors import FileHasNoExtensionError
 from ramifice.utils.mixins import JsonMixin
 
@@ -173,7 +177,7 @@ class ImageField(Field, FileGroup, JsonMixin):
                 if item[0] == 40:
                     break
             # Create the current date for the directory name.
-            date_str: str = str(datetime.now().date())  # noqa: DTZ005
+            date_str: str = str(datetime.now(UTC_TIMEZONE).date())
             # Directory name for the original image and its thumbnails.
             general_dir = uuid.uuid4()
             # Create path to target directory with images.
@@ -232,7 +236,7 @@ class ImageField(Field, FileGroup, JsonMixin):
                 logger.error(msg)
                 raise FileHasNoExtensionError(msg)
             # Create the current date for the directory name.
-            date_str: str = str(datetime.now().date())  # noqa: DTZ005
+            date_str: str = str(datetime.now(UTC_TIMEZONE).date())
             # Directory name for the original image and its thumbnails.
             general_dir = uuid.uuid4()
             # Create path to target directory with images.

ramifice/paladins/groups/file_group.py

@@ -7,12 +7,13 @@ __all__ = ("FileGroupMixin",)
 
 from typing import Any
 
+from xloft import to_human_size
+
 from ramifice.paladins.tools import (
     accumulate_error,
     panic_type_error,
 )
 from ramifice.utils import translations
-from ramifice.utils.tools import to_human_size
 
 
 class FileGroupMixin:

ramifice/paladins/groups/img_group.py

@@ -9,10 +9,10 @@ from asyncio import to_thread
 from typing import Any
 
 from PIL import Image
+from xloft import to_human_size
 
 from ramifice.paladins.tools import accumulate_error, panic_type_error
 from ramifice.utils import translations
-from ramifice.utils.tools import to_human_size
 
 
 class ImgGroupMixin:

ramifice/paladins/save.py

@@ -10,6 +10,7 @@ from pymongo.asynchronous.collection import AsyncCollection
 
 from ramifice.paladins.tools import ignored_fields_to_none, refresh_from_mongo_doc
 from ramifice.utils import constants
+from ramifice.utils.constants import UTC_TIMEZONE
 from ramifice.utils.errors import PanicError
 
 logger = logging.getLogger(__name__)
@@ -46,7 +47,7 @@ class SaveMixin:
         # Create or update a document in database.
         if result_check["is_update"]:
             # Update date and time.
-            checked_data["updated_at"] = datetime.now()  # noqa: DTZ005
+            checked_data["updated_at"] = datetime.now(UTC_TIMEZONE)
             # Run hook.
             await self.pre_update()
             # Update doc.
@@ -66,7 +67,7 @@ class SaveMixin:
             refresh_from_mongo_doc(self, mongo_doc)
         else:
             # Add date and time.
-            today = datetime.now()  # noqa: DTZ005
+            today = datetime.now(UTC_TIMEZONE)
             checked_data["created_at"] = today
             checked_data["updated_at"] = today
             # Run hook.

ramifice/paladins/validation.py

@@ -31,19 +31,19 @@ class ValidationMixin:
             if len(field_data.errors) > 0:
                 # title
                 if not is_err:
-                    print(colored("\nERRORS:", "red", attrs=["bold"]))  # noqa: T201
-                    print(colored("Model: ", "blue", attrs=["bold"]), end="")  # noqa: T201
-                    print(colored(f"`{self.full_model_name()}`", "blue"))  # noqa: T201
+                    print(colored("\nERRORS:", "red", attrs=["bold"]))
+                    print(colored("Model: ", "blue", attrs=["bold"]), end="")
+                    print(colored(f"`{self.full_model_name()}`", "blue"))
                     is_err = True
                 # field name
-                print(colored("Field: ", "green", attrs=["bold"]), end="")  # noqa: T201
-                print(colored(f"`{field_name}`:", "green"))  # noqa: T201
+                print(colored("Field: ", "green", attrs=["bold"]), end="")
+                print(colored(f"`{field_name}`:", "green"))
                 # error messages
-                print(colored("\n".join(field_data.errors), "red"))  # noqa: T201
+                print(colored("\n".join(field_data.errors), "red"))
         if len(self._id.alerts) > 0:
             # title
-            print(colored("AlERTS:", "yellow", attrs=["bold"]))  # noqa: T201
+            print(colored("AlERTS:", "yellow", attrs=["bold"]))
             # messages
-            print(colored("\n".join(self._id.alerts), "yellow"), end="\n\n")  # noqa: T201
+            print(colored("\n".join(self._id.alerts), "yellow"), end="\n\n")
         else:
-            print(end="\n\n")  # noqa: T201
+            print(end="\n\n")

ramifice/utils/constants.py

@@ -11,6 +11,7 @@ List of variables:
 - `MEDIA_URL` - URL that handles the media served from MEDIA_ROOT, used for managing stored files.
 - `STATIC_ROOT` - The absolute path to the directory where static files are located.
 - `STATIC_URL` - URL to use when referring to static files located in STATIC_ROOT.
+- `UTC_TIMEZONE` - Caching a patterns of regular expression.
 - `REGEX` - Caching a patterns of regular expression.
 """
 
@@ -24,11 +25,13 @@ __all__ = (
     "MEDIA_URL",
     "STATIC_ROOT",
     "STATIC_URL",
+    "UTC_TIMEZONE",
     "REGEX",
 )
 
 import re
 
+import pytz
 from pymongo import AsyncMongoClient
 from pymongo.asynchronous.database import AsyncDatabase
 
@@ -57,6 +60,8 @@ STATIC_ROOT: str = "public/static"
 # URL to use when referring to
 # static files located in STATIC_ROOT.
 STATIC_URL: str = "/static"
+# Caching a UTC timezone object.
+UTC_TIMEZONE = pytz.timezone("UTC")
 # Caching a patterns of regular expression.
 REGEX: dict[str, re.Pattern] = {
     "database_name": re.compile(r"^[a-zA-Z][-_a-zA-Z0-9]{0,59}$"),

ramifice/utils/fixtures.py

@@ -14,6 +14,7 @@ from dateutil.parser import parse
 from pymongo.asynchronous.collection import AsyncCollection
 from termcolor import colored
 
+from ramifice.utils.constants import UTC_TIMEZONE
 from ramifice.utils.errors import PanicError
 
 logger = logging.getLogger(__name__)
@@ -71,8 +72,8 @@ async def apply_fixture(
             # If the check fails.
             if not result_check["is_valid"]:
                 await collection.database.drop_collection(collection.name)
-                print(colored("\nFIXTURE:", "red", attrs=["bold"]))  # noqa: T201
-                print(colored(fixture_path, "blue", attrs=["bold"]))  # noqa: T201
+                print(colored("\nFIXTURE:", "red", attrs=["bold"]))
+                print(colored(fixture_path, "blue", attrs=["bold"]))
                 inst_model.print_err()
                 msg = f"Fixture `{fixture_name}` failed."
                 logger.critical(msg)
@@ -80,7 +81,7 @@ async def apply_fixture(
             # Get data for document.
             checked_data: dict[str, Any] = result_check["data"]
             # Add date and time.
-            today = datetime.now()  # noqa: DTZ005
+            today = datetime.now(UTC_TIMEZONE)
             checked_data["created_at"] = today
             checked_data["updated_at"] = today
             # Run hook.

ramifice/utils/migration.py

@@ -16,7 +16,12 @@ from termcolor import colored
 
 from ramifice.models.model import Model
 from ramifice.utils import constants
-from ramifice.utils.errors import DoesNotMatchRegexError, NoModelsForMigrationError, PanicError
+from ramifice.utils.constants import UTC_TIMEZONE
+from ramifice.utils.errors import (
+    DoesNotMatchRegexError,
+    NoModelsForMigrationError,
+    PanicError,
+)
 from ramifice.utils.fixtures import apply_fixture
 
 logger = logging.getLogger(__name__)
@@ -166,7 +171,7 @@ class Migration:
                         is_migration_process=True,
                     )
                     if not result_check["is_valid"]:
-                        print(colored("\n!!!>>MIGRATION<<!!!", "red", attrs=["bold"]))  # noqa: T201
+                        print(colored("\n!!!>>MIGRATION<<!!!", "red", attrs=["bold"]))
                         inst_model.print_err()
                         msg: str = "Migration failed."
                         logger.critical(msg)
@@ -181,7 +186,7 @@ class Migration:
                         ):
                             checked_data[field_name] = mongo_doc[field_name]
                     # Update date and time.
-                    checked_data["updated_at"] = datetime.now()  # noqa: DTZ005
+                    checked_data["updated_at"] = datetime.now(UTC_TIMEZONE)
                     # Update the document in the database.
                     await model_collection.replace_one(
                         filter={"_id": checked_data["_id"]},

ramifice/utils/tools.py

@@ -2,7 +2,6 @@
 
 __all__ = (
     "is_password",
-    "to_human_size",
     "get_file_size",
     "normal_email",
     "is_email",
@@ -15,7 +14,6 @@ __all__ = (
 )
 
 import ipaddress
-import math
 from asyncio import to_thread
 from os.path import getsize
 from typing import Any
@@ -35,14 +33,6 @@ def is_password(password: str | None) -> bool:
     return True
 
 
-def to_human_size(size: int) -> str:
-    """Convert number of bytes to readable format."""
-    idx = int(math.floor(math.log(size) / math.log(1024)))  # noqa: RUF046
-    size = size if size < 1024 else abs(round(size / pow(1024, idx), 2))
-    order = ["bytes", "KB", "MB", "GB", "TB"][idx]
-    return f"{size} {order}"
-
-
 async def get_file_size(path: str) -> int:
     """Get file size in bytes."""
     size: int = await to_thread(getsize, path)

{ramifice-0.8.29.dist-info → ramifice-0.8.31.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ramifice
-Version: 0.8.29
+Version: 0.8.31
 Summary: ORM-pseudo-like API MongoDB for Python language.
 Project-URL: Homepage, https://github.com/kebasyaty/ramifice
 Project-URL: Documentation, https://kebasyaty.github.io/ramifice/
@@ -33,6 +33,7 @@ Requires-Dist: pillow>=11.2.1
 Requires-Dist: pymongo>=4.13.0
 Requires-Dist: python-dateutil>=2.9.0.post0
 Requires-Dist: python-slugify>=8.0.4
+Requires-Dist: pytz>=2025.2
 Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: termcolor>=3.1.0
 Requires-Dist: xloft>=0.1.6

{ramifice-0.8.29.dist-info → ramifice-0.8.31.dist-info}/RECORD

@@ -1,4 +1,4 @@
-ramifice/__init__.py,sha256=XdLGeKCFqIVRyaj4M_dpdVvQ8Kx8rL3FtyuR08Ehnc4,1590
+ramifice/__init__.py,sha256=Nikv9qaOVLEwtxWIKB9rS6v1SPLgkM2DqQ9PtOlt-x0,1557
 ramifice/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ramifice/commons/__init__.py,sha256=HwOckqlNkt4OzFbYqnLw9x0VXLbwO_mJaJ9MLYgSvtI,545
 ramifice/commons/general.py,sha256=ZryiRH-qf_cH9HCul7EP11UU-k4YO_rp_kku2FWAwj4,5433
@@ -25,10 +25,10 @@ ramifice/fields/color_field.py,sha256=Q1ZezPW6Jl-9olKCx47pMdHTCauBY_lwoudxIhZpAg
 ramifice/fields/date_field.py,sha256=svJjb6KgsmpW4RO8y3Opkh2uFwwSVfzyeb7nd5tNXLs,6267
 ramifice/fields/date_time_field.py,sha256=jINGK1VrRt1boXmjJb6_WU7G7h_qnbUSolKNFOtVXFg,6324
 ramifice/fields/email_field.py,sha256=joReU6YV-ViewMiRVvHozVjIhXuPMwxA-cmqwR5kkHY,4389
-ramifice/fields/file_field.py,sha256=dAsOYXPjMNwC_t8jCyoNEwlRAsGEd9V_tiuix0qTukU,9476
+ramifice/fields/file_field.py,sha256=06tN6MS1_dIlqZZjPzRmtiCu42Jt_MA5KneqidiAV28,9503
 ramifice/fields/float_field.py,sha256=0OjoR9nwDs-Isv_lJoAT_jtdKmnd7-MqltCUiCViups,5796
 ramifice/fields/id_field.py,sha256=36VroZIgCH6uKuYjjWTXIycZ06ZGy4reLX6FhMUphCI,4757
-ramifice/fields/image_field.py,sha256=dZOB8ctt-7KeB-ePDwgeIgpNP6tLfnxWBU_E5_6dApc,12855
+ramifice/fields/image_field.py,sha256=hj7Zkxakqxhoj5C7bIzepuDEXcgyvyVE8REKWAU-NKo,12882
 ramifice/fields/integer_field.py,sha256=WKzmy-v2uLmIYlrTwcmuoUGfjWQhGD9wHukfQ0fUipk,5770
 ramifice/fields/ip_field.py,sha256=GjDo1g5PEolqb8_AcDqgE_BnTITqew2rZcqmEn3S5WA,4293
 ramifice/fields/password_field.py,sha256=lKELnyIjlAIJWeCR_3BCa0ZL5R0L73cf9zimigIgN3g,3902
@@ -54,30 +54,30 @@ ramifice/paladins/hooks.py,sha256=jTOcz5eb3WUpIy21h-CcnsISDDsTgDCWjitszcFxZFE,10
 ramifice/paladins/indexing.py,sha256=ep6iSUhnH70eaNASr0Kx3yeuRE_i9BEdVUUiJBo4hZE,363
 ramifice/paladins/password.py,sha256=7lZmsl-bBely5zlVz0aCYlC5yf8nHp1YswoFF4CZWBI,3297
 ramifice/paladins/refrash.py,sha256=oS-N1QVwQGwt5lSxS01bpM6ETGuMLV_RFt1u5v2uEds,1221
-ramifice/paladins/save.py,sha256=ahuPKo6qh9MHPXs_QNo9RbeBvN74uWtuI27k84gx5f4,3631
+ramifice/paladins/save.py,sha256=Dh9-qtnn9pNlWMfoCocjGjwO6F1nri2UyZh1vEuEHtU,3674
 ramifice/paladins/tools.py,sha256=8rkWPGrVMJiYN97EZuX52nVFVfB6qa08avYT4v8ohLA,2918
-ramifice/paladins/validation.py,sha256=vJ55g4al-V_aGxFSrnXDwAxjJXWv00Z8ZGexFipRD1c,1890
+ramifice/paladins/validation.py,sha256=3x8WUR0bTDkzJj41mEZyKc6brEmNukKpy0fc0NsniwQ,1764
 ramifice/paladins/groups/__init__.py,sha256=GdIBJaMKz7L8pBKMAA__a4m-p0g0_RlzCcvDLDMMiec,958
 ramifice/paladins/groups/bool_group.py,sha256=X8P4YDh02gNzxTo9rgeCnmnV88jApUPqPLYIkpf5vGg,841
 ramifice/paladins/groups/choice_group.py,sha256=NkD2sKqBkdUMHY36pFdvL4uQ-81LXByRHF_lhCEAI6Y,1848
 ramifice/paladins/groups/date_group.py,sha256=3i6U2mwFMxW8s5rRi7RtSr7my6a5Cdy5MRWe601hjGA,3780
-ramifice/paladins/groups/file_group.py,sha256=vDeW5JCqKHWa43LILcVWJSU1TG-CrwKXQZhchWsZgM8,2975
+ramifice/paladins/groups/file_group.py,sha256=_BbAveMZiwII7ZkCdePUSHzdkz3jVsKP2Aiop7lfedI,2962
 ramifice/paladins/groups/id_group.py,sha256=9iurBTOuhG1_8Wmxc5piTMcUNxAW3H0ZavA1sW7uopY,1321
-ramifice/paladins/groups/img_group.py,sha256=xSrDYqviuMt7mxOZiO0jKll1WnVlWRaSynk7ZvdEJ4c,6131
+ramifice/paladins/groups/img_group.py,sha256=5kmdkVnXKCeCiOnuO5T8Rq3U_R6gwXsHLYi7CtMfMfI,6116
 ramifice/paladins/groups/num_group.py,sha256=oiBqm9lFsyHBKZgxfWvcQUpePPIT_0TBGPVrt0ae57s,2285
 ramifice/paladins/groups/pass_group.py,sha256=54kvAyoUCEjujTw0Dh6oUrtv3RU80sWEem_b-3Ytv0k,1920
 ramifice/paladins/groups/slug_group.py,sha256=sf-9CebDLoCDsaxyPVJKMhi6D_tWFeg3ET8Qk5E8pU8,2505
 ramifice/paladins/groups/text_group.py,sha256=TWvUxFctwDtXSJQL_E4TvHX1Yh-cDx5MJLGLAJyC6Xc,4478
 ramifice/utils/__init__.py,sha256=lAD90nw2VfGSuf0SLjOkeFScBPmc48XFvecueAfq73w,468
-ramifice/utils/constants.py,sha256=zDVG2D8u0UMNl1Ik90PhZCdxjmK81uwqxosorersbXE,2630
+ramifice/utils/constants.py,sha256=fWVOganZbNHcUB4CXzEd0fr2Ch1NgL9OkgBsF08IzSo,2797
 ramifice/utils/errors.py,sha256=eEV7-aVR0U19vKqTd9JRHFJXcOv6N1HtXSzqeQpdciE,2796
-ramifice/utils/fixtures.py,sha256=0hdJGu895zDvVg5HUmRVUqDLZbvM-7BlhwTF6vhRqJI,3374
-ramifice/utils/migration.py,sha256=rA6RMIB7xrLNGUJHPuvxA5O0B3NkmG155et82kOtu7g,11316
+ramifice/utils/fixtures.py,sha256=0WUy0srEHH3QQugZ2pFOQ9MhgqFp1M3N9gUq7DSSJvw,3393
+ramifice/utils/migration.py,sha256=4XAmMfiCN3UV-NEQPKDjK_39yfkLFgorHsdIcdZcA0k,11370
 ramifice/utils/mixins.py,sha256=XSkxJllqsMxN7xcP_9kn3-GRS4a1l_QQpFOlD3e-tIM,1123
-ramifice/utils/tools.py,sha256=EKNJAV9Ch17IrmghLcu7-I69gDNkDSqPepG9GKU7WkA,3163
+ramifice/utils/tools.py,sha256=d5S38ksia6avBpLzXM3e3fzmRUMd8gM43JGAzJ7Nh6w,2799
 ramifice/utils/translations.py,sha256=EWITTDd4uXukRubOchqGwNjmZWt5HxoxRgq_kKeGsR8,4646
 ramifice/utils/unit.py,sha256=fxeWGWh5GkI8E9lxsf80HOh-NihSrqEmIQAQlUKMIaE,2497
-ramifice-0.8.29.dist-info/METADATA,sha256=hfYwYXqfRfVsffnIR8v6hpZ7xrqOL83KMSYJ0ZHyy_s,21066
-ramifice-0.8.29.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ramifice-0.8.29.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
-ramifice-0.8.29.dist-info/RECORD,,
+ramifice-0.8.31.dist-info/METADATA,sha256=72dzx-jP8VnFxA2e79IfZ5C8NFbpKvJFOh2J0TC6cYM,21094
+ramifice-0.8.31.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ramifice-0.8.31.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
+ramifice-0.8.31.dist-info/RECORD,,