From d16a1603f1d86ab649b8b83c2a0f83677ec782ab Mon Sep 17 00:00:00 2001
From: Xavier Moreno <xaviml.93@gmail.com>
Date: Mon, 25 Apr 2022 22:39:01 +0200
Subject: [PATCH 1/3] feat(integration): add shelly and shellyforhass
 integrations

related to #441
---
 .vscode/settings.json                         |  3 +-
 apps/controllerx/cx_core/controller.py        | 16 +++++
 .../controllerx/cx_core/integration/shelly.py | 25 ++++++++
 .../cx_core/integration/shellyforhass.py      | 27 ++++++++
 docs/docs/start/integrations.md               | 10 ++-
 .../cx_core/integration/integration_test.py   |  2 +
 .../cx_core/integration/shelly_test.py        | 62 +++++++++++++++++++
 .../cx_core/integration/shellyforhass_test.py | 56 +++++++++++++++++
 tests/unit_tests/cx_devices/devices_test.py   |  2 +
 9 files changed, 200 insertions(+), 3 deletions(-)
 create mode 100644 apps/controllerx/cx_core/integration/shelly.py
 create mode 100644 apps/controllerx/cx_core/integration/shellyforhass.py
 create mode 100644 tests/unit_tests/cx_core/integration/shelly_test.py
 create mode 100644 tests/unit_tests/cx_core/integration/shellyforhass_test.py

diff --git a/.vscode/settings.json b/.vscode/settings.json
index e2bcb022..a78e89a3 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -16,6 +16,5 @@
     "editor.codeActionsOnSave": {
       "source.organizeImports": true
     }
-  },
-  "python.analysis.completeFunctionParens": true
+  }
 }
