justinvelluppillai / whiskyton

Whiskys, find whiskies that you like!

Whiskython

• Official page: http://whiskyton.herokuapp.com/
• Version: 0.0.1 (Jan. 11h 2014)
• Authors: Eduardo Cuducos and Gabriel Vicente

About

This web based app uses an open database about whisky to help you find whiskys you'd probably like. It uses mathematics to run through the tastes classified in that database, and to find the best matches. We were inspired by this data visualization shared on Reddit.

What really matters

This is our very first project in Python (and we are not professional coders) -- so all feedback is important to help us through our learning process. Don't hesitate to criticize our code and software design! To be true, that is what we are expecting :)

Installation

Get your virtualenv and PostgreSQL running.

Check if the access data to your local PostgreSQL server (user, password and database) is correct at config.py. Look for the first instance of the variable SQLALCHEMY_DATABASE_URI (the second instance of this variable is set to make the app work under Heroku server).

Install the dependencies:

$ pip install -r requirements.txt

If you already have an old version of Whiskython database, drop it:

$ ./db_drop_tables.py

Then run the following commands (you might have to give the right permissions to each file by typing chmod a+x [filename], otherwise you won't be able to execute them):

$ ./db_create.py
$ ./db_migrate.py
$ ./db_add_whisky_data.py
$ ./db_add_correlations.py

Finally ./run.py to start your server.

Thanks

We had a lot of Python teachers, we are so glad we could count on you, guys:

• Joe Warren, Scott Rixner, John Greiner and Stephen Wong, from the An Introduction to Interactive Programming in Python course at Coursera
• Allen B. Downey and Jeff Elkner, authors of Think Python: How to Think Like a Computer Scientist
• Miguel Grinberg and his The Flask Mega-Tutorial
• Everyone who have ever contributed to The Hitchhiker’s Guide to Python!
• Everyone who helped at Reddit, mainly these guys here and here

In sum, we had the best teachers of the world in Python. Any mistake here is completely our fault.

License, copyright and shit

Do whatever you want with this code, but try to remember to mention the source.