mtcli 3.8.0.dev16__tar.gz → 3.8.0.dev17__tar.gz

{mtcli-3.8.0.dev16 → mtcli-3.8.0.dev17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mtcli
-Version: 3.8.0.dev16
+Version: 3.8.0.dev17
 Summary: Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly
 License-Expression: MIT
 License-File: LICENSE

mtcli-3.8.0.dev17/mtcli/utils/time.py

@@ -0,0 +1,65 @@
+"""
+Utilitários de conversão de tempo para o mtcli.
+
+Este módulo fornece funções para:
+- Obter o horário atual em UTC
+- Converter datas de UTC para o timezone da B3 (Brasil)
+- Converter datas da B3 para UTC
+
+Todas as funções trabalham com objetos datetime timezone-aware.
+"""
+
+from datetime import datetime
+from zoneinfo import ZoneInfo
+
+
+# Timezones padrão
+UTC = ZoneInfo("UTC")
+B3_TZ = ZoneInfo("America/Sao_Paulo")
+
+
+def now_utc():
+    """
+    Retorna o horário atual em UTC.
+
+    Returns:
+        datetime: Data/hora atual com timezone UTC (aware).
+    """
+    return datetime.now(tz=UTC)
+
+
+def utc_to_b3(dt):
+    """
+    Converte um datetime em UTC para o timezone da B3.
+
+    Caso o datetime seja naive (sem timezone), assume-se que ele já está em UTC.
+
+    Args:
+        dt (datetime): Data/hora em UTC (aware ou naive).
+
+    Returns:
+        datetime: Data/hora convertida para o timezone da B3.
+    """
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=UTC)
+
+    return dt.astimezone(B3_TZ)
+
+
+def b3_to_utc(dt):
+    """
+    Converte um datetime do timezone da B3 para UTC.
+
+    Caso o datetime seja naive (sem timezone), assume-se que ele já está
+    no horário da B3 (America/Sao_Paulo).
+
+    Args:
+        dt (datetime): Data/hora no timezone da B3 (aware ou naive).
+
+    Returns:
+        datetime: Data/hora convertida para UTC.
+    """
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=B3_TZ)
+
+    return dt.astimezone(UTC)

{mtcli-3.8.0.dev16 → mtcli-3.8.0.dev17}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mtcli"
-version = "3.8.0.dev16"
+version = "3.8.0.dev17"
 description = "Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly"
 authors = [
     {name = "Valmir França",email = "vfranca3@gmail.com"}

mtcli-3.8.0.dev16/mtcli/utils/time.py

@@ -1,16 +0,0 @@
-from datetime import datetime
-from zoneinfo import ZoneInfo
-
-
-UTC = ZoneInfo("UTC")
-B3_TZ = ZoneInfo("America/Sao_Paulo")
-
-
-def now_utc():
-    return datetime.now(tz=UTC)
-
-
-def utc_to_b3(dt):
-    if dt.tzinfo is None:
-        dt = dt.replace(tzinfo=UTC)
-    return dt.astimezone(B3_TZ)