Course configuration

Roman reads configuration file course.yml, course.yaml or course.json and then runs course build steps defined in steps list. Steps can be strings describing docker image or objects containing at least img. Here is small example:

# course.yml
---
version: 2
theme: aplus

steps:
  - hello-world
  - img: apluslms/compile-rst
    cmd: make touchrst html
    mnt: /compile
    env:
      STATIC_CONTENT_HOST: "http://localhost:8080/static/default"

Installation

You can use prebuild binaries with graphical user inteface from releases page. Alternatively, you can install cli version via pip pip3 install --user apluslms-roman[docker], which will add $HOME/.local/bin/roman. Presuming you have that in your PATH, then you can execute roman --help to get started.

Developing

This repository curently holds few different python packages, which makes things problematic. There is set of scripts under ./scripts/ to make this ok.

For example, you can setup development environment for you:

# install venv (you can skip this part)
python3 -m venv venv
# or
python3 -m virtualenv -p python3 venv
# activate
. ./venv/bin/activate

# install roman packages
./scripts/install_for_development.sh

To run tests:

# run all tests in the repo
#  creates virtual env, if none is active
./scripts/run_all_tests.sh

# run all tests for a package
python3 setup.py test
python3 -m unittest discover -t . -s tests

# run a single test file
python3 -m unittest tests.test_cli

# run a single test class
python3 -m unittest tests.test_cli.TestGetConfig