Get Started

Requirements

We will need to install python3.6 with sqlite3 support. This can be done using the system package management, downloaded from http://www.python.org, or compiled from sources.

• Installing from the system package management:
  • OSX: port install python36
  • FreeBSD: pkg install python36 py36-sqlite3
  • Linux: apt-get install ???
• Installing from sources:
  • Download from http://www.python.org
  • unxz Python-3.6.tar.xz
  • tar xvf Python-3.6.tar
  • cd Python-3.6
  • ./configure --prefix=$HOME/.local/bin
  • make && make install

Next install pip (if not yet installed):

python36 -m ensurepip --user

This will install pip in your account under ~/.local/bin. In the end you should be able to run pip3 --version and python3 -c "import sqlite3" without errors (sometimes pip3 is pip, pip3.6 or pip-3.6).

Install additional python packages locally on the user area:

pip install --user tornado sqlalchemy pyyaml pygments markdown bcrypt

These are usually installed under

• OSX: ~/Library/python/3.6/lib/python/site-packages/
• Linux/FreeBSD: ~/.local/lib/python3.6/site-packages/

Note: If you want to always install python modules on the user account, edit the pip configuration file ~/.config/pip/pip.conf (FreeBSD, Linux) or Library/Application Support/pip/pip.conf (OSX) and add the lines

[global]
user = yes

Installation

Replace USER by your bitbucket username:

cd path/to/some/directory
git clone https://USER@bitbucket.org/USER/aprendizations.git

A directory aprendizations will be created with the software:

cd aprendizations

Configuration

First we need to create a database:

./initdb.py                 # initialize with a single user `0`  and empty password
./initdb.py --help          # for the available options

We also need certificates for https. Generate selfsigned certificates using openssl:

cd certs
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes
cd ..

Run a demonstration:

./serve.py