blankslate

Blank Slate - A foundation for complex projects


Keywords
blankslate, blank, slate
License
BSD-3-Clause
Install
pip install blankslate==0.1.10

Documentation

Blank Slate

A programmable foundation for complex projects.

Usage

  1. Install Blank Slate: pip install blankslate
  2. Install slates:
    • slate install NAME
    • slate install github:me/myslate
  3. Run your project: slate run

Slates

Slates (slate.sh) are simple scripts, installed to ./slates/.

  • commands.sh:call() adds logging to calls
  • Blank Slate environment variables $BS* available
#!/bin/bash
set -e
source $BSDIR/scripts/commands.sh
call echo "Hello from my awesome script"

Examples

Browse ready-made slates.

Bootstrap the base requirements slate install bootstrap and then slate install EXAMPLE_NAME.

Docker integration

Example Dockerfile

docker build --rm --tag blankslate .
docker run --rm -it -p 8000:9000 --name blankslate blankslate

Project Templates

The example template:

  • config/haproxy.cfg (routing)
  • Procfile (processes)
  • .env (environment variables)
  • packages (optional: package dependencies (pip, npm, ...))
  • run.sh (optional: use something else than Process Boy)