Adding events consumer which provides an example of working with email events

[Taiters]

Resolves #649

Checklist

• I have made a material change to the repo (functionality, testing, spelling, grammar)
• I have read the [Contribution Guide] and my PR follows them.
• I updated my branch with the master branch.
• I have added tests that prove my fix is effective or that my feature works
• I have added necessary documentation about the functionality in the appropriate .md file
• I have added in line documentation to the code I modified

Short description of what this PR does:

This PR adds

• A Dockerized Flask app which provides an example of working with email events
• A readme with guides for
  • Deploying locally with test data
  • Deploying locally with real data (using ngrok)
  • Deploying to Heroku

This repo already contains a Procfile for the email ingress example, so I've suggested copying the events/ dir into a new repo on the users computer as part of the Heroku deploy to keep them separate.

[SendGridDX]

All committers have signed the CLA.

[codecov]

Codecov Report

Merging #660 into v4 will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##               v4     #660   +/-   ##
=======================================
  Coverage   84.35%   84.35%           
=======================================
  Files          36       36           
  Lines         965      965           
  Branches      107      107           
=======================================
  Hits          814      814           
  Misses         93       93           
  Partials       58       58

---

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 edd02e4...84837b7. Read the comment docs.

[thinkingserious]

Hello @Taiters,

Could you please take a moment to sign our CLA so that we can merge this?

Also, could you please merge this against our v4 branch? Thank you!

With Best Regards,

Elmer

[thinkingserious]

Hello @Taiters,

Thanks again for the PR!

It's HACKTOBERFEST! We want to show our appreciation by sending you some special Hacktoberfest swag. If you have not already, could you please fill out this form so we can send it to you? Thanks!

Team SendGrid DX

[Taiters]

Hey @thinkingserious,

I've added my latest changes (docs and a slightly easier way to view events) and updated the base branch to v4.

Let me know if anything else needs added.

Thanks!
Dan

[misterdorm]

LGTM, except I think events/data/events.db should not be part of the PR.

[Taiters]

Yeah well spotted @misterdorm! I've removed that folder from the PR

[42B]

Isn't this what json.load is for?

with open('sample_data.json', 'r') as f:
    return json.load(f)

[Taiters]

@42B yeah you're right. Changed in 84837b7

[thinkingserious]

Hello @Taiters,

Thanks again for the PR!

You have earned 15 out of the 5 points needed to receive glorious SendGrid Hacktoberfest swag.

Please take a moment to checkout this link to find more issues to get you past the required threshold or to simply continue the celebration.

Also, please be sure you have officially registered with us here by November 1, 2018 to qualify.

If you have any questions you can email us at dx+hacktoberfest2018@sendgrid.com.

Thank you and Happy Hacktobering!

Team SendGrid

[Taiters]

Hey, I've noticed this PR still has the WIP label. It's no longer a WIP :)