More face attributes for microsoft_face_detect API

[gonzalezcalleja]

Breaking change

Proposed change

The actual component microsoft_face_detect are only using a few face attributes from Microsoft Face API, could be useful to add some other to the component.
In this PR I'm adding this face attributes:

• hair: hair: group of hair values indicating whether the hair is visible, bald, and hair color if hair is visible
• smile: smile intensity, a number between [0,1].
• facialHair: return lengths in three facial hair areas: moustache, beard and sideburns. The length is a number between [0,1]. 0 for no facial hair in this area, 1 for long or very thick facial hairs in this area.
• emotion: emotion intensity, including neutral, anger, contempt, disgust, fear, happiness, sadness and surprise.
• accessories: accessories around face, including 'headwear', 'glasses' and 'mask'. Empty array means no accessories detected. Note this is after a face is detected. Large mask could result in no face to be detected.

https://westus.dev.cognitive.microsoft.com/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236

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
- platform: microsoft_face_detect
  scan_interval: 10000
  source:
    - entity_id: camera.calle
  attributes:
    - age
    - gender
    - glasses
    - hair
    - smile
    - facialhair
    - emotion
    - accessories

Additional information

• This PR fixes or closes issue: fixes #
• This PR is related to issue:
• Link to documentation pull request: Doc for PR 51028 home-assistant.io#18429 Doc for PR 51028 home-assistant.io#19075

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

To help with the load of incoming pull requests:

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

[KapJI]

Shouldn't these constants be used somehow?

[gonzalezcalleja]

Shouldn't these constants be used somehow?

If you did't declare it in image_processing.microsoft_face_detect, you can't use it in the config:

2021-06-20 19:06:26 ERROR (MainThread) [homeassistant.config] Invalid config for [image_processing.microsoft_face_detect]: Invalid attribute hair for dictionary value @ data['attributes']. Got ['age', 'gender', 'glasses', 'hair', 'smile', 'facialhair', 'emotion', 'accessories']. (See /etc/home-assistance/config/imageprocesing.yaml, line 207). Please check the docs at https://www.home-assistant.io/integrations/microsoft_face_detect 2021-06-20 19:06:26 ERROR (MainThread) [homeassistant.config] Invalid config for [image_processing.microsoft_face_detect]: Invalid attribute hair for dictionary value @ data['attributes']. Got ['age', 'gender', 'glasses', 'hair', 'smile', 'facialhair', 'emotion', 'accessories']. (See /etc/home-assistance/config/imageprocesing.yaml, line 221). Please check the docs at https://www.home-assistant.io/integrations/microsoft_face_detect

[KapJI]

Please format your code with black and isort.

[janiversen]

LGTM.

[allenporter]

These are string specific to this API? It is not clear that sharing these string constants with a common library is worthwhile since the strings are specific to the microsoft API.

[balloob]

I agree, these should not be added to default integration. Add to microsoft integration instead.

[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.
Thank you for your contributions.