Add Overkiz AtlanticPassAPCDHW

[nyroDev]

Breaking change

Proposed change

Implement Overkiz AtlanticPassAPCDHW, a Water Heater entity provided by Atlantic.
This entity is generally attached to an Atlantic heat pump.

Type of change

• Dependency upgrade
• Bugfix (non-breaking change which fixes an issue)
• New integration (thank you!)
• New feature (which adds functionality to an existing integration)
• Deprecation (breaking change to happen in the future)
• Breaking change (fix/feature causing existing functionality to break)
• Code quality improvements to existing code or addition of tests

Additional information

Tested on my water heater, change of operation mode is working correctly.

I also added the async_execute_commands in the Overkiz executor in order to be able to execute multiple commands at once.
I did it because the regular web interface of Somfy do that.
I already addad a pull request #78659 who add the exact same multiple commands

• This PR fixes or closes issue: fixes #
• This PR is related to issue:
• Link to documentation pull request: Update overkiz and somfy doc for adding water heater support home-assistant.io#24586

Checklist

• The code change is tested and works locally.
• Local tests pass. Your PR cannot be merged unless tests pass
• There is no commented out code in this PR.
• I have followed the development checklist
• The code has been formatted using Black (black --fast homeassistant tests)
• Tests have been added to verify that the new code works.

If user exposed functionality or configuration variables are added/changed:

• Documentation added/updated for www.home-assistant.io

If the code communicates with devices, web services, or third-party tools:

• The manifest file has all fields filled out correctly.
  Updated and included derived files by running: python3 -m script.hassfest.
• New or updated dependencies have been added to requirements_all.txt.
  Updated by running python3 -m script.gen_requirements_all.
• For the updated dependencies - a link to the changelog, or at minimum a diff between library versions is added to the PR description.
• Untested files have been added to .coveragerc.

The integration reached or maintains the following Integration Quality Scale:

• No score or internal
• 🥈 Silver
• 🥇 Gold
• 🏆 Platinum

To help with the load of incoming pull requests:

• I have reviewed two other open pull requests in this repository.

Fixes #80375

[probot-home-assistant]

Hey there @iMicknl, @vlebourl, @tetienne, mind taking a look at this pull request as it has been labeled with an integration (overkiz) you are listed as a code owner for? Thanks!
_{^{(message by CodeOwnersMention)}}

[bachya]

Looks great! Small item.

[nyroDev]

Undraft this PR in favor of creating another PR #79576 for async_execute_commands

[nyroDev]

@bachya I don't know when you write "still in progress?", but no, I think this PR is ready for merging if reviewers are ok with it.
The code is no fully functional.
It was marked a draft in order to wait for a new PR #79576
I updated this PR to make it work without it for now, and I will update this entity on the other PR to optimize multiple calls afterwards

[iMicknl]

Some quick comments to get you started. It is hard to review since codecov is adding comments on every line, so not very readable currently.

By the way, you may also join our Discord where all developers are if you are looking for some guidance / brainstorm sometimes.

[nyroDev]

Because I'm adding a new type of entity (water heater), Should I do a PR for the documentation to update this file:
https://github.com/home-assistant/home-assistant.io/blob/8e7d6ef9aba3663697c4c9addf266e90be0155d4/source/_integrations/overkiz.markdown

And if I should do it, when should I do it?
Before or after this PR is merged?

And in this documentation PR, should I also update the Somfy integration as well?
https://github.com/home-assistant/home-assistant.io/blob/current/source/_integrations/somfy.markdown

[vlebourl]

https://github.com/home-assistant/home-assistant.io/blob/8e7d6ef9aba3663697c4c9addf266e90be0155d4/source/_integrations/overkiz.markdown

Let me get corrected if I'm wrong, but I believe you do have to update the doc concurrently and add the link to the PR in the Additional information section of the description at the top.

[nyroDev]

https://github.com/home-assistant/home-assistant.io/blob/8e7d6ef9aba3663697c4c9addf266e90be0155d4/source/_integrations/overkiz.markdown

Let me get corrected if I'm wrong, but I believe you do have to update the doc concurrently and add the link to the PR in the Additional information section of the description at the top.

Yes, I've done the PR in the next branch for the doc as required.
I've updated the original comment here and linked to this PR from the documentation PR

[Quentame]

Some comments otherwise looks good !

[Quentame]

Make sure this PR contains the latest ha-tahoma feature/fix

[nyroDev]

Make sure this PR contains the latest ha-tahoma feature/fix

@Quentame As far as I know, this very specific entity was not supported in ha-tahoma.
See https://github.com/iMicknl/ha-tahoma/blob/master/custom_components/tahoma/water_heater.py#L17

When this PR is merged and another one in pyoverkiz, I'm willing to rewrite supported water heater device in ha-tahoma here.

[Quentame]

Nice job !
Thanks 🎉

[Quentame]

@nyroDev Can you explain what is a AtlanticPassAPCDHW device IRL in the "Proposed change" section of the description of the PR ?

As it will be used for the release notes, it will be more understandable for everyone.

[nyroDev]

@nyroDev Can you explain what is a AtlanticPassAPCDHW device IRL in the "Proposed change" section of the description of the PR ?

As it will be used for the release notes, it will be more understandable for everyone.

@Quentame Updated, is that ok for you?

[Quentame]

@nyroDev Can you explain what is a AtlanticPassAPCDHW device IRL in the "Proposed change" section of the description of the PR ?
As it will be used for the release notes, it will be more understandable for everyone.

@Quentame Updated, is that ok for you?

Nice ! 👌