libdev 0.83__tar.gz → 0.85__tar.gz

{libdev-0.83 → libdev-0.85}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: libdev
-Version: 0.83
+Version: 0.85
 Summary: Set of standard functions for development
 Home-page: https://github.com/chilleco/lib
 Author: Alex Poloz
@@ -41,6 +41,7 @@ Data Format | ` libdev.num ` | Numeric conversions & handlers
 Transforms | ` libdev.gen ` | Code & token generators
   | ` libdev.codes ` | Ciphers: langs & flags / networks / user statuses
   | ` libdev.check ` | Validation functions
+  | ` libdev.crypt ` | Encryption and decryption functions
 Fields | ` libdev.dev ` | Development tools
   | ` libdev.fin ` | Financial codes and tools
   | ` libdev.lang ` | Natural language formatters

{libdev-0.83 → libdev-0.85}/README.md

@@ -15,6 +15,7 @@ Data Format | ` libdev.num ` | Numeric conversions & handlers
 Transforms | ` libdev.gen ` | Code & token generators
   | ` libdev.codes ` | Ciphers: langs & flags / networks / user statuses
   | ` libdev.check ` | Validation functions
+  | ` libdev.crypt ` | Encryption and decryption functions
 Fields | ` libdev.dev ` | Development tools
   | ` libdev.fin ` | Financial codes and tools
   | ` libdev.lang ` | Natural language formatters

{libdev-0.83 → libdev-0.85}/libdev/__init__.py

