Whiskython

By Eduardo Cuducos and Gabriel Vicente.

About

This was our very first project in Python, back in 2014. 10 years later, the idea is to use that as a playground to explore Rust bindings in Python projetcs.

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.

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.

Also we are glad to have contributions from Henrique Bastos, Lucretiel, Justin Velluppillai and Chris Loverchio.

Installation

Depends on Python 3.12 (or newer), Poetry and Rust.

Install the Python dependencies

$ poetry install

Install the Rust crates

$ poetry run pip install .

Web server

$ poetry run flask --app whiskyton run

Tests

To run tests:

$ cargo test --no-default-features
$ poetry run pytest

Some tests use your local Firefox through Selenium. So get the server running before running tests. If you do not want to run UI tests, use -k 'not ui'.