Initial Release

Author: Roach

.DS_Store

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2016 Slack Technologies, Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

LICENSE

@@ -0,0 +1,118 @@
+Slack Events API adapter for Python
+===================================
+
+The Slack Events Adapter is a Python-based solution to receive and parse events
+from Slack’s Events API. This library uses an event emitter framework to allow
+you to easily process Slack events by simply attaching functions
+to event listeners.
+
+🤖  Installation
+------------
+
+.. code::
+
+  pip install slackeventsapi
+
+🤖  App Setup
+--------------------
+
+Before you can use the `Events API`_ you must
+`create a Slack App`_, and turn on
+`Event Subscriptions`_.
+
+.. _Events API: https://api.slack.com/events-api
+.. _create a Slack App: https://api.slack.com/apps/new
+.. _Event Subscriptions: https://api.slack.com/events-api#subscriptions
+
+💡  When you add the Request URL to your app's Event Subscription settings,
+Slack will send a request containing a `challenge` code to verify that your
+server is alive. This package handles that URL Verification event for you, so
+all you need to do is start the example app, start ngrok and configure your
+URL accordingly.
+
+✅  Once you have your `Request URL` verified, your app is ready to start
+receiving Team Events.
+
+🔑  Your server will begin receiving Events form Slack's Events API as soon as a
+user has authorized your app.
+
+🤖  Development workflow:
+------------------------------
+
+(1) Create a Slack app on https://api.slack.com/apps/
+(2) Add a `bot user` for your app
+(3) Start the example app on your **Request URL** endpoint
+(4) Start ngrok and copy the **HTTPS** URL
+(5) Add your **Request URL** and subscribe your app to events
+(6) Go to your ngrok URL (e.g. https://myapp12.ngrok.com/) and auth your app
+
+**🎉 Once your app has been authorized, you will begin receiving Slack Events**
+
+    ⚠️  We strongly discourage using ngrok for
+    anything but development. It’s not well-suited for production use.
+
+    💡  See the example app included in this repository for more information
+    on implementing OAuth.
+
+🤖  Usage
+-----
+  **⚠️  Keep your app's credentials safe!**
+
+  - For development, keep them in virtualenv variables.
+
+  - For production, use a secure data store.
+
+  - Never post your app's credentials to github.
+
+.. code:: python
+
+  SLACK_VERIFICATION_TOKEN = os.environ["SLACK_VERIFICATION_TOKEN"]
+
+Create a Slack Event Adapter for receiving actions via the Events API
+
+.. code:: python
+
+  from slackeventsapi import SlackEventAdapter
+
+  slack_events_adapter = SlackEventAdapter(SLACK_VERIFICATION_TOKEN, endpoint="/slack_events")
+
+Create an event listener for "reaction_added" events and print the emoji name
+
+.. code:: python
+
+  @slack_events_adapter.on("reaction_added")
+  def reaction_added(event):
+    emoji = event.get("reaction")
+    print(emoji)
+
+
+Start the server on port 3000
+
+.. code-block:: python
+
+  slack_events_adapter.start(port=3000)
+
+For a comprehensive list of available Slack `Events` and more information on
+`Scopes`, see https://api.slack.com/events-api
+
+🤖  Examples
+--------
+
+See `example.py`_ for usage examples. This example also utilizes OAuth and the
+SlackClient Web API client.
+
+.. _example.py: /example/
+
+🤔  Support
+-------
+
+Need help? Join `dev4slack`_ and talk to us in `#slack-api`_.
+
+You can also `create an Issue`_ right here on GitHub.
+
+.. _Events API: https://api.slack.com/events-api
+.. _create a Slack App: https://api.slack.com/apps/new
+.. _Event Subscriptions: https://api.slack.com/events-api#subscriptions
+.. _dev4slack: http://dev4slack.xoxco.com/
+.. _#slack-api: https://dev4slack.slack.com/messages/slack-api/
+.. _create an Issue: https://github.com/slackapi/python-slack-events-api/issues/new