<commit_before><commit_msg>Add basic readme.<commit_after># PushBullet.py

This is a python library for the wonderful [PushBullet](https://www.pushbullet.com) service.
It allows you to send push notifications to Android devices.  

In order to use the API you need an API key that can be obtained [here](https://www.pushbullet.com/settings). This is user specific and is used instead of passwords.

## Requirements

 - Python. Tested on 2.7 and 3.2
 - The wonderful requests library.

## Usage

The library is work in progress. More features will be added soon.

```Python
from pushbullet import PushBullet
pb = PushBullet("API_KEY")

# See what devices we controll
print(pb.devices())
[{'dev_id: '12435', 'name': ""}]
# Get a device by it's numeric id
nexus = pb.get(12345)
# Push a text note. The underlying request object is returned for all pushes.
note = nexus.push_note("Hello!", "Hello Nexus! Sent from python.")
print(note.status_code)
200
# Push a list
l = nexus.push_note("Shopping list", ["Milk", Eggs", "Bacon"])
```

{'fraction_non_alphanumeric': 0.11273080660835763, 'fraction_numerical': 0.01652089407191448, 'mean_word_length': 4.4787234042553195, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1809678', 'n_tokens_mistral': 342, 'n_tokens_neox': 309, 'n_words': 130}