Add Homepluscontrol integration

[chemaaa]

Proposed change

This adds the Legrand Home+ Control integration to the Home Assistant core. This integration connects Home Assistant to the Legrand API that can manage "Legrand/Bticino with Netatmo" products. This API is one of several that Legrand exposes through their "Works with Legrand" platform: https://developer.legrand.com/

In this initial PR, the integration adds a simple switch entity to represent the in-wall switches and power outlets that are part of this Legrand smart home product range.

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)
• Breaking change (fix/feature causing existing functionality to break)
• Code quality improvements to existing code or addition of tests

Example entry for configuration.yaml:

# Example configuration.yaml
home_plus_control:
  client_id: YOUR_CLIENT_ID
  client_secret: YOUR_CLIENT_SECRET
  subscription_key: YOUR_SUBSCRIPTION_KEY

Additional information

The integration uses cloud-polling with a single API poll to fetch the data of all entities.
Authentication follows an oauth2 exchange.
The Legrand API only allows 500 API calls per day, so this is catered for in the configuration of the integration - refresh intervals have default values that are larger than ideal, but are currently the best possible to prevent reaching daily quota limitations. In any case, these intervals are configurable in the integration.

• This PR fixes or closes issue: fixes #
• This PR is related to issue:
• Link to documentation pull request: Add Legrand Home+ Control Integration document home-assistant.io#16644

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.
• Untested files have been added to .coveragerc.

The integration reached or maintains the following Integration Quality Scale:

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

To help with the load of incoming pull requests:

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

[homeassistant]

Hi @chemaaa,

It seems you haven't yet signed a CLA. Please do so here.

Once you do that we will be able to review and accept this pull request.

Thanks!

[MartinHjelmare]

Please don't pin requirements exact in the library. And don't require any packages that are not imported directly. The library only needs these requirements:

aiohttp
PyJWT
yarl

Please change here:
https://github.com/chemaaa/homepluscontrol/blob/26aab702aafa573eec05eeb873dcfcce14398f0f/setup.py#L43-L89

Please set as loose version specifiers as possible. Eg a minimum version but no maximum version. If a maximum version is needed, please be as forgiving as possible to avoid conflicts with other libraries installed in Home Assistant.

[chemaaa]

Please don't pin requirements exact in the library. And don't require any packages that are not imported directly. The library only needs these requirements:

aiohttp
PyJWT
yarl

Please change here:
https://github.com/chemaaa/homepluscontrol/blob/26aab702aafa573eec05eeb873dcfcce14398f0f/setup.py#L43-L89

Please set as loose version specifiers as possible. Eg a minimum version but no maximum version. If a maximum version is needed, please be as forgiving as possible to avoid conflicts with other libraries installed in Home Assistant.

OK, I will also work on cleaning up the library dependencies 👍

[MartinHjelmare]

Looks good!

Are we ready to merge?

[chemaaa]

Looks good!

Are we ready to merge?

Thanks @MartinHjelmare!

All good on my side 😄 . Let me know if there is anything else I should do in this process (sorry, this is my first PR).

[MartinHjelmare]

Good work!

Maybe check if we can make the integration configurable via Home Assistant Cloud Account Linking service to make the set up super easy?
https://developers.home-assistant.io/docs/config_entries_config_flow_handler#configuration-via-oauth2