transcrypto 2.3.2__tar.gz → 2.3.3__tar.gz

{transcrypto-2.3.2 → transcrypto-2.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: transcrypto
-Version: 2.3.2
+Version: 2.3.3
 Summary: Basic crypto primitives, not intended for actual use, but as a companion to --Criptografia, Métodos e Algoritmos--
 License-Expression: Apache-2.0
 License-File: LICENSE

{transcrypto-2.3.2 → transcrypto-2.3.3}/pyproject.toml

@@ -12,7 +12,7 @@ build-backend = "poetry.core.masonry.api"
 [project]
 
 name = "transcrypto"
-version = "2.3.2"  # also update src/transcrypto/__init__.py
+version = "2.3.3"  # also update src/transcrypto/__init__.py
 
 description = "Basic crypto primitives, not intended for actual use, but as a companion to --Criptografia, Métodos e Algoritmos--"
 license = "Apache-2.0"

{transcrypto-2.3.2 → transcrypto-2.3.3}/src/transcrypto/__init__.py

@@ -3,5 +3,5 @@
 """Basic cryptography primitives implementation."""
 
 __all__: list[str] = ['__author__', '__version__']
-__version__ = '2.3.2'  # remember to also update pyproject.toml
+__version__ = '2.3.3'  # remember to also update pyproject.toml
 __author__ = 'Daniel Balparda <balparda@github.com>'

{transcrypto-2.3.2 → transcrypto-2.3.3}/src/transcrypto/utils/timer.py

@@ -18,13 +18,53 @@ from transcrypto.utils import base, human
 
 MIN_TM = int(datetime.datetime(2000, 1, 1, 0, 0, 0, tzinfo=datetime.UTC).timestamp())
 TIME_FORMAT = '%Y/%b/%d-%H:%M:%S-UTC'
-TimeStr: abc.Callable[[int | float | None], str] = lambda tm: (
+TimeStr: abc.Callable[[float | None], str] = lambda tm: (
   time.strftime(TIME_FORMAT, time.gmtime(tm)) if tm else '-'
 )
 Now: abc.Callable[[], int] = lambda: int(time.time())
 StrNow: abc.Callable[[], str] = lambda: TimeStr(Now())
 
 
+def DatetimeFromISO(s: str) -> datetime.datetime:
+  """Parse ISO datetime and ensure it is timezone-aware (default UTC).
+
+  Args:
+    s (str): ISO 8601 datetime string.
+
+  Returns:
+    Timezone-aware datetime (UTC if input was naive).
+
+  """
+  dt: datetime.datetime = datetime.datetime.fromisoformat(s)
+  return dt if dt.tzinfo is not None else dt.replace(tzinfo=datetime.UTC)
+
+
+def ISOFromDatetime(dt: datetime.datetime) -> str:
+  """Convert a datetime to an ISO 8601 string.
+
+  Args:
+    dt (datetime.datetime): The datetime to convert.
+
+  Returns:
+    str: The ISO 8601 string representation of the datetime.
+
+  """
+  return dt.isoformat()
+
+
+def UTCDatetimeFromUnix(tm: float) -> datetime.datetime:
+  """Convert a Unix timestamp to a timezone-aware datetime (UTC).
+
+  Args:
+    tm (float): Unix timestamp (seconds since epoch).
+
+  Returns:
+    Timezone-aware datetime in UTC.
+
+  """
+  return datetime.datetime.fromtimestamp(tm, tz=datetime.UTC)
+
+
 class Timer:
   """An execution timing class that can be used as both a context manager and a decorator.