diff --git a/apps/controllerx/cx_core/controller.py b/apps/controllerx/cx_core/controller.py
index 825e3fdd..e2c2bf0b 100644
--- a/apps/controllerx/cx_core/controller.py
+++ b/apps/controllerx/cx_core/controller.py
@@ -586,5 +586,21 @@ def get_homematic_actions_mapping(self) -> Optional[DefaultActionsMapping]:
         """
         return None
 
+    def get_shelly_actions_mapping(self) -> Optional[DefaultActionsMapping]:
+        """
+        Controllers can implement this function. It should return a dict
+        with the command that a controller can take and the functions as values.
+        This is used for Shelly support.
+        """
+        return None
+
+    def get_shellyforhass_actions_mapping(self) -> Optional[DefaultActionsMapping]:
+        """
+        Controllers can implement this function. It should return a dict
+        with the command that a controller can take and the functions as values.
+        This is used for Shelly for HASS support.
+        """
+        return None
+
     def get_predefined_actions_mapping(self) -> PredefinedActionsMapping:
         return {}
diff --git a/apps/controllerx/cx_core/integration/shelly.py b/apps/controllerx/cx_core/integration/shelly.py
new file mode 100644
index 00000000..c34ccc74
--- /dev/null
+++ b/apps/controllerx/cx_core/integration/shelly.py
@@ -0,0 +1,25 @@
+from typing import Any, Dict, Optional
+
+from appdaemon.plugins.hass.hassapi import Hass
+from cx_const import DefaultActionsMapping
+from cx_core.integration import EventData, Integration
+
+
+class ShellyIntegration(Integration):
+    name = "shelly"
+
+    def get_default_actions_mapping(self) -> Optional[DefaultActionsMapping]:
+        return self.controller.get_shelly_actions_mapping()
+
+    async def listen_changes(self, controller_id: str) -> None:
+        await Hass.listen_event(
+            self.controller, self.event_callback, "shelly.click", device=controller_id
+        )
+
+    async def event_callback(
+        self, event_name: str, data: EventData, kwargs: Dict[str, Any]
+    ) -> None:
+        click_type = data["click_type"]
+        channel = data["channel"]
+        action = f"{click_type}_{channel}"
+        await self.controller.handle_action(action, extra=data)
diff --git a/apps/controllerx/cx_core/integration/shellyforhass.py b/apps/controllerx/cx_core/integration/shellyforhass.py
new file mode 100644
index 00000000..a9eb5312
--- /dev/null
+++ b/apps/controllerx/cx_core/integration/shellyforhass.py
@@ -0,0 +1,27 @@
+from typing import Any, Dict, Optional
+
+from appdaemon.plugins.hass.hassapi import Hass
+from cx_const import DefaultActionsMapping
+from cx_core.integration import EventData, Integration
+
+
+class ShellyForHASSIntegration(Integration):
+    name = "shellyforhass"
+
+    def get_default_actions_mapping(self) -> Optional[DefaultActionsMapping]:
+        return self.controller.get_shellyforhass_actions_mapping()
+
+    async def listen_changes(self, controller_id: str) -> None:
+        await Hass.listen_event(
+            self.controller,
+            self.event_callback,
+            "shellyforhass.click",
+            entity_id=controller_id,
+        )
+
+    async def event_callback(
+        self, event_name: str, data: EventData, kwargs: Dict[str, Any]
+    ) -> None:
+        click_type = data["click_type"]
+        action = f"{click_type}"
+        await self.controller.handle_action(action, extra=data)
diff --git a/docs/docs/start/integrations.md b/docs/docs/start/integrations.md
index 9951a7f6..724f4d09 100644
--- a/docs/docs/start/integrations.md
+++ b/docs/docs/start/integrations.md
@@ -169,4 +169,12 @@ This integration(**`lutron_caseta`**) listens to `lutron_caseta_button_event` ev
 
 #### Homematic
 
-This integration ([**`homematic`**](https://www.home-assistant.io/integrations/homematic/)) listens to `homematic.keypress` events. It created an action like `<action_type>_<channel>`. It does not have any additional arguments.
+This integration ([**`homematic`**](https://www.home-assistant.io/integrations/homematic)) listens to `homematic.keypress` events. It creates an action like `<action_type>_<channel>`. It does not have any additional arguments.
+
+#### Shelly
+
+This integration ([**`shelly`**](https://www.home-assistant.io/integrations/shelly)) listens to `shelly.click` events. It creates an action like `<click_type>_<channel>`. It does not have any additional arguments.
+
+#### Shelly for HASS
+
+This integration ([**`shellyforhass`**](https://github.com/StyraHem/ShellyForHASS)) listens to `shellyforhass.click` events. It creates an action like `<action_type>`. It does not have any additional arguments.
diff --git a/tests/unit_tests/cx_core/integration/integration_test.py b/tests/unit_tests/cx_core/integration/integration_test.py
index e4df04d1..587ff1bf 100644
--- a/tests/unit_tests/cx_core/integration/integration_test.py
+++ b/tests/unit_tests/cx_core/integration/integration_test.py
@@ -13,4 +13,6 @@ def test_get_integrations(fake_controller: Controller) -> None:
         "mqtt",
         "lutron_caseta",
         "homematic",
+        "shelly",
+        "shellyforhass",
     }
diff --git a/tests/unit_tests/cx_core/integration/shelly_test.py b/tests/unit_tests/cx_core/integration/shelly_test.py
new file mode 100644
index 00000000..47ba16c8
--- /dev/null
+++ b/tests/unit_tests/cx_core/integration/shelly_test.py
@@ -0,0 +1,62 @@
+from typing import Any, Dict
+
+import pytest
+from appdaemon.plugins.hass.hassapi import Hass
+from cx_core.controller import Controller
+from cx_core.integration.shelly import ShellyIntegration
+from pytest_mock.plugin import MockerFixture
+
+
+@pytest.mark.parametrize(
+    "data, expected",
+    [
+        (
+            {
+                "device_id": "e09c64a22553484d804353ef97f6fcd6",
+                "device": "shellybutton1-A4C12A45174",
+                "channel": 1,
+                "click_type": "single",
+                "generation": 1,
+            },
+            "single_1",
+        ),
+        (
+            {
+                "device_id": "e09d64a22553384d8043532f97f6fcd6",
+                "device": "shellybutton1-A4C13B45274",
+                "channel": 3,
+                "click_type": "btn_down",
+                "generation": 1,
+            },
+            "btn_down_3",
+        ),
+    ],
+)
+async def test_callback(
+    fake_controller: Controller,
+    mocker: MockerFixture,
+    data: Dict[str, Any],
+    expected: str,
+) -> None:
+    handle_action_patch = mocker.patch.object(fake_controller, "handle_action")
+    shelly_integration = ShellyIntegration(fake_controller, {})
+    await shelly_integration.event_callback("test", data, {})
+    handle_action_patch.assert_called_once_with(expected, extra=data)
+
+
+async def test_listen_changes(
+    fake_controller: Controller,
+    mocker: MockerFixture,
+) -> None:
+    controller_id = "controller_id"
+    listen_event_mock = mocker.patch.object(Hass, "listen_event")
+    shelly_integration = ShellyIntegration(fake_controller, {})
+
+    await shelly_integration.listen_changes(controller_id)
+
+    listen_event_mock.assert_called_once_with(
+        fake_controller,
+        shelly_integration.event_callback,
+        "shelly.click",
+        device=controller_id,
+    )
diff --git a/tests/unit_tests/cx_core/integration/shellyforhass_test.py b/tests/unit_tests/cx_core/integration/shellyforhass_test.py
new file mode 100644
index 00000000..cd48d612
--- /dev/null
+++ b/tests/unit_tests/cx_core/integration/shellyforhass_test.py
@@ -0,0 +1,56 @@
+from typing import Any, Dict
+
+import pytest
+from appdaemon.plugins.hass.hassapi import Hass
+from cx_core.controller import Controller
+from cx_core.integration.shellyforhass import ShellyForHASSIntegration
+from pytest_mock.plugin import MockerFixture
+
+
+@pytest.mark.parametrize(
+    "data, expected",
+    [
+        (
+            {
+                "entity_id": "binary_sensor.shelly_shbtn_1_xxxxxx_switch",
+                "click_type": "single",
+            },
+            "single",
+        ),
+        (
+            {
+                "entity_id": "binary_sensor.shelly_shbtn_1_xxxxxx_switch",
+                "click_type": "double",
+            },
+            "double",
+        ),
+    ],
+)
+async def test_callback(
+    fake_controller: Controller,
+    mocker: MockerFixture,
+    data: Dict[str, Any],
+    expected: str,
+) -> None:
+    handle_action_patch = mocker.patch.object(fake_controller, "handle_action")
+    shellyforhass_integration = ShellyForHASSIntegration(fake_controller, {})
+    await shellyforhass_integration.event_callback("test", data, {})
+    handle_action_patch.assert_called_once_with(expected, extra=data)
+
+
+async def test_listen_changes(
+    fake_controller: Controller,
+    mocker: MockerFixture,
+) -> None:
+    controller_id = "controller_id"
+    listen_event_mock = mocker.patch.object(Hass, "listen_event")
+    shellyforhass_integration = ShellyForHASSIntegration(fake_controller, {})
+
+    await shellyforhass_integration.listen_changes(controller_id)
+
+    listen_event_mock.assert_called_once_with(
+        fake_controller,
+        shellyforhass_integration.event_callback,
+        "shellyforhass.click",
+        entity_id=controller_id,
+    )
diff --git a/tests/unit_tests/cx_devices/devices_test.py b/tests/unit_tests/cx_devices/devices_test.py
index a186853d..24067cc9 100644
--- a/tests/unit_tests/cx_devices/devices_test.py
+++ b/tests/unit_tests/cx_devices/devices_test.py
@@ -64,6 +64,8 @@ def test_devices(device_class: Type[Controller]) -> None:
         device.get_lutron_caseta_actions_mapping,
         device.get_state_actions_mapping,
         device.get_homematic_actions_mapping,
+        device.get_shelly_actions_mapping,
+        device.get_shellyforhass_actions_mapping,
     ]
     for func in integration_mappings_funcs:
         mappings = func()

From 3a4682aca020d8f4ac78f648e748223d32aa7256 Mon Sep 17 00:00:00 2001
From: Xavier Moreno <xaviml.93@gmail.com>
Date: Fri, 13 May 2022 22:55:39 +0200
Subject: [PATCH 2/3] feat(device): add shelly devices for shelly and
 shellyforhass integrations

related to #441
---
 apps/controllerx/controllerx.py               |   1 +
 apps/controllerx/cx_devices/shelly.py         |  47 ++++++++++++++++++
 docs/docs/assets/controllers/Shelly25.jpeg    | Bin 0 -> 16467 bytes
 docs/docs/assets/controllers/ShellyI3.jpeg    | Bin 0 -> 20661 bytes
 .../docs/assets/controllers/ShellyPlusI4.jpeg | Bin 0 -> 20056 bytes
 docs/main.py                                  |  10 ++++
 6 files changed, 58 insertions(+)
 create mode 100644 apps/controllerx/cx_devices/shelly.py
 create mode 100644 docs/docs/assets/controllers/Shelly25.jpeg
 create mode 100644 docs/docs/assets/controllers/ShellyI3.jpeg
 create mode 100644 docs/docs/assets/controllers/ShellyPlusI4.jpeg

diff --git a/apps/controllerx/controllerx.py b/apps/controllerx/controllerx.py
index eae0fe81..354107ca 100644
--- a/apps/controllerx/controllerx.py
+++ b/apps/controllerx/controllerx.py
@@ -24,6 +24,7 @@
 from cx_devices.rgb_genie import *
 from cx_devices.robb import *
 from cx_devices.sengled import *
+from cx_devices.shelly import *
 from cx_devices.smartthings import *
 from cx_devices.sonoff import *
 from cx_devices.terncy import *
diff --git a/apps/controllerx/cx_devices/shelly.py b/apps/controllerx/cx_devices/shelly.py
new file mode 100644
index 00000000..aa1fc35d
--- /dev/null
+++ b/apps/controllerx/cx_devices/shelly.py
@@ -0,0 +1,47 @@
+from cx_const import DefaultActionsMapping, Light
+from cx_core import LightController
+
+
+class ShellyI3LightController(LightController):
+    def get_shellyforhass_actions_mapping(self) -> DefaultActionsMapping:
+        return {
+            "single": Light.CLICK_BRIGHTNESS_UP,
+            "long": Light.CLICK_BRIGHTNESS_DOWN,
+            "double": Light.ON_FULL_BRIGHTNESS,
+        }
+
+
+class ShellyPlusI4LightController(LightController):
+    def get_shelly_actions_mapping(self) -> DefaultActionsMapping:
+        return {
+            "single_push_1": Light.ON,
+            "long_push_1": Light.HOLD_COLOR_UP,
+            "btn_up_1": Light.RELEASE,
+            "double_push_1": Light.ON_FULL_COLOR_TEMP,
+            "single_push_2": Light.OFF,
+            "long_push_2": Light.HOLD_COLOR_DOWN,
+            "btn_up_2": Light.RELEASE,
+            "double_push_2": Light.ON_MIN_COLOR_TEMP,
+            "single_push_3": Light.CLICK_BRIGHTNESS_UP,
+            "long_push_3": Light.HOLD_BRIGHTNESS_UP,
+            "btn_up_3": Light.RELEASE,
+            "double_push_3": Light.ON_FULL_BRIGHTNESS,
+            "single_push_4": Light.CLICK_BRIGHTNESS_DOWN,
+            "long_push_4": Light.HOLD_BRIGHTNESS_DOWN,
+            "btn_up_4": Light.RELEASE,
+            "double_push_4": Light.ON_MIN_BRIGHTNESS,
+        }
+
+
+class Shelly25LightController(LightController):
+    def get_shelly_actions_mapping(self) -> DefaultActionsMapping:
+        return {
+            "single_push_1": Light.ON,
+            "long_push_1": Light.HOLD_BRIGHTNESS_UP,
+            "btn_up_1": Light.RELEASE,
+            "double_push_1": Light.ON_FULL_BRIGHTNESS,
+            "single_push_2": Light.OFF,
+            "long_push_2": Light.HOLD_BRIGHTNESS_DOWN,
+            "btn_up_2": Light.RELEASE,
+            "double_push_2": Light.ON_MIN_BRIGHTNESS,
+        }
diff --git a/docs/docs/assets/controllers/Shelly25.jpeg b/docs/docs/assets/controllers/Shelly25.jpeg
new file mode 100644
index 0000000000000000000000000000000000000000..939f0935485169a4ec2ff556f3b16aaa94e51212
GIT binary patch
literal 16467
zcmeIZbzD_lw?De*ZjhEumvnbYcXw>MyAkP>kdl^^kW?B$IwV9|5NQ+;1SCb`u8ls=
z``mNh-}&6%`S-qa@44q#bB;OI7-QyI^Sf_9-mU_;N^**F02~|~U;%!B+cmN=S$_vx
z08mt90Z;(|jM#ASfG|k8f)O7M0e}NjSR{i(x=SlSn*0x457JD3c;G>r3#^L;rmbM)
z25CYt9R#C84B}ngMUWN-g~@2iO6jO;2}A6x*&N+%>>$2e?3@rLA1?=2JBXr^JVZ%D
zRvzNZ&&~V*;^6~zcJK~>h(Uxn(P2v8N%||5S5(!2aI<r9vh#3)_vGZ}7Utv==Hh{X
z1h1elCpQ2OM5m$vQeeFcSlz;ZSp;7G9sc(kp#e9*Z|h)Q0^okrFeTysLBoSyLI8`a
z!F+^29zzDNk^eyx{h?ueaPYt7yaxH<|IqlPU;!9V?>@KxY)`NP?2fme02u%k85so`
z2^9qe1q}@q9g`3X69WU26rTWxkdln*J|!6i1%!^B5km8TmV$ywfcXI@7cVa_6{C=t
zAh#$x4=*=N2pk$38YTuN2^JO!H#G${_y2Xc?FR5rVLBne(E#vxa0qyCxBUPWs3#KG
z`(PdLPk@6*Ktw`DK}AEy02!Ka0nk$j@Q4UVNQj6acQ9BEAmSn6Q*%in6KFzFXgmnH
z!%~V+X{BHF5NS;w((zb&hNGe1BPJmwqi0}bVrJpx;};MV5|()=D<`j@sHCl<tEX>Z
zXk=w=V{2#c;OOP;<Ll=i5Eu~|6&({B7oVDzp7AU*D?6vSr1V8uc}3;R*A0zL%`L5M
z?Y({d1A{}u??$GkXJ+T-KQ1h;t#52@efhe*vwQU8_~i8L{Nm>&%r2One}&(M{TI9N
zK)c`(5fKnkV0OX5`+*Sw4-tu)3mIQZ69wu)K*Jq|N+_LD^r{DqmPhN5$kKBX{T?0f
z8vPN>v^&fGzZn+(zq0Ia!~SL0B7lhi2R0r89v}gnUosVkqW`y8T8LB}&jkD((;$9j
z*;Zz?CA;=;CpuVuuAO!XA>C1Oiy1kmt;si+ga#Pix^UGW?Wi1*kDyvuN@G9Rp|`->
z0df70`m*gTi0$F(ZM=5d-7`fqC$z^eY>6plNsGgx2sI^<?qYO(hs=77NM9Ujr`KDR
zec3@Zu8%3ZObCJTtC{OI2`jr+6Td#*B&vyvWDHtGOB`Q(K=F}t8Y{g>{S;rXkVOGa
zLc4ZMJm`0dg>W~fy4(U52v_4yWIX8ssUI?V^OKDyIvG|);*VI(V_S^kMdW$AnTN)z
zZp2UZz77$ya_ZYz1g@g*M4K9Ud{LGWFhl!zuFb-s2VWfY&Hm=3P(QkWfN$dSBZ6B%
zjFTmF#>cm9ESv{hkSjGL>*dW@%~+;Kuq9*1+m`b3<u>!-TOdk51b@fj7T{nBLAW7W
z%OuW8vwFvtcc~L6Ub_<$XK<M}FMsy%*$<w}DX|=NlAT!h*Tk20S1fsNMPAADyM~bc
zAUSa;Z6|p5CHe#*K6OK~tsSrfLJE}H19V&thP4KK#pKLm?`@a<e1OtvOBHvd%qkC;
zP``_wvj#of8Ue5dQRZ)f8hwio9kqsi1WN@sP3C8&^lT^8>-kC1A#tfCkq(w7m#iU)
zTCEpx{#I<5iPU>|u{X92I595yEfNebRFTIe!kYpfQ##AfSu4HepM4QJeBd54JtnbX
zSUz|e*&Xc^anNxKBsvY1eHs+kSuZtKATG6RN+QM~a@7j%Sa_drr`w*#l~wvUGBqTh
zes-{WKn2?%Sp8yNb*sOt7YSKGyNc<`aYHHHH#Xm}rEN4IaD2o$C0pv-tNM_9BeLLQ
znXR7<5#PS(O?EYzVZQr0<5Fc*v37hibTP}+<ANuo+?MT9{*99=P4|t|HiN{5G5@^q
zCJ@rUxYf0sk$hTRRY2%))^<$#TEydq_v4i!QEzmZCr;fhP+RgW?{jtdv8h_&MRLCe
zlRZ1+X;Kx-tBD&?R(++5h~sMEfd*qC!DAGb5E|8h*{^ZSb7IRzn<of0HXI4%IjcPn
z9viqmKkYL{lk?m%;wjEIiZk6!F4?bLdlP39F1fuF&NA?*izA889Qz`i=vCHFwQTF|
zp3Pezw60i`tBSv+&}bL?jgbvqa)0uUnV8Yz_pXfA^kcQonzBUM(qxAPi2^t%vChY-
zQN{?<k>f#~{^mom&5mTET`L4Q!}5~%o$kK~7q{$6w3n%wz(r!1SZB><<c*5|fkq`G
zN!ekv?Gcw^EEb3}Ph@Yn=!i?omQ~u>W4Thq*ZpGYNpe=ofl<!mays_fq!IbHms(D?
zth8m*3{9^J_S)lrIuC7SqBwb9p#<()P3_T3(Xh1cNll#A>c4N8+gH&pM&tS%lKIu}
zUe4?-5W{CsgShWu#~Y?2g0D~K{qCG^cg+ipRoaf;S?qfIc|yC(%jYyi+>5;>ktEf6
z^QKlSp(tifWFaIbjWrZpNh0&*S{)8oDw~NyqgKs$auSi+^-r!RP1suE>D$sqQx*kI
z-c^0s^(Ezbm(=xWc2LPFn@f;)?|tbw`e_QvItx#*bNRKW-9l8ra#iKTxn;&6j>ZsQ
z{(~0H$2UTobe>X{Qba=!T=>MbeWKG6Cp3e#W<!!Cl)_a#7rD|t_=)P%mzf7QFLC|q
ztI?fhCmoe54>O*xL)ZB^97W7*u)TToB8O8~d*boRNVz#~<7hj*NpQ&JY!8WU;m2;T
z0mBdMrlzZ&YSSx61JKBUU-}NTN{xi~Vsr!6$)EU--Xq=Pl<2L0aisSmjGA`z2EsM8
zqv6QSJ1v|feRMfXqf;fD#D8qk^y>9lbJAda(S75F7fmxcXSnNfUn|D#9CH#1V~bN_
zMDu2;aE6yn;<+V1uYAa1_ib?feEdvQ@8gn6iK^!*Ln8gycfHizAd$!nYum&mR7SoJ
z*VW`yA~PN)otLdmk}CnZ2vjo0Qc61tsJDPnW#3#*;U`K3MqUj%Mb^eh%KlT{cDiw*
z<DP<aev}=Bl<KIg1f&Ti-zTnSyUJ;K_cnG0tU|rKoTpyLC&rzUCZv76(1{;?6SDG2
zI2>EmVM+cbi|~*qO>@Y0KC@S&tL;g`<@5APY0uito+dJ1E+0MaZyE$woMD$u!TPKA
z9R(;mI|)#nn@FcEk+lL`wUS~?xQm?21IdWJMfz%k!C8s1d2H(CD!#HBLWfCNqBy9T
z$kFnr;G|56t7Gn)GT}3pW1PhLgTrdi5Ra~0df?Hq!e?fO*LiXuPYRKzqFFqdtEO{|
zfHtg+pYd($so$l~pQ!|?6<p%J{E(-{67-zDSv-yLCX%J_dXw4NM_}4bC&9bBdcd@S
z2cIi`A$)fcl}`BywTQx#ri3Wp8&k)|oYHBTGk)EVB@tl-TgK~*%rkFja+DZU=VtNV
zmuEmHn!Gueh^P9qzrxpZ&|FVFtQxKFzH$m&TuS787`Wc~06+7UotTpst(c2yZ_5F#
zYS)UG;~V1T5gno-qu`Nt`2<}141<16DQ?bgz`Kq;UueWvUO8349OoJSFv{oA5TjRg
zRhX~e^uJEHo~sJf&2DVzp?I!Xaj=&k!HpTc$2vE#_LW6bxoA|WR44m6p0%4m8M4Pm
zt!)n;Q)PB>Ej0<FhI_f9^)5XRMY*66@zc#M%J#jG9d)G0biSwhFQ3N_cWINq`<8dp
zWaeB=u45}tt`ju3KbvF9j>fXGTujac5t*1^JWnRMV$n0XE=dc-`BZC6#G6at<SY}s
zjvYcVtK6#M$AY7hW^5~KR*kZu**Qj=x*dXNs(W}+mYVi)BwvwXk;ig+`MXb!4J%=Y
z`~5FX^kHT=9EFrD_hu|9>`p3-bu{x|I_j#33I15}tz`6gwd2}7L>EiT$mp<nlTk$B
zfFC6Z9~Krr>Y}E%&85+~H$HoGfj(g6e$p7GmZ<pMaoi2D`o1h;yq7Av9FbCmW;apz
zJf`|MH6OW3=lc+{5yL$FKKwb-QyZeDXR40tYngZ=?oQwGS-vm+=w)WJF{Gsp$9CG{
zXpGvK>Lg#g*XjF6h9UP0k1;R(+5I8U<XxxXytdMXnT(8NpW-lOEzUZzivi;7Rppo=
zrgyhMQB5F`$1OnMax=N=w0W`^a<poXu+?szSAy=oqi_p&e?U}BEzZ~Mf2`g=lMcKB
zmms58K2rocEFr?xG3TRt>=WOg-U7{C?_W~k6MWpi_nEOF_7=D|aHA_NLTa=h8(TkA
zK~&_#g2BYycWrbFumsG|CRmLTo#6MaeRWXGV=0}BjThskTXtS0-s^l;iv(C!ye+@)
z$^AHkV7L52|G4HJO%%QLyE7lU?~{(}Bjjnvn<4EU+I0LMh9Z-{+#FNn47<qr?u2Rb
zjg6n@&5OP|A?VO7udg^4P>C%$Ku`R>rdD^UhvzBJ_H!D8sk%Hz;&pryk&o@DV~Q1A
z-2J>6wwED3tW3kjS#}7WUdr6nXKc{bME;pF32!)!rlq0kn8WI056$e4bNB<Z&-Ny@
z;<wEmvQAUFgcF9}w!M_o<DJ?(=X+Ag_=ZiE?MbwIW1m-i)qE$t?4W@FN)uO^m8RAQ
z_)M$iG`jQRcmONVuE*H)hPkzsHmb#D;tCBbAR~yX2jkIo`^Ja#>wBSM&m$CswLZWZ
zh;zm4-@o@Zne->xRaIa^)66liGPrP+v0WtskNoA(2nYH2diUB=f=S{-PYaR5!orjl
znC;=T;Ux{+SsfAMW=(+L1_M?72keFvm7*HRSB2c+<Rp|l8t%d=x<=d2Gw`y<1sDdb
z&6mTorkTF8#QBQtaH|LEle*L*2To%Rz0fZXrQ_i$169wJ1rT#oyp&}DLQPqKp0H5^
zUTacO5<^jz4R)0d=(k_th1Ny|FjED(N>G~-nae(+ZvG*9KRNld=FQJ|;N)(bURB9{
z&Ak(B>9*-OE9?1Y-_~4*_M{LesY&NYlM}e}e8ZDGSMj{5X+5^1fXMOH#`n((5=R>b
z<uw4W))aPQBQRIKSg_p0RXNx7EfFv$)QVREjF@=SfyVSk4LDiCKanVKNN&bQu=Lr~
zl%Zv^$Y+hGU0NuefM#*KG8NK_={C<dEILhN*_7i{G)T%$QgK@&gwv8I91CEdBiX1^
z+HtvpTgRwjZbEE;qE|jHDSRLFOE=dI-{G9>?Q^$Pn}+5d8_l$p<hf26<s+S(sOL3R
z!#8qC_36!qfa#DeHqZPQ@NWKiiF4Wnn1Uh-Cw#j(5)oHCW&VNl+H+gkWjXYjBlPG$
z#L$1;KmFQZY-Z{>5rmaDPB}38juh2>h2Nd^lPGhI<FvujP>n;4m6Z$jtV5W|#{EKH
z@kY4SOcw$(B@2?+SBqjV$r>IHUncg+pJOJ-f7Klah)&M?vP6>+cQ$5W%hVSHa|3@Z
zs)h^45gM*0FvlLjG4)wIz)YS&yZG!W==yZg5S+A)L<1|hT5GqfNAsM$Z$jcdP&>SQ
zxz1m&<TiOc5G+I;U?bE(Fwm~K1?J*$lpyPxlEga>BH+^xm=C9@EICSnZI9sAw@ftC
zp~yp@7xG5Ei`E_ZI=}7IT7Mx!w1gef{9!nc6L%9~C;xQniVjzKjXak#j9mwhy89ib
zImI<=OoOWB{NS;_<NF`>HJhzZpC%`)Qr$3w^6+)RnQoJzJNo&d3$*Gc+rN7s@IJVc
zHBG}XyyAhnBvLTdx&&rOujb1>C(p4Qm-?lV7^Ga<`<-$7CPR^rNK2IK9OpIrzRK82
z%Tk0Xd_G1P6w?b84c*BJ@3nOz52HFCQ%#;A`sT}79{rdwmH3)fYlIy|BpU~u5RK3A
zOy3nPEl$`GvOXBX96>J)K*U7YkAHte94pGy1(ok4khScYTBc1L<4FkTTKa&{q$(&|
zxV=mirS`35g$o4{;$wSFabC&Wg}8lYMprP>z<{AZocRv(tLO8sD7%l3q?+bC^c`~^
z7c^@|;j4u{?P3y95Y;PBzS3ogDjX+#Q13`EEKSmb;<_sJJ}BV>O7_ylV;A{BW4EhZ
zrt<3zBnw{-wb1y3E17jF<b{hzJFLvUN&GsA2w|-W39A-AoCa#^zz<naRUAV`dqZAM
zU6Pk1<>#-->twe1PSElp^2NMNL6KI3UvFpC%`W0<oaSnrXz4gxmJJ4{0?&zt!AWR2
zo~aN;E?N;jNwKc3ng-WU7WW3voay2*oKKyRq@2vF8@ablYPdL#fDb(zA)qM>ZfZUq
zJ>y^<G8|fN!MX*KI|Fv=bS}QS>JRX@kgU~cN>ILc8s(D2yWgl)|0OjPo%R+mVJen5
zEe_>KO4oo*eBd}nz6ByW#NW~#A@Xx8zNS5o6+PkGxnWFvM7n9TO-B065bpX%M9=<B
zaMcj+XSD-`PUSa3kJ{3TYF~!Lo6$TMtDW22Amw7dNr(G<!T;s_p{lys(SuP}S6$K8
zEo$SfWv+0P^C&N2s)UoO5YpYi)9o~;yzZCCfzKDtYst0e`6$g)=l!$<Z&oddf9x2}
z!0oUe`JRc4R^AN14#<-ueN}Ja@iTs)>msGjw1ke}I){HZo~SFUR)Vk*PHc96d@ou#
zTO~=IE>t2zN|q4V-txCLq;;t+hg@oxKR3=+X=w91r70;6#g8{)f@8Lay~HRj#7^#Z
z|9K-YO?&El3w$7ZTV|GV?AQB5U1IR;^;rzt&v4cqGH|y0{l-I7d81L#3GL_|wbuoo
ze@~sy#r{3-AT%+?p&MbR-U_(n#auPl@LWkGw3|jv1&KMF8o(YqJRapUp$7aUsFLP?
ziRoHX8gR;B>#>1vG|(2~jg)|sTOhn1O;pN{`UbU!DnDp8K)$C2etl$cLnq(2W@wZ|
zY#v=|=fJE^5+jG1>F%8i!kD;#%ol$x6ohM&PhBed6MQEJ1IEl8kBGc!rS~ErI2CnS
zhw_?|c&fe06~%Ee!{WtHy$g{FgV$uKcfq+W`0@6o))eCsm6FfhLIYcD{u${B!Ie~N
z3idN83lPm-;Pg&iq?sftaW=<AD0~$BE_uzG_v&@7MrZUK65E4XJjqi=s=2qhhx*YL
zhs$x8OrdJKWP082!~(&&MPQ%JvY{zynFxczkx25aa)(P<5>5HHU*HJqONXseWN3Ym
zI|SA_de0iU9dmdCo{*QuhM)pJfcwjx-#+goleK49po)R3u^|gyIy4#uQOCjpTnXha
zOj=mkt4anRb~L774f(0%2Y>4;3s(*>V%AK3NXK2@gBYZNz>K4*tPrGubRq$Ei^`PX
zo|E#szW=Xv?639gPpX8(X!NZEVU6*Kzp?nC+iTge#E6Lff_@E@fWyq5Vy5V}0Fvb;
zX&mVDPBFbsfAsie#Fi+_IO*a9fW;AD0{0&Oj804zQb5EEo|((WMATXPiI$neWT`+&
z9!n_I^PsS$`4>}`q2fF<CspG#J2iC{_N8V+SB@z==K2?X-Ispxdn4l{%1^}=(=j6=
zmLi7uj$`6G=qoOau2<hA{Cs%xU2Tk0Vlb3@O(;R9iI8e{K>5$RvcKM${grBIz<*#q
zdU&jW&-Y-ckZ57s9Fy;}^@C*G=Ez%sB7ZQrL6V}Zz>2>l7^@W3NRb>szjW$(OB&N>
z^gwSU;=Ki|Ih}!!3~PUxwWgS8JLMMN=X*FEAF0()1%FC?cWOr<1kjC`3gN+t3_hOc
z|J|R6GHdMhjP@g+Wxhg@*MfUTa=zZgREU!=YI@kB`5{L+QCx_<h9|$GdaOj$9i_Dv
zF<MJEy$ZW9f$SHV!kjG2E~&bPoK&5}QB3c(h^b!dYu%=fAte1Ru^?;g6S(7XqMDiu
zJDtPpQJEm;Rh$h37XMQ!qj&!teTqmO=W6(<)+xy(vJ9cL#cxb;)}lMBky6%w@v>d1
zhs)oOj4&%He8e#6U1sRo;KzLq3Hxas4;+4G?F(#vz1ytEGhBLoL_kCpOSD6V(-UWd
zH(IsiJp3+6qWn>))5m>hHs`1GO&ywW*Zl}Tb@PHWkddFP?h{LEo{8}3Q<^kT+*n`g
z{U|gGg;V=??^6Fuo-_}*1+?337fWieKbxQ1Vd13xqM>kU+hI3Ig~smu=+ii1<D?zK
zJzCZYS71ouMNkcr6vYRWA@0FLrAehXrfR4sW%JYGEEgd!E;7jEWr!vm^y@<UIs?4T
zk$t8s0@V5Hn^7_`7ly8n<AG!6^(OBE?A`WHQT2@uZzFNOIDO{DiM(V_*Hg}Ls+7Mv
z5yNTbG97QqyO;7nLk^EP6bbPE9&>2;`I)KN-pli(2MCuDW|<}aA`d4CF_f8Fl7HF{
zzv<#ca<hCEN=AqctmpriS@55;qL$X=zwNT90VS~QujR9UzGD9OG{Wt|?HZ<^y|=f!
zFb9XL7dzD2&C-V5%FTttAL`Blo-c6#q7we@P%9@JZ-}Lhor9|w&B2>48i<3n7>z!k
zDyOQujE%j6LZGLOcA%P$RiKlVkTs2jI7HN6*x$w7#l{;7@po}{^%C|Mqq!3<4AQV{
z4jRZEi?@>)jRANZCFAC41L0-oW#?oA57&ITX+RmC*0#c059R(y0I$So{;2Bb=g02H
z!|vv3$H65eB*ekV&B4vh26C`@1-N=c{n=c-X#bM%(8kNk)4|=_!Oax{lL)nR^YIp=
z0q_4?F&B4L)xQP*TOYW%z_h*N_VSkX1uOqg9`n)(aJS*mvhi~B@wBp$^|f*Jrv0nB
zwbkEs-F-Zr?+mcE;;?bHaRJ%9K#z0%eJj{0-QV0WgY6t#-0y0Dp8cB(r2l66x5~qA
z4O%Gt(9OyRb`!;iVl*&G!q#q94%WhVBsV9gwSW~551Wm(jWrvu4Id|)kf4<S8;=c_
z4W}*C%2E)@{g)g?S1)g<tCbB*4k(%30TjYxCBP3A5VT<vvgPAu<K^WNWV3{VjbY0V
zwY20B;^u@3@%>d_-O~Z=Mo{N}>I0Kw4a$LXTk~)UadWX*gX*yHa#``P3G(t=u?cc<
z@$lIQ3E6OR^3Xu6t%T*=JYAq*J2<#N?QA$;r=c_un7@RjG!(^XxY;@XTxvK&y=_5W
zF&Y&IS0DdBxjGImHrn1$nCH0o`M7xncm)Od__+DNgU~-5dN!V3V1I#$x;rJkQ(joc
z(+2A8=BeZ6<}60@_aQ2*pZ#{Rf`b=W9Pp>-YTJ1Hp`0Bccl|~fY6a_sVl-Y*UmI(h
zKbcncP**z}a6Ex+`kT$+-?*5Q$Hvx5KuCy<n+qz$#tUAtLHW6P*aWyOZ8@!=f|f!8
ze@paov-S3adfG_Yf$a@y3byv$aW91F&I`<c-N(<~24*5?HXA1&8yAnxpYvZnR!;Cl
zn3IMB)Sm-3WPY2%@n5aHEBnXr`imVLvoP}SDL@?ZpYR_K{Ko_T@xXsP@E;HS#{>WW
z^T59zB5Yj2osJ*)h;X|OU#}=5W3Hj4E~ls>3j)7D&{m<dm5Uc52ugEt_4d?~mxh2C
zBnZkE00~6M5ds_lE7Z!%T}nek<u4@Ee^1ZmV4yAlm}Y~?`tRlcV-A)z_^<#Xs30Jh
zq?Nm;H%ME6G{2v>JB-c(X+m(rW)0HSApO7-R1l;;!tyPD(|a)5?v94R`v5{u9W5Eq
zHW;oCV)qZ)@*lL7y{8Mv!wd4zS-ZG`^5G4B)7CKh5sY?m_5pRf3or{YZCrJ=!ITb+
z6o5RS2&e)Y00giEd;kZ)8Sn<!z|<AY@dC8Ka_Rp=eX_gy8elC;u$BX01=e^7xB)Hz
z^sYVtYXgu64FB@2mn{$XT^1asGyoti-`*b60{}`I09-%4z5P{mdwX3Bg7%gGpxgCd
z_1y{qK=2gIfBLUHx&i>ei3EV={(t3JW&%J<3;>WUxI;amclUwe``~Rs(B+SE0KhT?
z0D=zyfNuQTZ(td$94MIw03Fa*D&qi<odW<2cA#vN|AXBy<mTUg`yYA!`0oxVhyV`{
z`+@-x{34;kAa_XUC@9FNnCO_880Z)nSlIZuSlD>j7#O(saPbHTiHL|WafnIo5t85&
z5)s}31rfkHh)8HiNN9vu7+8e=*WvaC5dGhSFK>H6m?7{Cc!mH6BJBQx8B)TA4GL@&
z{vF_cqYUBEK(rniSOO0s+x`&{5aHmFkZ=DW-f$6c!GW;*6vohtiTV`+2XCk_K$r9B
zYyc^rjob2*r7*ds=0Oc*K66>}+@*=PxzO<zg?O}=n*CNnUZDy7^pIY&)VBbl#Nhqv
zi({;GzLsqM2j0%|CZEa-+W24c4>DusfBt%4Hs-t<(G$WR+|C!J9++4#a_ZPggf780
zU9in$+}6x~?DVzL%+!$G&tkBx89ZD!uVhMoP8Vwaz2|Yb`s1!lju_9ioq*RB2DRIB
zFRFN{7j+exna5?-935Z#u;;p@y*ut`!Rv$U>WyAAN(=<=RF12v83}u7OLcVeXGAs(
zqnPBXP#{`Kc5#WOj};q&UV9j}810FDkJCb(H8vDr$i-|(Rna(rzj(O5q5qUIqhBh6
z_?VD?(!?UFegIv28&5E9*ftlU#u}U5R*!=eJCMvkhnnfti5l@N5!0WMs9!k@QU-+K
zN{+o>1il>SsUuEx#Da+2SOLWu$+!}1ZBc?Jp`epF<Xtm0&`_9iRI*GYL4a$%y9*~E
zn)k&k&K)cj(43)@1Q2xcdJVgQTK=Q<gqc{deVl|krV%k$Kg%t#!ejtpVMKDa4`I~r
z5CS$eD=rAgg&|78F8(_gY-j`|02vnrp8$`On+QTpcu!KAhKmPmdsMJrz#+lkunf;_
zBvWR6dzzi<JbU!=J7CrF;o5XYFeCM#lr|(_LFL@p&vWB_TT041r-*D9Y=%A?0;jVc
z1)Zy-*O?GP&Hbp$>yY=a-?1oDI;zL16MO2QKUv48`w??r)gO1Hh3o9`j%+~Yv~>9L
zdpSI3^~!$M!^*rP2eO*-@n;<TUHK!k$P0Zo9#u%CXV#+-xpr&XIeq=7UtaB>YMLCB
z4bKKCJDwx+bZRiFr=i!Te(;W$%1TL&;TgUc;*9a*(Nw^FV05`;^b4T`hIqlxy|@%E
z`H1`0PD!s!JPw9Ps^ZnWKQ4@y3^BeWpo&cX-U@$tzf>~G7<nVvS8#!=|K<AotcLZG
zwxupR)%Bxq6wY`TZi2X7M_L4gQ6`2&Uh@l6)Q65st{xZ72`1zpogH_W`H&aH6W}O=
z8!;|f$BLiyC=Y2CAMNMi-2AL841U_&9%&I~{xG;qV{(8b&GAD<&e5!nM^AkMK?1ii
zeAe=L?*yT!k79l<_YulyVvwQF5+4taZk_JFu8z;N8yd-$%d;rn@uz7l0p-c#ZWDTI
zC(VAiR~Pu*PYJ_q*=~Wyxi|%OU#li>O#3Ay+{)5Z@$4q_ki45XE;h|i&MJ4y+Ul!o
z<16mlMx_nCu~)BLmndi|b~2Z(`(-lY=_)4h{rzl`xt;XPCg+Nk^CU{ws8aY&>@OL_
zCuoj=7En^{^4aNMzC<NPIIm7tL%B4K+O*4zK5eP1NE0KW1D5A?-tFJM>g@7)-vaN!
z4o3%0L-6n*JRXEC{|+Dw9sv;#p8x_Pm<eelHAC-u8VDDbfV+{P7OEi6w@wUvaFrgz
zPSN($mLijL`Ow;sn7NZzS#QF$)YZ@!X{y)o5s5RMqw_d{XpeRQCpDwys|C3&LgHt-
z15M-<h*_sNwt9sIJ}W5(wEZeJ^Vv2g=9;V;w1r>!iYhhCs@tMpAo&k@On82pH^SrQ
zZO`gYRXk{!+1l{@CgCtow&bMf()UzhM(fwdgl16_y9nZ65u}hxlwssfzh(ZnklJZv
zp6dwQU{0&Td_F3Mu5K#Wz`_Fu7WjcjMEPSUJOIwIAW)ltS_;BN!>y@BNW>#4?e1}B
zE<DWK>t@P%(ymBOCE2E!#u>X`I!4~dc9>5T^Ng9iEqzB*DJfeX$xa0`ApeL_dpW-7
zsB7HI!uRB&vT=Cj<WgHV6?^p4G)10UhTe?Hr%mfAx!@-Zi}anjjXy+cRXF0N-(wn^
zPFl!&wMQ>`KAY2L!*V;7v9L}Ks&K;_Pe#8kwzBVg;VI9uQDBzK6DMx|g1v;{e6ea_
z^GQ&p3q`7sNQE6oUz@Ncjp$Fk;hZWKh&qFzBOa+rQS}uzOFjYol2V}PYd51@RMgPR
z-6v^p1SUP6c|_^GNf6QB`f)HQtT_*Tk|<l2pq}Z&h=x5SBc>p(FJIYnGQwuQPiRy+
zuou5Mv_+b7HSukFyd;+{epd5Q@hpv-wNabI$nYt198sn6Qd+jeo9bI2<Q4#3ECIv9
zgUd4-A~G7%os+>U01pwL8kb8GiGYTaTS^P+K?q5CC2bj2)H6v$OUENAqwTrIYZYGH
z`)58wmVmz@)`M@?9+cQJ-zDCwTQRxR95L)<Q^6yBeb8wp=oMi5f)>l^+@@<ohAu!q
z&IrP6F7n~J@XJA4u^Qj}JENv8M(Ale*}YUW(NbmeHRbz|T70WQ%+Cbdz8fC6d9US3
zA&0fksY`E;_1Py2UV2x2eWaWx5yY^z%cPRkYy&Nld12>bKH%cG<@#v1zwo|`k@YVm
zgXXu=4M^=DDBf#$kJ%%QX8qK8Lc3*sIQKZ98prZ_Cj3jk$&5#;n&C;Oh15)}c1YQK
zEj2;EpUzWFvqAHTf{|H8-s~Eb9D!5%x-CA!Bd$9ugKa}73<oSZ+-_+;l;gP}8BE_h
zA(VR$n5EX<mZh~tJv+5*CVqp@tn|sJshWbhw%SdzVu=tdtvn9(S2N`k*NabwWokCG
z+BKn{&t_gzB5boV>A8qh9{Uyq^DTEDt{C!S7?HP-?R_~VTBupociwv(@C0>>DRT|_
zdX~lCAYO#pb+5+DFcxz;qd3ioiD<FO@oPow#isAC{R@{Z#5Iwtvu_=G5!Kz;%(?4s
zE$K18S}wjdwTI@Xs<s<x2gz|klk>k=G4XgMJMEYZ3M*Vcr&)N?tTFewuEvrYcK|Rp
zq!uv!#L2uCC2s5yVnQ1-<08I!(UJ~5)Oh?ui{p@pof}&tnF!s+EOw^tk~cUPa|&<?
z?!DrxRf;x1X;fvkd|}CFFzx<JweqL_{ZdlRFFqMRXmW3AobdP=3>gNRHj)=&tUVBq
zD#j=>V{8q2(<IdPgT7R95i|#Yudt=$j$hFD%Qi=>hpA6Ee2VYqjTRLrF@4Q$=LTWT
zm@_ErTP;(TZmnHPwrYLEnpVF+j(^0Qv4CPL^G#DKx@RTl!Nat-rOn4SEo2z`41@?w
z2Ez9!cq`lySsr$lk#C+}{K_IcQj0h^=hX5q8a<Tw>aeIrjz>q@a_r(X7w{sWpnu<M
z#?$jKO`y-*D~;;c&}iK?&7uraw>SgsQt#MH16dA*q*Zy-d-(UK^VK6gD(dSo<VjlU
z3R)+JizcJun>W-Gx+~LAI@8`t9M$_gx*Gjuvi^0q4kvI(Q$1lbV?Jmt<|c$?q>mNB
z5=W<X&*VXtf0N`!^Gc@nKCVsQMu+d@b%^j65BIFx)^mZP^R^CN4v|BtK&+&6sCIWJ
zL!o6~OnL~vS(=Y6rj9bNU0Y@O=C^f=mGNM{tL^Xy@*W@2p<`TBUsNXvsmN(9S9*n+
zrA0**(Q%5yKZgj>WZB(R8xeey?2E=?Jf+(aI9dT`0A^fpqY5CPAcCvKpTz{g1D6q8
zO{fR>9~cPdtDecjqczFD_AV0C=j<k3x?_cc4HHG#U-Ox9P?_CXY(q-BN(^<^MQNsa
z#??@XpoC%CWH^1tq@R&cLemuwAdh;Qp?cjJS42NHC3Qe#RE#YnS5eiaohJO?c=|{E
zAIX%CP^D*8^xn278{+ck3a-Au!+|m3UgjyLcH4?WcTRdt%CVj|nrRc>Vx7c}_~i}7
z3+_x)+q8z!4$^L!*L++$#E9umwi-<7^hF-Ivg}T^BfQOZBBQO$j$5QEa<-b09P5((
zw8!*OJXa_lZ~2+VbTMhgY745zmDA2*r8o16h+T0voEe(2$E+&KDG>}!_FC&H;2&6X
z@p?S7c)(`Fb<BNFUdHaUT&pto^U-u3>Of)5&tig3fo@i(YNm>|!HYr}_vv}&M4AQf
zH4MFe4PhJIagO-6Y)ZkR6*-b#mT#$fPQP(+2qZMmw>Wrq>@_U2fau9&$47MU*uP<~
zax&gej3+oG*owfl*`y_T-;njBh`3tYaKeq!%6{6dGiQ)k<tw`k4Z{n<FDu2Jf+$LU
z1um^2dT-<xow#LVH}>e`U3$+)(JpHGc`eBL3ALW=p<5+VYbR@<zhGzEn+`PNZZ`fQ
z3U|tvWR~-*k=S<*E;nvj(=_j7NgF<k<?XY)^{m5$Rz_2Y_irDnegE}=sE2bRy<%Jq
zdzQGf=sj>%BeOJGTm4dN2Df)ONVTg<OS~*NODM=I;%Li6+9Kgzk0j^iS8`$%k?aWk
zsnt(t-+XK^T$VMc22r=1b?5X5U0KnyTFVPcbRNY;FVlC9HXiYpB_l02sWJEX6<C;X
ztgV!nc0wE0&dHH{T97DWHa^_+NT0@3sAv6LNE!Wv;)jAIJDe40)9KjyHlE_=0|Bmk
z*f><9hYK-_;Zv`&?fBYuf>(}b5+3#t2<l8fZ@tN*4z!O?Ig?&cpsD?y<88Nif1n9N
zUY721*V6b@OhzDkXTsZ0BKb(2=jYq7qA8>xBL=n6*zM6QXJyuy{RG3AD7v|(f`QdU
zvq-_rg0uU_?3IW?vjY3OzmPaTbbaL-eW8T&D+C-EcYk5Jd!)uqRYZJ>w4I73(t+B)
z;S6EGJnz9q495y`ds#dNhZuNY5bFzo7x?KZBs5e}NE$#4RiMKMAn<5(;4n;;g5bje
z;Zk%@Q4!%KA*pZ>cq!NykVJ%6ga82IQ#iy_kXZ_Ns(^?uNr#ID30DB{r4aF@=s@PD
z3g9Ij$dIZ?R{)M|YCLdc!?uZk?GnLfue*^A;nak>dxYJMXxJVR_xN$gJ=b;7!PWI(
zMrs~MV70#|9IZc~Mm9IRdx_`a<@<R)&vkD<I!g@`6fehcjs7CP2dc`t9)#-LpT{)%
zpL8gawo=?1BhY9~O{W)QiUI~nKM@MbnM5{?Ar{qc!Ud0zLg;DDn3;`KFtWoHwAs`x
zF*qJ#*PhqeQ_8z=LSD@96*43htdN=1y*K}@`Q6|5z+LVi-S0GqXmUzHJ#gJq?lgyO
z_i(Qg_u397NaXGhW#0m$vc=b$$`8Dn*HWg*Jt4&8@JQz(y9G0hN;j?^IN@k0;=_`5
zC!PZ0{Qc&I?<57NzjY+~j++c!kO(4=sb)F9ITOuBEA)A6)W58nIsyOb6yv$fsF@=!
z|EX`%E2g0@eUiHd^P`ll1VvvbR(#}Z7d{DRHc*X5t$7DL>PWMYcx{z2vVP9v?fuxs
z7}I*;-f@sCJnjW`pzNHS@qXRst*#iupys+?L!gCBuvr&;WJCg!-zNTU8%<oO2LzmU
zU-hgVaZVooJ?Y|}vIV+oX~g(k>d?T?#Rea5NLVRkHx+!O^=)eSN%~CdgN@iO$Gv)k
zv-fN+8t;PGAyC=HHv>2`eKq7V2gR&!$&fyxcdi=vMgt2)A$0HR$42XgvnqdeaLS7t
zY?I!2IIH5kV25AndW9HZbO7OHttYmJprw$L>f<YL66w+$SyZk&F<5(?x0z|ZU&9Sp
zxPN#M)>K~Aq!}PjGHFjrsk)Fd7NF>u93DQwqm$lZ5NelyXy7z`3#j0+z$f6Ose3;Z
z3eVX0FesQU>Lt=wX*H^j{qdDMr^n(&y=w>vv>DQhmTM{acwI(V8-Y3ZRGpfpsOw|g
zGDA~l@V)wvdtQ4q&wZY~{#7hrKF&cdwr<Lnq?ko!T-au(<3~R0mx0{KTj>5J?K?*|
z;)mr3-4M^(wiX&hw)f0O7-Ufx;nwxW>sJFk0{Kop7itc=p$5Upt(MqMmfAg^1PEue
zD`r@?TGqAaUh!cVz4V8-Zv638Qe!T$$nR|%{Ic#b3tM?E6T%PEQON7u9IB5WJBur8
zknZ>Ex+0uoL0?ZLQfWpjrA2Ymw&(b#BcR8|lK71xqpMO^zaPq=S52=~O$JaJb)QB>
z$!d|KySc>{zl<NLq3$Jpq7NUBNp4&6%wbW|zxCOoUsiI<EzmA{ky<_@n=+;E8#HFe
zBstM0<r7G<$cN-YutlQFl4pD+>s|liYQSvcjHz(MB;B}aMpas4R(+VPX;h=?_(9h@
z=^(9JfQvZB^pX5$gs+Bbm5j*Ai!1o^x<AwLY}ruWvcxJUr4};bu0F4?c*}#kO?v+7
z3!1013M6%L=MjPaqin60PLri`bd#A)NoNN|leyAdc>bz}b{3Dz5{%-49kGh4g|gA)
zLbZ!h-qPR1?S~?V^S7|#Mm3+|hc-NMJWb#-dR*9#^^(-k2epA-Wb@ay4Z24Det{!B
zZLACK+-%h7&oB~w@8*8?(}XaUK_h6RdqOdTKA+Lxc1~n`BpULd8UrTjW*$16X7s9&
z6-BiWX>L5xQ#ZFHVy0Lil#NTNEM7pRMsD>`ca9d-0ln!1Rw%#^q+{Z`)=<^=l?+)(
zq_hsaC>fbK(x1At#OmkUk=fX>u2i=7?C=YBTX%YZJsfRBCa&Qf)*Y_P4=4LMaVuWo
zWL3D4)>o&2h&wzQD+8f=rSdEvw?_9>_D(#nKJP8i051lgX&#XH0tfR=RyY5Nh&R3a
zG_{Xw#~9LLZ=S&`wh7&cU{WIz|KctN%s?(>)Psr3k=jOs;FH#06;5;QGm|-A2>V|P
z5D3+Z_hoE-PY}k@eu<VJ9`)m?(O!XKB_$3EvfE65Kc=@Yb7Z~OCxi2z4s08GPrP=c
zpC|MXN;_1+hly0X#O!84?cWD&w2fpJHgmn}^gApt*x=q^c87@8Ni4_>J4~w;H%<;y
zKJ*R!P!72Io8AJG2<@@(Gx9VZSYm!zVX~bip?ofDj;@VHcAS&5?1H-y)uz46eY{u~
zqynT4Z(Dm_cTcNw@F9cH%NH*&^rd5bWBV*M+j<jkZg4SA(?5@>M@kU_?%tITr>C_U
z7oAz5*8C4`p(3mm_V!16KJn7%xQ?{NG7uXJEQ7_<E^}&e_XD0Mqlgz&S(HVLtLOa4
yW_##jt~}U*^A8!kV_bjPUm*o({pvAfxH@!y%!!{sA@kvqN>?dks%!mr;r{_#v%)<9

literal 0
HcmV?d00001

diff --git a/docs/docs/assets/controllers/ShellyI3.jpeg b/docs/docs/assets/controllers/ShellyI3.jpeg
new file mode 100644
index 0000000000000000000000000000000000000000..e2de708479369a304a53b81a784224b65ca905ab
GIT binary patch
literal 20661
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

literal 0
HcmV?d00001

diff --git a/docs/docs/assets/controllers/ShellyPlusI4.jpeg b/docs/docs/assets/controllers/ShellyPlusI4.jpeg
new file mode 100644
index 0000000000000000000000000000000000000000..efb60171d59e4359ad0fe73ce98e3e2bb7fe2f6e
GIT binary patch
literal 20056
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

literal 0
HcmV?d00001

diff --git a/docs/main.py b/docs/main.py
index 7b5f9af3..a50dae35 100644
--- a/docs/main.py
+++ b/docs/main.py
@@ -24,6 +24,8 @@
     "state": "State",
     "lutron": "Lutron Caseta",
     "homematic": "Homematic",
+    "shelly": "Shelly",
+    "shellyforhass": "ShellyForHass",
 }
 
 INTEGRATIONS_EXAMPLES: List[Dict[str, Any]] = [
@@ -47,6 +49,12 @@
     },
     {"name": "lutron", "title": "Lutron Caseta", "controller": "87654321"},
     {"name": "homematic", "title": "Homematic", "controller": "my_controller"},
+    {"name": "shelly", "title": "Shelly", "controller": "shellybutton-ABC123456"},
+    {
+        "name": "shellyforhass",
+        "title": "ShellyForHass",
+        "controller": "binary_sensor.shelly_button_switch",
+    },
 ]
 
 
@@ -168,6 +176,8 @@ def get_controller_docs(controller: TypeController[Entity]) -> ControllerDocs:
         "state": controller.get_state_actions_mapping,
         "lutron": controller.get_lutron_caseta_actions_mapping,
         "homematic": controller.get_homematic_actions_mapping,
+        "shelly": controller.get_shelly_actions_mapping,
+        "shellyforhass": controller.get_shellyforhass_actions_mapping,
     }
     for integration, integration_mapping_func in integration_mappings_funcs.items():
         mapping = integration_mapping_func()

From 3df78323606326a96e7182edd442ca0775b15820 Mon Sep 17 00:00:00 2001
From: Xavier Moreno <xaviml.93@gmail.com>
Date: Fri, 13 May 2022 23:09:12 +0200
Subject: [PATCH 3/3] docs: add missing docs for shelly integrations

related to #441
---
 RELEASE_NOTES.md                          |  5 +++++
 docs/docs/others/extract-controller-id.md | 14 +++++++++++---
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 4cdb81b6..c15c244e 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -9,6 +9,8 @@ PRERELEASE_NOTE
 ## :pencil2: Features
 
 - Add following predefined actions `on_min_max_brightness`, `on_max_min_brightness`, `on_min_max_color_temp` and `on_max_min_color_temp`. [ #472 ] @sabaatworld
+- Add [`shelly` integration](https://xaviml.github.io/controllerx/start/integrations/#shelly).
+- Add [`shellyforhass` integration](https://xaviml.github.io/controllerx/start/integrations/#shellyforhass).
 
 <!--
 ## :hammer: Fixes
@@ -29,3 +31,6 @@ PRERELEASE_NOTE
 ## :video_game: New devices
 
 - [ROB2000070](https://xaviml.github.io/controllerx/controllers/ROB2000070) - add device with Z2M support. [ #482 ] @hrak
+- [ShellyI3](https://xaviml.github.io/controllerx/controllers/ShellyI3) - add device with ShellyForHASS support. [ #441 ]
+- [ShellyPlusI4](https://xaviml.github.io/controllerx/controllers/ShellyPlusI4) - add device with Shelly support. [ #441 ]
+- [Shelly25](https://xaviml.github.io/controllerx/controllers/Shelly25) - add device with Shelly support. [ #441 ]
diff --git a/docs/docs/others/extract-controller-id.md b/docs/docs/others/extract-controller-id.md
index 37b47d94..b2c91ed9 100644
--- a/docs/docs/others/extract-controller-id.md
+++ b/docs/docs/others/extract-controller-id.md
@@ -11,11 +11,11 @@ The name you need to add to the `controller` parameter can be found in `Configur
 
 #### deCONZ
 
-In case of deCONZ, you can go to `Developer Tools > Events` then down the bottom you can subscribe for `deconz_event` and start listening. Then press any button and you will see event of the button, you will need to copy the `id` inside the `data` object.
+In case of deCONZ, you can go to `Developer Tools > Events` then down the bottom you can subscribe for `deconz_event` and start listening. Then, press any button and you will see event of the button, you will need to copy the `id` inside the `data` object.
 
 #### ZHA
 
-In case of ZHA, you can go to `Developer Tools > Events` then down the bottom you can subscribe for `zha_event` and start listening. Then press any button and you will see event of the button, you will need to copy the `device_ieee` inside the `data` object. It is a number like the following 00:67:88:56:06:78:9b:3f.
+In case of ZHA, you can go to `Developer Tools > Events` then down the bottom you can subscribe for `zha_event` and start listening. Then, press any button and you will see event of the button, you will need to copy the `device_ieee` inside the `data` object. It is a number like the following 00:67:88:56:06:78:9b:3f.
 
 #### MQTT
 
@@ -23,4 +23,12 @@ In case of using MQTT integration, the `controller` attribute must have the MQTT
 
 #### Homematic
 
-In case of Homematic, you can go to `Developer Tools > Events` then down the bottom you can subscribe for `homematic.keypress` and start listening. Then press any button and you will see event of the button, you will need to copy the `name` inside the `data` object.
+In case of Homematic, you can go to `Developer Tools > Events` then down the bottom you can subscribe for `homematic.keypress` and start listening. Then, press any button and you will see event of the button, you will need to copy the `name` inside the `data` object.
+
+#### Shelly
+
+In case of Shelly, you can go to `Developer Tools > Events` then down the bottom you can subscribe for `shelly.click` and start listening. Then, press any button and you will see event of the button, you will need to copy the `device` inside the `data` object. You can read more about the event [here](https://www.home-assistant.io/integrations/shelly/#events).
+
+#### ShellyForHASS
+
+In case of ShellyForHASS, you can go to `Developer Tools > Events` then down the bottom you can subscribe for `shellyforhass.click` and start listening. Then, press any button and you will see event of the button, you will need to copy the `entity_id` inside the `data` object. You can read more about the event [here](https://github.com/StyraHem/ShellyForHASS#shellyforhassclick-020).