akurihara / musictaxonomy

Music Taxonomy lets you express your musical taste in a way that's visual, organized, and delightful!

musictaxonomy

Music Taxonomy lets you express your musical taste in a way that's visual, organized, and delightful! See a live demo here.

It was inspired an infographic created by artist Karl Turner.

Set Up

1. Create a virtual environment and install dependencies.

   $ brew install pyenv
   $ pyenv install 3.7.2
   $ pyenv local 3.7.2
   $ brew install pipenv
   $ pipenv install
   

2. Set up environmental variables

   cp .env.sample .env
   

   Add the following variables to the .env file:

   • SPOTIFY_CLIENT_ID - The client ID of your Spotify application. This can be found at the Spotify developer dashboard.
   • SPOTIFY_CLIENT_SECRET - The client secret of your Spotify application.
   • DATABASE_URL - Database URL specifying which database to connect to locally (e.g. sqlite:///database.db).

3. Install SQLite, create a new database, and initialize tables.

   $ brew install sqlite3
   $ sqlite3 database.db
   $ pipenv run python scripts/initialize_database.py
   

4. Build the React frontend using:

   $ npm install
   $ npm run build
   

Running Locally

Run the server locally from the root directory with:

$ pipenv run python server.py --port=8080

Then, nagivate to localhost:8080 in your browser.

Running Tests

Activate the virtual environment.

$ pipenv shell

Create a test database if you haven't done so already:

$ sqlite3 test_database.db
$ source .env.test && python scripts/initialize_database.py

Run tests with:

source .env.test && nosetests test