omdathetkan · omdathetkan · Feb 1, 2022 · Feb 3, 2022 · Feb 5, 2022 · Feb 6, 2022
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
@@ -5,12 +5,3 @@ updates:
   schedule:
     interval: daily
   open-pull-requests-limit: 10
-  ignore:
-  - dependency-name: pylint
-    versions:
-    - 2.8.1
-    - 2.8.2
-  - dependency-name: astroid
-    versions:
-    - 2.5.3
-    - 2.5.6
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: [3.8, 3.9, '3.10']
+        python-version: [3.9, '3.10']
     steps:
     - uses: actions/checkout@v2
     - name: Set up Python ${{ matrix.python-version }}
@@ -58,7 +58,7 @@ jobs:
     needs: ["build"]
     strategy:
       matrix:
-        python-version: [3.9]
+        python-version: ["3.10"]
     steps:
     - uses: actions/checkout@v2
     - name: Set up Python ${{ matrix.python-version }}

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -1,32 +1,34 @@
 ---
 repos:
   - repo: https://github.com/asottile/pyupgrade
-    rev: v2.11.0
+    rev: v2.31.0
     hooks:
       - id: pyupgrade
-        args: [--py38-plus]
+        args: [--py39-plus]
   - repo: https://github.com/psf/black
-    rev: 20.8b1
+    rev: 22.3.0
     hooks:
       - id: black
         args:
           - --safe
           - --quiet
         files: ^((xknx|test|examples|home-assistant-plugin|docs)/.+)?[^/]+\.py$
-  - repo: https://gitlab.com/pycqa/flake8
-    rev: 3.9.0
+  - repo: https://github.com/pycqa/flake8
+    rev: 4.0.1
     hooks:
       - id: flake8
         additional_dependencies:
           - flake8-docstrings==1.6.0
           - pydocstyle==6.0.0
         files: ^(xknx|examples|docs)/.+\.py$
-  - repo: https://github.com/timothycrosley/isort
-    rev: 5.8.0
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.10.1
     hooks:
       - id: isort
+        args:
+          - --resolve-all-configs
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v3.4.0
+    rev: v4.1.0
     hooks:
       - id: check-executables-have-shebangs
         stages: [manual]
@@ -36,15 +38,15 @@ repos:
           - --branch=main
       - id: trailing-whitespace
   - repo: https://github.com/cdce8p/python-typing-update
-    rev: v0.3.2
+    rev: v0.3.5
     hooks:
       # Run `pre-commit run --hook-stage manual python-typing-update --all-files` manually
       # from time to time to update python typing syntax.
       # Will require manual work, before submitting changes!
       - id: python-typing-update
         stages: [manual]
         args:
-          - --py38-plus
+          - --py39-plus
           - --force
           - --keep-updates
         files: ^(xknx)/.+\.py$

