{"id":23893,"library":"integrationhelper","title":"Integration Helper","description":"A lightweight set of helper utilities for Python integrations, commonly used in Home Assistant custom components. Current version is 0.2.2. Low release cadence.","status":"active","version":"0.2.2","language":"python","source_language":"en","source_url":"https://github.com/ludeeus/integrationhelper","tags":["helpers","integration","home-assistant","throttle","logger"],"install":[{"cmd":"pip install integrationhelper","lang":"bash","label":"Default install"}],"dependencies":[],"imports":[{"note":"No common wrong import; just import directly.","symbol":"IntegrationLogger","correct":"from integrationhelper import IntegrationLogger"},{"note":"No common wrong import; just import directly.","symbol":"IntegrationBadge","correct":"from integrationhelper import IntegrationBadge"},{"note":"No common wrong import; just import directly.","symbol":"Integration","correct":"from integrationhelper import Integration"},{"note":"No common wrong import; just import directly.","symbol":"BaseGraphQLApi","correct":"from integrationhelper import BaseGraphQLApi"},{"note":"No common wrong import; just import directly.","symbol":"RestAPIWrapper","correct":"from integrationhelper import RestAPIWrapper"},{"note":"No common wrong import; just import directly.","symbol":"Throttle","correct":"from integrationhelper import Throttle"}],"quickstart":{"code":"from integrationhelper import IntegrationLogger, Throttle\nimport logging\n\nlogger = IntegrationLogger(__name__)\nlogger.info(\"Integration helper works!\")\n\n@Throttle(min_time=10)\ndef my_throttled_function():\n    return \"Called once per 10 seconds\"\n\nprint(my_throttled_function())","lang":"python","description":"Basic usage of IntegrationLogger and Throttle decorator."},"warnings":[{"fix":"Use async-compatible throttling or run in executor.","message":"Throttle uses wall-clock time, not async; may block event loop if used in async context.","severity":"gotcha","affected_versions":"all"},{"fix":"For advanced logging, consider using Home Assistant's homeassistant.helpers.logging or structlog.","message":"IntegrationLogger is a simple wrapper around Python logging; does not support advanced formatting like Home Assistant's custom component logger.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install integrationhelper' in the correct environment.","cause":"Library not installed in the Python environment.","error":"ModuleNotFoundError: No module named 'integrationhelper'"},{"fix":"Check the official documentation or source for correct available imports. Use 'from integrationhelper import IntegrationLogger' for common helpers.","cause":"Trying to import a symbol that does not exist in the library (e.g., a typo or outdated version).","error":"ImportError: cannot import name 'XYZ' from 'integrationhelper'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}