Makefile

Nearly everything about Bookie is managed via the Makefile. If you’re not familiar with Makefiles, it’s worth a little time to get your head around.

Commonly Used Make Targets

run

This command will start up the Bookie application along with the combo loader needed to serve the Javascript for Bookie.

stop

This will kill the running servers started up from the make run.

js

This command will check for updated Javascript library files and, if required, copy changed files to the build directory and minimize them.

run_dev

When doing development you might want some help keeping things “built” while you work. This command will also start up the sass watch process and a python script that will auto build changed Javascript files for you. This is how I tend to work and debug. For production purposes though, make run does everything you need.

stop_dev

This will kill things started via make run_dev.

test

Run the Python tests.

jstest

Open up all of the Javascript tests in the browser, one per tab.

db_up

Run any database migrations.

db_new

Start out a new migration file. Make sure to pass desc=”What is this migration”.

clean

This will wipe the majority of the built files and resources. Think of it as a little bit of a hard reset.

all

Should recover froma a make clean and perform steps just as checking all deps are installed, the database is up to date, and the Javascript and CSS are up to date.

Table Of Contents

Previous topic

Change Log

Next topic

Setting Up Email Server

This Page