Pular para conteúdo

Novidades na versão 0.58.0

Nota reconstituída a partir do histórico Git, usando o commit de incremento da versão e o diff desde o incremento anterior. O recorte é definido pelos commits de versão, não por tags de publicação.

As orientações abaixo descrevem a API histórica. Para chegar à API atual, consulte também as notas das versões seguintes no histórico de versões.

Cotações em base 100 e taxas percentuais

As funções escalares de cálculo dos títulos também aceitam taxas percentuais explícitas, como "5.75%" ou "5,75%", equivalentes a 0.0575. Números continuam em formato decimal; strings sem % são rejeitadas.

As funções cotacao de yd.lft, yd.ntnb, yd.ntnc, yd.ntnbp e yd.ntnb1 passam a retornar base 100 com quatro casas decimais: 0.993651 passa a ser 99.3651. As funções pu desses títulos recebem a cotação nessa mesma base e aplicam VNA * cotacao / 100.

A coluna valor_pagamento de fluxos_caixa de NTN-B, NTN-C e NTN-B1 e o retorno de ntnb1.cotacao_curva_zero também passam para base 100. Esta última mantém a soma sem truncamento para calibrar a TIR equivalente.

Para migrar, multiplique cotações e fluxos antigos armazenados por 100, remova multiplicações por 100 usadas apenas para exibir cotações e ajuste cálculos manuais de PU para dividir por 100. A composição pu(vna, cotacao(...)) preserva a unidade e as regras de precisão do preço. Taxas continuam em formato decimal, e VNA e PU continuam em reais.

Migração acumulada desde a 0.56.0

O README dessa versão também preservava o quadro abaixo. Ele reúne alterações do intervalo desde a 0.56.0; não significa que todas foram introduzidas na 0.58.0.

Este resumo parte da API da 0.56.0. Mudanças que já faziam parte dessa versão ou de versões anteriores estão no histórico das releases do GitHub.

Antes Agora
ntnbp.taxas_zero(...) ntnb.taxas_zero(...), sem incluir_vertices
ntnb.taxas_zero(..., incluir_cupons=...) ntnb.taxas_zero(...), sem incluir_cupons
ntnb.taxas_zero(..., percentual=...) ntnb.taxas_zero(...), com taxas em formato decimal
yd.tpf.ntnb yd.ntnb ou from pyield import ntnb
yd.tpf.rmd(aba) yd.rmd(aba) ou from pyield import rmd
pyield.tpf.vna.calcular_vna(...) yd.vna.calcular_vna(...)
yd.ntnb.vna(data) yd.vna.valor("NTN-B", data)
yd.ntnb.vnas() yd.vna.historico("NTN-B")
vna_projetado(...) nos módulos de títulos yd.vna.projetado(titulo, data, vna_base, inflacao)
vigencia(data) nos módulos de títulos yd.vna.vigencia(titulo, data)

O namespace público segue a autonomia semântica do conceito que o usuário precisa conhecer, e não apenas a fonte dos dados ou sua relação temática com outro domínio. Por isso, conceitos como yd.ltn, yd.ntnb, yd.vna e yd.rmd ficam na raiz, enquanto as implementações podem continuar agrupadas internamente por domínio para manter o código coeso. Consulte as releases para o histórico completo.