Skip to content

Latest commit

 

History

History
32 lines (25 loc) · 2.38 KB

CONTRIBUTING.md

File metadata and controls

32 lines (25 loc) · 2.38 KB

Что нужно для запуска

  1. python3.11. Установка описана тут

  2. Завсимости, описанные в setup.py, requirements.dev.txt

Как тестировать при разработке

  1. Создаете ветку в репозитории, разрабатываете там
  2. Закончили - коммитите изменения
  3. Заходите в любой fastapi проект
  4. Установите вашу версию. Вот как это сделать: https://stackoverflow.com/questions/20101834/pip-install-from-git-repo-branch
  5. Тестируйте все методы из methods.py, aiomethods.py, UnionAuth.call()

Как контрибьютить

  1. git clone https://github.com/profcomff/auth-lib.git
  2. Создавайте ветку

Если хотите добавить новый общий метод

  1. Написать этот метод в файл /auth_lib/methods.py - синхронная версия и, если есть возможность, в файл /auth_lib/aiomethods/py - асинхронная версия
  2. Протестировать метод на локальном/тестовом АПИ

Если хотите добавить логику в общий класс порверки аутентификации и авторизации

  1. Прочитайте как работает Depends: https://fastapi.tiangolo.com/tutorial/dependencies/
  2. Нужная вам логика описана в /auth_lib/fastapi.py. Основной метод - call.py.

Если хотите поменять логику тестирования библиотеки

  1. Прочитайте про используемые в этой библиотеке моки из unittest
  2. Прочитайте про pytest fixtures. Это тоже неплохая статья.
  3. Нужная вам логика описана в /auth_lib/testing/testutils.py.

Codestyle

  • Black. Как пользоваться описано тут

  • Также применяем isort