Metadata-Version: 1.1
Name: whiskers
Version: 1.0-alpha.2
Summary: whiskers
Home-page: https://github.com/pingviini/whiskers
Author: Jukka Ojaniemi
Author-email: jukka.ojaniemi@gmail.com
License: UNKNOWN
Description: ========
        Whiskers
        ========
        
            "Vibrissae (singular: vibrissa), or whiskers, are specialized hairs (or, in
            certain bird species, specialized feathers) usually employed for tactile
            sensation." - Wikipedia
        
        Whiskers is a Pyramid application for storing information about your buildouts.
        It is intended to use with buildout.sendpickedversions (PyPI_, Github_)
        extension.
        
        .. image:: https://travis-ci.org/pingviini/whiskers.png?branch=master
        
        Reason behind Whiskers
        ======================
        
        Why? Shortly to automate your workflow.
        
        Think an environment where you're managing tens or hundereds of buildouts - say
        Plone instances. Most of them have probably almost the same packages and 
        versions. Now you make an critical fix to some custom package and you need to
        know which buildouts you have to update. Whiskers helps you here by knowing
        what is required and where.
        
        Installation
        ============
        
        Requirements
        ------------
        
        Python 2.6, 2.7, 3.2 or 3.3
        
        
        Pip
        ---
        
        ::
        
            virtualenv --no-site-packages -p /path/to/python whiskers
            cd whiskers
            bin/pip install whiskers
            wget https://github.com/pingviini/whiskers/raw/master/production.ini
            bin/pserve production.ini
        
        Github
        ------
        
        ::
        
            virtualenv --no-site-packages -p /path/to/python whiskers
            git clone git://github.com/pingviini/whiskers.git
            cd whiskers
            python setup.py install
            bin/pserve production.ini
        
        
        Usage
        =====
        
        To get some data to Whiskers you should set up buildout.sendpickedversions for
        your buildouts. Just add following lines to your buildout.cfg: ::
        
            [buildout]
            extensions = buildout.sendpickedversions
            send-data-url = http://localhost:6543
            ...
        
        Above configuration assumes you have Whiskers running on localhost.
        
        Run buildout and it should say in last lines something like this: ::
        
            ...
            root: Sending data to remote url (http://localhost:6543/)
            Added buildout information to Whiskers.
        
        Open web browser and go to http://localhost:6543/buildouts and you should see
        your buildout data.
        
        
        Having trouble
        ==============
        
        Both Whiskers and buildout.sendpickedversions have been updated to work
        nicely together. Make sure you are using latest version of
        buildout.sendpickedversions when you've set up Whiskers 1.x.
        
        Older version of buildout.sendpickedversions (0.x) is incompatible with
        Whiskers 1.x. Same goes to other way too - Whiskers 0.x doesn't work with
        buildout.sendpickedversions 1.x.
        
        
        Found a bug
        ===========
        
        Please kill it (or add a new issue to github). Code is out there for you.
        
        Seriously - I'm more than willing accepting new contributions.
        
        
        .. _PyPI: http://pypi.python.org/pypi/buildout.sendpickedversions
        .. _Github: http://github.com/pingviini/buildout.sendpickedversions
        
        
        CHANGELOG
        =========
        
        1.0-alpha.2 (2013-04-07)
        ------------------------
        
         * Shows unused packages in packages view.
         * Host views shows hosts IP-address.
         * Host view shows buildouts grouped by name.
         * Modal window for buildout config is now wider showing all
           values.
         * Fixed buildout views package lists indentation.
         * Added settings view with option to select how many buildout versions
           are stored for each buildout.
         * Fixed front pages instructions how to set up
           buildout.sendpickedversions.
        
        1.0-alpha.1 (2013-03-20)
        ------------------------
        
         * New twitter-bootstrap based UI.
         * Supports buildout.sendpickedversions >= 1.x.
         * Stores buildout history.
         * Stores buildout configuration.
         * Stores all package requirements.
        
Keywords: web wsgi pyramid whiskers buildout
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Framework :: Pyramid
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
