moth/docs/devel-server.md

Using the MOTH Development Server

To make puzzle development easier, MOTH comes with a standalone web server written in Python, which will show you how your puzzles are going to look without making you compile or package anything.

It even works in Windows, because that is what my career has become.

Getting It Going

With Docker

If you can use docker, you are in luck:

docker run --rm -t -p 8080:8080 dirtbags/moth-devel

Gets you a development puzzle server running on port 8080, with the sample puzzle directory set up.

Without Docker

If you can't use docker, try this:

apt install python3
git clone https://github.com/dirtbags/moth/
cd moth
python3 devel/devel-server.py --puzzles example-puzzles

Installing New Puzzles

The development server wants to see category directories under puzzles, like this:

$ find puzzles -type d
puzzles/
puzzles/category1/
puzzles/category1/10/
puzzles/category1/20/
puzzles/category1/30/
puzzles/category2/
puzzles/category2/100/
puzzles/category2/200/
puzzles/category2/300/

With Docker

docker run --rm -t -v /path/to/my/puzzles:/puzzles:ro -p 8080:8080 dirtbags/moth-devel

Without Docker

You can use the --puzzles argument to devel-server.py to specify a path to your puzzles directory.