Extend Functionality of ESPHome Media Player

[rwrozelle]

Breaking change

No breaking change

Proposed change

What does this implement/fix?

Lays the ground work for child components of Esphome Media Player to be built with a richer set of capability.

Description

Extends Esphome Media Player component to support the following commands in child components:

• Next Track
• Previous Track
• Turn On
• Turn Off
• Clear Playlist
• Shuffle
• Unshuffle
• Repeat Off
• Repeat One
• Repeat All
• Join
• Unjoin

Traits are extended to include:

• supports next/previous track
• supports turn off/on
• supports grouping

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

• This PR fixes or closes issue: fixes #
• This PR is related to issue:
• Link to documentation pull request:

Requires the following pull requests:
esphome/esphome-docs#4090
esphome/aioesphomeapi#911
esphome/esphome#7158

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
• I have followed the perfect PR recommendations
• The code has been formatted using Ruff (ruff format homeassistant tests)
• Tests have been added to verify that the new code works.

If user exposed functionality or configuration variables are added/changed:
Nothing changes for existing esphome media_players, new functionality requires updated/new esphome components.
An example of which is my external component https://github.com/rwrozelle/audio-media-player

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

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.

To help with the load of incoming pull requests:

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

[home-assistant]

Hi @bobrozelle,@rwrozelle

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!

[rwrozelle]

Thank you, its obvious now that you've pointed it out. I've signed cla with both accounts.

[rwrozelle]

I'll work on getting the files updated for ruff. A little confused because it passed ruff in my local dev environment. Most of the MyPY errors look like they are because of the changes needed from esphome/aioesphomeapi#911. How is that handled?

[rwrozelle]

I've updated the code and updated for all pre-commit requested changes from my local dev environment. I'm going to submit for review, but still unclear if it will pass tests because of changes needed from esphome/aioesphomeapi#911. Is there a way to get the github tester to use updates from another pending Pull Request?

Stale

[github-actions]

There hasn't been any activity on this pull request recently. This pull request has been automatically marked as stale because of that and will be closed if no further activity occurs within 7 days.
If you are the author of this PR, please leave a comment if you want to keep it open. Also, please rebase your PR onto the latest dev branch to ensure that it's up to date with the latest changes.
Thank you for your contribution!

[frenck]

Drafting as this depends on upstream changes.