Sdbus

Breaking changes

All enums were revisisted and updated in accordance to NetworkManager documentation.

Some enums and their fields were renamed:

* `AccessPointCapabilities` -> `WifiAccessPointCapabilities`
* `WirelessCapabilities` -> `WifiCapabilities`
* `WpaSecurityFlags` -> `WifiAccessPointSecurityFlags`
* `P2P_*` -> `PAIR_*`
* `BROADCAST_*` -> `GROUP_*`
* `AUTH_*` -> `KEY_MGMT_*`
* `ConnectionState` -> `ActiveConnectionState`
* `ConnectionStateReason` -> `ActiveConnectionStateReason`
* `ConnectionFlags` -> `SettingsConnectionFlags`
* `ConnectionStateFlags` -> `ActivationStateFlags`
* `DeviceCapabilities` -> `DeviceCapabilitiesFlags`
* `BluetoothCapabilities` -> `BluetoothCapabilitiesFlags`
* `ModemCapabilities` -> `ModemCapabilitiesFlags`
* `SecretAgentCapabilities` -> `SecretAgentCapabilitiesFlags`
* `VpnState` -> `VpnServiceState`
* `VpnFailure`
* `LOGIN_FAILURE` -> `LOGIN_FAILED`

New enums:

* `NetworkManagerCapabilities`
* `WimaxNSPNetworkType`
* `SecretAgentGetSecretsFlags`
* `CheckpointCreateFlags`
* `CheckpointRollbackResult`
* `SettingsAddConnection2Flags`
* `SettingsUpdate2Flags`
* `DeviceReapplyFlags`
* `NetworkManagerReloadFlags`
* `RadioFlags`
* `MptcpFlags`
* `VpnConnectionState`
* `VpnConnectionStateReason`

Warning if you used pre-release version

`connection_profile` of `NetworkConnectionSettings` object has been replaced with
equivalent `get_profile` method which can also fetch the secrets fields. (you can
use `mypy` to check)

Breaking changes

* Renamed certain elements of `ConnectionType` enum to match `DeviceType` enum.

* `WIRED` -> `ETHERNET`
* `GSM` -> `MODEM`

Features

* Added connection settings dataclasses.
Those dataclasses are found under `networkmanager.settings` sub-package.
They allow for easy and typed reading, modifying and writing connection settings
without dealing with D-Bus variants.

Thank you bernhardkaindl for spearheading this feature.

New methods have been added to existing interfaces that utilize the new dataclasses:

* `NetworkManagerSettingsConnectionInterface`

* `get_profile`
* `update_profile`

* `NetworkManagerSettingsInterface`

* `add_connection_profile`

* `NetworkManagerInterfaceAsync`

* `add_and_activate_connection_profile`

* Added support for loopback devices from NetworkManager 1.42

Features

* Added NetworkManager errors as named exceptions.

Initial release.

This version significantly reworked the internal undocumented classes
and functions. If you used the undocumented API you would probably need
to adjust your code. Type checker like `mypy` can be very useful for this.

Features:

* `setter_private` can now be used in overrides.
* Added `assertDbusSignalEmits` method to `IsolatedDbusTestCase`.
Can be used to assert that a D-Bus signal was emitted
inside the `async with` block.
* Added `sdbus.utils.parse_get_managed_objects` function. Can be
used to parse the ObjectManager's `get_managed_objects` method
data to classes and Python attribute names.
* Added a handle that is returned by `export_to_dbus` and `export_with_manager`
methods. This handle can be used to explicitly control when object is accessible
from D-Bus. (requested by dragomirecky)

Fixes:

* Fixed async D-Bus properties not having a proper generic typing. (reported by ValdezFOmar)
* Fixed build not working when systemd has a minor version suffix.
* Fixed being unable to name arguments in D-Bus introspection when
method has no return arguments. (reported by colazzo)
* Fixed serving D-Bus methods that return a single struct. (reported by colazzo)
* Fixed sending extremely large D-Bus messages getting stuck. (reported by colazzo)

Features:

* Improved interface generator handling of multiple uppercase letters
sequences. For example, `ACTIVATE_CONNECTION` would before be converted
to `a_c_t_i_v_a_t_e__c_o_n_n_e_c_t_i_o_n` and after to `activate_connection`.
(reported by bhattarabi)
* Improved python formatting generated by interface code generator.
* Added option `--block` to generate blocking interface code.
(requested by zhanglongqi and MathisMARION)

Fixes:

* Fixed docstrings still being present even if python was configured with
`--without-doc-strings`.
* Fixed interface generator crashing when a rare write-only property is
encountered. (reported by gotthardp)
* Fixed async interfaces iterating over all members during initialization.
(reported by gotthardp)
* Fixed `TypeError: Dbus type '\x00' is unknown` being raised when trying to read
from a message more than one time. (reported by IB1387 and asmello)
* Fixed missing class body when generating code for interface without members.