Allow Twitter notifications to include media

[MikeChristianson]

Allow Twitter notifications to include media.

The notifier uses the Twitter-recommended async chunked media/upload approach and tries to convey the correct mime type of the media. The implementation is based on https://github.com/geduldig/TwitterAPI/blob/master/examples/upload_video.py.

notify:
  - name: twitter
    platform: twitter
    consumer_key: …
    consumer_secret: …
    access_token: …
    access_token_secret: …

automation twitter:
  alias: Send a test message
  initial_state: False
  hide_entity: False
  trigger:
    platform: time
    seconds: 00
  action:
    - service: notify.twitter
      data:
        message: "Test at {{ now().strftime('%I:%M:%S %p') }}."
        data:
          media: /tmp/my-awesome-video.mp4
    - service: homeassistant.turn_off
      entity_id: automation.send_a_test_message

[homeassistant]

Hi @MikeChristianson,

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!

[mention-bot]

@MikeChristianson, thanks for your PR! By analyzing the history of the files in this pull request, we identified @pvizeli, @balloob and @fabaff to be potential reviewers.

[balloob]

Other notify platforms are using ATTR_DATA for it. That way if a platform requires extra metadata, we don't need to add extra fields. So please add it to Twitter via ATTR_DATA.

[MikeChristianson]

I attempted that approach, initially, but was not successful. I'll give it another try and look for examples.

[balloob]

Please remove this file. We fixed the issue in our tests that left this artifact.

[balloob]

Media path has to be allowed by hass.config.is_allowed_path

[balloob]

This is very inefficient. You are now generating up to 99 values. Prefer

if 199 > resp.status_code < 300:

[balloob]

Shouldn't this method not be called if media_path is not set ?

Also, prefer a guard clause:

if not media_path:
    return

media_type, _ = mimetipes.guess_type(…)

[balloob]

Since media_id is going to be None, why not just return None and you can remove the else.

[MikeChristianson]

@balloob Please have another look, thanks.

[balloob]

Awesome! 🐬 🎉

[MikeChristianson]

Thanks, @balloob! 🎊 Glad I could help the community, too.

[onerealfunnyguy]

Can you please update the component page to include the correct formatting for images, can send txt tweet no problems, yet with the above example using both a local path and http:// I can not get the notify to work once I add the include media code.