README.md

Waitress

Dependencies

• Go

Installation

• go get
• go build

Running go build will result in a binary named waitress being created. This can then be moved to the /usr/local or the preferred install path.

Running

Usage of waitress: -binding="0.0.0.0": bind the server to the specified ip -config="": conf file (see config.yml.sample) -port="3000": run the server on the specified port

Image processing

The format is specified as the first part of the URL path. The syntax is similar to the geometry syntax of ImageMagick.

Syntax

s ::= ( width | 'x' height | width 'x' height ) ( '#' | '^' | '!' )?
bg ::= (
    '#' [0-9A-Fa-f]{6} |
    'rgb(' \d{1,3} ',' \d{1,3} ',' \d{1,3} ')' |
    'rgba(' \d{1,3} ',' \d{1,3} ',' \d{1,3} ',' \d+ (\.\d+)? ')' |
    'hsl(' \d{1,3} ',' \d{1,3} '%,' \d{1,3} '%)' |
    'hsla(' \d{1,3} ',' \d{1,3} '%,' \d{1,3} '%,' \d+ (\.\d+)? ')'        
)

Size

s=700: Resize the image to have a width of 700 (maintains aspect ratio) s=x700: Resize the image to have a height of 700 (maintains aspect ratio) s=700x700: Resize the image to have a width and height of 700. This maintains the aspect ratio and pads image with a background color.

Options

#: Crop the image to fill the specified size (This need to be URL escaped) ^: The size specified is a minimum. The resulting image may be bigger *: The size specified is a maximum. The resulting image may be smaller !: Do not preserve the aspect ratio.

Examples

Support both syntaxes?

• http://example.com/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg?s=700

• http://example.com/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg?s=x700

• http://example.com/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg?s=700x700

• http://example.com/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg?s=700^

• http://example.com/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg?s=700x700^

• http://example.com/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg?s=700x467%23

• http://example.com/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg?s=700x467!

• http://example.com/s%3D700/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg

• http://example.com/s%3Dx700/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg

• http://example.com/s%3D700x700/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg

• http://example.com/s%3D700^/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg

• http://example.com/s%3D700x700^/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg

• http://example.com/s%3D700x467%23/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg

• http://example.com/s%3D700x467!/ec64fc472479c2cddada6ad58e802d492b5936e3.jpg

TODO: Makefile