Install Twitter Tap using [pip](http://www.pip-installer.org/)
- pip
- mongodb
- virtualenvwrapper or virutalenvwrapper-win if on windows (optional but highly recommended)
## Before you start ##
Please follow this link https://apps.twitter.com/ and create a twitter app. You will need the consumer key and consumer secret to access the twitter API.
## Installation ##
### Creating the environment ###
Create a virtual python environment for the project.
If you're not using virtualenv or virtualenvwrapper you may skip this step.
Please follow this link https://apps.twitter.com/ and create a twitter app. You will need the consumer key and consumer secret to access the twitter API.
```bash
# Using twitter tap #
cd twitter-tap
pip install-r requirements.txt
```
### Copy and edit the settings file ###
Run Twitter Tap in the command line like this.
```bash
```bash
cp __settings.py settings.py
tap
vi settings.py
```
```
## Show help text ##
### Show help text ###
```bash
```bash
python tap.py-h
tap-h
```
```
## Executing a query ##
### Executing a query ###
To execute a query you must provide a **query**, the **consumer secret** and either the **consumer key** or the access token. Consumer key and secret can be obtained at the http://apps.twitter.com/ website, while the access token will be obtained when first connecting with the key and secret.
```bash
```bash
python tap.py-q"miley cyrus"-v DEBUG
tap --consumer-key CONSUMERKEY --consumer-secret CONSUMERSECRET-q"miley cyrus"-v DEBUG
