{ "info": { "author": "Yuri Shikanov", "author_email": "dizballanze@gmail.com", "bugtrack_url": null, "classifiers": [ "Framework :: Pytest", "Intended Audience :: Developers", "Natural Language :: Russian", "Operating System :: MacOS", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: Implementation :: CPython" ], "description": "aiomisc-dependency\n==================\n\nDependency injection plugin for aiomisc_ built with aiodine_ library and\nsupport pytest fixture style dependency injection.\n\n.. _aiodine: https://github.com/bocadilloproject/aiodine\n.. _aiomisc: https://github.com/aiokitchen/aiomisc\n\n.. contents:: Table of contents\n\n\nInstallation\n------------\n\nInstalling from pypi:\n\n.. code-block:: bash\n\n pip3 install aiomisc aiomisc-dependency\n\n\nHow to use\n----------\n\nRegister dependency\n*******************\n\nTo register dependency you can use ``aiomisc_dependency.dependency`` decorator.\n\n.. code-block:: python\n\n from aiomisc_dependency import dependency\n\n @dependency\n async def pg_engine():\n pg_engine = await create_engine(dsn=pg_url)\n yield pg_engine\n pg_engine.close()\n await pg_engine.wait_closed()\n\n\nAs you can see dependency can be async generator function. Code after yield\nwill be executed on teardown to correctly close the dependency.\n\nCoroutine functions, non async functions and generators are also supported.\n\n\nUse dependency\n**************\n\nTo use dependency you need to add it's name to ``__dependencies__`` property\nfor every service which depends on it. Specified dependencies will be injected\nas service's attributes on entrypoint startup.\n\n.. code-block:: python\n\n from contextlib import suppress\n\n import aiohttp\n from aiomisc import Service\n from aiomisc.service.aiohttp import AIOHTTPService\n\n class HealthcheckService(Service):\n\n __dependencies__ = ('pg_engine',)\n\n async def create_application(self):\n app = aiohttp.web.Application()\n app.add_routes([aiohttp.web.get('/ping', self.healthcheck_handler)])\n return app\n\n async def healthcheck_handler(self, request):\n pg_status = False\n with suppress(Exception):\n async with self.pg_engine.acquire() as conn:\n await conn.execute('SELECT 1')\n pg_status = True\n\n return aiohttp.web.json_response(\n {'db': pg_status},\n status=(200 if pg_status else 500),\n )\n\n\n class RESTService(AIOHTTPService):\n\n __dependencies__ = ('pg_engine',)\n\n ...\n\nIf any required dependency won't be found on entrypoint startup,\n``RuntimeError`` will be raised.\n\nYou can set a dependency manually by adding it to kw arguments on service\ncreation. This could be convenient in tests.\n\n.. code-block:: python\n\n from unittest import Mock\n\n def test_rest_service():\n pg_engine_mock = Mock()\n service = RESTService(pg_engine=pg_engine_mock)\n ...\n\nDependencies for dependencies\n*****************************\n\nYou can use dependencies as arguments for other dependencies. Arguments will\ninjected automatically.\n\n.. code-block:: python\n\n @dependency\n async def pg_connection(pg_engine):\n async with pg_engine.acquire() as conn:\n yield conn\n\n\n``loop`` built-in dependency\n****************************\n\nBuilt-in ``loop`` dependency can be used if your dependency requires\nevent loop instance.\n\n.. code-block:: python\n\n import aioredis\n\n @dependency\n async def redis_pool(loop):\n pool = aioredis.create_pool(redis_url, loop=loop)\n yield pool\n pool.close()\n await pool.wait_closed()\n\nLICENSE\n-------\n\nMIT\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/aiokitchen/aiomisc-dependency", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "aiomisc-dependency", "package_url": "https://pypi.org/project/aiomisc-dependency/", "platform": "all", "project_url": "https://pypi.org/project/aiomisc-dependency/", "project_urls": { "Homepage": "https://github.com/aiokitchen/aiomisc-dependency" }, "release_url": "https://pypi.org/project/aiomisc-dependency/0.1.7/", "requires_dist": [ "aiodine (~=1.2.9)", "aiomisc (>=7.1)", "async-generator ; python_version < \"3.7\"", "coverage (~=4.5.3) ; extra == 'develop'", "coveralls ; extra == 'develop'", "pylava ; extra == 'develop'", "pytest ; extra == 'develop'", "pytest-cov (~=2.5.1) ; extra == 'develop'", "tox (>=2.4) ; extra == 'develop'" ], "requires_python": "", "summary": "aiomisc-dependency - dependency injection in aiomisc", "version": "0.1.7" }, "last_serial": 5975687, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "02b268e3a6ca10d4c431b0106b4a76b7", "sha256": "e50c5c17154d4b294fc07deedcadab45747ee22beab9be0a7ce0036770d6958f" }, "downloads": -1, "filename": "aiomisc_dependency-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "02b268e3a6ca10d4c431b0106b4a76b7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5204, "upload_time": "2019-05-15T13:19:18", "url": "https://files.pythonhosted.org/packages/ad/bc/def6ed24658ee1216086beafaf1d8afed836fffae9f88d1ae24c8e96a824/aiomisc_dependency-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "62b9bdfee493dcae1f28cb7ac53152ac", "sha256": "9cbd7d904109b2f0a2978e76e6528540964b2d15aed963cd876bd0a89f73c9b9" }, "downloads": -1, "filename": "aiomisc_dependency-0.1.0.tar.gz", "has_sig": false, "md5_digest": "62b9bdfee493dcae1f28cb7ac53152ac", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3955, "upload_time": "2019-05-15T13:19:20", "url": "https://files.pythonhosted.org/packages/07/04/4b0a1f305752923145a9e12b206a77934ab54c1e78f0d2d50d0092a3b639/aiomisc_dependency-0.1.0.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "59439baa4df2b08fe4523ea28f335c58", "sha256": "e0a6c39e3ec62a2680434c26e8fc35b3014cb8411f2c2b3f2a51e74d3f79650c" }, "downloads": -1, "filename": "aiomisc_dependency-0.1.4-py3-none-any.whl", "has_sig": false, "md5_digest": "59439baa4df2b08fe4523ea28f335c58", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5330, "upload_time": "2019-06-09T19:10:43", "url": "https://files.pythonhosted.org/packages/3c/2b/fcf497fbfb53802364cdb87a81efd12134ab35b1324811e0e799323c0c46/aiomisc_dependency-0.1.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "474a902d2fc7bb5d9695690c5fb63152", "sha256": "349f49005429ab87378cb02d001435e68801947c207b40e75dea92d935cfacb4" }, "downloads": -1, "filename": "aiomisc_dependency-0.1.4.tar.gz", "has_sig": false, "md5_digest": "474a902d2fc7bb5d9695690c5fb63152", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4086, "upload_time": "2019-06-09T19:10:45", "url": "https://files.pythonhosted.org/packages/f2/f2/e4eb0c3a0fbc441b524a6d0ffce57b34d2f68c08b31a65aa8b7b1830d4b6/aiomisc_dependency-0.1.4.tar.gz" } ], "0.1.7": [ { "comment_text": "", "digests": { "md5": "6f1b0b68cb5ab93b3594daf6b29f697e", "sha256": "1b1af44421c3e733ca03846e6362b5ae52b96a23f611dbfb60e46d7a12333b44" }, "downloads": -1, "filename": "aiomisc_dependency-0.1.7-py3-none-any.whl", "has_sig": false, "md5_digest": "6f1b0b68cb5ab93b3594daf6b29f697e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5332, "upload_time": "2019-10-15T08:56:20", "url": "https://files.pythonhosted.org/packages/7a/b1/ce892f8d65932215ccb57738c078535109ae5b501dc287998d8574cb374f/aiomisc_dependency-0.1.7-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "cfa33128b7a5c88bd7521bd76a9ef267", "sha256": "7a7e0b4b9ff288e58734b83135ef6ea31916d404e70970642f1ccc59eb6a5a09" }, "downloads": -1, "filename": "aiomisc_dependency-0.1.7.tar.gz", "has_sig": false, "md5_digest": "cfa33128b7a5c88bd7521bd76a9ef267", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4100, "upload_time": "2019-10-15T08:56:22", "url": "https://files.pythonhosted.org/packages/24/9c/0d25ca081d6f1487634af2557af7816d869d4359d4e584e48065a5e23d99/aiomisc_dependency-0.1.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6f1b0b68cb5ab93b3594daf6b29f697e", "sha256": "1b1af44421c3e733ca03846e6362b5ae52b96a23f611dbfb60e46d7a12333b44" }, "downloads": -1, "filename": "aiomisc_dependency-0.1.7-py3-none-any.whl", "has_sig": false, "md5_digest": "6f1b0b68cb5ab93b3594daf6b29f697e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5332, "upload_time": "2019-10-15T08:56:20", "url": "https://files.pythonhosted.org/packages/7a/b1/ce892f8d65932215ccb57738c078535109ae5b501dc287998d8574cb374f/aiomisc_dependency-0.1.7-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "cfa33128b7a5c88bd7521bd76a9ef267", "sha256": "7a7e0b4b9ff288e58734b83135ef6ea31916d404e70970642f1ccc59eb6a5a09" }, "downloads": -1, "filename": "aiomisc_dependency-0.1.7.tar.gz", "has_sig": false, "md5_digest": "cfa33128b7a5c88bd7521bd76a9ef267", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4100, "upload_time": "2019-10-15T08:56:22", "url": "https://files.pythonhosted.org/packages/24/9c/0d25ca081d6f1487634af2557af7816d869d4359d4e584e48065a5e23d99/aiomisc_dependency-0.1.7.tar.gz" } ] }