| Name | pyDolarVenezuela JSON |
| Version |
1.5.8
JSON |
| download |
| home_page | https://github.com/fcoagz/pydolarvenezuela |
| Summary | Esta librería en Python consulta los precios del dólar y/o euro en diversos monitores en Venezuela, además de la tasa de cambio oficial BCV. |
| upload_time | 2024-05-20 18:43:43 |
| maintainer | None |
| docs_url | None |
| author | Francisco Griman |
| requires_python | >=3.9 |
| license | MIT License Copyright (c) 2023 Francisco Griman Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
dolarmonitor
dolartoday
enparalelovzla
bcv
venezuela
dolarparalelo
dolarcambio
dolarvenezuela
dolartodayvenezuela
dolaroficial
dolarlibre
dolarinformal
dolarparalelovzla
dolarbcv
dolarenvenezuela
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
pyDolarVenezuela es una librería de Python que te brinda la posibilidad de obtener los valores del dólar en distintos monitores en Venezuela, así como las tasas de cambio proporcionadas por el Banco Central de Venezuela. Esta librería consulta diversas páginas web que ofrecen información actualizada sobre el valor del dólar:
| Página Web | URL | Estado
|------------|-------------|-------------|
| Exchange Monitor | https://exchangemonitor.net/dolar-venezuela |  |
| CriptoDolar | https://criptodolar.net/ |  |
| BCV (Banco Central de Venezuela) | http://www.bcv.org.ve/ |  |
| Italcambio | https://www.italcambio.com/ |  |
pyDolarVenezuela tiene como objetivo principal brindar una solución eficiente y confiable para acceder a información relevante sobre el valor del dólar en Venezuela, ofreciendo así una herramienta valiosa para desarrolladores interesados en trabajar en este ámbito.
## Instalación
``` sh
pip install pyDolarVenezuela
```
## Uso
Debes importar el módulo `pages`, donde encontrarás una variedad de atributos que contienen información sobre una página específica de la que deseas obtener los datos. Adicionalmente deberás importar la clase `Monitor`, cuyos parámetros será la página que deseas utilizar y la moneda en la que se expresarán los precios (`USD`, `EUR`).
```python
from pyDolarVenezuela.pages import BCV, CriptoDolar, ExchangeMonitor, Italcambio
from pyDolarVenezuela import Monitor
monitor = Monitor(ExchangeMonitor, 'USD')
```
pyDolarVenezuela utiliza [Redis](https://github.com/redis/redis-py), un motor de base de datos en memoria, para almacenar y procesar datos. Esto nos ayuda para calcular el cambio, el porcentaje, el color y el símbolo, y se devuelven los datos actualizados.
```python
from pyDolarVenezuela.pages import BCV, CriptoDolar, ExchangeMonitor, Italcambio
from pyDolarVenezuela import Monitor, Redis
# Defecto
db = Redis(
host='localhost',
port=6379
)
monitor = Monitor(CriptoDolar, 'USD', db=db)
```
Si prefieres utilizar [Redis Cloud](https://app.redislabs.com/) en lugar de una instancia local de `Redis`, puedes hacerlo cambiando el host y el puerto cuando creas la instancia de `Redis`.
```python
db = Redis(
host='redis-cloud-host',
port='redis-cloud-port',
password='*************'
)
```
```
Aunque Redis puede funcionar en Windows, no es una versión oficial. Para un entorno de producción estable, se recomienda instalar Redis en Linux o utilizar Redis Cloud.
```
El parámetro `currency` de la clase `Monitor` por defecto tiene el valor: `USD`, verifique que la página de la que desea obtener los datos pueda expresar precios en `EUR`.
```python
print(ExchangeMonitor.currencies)
>> ['usd', 'eur']
```
El método `get_value_monitors` se utiliza después de crear una instancia del objeto Monitor y permite el acceso a los datos almacenados en el diccionario. Los siguientes parámetros serían los siguientes:
- `monitor_code`: El código del monitor del cual se desea obtener información. Por defecto es `None`.
- `name_property`: El nombre de la propiedad específica del diccionario de la información del monitor extraído que se desea obtener. Por defecto es `None`.
- `prettify`: Muestra los precios en formato de moneda con el símbolo de Bolívares. Por defecto es `False`.
```python
from pyDolarVenezuela.pages import BCV, CriptoDolar, ExchangeMonitor, Italcambio
from pyDolarVenezuela import Monitor
monitor = Monitor(ExchangeMonitor, 'USD')
# Obtener los valores de todos los monitores
valores_dolar = monitor.get_value_monitors()
# Obtener el valor del dólar en EnParaleloVzla
valor_dolar = monitor.get_value_monitors("enparalelovzla", "price", prettify=True)
print(valor_dolar)
```
La función `currency_converter` convierte una cantidad de dinero de una moneda a otra utilizando los datos de un monitor específico.
```python
from pyDolarVenezuela.pages import BCV, CriptoDolar, ExchangeMonitor, Italcambio
from pyDolarVenezuela import Monitor
from pyDolarVenezuela import currency_converter
monitor = Monitor(ExchangeMonitor, 'USD')
information_dolar = monitor.get_value_monitors("enparalelovzla")
price_in_dolares = currency_converter(
type='VES', # VES | USD | EUR
value=1000, # Bs. 1000
monitor=information_dolar # Datos del dolar
)
print(price_in_dolares) # Imprime algo como 28.22466836014677
```
Raw data
{
"_id": null,
"home_page": "https://github.com/fcoagz/pydolarvenezuela",
"name": "pyDolarVenezuela",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "dolarmonitor, dolartoday, enparalelovzla, bcv, venezuela, dolarparalelo, dolarcambio, dolarvenezuela, dolartodayvenezuela, dolaroficial, dolarlibre, dolarinformal, dolarparalelovzla, dolarbcv, dolarenvenezuela",
"author": "Francisco Griman",
"author_email": "Francisco Griman <grihardware@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/f0/04/d0fce85c1f612899930b42f9d3dc3007b0b40c4478ce2b3ca39f0909b868/pydolarvenezuela-1.5.8.tar.gz",
"platform": null,
"description": "\r\n\r\npyDolarVenezuela es una librer\u00eda de Python que te brinda la posibilidad de obtener los valores del d\u00f3lar en distintos monitores en Venezuela, as\u00ed como las tasas de cambio proporcionadas por el Banco Central de Venezuela. Esta librer\u00eda consulta diversas p\u00e1ginas web que ofrecen informaci\u00f3n actualizada sobre el valor del d\u00f3lar:\r\n\r\n| P\u00e1gina Web | URL | Estado\r\n|------------|-------------|-------------|\r\n| Exchange Monitor | https://exchangemonitor.net/dolar-venezuela |  |\r\n| CriptoDolar | https://criptodolar.net/ |  |\r\n| BCV (Banco Central de Venezuela) | http://www.bcv.org.ve/ |  |\r\n| Italcambio | https://www.italcambio.com/ |  |\r\n\r\npyDolarVenezuela tiene como objetivo principal brindar una soluci\u00f3n eficiente y confiable para acceder a informaci\u00f3n relevante sobre el valor del d\u00f3lar en Venezuela, ofreciendo as\u00ed una herramienta valiosa para desarrolladores interesados en trabajar en este \u00e1mbito.\r\n\r\n## Instalaci\u00f3n\r\n``` sh\r\npip install pyDolarVenezuela\r\n```\r\n\r\n## Uso\r\nDebes importar el m\u00f3dulo `pages`, donde encontrar\u00e1s una variedad de atributos que contienen informaci\u00f3n sobre una p\u00e1gina espec\u00edfica de la que deseas obtener los datos. Adicionalmente deber\u00e1s importar la clase `Monitor`, cuyos par\u00e1metros ser\u00e1 la p\u00e1gina que deseas utilizar y la moneda en la que se expresar\u00e1n los precios (`USD`, `EUR`).\r\n\r\n```python\r\nfrom pyDolarVenezuela.pages import BCV, CriptoDolar, ExchangeMonitor, Italcambio\r\nfrom pyDolarVenezuela import Monitor\r\n\r\nmonitor = Monitor(ExchangeMonitor, 'USD')\r\n```\r\n\r\npyDolarVenezuela utiliza [Redis](https://github.com/redis/redis-py), un motor de base de datos en memoria, para almacenar y procesar datos. Esto nos ayuda para calcular el cambio, el porcentaje, el color y el s\u00edmbolo, y se devuelven los datos actualizados.\r\n\r\n```python\r\nfrom pyDolarVenezuela.pages import BCV, CriptoDolar, ExchangeMonitor, Italcambio\r\nfrom pyDolarVenezuela import Monitor, Redis\r\n\r\n# Defecto\r\ndb = Redis(\r\n host='localhost',\r\n port=6379\r\n)\r\n\r\nmonitor = Monitor(CriptoDolar, 'USD', db=db)\r\n\r\n```\r\nSi prefieres utilizar [Redis Cloud](https://app.redislabs.com/) en lugar de una instancia local de `Redis`, puedes hacerlo cambiando el host y el puerto cuando creas la instancia de `Redis`.\r\n\r\n```python\r\ndb = Redis(\r\n host='redis-cloud-host',\r\n port='redis-cloud-port',\r\n password='*************'\r\n)\r\n```\r\n\r\n```\r\nAunque Redis puede funcionar en Windows, no es una versi\u00f3n oficial. Para un entorno de producci\u00f3n estable, se recomienda instalar Redis en Linux o utilizar Redis Cloud.\r\n```\r\n\r\n\r\nEl par\u00e1metro `currency` de la clase `Monitor` por defecto tiene el valor: `USD`, verifique que la p\u00e1gina de la que desea obtener los datos pueda expresar precios en `EUR`.\r\n\r\n```python\r\nprint(ExchangeMonitor.currencies)\r\n\r\n>> ['usd', 'eur']\r\n```\r\n\r\nEl m\u00e9todo `get_value_monitors` se utiliza despu\u00e9s de crear una instancia del objeto Monitor y permite el acceso a los datos almacenados en el diccionario. Los siguientes par\u00e1metros ser\u00edan los siguientes:\r\n\r\n- `monitor_code`: El c\u00f3digo del monitor del cual se desea obtener informaci\u00f3n. Por defecto es `None`.\r\n- `name_property`: El nombre de la propiedad espec\u00edfica del diccionario de la informaci\u00f3n del monitor extra\u00eddo que se desea obtener. Por defecto es `None`.\r\n- `prettify`: Muestra los precios en formato de moneda con el s\u00edmbolo de Bol\u00edvares. Por defecto es `False`.\r\n\r\n```python\r\nfrom pyDolarVenezuela.pages import BCV, CriptoDolar, ExchangeMonitor, Italcambio\r\nfrom pyDolarVenezuela import Monitor\r\n\r\nmonitor = Monitor(ExchangeMonitor, 'USD')\r\n\r\n# Obtener los valores de todos los monitores\r\nvalores_dolar = monitor.get_value_monitors()\r\n\r\n# Obtener el valor del d\u00f3lar en EnParaleloVzla\r\nvalor_dolar = monitor.get_value_monitors(\"enparalelovzla\", \"price\", prettify=True)\r\n\r\nprint(valor_dolar)\r\n```\r\n\r\nLa funci\u00f3n `currency_converter` convierte una cantidad de dinero de una moneda a otra utilizando los datos de un monitor espec\u00edfico.\r\n\r\n```python\r\nfrom pyDolarVenezuela.pages import BCV, CriptoDolar, ExchangeMonitor, Italcambio\r\nfrom pyDolarVenezuela import Monitor\r\nfrom pyDolarVenezuela import currency_converter\r\n\r\nmonitor = Monitor(ExchangeMonitor, 'USD')\r\n\r\ninformation_dolar = monitor.get_value_monitors(\"enparalelovzla\")\r\nprice_in_dolares = currency_converter(\r\n type='VES', # VES | USD | EUR\r\n value=1000, # Bs. 1000\r\n monitor=information_dolar # Datos del dolar\r\n)\r\n\r\nprint(price_in_dolares) # Imprime algo como 28.22466836014677\r\n```\r\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2023 Francisco Griman Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "Esta librer\u00eda en Python consulta los precios del d\u00f3lar y/o euro en diversos monitores en Venezuela, adem\u00e1s de la tasa de cambio oficial BCV.",
"version": "1.5.8",
"project_urls": {
"Bug Tracker": "https://github.com/fcoagz/pydolarvenezuela/issues",
"Homepage": "https://github.com/fcoagz/pydolarvenezuela"
},
"split_keywords": [
"dolarmonitor",
" dolartoday",
" enparalelovzla",
" bcv",
" venezuela",
" dolarparalelo",
" dolarcambio",
" dolarvenezuela",
" dolartodayvenezuela",
" dolaroficial",
" dolarlibre",
" dolarinformal",
" dolarparalelovzla",
" dolarbcv",
" dolarenvenezuela"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "84f9022f6450abfb5b9e58222590258b01b6088ec9da51280c418029845596d7",
"md5": "d2769e3fc7e99fcb4534460222bb04c7",
"sha256": "c7b144cbf9d0b55ec8d9bc58070603a04854dc26e2c1f4b8c4982929a876319f"
},
"downloads": -1,
"filename": "pyDolarVenezuela-1.5.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d2769e3fc7e99fcb4534460222bb04c7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 19283,
"upload_time": "2024-05-20T18:43:39",
"upload_time_iso_8601": "2024-05-20T18:43:39.790100Z",
"url": "https://files.pythonhosted.org/packages/84/f9/022f6450abfb5b9e58222590258b01b6088ec9da51280c418029845596d7/pyDolarVenezuela-1.5.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f004d0fce85c1f612899930b42f9d3dc3007b0b40c4478ce2b3ca39f0909b868",
"md5": "41a3596c05f955570ce7eb71b3cbe9f2",
"sha256": "876f82b6d0a24e79e806c43efd2f8ff095dce5d7bfe2ae346e527c65b119de80"
},
"downloads": -1,
"filename": "pydolarvenezuela-1.5.8.tar.gz",
"has_sig": false,
"md5_digest": "41a3596c05f955570ce7eb71b3cbe9f2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 17124,
"upload_time": "2024-05-20T18:43:43",
"upload_time_iso_8601": "2024-05-20T18:43:43.432475Z",
"url": "https://files.pythonhosted.org/packages/f0/04/d0fce85c1f612899930b42f9d3dc3007b0b40c4478ce2b3ca39f0909b868/pydolarvenezuela-1.5.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-20 18:43:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fcoagz",
"github_project": "pydolarvenezuela",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pydolarvenezuela"
}
