Package for async parsing CB rates
Project description
async-cb-rate
Асинхронная библиотека для парсинга курса валют с сайта ЦБ РФ.
Библиотеку можно использовать для:
- мониторинга за курсом валют
- построения графиков изменения курса
Установка c pip
pip install async-cb-rate
Краткий обзор функциональности
- Библиотека позволяет получить курс валюты на любой день. По умолчанию курс ищется на сегодняшний день.
- Функции возвращают объекты
Currency
, с которыми удобно далее работать.
import asyncio
from async_cb_rate.parser import get_rate, get_codes, get_all_rates
async def main():
usd_rate = await get_rate("USD")
print(f"USD rate for today={usd_rate.price}₽") # USD rate for today=55.2987₽
euro_rate = await get_rate("EUR") # EUR rate for today=52.7379₽
print(f"EUR rate for today={euro_rate.price}₽")
codes = await get_codes()
print(f"Available codes: {codes}") # ['AUD', 'AZN', 'GBP', 'AMD', 'BYN', 'BGN', 'BRL', 'HUF', 'HKD', 'DKK', 'USD',
# 'EUR', 'INR', 'KZT', 'CAD', 'KGS', 'CNY', 'MDL', 'NOK', 'PLN', 'RON', 'XDR', 'SGD', 'TJS', 'TRY', 'TMT', 'UZS',
# 'UAH', 'CZK', 'SEK', 'CHF', 'ZAR', 'KRW', 'JPY']
all_rates = await get_all_rates()
print(f"All rates for today: {all_rates}") # [Currency(name='Австралийский доллар', code='AUD', price=35.9552,
# date=datetime.datetime(2022, 10, 3, 23, 45, 29, 145779)), ...]
asyncio.run(main())
Доступные асинхронные функции библиотеки:
- get_codes(date) - получить все доступные коды валют на определённую дату:
codes = await get_codes() # Коды валют
- get_rate(code, date) - получить курс определённой валюты по её коду на определённую дату:
usd_rate = await get_rate("USD") # Курс доллара на сегодня
- get_all_rates(date) - получить курс всех доступных валют от ЦБ на определённую дату:
all_rates = await get_all_rates() # Все курсы валют на сегодня
! По умолчанию поле date - это сегодня.
Ошибки, которые можно получить при работе с библиотекой:
NoValidDateError
- функция была вызвана с датой, которая ещё не наступила.CurrencyRateNotFoundError
- курс для данного кода валюты не найден.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
async-cb-rate-1.0.0.tar.gz
(3.9 kB
view hashes)
Built Distribution
Close
Hashes for async_cb_rate-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9cdc36aa68d9daf1411b2b185894cbe4b5a81110d0dec5d30e511ab524aee002 |
|
MD5 | dd4d7b0110b617154c187ff336b8f046 |
|
BLAKE2b-256 | a04789ef91cd19df3110faf5e7a542fb4b50e4086894ec7b77381752ea7b05d7 |