<commit_before>#Live From The Fort

A VPR music video series, similar to NPR's [Tiny Desk Concerts](http://www.npr.org/series/tiny-desk-concerts/)

## Releasing Updates

The steps to get set up locally and release new versions when the spreadsheet is
updated. These are commands that should be run from the command line.

1. Clone the repository locally - `<EMAIL>:vprnet/live-from-the-fort.git`
1. Ensure you have Python 2.7 installed
1. [Install `pip`](https://pip.pypa.io/en/latest/installing.html)
1. Install virtualenv - `pip install virtualenv`
1. Change into the project directory - `cd live-from-the-fort`
1. Create a virtual environment for the app - `virtualenv venv`
1. Enter the virtual environment - `source venv/bin/activate`
1. Install the app requirements - `pip install -r requirements.txt`
1. Copy the config file - `cp app/_config.py app/config.py`
1. Configure the values in `app/config.py`
1. Upload the app to AWS S3 - `python app/index.py build`

###To Run Locally

Remove 'build' argument from last step, so:	`python app/index.py`

## Author

[<NAME>](http://twitter.com/mattparrilla)

##Copyright and License

Copyright 2013 Vermont Public Radio

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License.
You may obtain a copy of the License in the LICENSE file, or at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language
governing permissions under the License.<commit_msg>It's a documentation party.<commit_after>#Live From The Fort

A VPR music video series, similar to NPR's [Tiny Desk Concerts](http://www.npr.org/series/tiny-desk-concerts/)

## Releasing Updates

The steps to get set up locally and release new versions when the spreadsheet is
updated. These are commands that should be run from the command line.

1. Clone the repository locally - `<EMAIL>@github.com:vprnet/live-from-the-fort.git`
1. Ensure you have Python 2.7 installed
1. [Install `pip`](https://pip.pypa.io/en/latest/installing.html)
1. Install virtualenv - `pip install virtualenv`
1. Change into the project directory - `cd live-from-the-fort`
1. Create a virtual environment for the app - `virtualenv venv`
1. Enter the virtual environment - `source venv/bin/activate`
1. Install the app requirements - `pip install -r requirements.txt`
1. Copy the config file - `cp app/_config.py app/config.py`
1. Configure the values in `app/config.py`
1. Upload the app to AWS S3 - `python app/index.py build`

### To Run Locally

Remove 'build' argument from last step, so:	`python app/index.py`

## Notes on Interacting with Google Spreadsheets

In May 2015, Google stopped supporting the Google Spreadsheets API, which Live From the Fort used to connect a spreadsheet to the page. We found a good replacement in [gspread](https://github.com/burnash/gspread). Here are a few things to know about our new implementation:

1. To start a new project, head to the [Google Developer's Console](https://console.developers.google.com/project).
1. Click `create project`.
1. Under `APIs`, enable the Google Drive API.
1. In `Credentials` under `OAuth`, create a new Client ID.
1. Select `Service Account`. You'll see a json file incoming with a private_key_id, private_key, client_email, client_id, and type.
1. Save the json file in your project. Be a good person and add it to your gitignore, too.
1. The json file is what gets loaded and opened in sheet.py. Make sure the names match!
1. Finally, *share your google spreadsheet* with the email provided in client_email.
1. You'll also need to `pip install gspread` and `pip install oauth2client`.


##Copyright and License

Copyright 2013 Vermont Public Radio

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License.
You may obtain a copy of the License in the LICENSE file, or at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language
governing permissions under the License.
{'fraction_non_alphanumeric': 0.08393339333933393, 'fraction_numerical': 0.013051305130513051, 'mean_word_length': 4.241745283018868, 'pattern_counts': {'":': 0, '<': 6, '<?xml version=': 0, '>': 6, 'https://': 4, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 1, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6357623', 'n_tokens_mistral': 1299, 'n_tokens_neox': 1245, 'n_words': 613}