ifttt 0.2.2

A Pythonic interface for building IFTTT plugins routed over email.

# ifttt (If That Then This)
`ifttt` is a simple package for connecting [IFTTT](http://ifttt.com)
channels with your service via email.

## what?

[IFTTT](http://ifttt.com) 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)


[](https://ifttt.com/recipes/229283-if-twitter-then-data)


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.


```python
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 msg
```

### If This Then Say YO


Make an "IfThis" Yo Recipe that has an "ThenThat"
mail step (customize the address to match your configuration)


[](https://ifttt.com/recipes/229285-if-yo-then-data)

Now write a similar python script as above:

```python
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 msg
```

This basic approach works for every channel!

## Input Format

All email messages routed to `thenthis` steps
are processed to have the following
format (a simple python dictionary):

```python
{
'id': '[e-mail]',
'subject': 'yo',
'from': '[e-mail]',
'to': '[e-mail]',
'timestamp': 1418553603, # utc timestamp when message was processed
'body': { # parsed body
'received_at': 'December 13, 2014 at 11:45PM',
'from': 'ABELSONLIVE'
}
}
```

## Configuration

You can pass more parameters into the decorator:

```python
from ifttt import ifthat

config = {
subject='yo',
pattern="{{ReceivedAt}}|||||{{From}}|||||",
username='[e-mail]',
password='123456',
server='mail.example.com',
port=993,
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
}
@ifthat(**config)
def yo(msg):
import os
os.system('say yo from {from} &'.format(**msg['body']))
return msg

for msg in yo():
print msg
```

You can also simply inherit from the core class and overwrite the `thenthis` method:

```python
from ifttt import IfThat

class Yo(IfThat):
def __init__(self):
IfThat.__init__(self,
subject = 'yo',
pattern="{{ReceivedAt}}|||||{{From}}|||||",
username='[e-mail]',
password='123456',
server='mail.example.com',
port=993,
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
)

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 msg
```

Alternatively, you can set these environmental variables:

```bash
export IFTTT_USERNAME='[e-mail]'
export IFTTT_PASSWORD='password'
export IFTTT_SERVER='mail.domain.com'
export IFTTT_PORT=993
```

## TODO
- [ ] Delete Messages
- [ ] Support for more complicated email searches.
- [ ] Instead of caching, update last update and filter for messages after that point?