pyield 0.48.6__tar.gz → 0.48.7__tar.gz

{pyield-0.48.6 → pyield-0.48.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyield
-Version: 0.48.6
+Version: 0.48.7
 Summary: A Python library for analysis of fixed income instruments in Brazil
 Project-URL: Homepage, https://github.com/crdcj/PYield
 Project-URL: Documentation, https://crdcj.github.io/PYield

pyield-0.48.7/pyield/__about__.py

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

pyield-0.48.7/pyield/bc/_olinda.py

@@ -0,0 +1,33 @@
+"""Helpers compartilhados para acesso à API OData do BCB (olinda.bcb.gov.br)."""
+
+import polars as pl
+import requests
+
+from pyield._internal.retry import retry_padrao
+
+
+def montar_url(url_base: str, parametros: dict[str, str]) -> str:
+    """Monta URL OData com parâmetros opcionais e formato CSV.
+
+    Args:
+        url_base: URL base do endpoint OData (com '?' no final).
+        parametros: Dicionário ``{nome_param: valor}`` já formatado.
+            Parâmetros com valor vazio são ignorados.
+    """
+    partes = [f"@{k}='{v}'" for k, v in parametros.items() if v]
+    return url_base + "&".join(partes) + "&$format=text/csv"
+
+
+@retry_padrao
+def buscar_csv(url: str) -> bytes:
+    """Busca CSV da API OData do BCB com retry automático."""
+    r = requests.get(url, timeout=10)
+    r.raise_for_status()
+    return r.content
+
+
+def parsear_csv(dados: bytes) -> pl.DataFrame:
+    """Lê CSV OData como DataFrame sem inferência de tipos."""
+    if not dados.strip():
+        return pl.DataFrame()
+    return pl.read_csv(dados, infer_schema=False, null_values=["null", ""])

{pyield-0.48.6 → pyield-0.48.7}/pyield/bc/compromissada.py

@@ -13,63 +13,27 @@ ac1b013d13d6fb1d9d9e251b8000121e, 2025-08-21   , 12:00     , TodoMercado
 """
 
 import polars as pl
-import requests
 
 import pyield._internal.converters as cv
 from pyield import du
 from pyield._internal.br_numbers import float_br, taxa_br
-from pyield._internal.retry import retry_padrao
 from pyield._internal.types import DateLike
+from pyield.bc._olinda import buscar_csv, montar_url, parsear_csv
 
 URL_BASE_API = "https://olinda.bcb.gov.br/olinda/servico/leiloes_selic/versao/v1/odata/leiloes_compromissadas(dataLancamentoInicio=@dataLancamentoInicio,dataLancamentoFim=@dataLancamentoFim,horaInicio=@horaInicio,dataLiquidacao=@dataLiquidacao,dataRetorno=@dataRetorno,publicoPermitidoLeilao=@publicoPermitidoLeilao,nomeTipoOferta=@nomeTipoOferta)?"
 
 
-def _montar_url(
+def _montar_parametros(
     inicio: DateLike | None,
     fim: DateLike | None,
-) -> str:
-    """Monta URL de consulta conforme parâmetros opcionais de período.
-
-    Regras da API:
-        - Apenas inicio: retorna de inicio até o fim da série.
-        - Apenas fim: retorna do início da série até fim.
-        - Ambos ausentes: retorna a série completa.
-    """
-    url = URL_BASE_API
+) -> dict[str, str]:
+    """Converte parâmetros opcionais de período em dicionário para a URL."""
+    params: dict[str, str] = {}
     if inicio:
-        inicio_dt = cv.converter_datas(inicio)
-        inicio_str = inicio_dt.strftime("%Y-%m-%d")
-        url += f"@dataLancamentoInicio='{inicio_str}'"
-
+        params["dataLancamentoInicio"] = cv.converter_datas(inicio).strftime("%Y-%m-%d")
     if fim:
-        fim_dt = cv.converter_datas(fim)
-        fim_str = fim_dt.strftime("%Y-%m-%d")
-        url += f"&@dataLancamentoFim='{fim_str}'"
-
-    url += "&$format=text/csv"  # Adiciona o formato CSV ao final
-
-    return url
-
-
-@retry_padrao
-def _buscar_csv_api(url: str) -> bytes:
-    """Executa requisição HTTP e retorna o corpo CSV como string.
-
-    Decorado com ``retry_padrao`` para resiliência a falhas transitórias.
-    Levanta exceções de status HTTP para tratamento a montante.
-    """
-    r = requests.get(url, timeout=10)
-    r.raise_for_status()
-    return r.content
-
-
-def _ler_csv(csv_bytes: bytes) -> pl.DataFrame:
-    """Lê o CSV (bytes) em um DataFrame Polars sem inferência de tipos."""
-    return pl.read_csv(
-        csv_bytes,
-        infer_schema=False,
-        null_values=["null", ""],
-    )
+        params["dataLancamentoFim"] = cv.converter_datas(fim).strftime("%Y-%m-%d")
+    return params
 
 
 def _processar_df(df: pl.DataFrame) -> pl.DataFrame:
@@ -80,14 +44,14 @@ def _processar_df(df: pl.DataFrame) -> pl.DataFrame:
         data_liquidacao=pl.col("dataLiquidacao").str.to_date("%Y-%m-%d"),
         data_retorno=pl.col("dataRetorno").str.to_date("%Y-%m-%d"),
         hora_inicio=pl.col("horaInicio").str.to_time("%H:%M"),
-        prazo_dias_corridos=pl.col("prazoDiasCorridos").cast(pl.Int64),
-        prazo_dias_uteis=du.contar_expr("dataLiquidacao", "dataRetorno"),
-        numero_comunicado=pl.col("numeroComunicado").cast(pl.Int64),
+        prazo_dc=pl.col("prazoDiasCorridos").cast(pl.Int64),
+        prazo_du=du.contar_expr("dataLiquidacao", "dataRetorno"),
+        comunicado=pl.col("numeroComunicado").cast(pl.Int64),
         tipo_oferta=pl.col("nomeTipoOferta"),
-        publico_permitido=pl.col("publicoPermitidoLeilao"),
-        volume_aceito=1000 * pl.col("volumeAceito").cast(pl.Int64),
+        publico=pl.col("publicoPermitidoLeilao"),
+        financeiro_aceito=1000 * pl.col("volumeAceito").cast(pl.Float64),
         taxa_corte=pl.when(vol_zero).then(None).otherwise(taxa_br("taxaCorte")),
-        percentual_aceito=pl.when(vol_zero)
+        pct_aceito=pl.when(vol_zero)
         .then(0.0)
         .otherwise(100 - float_br("percentualCorte")),
     ).sort("data_leilao", "hora_inicio", "tipo_oferta")
@@ -117,36 +81,41 @@ def compromissadas(
         - data_liquidacao (Date): data de liquidação (início da operação).
         - data_retorno (Date): data de recompra / término da operação.
         - hora_inicio (Time): horário de início do leilão.
-        - prazo_dias_corridos (Int64): dias corridos até a data de retorno.
-                - prazo_dias_uteis (Int64): dias úteis entre liquidação e retorno
-                    (du.contar).
-        - numero_comunicado (Int64): número do comunicado/aviso do BC (pode ser nulo).
+        - prazo_dc (Int64): dias corridos até a data de retorno.
+        - prazo_du (Int64): dias úteis entre liquidação e retorno.
+        - comunicado (Int64): número do comunicado/aviso do BC (pode ser nulo).
         - tipo_oferta (String): classif. do tipo de oferta (ex: Tomador, Compromissada 1047).
-        - publico_permitido (String): escopo de participantes (SomenteDealer, TodoMercado).
-        - volume_aceito (Int64): volume aceito no leilão em reais (convertido de milhares).
-        - taxa_corte (Float64): taxa de corte (ex. 0.1490 = 14,90%). Nula se volume_aceito = 0.
-        - percentual_aceito (Float64): percentual do volume ofertado efetivamente aceito (0-100).
+        - publico (String): público permitido no leilão (SomenteDealer, TodoMercado).
+        - financeiro_aceito (Float64): financeiro aceito no leilão em reais (convertido de milhares).
+        - taxa_corte (Float64): taxa de corte (ex. 0.1490 = 14,90%). Nula se financeiro_aceito = 0.
+        - pct_aceito (Float64): percentual do volume ofertado efetivamente aceito (0-100).
           100 = nenhuma rejeição. 0 indica nada aceito (volume_aceito = 0).
 
     Notes:
         - Dados ordenados por: data_leilao, hora_inicio, tipo_oferta.
 
     Examples:
+        >>> import polars as pl
+        >>> _ = pl.Config.set_tbl_width_chars(210)
+        >>> _ = pl.Config.set_tbl_cols(-1)
         >>> from pyield import bc
         >>> bc.compromissadas(inicio="21-08-2025", fim="21-08-2025")
         shape: (2, 12)
-        ┌─────────────┬─────────────────┬──────────────┬─────────────┬───┬───────────────────┬───────────────┬────────────┬───────────────────┐
-        │ data_leilao ┆ data_liquidacao ┆ data_retorno ┆ hora_inicio ┆ … ┆ publico_permitido ┆ volume_aceito ┆ taxa_corte ┆ percentual_aceito │
-        │ ---         ┆ ---             ┆ ---          ┆ ---         ┆   ┆ ---               ┆ ---           ┆ ---        ┆ ---               │
-        │ date        ┆ date            ┆ date         ┆ time        ┆   ┆ str               ┆ i64           ┆ f64        ┆ f64               │
-        ╞═════════════╪═════════════════╪══════════════╪═════════════╪═══╪═══════════════════╪═══════════════╪════════════╪═══════════════════╡
-        │ 2025-08-21  ┆ 2025-08-21      ┆ 2025-08-22   ┆ 09:00:00    ┆ … ┆ SomenteDealer     ┆ 647707406000  ┆ 0.149      ┆ 100.0             │
-        │ 2025-08-21  ┆ 2025-08-22      ┆ 2025-11-21   ┆ 12:00:00    ┆ … ┆ TodoMercado       ┆ 5000000000    ┆ 0.9978     ┆ 35.87             │
-        └─────────────┴─────────────────┴──────────────┴─────────────┴───┴───────────────────┴───────────────┴────────────┴───────────────────┘
+        ┌─────────────┬─────────────────┬──────────────┬─────────────┬──────────┬──────────┬────────────┬────────────────────┬───────────────┬───────────────────┬────────────┬────────────┐
+        │ data_leilao ┆ data_liquidacao ┆ data_retorno ┆ hora_inicio ┆ prazo_dc ┆ prazo_du ┆ comunicado ┆ tipo_oferta        ┆ publico       ┆ financeiro_aceito ┆ taxa_corte ┆ pct_aceito │
+        │ ---         ┆ ---             ┆ ---          ┆ ---         ┆ ---      ┆ ---      ┆ ---        ┆ ---                ┆ ---           ┆ ---               ┆ ---        ┆ ---        │
+        │ date        ┆ date            ┆ date         ┆ time        ┆ i64      ┆ i64      ┆ i64        ┆ str                ┆ str           ┆ f64               ┆ f64        ┆ f64        │
+        ╞═════════════╪═════════════════╪══════════════╪═════════════╪══════════╪══════════╪════════════╪════════════════════╪═══════════════╪═══════════════════╪════════════╪════════════╡
+        │ 2025-08-21  ┆ 2025-08-21      ┆ 2025-08-22   ┆ 09:00:00    ┆ 1        ┆ 1        ┆ null       ┆ Tomador            ┆ SomenteDealer ┆ 6.4771e11         ┆ 0.149      ┆ 100.0      │
+        │ 2025-08-21  ┆ 2025-08-22      ┆ 2025-11-21   ┆ 12:00:00    ┆ 91       ┆ 64       ┆ 43716      ┆ Compromissada 1047 ┆ TodoMercado   ┆ 5.0000e9          ┆ 0.9978     ┆ 35.87      │
+        └─────────────┴─────────────────┴──────────────┴─────────────┴──────────┴──────────┴────────────┴────────────────────┴───────────────┴───────────────────┴────────────┴────────────┘
+        >>> _ = pl.Config.restore_defaults()
+        >>> _ = pl.Config.set_tbl_width_chars(150)
     """
-    url = _montar_url(inicio=inicio, fim=fim)
-    csv_api = _buscar_csv_api(url)
-    df = _ler_csv(csv_api)
+    params = _montar_parametros(inicio, fim)
+    url = montar_url(URL_BASE_API, params)
+    dados = buscar_csv(url)
+    df = parsear_csv(dados)
     if df.is_empty():
         return pl.DataFrame()
     return _processar_df(df)

{pyield-0.48.6 → pyield-0.48.7}/pyield/bc/leiloes.py

@@ -12,13 +12,12 @@ from typing import Literal
 
 import polars as pl
 import polars.selectors as cs
-import requests
 
 import pyield._internal.converters as cv
 from pyield import du
 from pyield._internal.br_numbers import float_br, taxa_br
-from pyield._internal.retry import retry_padrao
 from pyield._internal.types import DateLike
+from pyield.bc._olinda import buscar_csv, montar_url, parsear_csv
 from pyield.bc.sgs import ptax_serie
 from pyield.tn.ntnb import duration as duration_b
 from pyield.tn.ntnf import duration as duration_f
@@ -74,39 +73,17 @@ CHAVES_ORDENACAO = ["data_leilao", "tipo_leilao", "titulo", "data_vencimento"]
 URL_BASE_API = "https://olinda.bcb.gov.br/olinda/servico/leiloes_selic/versao/v1/odata/leiloesTitulosPublicos(dataMovimentoInicio=@dataMovimentoInicio,dataMovimentoFim=@dataMovimentoFim,dataLiquidacao=@dataLiquidacao,codigoTitulo=@codigoTitulo,dataVencimento=@dataVencimento,edital=@edital,tipoPublico=@tipoPublico,tipoOferta=@tipoOferta)?"
 
 
-MAPA_TIPO_LEILAO = {"venda": "Venda", "compra": "Compra"}
-
-
-def _montar_url(
+def _montar_parametros(
     inicio: DateLike | None = None,
     fim: DateLike | None = None,
-    tipo_leilao: Literal["venda", "compra"] | None = None,
-) -> str:
-    url = URL_BASE_API
+) -> dict[str, str]:
+    """Converte parâmetros opcionais de período em dicionário para a URL."""
+    params: dict[str, str] = {}
     if inicio:
-        inicio = cv.converter_datas(inicio)
-        url += f"@dataMovimentoInicio='{inicio:%Y-%m-%d}'"
+        params["dataMovimentoInicio"] = cv.converter_datas(inicio).strftime("%Y-%m-%d")
     if fim:
-        fim = cv.converter_datas(fim)
-        url += f"&@dataMovimentoFim='{fim:%Y-%m-%d}'"
-    if tipo_leilao:
-        url += f"&@tipoOferta='{MAPA_TIPO_LEILAO[tipo_leilao.lower()]}'"
-    url += "&$format=text/csv"
-    return url
-
-
-@retry_padrao
-def _buscar_csv(url: str) -> bytes:
-    resposta = requests.get(url, timeout=10)
-    resposta.raise_for_status()
-    return resposta.content
-
-
-def _parsear_df(dados: bytes) -> pl.DataFrame:
-    """Lê CSV como strings."""
-    if not dados.strip():
-        return pl.DataFrame()
-    return pl.read_csv(dados, infer_schema=False, null_values=["null"])
+        params["dataMovimentoFim"] = cv.converter_datas(fim).strftime("%Y-%m-%d")
+    return params
 
 
 def _processar_df(df: pl.DataFrame) -> pl.DataFrame:
@@ -147,9 +124,7 @@ def _processar_df(df: pl.DataFrame) -> pl.DataFrame:
             pu_corte=float_br("cotacaoCorte"),
             taxa_media=taxa_br("taxaMedia"),
             taxa_corte=taxa_br("taxaCorte"),
-            financeiro_total=(float_br("financeiro") * 1_000_000)
-            .round(0)
-            .cast(pl.Int64),
+            financeiro_total=float_br("financeiro") * 1_000_000,
             quantidade_ofertada_1v=pl.col("quantidadeOfertada").cast(pl.Int64),
             quantidade_aceita_1v=pl.col("quantidadeAceita").cast(pl.Int64),
             quantidade_liquidada_1v=pl.col("quantidadeLiquidada").cast(pl.Int64),
@@ -182,9 +157,7 @@ def _processar_df(df: pl.DataFrame) -> pl.DataFrame:
                 (pl.col("quantidade_aceita_1v") / pl.col("quantidade_aceita_total"))
                 * pl.col("financeiro_total")
             )
