command line interface

A yaml file is rendered via

python clipig.py demo.yaml -o images/

to produce a PNG file at images/demo.png. When called again, images/demo-1.png will be created, images/demo-2.png the third time, aso..

Generally, clipig.py never overwrites existing files.

The -o (or --output) option is not mandatory but it's good practice to store those images in separate directories because they tend to grow in number.

You can specify an actual filename with -o /path/image.png, otherwise the name of the yaml file is used. Still, if /path/image.png already exists, /path/image-1.png will be created.

CLIPig also stores a <filename>.yaml file besides the image, if there does not exist one already, which holds the complete configuration with all defaults and the runtime in seconds as comment on the top.

Multiple yaml files are merged into one set of parameters, e.g.:

python clipig.py best-meta-settings.yaml specific.yaml

will parse best-meta-settings.yaml and then add anything from sepcific.yaml on top. List entries like targets will be appended to the previous list.