diff --git a/.pylintrc b/.pylintrc
diff --git a/Makefile b/Makefile
@@ -29,8 +29,8 @@ pypi:
 	@twine upload dist/*
 
 pylint:
-	@pylint --jobs=0 --rcfile=.pylintrc xknx *.py examples/*.py
-	@pylint --jobs=0 --rcfile=.pylintrc --disable=no-self-use,protected-access,abstract-class-instantiated test/*
+	@pylint --jobs=0 xknx *.py examples/*.py
+	@pylint --jobs=0 --disable=no-self-use,protected-access,abstract-class-instantiated test/*
 
 pydocstyle:
 	@pydocstyle xknx test/*.py test/*.py *.py examples/*.py

diff --git a/README.md b/README.md
@@ -1,20 +1,23 @@
-# XKNX - An Asynchronous KNX Library Written in Python
+# XKNX - An asynchronous KNX library written in Python
 
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/xknx?logo=python)
 [![codecov](https://codecov.io/gh/XKNX/xknx/branch/main/graph/badge.svg?token=irWbIygS84)](https://codecov.io/gh/XKNX/xknx)
 [![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
-[![Pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
+[![Pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=f8b424)](https://github.com/pre-commit/pre-commit)
+[![HA integration usage](https://img.shields.io/badge/dynamic/json?color=41BDF5&logo=home-assistant&label=integration%20usage&suffix=%20installs&cacheSeconds=15600&url=https://analytics.home-assistant.io/data.json&query=current.integrations.knx)](https://www.home-assistant.io/integrations/knx/)
+[![Discord](https://img.shields.io/discord/338619021215924227?color=7289da&label=Discord&logo=discord&logoColor=7289da)](https://discord.gg/bkZe9m4zvw)
 
 ## Documentation
 
 See documentation at: [https://xknx.io/](https://xknx.io/)
 
 ## Help
 
-We need your help for testing and improving XKNX. For questions, feature requests, bug reports either join the [XKNX chat on Discord](https://discord.gg/EuAQDXU) or write an [email](mailto:xknx@xknx.io).
+We need your help for testing and improving XKNX. For questions, feature requests, bug reports either open an [issue](https://github.com/XKNX/xknx/issues), join the [XKNX chat on Discord](https://discord.gg/EuAQDXU) or write an [email](mailto:xknx@xknx.io).
 
 ## Development
 
-You will need at least Python 3.8 in order to use XKNX.
+You will need at least Python 3.9 in order to use XKNX.
 
 Setting up your local environment:
 
@@ -30,9 +33,11 @@ XKNX contains a [plugin](https://xknx.io/home_assistant) for the [Home Assistant
 ```python
 """Example for switching a light on and off."""
 import asyncio
+
 from xknx import XKNX
 from xknx.devices import Light
 
+
 async def main():
     """Connect to KNX/IP bus, switch on light, wait 2 seconds and switch it off again."""
     async with XKNX() as xknx:

diff --git a/changelog.md b/changelog.md
@@ -1,5 +1,117 @@
 # Changelog
 
+## Unreleased changes
+
+### Internals
+
+- Rename TaskRegistry.register and Task `task` attribute to `async_func` to avoid confusion; return Task from `start()`
+
+## 0.21.1 Fix Task Registry 2022-05-01
+
+### Bugfixes
+
+- Fix exposure of datetime, time and date objects to the Bus again
+
+### Internals
+
+- TaskRegistry takes functions returning coroutines instead of coroutines directly
+
+## 0.21.0 Search and connect 2022-04-30
+
+### Discovery
+
+- Use unicast discovery endpoint to receive SearchRespones frames
+- Send SearchRequest and SearchRequestExtended simultaneously when using GatewayScanner
+- Skip SearchResponse results for Core-V2 devices - wait for SearchResponseExtended
+- Identify interfaces having KNX IP Secure Tunneling required and skip if using Automatic connection mode
+- Only send SearchRequests from one interface for each `scan()` call
+- Connect to next found interface in case of unsuccessful initial connection when using "automatic" mode
+
+### Internals
+
+- Use `ifaddr` instead of `netifaces`
+- make HPAI hashable and add `addr_tuple` convenice property
+
+## 0.20.4 Fix exposure of time and date 2022-04-20
+
+### Bugfixes
+
+- Fix exposure of datetime, time and date objects to the Bus
+
+### Protocol
+
+- Add DIBSecuredServiceFamilies and DIBTunnelingInfo parser
+
+### Internal
+
+- Include base class in `DPTBase.parse_transcoder()` lookup
+- Move `levels` instance attribute form `GroupAddress` to `address_format` class variable
+- Remove xknx form every class in the knxip package: CEMIFrame, KNXIPFrame and KNXIPBody (and subclasses)
+- Remove xknx form every class in the io.request_response package
+- Remove xknx form io.transport package and io.secure_session and io.self_description modules
+
+## 0.20.3 Threading fixes 2022-04-15
+
+### Devices
+
+- Notification: add `value_type` argument to set "string" or "latin_1" text encoding
+
+### Bug fixes
+
+- Fix call from wrong thread in ConnectionManager
+- Fix thread leak when restarting XKNX
+
+### Internal
+
+- Change RemoteValueString to _RemoteValueGeneric subclass
+
+## 0.20.2 Handle shutdown properly 2022-04-11
+
+### Bug fixes
+
+- Properly shutdown climate mode if climate.shutdown() is called and ClimateMode exists
+
+## 0.20.1 Add support for DPT 16.001 and SearchRequestExtended 2022-04-05
+
+### Features
+
+- Add support for SearchRequestExtended to find interfaces that allow IP Secure
+- Use XKNX `state_updater` argument to set default method for StateUpdater. StateUpdater is always started - Device / RemoteValue can always opt in to use it, even if default is `False`.
+- Add support for DPT 16.001 (DPT_String_8859_1) as `DPTLatin1` with value_type "latin_1".
+
+### Bug fixes
+
+- Stop SecureSession keepalive_task when session is stopped (and don't restart it from sending STATUS_CLOSE)
+- Fix encoding invalid characters for DPTString (value_type "string")
+
+## 0.20.0 IP Secure 2022-03-29
+
+### Features
+
+- We now support IP Secure!
+  Thanks to MDT for providing us an interface for testing purposes!
+- Add support for requesting tunnel interface information
+
+### Protocol
+
+- add SessionRequest, SessionResponse, SessionAuthenticate, SessionStatus, SecureWrapper Frame parser
+
+### Internals
+
+- Drop support for Python 3.8 to follow Home Assistant changes
+- Return `bytes` from to_knx() in knxip package instead of `list[int]`
+- Add a callback for `connection_lost` of TCP transports to Tunnel
+
+## 0.19.2 TCP Heartbeat 2022-02-06
+
+### Connection
+
+- Do a ConnectionStateRequest heartbeat on TCP tunnel connections too
+
+### Devices
+
+- Handle invalid payloads per RemoteValue, log a readable warning
+
 ## 0.19.1 Bugfix for route_back 2022-01-31
 
 ### Connection

diff --git a/docs/climate.md b/docs/climate.md
@@ -94,6 +94,8 @@ await climate.set_setpoint_shift(1)
 # Reading climate device
 await climate.sync(wait_for_result=True)
 print("Current temperature: ", climate.temperature)
+# Shutdown the Climate and the underlying ClimateMode!
+climate.shutdown()
 ```
 
 ## [](#header-2)Example

diff --git a/docs/index.md b/docs/index.md
@@ -26,7 +26,7 @@ XKNX...
 
 ## [](#header-2)Installation
 
-XKNX depends on Python >= 3.8
+XKNX depends on Python >= 3.9
 
 You can install XKNX as Python package via pip:
 

diff --git a/docs/xknx.md b/docs/xknx.md
@@ -49,7 +49,7 @@ The constructor of the XKNX object takes several parameters:
 - `multicast_group` is the multicast IP address - can be used to override the default multicast address (`224.0.23.12`)
 - `multicast_port` is the multicast port - can be used to override the default multicast port (`3671`)
 - `log_directory` is the path to the log directory - when set to a valid directory we log to a dedicated file in this directory called `xknx.log`. The log files are rotated each night and will exist for 7 days. After that the oldest one will be deleted.
-- if `state_updater` is set, XKNX will start (once `start() is called) an asynchronous process for syncing the states of all connected devices every hour
+- `state_updater` is used to set the default state-updating mechanism used by devices. `False` to  disable state-updating by default, `True` to use default 60 minutes expire-interval, a number between 2 to 1440 to configure expire-time or a string "expire 50", "every 90" for strict periodically update or "init" for update when a connection is established. Default: `False`.
 - if `daemon_mode` is set, start will only stop if Control-X is pressed. This function is useful for using XKNX as a daemon, e.g. for using the callback functions or using the internal action logic.
 - `connection_config` replaces a ConnectionConfig() that was read from a yaml config file.
 

diff --git a/examples/example_disconnect.py b/examples/example_disconnect.py
@@ -24,25 +24,23 @@ async def main():
         print("Gateway does not support tunneling")
         return
 
-    udp_transport = UDPTransport(
-        xknx, (gateway.local_ip, 0), (gateway.ip_addr, gateway.port)
-    )
+    udp_transport = UDPTransport((gateway.local_ip, 0), (gateway.ip_addr, gateway.port))
 
     await udp_transport.connect()
     local_hpai = HPAI(*udp_transport.getsockname())
 
     for i in range(0, 255):
 
         conn_state = ConnectionState(
-            xknx, udp_transport, communication_channel_id=i, local_hpai=local_hpai
+            udp_transport, communication_channel_id=i, local_hpai=local_hpai
         )
 
         await conn_state.start()
 
         if conn_state.success:
             print("Disconnecting ", i)
             disconnect = Disconnect(
-                xknx, udp_transport, communication_channel_id=i, local_hpai=local_hpai
+                udp_transport, communication_channel_id=i, local_hpai=local_hpai
             )
 
             await disconnect.start()

diff --git a/examples/example_info.py b/examples/example_info.py
@@ -1,7 +1,6 @@
 """Example on how to read mask version and properties from a KNX actor."""
 import asyncio
 import sys
-from typing import List
 
 from xknx import XKNX
 from xknx.core import PayloadReader
@@ -14,7 +13,7 @@
 )
 
 
-async def main(argv: List[str]):
+async def main(argv: list[str]):
     """Connect and read information from a KNX device. Requires a System B device."""
     if len(argv) == 2:
         address = IndividualAddress(argv[1])