bcv

Crates.iobcv
lib.rsbcv
version0.1.4
created_at2025-03-16 02:21:56.046689+00
updated_at2025-07-27 16:31:52.044531+00
descriptionA Command line tool to fetch the BCV exchange rates for the Bolivar
homepage
repositoryhttps://github.com/S14vcGt/bcv_scraper
max_upload_size
id1594057
size64,387
Sebastián Mata (S14vcGt)

documentation

README

🔄 Conversor de Tasa de Cambio del Bolívar (CLI) 💻

Este proyecto es una interfaz de línea de comandos (CLI) 🖥️ escrita en Rust 🦀 que utiliza técnicas de web scraping 🕸️ para obtener la tasa de cambio oficial del Bolívar venezolano (VES) a diferentes monedas 💵, según lo publicado por el Banco Central de Venezuela (BCV) 🏦.


📋 Tabla de Contenidos

  1. Descripción 📝
  2. Instalación 🚀
  3. Uso ⚙️
  4. Ejemplo de Salida 📊

Descripción 📝

El programa consulta la página web oficial del Banco Central de Venezuela (BCV) para obtener la información más reciente sobre las tasas de cambio del Bolívar a otras monedas. Utiliza web scraping 🕷️ para extraer los datos relevantes y mostrarlos en un formato legible directamente desde la terminal 📋.

🔗 URL del sitio web del BCV: https://www.bcv.org.ve/

🔗 URL del paquete en crates.io: https://crates.io/crates/bcv


Instalación 🚀

Puedes descargar el paquete de Cargo con el siguiente comando:


cargo install bcv

o si quieres compilarlo localmente, puedes seguir los pasos siguientes:

  1. Clona este repositorio en tu máquina local 🖥️:

   ```bash

   git clone https://github.com/S14vcGt/bcv_scraper.git

   cd bcv_scraper

   ```

  1. Compila el proyecto con Cargo 🏗️:

   ```bash

   cargo build --release

   ```

  1. El archivo ejecutable estará disponible en la carpeta target/release. Puedes moverlo a un directorio incluido en tu variable de entorno PATH para facilitar su uso 📂:

   ```bash

   mv target/release/bcv_scraper/usr/local/bin/

   ```


Uso ⚙️

Una vez instalado, puedes usar el programa ejecutando el siguiente comando 🔧:


bcv

Ademas, puedes configurar la salida esperada usando diferente banderas:

Bandera Uso
--eur Muestra la tasa en euros (EUR)
--cny Muestra la tasa en yuanes chinos (CNY)
--tl Muestra la tasa en liras turcas (TRY)
--rub Muestra la tasa en rublos rusos (RUB)
--usd Muestra la tasa en dólares estadounidenses (USD)
-h, --help Muestra ayuda sobre como usar la herramienta

El programa mostrará automáticamente las tasas de cambio disponibles para el Bolívar venezolano según el BCV 📈.

Ejemplo de Salida 📊

Al ejecutar el programa, verás una salida similar a esta 🖥️:


EUR         143.40314600

CNY         17.04523258

TRY         3.01281624

RUB         1.53989651

USD         122.17000000

Lunes, 28 Julio  2025

Commit count: 14

cargo fmt