jsreport 0.2.3

Simple tool to pull basic reporting data out of JustServe (https://www.justserve.org/).

# JustServe Reports
Simple tool to pull basic reporting data out of JustServe (https://www.justserve.org/).

## Background
JustServe is a wonderful resource to bring volunteers and service organizations together. For those that are responsible for training and awareness, however, the reporting tools are...lacking. How is one to measure whether more projects are being added to the site? This script aims to help answer that question.

## What It Does
`jsreport.py` is a script that interacts with the JustServe website to tell you how many projects are listed near a specific zipcode. You can specify the zipcode and search radius, along with some technical details.

## Usage
$ ./jsreport.py --help
usage: jsreport.py [-h] [-r {5,10,15,25,50,75}]
[-d {firefox,chrome,phantomjs}] [-o {human,csv,json}]
zipcode

Retrieve the number of JustServe projects at a zipcode.

positional arguments:
zipcode The five digit zipcode at the center of the search
radius.

optional arguments:
-h, --help show this help message and exit
-r {5,10,15,25,50,75}, --radius {5,10,15,25,50,75}
The search radius, in miles. Defaults to 5.
-d {firefox,chrome,phantomjs}, --driver {firefox,chrome,phantomjs}
The WebDriver to use. Defaults to firefox.
-o {human,csv,json}, --output {human,csv,json}
The output format. Defaults to human-readable.


## Examples
$ ./jsreport.py 20500
6 projects within a 5 mile radius of 20500
$ ./jsreport.py -r 10 20500
29 projects within a 10 mile radius of 20500
$ ./jsreport.py -r 15 20500
48 projects within a 15 mile radius of 20500
$ ./jsreport.py -r 25 20500
70 projects within a 25 mile radius of 20500
$ ./jsreport.py -r 50 20500
96 projects within a 50 mile radius of 20500
$ ./jsreport.py -r 75 20500
106 projects within a 75 mile radius of 20500

## Dependancies/Setup
* This is a Python script, tested with version 2.7.11, but it should work with others
* I highly recommend using a virtualenv, if you can
* Use `pip` to install the python requirements:
`pip install -r requirements.txt`
* If you want to use the Chrome or PhantomJS Selenium WebDrivers, you will need to ensure they are installed.
* The `chromedriver-installer` package is in the `requirements.txt` file. Your mileage may vary.

Please note: I do not provide technical support for environment setup; you are on your own for that. I will respond to pull requests for bug fixes, though.