Drawing Tool

Command line tool that reads drawing instructions from an input file and writes the result in an output file.

Instructions:

C w h: creates a new canvas of width w and height h.
L x1 y1 x2 y2: creates a new line from (x1, y1) to (x2, y2) using the x character.
R x1 y1 x2 y2 B x y c: create a new rectangle, whose upper left corner is (x1, y1) and lower right corner is (x2, y2) using the x character.
B x y c: fills the entire area connected to (x, y) with "colour" c.

Example input:

C 20 4
L 1 2 6 2
L 6 3 6 4
R 16 1 20 3
B 10 3 o

Expected output:

----------------------
|                    |
|                    |
|                    |
|                    |
----------------------
----------------------
|                    |
|xxxxxx              |
|                    |
|                    |
----------------------
----------------------
|                    |
|xxxxxx              |
|     x              |
|     x              |
----------------------
----------------------
|               xxxxx|
|xxxxxx         x   x|
|     x         xxxxx|
|     x              |
----------------------
----------------------
|oooooooooooooooxxxxx|
|xxxxxxooooooooox   x|
|     xoooooooooxxxxx|
|     xoooooooooooooo|
----------------------

Quick start

Create a input.txt file with the drawing instructions:

$ cat > ~/input.txt << EOF
C 20 4
L 1 2 6 2
L 6 3 6 4
R 16 1 20 3
B 10 3 o
EOF

$ git clone https://github.com/pv8/drawingtool
$ cd drawingtool
$ pip install .
$ drawingtool --input ~/input.txt

Note: It's recommended to install inside a virtualenv.

The result will be written in a output.txt file.

It's also possible to output the results to stdout:

$ drawingtool --input ~/input.txt --stdout

To see all options:

$ drawingtool --help

With Docker

If you like Docker, build the image:

$ docker build -t drawingtool .

And run with helper script run.sh:

$ ./run.sh drawingtool < input.txt

Development environment

Running tests

With Docker:

Build the image:

$ docker build -t drawingtool .

Then run with the helper script run.sh

$ ./run.sh tests

Without Docker:

Install the development requirements:

(drawingtool)$ pip install -r requirements_dev.txt

Then run with pytest:

(drawingtool)$ pytest --cov-report term-missing --cov=.

Debugging

Include the ipdb breakpoint (import ipdb; ipdb.set_trace()) and run:

With Docker:

$ ./run.sh tests

Without Docker:

$ (drawingtool)$ pytest -s

Linting

With Docker:

$ ./run.sh pep8

Without Docker:

$ (drawingtool)$ flake8 --statistics .

License

MIT