ramifice 0.3.25__py3-none-any.whl → 0.3.27__py3-none-any.whl

ramifice/paladins/groups/file_group.py

@@ -6,7 +6,7 @@ Supported fields: FileField
 from typing import Any
 
 from ... import translations
-from ...utilities import to_human_size
+from ...tools import to_human_size
 from ..tools import accumulate_error, panic_type_error
 
 

ramifice/paladins/groups/img_group.py

@@ -8,7 +8,7 @@ from typing import Any
 from PIL import Image
 
 from ... import translations
-from ...utilities import to_human_size
+from ...tools import to_human_size
 from ..tools import accumulate_error, panic_type_error
 
 

ramifice/paladins/groups/pass_group.py

@@ -8,7 +8,7 @@ from typing import Any
 from argon2 import PasswordHasher
 
 from ... import translations
-from ...utilities import is_password
+from ...tools import is_password
 from ..tools import accumulate_error, panic_type_error
 
 

ramifice/paladins/groups/text_group.py

@@ -10,7 +10,7 @@ from typing import Any
 from email_validator import EmailNotValidError, validate_email
 
 from ... import translations
-from ...utilities import is_color, is_ip, is_phone, is_url
+from ...tools import is_color, is_ip, is_phone, is_url
 from ..tools import accumulate_error, check_uniqueness, panic_type_error
 
 

ramifice/{utilities.py → tools.py}

@@ -29,13 +29,17 @@ def to_human_size(size: int) -> str:
 
 
 def get_file_size(path: str) -> int:
-    """Get human readable version of file size."""
+    """Get file size in bytes."""
     size: int = os.path.getsize(path)
     return size
 
 
 def normal_email(email: str | None) -> str | None:
-    """Normalizing email address."""
+    """Normalizing email address.
+    
+    Use this before requeste to a database.
+    For example, on the login page.
+    """
     normal: str | None = None
     try:
         emailinfo = validate_email(str(email), check_deliverability=False)

