dolarhoy

DolarHoy es una librería en Python que facilita la obtención de cotizaciones actualizadas de diferentes tipos de dólar en Argentina, utilizando web scraping para extraer datos del sitio web DolarHoy.


Keywords
python, dolar, dolarhoy, web, scraping, exchange, rates, cotizaciones, dollar, argentina, financial, data, beautifulsoup, requests
License
MIT
Install
pip install dolarhoy==0.0.3

Documentation

Logo

DolarHoy

DolarHoy es una librería en Python que permite obtener las cotizaciones de diferentes tipos de dólar en Argentina desde el sitio web DolarHoy. Utiliza las librerías requests y BeautifulSoup para hacer web scraping y extraer la información relevante.

Instalación

Puedes instalar la librería utilizando pip:

pip install dolarhoy

Uso

Ejemplo Básico

A continuación se muestra un ejemplo básico de cómo utilizar la clase DolarHoy para obtener las cotizaciones del dólar.

from dolarhoy import DolarHoy

# URL del sitio web
dolar_hoy = DolarHoy()

# Obtener todas las cotizaciones
all_data = dolar_hoy.get_all_data()

# Obtener la cotización del dólar blue
blue_price = dolar_hoy.get_blue_price()

# Obtener la cotización del dólar oficial
oficial_price = dolar_hoy.get_oficial_price()

# Obtener un resumen de todas las cotizaciones
summary = dolar_hoy.get_summary()

Clases Enum

TipoDolar

Una enumeración que representa los diferentes tipos de dólares:

  • BLUE: "dolar_blue"
  • OFICIAL: "dolar_oficial"
  • BOLSA: "dolar_bolsa"
  • CONTADO_CON_LIQUI: "contado_con_liqui"
  • TARJETA: "dolar_tarjeta"

TipoOperacion

Una enumeración que representa el tipo de operación:

  • COMPRA: "compra"
  • VENTA: "venta"

Clase DolarHoy

Constructor

__init__(self, url: str = "https://www.dolarhoy.com")

Inicializa una instancia de DolarHoy con la URL especificada. Por defecto, la URL es "https://www.dolarhoy.com".

Métodos Privados

_scrape_data(self)

Extrae los datos de la URL y devuelve un diccionario que contiene las cotizaciones de diferentes tipos de dólares.

_extract_cotizacion(self, soup, href)

Extrae las cotizaciones (compra y venta) para un tipo específico de dólar del objeto BeautifulSoup y la URL proporcionada.

_get_value(self, parent, class_name)

Obtiene el valor de compra o venta del elemento HTML correspondiente.

Métodos Públicos

get_all_data(self) -> dict

Devuelve un diccionario con todas las cotizaciones de los diferentes tipos de dólares.

get_blue_price(self) -> dict

Devuelve un diccionario con la cotización del dólar blue.

get_oficial_price(self) -> dict

Devuelve un diccionario con la cotización del dólar oficial.

get_bolsa_price(self) -> dict

Devuelve un diccionario con la cotización del dólar bolsa.

get_contado_con_liqui_price(self) -> dict

Devuelve un diccionario con la cotización del dólar contado con liqui.

get_tarjeta_price(self) -> dict

Devuelve un diccionario con la cotización del dólar tarjeta.

get_price(self, tipo_dolar: TipoDolar, tipo_operacion: TipoOperacion) -> float

Devuelve el precio de compra o venta para un tipo de dólar y operación específicos.

get_all_prices(self, tipo_operacion: TipoOperacion) -> dict

Devuelve un diccionario con todos los precios de compra o venta para todos los tipos de dólares.

get_summary(self) -> str

Devuelve un resumen en formato de cadena con todas las cotizaciones de los diferentes tipos de dólares, incluyendo los precios de compra y venta, la fuente y la URL de la fuente.

Contribuciones

Si deseas contribuir a este proyecto, por favor sigue los siguientes pasos:

  1. Haz un fork del repositorio.
  2. Crea una nueva rama (git checkout -b feature/nueva-funcionalidad).
  3. Realiza tus cambios y haz commit (git commit -am 'Agrega nueva funcionalidad').
  4. Sube tus cambios (git push origin feature/nueva-funcionalidad).
  5. Crea un nuevo Pull Request.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

Descargo de Responsabilidad

Esta librería es para fines educativos y no se asume responsabilidad alguna por los usos que se le den. La información utilizada por esta librería proviene del sitio DolarHoy.com, un sitio meramente informativo que no brinda consejo, recomendación, asesoramiento o invitación de ningún tipo para realizar actos y/u operaciones de cualquier clase.

Las fuentes de información citadas son de acceso público y los datos mostrados son elaborados sobre la base de dicha información. No se garantiza la precisión, veracidad, exactitud, integridad o vigencia de los datos.

El uso de la información proporcionada es responsabilidad exclusiva del usuario y no se asume responsabilidad por eventuales daños o perjuicios derivados de decisiones basadas en los datos obtenidos. Esta librería no mantiene acuerdos, asociaciones, alianzas o vínculos con los anunciantes de DolarHoy.com y no se responsabiliza por los contenidos de las piezas publicitarias o banners en dicho sitio.