-            .otherwise(0)
-            .round(0)
-            .cast(pl.Int64),
+            .otherwise(0.0),
         )
         .with_columns(
             financeiro_2v=pl.col("financeiro_total") - pl.col("financeiro_1v"),
@@ -319,9 +292,9 @@ def leiloes(
         * quantidade_aceita_1v (Int64): qtd aceita 1ª volta.
         * quantidade_aceita_2v (Int64): qtd aceita 2ª volta.
         * quantidade_aceita_total (Int64): qtd total aceita.
-        * financeiro_1v (Int64): financeiro 1ª volta em R$.
-        * financeiro_2v (Int64): financeiro 2ª volta em R$.
-        * financeiro_total (Int64): financeiro total em R$.
+        * financeiro_1v (Float64): financeiro 1ª volta em R$.
+        * financeiro_2v (Float64): financeiro 2ª volta em R$.
+        * financeiro_total (Float64): financeiro total em R$.
 
     Notes:
         1v = primeira volta (rodada), 2v = segunda volta.
@@ -333,24 +306,23 @@ def leiloes(
         ┌─────────────┬─────────────────┬─────────────┬───────────────┬───┬─────────────────────────┬───────────────┬───────────────┬──────────────────┐
         │ data_leilao ┆ data_liquidacao ┆ tipo_leilao ┆ numero_edital ┆ … ┆ quantidade_aceita_total ┆ financeiro_1v ┆ financeiro_2v ┆ financeiro_total │
         │ ---         ┆ ---             ┆ ---         ┆ ---           ┆   ┆ ---                     ┆ ---           ┆ ---           ┆ ---              │
-        │ date        ┆ date            ┆ str         ┆ i64           ┆   ┆ i64                     ┆ i64           ┆ i64           ┆ i64              │
+        │ date        ┆ date            ┆ str         ┆ i64           ┆   ┆ i64                     ┆ f64           ┆ f64           ┆ f64              │
         ╞═════════════╪═════════════════╪═════════════╪═══════════════╪═══╪═════════════════════════╪═══════════════╪═══════════════╪══════════════════╡
-        │ 2025-08-19  ┆ 2025-08-20      ┆ Venda       ┆ 192           ┆ … ┆ 150000                  ┆ 2572400000    ┆ 0             ┆ 2572400000       │
-        │ 2025-08-19  ┆ 2025-08-20      ┆ Venda       ┆ 192           ┆ … ┆ 751003                  ┆ 12804476147   ┆ 17123853      ┆ 12821600000      │
-        │ 2025-08-19  ┆ 2025-08-20      ┆ Venda       ┆ 193           ┆ … ┆ 300759                  ┆ 1289936461    ┆ 3263539       ┆ 1293200000       │
-        │ 2025-08-19  ┆ 2025-08-20      ┆ Venda       ┆ 194           ┆ … ┆ 500542                  ┆ 2071654327    ┆ 2245673       ┆ 2073900000       │
-        │ 2025-08-19  ┆ 2025-08-20      ┆ Venda       ┆ 194           ┆ … ┆ 500000                  ┆ 2010700000    ┆ 0             ┆ 2010700000       │
+        │ 2025-08-19  ┆ 2025-08-20      ┆ Venda       ┆ 192           ┆ … ┆ 150000                  ┆ 2.5724e9      ┆ 0.0           ┆ 2.5724e9         │
+        │ 2025-08-19  ┆ 2025-08-20      ┆ Venda       ┆ 192           ┆ … ┆ 751003                  ┆ 1.2804e10     ┆ 1.7124e7      ┆ 1.2822e10        │
+        │ 2025-08-19  ┆ 2025-08-20      ┆ Venda       ┆ 193           ┆ … ┆ 300759                  ┆ 1.2899e9      ┆ 3.2635e6      ┆ 1.2932e9         │
+        │ 2025-08-19  ┆ 2025-08-20      ┆ Venda       ┆ 194           ┆ … ┆ 500542                  ┆ 2.0717e9      ┆ 2.2457e6      ┆ 2.0739e9         │
+        │ 2025-08-19  ┆ 2025-08-20      ┆ Venda       ┆ 194           ┆ … ┆ 500000                  ┆ 2.0107e9      ┆ 0.0           ┆ 2.0107e9         │
         └─────────────┴─────────────────┴─────────────┴───────────────┴───┴─────────────────────────┴───────────────┴───────────────┴──────────────────┘
     """
-    url = _montar_url(
-        inicio=inicio,
-        fim=fim,
-        tipo_leilao=tipo_leilao,
-    )
-    dados = _buscar_csv(url)
-    df = _parsear_df(dados)
+    url = montar_url(URL_BASE_API, _montar_parametros(inicio, fim))
+    dados = buscar_csv(url)
+    df = parsear_csv(dados)
     if df.is_empty():
         return pl.DataFrame()
     df = _processar_df(df)
     df = _adicionar_dv01_usd(df)
-    return df.select(ORDEM_COLUNAS_FINAL).sort(CHAVES_ORDENACAO)
+    df = df.select(ORDEM_COLUNAS_FINAL).sort(CHAVES_ORDENACAO)
+    if tipo_leilao:
+        df = df.filter(pl.col("tipo_leilao").str.to_lowercase() == tipo_leilao.lower())
+    return df

{pyield-0.48.6 → pyield-0.48.7}/pyield/bc/sgs.py

@@ -59,7 +59,7 @@ class SerieSGS(Enum):
 @ttl_cache()
 @retry_padrao
 def _chamar_api(url_api: str) -> list[dict[str, str]]:
-    resposta = requests.get(url_api, timeout=10)
+    resposta = requests.get(url_api, timeout=30)
     resposta.raise_for_status()
     return resposta.json()
 

pyield-0.48.6/pyield/__about__.py

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