pyControl4 1.2.0__tar.gz → 1.3.0__tar.gz

{pycontrol4-1.2.0 → pycontrol4-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pyControl4
-Version: 1.2.0
+Version: 1.3.0
 Summary: Python 3 asyncio package for interacting with Control4 systems
 Home-page: https://github.com/lawtancool/pyControl4
 Author: lawtancool
@@ -15,6 +15,16 @@ Requires-Dist: aiohttp
 Requires-Dist: xmltodict
 Requires-Dist: python-socketio-v4
 Requires-Dist: websocket-client
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # pyControl4
 [![PyPI version](https://badge.fury.io/py/pyControl4.svg)](https://badge.fury.io/py/pyControl4)[![Downloads](https://pepy.tech/badge/pycontrol4)](https://pepy.tech/project/pycontrol4)

{pycontrol4-1.2.0 → pycontrol4-1.3.0}/pyControl4/alarm.py

@@ -1,5 +1,4 @@
-"""Controls Control4 security panel and contact sensor (door, window, motion) devices.
-"""
+"""Controls Control4 security panel and contact sensor (door, window, motion) devices."""
 
 import json
 from pyControl4 import C4Entity

{pycontrol4-1.2.0 → pycontrol4-1.3.0}/pyControl4/blind.py

@@ -1,5 +1,4 @@
-"""Controls Control4 blind devices.
-"""
+"""Controls Control4 blind devices."""
 
 from pyControl4 import C4Entity
 

pycontrol4-1.3.0/pyControl4/climate.py

@@ -0,0 +1,109 @@
+"""Controls Control4 Climate Control devices."""
+
+from pyControl4 import C4Entity
+
+
+class C4Climate(C4Entity):
+    # ------------------------
+    # HVAC and Fan States
+    # ------------------------
+
+    async def getHVACState(self):
+        """Returns the current HVAC state (e.g., on/off or active mode)."""
+        return await self.director.getItemVariableValue(self.item_id, "HVAC_STATE")
+
+    async def getFANState(self):
+        """Returns the current power state of the fan (True=on, False=off)."""
+        return await self.director.getItemVariableValue(self.item_id, "FAN_STATE")
+
+    # ------------------------
+    # Mode Getters
+    # ------------------------
+
+    async def getHVACMode(self):
+        """Returns the currently active HVAC mode."""
+        return await self.director.getItemVariableValue(self.item_id, "HVAC_MODE")
+
+    async def getHVACModes(self):
+        """Returns a list of supported HVAC modes."""
+        return await self.director.getItemVariableValue(self.item_id, "HVAC_MODES_LIST")
+
+    async def getFANMode(self):
+        """Returns the currently active fan mode."""
+        return await self.director.getItemVariableValue(self.item_id, "FAN_MODE")
+
+    async def getFANModes(self):
+        """Returns a list of supported fan modes."""
+        return await self.director.getItemVariableValue(self.item_id, "FAN_MODES_LIST")
+
+    # ------------------------
+    # Setpoint Getters
+    # ------------------------
+
+    async def getCoolSetpointF(self):
+        """Returns the cooling setpoint temperature in Fahrenheit."""
+        return await self.director.getItemVariableValue(self.item_id, "COOL_SETPOINT_F")
+
+    async def getHeatSetpointF(self):
+        """Returns the heating setpoint temperature in Fahrenheit."""
+        return await self.director.getItemVariableValue(self.item_id, "HEAT_SETPOINT_F")
+
+    # ------------------------
+    # Sensor Readings
+    # ------------------------
+
+    async def getHumidity(self):
+        """Returns the current humidity percentage."""
+        return await self.director.getItemVariableValue(self.item_id, "HUMIDITY")
+
+    async def getCurrentTemperature(self):
+        """Returns the current ambient temperature in Fahrenheit."""
+        return await self.director.getItemVariableValue(self.item_id, "TEMPERATURE_F")
+
+    # ------------------------
+    # Setters / Commands
+    # ------------------------
+
+    async def setTemperature(self, temp):
+        """Sets the cooling setpoint temperature in Fahrenheit."""
+        await self.setCoolSetpoint(temp)  # Delegates to the proper method
+
+    async def setCoolSetpoint(self, temp):
+        """Sets the cooling setpoint temperature in Fahrenheit."""
+        await self.director.sendPostRequest(
+            f"/api/v1/items/{self.item_id}/commands",
+            "SET_SETPOINT_COOL",
+            {"FAHRENHEIT": temp},
+        )
+
+    async def setHeatSetpoint(self, temp):
+        """Sets the heating setpoint temperature in Fahrenheit."""
+        await self.director.sendPostRequest(
+            f"/api/v1/items/{self.item_id}/commands",
+            "SET_SETPOINT_HEAT",
+            {"FAHRENHEIT": temp},
+        )
+
+    async def setHvacMode(self, mode):
+        """Sets the HVAC operating mode (e.g., heat, cool, auto)."""
+        await self.director.sendPostRequest(
+            f"/api/v1/items/{self.item_id}/commands",
+            "SET_MODE_HVAC",
+            {"MODE": mode},
+        )
+
+    async def setFanMode(self, mode):
+        """Sets the fan operating mode (e.g., auto, on, circulate)."""
+        await self.director.sendPostRequest(
+            f"/api/v1/items/{self.item_id}/commands",
+            "SET_MODE_FAN",
+            {"MODE": mode},
+        )
+
+    async def setPreset(self, preset):
+        """Applies a predefined climate preset by name."""
+        await self.director.sendPostRequest(
+            f"/api/v1/items/{self.item_id}/commands",
+            "SET_PRESET",
+            {"NAME": preset},
+        )

{pycontrol4-1.2.0 → pycontrol4-1.3.0}/pyControl4/director.py

@@ -1,5 +1,5 @@
 """Handles communication with a Control4 Director, and provides functions for
-   getting details about items on the Director.
+getting details about items on the Director.
 """
 
 import aiohttp
@@ -134,7 +134,7 @@ class C4Director:
             `item_id` - The Control4 item ID.
         """
         return await self.sendPostRequest(
-            "/api/v1/items/{}/commands".format(item_id), "GET_SETUP", "{}", False
+            "/api/v1/items/{}/commands".format(item_id), "GET_SETUP", {}, False
         )
 
     async def getItemVariables(self, item_id):

pycontrol4-1.3.0/pyControl4/fan.py

@@ -0,0 +1,81 @@
+"""Controls Control4 Fan devices."""
+
+from pyControl4 import C4Entity
+
+
+class C4Fan(C4Entity):
+    # ------------------------
+    # Fan State Getters
+    # ------------------------
+
+    async def getState(self):
+        """
+        Returns the current power state of the fan.
+
+        Returns:
+            bool: True if the fan is on, False otherwise.
+        """
+        value = await self.director.getItemVariableValue(self.item_id, "IS_ON")
+        return bool(value)
+
+    async def getSpeed(self):
+        """
+        Returns the current speed of the fan controller.
+
+        Valid speed values:
+            0 - Off
+            1 - Low
+            2 - Medium
+            3 - Medium High
+            4 - High
+
+        Note:
+            Only valid for fan controllers. On non-dimmer switches,
+            use `getState()` instead.
+
+        Returns:
+            int: Current fan speed (0–4).
+        """
+        value = await self.director.getItemVariableValue(self.item_id, "CURRENT_SPEED")
+        return int(value)
+
+    # ------------------------
+    # Fan Control Setters
+    # ------------------------
+
+    async def setSpeed(self, speed: int):
+        """
+        Sets the fan speed or turns it off.
+
+        Parameters:
+            speed (int): Fan speed level:
+                0 - Off
+                1 - Low
+                2 - Medium
+                3 - Medium High
+                4 - High
+        """
+        await self.director.sendPostRequest(
+            f"/api/v1/items/{self.item_id}/commands",
+            "SET_SPEED",
+            {"SPEED": speed},
+        )
+
+    async def setPreset(self, preset: int):
+        """
+        Sets the fan's preset speed — the speed used when the fan is
+        turned on without specifying speed.
+
+        Parameters:
+            preset (int): Preset fan speed level:
+                0 - Off
+                1 - Low
+                2 - Medium
+                3 - Medium High
+                4 - High
+        """
+        await self.director.sendPostRequest(
+            f"/api/v1/items/{self.item_id}/commands",
+            "DESIGNATE_PRESET",
+            {"PRESET": preset},
+        )

{pycontrol4-1.2.0 → pycontrol4-1.3.0}/pyControl4/light.py

@@ -1,5 +1,4 @@
-"""Controls Control4 Light devices.
-"""
+"""Controls Control4 Light devices."""
 
 from pyControl4 import C4Entity
 

{pycontrol4-1.2.0 → pycontrol4-1.3.0}/pyControl4/relay.py

@@ -1,5 +1,4 @@
-"""Controls Control4 Relay devices. These can include locks, and potentially other types of devices.
-"""
+"""Controls Control4 Relay devices. These can include locks, and potentially other types of devices."""
 
 from pyControl4 import C4Entity
 

{pycontrol4-1.2.0 → pycontrol4-1.3.0}/pyControl4/room.py

@@ -1,5 +1,4 @@
-"""Controls Control4 Room devices.
-"""
+"""Controls Control4 Room devices."""
 
 from pyControl4 import C4Entity
 

{pycontrol4-1.2.0 → pycontrol4-1.3.0}/pyControl4.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pyControl4
-Version: 1.2.0
+Version: 1.3.0
 Summary: Python 3 asyncio package for interacting with Control4 systems
 Home-page: https://github.com/lawtancool/pyControl4
 Author: lawtancool
@@ -15,6 +15,16 @@ Requires-Dist: aiohttp
 Requires-Dist: xmltodict
 Requires-Dist: python-socketio-v4
 Requires-Dist: websocket-client
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # pyControl4
 [![PyPI version](https://badge.fury.io/py/pyControl4.svg)](https://badge.fury.io/py/pyControl4)[![Downloads](https://pepy.tech/badge/pycontrol4)](https://pepy.tech/project/pycontrol4)

{pycontrol4-1.2.0 → pycontrol4-1.3.0}/pyControl4.egg-info/SOURCES.txt

@@ -5,8 +5,10 @@ pyControl4/__init__.py
 pyControl4/account.py
 pyControl4/alarm.py
 pyControl4/blind.py
+pyControl4/climate.py
 pyControl4/director.py
 pyControl4/error_handling.py
+pyControl4/fan.py
 pyControl4/light.py
 pyControl4/relay.py
 pyControl4/room.py

{pycontrol4-1.2.0 → pycontrol4-1.3.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r") as fh:
 
 setuptools.setup(
     name="pyControl4",  # Replace with your own username
-    version="1.2.0",
+    version="1.3.0",
     author="lawtancool",
     author_email="contact@lawrencetan.ca",
     description="Python 3 asyncio package for interacting with Control4 systems",