Metadata-Version: 1.0
Name: rainbow-saddle
Version: 0.1
Summary: A wrapper around gunicorn to handle graceful restarts correctly
Home-page: https://github.com/flupke/rainbow-saddle
Author: Luper Rouch
Author-email: luper.rouch@gmail.com
License: BSD
Description: Rainbow Saddle
        ==============
        
        rainbow-saddle is a wrapper around `Gunicorn <http://gunicorn.org/>`_ to
        simplify code reloading without dropping requests.
        
        Installation
        ------------
        
        Install from pypi::
        
            $ sudo pip install rainbow-saddle
        
        Or from source::
        
            $ sudo ./setup.py install
        
        Why?
        ----
        
        Sometimes doing a ``kill -HUP <gunicorn PID>`` is not sufficient to reload your
        code. For example it doesn't work well `if you host your code behind a symlink
        <https://github.com/benoitc/gunicorn/issues/394>`_, or if a `.pth in your
        installation is updated to point to a different directory
        <https://github.com/benoitc/gunicorn/issues/402>`_.
        
        The correct way to reload code in such situations is a bit complicated::
        
            # Reexec a new master with new workers
            /bin/kill -s USR2 `cat "$PID"`
            # Graceful stop old workers
            /bin/kill -s WINCH `cat "$PIDOLD"`
            # Graceful stop old master 
            /bin/kill -s QUIT `cat "$PIDOLD"`
        
        It also has the downside of changing the "master" process PID, which confuses
        tools such as supervisord.
        
        rainbow-saddle handles all of this for you, and never changes its PID.
        Reloading code becomes as simple as sending a ``SIGHUP`` again::
        
            $ rainbow-saddle --pid /tmp/mysite.pid gunicorn_paster development.ini --log-level debug 
            $ kill -HUP `cat /tmp/mysite.pid`
        
        
        .. This is your project NEWS file which will contain the release notes.
        .. Example: http://www.python.org/download/releases/2.6/NEWS.txt
        .. The content of this file, along with README.rst, will appear in your
        .. project's PyPI page.
        
        News
        ====
        
        0.2a1
        -----
        
        *Release date: UNRELEASED*
        
        * Example news entry for the in-development version
        
        
        0.1
        ---
        
        *Release date: 15-Mar-2010*
        
        * Example news entry for a released version
        
        
Keywords: gunicorn wrapper graceful restart
Platform: UNKNOWN
