ifttt (If That Then This)
ifttt is a simple package for connecting IFTTT
channels with your service via email.
What?
IFTTT provides an interface to an amazing number of services, but since they lack their own API and have a closed submission process, it's difficult to integrate it into your own applications.
By creating a set of transformations for routing IFTTT channels to email,
we can pass structured data to custom email-listener functions – ifthat
which can be routed to an arbitrary thenthis callback function.
Installation
requires gevent and pytz
pip install ifttt
Usage
If That Then Say Tweet ...
Make an "IfThis" Twitter Recipe that has an "ThenThat" mail step (customize the address to match your configuration)
Now write a python script to read from this inbox, filtered by the subject, copy the pattern from the "body" field, and pass the message to a custom function that speaks the tweet text.
from ifttt import ifthat
@ifthat('twitter', pattern = "{{UserName}}|||||{{LinkToTweet}}|||||{{Text}}|||||")
def twitter(msg):
import os
os.system('tweet from {text}'.format(**msg['body']))
return msg
for msg in twitter():
print msgIf This Then Say YO
Make an "IfThis" Yo Recipe that has an "ThenThat" mail step (customize the address to match your configuration)
Now write a similar python script as above:
from ifttt import ifthat
@ifthat('yo', pattern="{{ReceivedAt}}|||||{{From}}|||||")
def yo(msg):
import os
os.system('say yo from {from} &'.format(**msg['body']))
return msg
for msg in yo():
print msgThis basic approach works for every channel!
Schema
Body PatternFormat
All email bodies (the "pattern") should be format as follows:
pattern = "{{Ingredient1}}||||{{Ingredient2}}||||"This pattern ensures that new channels can be configured simply
by separating all of its ingredients with 5 pipes (||||).
Messsage
All email messages routed to thenthis steps
are processed to have the following format (a simple python dictionary):
{
'id': '548d15ea3c46c_119282d32c497a2@ip-10-180-52-134.mail',
'subject': 'yo',
'from': 'gmail@example.com',
'to': 'brian@newslynx.org',
'timestamp': 1418553603, # utc timestamp when message was processed
'body': { # parsed body (as specified by `pattern`)
'received_at': 'December 13, 2014 at 11:45PM',
'from': 'ABELSONLIVE'
}
}If no pattern is specified, the format will be as follows:
{
'id': '548d15ea3c46c_119282d32c497a2@ip-10-180-52-134.mail',
'subject': 'yo',
'from': 'gmail@example.com',
'to': 'brian@newslynx.org',
'timestamp': 1418553603, # utc timestamp when message was processed
'body': { # raw contents of email.
'raw': 'December 13, 2014 at 11:45PM|||||ABELSONLIVE|||||'
}
}Configuration
You can pass more parameters into the decorator:
from ifttt import ifthat
config = dict(
subject = 'yo', # subject line filter
pattern="{{ReceivedAt}}|||||{{From}}|||||", # pattern for ifttt input
username='username@example.com', # imap username (the email to send things to)
password='123456', # imap password
server='mail.example.com', # imap server
port = 993, # imap port
cache_size = 100, # how many message ids to keep track in the cache (non-persistent),
num_workers = 5, # how many workers for the processing queue.
refresh = 120, # how often to refresh the inbox ,
noise = 0.2 # random noise to add to refresh.
)
@ifthat(**config)
def yo(msg):
import os
os.system('say yo from {from} &'.format(**msg['body']))
return msg
for msg in yo():
print msgYou can also simply inherit from the core class and overwrite the thenthis method:
from ifttt import IfThat
class Yo(IfThat):
def __init__(self):
IfThat.__init__(self,
subject = 'yo', # subject line filter
pattern="{{ReceivedAt}}|||||{{From}}|||||", # pattern for ifttt input
username='username@example.com', # imap username (the email to send things to)
password='123456', # imap password
server='mail.example.com', # imap server
port = 993, # imap port
cache_size = 100, # how many message ids to keep track in the cache (non-persistent),
num_workers = 5, # how many workers for the processing queue.
refresh = 120, # how often to refresh the inbox ,
noise = 0.2 # random noise to add to refresh.
)
def thenthis(self, msg):
import os
os.system('say yo from {from} &'.format(**msg['body']))
return msg
yo = Yo()
for msg in yo.listen():
print msgAlternatively, you can set these environmental variables:
export IFTTT_USERNAME='username@domain.com'
export IFTTT_PASSWORD='password'
export IFTTT_SERVER='mail.domain.com'
export IFTTT_PORT=993TODO
- Delete Messages
- Support for more complicated email searches.
- Instead of caching, update last update and filter for messages after that point?
