Metadata-Version: 2.4
Name: monetary-correction
Version: 0.1.0
Summary: A simple, robust Python library to deflate nominal Brazilian Reais using official price indexes from the Brazilian Central Bank's SGS (Sistema Gerenciador de Séries Temporais) API.
Author-email: Alexsander Lopes Camargos <alexcamargos@gmail.com>
License: MIT
Project-URL: Repository, https://github.com/alexcamargos/monetary-correction
Project-URL: Issues, https://github.com/alexcamargos/monetary-correction/issues
Keywords: finance,economics,inflation,brazil,bcb,sgs,ipca,igp-m,inpc,monetary-correction,deflation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Portuguese (Brazilian)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: grab-harvester>=0.0.1
Requires-Dist: polars>=0.20.0
Requires-Dist: requests>=2.31.0
Requires-Dist: typer>=0.9.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: pre-commit>=3.5.0; extra == "dev"
Dynamic: license-file

# Monetary Correction

> Uma biblioteca Python simples e robusta para atualização e correção monetária de valores em Reais (R$) utilizando índices de preços oficiais da API do SGS (Sistema Gerenciador de Séries Temporais) do Banco Central do Brasil.

[![LinkedIn](https://img.shields.io/badge/%40alexcamargos-230A66C2?style=social&logo=LinkedIn&label=LinkedIn&color=white)](https://www.linkedin.com/in/alexcamargos)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Python Version](https://img.shields.io/badge/Python-3.13%2B-blue.svg)](https://www.python.org/downloads/)


## Sobre o Projeto

**Monetary Correction** é uma ferramenta robusta para a atualização de valores monetários, conectando-se diretamente ao SGS do Banco Central do Brasil para obter dados oficiais. Com suporte aos índices IPCA, IGP-M, IGP-DI, IPC-FGV e INPC, o projeto aplica a metodologia de indexação do "mês anterior", assegurando que os cálculos de correção estejam em total conformidade com as práticas contratuais e econômicas vigentes no país.

Construída sobre uma stack moderna que inclui `polars` e `type hints` para máxima confiabilidade, a ferramenta é gerenciada via `uv` e oferece versatilidade de uso. Ela disponibiliza tanto uma API Python para integração fluida em aplicações de software quanto uma Interface de Linha de Comando (CLI), permitindo que desenvolvedores e analistas realizem correções monetárias de forma ágil e precisa.


## Autor

Feito com ❤️ por [Alexsander Lopes Camargos](https://github.com/alexcamargos) 👋 Entre em contato!

[![GitHub](https://img.shields.io/badge/-AlexCamargos-1ca0f1?style=flat-square&labelColor=1ca0f1&logo=github&logoColor=white&link=https://github.com/alexcamargos)](https://github.com/alexcamargos)
[![Twitter Badge](https://img.shields.io/badge/-@alcamargos-1ca0f1?style=flat-square&labelColor=1ca0f1&logo=twitter&logoColor=white&link=https://twitter.com/alcamargos)](https://twitter.com/alcamargos)
[![Linkedin Badge](https://img.shields.io/badge/-alexcamargos-1ca0f1?style=flat-square&logo=Linkedin&logoColor=white&link=https://www.linkedin.com/in/alexcamargos/)](https://www.linkedin.com/in/alexcamargos/)
[![Gmail Badge](https://img.shields.io/badge/-alcamargos@vivaldi.net-1ca0f1?style=flat-square&labelColor=1ca0f1&logo=Gmail&logoColor=white&link=mailto:alcamargos@vivaldi.net)](mailto:alcamargos@vivaldi.net)

## Licença
Este projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.
