Add opening and closing states to MQTT covers

[rickvdl]

Proposed change

Home assistent has support for the opening and closing state for covers. However, the MQTT component does not expose a way to set this state from the state topic. This PR adds that functionality for devices that are able to proactively report whether they're opening or closing, perhaps from an analog input not connected to HA.

This change is purely additive, the existing features will keep working and the extra configuration options are optional.

Related feature request: https://community.home-assistant.io/t/garage-door-state-opening-closing-state-from-mqtt-sensor/71263

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:

(Optional custom payload, inline with the existing options)

# Example configuration.yaml
cover:
  - platform: mqtt
    ...
    state_opening: "IS_OPENING" #The default value is `opening`
    state_closing: "IS_CLOSING" #The default value is `closing`

Additional information

• This PR fixes or closes issue: fixes Add mqtt cover support for IS_CLOSING and IS_OPENING #30248
• This PR is related to issue:
• Link to documentation pull request: Patch 1 home-assistant.io#11904

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
• 🥈 Silver
• 🥇 Gold
• 🏆 Platinum

[homeassistant]

Hi @rickvdl,

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!

[probot-home-assistant]

Hey there @home-assistant/core, mind taking a look at this pull request as its been labeled with a integration (mqtt) you are listed as a codeowner for? Thanks!

[homeassistant]

Hi @rickvdl,

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 remove the use of STATE_UNKNOWN.

[MartinHjelmare]

Please add a test for this case:
https://codecov.io/gh/home-assistant/home-assistant/compare/ab8b94382eb6267d5e356a6c2f859a73db0f544f...aa41c6f353f2e2d1d96377ca4633da68c1c7a22e/diff#D2-572

[rickvdl]

@MartinHjelmare Test added 👍

[MartinHjelmare]

Nice! Thanks!