Added IFTTT plugin
This commit is contained in:
parent
006a6e2390
commit
32838efa36
1 changed files with 84 additions and 0 deletions
84
platypush/plugins/ifttt.py
Normal file
84
platypush/plugins/ifttt.py
Normal file
|
@ -0,0 +1,84 @@
|
||||||
|
import requests
|
||||||
|
|
||||||
|
from platypush.message import Message
|
||||||
|
from platypush.plugins import Plugin, action
|
||||||
|
|
||||||
|
class IftttPlugin(Plugin):
|
||||||
|
"""
|
||||||
|
This plugin allows you to interact with the IFTTT maker API
|
||||||
|
<https://ifttt.com/maker_webhooks> to programmatically trigger your own
|
||||||
|
IFTTT hooks from Platypush - e.g. send a tweet or a Facebook post, create a
|
||||||
|
Todoist item or a Trello task, trigger events on your mobile device, or run
|
||||||
|
any action not natively supported by Platypush but available on your IFTTT
|
||||||
|
configuration.
|
||||||
|
|
||||||
|
Requires:
|
||||||
|
|
||||||
|
* **requests** (``pip install requests``)
|
||||||
|
|
||||||
|
Some example usages::
|
||||||
|
|
||||||
|
# Execute a GET request on a JSON endpoint
|
||||||
|
{
|
||||||
|
"type": "request",
|
||||||
|
"action": "http.request.get",
|
||||||
|
"args": {
|
||||||
|
"url": "http://remote-host/api/v1/entity",
|
||||||
|
"params": {
|
||||||
|
"start": "2000-01-01"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# Execute an action on another Platypush host through HTTP interface
|
||||||
|
{
|
||||||
|
"type": "request",
|
||||||
|
"action": "http.request.post",
|
||||||
|
"args": {
|
||||||
|
"url": "http://remote-host:8008/execute",
|
||||||
|
"json": {
|
||||||
|
"type": "request",
|
||||||
|
"target": "remote-host",
|
||||||
|
"action": "music.mpd.play"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
"""
|
||||||
|
|
||||||
|
_base_url = 'https://maker.ifttt.com/trigger/{event_name}/with/key/{ifttt_key}'
|
||||||
|
|
||||||
|
def __init__(self, ifttt_key, *args, **kwargs):
|
||||||
|
"""
|
||||||
|
:param ifttt_key: Your IFTTT Maker API key. Log in to IFTTT and get your key from <https://ifttt.com/maker_webhooks>. Once you've got your key, you can start creating IFTTT rules using the Webhooks channel.
|
||||||
|
:type ifttt_key: str
|
||||||
|
"""
|
||||||
|
|
||||||
|
super().__init__(*args, **kwargs)
|
||||||
|
self.ifttt_key = ifttt_key
|
||||||
|
|
||||||
|
|
||||||
|
@action
|
||||||
|
def trigger_event(self, event_name, values=None):
|
||||||
|
"""
|
||||||
|
Send an event to your IFTTT account
|
||||||
|
|
||||||
|
:param event_name: Name of the event
|
||||||
|
:type event_name: str
|
||||||
|
|
||||||
|
:param values: Optional list of values to be passed to the event. By convention IFTTT names the values as ``value1,value2,...`.
|
||||||
|
:type values: list
|
||||||
|
"""
|
||||||
|
|
||||||
|
url = self._base_url.format(event_name=event_name, ifttt_key=self.ifttt_key)
|
||||||
|
if not values:
|
||||||
|
values = []
|
||||||
|
|
||||||
|
response = requests.post(url, json={'value{}'.format(i+1): v
|
||||||
|
for (i,v) in enumerate(values)})
|
||||||
|
|
||||||
|
if not response.ok:
|
||||||
|
raise RuntimeError("IFTTT event '{}' error: {}: {}".format(event_name, r.status_code, r.reason))
|
||||||
|
|
||||||
|
|
||||||
|
# vim:sw=4:ts=4:et:
|
||||||
|
|
Loading…
Reference in a new issue