Github Navigator

\n\n \n\n

Results found: {{ repositories|length }}

\n\n \n \n \n \n \n \n \n \n \n \n {% for repository in repositories %} {{n}}\n \n \n \n \n \n \n {% endfor %}\n \n

#	Repository	Repository owner	Last commit
{{ loop.index }}	\n {{ repository.name }}\n	\n $\"avatar\"$ \n \n {{ repository.owner.login }}\n	\n {{ repository.latest_commit.sha }}\n {{ repository.latest_commit.message }}\n {{ repository.latest_commit.author_name }}\n

\n\n{% endblock %}\n","type":"unstyled","key":"f08t5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отлично, почти готово. Последним шагом изменим представление index чтобы оно использовало шаблон index.html.\n","type":"unstyled","key":"e26ja"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируем views.py:\n","type":"unstyled","key":"21q56"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Views module.\"\"\"\n\nfrom flask import request, render_template\n\n\ndef index():\n query = request.args.get('query', 'Dependency Injector')\n limit = request.args.get('limit', 10, int)\n\n repositories = []\n\n return render_template(\n 'index.html',\n query=query,\n limit=limit,\n repositories=repositories,\n )\n","type":"unstyled","key":"eli7u"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Готово.\n","type":"unstyled","key":"fbpcm"},{"data":{},"depth":0,"entityRanges":[{"key":16,"length":22,"offset":69}],"inlineStyleRanges":[],"text":"Убедитесь что приложение работает или выполните flask run и откройте http://127.0.0.1:5000/.\n","type":"unstyled","key":"2n3sc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Вы должны увидите:\n","type":"unstyled","key":"emise"},{"data":{"image":{"id":"5f1ccc69082c3d64be791fcb"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\n\n","type":"atomic:image","key":"26f8l"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"BOLD"}],"text":"Подключаем Github","type":"header-three","key":"f96nm"},{"data":{},"depth":0,"entityRanges":[{"key":17,"length":8,"offset":90}],"inlineStyleRanges":[],"text":"В этом разделе интегрируем наше приложение с Github API.\nМы будем использовать библиотеку PyGithub.\n","type":"unstyled","key":"bpd3s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Добавим её в requirements.txt:\n","type":"unstyled","key":"8t87p"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"dependency-injector\nflask\nbootstrap-flask\npygithub\n","type":"unstyled","key":"ce5s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"и выполним в терминале:\n","type":"unstyled","key":"6d0b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"pip install --upgrade -r requirements.txt\n","type":"unstyled","key":"2hj10"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь нам нужно добавить Github API клиент в контейнер. Для этого нам нужно будет воспользоваться двумя новыми провайдерами из модуля dependency_injector.providers:\n","type":"unstyled","key":"a6lcb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Провайдер Factory будет создавать Github клиент.","type":"unordered-list-item","key":"bc8kk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Провайдер Configuration будет передавать API токен и таймаут Github клиенту.","type":"unordered-list-item","key":"9cfrn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Сделаем это.\n","type":"unstyled","key":"3tb6g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируем containers.py:\n","type":"unstyled","key":"6icjn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Application containers module.\"\"\"\n\nfrom dependency_injector import containers, providers\nfrom dependency_injector.ext import flask\nfrom flask import Flask\nfrom flask_bootstrap import Bootstrap\nfrom github import Github\n\nfrom . import views\n\n\nclass ApplicationContainer(containers.DeclarativeContainer):\n \"\"\"Application container.\"\"\"\n\n app = flask.Application(Flask, __name__)\n\n bootstrap = flask.Extension(Bootstrap)\n\n config = providers.Configuration()\n\n github_client = providers.Factory(\n Github,\n login_or_token=config.github.auth_token,\n timeout=config.github.request_timeout,\n )\n\n index_view = flask.View(views.index)\n","type":"unstyled","key":"bbipv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":116,"offset":0,"style":"ITALIC"},{"length":14,"offset":117,"style":"ITALIC"},{"length":42,"offset":133,"style":"ITALIC"}],"text":"Мы использовали параметры конфигурации перед тем как задали их значения. Это принцип, по которому работает провайдер Configuration.\n\nСначала используем, потом задаем значения.\n","type":"blockquote","key":"44cvj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь давайте добавим файл конфигурации.\nБудем использовать YAML.\n","type":"unstyled","key":"b3r1a"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создайте пустой файл config.yml в корне проекта:\n","type":"unstyled","key":"7jj7h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"./\n├── githubnavigator/\n│ ├── templates/\n│ │ ├── base.html\n│ │ └── index.html\n│ ├── __init__.py\n│ ├── application.py\n│ ├── containers.py\n│ └── views.py\n├── venv/\n├── config.yml\n└── requirements.txt\n","type":"unstyled","key":"ajpi8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"И заполните его следующими строками:\n","type":"unstyled","key":"adhc4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"github:\n request_timeout: 10\n","type":"unstyled","key":"64p9s"},{"data":{},"depth":0,"entityRanges":[{"key":18,"length":6,"offset":70}],"inlineStyleRanges":[],"text":"Для работы с конфигурационным файлом мы будем использовать библиотеку PyYAML. Добавим ее в файл с зависимостями.\n","type":"unstyled","key":"edii0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируйте requirements.txt:\n","type":"unstyled","key":"4r0l7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"dependency-injector\nflask\nbootstrap-flask\npygithub\npyyaml\n","type":"unstyled","key":"7hqpt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"и установите зависимость:\n","type":"unstyled","key":"sl2m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"pip install --upgrade -r requirements.txt\n","type":"unstyled","key":"61kn0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для передачи API токена мы будем использовать переменную окружения GITHUB_TOKEN.\n","type":"unstyled","key":"eec20"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь нам нужно отредактировать create_app() чтобы сделать 2 действие при старте приложения:\n","type":"unstyled","key":"7sb4t"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Загрузить конфигурацию из config.yml","type":"unordered-list-item","key":"daefg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Загрузить API токен из переменной окружения GITHUB_TOKEN","type":"unordered-list-item","key":"7hanb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируйте application.py:\n","type":"unstyled","key":"cbf0o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Application module.\"\"\"\n\nfrom .containers import ApplicationContainer\n\n\ndef create_app():\n \"\"\"Create and return Flask application.\"\"\"\n container = ApplicationContainer()\n container.config.from_yaml('config.yml')\n container.config.github.auth_token.from_env('GITHUB_TOKEN')\n\n app = container.app()\n app.container = container\n\n bootstrap = container.bootstrap()\n bootstrap.init_app(app)\n\n app.add_url_rule('/', view_func=container.index_view.as_view())\n\n return app\n","type":"unstyled","key":"7d2er"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь нам нужно создать API токен.\n","type":"unstyled","key":"dlipi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для это нужно:\n","type":"unstyled","key":"6jmoj"},{"data":{},"depth":0,"entityRanges":[{"key":19,"length":21,"offset":16}],"inlineStyleRanges":[],"text":"Следовать этому руководству на Github","type":"unordered-list-item","key":"dn0vc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Установить токен в переменную окружения:\n\nexport GITHUB_TOKEN=","type":"unordered-list-item","key":"2kcrj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":37,"offset":0,"style":"ITALIC"},{"length":200,"offset":39,"style":"ITALIC"}],"text":"Этот пункт можно временно пропустить.\n\nПриложение будет работать без токена, но с ограниченной пропускной способностью. Ограничение для неаутентифицированных клиентов: 60 запросов в час. Токен нужен чтобы увеличить эту квоту до 5000 в час.","type":"blockquote","key":"8uaq4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Готово.\n","type":"unstyled","key":"4fsl3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Установка Github API клиента завершена.\n\n","type":"unstyled","key":"5iqf3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"}],"text":"Сервис поиска","type":"header-three","key":"3nbbq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Пришло время добавить сервис поиска SearchService. Он будет:\n","type":"unstyled","key":"bk24j"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Выполнять поиск на Github","type":"unordered-list-item","key":"epfdk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Получать дополнительные данные о коммитах","type":"unordered-list-item","key":"6lrku"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Преобразовывать формат результат","type":"unordered-list-item","key":"4v02h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"SearchService будет использовать Github API клиент.\n","type":"unstyled","key":"50ate"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создайте пустой файл services.py в пакете githubnavigator:\n","type":"unstyled","key":"6adf0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"./\n├── githubnavigator/\n│ ├── templates/\n│ │ ├── base.html\n│ │ └── index.html\n│ ├── __init__.py\n│ ├── application.py\n│ ├── containers.py\n│ ├── services.py\n│ └── views.py\n├── venv/\n├── config.yml\n└── requirements.txt\n","type":"unstyled","key":"b1od9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"и добавьте в него следующие строки:\n","type":"unstyled","key":"27fbl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Services module.\"\"\"\n\nfrom github import Github\nfrom github.Repository import Repository\nfrom github.Commit import Commit\n\n\nclass SearchService:\n \"\"\"Search service performs search on Github.\"\"\"\n\n def __init__(self, github_client: Github):\n self._github_client = github_client\n\n def search_repositories(self, query, limit):\n \"\"\"Search for repositories and return formatted data.\"\"\"\n repositories = self._github_client.search_repositories(\n query=query,\n **{'in': 'name'},\n )\n return [\n self._format_repo(repository)\n for repository in repositories[:limit]\n ]\n\n def _format_repo(self, repository: Repository):\n commits = repository.get_commits()\n return {\n 'url': repository.html_url,\n 'name': repository.name,\n 'owner': {\n 'login': repository.owner.login,\n 'url': repository.owner.html_url,\n 'avatar_url': repository.owner.avatar_url,\n },\n 'latest_commit': self._format_commit(commits[0]) if commits else {},\n }\n\n def _format_commit(self, commit: Commit):\n return {\n 'sha': commit.sha,\n 'url': commit.html_url,\n 'message': commit.commit.message,\n 'author_name': commit.commit.author.name,\n }\n","type":"unstyled","key":"feiu0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь добавим SearchService в контейнер.\n","type":"unstyled","key":"8vcps"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируйте containers.py:\n","type":"unstyled","key":"ah14p"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Application containers module.\"\"\"\n\nfrom dependency_injector import containers, providers\nfrom dependency_injector.ext import flask\nfrom flask import Flask\nfrom flask_bootstrap import Bootstrap\nfrom github import Github\n\nfrom . import services, views\n\n\nclass ApplicationContainer(containers.DeclarativeContainer):\n \"\"\"Application container.\"\"\"\n\n app = flask.Application(Flask, __name__)\n\n bootstrap = flask.Extension(Bootstrap)\n\n config = providers.Configuration()\n\n github_client = providers.Factory(\n Github,\n login_or_token=config.github.auth_token,\n timeout=config.github.request_timeout,\n )\n\n search_service = providers.Factory(\n services.SearchService,\n github_client=github_client,\n )\n\n index_view = flask.View(views.index)\n","type":"unstyled","key":"3akbm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":0,"style":"BOLD"}],"text":"Подключаем поиск","type":"header-three","key":"bic4e"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь мы готовы чтобы поиск заработал. Давайте используем SearchService в index представлении.\n","type":"unstyled","key":"fec2s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируйте views.py:\n","type":"unstyled","key":"coikj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Views module.\"\"\"\n\nfrom flask import request, render_template\n\nfrom .services import SearchService\n\n\ndef index(search_service: SearchService):\n query = request.args.get('query', 'Dependency Injector')\n limit = request.args.get('limit', 10, int)\n\n repositories = search_service.search_repositories(query, limit)\n\n return render_template(\n 'index.html',\n query=query,\n limit=limit,\n repositories=repositories,\n )\n","type":"unstyled","key":"bqeer"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь изменим контейнер чтобы передавать зависимость SearchService в представление index при его вызове.\n","type":"unstyled","key":"ai583"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируйте containers.py:\n","type":"unstyled","key":"4pf58"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Application containers module.\"\"\"\n\nfrom dependency_injector import containers, providers\nfrom dependency_injector.ext import flask\nfrom flask import Flask\nfrom flask_bootstrap import Bootstrap\nfrom github import Github\n\nfrom . import services, views\n\n\nclass ApplicationContainer(containers.DeclarativeContainer):\n \"\"\"Application container.\"\"\"\n\n app = flask.Application(Flask, __name__)\n\n bootstrap = flask.Extension(Bootstrap)\n\n config = providers.Configuration()\n\n github_client = providers.Factory(\n Github,\n login_or_token=config.github.auth_token,\n timeout=config.github.request_timeout,\n )\n\n search_service = providers.Factory(\n services.SearchService,\n github_client=github_client,\n )\n\n index_view = flask.View(\n views.index,\n search_service=search_service,\n )\n","type":"unstyled","key":"cfo3k"},{"data":{},"depth":0,"entityRanges":[{"key":20,"length":22,"offset":69}],"inlineStyleRanges":[],"text":"Убедитесь что приложение работает или выполните flask run и откройте http://127.0.0.1:5000/.\n","type":"unstyled","key":"e62sq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Вы увидите:\n","type":"unstyled","key":"diken"},{"data":{"image":{"id":"5f1ccc69aecb5c17383b2033"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\n\n","type":"atomic:image","key":"a5ue"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":0,"style":"BOLD"}],"text":"Немного рефакторинга","type":"header-three","key":"aoqii"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Наше представление index содержит два hardcoded значения:\n","type":"unstyled","key":"6383r"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Поисковый запрос по умолчанию","type":"unordered-list-item","key":"4jfnl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Лимит количества результатов","type":"unordered-list-item","key":"3nl3c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Давайте сделаем небольшой рефакторинг. Мы перенесем эти значения в конфигурацию.\n","type":"unstyled","key":"357j4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируйте views.py:\n","type":"unstyled","key":"acrth"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Views module.\"\"\"\n\nfrom flask import request, render_template\n\nfrom .services import SearchService\n\n\ndef index(\n search_service: SearchService,\n default_query: str,\n default_limit: int,\n):\n query = request.args.get('query', default_query)\n limit = request.args.get('limit', default_limit, int)\n\n repositories = search_service.search_repositories(query, limit)\n\n return render_template(\n 'index.html',\n query=query,\n limit=limit,\n repositories=repositories,\n )\n","type":"unstyled","key":"7lphj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь нам нужно чтобы эти значения передавались при вызове. Давайте обновим контейнер.\n","type":"unstyled","key":"j08d"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируйте containers.py:\n","type":"unstyled","key":"23vgq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Application containers module.\"\"\"\n\nfrom dependency_injector import containers, providers\nfrom dependency_injector.ext import flask\nfrom flask import Flask\nfrom flask_bootstrap import Bootstrap\nfrom github import Github\n\nfrom . import services, views\n\n\nclass ApplicationContainer(containers.DeclarativeContainer):\n \"\"\"Application container.\"\"\"\n\n app = flask.Application(Flask, __name__)\n\n bootstrap = flask.Extension(Bootstrap)\n\n config = providers.Configuration()\n\n github_client = providers.Factory(\n Github,\n login_or_token=config.github.auth_token,\n timeout=config.github.request_timeout,\n )\n\n search_service = providers.Factory(\n services.SearchService,\n github_client=github_client,\n )\n\n index_view = flask.View(\n views.index,\n search_service=search_service,\n default_query=config.search.default_query,\n default_limit=config.search.default_limit,\n )\n","type":"unstyled","key":"r51i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь давайте обновим конфигурационный файл.\n","type":"unstyled","key":"7vb92"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируйте config.yml:\n","type":"unstyled","key":"cq8qr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"github:\n request_timeout: 10\nsearch:\n default_query: \"Dependency Injector\"\n default_limit: 10\n","type":"unstyled","key":"9hlie"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Готово.\n","type":"unstyled","key":"bkgun"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Рефакторинг закончен. Му сделали код чище.\n\n","type":"unstyled","key":"b37mf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":15,"offset":0,"style":"BOLD"}],"text":"Добавляем тесты","type":"header-three","key":"ecl95"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Было бы хорошо добавить немного тестов. Давайте это сделаем.\n","type":"unstyled","key":"20a8i"},{"data":{},"depth":0,"entityRanges":[{"key":21,"length":6,"offset":22},{"key":22,"length":8,"offset":31}],"inlineStyleRanges":[],"text":"Мы будем использовать pytest и coverage.\n","type":"unstyled","key":"20kmt"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отредактируйте requirements.txt:\n","type":"unstyled","key":"9lteb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"dependency-injector\nflask\nbootstrap-flask\npygithub\npyyaml\npytest-flask\npytest-cov\n","type":"unstyled","key":"b400s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"и установите новые пакеты:\n","type":"unstyled","key":"cjauf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"pip install -r requirements.txt\n","type":"unstyled","key":"8d421"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Создайте пустой файл tests.py в пакете githubnavigator:\n","type":"unstyled","key":"blu13"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"./\n├── githubnavigator/\n│ ├── templates/\n│ │ ├── base.html\n│ │ └── index.html\n│ ├── __init__.py\n│ ├── application.py\n│ ├── containers.py\n│ ├── services.py\n│ ├── tests.py\n│ └── views.py\n├── venv/\n├── config.yml\n└── requirements.txt\n","type":"unstyled","key":"bjskv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"и добавьте в него следующие строки:\n","type":"unstyled","key":"97lol"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Tests module.\"\"\"\n\nfrom unittest import mock\n\nimport pytest\nfrom github import Github\nfrom flask import url_for\n\nfrom .application import create_app\n\n\n@pytest.fixture\ndef app():\n return create_app()\n\n\ndef test_index(client, app):\n github_client_mock = mock.Mock(spec=Github)\n github_client_mock.search_repositories.return_value = [\n mock.Mock(\n html_url='repo1-url',\n name='repo1-name',\n owner=mock.Mock(\n login='owner1-login',\n html_url='owner1-url',\n avatar_url='owner1-avatar-url',\n ),\n get_commits=mock.Mock(return_value=[mock.Mock()]),\n ),\n mock.Mock(\n html_url='repo2-url',\n name='repo2-name',\n owner=mock.Mock(\n login='owner2-login',\n html_url='owner2-url',\n avatar_url='owner2-avatar-url',\n ),\n get_commits=mock.Mock(return_value=[mock.Mock()]),\n ),\n ]\n\n with app.container.github_client.override(github_client_mock):\n response = client.get(url_for('index'))\n\n assert response.status_code == 200\n assert b'Results found: 2' in response.data\n\n assert b'repo1-url' in response.data\n assert b'repo1-name' in response.data\n assert b'owner1-login' in response.data\n assert b'owner1-url' in response.data\n assert b'owner1-avatar-url' in response.data\n\n assert b'repo2-url' in response.data\n assert b'repo2-name' in response.data\n assert b'owner2-login' in response.data\n assert b'owner2-url' in response.data\n assert b'owner2-avatar-url' in response.data\n\n\ndef test_index_no_results(client, app):\n github_client_mock = mock.Mock(spec=Github)\n github_client_mock.search_repositories.return_value = []\n\n with app.container.github_client.override(github_client_mock):\n response = client.get(url_for('index'))\n\n assert response.status_code == 200\n assert b'Results found: 0' in response.data\n","type":"unstyled","key":"dbi7h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь давайте запустим тестирование и проверим покрытие:\n","type":"unstyled","key":"72c76"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"py.test githubnavigator/tests.py --cov=githubnavigator\n","type":"unstyled","key":"b6gra"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Вы увидите:\n","type":"unstyled","key":"ratm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"platform darwin -- Python 3.8.3, pytest-5.4.3, py-1.9.0, pluggy-0.13.1\nplugins: flask-1.0.0, cov-2.10.0\ncollected 2 items\n\ngithubnavigator/tests.py .. [100%]\n\n---------- coverage: platform darwin, python 3.8.3-final-0 -----------\nName Stmts Miss Cover\n----------------------------------------------------\ngithubnavigator/__init__.py 0 0 100%\ngithubnavigator/application.py 11 0 100%\ngithubnavigator/containers.py 13 0 100%\ngithubnavigator/services.py 14 0 100%\ngithubnavigator/tests.py 32 0 100%\ngithubnavigator/views.py 7 0 100%\n----------------------------------------------------\nTOTAL 77 0 100%\n","type":"unstyled","key":"7gh8k"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":33,"offset":0,"style":"ITALIC"},{"length":13,"offset":34,"style":"ITALIC"},{"length":22,"offset":48,"style":"ITALIC"},{"length":88,"offset":71,"style":"ITALIC"}],"text":"Обратите внимание как мы заменяем github_client моком с помощью метода .override(). Таким образом можно переопределить возвращаемое значения любого провайдера.\n","type":"blockquote","key":"1f02"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":0,"style":"BOLD"}],"text":"Заключение","type":"header-three","key":"en491"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Мы построили Flask приложения применяя принцип dependency injection. Мы использовали Dependency Injector в качестве dependency injection фреймворка.\n","type":"unstyled","key":"tjr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Основная часть нашего приложения это контейнер. Он содержит все компоненты приложения и их зависимости в одном месте. Это предоставляет контроль над структурой приложения. Её легко понимать и изменять:\n","type":"unstyled","key":"e4ri6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\"\"\"Application containers module.\"\"\"\n\nfrom dependency_injector import containers, providers\nfrom dependency_injector.ext import flask\nfrom flask import Flask\nfrom flask_bootstrap import Bootstrap\nfrom github import Github\n\nfrom . import services, views\n\n\nclass ApplicationContainer(containers.DeclarativeContainer):\n \"\"\"Application container.\"\"\"\n\n app = flask.Application(Flask, __name__)\n\n bootstrap = flask.Extension(Bootstrap)\n\n config = providers.Configuration()\n\n github_client = providers.Factory(\n Github,\n login_or_token=config.github.auth_token,\n timeout=config.github.request_timeout,\n )\n\n search_service = providers.Factory(\n services.SearchService,\n github_client=github_client,\n )\n\n index_view = flask.View(\n views.index,\n search_service=search_service,\n default_query=config.search.default_query,\n default_limit=config.search.default_limit,\n )\n","type":"unstyled","key":"8nc5s"},{"data":{"image":{"id":"5f1ccc694c281d04bc108999"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\nКонтейнер как карта вашего приложения. Вы всегда знайте что от чего зависит.\n","type":"atomic:image","key":"84ls3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":0,"style":"BOLD"}],"text":"Что дальше?","type":"header-three","key":"ck543"},{"data":{},"depth":0,"entityRanges":[{"key":23,"length":29,"offset":17}],"inlineStyleRanges":[],"text":"Узнайте больше о Dependency Injector на GitHub","type":"unordered-list-item","key":"ehagh"},{"data":{},"depth":0,"entityRanges":[{"key":24,"length":30,"offset":14}],"inlineStyleRanges":[],"text":"Ознакомтесь с документацией на Read the Docs","type":"unordered-list-item","key":"2b2p4"},{"data":{},"depth":0,"entityRanges":[{"key":25,"length":24,"offset":27}],"inlineStyleRanges":[],"text":"Есть вопрос или нашли баг? Откройте issue на Github","type":"unordered-list-item","key":"fuf6g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"Bw1iQPzTnIsTm8VTzs3b"}],"entityMap":{"22":{"data":{"href":"https://coverage.readthedocs.io/en/coverage-5.2.1/","url":"https://coverage.readthedocs.io/en/coverage-5.2.1/"},"mutability":"MUTABLE","type":"LINK"},"23":{"data":{"href":"https://github.com/ets-labs/python-dependency-injector","url":"https://github.com/ets-labs/python-dependency-injector"},"mutability":"MUTABLE","type":"LINK"},"24":{"data":{"href":"http://python-dependency-injector.ets-labs.org/","url":"http://python-dependency-injector.ets-labs.org/"},"mutability":"MUTABLE","type":"LINK"},"25":{"data":{"href":"https://github.com/ets-labs/python-dependency-injector/issues","url":"https://github.com/ets-labs/python-dependency-injector/issues"},"mutability":"MUTABLE","type":"LINK"},"10":{"data":{"href":"https://habr.com/ru/post/512242/#tests","url":"https://habr.com/ru/post/512242/#tests"},"mutability":"MUTABLE","type":"LINK"},"11":{"data":{"href":"https://habr.com/ru/post/512242/#conclusion","url":"https://habr.com/ru/post/512242/#conclusion"},"mutability":"MUTABLE","type":"LINK"},"12":{"data":{"href":"https://github.com/ets-labs/python-dependency-injector/tree/master/examples/miniapps/ghnav-flask","url":"https://github.com/ets-labs/python-dependency-injector/tree/master/examples/miniapps/ghnav-flask"},"mutability":"MUTABLE","type":"LINK"},"13":{"data":{"href":"http://127.0.0.1:5000/","url":"http://127.0.0.1:5000/"},"mutability":"MUTABLE","type":"LINK"},"14":{"data":{"href":"https://getbootstrap.com/","url":"https://getbootstrap.com/"},"mutability":"MUTABLE","type":"LINK"},"15":{"data":{"href":"https://pypi.org/project/Bootstrap-Flask/","url":"https://pypi.org/project/Bootstrap-Flask/"},"mutability":"MUTABLE","type":"LINK"},"16":{"data":{"href":"http://127.0.0.1:5000/","url":"http://127.0.0.1:5000/"},"mutability":"MUTABLE","type":"LINK"},"17":{"data":{"href":"https://github.com/PyGithub/PyGithub","url":"https://github.com/PyGithub/PyGithub"},"mutability":"MUTABLE","type":"LINK"},"18":{"data":{"href":"https://pypi.org/project/PyYAML/","url":"https://pypi.org/project/PyYAML/"},"mutability":"MUTABLE","type":"LINK"},"19":{"data":{"href":"https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token","url":"https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token"},"mutability":"MUTABLE","type":"LINK"},"0":{"data":{"href":"https://github.com/ets-labs/python-dependency-injector","url":"https://github.com/ets-labs/python-dependency-injector"},"mutability":"MUTABLE","type":"LINK"},"1":{"data":{"href":"https://habr.com/ru/post/512242/#what-we-are-going-to-build","url":"https://habr.com/ru/post/512242/#what-we-are-going-to-build"},"mutability":"MUTABLE","type":"LINK"},"2":{"data":{"href":"https://habr.com/ru/post/512242/#prepare-the-env","url":"https://habr.com/ru/post/512242/#prepare-the-env"},"mutability":"MUTABLE","type":"LINK"},"3":{"data":{"href":"https://habr.com/ru/post/512242/#structure","url":"https://habr.com/ru/post/512242/#structure"},"mutability":"MUTABLE","type":"LINK"},"4":{"data":{"href":"https://habr.com/ru/post/512242/#hello-world","url":"https://habr.com/ru/post/512242/#hello-world"},"mutability":"MUTABLE","type":"LINK"},"5":{"data":{"href":"https://habr.com/ru/post/512242/#make-it-pretty","url":"https://habr.com/ru/post/512242/#make-it-pretty"},"mutability":"MUTABLE","type":"LINK"},"6":{"data":{"href":"https://habr.com/ru/post/512242/#connect-github","url":"https://habr.com/ru/post/512242/#connect-github"},"mutability":"MUTABLE","type":"LINK"},"7":{"data":{"href":"https://habr.com/ru/post/512242/#search-service","url":"https://habr.com/ru/post/512242/#search-service"},"mutability":"MUTABLE","type":"LINK"},"8":{"data":{"href":"https://habr.com/ru/post/512242/#enable-search","url":"https://habr.com/ru/post/512242/#enable-search"},"mutability":"MUTABLE","type":"LINK"},"9":{"data":{"href":"https://habr.com/ru/post/512242/#refactoring","url":"https://habr.com/ru/post/512242/#refactoring"},"mutability":"MUTABLE","type":"LINK"},"20":{"data":{"href":"http://127.0.0.1:5000/","url":"http://127.0.0.1:5000/"},"mutability":"MUTABLE","type":"LINK"},"21":{"data":{"href":"https://docs.pytest.org/en/stable/","url":"https://docs.pytest.org/en/stable/"},"mutability":"MUTABLE","type":"LINK"}}},"mentions":[]}