whiteapfel/raiffather

Raiffeisen bank (RU) client in Python

Raiffather

Враппер апишки Райффайзенбанка из их мобильного приложения

Введение

Предоставляется как есть, as is, за финансовые, моральные и прочие вариации потерь от использования ответственность не несу, она целиком и полностью ложится на ваши плечи. Код может содержать баги, изъяны и прочие недостатки, являющиеся следствием одного из процессов жизнедеятельности моего несовершенного мозга.

Мне было нечем заняться, поэтому я решил побаловаться с автоматизацией своих рутинных процессов в моём ныне основном банке.

Старался взять всё прекрасное из мейнстримовых библиотек и сделать удобную красоту. Получилось? Кажется, немного.

Возможности Райффазера

• Получение пуш-уведомлений как в настоящем приложении
• Регистрация устройства для подтверждения операций
• Общий баланс по курсу ЦБ в рублях
• Список счетов и привязанных к ним карт
• Уведомления из разряда технических работ или сбоев
• Управление картой
  • Просмотр реквизитов
  • Смена пин-кода
  • Блокировка карты
  • Получение кешбэка
  • Уведомления по операциям
  • Переименовка карты
  • Получение тарифа
• Управление счётом
  • Переименовать счёт
  • Закрыть счёт
• Переводы по СБП
  • c2c
  • me2me
  • c2b
• Переводы между счетами
  • В одной валюте
  • В разной валюте
  • Со счёта или на счёт ИП
• Обмен валюты
• Переводы по номеру карты
  • Отправка внутри банка
  • Отправка в другие банки
  • Получение внутри банка
  • Получение из другого банка
• Переводы по реквизитам
  • Физ лицам
  • Юр лицам
  • Государству
• Оплата по QR коду (СБП)
• Оплата услуг
  • Пополнение баланса номера телефона
  • Вывод на электронные кошельки
    • Киви
    • Юмани
  • Интернет и телефония
  • Транспорт
  • Телевидение
  • ЖКХ
• Штрафы, платежи в бюджет
  • По УИН
  • Подписка по ИНН/СНИЛС/Права/Единый лицевой счёт
• Чат поддержки
  • Эскорт истории диалога
  • Отправка сообщений
  • Отправка файлов
• Справки и документы
  • Счета
    • О наличии счёта(ов) с балансом
    • О наличии счёта(ов) без баланса
    • О закрытии счёта
  • Кредит
    • О задолженности
    • О полном погашении
    • О процентах за пользование
    • Для маткапитала в ПФР
    • О задолженности по решению суда/судебному приказу/исполнительной надписи нотариуса
  • Кредитная карта
    • О кредитном лимите
    • О закрытии счёта кредитной карты
    • О задолженности по решению суда/судебному приказу/исполнительной надписи нотариуса
  • Об отсутствии кредитных обязательств
  • О наличии депозита
• Настройка переводов по СБП
• Адреса банкоматов
  • Банки партнёры
  • Поиск ближайших к точке
  • Фильтры
  • Список всех для города
• Курсы валют
• Управление персональными данными
• Открытие новых продуктов
  • Дебетовые карты
    • Виртуальные
    • Пластиковые
  • Расчётные счета
  • Накопительные счета
  • Вклады

Как устанавливать?

Если доверяете мне или можете проверить код в site_packages (пока что не работает, ибо ещё не залил в pypi)

python -m pip install raiffather

Если не сильно доверяете мне и не хотите проверять код в site_packages, но проверили его в репозитории

python -m pip install [email protected]:WhiteApfel/raiffather.git

Если не доверяете мне и коду

Наденьте шапочку из фольги и свинцовый жилет, а то я уже облучаю вашу светлую голову 5G лучами

Как пользоваться?

from raiffather import Raiffather

raif = Raiffather('username', 'password')

async def main():
    async with raif:
        request_id = await raif.register_device()
        code = input("SMS code >>> ")
        await raif.register_device_verify(request_id, code)

from raiffather import Raiffather

raif = Raiffather('username', 'password')

async def main():
    async with raif:
        await raif.sbp("79991398805", "Точка", 22.8, "Благодарность за библиотеку")

from raiffather import Raiffather

raif = Raiffather('username', 'password')

