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.