Metadata-Version: 2.1
Name: pyBCV
Version: 1.0.2
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 desarrollada en el lenguaje de programación Python que se utiliza para recopilar los precios de los tipos de cambio y la tasas informativas del sistema bancario proporcionados por el Banco Central de Venezuela (BCV). Esta librería se centra específicamente en la obtención de los datos de tipos de cambio y las tasas informativas del BCV y los convierte en un formato fácilmente utilizable en Python.

## Instalación
Para instalar esta librería, puedes utilizar el siguiente comando de pip:
```py
pip install pyBCV
```
Si usas un Sistema Operativo como Linux o Mac:
```py
pip3 install pyBCV
```

## Uso
Para obtener información del BCV, creamos una instancia de la clase `Currency` y elegimos el módulo que deseamos utilizar para obtener la información. En pyBCV, los módulos disponibles son:

- get_rate(): Obtiene la tasa de cambio actual de una moneda específica.
- get_by_bank(): Obtiene la fecha vigente y el sistema cambiario de compra y venta de moneda extranjera para un banco específico.

A continuación te digo como se utiliza estos módulos:
### Módulo **get_rate()**
___
El módulo `get_rate()` acepta un código de moneda como argumento y devuelve la tasa de cambio actual de esa moneda.
```py
import pyBCV

bcv = pyBCV.Currency()

tasa_usd = bcv.get_rate('USD')
print(tasa_usd)

>> 'Bs. 24.53'
```
Para obtener una estructura tipo JSON de las monedas disponibles en pyBCV, utilizamos el módulo get_rate() sin argumentos, el cual devuelve un diccionario.
```py
import pyBCV

bcv = pyBCV.Currency()

tasa_de_cambio = bcv.get_rate()
print(tasa_de_cambio)

>> {'EUR': 'Bs. 26.65', 'CNY': 'Bs. 3.57', 'TRY': 'Bs. 1.28', 'RUB': 'Bs. 0.32', 'USD': 'Bs. 24.53'}
```

### Módulo **get_by_bank()**
___
El módulo `get_by_bank()` acepta el nombre de un banco como argumento y devuelve la fecha vigente y el sistema cambiario de compra y venta de moneda extranjera para ese banco.
```py
import pyBCV

bcv = pyBCV.Currency()

banco = bcv.get_by_bank('Bancamiga')
print(banco)

>> {'Fecha': '31-03-2023', 'Compra': 'Bs. 24.50', 'Venta': 'Bs. 24.55'}
``` 
Para acceder a una sola propiedad. El módulo `get_by_bank()` acepta el nombre de un banco como primer argumento y el nombre de una propiedad como segundo argumento (por ejemplo: "Fecha") y devuelve el valor de esa propiedad para el banco especificado.
```py
import pyBCV

bcv = pyBCV.Currency()

banco = bcv.get_by_bank('Bancamiga', 'Fecha')
print(banco)

>> '31-03-2023'
``` 
Si queremos obtener una estructura tipo JSON de los bancos disponibles en pyBCV, utilizamos el módulo `get_by_bank()` sin argumentos.
```py
import pyBCV

bcv = pyBCV.Currency()

bancos = bcv.get_by_bank()
print(bancos)

>> {'Bancamiga': {'Fecha': '31-03-2023', 'Compra': 'Bs. 24.5', 'Venta': 'Bs. 24.55'}, 'Banco Nacional de Crédito BNC': {'Fecha': '31-03-2023', 'Compra': 'Bs. 24.46', 'Venta': 'Bs. 24.64'}, 'BBVA Provincial': {'Fecha': '31-03-2023', 'Compra': 'Bs. 24.33', 'Venta': 'Bs. 24.45'}, 'Banesco': {'Fecha': '31-03-2023', 'Compra': 'Bs. 24.36', 'Venta': 'Bs. 24.54'}, 'Banco Mercantil': {'Fecha': '31-03-2023', 'Compra': 'Bs. 24.41', 'Venta': 'Bs. 24.5'}}
``` 
# Propósito de pyBCV
El objetivo principal de PyBCV es proporcionar una forma fácil y rápida de acceder a los datos de tipos de cambio y tasas informativas del BCV en un formato que sea fácil de usar y manipular en Python. 
