Metadata-Version: 2.1
Name: pyBCV
Version: 1.0.8
Summary: PyBCV es una librería desarrollada en el lenguaje de programación Python que se utiliza para recopilar los precios de los tipos de cambio y las tasas informativas proporcionados por el Banco Central de Venezuela (BCV).
Home-page: https://github.com/fcoagz/pyBCV
Author: Francisco Griman
Author-email: Francisco Griman <grihardware@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/fcoagz/pyBCV
Project-URL: Bug Tracker, https://github.com/fcoagz/pyBCV/issues
Keywords: bcv,analysis,precios,tasascambio,divisas,pybcv,venezuela
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: bs4
Requires-Dist: beautifulsoup4

 <p align="center">
 <img width="300" height="170" src="pyBCV/pybcv-preview.png">
</p>

# pyBCV
pyBCV es una librería de Python que simplifica la obtención de los precios de los tipos de cambio y las tasas informativas del sistema bancario proporcionados por el Banco Central de Venezuela (BCV) convirtiéndolos en un formato fácilmente utilizable en Python.

## Instalación
Para instalar esta librería, puedes utilizar el siguiente comando:
```py
pip install pyBCV
```
Para actualizar esta librería, puedes utilizar el siguiente comando:
```py
pip install pyBCV --upgrade
```
## Uso
La librería pyBCV proporciona dos clases, `Currency` y `Bank`, para obtener tasas de cambio e informativas de bancos del Banco Central de Venezuela.

La clase `Currency` obtiene tasas de cambio para varias monedas y las devuelve en formato de diccionario. También proporciona métodos para obtener una tasa de cambio específica o la hora de la última actualización.
```py
import pyBCV

currency = pyBCV.Currency()
all_rates = currency.get_rate() # obtener todas las tasas de cambio de moneda
usd_rate = currency.get_rate(currency_code='USD', prettify=False) # obtener la tasa de cambio del dólar estadounidense sin símbolo de moneda
last_update = currency.get_rate(currency_code='Fecha') # obtener la hora de la última actualización
```

La clase `Bank` obtiene tasas informativas proporcionadas por varios bancos en Venezuela y las devuelve en formato de diccionario. Proporciona métodos para obtener información sobre un banco específico o todos los bancos disponibles.
```py
import pyBCV

bcv = pyBCV.Bank()
bank_info = bcv.get_by_bank() # obtener todas las tasas de cambio informativas de los bancos disponibles
bnc_buy_rate = bcv.get_by_bank(bank_code='Banco Nacional de Crédito', rate_or_sale='Compra') # obtener la tasa de compra del Banco Nacional de Crédito
```
## Colaboradores

| [<img src="https://avatars.githubusercontent.com/u/103836660?v=4" width=115><br><sub>Francisco Griman</sub>](https://github.com/fcoagz) |  [<img src="https://avatars.githubusercontent.com/u/12820150?v=4" width=115><br><sub>Jesús Alfredo Reyes Vargas</sub>](https://github.com/jesusareyesv) |
| :---: | :---: |
## Propósito de pyBCV
Esta librería está diseñada específicamente para recopilar y convertir estos datos en un formato fácilmente utilizable en Python, lo que permite a los desarrolladores acceder a ellos y utilizarlos en sus aplicaciones con facilidad. Con pyBCV, los usuarios pueden obtener información actualizada sobre las tasas de cambio y las tasas informativas de los bancos de manera rápida y sencilla, haciendo que el proceso de obtener estos datos sea más eficiente y conveniente.
