python-flask-picture-factory/README.md

python-flask picture factory

This server provides and caches images based on url-arguments.

Ussage

Place your images in the "/pictures/"-subdirectory.

../pictures
    ├── picture1.png
    ├── picture2.jpg
    ├── picture3

Run the server, either as:

python ./server

or:

/usr/bin/waitress-serve --host 127.0.0.1 --port 5002 --call 'app:createApp'*

Retrive the images with these URLs:

http://server:port/media/picture1.png?x=100&y=200&encoding=webp
http://server:port/media/picture2.jpg?x=100
http://server:port/media/picture3.jpg?y=200&encoding=png

You may omitt any of the parameters. Not giving any parameters will return the original image. You must always name the original picture in your URL, even if you want a different encoding.

Other possible URL-parameters:

In addition to encoding, scaleX and scaleY you may also use the following parameters:

force=True/False -> apply the x/y-values as given, cut off image when necessary
cacheTimeout=SECONDS -> add a cache timeout header witht the given value to the response

Futher explanation

I wrote a small article with some more example on how to best use this to optimize your website -if you want to use it for that: Medium