{"id":20638559,"url":"https://github.com/meetinger/webtronicstesttask","last_synced_at":"2025-10-24T05:06:25.011Z","repository":{"id":203780851,"uuid":"587527024","full_name":"meetinger/WebTronicsTestTask","owner":"meetinger","description":"FastAPI Test Task","archived":false,"fork":false,"pushed_at":"2023-02-11T16:05:50.000Z","size":160,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-16T09:43:01.303Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/meetinger.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-11T00:35:18.000Z","updated_at":"2023-01-16T13:44:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"ea901181-335d-451a-bfab-da1a31a59cb3","html_url":"https://github.com/meetinger/WebTronicsTestTask","commit_stats":null,"previous_names":["meetinger/webtronicstesttask"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/meetinger/WebTronicsTestTask","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meetinger%2FWebTronicsTestTask","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meetinger%2FWebTronicsTestTask/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meetinger%2FWebTronicsTestTask/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meetinger%2FWebTronicsTestTask/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meetinger","download_url":"https://codeload.github.com/meetinger/WebTronicsTestTask/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meetinger%2FWebTronicsTestTask/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262364843,"owners_count":23299654,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T15:18:28.745Z","updated_at":"2025-10-24T05:06:24.928Z","avatar_url":"https://github.com/meetinger.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WebTronicsTestTask\n\n## Тестовое задание WebTronics\n\n### Установка и настройка\n\n1. Склонируйте репозиторий при помощи команды `git clone https://github.com/meetinger/WebTronicsTestTask` \nи перейдите в директорию репозитория\n2. Установите виртуальное окружение(venv или conda) Python(рекомендую установить Python 3.10,\n   т.к. на 3.11 есть проблемы с отображением стека вызовов FastAPI,\n   [GitHub Issue](https://github.com/tiangolo/fastapi/issues/5740))\n3. Установите нужные зависимости `pip install -r requirements.txt`\n4. Установите контейнеры docker `docker-compose up -d`\n   (перед этим проверьте конфигурацию контейнеров в файле `docker-compose.yml`,\n   если у Вас уже заняты те или иные параметры(порты, имена контейнеров) тогда измените их)\n    1. В случае того, если Вы изменили конфигурацию `docker-compose.yml`, отредактируйте\n       файл `core/settings.py` в соответствии с изменёнными параметрами\n5. В файле `core/settings.py` измените параметр `ROOT_URL` в соответствии с вашим IP-адресом или доменом\n6. Примените миграции для базы данных `alembic upgrade head`\n7. Запустите сервер из корня репозитория при помощи команды `uvicorn main:app --host 0.0.0.0`\n    1. Если Вы хотите запустить сервер на другом порте, то команда будет следующей:\n       `uvicorn main:app --host 0.0.0.0 --port \u003cномер порта\u003e`\n\n### Тестирование API\n\n1. Из корня репозитория запустите команду `pytest tests/`\n2. Для того чтобы посмотреть покрытие кода тестами(на момент написания README 95%), команда будет следующей:\n   `pytest --cov=../ tests/`\n\n### Задания из Google-Формы\n\n1. Юнит-тесты для функции:\n\n```python\nasync def logs(cont, name):\n    conn = aiohttp.UnixConnector(path=\"/var/run/docker.sock\")\n    async with aiohttp.ClientSession(connector=conn) as session:\n        async with session.get(f\"http://xx/containers/{cont}/logs?follow=1\u0026stdout=1\") as resp:\n            async for line in resp.content:\n                print(name, line)\n```\n\nНаходятся в директории `form_tasks/unittests`\n\n2. Эндпоинты для кодирования URL находятся в директории `form_tasks/endpoints`\n\n### Замечания по поводу моего кода\n\n1. В структуре БД была применена примесь `db/models/mixins_models.py`, что в будущем позволит легко добавить возможность\n   реакций для других сущностей\n2. В задании с юнит-тестами для функции логов докера были применены костыли в связи с тем,\n   что в исходной функции у line не был вызван метод `.decode()`\n3. В задании с эндпоинтом для кодирования URL я сделал два эндпоинта GET и POST\n\n\n### Бонусная секция:\n1. https://hunter.io/ не верифицирует webmail, так что делать проверку с помощью этого сервиса бессмысленно\nМодуль с клиентом на aiohttp Вы можете найти по пути `core/utils/hunter_io.py` (токен, найденный на GitHub прилагается)\n2. https://clearbit.com/ также не ищет людей с webmail адресами, так что нет смысла интегрировать этот сервис\nМодуль с клиентом на aiohttp Вы можете найти по пути `core/utils/clearbit_com.py` (токены, найденные на GitHub прилагаются)\n# P.S. Репозиторий не мёртв на данный момент, я буду продолжать делать бонусную секцию)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeetinger%2Fwebtronicstesttask","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmeetinger%2Fwebtronicstesttask","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmeetinger%2Fwebtronicstesttask/lists"}