PYield 0.29.2__tar.gz → 0.29.3__tar.gz

{pyield-0.29.2 → pyield-0.29.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PYield
-Version: 0.29.2
+Version: 0.29.3
 Summary: A Python library for analysis of fixed income instruments in Brazil
 Project-URL: Source, https://github.com/crdcj/PYield
 Author-email: Carlos Carvalho <cr.cj@outlook.com>

pyield-0.29.3/pyield/__about__.py

@@ -0,0 +1 @@
+__version__ = "0.29.3"

{pyield-0.29.2 → pyield-0.29.3}/pyield/__init__.py

@@ -1,9 +1,9 @@
 import logging
 
-from pyield import anbima, bc, bday, ibge
+from pyield import anbima, b3, bc, bday, ibge
 from pyield.__about__ import __version__
-from pyield.b3_futures import futures
-from pyield.b3_futures.di import DIFutures
+from pyield.b3 import futures
+from pyield.b3.di import DIFutures
 from pyield.forwards import forward_rates
 from pyield.interpolator import Interpolator
 from pyield.tpf import lft, ltn, ntnb, ntnf
@@ -22,6 +22,7 @@ __all__ = [
     "ntnb",
     "ntnf",
     "bc",
+    "b3",
 ]
 
 # Configura o logger do pacote principal com um NullHandler

pyield-0.29.3/pyield/b3/__init__.py

@@ -0,0 +1,9 @@
+from pyield.b3.di import DIFutures
+from pyield.b3.di_over import di_over
+from pyield.b3.futures import futures
+
+__all__ = [
+    "di_over",
+    "futures",
+    "DIFutures",
+]

{pyield-0.29.2/pyield/b3_futures → pyield-0.29.3/pyield/b3}/di.py

@@ -1,9 +1,8 @@
 import pandas as pd
 
-import pyield.b3_futures as b3
 import pyield.date_converter as dc
 import pyield.forwards as tl
-from pyield import bday, interpolator
+from pyield import b3, bday, interpolator
 from pyield.data_cache import get_anbima_dataset, get_di_dataset
 from pyield.date_converter import DateArray, DateScalar
 

pyield-0.29.3/pyield/b3/di_over.py

@@ -0,0 +1,70 @@
+import ftplib
+
+from pyield.date_converter import DateScalar, convert_input_dates
+
+
+def di_over(date: DateScalar) -> float:
+    """
+    Gets the DI (Interbank Deposit) rate for a specific date from B3/CETIP FTP server.
+
+    Args:
+        date (str): Date in DD/MM/YYYY format
+
+    Returns:
+        float: DI rate for the specified date
+
+    Raises:
+        ValueError: If date is not in the correct format
+        ftplib.error_perm: If the file is not found or there is a permission error
+        Exception: For any other unexpected error
+
+    Examples:
+        >>> di_over("28/02/2025")
+        0.1315
+    """
+    ftp = None
+    try:
+        # Convert date to file format
+        date_obj = convert_input_dates(date)
+        filename = date_obj.strftime("%Y%m%d.txt")
+
+        # Connect to FTP and get the file
+        ftp = ftplib.FTP("ftp.cetip.com.br")
+        ftp.login()
+        ftp.cwd("/MediaCDI")
+
+        # Read rate
+        lines = []
+        ftp.retrlines(f"RETR {filename}", lines.append)
+
+        # Close FTP connection
+        ftp.quit()
+
+        # Get and format rate
+        if lines:
+            raw_rate = lines[0].strip()
+            rate = int(raw_rate) / 10000
+            return round(rate, 5)
+        else:
+            return "Empty file or no data"
+
+    except ValueError as e:
+        return f"Date format error: {e}"
+    except ftplib.error_perm as e:
+        return f"File access error: {e}"
+    except Exception as e:
+        return f"Unexpected error: {e}"
+    finally:
+        # Ensure FTP connection is closed
+        if ftp:
+            try:
+                ftp.quit()
+            except:  # noqa
+                pass
+
+
+# Example usage
+if __name__ == "__main__":
+    date = "28/02/2025"
+    rate = di_over(date)
+    print(f"DI Rate for {date}: {rate}")

{pyield-0.29.2/pyield/b3_futures → pyield-0.29.3/pyield/b3/futures}/__init__.py

@@ -5,8 +5,8 @@ from zoneinfo import ZoneInfo
 import pandas as pd
 
 from pyield import date_converter as dc
-from pyield.b3_futures.historical import fetch_historical_df
-from pyield.b3_futures.intraday import fetch_intraday_df
+from pyield.b3.futures.historical import fetch_historical_df
+from pyield.b3.futures.intraday import fetch_intraday_df
 from pyield.date_converter import DateScalar
 
 TIMEZONE_BZ = ZoneInfo("America/Sao_Paulo")

{pyield-0.29.2/pyield/b3_futures → pyield-0.29.3/pyield/b3/futures}/historical.py

@@ -4,7 +4,7 @@ import pandas as pd
 import requests
 
 from pyield import bday
-from pyield.b3_futures import common
+from pyield.b3.futures import common
 
 COUNT_CONVENTIONS = {
     "DAP": 252,

{pyield-0.29.2/pyield/b3_futures → pyield-0.29.3/pyield/b3/futures}/xml.py

@@ -8,7 +8,7 @@ import requests
 from lxml import etree
 
 from pyield import bday
-from pyield.b3_futures import common
+from pyield.b3.futures import common
 
 
 def _get_file_from_path(file_path: Path) -> io.BytesIO:

{pyield-0.29.2 → pyield-0.29.3}/pyield/tpf/ltn.py

@@ -3,7 +3,7 @@ import pandas as pd
 from pyield import bday
 from pyield import date_converter as dc
 from pyield.anbima import tpf
-from pyield.b3_futures import di
+from pyield.b3 import di
 from pyield.date_converter import DateScalar
 from pyield.tpf import tools as tt
 

{pyield-0.29.2 → pyield-0.29.3}/pyield/tpf/ntnf.py

@@ -7,7 +7,7 @@ from pyield import bday
 from pyield import date_converter as dc
 from pyield import interpolator as ip
 from pyield.anbima import tpf
-from pyield.b3_futures import di
+from pyield.b3 import di
 from pyield.date_converter import DateScalar
 from pyield.tpf import tools as tt
 

{pyield-0.29.2 → pyield-0.29.3}/pyield/tpf/tools.py

@@ -5,7 +5,7 @@ import pandas as pd
 
 from pyield import date_converter as dc
 from pyield.anbima import tpf
-from pyield.b3_futures.di import DIFutures
+from pyield.b3.di import DIFutures
 from pyield.date_converter import DateScalar
 
 

pyield-0.29.2/pyield/__about__.py

@@ -1 +0,0 @@
-__version__ = "0.29.2"