{"id":23217,"library":"aiomisc","title":"aiomisc","description":"Miscellaneous utilities for asyncio, including connection pools, retry logic, periodic callbacks, and CLI entrypoints. Current version 18.0.19, supports Python >=3.11. Releases follow semantic versioning with occasional breaking changes in internal modules.","status":"active","version":"18.0.19","language":"python","source_language":"en","source_url":"https://github.com/aiokitchen/aiomisc","tags":["asyncio","utilities","async","connection-pool","retry","periodic"],"install":[{"cmd":"pip install aiomisc","lang":"bash","label":"Install from PyPI"},{"cmd":"pip install 'aiomisc[uvloop,thread-pool]'","lang":"bash","label":"Install with extras"}],"dependencies":[{"reason":"Required for time-related utilities","package":"python-dateutil","optional":false},{"reason":"Required for timeout utilities","package":"async-timeout","optional":false},{"reason":"Used for version parsing","package":"packaging","optional":false}],"imports":[{"note":"Recommended import is via the top-level module; direct internal imports may break","wrong":"from aiomisc.entrypoint import AsyncEntrypoint","symbol":"AsyncEntrypoint","correct":"from aiomisc import entrypoint"},{"note":"Top-level import is preferred; internal module paths may change","wrong":"from aiomisc.periodic import PeriodicCallback","symbol":"PeriodicCallback","correct":"from aiomisc import PeriodicCallback"},{"note":"","wrong":"","symbol":"retry","correct":"from aiomisc import retry"}],"quickstart":{"code":"import asyncio\nfrom aiomisc import entrypoint\n\nasync def main():\n    print('Hello, aiomisc!')\n    return 0\n\nif __name__ == '__main__':\n    with entrypoint() as loop:\n        loop.run_until_complete(main())","lang":"python","description":"Basic entrypoint usage."},"warnings":[{"fix":"Use only public APIs imported from top-level aiomisc. For aiomisc.io, check changelog for migration details.","message":"In version 16.3, migration to poetry broke some non-public imports, mainly typing and the aiomisc.io module. If you rely on internal modules like aiomisc.io, your code may need updating.","severity":"breaking","affected_versions":">=16.3"},{"fix":"Upgrade Python to >=3.11 or install aiomisc==17.x","message":"aiomisc 18.x drops support for Python <3.11. If your project uses Python 3.10 or earlier, you must upgrade Python or pin to aiomisc<18.","severity":"breaking","affected_versions":">=18.0.0"},{"fix":"Always use 'with entrypoint() as loop:' instead of manually calling loop.close()","message":"The entrypoint context manager may require proper event loop closure. Forgetting to use it can lead to resource warnings.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'18.0.19':18 '3.11':21 'aiomisc':1 'async':35 'asyncio':5,33 'break':28 'callback':12 'chang':29 'cli':14 'connect':7,37 'connection-pool':36 'current':16 'entrypoint':15 'follow':23 'includ':6 'intern':31 'logic':10 'miscellan':2 'modul':32 'occasion':27 'period':11,40 'pool':8,38 'python':20 'releas':22 'retri':9,39 'semant':24 'support':19 'util':3,34 'version':17,25","created_at":"2026-05-01T08:06:35.998265+00:00","updated_at":"2026-05-01T08:06:35.998265+00:00","problems":[{"fix":"Use 'from aiomisc import entrypoint' or 'from aiomisc import *' to get the correct entrypoint symbol.","cause":"Attempting to import from a submodule that no longer exists or has been restructured.","error":"ModuleNotFoundError: No module named 'aiomisc.entrypoint'"},{"fix":"If you need IO utilities, use standard asyncio streams or check the changelog for replacement APIs.","cause":"In aiomisc 16.3+, the io module is no longer a public top-level attribute. It was moved or removed.","error":"AttributeError: module 'aiomisc' has no attribute 'io'"},{"fix":"Use 'with entrypoint() as loop:' or 'with entrypoint(*args, **kwargs) as loop:' as per the documentation.","cause":"Using entrypoint incorrectly without arguments or with deprecated parameters.","error":"TypeError: entrypoint() missing required positional argument (or similar)"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"18.0.24","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/aiokitchen/aiomisc","docs":"https://docs.aiomisc.com/","changelog":"https://github.com/aiokitchen/aiomisc/blob/master/CHANGELOG.md","pypi":"https://pypi.org/project/aiomisc/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["http-networking","database","workflow","observability","web-framework"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}