async def main():
    async with raif:
        cba = (await raif.sbp_settings()).cba
        await raif.sbp_prepare()
        banks = await raif.sbp_banks(phone="79991398805", cba=cba)
        bank_name = raif.sbp_bank_fuzzy_search([b.name for b in banks], "Точка")
        bank = next((bank for bank in banks if bank.name == bank_name), None)
        if bank:
            pam = await raif.sbp_pam(bank_id=bank.id, phone="79991398805", cba=cba)
            com = float(
                (
                    await raif.sbp_commission(
                        bank=bank.id, phone="79991398805", amount=float(22), cba=cba
                    )
                ).commission
            )
            init = await raif.sbp_init(float(22), bank.id, "79991398805", "Благодарность за либу", cba)
            code = await raif.sbp_send_push(init.request_id)
            success = await raif.sbp_push_verify(init.request_id, code)

from raiffather import Raiffather

raif = Raiffather('username', 'password')

async def main():
    async with raif:
        transactions = raif.global_history_generator()
        async for transaction in transactions:
            print(transaction)

raiffather's Issues

(PTC-W0027) `f-string` used without any expression

Description

It is wasteful to use f-string mechanism if there are no expressions to be extrapolated. It is recommended to use regular strings instead.

Occurrences

There are 10 occurrences of this issue in the repository.

See all occurrences on DeepSource → deepsource.io/gh/WhiteApfel/raiffather/issue/PTC-W0027/occurrences/

Standard pseudo-random generators are not suitable for security/cryptographic purposes.

Codacy detected an issue:

Message: Standard pseudo-random generators are not suitable for security/cryptographic purposes.

Occurred on:

• Commit: 8902b15
• File: raiffather/modules/base.py
• LineNum: 254
• Code: "fingerprint": str(randint(1000000000, 9999999999)),

Currently on:

• Commit: 99e6c77
• File: raiffather/modules/base.py
• LineNum: 255

Standard pseudo-random generators are not suitable for security/cryptographic purposes.

Codacy detected an issue:

Message: Standard pseudo-random generators are not suitable for security/cryptographic purposes.

Occurred on:

• Commit: 8902b15
• File: raiffather/modules/base.py
• LineNum: 252
• Code: [choice("1234567890ABCDEF") for _ in range(40)]

Currently on:

• Commit: 99e6c77
• File: raiffather/modules/base.py
• LineNum: 253

Добавить вызов RaifUnauthorized для всех ответов. И 417ый код тоже посмотреть надо

Было бы классно не пихать во всё подряд обработку нескольких одинаковых кодов, а через один вызов ErrorResponse делать магию ответов

Initial Update

The bot created this issue to inform you that pyup.io has been set up on this repo.
Once you have closed it, the bot will open pull requests for updates as soon as they are available.

Правильное исключение при невозможности найти продукт в списке продуктов

Сейчас используется KeyError, но лучше было бы использовать унаследованный от него RaifProductNotFound или просто ProductNotFund

Standard pseudo-random generators are not suitable for security/cryptographic purposes.

Codacy detected an issue:

Message: Standard pseudo-random generators are not suitable for security/cryptographic purposes.

Occurred on:

• Commit: 8902b15
• File: raiffather/modules/base.py
• LineNum: 243
• Code: [choice(hexdigits[:-6]) for _ in range(8)]

Currently on:

• Commit: 99e6c77
• File: raiffather/modules/base.py
• LineNum: 244

Добавить поддержку большего количества типов для счетов в sbp_qr

Сейчас принимает только аккаунты, но было бы классно дать вохможность принмиать названия, id или номера счетов

Добавить докстринги и тайп хинты

Очень много кода без документации и подсказок типов. Некрасиво. Не надо так.

Добавить поддержку большего количества типов в settings

Сейчас там принимается только номер счёта, но хотелось бы передавать объект счёта или какой-либо его идентификатор

Поиск счёта/карты по названию, если название совпадает по длине с id

Добавить проверку счёта на соответствие требованиям СБП

Сейчас можно передать любой параметр, но как минимум необходимо его валидировать по длине. Хорошей практикой была бы его проверка на принадлежность банку и коду валюты

Логилогилогилоги

Надо покрыть логами все рабочие функции. И систему уровней логирования пропработать

Использовать AppDirs для сохранения файла конфига

Хранить в $HOME -- так себе решение. Может лучше appdirs использовать?

Мне тоже так кажется

(PYL-W0703) Exception caught is very general

Description

If the except block catches a very general exception, it is likely to catch any unrelated errors too. Try to be more explicit about which exception(s) you're trying to catch.

Occurrences

There is 1 occurrence of this issue in the repository.

See all occurrences on DeepSource → deepsource.io/gh/WhiteApfel/raiffather/issue/PYL-W0703/occurrences/