ucapi 0.5.1__tar.gz → 0.5.2__tar.gz

{ucapi-0.5.1 → ucapi-0.5.2}/CHANGELOG.md

@@ -11,6 +11,11 @@ _Changes in the next release_
 
 ---
 
+## v0.5.2 - 2026-01-30
+### Added
+- Add Select Entity support by @JackJPowell ([#44](https://github.com/unfoldedcircle/integration-python-library/pull/44)).
+- Add IR Emitter Entity support by @JackJPowell ([#45](https://github.com/unfoldedcircle/integration-python-library/pull/45)).
+
 ## v0.5.1 - 2025-12-19
 ### Added
 - Add binary sensor device class and common entity states enum ([#40](https://github.com/unfoldedcircle/integration-python-library/pull/40)).

{ucapi-0.5.1/ucapi.egg-info → ucapi-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ucapi
-Version: 0.5.1
+Version: 0.5.2
 Summary: Python wrapper for the Unfolded Circle Integration API
 Author-email: Unfolded Circle ApS <hello@unfoldedcircle.com>
 License: MPL-2.0

{ucapi-0.5.1 → ucapi-0.5.2}/examples/hello_integration.py

@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 """Hello world integration example. Bare minimum of an integration driver."""
+
 import asyncio
 import logging
 from typing import Any

{ucapi-0.5.1 → ucapi-0.5.2}/examples/remote.py

@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 """Remote entity integration example. Bare minimum of an integration driver."""
+
 import asyncio
 import json
 import logging

{ucapi-0.5.1 → ucapi-0.5.2}/examples/setup_flow.py

@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 """Integration setup flow example."""
+
 import asyncio
 import logging
 from typing import Any

{ucapi-0.5.1 → ucapi-0.5.2}/ucapi/__init__.py

@@ -44,6 +44,7 @@ from .cover import Cover  # noqa: F401
 from .light import Light  # noqa: F401
 from .media_player import MediaPlayer  # noqa: F401
 from .remote import Remote  # noqa: F401
+from .select import Select  # noqa: F401
 from .sensor import Sensor  # noqa: F401
 from .switch import Switch  # noqa: F401
 from .voice_assistant import VoiceAssistant  # noqa: F401

{ucapi-0.5.1 → ucapi-0.5.2}/ucapi/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.5.1'
-__version_tuple__ = version_tuple = (0, 5, 1)
+__version__ = version = '0.5.2'
+__version_tuple__ = version_tuple = (0, 5, 2)
 
-__commit_id__ = commit_id = 'g107d46634'
+__commit_id__ = commit_id = 'g08c18e023'

{ucapi-0.5.1 → ucapi-0.5.2}/ucapi/entity.py

@@ -25,6 +25,7 @@ class EntityTypes(str, Enum):
     LIGHT = "light"
     MEDIA_PLAYER = "media_player"
     REMOTE = "remote"
+    SELECT = "select"
     SENSOR = "sensor"
     SWITCH = "switch"
     IR_EMITTER = "ir_emitter"

ucapi-0.5.2/ucapi/ir_emitter.py

@@ -0,0 +1,93 @@
+"""
+IR Emitter entity definitions.
+
+:copyright: (c) 2023 by Unfolded Circle ApS.
+:license: MPL-2.0, see LICENSE for more details.
+"""
+
+from enum import Enum
+from typing import Any
+
+from .api_definitions import CommandHandler
+from .entity import Entity, EntityTypes
+
+
+class States(str, Enum):
+    """IR Emitter entity states."""
+
+    UNAVAILABLE = "UNAVAILABLE"
+    UNKNOWN = "UNKNOWN"
+    ON = "ON"
+
+
+class Features(str, Enum):
+    """IR Emitter entity features."""
+
+    SEND_IR = "send_ir"
+
+
+class Attributes(str, Enum):
+    """IR Emitter entity attributes."""
+
+    STATE = "state"
+
+
+class Commands(str, Enum):
+    """IR Emitter entity commands."""
+
+    SEND_IR = "send_ir"
+    STOP_IR = "stop_ir"
+
+
+class DeviceClasses(str, Enum):
+    """IR Emitter entity device classes."""
+
+
+class Options(str, Enum):
+    """IR Emitter entity options."""
+
+    PORTS = "ports"
+    IR_FORMATS = "ir_formats"
+
+
+class IREmitter(Entity):
+    """
+    IR Emitter entity class.
+
+    See https://github.com/unfoldedcircle/core-api/blob/main/doc/entities/entity_ir_emitter.md
+    for more information.
+    """
+
+    # pylint: disable=R0917
+    def __init__(
+        self,
+        identifier: str,
+        name: str | dict[str, str],
+        features: list[Features],
+        attributes: dict[str, Any],
+        *,
+        options: dict[str, Any] | None = None,
+        area: str | None = None,
+        cmd_handler: CommandHandler = None,
+    ):
+        """
+        Create IR Emitter instance.
+
+        :param identifier: entity identifier
+        :param name: friendly name
+        :param features: IR Emitter features
+        :param attributes: IR Emitter attributes
+        :param options: IR Emitter options
+        :param area: optional area
+        :param cmd_handler: handler for entity commands
+        """
+        super().__init__(
+            identifier,
+            name,
+            EntityTypes.IR_EMITTER,
+            features,
+            attributes,
+            options=options,
+            area=area,
+            cmd_handler=cmd_handler,
+        )

ucapi-0.5.2/ucapi/select.py

@@ -0,0 +1,88 @@
+"""
+Switch entity definitions.
+
+:copyright: (c) 2023 by Unfolded Circle ApS.
+:license: MPL-2.0, see LICENSE for more details.
+"""
+
+from enum import Enum
+from typing import Any
+
+from .api_definitions import CommandHandler
+from .entity import Entity, EntityTypes
+
+
+class States(str, Enum):
+    """Select entity states."""
+
+    UNAVAILABLE = "UNAVAILABLE"
+    UNKNOWN = "UNKNOWN"
+    ON = "ON"
+
+
+class Features(str, Enum):
+    """Select entity features."""
+
+
+class Attributes(str, Enum):
+    """Select entity attributes."""
+
+    STATE = "state"
+    CURRENT_OPTION = "current_option"
+    OPTIONS = "options"
+
+
+class Commands(str, Enum):
+    """Select entity commands."""
+
+    SELECT_OPTION = "select_option"
+    SELECT_FIRST = "select_first"
+    SELECT_LAST = "select_last"
+    SELECT_NEXT = "select_next"
+    SELECT_PREVIOUS = "select_previous"
+
+
+class DeviceClasses(str, Enum):
+    """Select entity device classes."""
+
+
+class Options(str, Enum):
+    """Select entity options."""
+
+
+class Select(Entity):
+    """
+    Select entity class.
+
+    See https://github.com/unfoldedcircle/core-api/blob/main/doc/entities/entity_select.md
+    for more information.
+    """
+
+    # pylint: disable=R0917
+    def __init__(
+        self,
+        identifier: str,
+        name: str | dict[str, str],
+        attributes: dict[str, Any],
+        *,
+        area: str | None = None,
+        cmd_handler: CommandHandler = None,
+    ):
+        """
+        Create select-entity instance.
+
+        :param identifier: entity identifier
+        :param name: friendly name
+        :param attributes: select attributes
+        :param area: optional area
+        :param cmd_handler: handler for entity commands
+        """
+        super().__init__(
+            identifier,
+            name,
+            EntityTypes.SELECT,
+            [],
+            attributes,
+            area=area,
+            cmd_handler=cmd_handler,
+        )

{ucapi-0.5.1 → ucapi-0.5.2/ucapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ucapi
-Version: 0.5.1
+Version: 0.5.2
 Summary: Python wrapper for the Unfolded Circle Integration API
 Author-email: Unfolded Circle ApS <hello@unfoldedcircle.com>
 License: MPL-2.0

{ucapi-0.5.1 → ucapi-0.5.2}/ucapi.egg-info/SOURCES.txt

@@ -30,9 +30,11 @@ ucapi/climate.py
 ucapi/cover.py
 ucapi/entities.py
 ucapi/entity.py
+ucapi/ir_emitter.py
 ucapi/light.py
 ucapi/media_player.py
 ucapi/remote.py
+ucapi/select.py
 ucapi/sensor.py
 ucapi/switch.py
 ucapi/ui.py