{ramifice-0.3.25.dist-info → ramifice-0.3.27.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ramifice
-Version: 0.3.25
+Version: 0.3.27
 Summary: ORM-like API MongoDB for Python language.
 Project-URL: Homepage, https://github.com/kebasyaty/ramifice
 Project-URL: Documentation, https://kebasyaty.github.io/ramifice/
@@ -513,7 +513,7 @@ await user.delete(remove_files=False)
 # Verification, replacement and recoverang of password.
 user = User()
 await user.verify_password(password="12345678")
-await user.update_password(  # uses verify_password
+await user.update_password(  # + verify_password
   old_password="12345678",
   new_password="O2eA4GIr38KGGlS",
 )
@@ -522,7 +522,7 @@ await user.update_password(  # uses verify_password
 ## General auxiliary methods
 
 ```python
-from ramifice.utilities import (
+from ramifice.tools import (
     get_file_size,
     hash_to_obj_id,
     is_color,
@@ -536,34 +536,47 @@ from ramifice.utilities import (
     to_human_size,
 )
 
+# Validate Password.
 if is_password("12345678"):
     ...
 
+# Validate Email address.
 if is_email("kebasyaty@gmail.com"):
     ...
 
-email = normal_email("kebasyaty@gmail.com")  # + validate_email
+# Normalizing email address.
+# Use this before requeste to a database.
+# For example, on the login page.
+email: str | None = normal_email("kebasyaty@gmail.com")  # None, if not valid
 
+# Validate URL address.
 if is_url("https://www.google.com"):
     ...
 
+# Validate IP address.
 if is_ip("127.0.0.1"):
     ...
 
+# Validate Color code.
 if is_color("#000"):
     ...
 
+# Validate Phone number.
 if is_phone("+447986123456"):
     ...
 
+# Validation of the Mongodb identifier.
 if is_mongo_id("666f6f2d6261722d71757578"):
     ...
 
+# Get ObjectId from hash string.
 from bson.objectid import ObjectId
 _id: ObjectId | None = hash_to_obj_id("666f6f2d6261722d71757578")
 
+# Convert number of bytes to readable format.
 size: str = to_human_size(2097152)  # => 2.0 MB
 
+# Get file size in bytes.
 path = "public/media/default/no_doc.odt"
 size: int = get_file_size(path)  # => 9843
 ```

{ramifice-0.3.25.dist-info → ramifice-0.3.27.dist-info}/RECORD

@@ -11,9 +11,9 @@ ramifice/model.py,sha256=xhLKosxnT3HkPr6j_BSkB7pvG2WNY_7uylcHo3Oq0vM,6521
 ramifice/pseudo_model.py,sha256=K00TqtrO6QScfAswM3Rr5Y017PfbtEXHymGSJYYgA40,6744
 ramifice/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ramifice/store.py,sha256=MpDEPvUvbs11FXjakNtHPm9MekIv5p1U3as2Y80lTyc,1860
+ramifice/tools.py,sha256=NX4mtXBi6H3UNlYcTMdlfltJ0MikTPa7kpB3F0qmUpM,2731
 ramifice/translations.py,sha256=GNGE0ULAA0aOY5pTxUd3MQW-nVaKvp6BeXWEcsR0s0o,4048
 ramifice/types.py,sha256=ljo6VscUGWEJ4Km4JYo8GEfxd1YK1CUbS8CfHp_MlEA,2390
-ramifice/utilities.py,sha256=2qfdSvqlL3rhT8-7MW83IoMjKQ0CZz0e24UTxMcOq90,2654
 ramifice/commons/__init__.py,sha256=LHCsdpl4z8W-xUvAlOr1ad0ras9hspvCpuce4SAdfP0,472
 ramifice/commons/general.py,sha256=fTnIRA3IGbi0lMKBCgeqkI7BGJWTbZVu0nOJYoNRSRU,4571
 ramifice/commons/indexes.py,sha256=ABNRXeWZSreAE4_EDlsTN9aS8QiZbzhsatUJFn2EuOo,3849
@@ -69,14 +69,14 @@ ramifice/paladins/groups/__init__.py,sha256=hpqmWLsYAMvZHAbmMXluQSqLhkHOSTUAgLHy
 ramifice/paladins/groups/bool_group.py,sha256=oJc9mw9KGrnK_Pj7uXixYYQAJphcXLr_xSQv3PMUlcU,792
 ramifice/paladins/groups/choice_group.py,sha256=ZV6t6qgh__BzWGRUSx2RdXH_K9BtBOo0eAZ3Yon0tfY,1723
 ramifice/paladins/groups/date_group.py,sha256=bVhzmwsN3sKbmzvm4jI0i_Mzjwn8gdx4kxCUWq-0Yqs,3736
-ramifice/paladins/groups/file_group.py,sha256=AtGu2sQ9A64dPo2Kpt4milp5HWPdULdPdQycwFW8ZgE,2925
+ramifice/paladins/groups/file_group.py,sha256=mK12CeQPtbvckAeFApmT1TyG0dxh1rLMv7EmL4zuP-8,2921
 ramifice/paladins/groups/id_group.py,sha256=zAlJrDTOdRY9e7eFYSXPjjsD05A4EsgSE6ibN3KKOMU,1263
-ramifice/paladins/groups/img_group.py,sha256=o0bMI1WIA6t1QrhLaR2bBAAJUKCgHg7SiIFQsGTr2Cg,5535
+ramifice/paladins/groups/img_group.py,sha256=J5ZR_9h3ZUZcKlJ9cCgwWr36V1DGHqqSjU8A-1okcto,5531
 ramifice/paladins/groups/num_group.py,sha256=lpyFG9a6WGOzu9f_9jwYVWZNFHxG0B0AVWvvbv_2mV0,2224
-ramifice/paladins/groups/pass_group.py,sha256=tjBSovPSCKATF46FazT0a1EQ2YiztRqOjBq0uu2nTU8,1852
+ramifice/paladins/groups/pass_group.py,sha256=Vh2guTwRsMK82Gkqhg2jYhk68OjL3Cjz9NxxJ6z_1D8,1848
 ramifice/paladins/groups/slug_group.py,sha256=SVYxHcSSgCA51C18LVGxMQYuUw-6ryQlTi6B9T8Dzsw,2185
-ramifice/paladins/groups/text_group.py,sha256=o5DnlptN93vsHtb36qO-noEnPv7CSAiqVj1j603zKw0,3159
-ramifice-0.3.25.dist-info/METADATA,sha256=RCix9UrN67JO5bCxjhQ4lgWYtiX-RlQJHzm7erzuuN8,20303
-ramifice-0.3.25.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ramifice-0.3.25.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
-ramifice-0.3.25.dist-info/RECORD,,
+ramifice/paladins/groups/text_group.py,sha256=lveVuDMcQwLNUtQBlOjfwFzEWH5_F8L6JxIf936lIQ0,3155
+ramifice-0.3.27.dist-info/METADATA,sha256=txVWbR0T_4Ab1-lrKIUiyHBuHTCIHAFTzM5FQcv-P18,20702
+ramifice-0.3.27.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ramifice-0.3.27.dist-info/licenses/LICENSE,sha256=LrEL0aTZx90HDwFUQCJutORiDjJL9AnuVvCtspXIqt4,1095
+ramifice-0.3.27.dist-info/RECORD,,