placeany/README.md

# Placeany

A quick and simple service for getting pictures of whatever-you-want
for use as placeholders in your designs or code. Just put your image
size (width & height) after the URL and you'll get a placeholder.

Similar URL API as [Placekitten]([http://placekitten.com](https://web.archive.org/web/20110504042732/http://placekitten.com/)).

There is also a bookmarklet service which works the same as
[Horse_ebookmarklet]([http://www.heyben.com/horse_ebookmarklet/](https://web.archive.org/web/20120223050454/http://www.heyben.com/horse_ebookmarklet/)).

## Installation

First, create an image collection.

1. Create the directory `./images`.
1. Get some images, from [Unsplash](https://unsplash.com) or similar.
1. Place images in image directory.

### Run as local web server

1. Go to the code: `cd path/to/holder`. Copy `images` folder to it.
1. Create and activate a virtualenv.
1. Get dependencies in place: `pip install -r requirements.txt`
1. Start the app: `waitress-serve --host 127.0.0.1 --port 5099 wsgi:app`
1. Go to [http://localhost:5099](http://localhost:5099) in your web browser.
1. Done!

### Run as Container

The most easy and portable way to use this is to use Docker or Podman.
In this build, waitress is used for production readyness. Port 5099 is
instead used.

    podman build .
    podman run -it -p 5099:5099 -v ./images:/app/images <container id>

If you wish to embed images in container as well, use alternate
Containerfile.

    podman build -f Containerfile.aio --build-arg images=./images .
    podman run -it -p 5099:5099 <container id>

## Example calls

    # generates an image, 200px wide and 300px tall
    http://localhost:5000/200/300

    # generates an image in grayscale, 200px wide and 300px tall
    http://localhost:5000/g/200/300