Skip to content
♥ Taylor Swift Lyric Generator ♥
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore New repo from the mini-template. Oct 8, 2015
.travis.yml Enable codecov reports. Jan 15, 2016
README.rst Adding badges. Jan 15, 2016
requirements-dev.txt Update dev requirements. Jan 15, 2016


Taytay Quick Start

Below you will find basic setup and deployment instructions for the taytay project. To begin you should have the following applications installed on your local development system:

Getting Started

First clone the repository from Github and switch to the new directory:

$ git clone[ORGANIZATION]/taytay.git
$ cd taytay

To setup your local environment you should create a virtualenv and install the necessary requirements:

# Check that you have python3.4 installed
$ which python3.4
$ mkvirtualenv taytay -p `which python3.4`
(taytay)$ make dev

Configurable settings are managed with django-dotenv. It reads environment variables located in a file name .env in the top level directory of the project. The previous command make dev creates new .env file with a new SECRET_KEY value set.

Create the Postgres database and run the initial migrate:

(taytay)$ createdb -E UTF-8 taytay
(taytay)$ python migrate

You should now be able to run the development server:

(taytay)$ python runserver

Connecting to the API

To connect to the API at, you'll need to create a user using the following curl command

$ curl -H "Content-Type: application/json" -X POST -d
'{"username": "yourusername","email_address": "youremail",
"password": "yourpassword","password_confirm": "yourpassword"}'

You should receive an API key in the response. To make use of this key, you should include it in your .env file:

$ echo 'BAELOR_API_KEY="<api key>"' >> .env

Where <api key> would be replaced with your actual API key value.

Get song data

To get song data run the fetch_song_data command

$ python fetch_song_data


The Makefile for this project has a number of helpful commands for testing and checking code quality. Below is a brief description of the commands

  • make test - Runs the full test suite and reports test coverage
  • make lint - Runs a set of subcommands to check code quality
  • make lint-py - Runs the code through flake8 for static analysis
  • make lint-migrations - Runs Django's checks for model changes without migrations
  • make lint-django - Runs Django's system checks with the base settings
  • make lint-deploy - Runs Django's system checks for deployment
You can’t perform that action at this time.