@@ -2,6 +2,6 @@
 Initializing the Python package
 """
 
-__version__ = "0.83"
+__version__ = "0.85"
 
 __all__ = ("__version__",)

libdev-0.85/libdev/crypt.py

@@ -0,0 +1,112 @@
+"""
+Provides functions for encrypting and decrypting integers
+using a custom base encoding scheme
+"""
+
+import random
+import string
+
+# '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'
+ALPHABET = string.digits + string.ascii_letters
+BASE = len(ALPHABET)
+
+
+def _int_to_custom_base(number):
+    """
+    Convert an integer to a custom base string.
+
+    Args:
+        number (int): The integer to convert.
+
+    Returns:
+        str: The custom base string representation of the integer.
+    """
+    if number == 0:
+        return ALPHABET[0]
+    result = ""
+    while number > 0:
+        result = ALPHABET[number % BASE] + result
+        number //= BASE
+    return result
+
+
+def _custom_base_to_int(encoded_str):
+    """
+    Convert a custom base string to an integer.
+
+    Args:
+        encoded_str (str): The custom base string to convert.
+
+    Returns:
+        int: The integer representation of the custom base string.
+    """
+    number = 0
+    for char in encoded_str:
+        number = number * BASE + ALPHABET.index(char)
+    return number
+
+
+def _get_checksum(encoded_str):
+    """
+    Calculate the checksum for a custom base string.
+
+    Args:
+        encoded_str (str): The custom base string.
+
+    Returns:
+        str: The checksum character.
+    """
+    checksum_value = sum(ALPHABET.index(char) for char in encoded_str) % BASE
+    return ALPHABET[checksum_value]
+
+
+def encrypt(number, length=5):
+    """
+    Encrypt an integer by converting it to a custom base string,
+    adding a checksum, and padding with random characters.
+
+    Args:
+        number (int): The integer to encrypt.
+        length (int): The desired length of the encrypted string.
+
+    Returns:
+        str: The encrypted string.
+    """
+    if number is None:
+        return None
+    # Convert the number to custom base
+    encoded_str = _int_to_custom_base(number)
+    # Calculate checksum and append to the end
+    checksum = _get_checksum(encoded_str)
+    if encoded_str != checksum:
+        encoded_str += checksum
+    # Add random characters to the beginning to meet the desired length
+    while len(encoded_str) < length:
+        random_char = random.choice(ALPHABET)
+        if _get_checksum(random_char + encoded_str[:-1]) != checksum:
+            encoded_str = random_char + encoded_str
+    return encoded_str
+
+
+def decrypt(encoded_str):
+    """
+    Decrypt an encoded string back to its original integer form.
+
+    Args:
+        encoded_str (str): The encoded string to decrypt.
+
+    Returns:
+        int: The original integer.
+
+    Raises:
+        ValueError: If the encoded string is invalid.
+    """
+    # Extract the checksum
+    checksum = encoded_str[-1]
+    encoded_str = encoded_str[:-1]
+    # Find the actual encoded string by removing the random characters
+    for i in range(len(encoded_str)):
+        candidate = encoded_str[i:]
+        if _get_checksum(candidate) == checksum:
+            return _custom_base_to_int(candidate)
+    return _custom_base_to_int(checksum)

{libdev-0.83 → libdev-0.85}/libdev/time.py

@@ -54,6 +54,11 @@ def get_time(data=None, template="%d.%m.%Y %H:%M:%S", tz=0):
     return time.strftime(template, time.gmtime(data + tz * 3600))
 
 
+def get_date(data=None, template="%d.%m.%Y", tz=0):
+    """Get date from timestamp"""
+    return get_time(data, template, tz)
+
+
 def decode_time(data=None, template="%d.%m.%Y %H:%M:%S", tz=0):
     """Get timestamp from time"""
 
@@ -72,6 +77,11 @@ def decode_time(data=None, template="%d.%m.%Y %H:%M:%S", tz=0):
     return int(data.timestamp())
 
 
+def decode_date(data=None, template="%d.%m.%Y", tz=0):
+    """Get timestamp from date"""
+    return decode_time(data, template, tz)
+
+
 # pylint: disable=too-many-branches,too-many-statements
 def parse_time(data: str, tz=0):
     """Parse time"""

{libdev-0.83 → libdev-0.85}/libdev.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: libdev
-Version: 0.83
+Version: 0.85
 Summary: Set of standard functions for development
 Home-page: https://github.com/chilleco/lib
 Author: Alex Poloz
@@ -41,6 +41,7 @@ Data Format | ` libdev.num ` | Numeric conversions & handlers
 Transforms | ` libdev.gen ` | Code & token generators
   | ` libdev.codes ` | Ciphers: langs & flags / networks / user statuses
   | ` libdev.check ` | Validation functions
+  | ` libdev.crypt ` | Encryption and decryption functions
 Fields | ` libdev.dev ` | Development tools
   | ` libdev.fin ` | Financial codes and tools
   | ` libdev.lang ` | Natural language formatters

{libdev-0.83 → libdev-0.85}/libdev.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ libdev/__init__.py
 libdev/cfg.py
 libdev/check.py
 libdev/codes.py
+libdev/crypt.py
 libdev/dev.py
 libdev/doc.py
 libdev/fin.py
@@ -24,6 +25,7 @@ libdev.egg-info/top_level.txt
 tests/test_cfg.py
 tests/test_check.py
 tests/test_codes.py
+tests/test_crypt.py
 tests/test_dev.py
 tests/test_doc.py
 tests/test_gen.py

libdev-0.85/tests/test_crypt.py

@@ -0,0 +1,12 @@
+from libdev.crypt import encrypt, decrypt
+
+
+def test_cfg_json():
+    assert encrypt(None) == None
+    assert encrypt(0)[-1:] == "0"
+    assert encrypt(0, length=0) == "0"
+    assert encrypt(0, length=10)[-1:] == "0"
+    assert decrypt(encrypt(0, length=15)) == 0
+    assert decrypt(encrypt(123, length=15)) == 123
+    for i in range(0, 1000):
+        assert decrypt(encrypt(i)) == i

{libdev-0.83 → libdev-0.85}/tests/test_time.py

@@ -4,7 +4,14 @@ https://www.epochconverter.com/
 
 import datetime
 
-from libdev.time import get_time, decode_time, parse_time, format_delta
+from libdev.time import (
+    get_time,
+    get_date,
+    decode_time,
+    decode_date,
+    parse_time,
+    format_delta,
+)
 
 
 def test_get_time():
@@ -22,6 +29,10 @@ def test_get_time():
     )
 
 
+def test_get_date():
+    assert get_date(1641061152.4) == "01.01.2022"
+
+
 def test_decode_time():
     assert decode_time("") == None
     assert decode_time("01.01.2022 21:19:12", tz=3) == 1641061152
@@ -29,6 +40,10 @@ def test_decode_time():
     assert decode_time("2024-10-07", "%Y-%m-%d", 4) == 1728244800
 
 
+def test_decode_date():
+    assert decode_date("01.01.2022", tz=3) == 1640984400
+
+
 def test_parse_time():
     assert parse_time("07.10.1998", tz=3) == 907707600
     assert parse_time("7.10.1998 7:00:00") == 907743600