tgapp-placeholder 1.0.1
Placeholder image on the fly for Turbogears2
License: WTFPL
Keywords: turbogears2.application placeholder dummy image

+------------+------------+-----------+-----------+
|     |ph|   |    |nc|    |   |pm|    |    |ss|   |
+------------+------------+-----------+-----------+


.. |ph| image:: http://placehold.it/200
.. |nc| image:: http://www.placecage.com/gif/200/200
.. |pm| image:: http://www.fillmurray.com/200/200
.. |ss| image:: https://www.stevensegallery.com/200/200
   
.. image:: https://img.shields.io/pypi/v/tgapp-placeholder.svg   
   :alt: PyPI   
   :target: https://pypi.org/project/tgapp-placeholder/

About tgapp-placeholder
-------------------------

**tgapp-placeholder** is a Pluggable application for `TurboGears2 <http://turbogears.org/>`_ that allows placeholder images generation on the fly.
Inspired by http://dummyimage.com/ and https://github.com/darkrho/django-dummyimage.

Installing
-------------------------------

placeholder can be installed both from pypi or from github::

    pip install tgapp-placeholder

should just work for most of the users

Plugging placeholder
----------------------------

In your application *config/app_cfg.py* import **plug**::

    from tgext.pluggable import plug

Then at the *end of the file* call plug with placeholder::

    plug(base_config, 'placeholder')

You will be able to access the plugged application at
*http://localhost:8080/placeholder*.

Using placeholder
-----------------

You are now able to get your fake images by calling::

  http://you-application/placeholder/{width} #for a square image
  http://you-application/placeholder/{width}x{height}
  http://you-application/placeholder/{width}x{height}?text={some text value}

actually the parameters you can play with are:
    * **text** : a custom online text wich size is calculated to fit your image width
    * **bgcolor** : the background color in HEX rgb form (default set to 'DDDDDD')
    * **color** : the text color in HEX rgb form (default set to '888888')
    * **format** : available formats available `here <http://pillow.readthedocs.org/en/latest/handbook/image-file-formats.html>`_ (default set to PNG)
    * **font_size** : font_size of the eventtual text. If none is provided it is automagically calculated to fit the whole text in the image width.


Moviestars
----------

Your movie stars by placeholder! Now you can generate custom-size placeholder images of Bill Murray, Steven Seagal and the
greatest artist of all times Nicolas Cage!

Just add the name of you movie hero in the URL, like::

  http://you-application/placeholder/stevenseagal/{width} #for a square image
  http://you-application/placeholder/nicolascage/{width}x{height}
  http://you-application/placeholder/billmurray/{width}x{height}

No text, bgcolor, color, format or font size needed! Just the name of an hero, and see the magic!

EXTRA: Nicolas Cage
*******************

Nicolas The Great Cage images supports the gray or the gif mode. Just add the *mode* in your URL::

  http://you-application/placeholder/nicolascage/g/{width}x{height}
  http://you-application/placeholder/billmurray/gif/{width}x{height}

Available modes:
    * **g** : gray mode
    * **gif**: gif mode
    * **c**: Wanna see some crazy stuff? Try the crazy Cage mode!

Based on famous placeholder generator by Dave Cowart (*http://www.placecage.com*,
*https://www.stevensegallery.com/*, *http://www.fillmurray.com*)