Create decorator to check service permissions

[bachya]

Description:

Following up on @MartinHjelmare's and @balloob's suggestion, this PR creates a generic decorator to check user permissions on a service call belonging to a specific domain. The decorator checks the user's permissions against all entities owned by the passed-in domain.

Since this logic originally existed in the RainMachine component, this PR also replaces that logic with this decorator.

Related issue (if applicable): N/A

Pull request in home-assistant.io with documentation (if applicable): N/A

Example entry for configuration.yaml (if applicable):

N/A

Checklist:

• The code change is tested and works locally.
• Local tests pass with tox. Your PR cannot be merged unless tests pass
• There is no commented out code in this PR.

[MartinHjelmare]

Looks good! I think we need a test. But let's hear what core thinks first.

[awarecan]

Haven't looked at too details, several thought:

1. I think better put the decorator to helpers/service.py
2. If entity included in the call, it should be an entity_service_call, the permission check already covered in there.

[bachya]

@awarecan Thanks for your thoughts. RE: #2, do you mean to say that I don't need to cover the case of passing specific entity IDs into my decorator?

EDIT: assuming so. Updated with comments and added tests.

[codecov]

Codecov Report

Merging #22667 into dev will increase coverage by <.01%.
The diff coverage is 100%.

@@            Coverage Diff             @@
##              dev   #22667      +/-   ##
==========================================
+ Coverage   94.13%   94.14%   +<.01%     
==========================================
  Files         448      448              
  Lines       36720    36741      +21     
==========================================
+ Hits        34567    34589      +22     
+ Misses       2153     2152       -1

Impacted Files	Coverage Δ
homeassistant/helpers/service.py	93.92% <100%> (+0.66%)	⬆️
homeassistant/components/websocket_api/http.py	89.34% <0%> (ø)	⬆️
homeassistant/components/uk_transport/sensor.py	94.16% <0%> (+0.72%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update c2cfc4a...bc5f3d2. Read the comment docs.

[balloob]

Ok to merge when final comment addressed