Metadata-Version: 1.0
Name: ClueBin
Version: 0.2.3
Summary: Pastebin application
Home-page: UNKNOWN
Author: Rocky Burt
Author-email: rocky@serverzen.com
License: UNKNOWN
Description: .. -*-rst-*-
        
        =======
        ClueBin
        =======
        
        
        Overview
        ========
        
        ClueBin is a pastebin application with colour-syntax support for most major
        text formats.  It is implemented as a WSGI application and easily integrates with
        WSGI stacks.  The data backend is configurable and currently there are datastores
        for Google App Engine (BigTable) and SQLAlchemy (SQLite by default).
        
        Test the live version at http://cluebin.appspot.com
        
        
        Dependencies
        ============
        
        * (required) Python 2.5+
        
        * (required) Pygments 0.9+
        
        * (required) WebOb 0.9.1+
        
        * (optional) SQLAlchemy: only required if you want SQL-based datastore support
        
        * (optional) Google Apps SDK: only required if deployed on the Google App
        Engine
        
        
        Installation
        ============
        
        ClueBin was designed to be installed using standard easy_install methods.  A
        simple "easy_install ClueBin" should suffice.  This should generate a new
        script called ``cluebin``.
        
        
        Usage
        =====
        
        ClueBin was designed to be a pluggable WSGI app.  The factory for this app is
        ``cluebin.pastebin.make_app``.
        
        To setup ClueBin within it's own constrained directory try using virtualenv
        from http://pypi.python.org/pypi/virtualenv/1.0  Once virtualenv is installed
        do this::
        
        $ virtualenv cluebinenv
        $ cd cluebinenv
        $ ./bin/easy_install SQLAlchemy
        $ ./bin/easy_install ClueBin
        
        To use ClueBin in stand-alone mode, run the ``cluebin`` script.  See the help
        usage for standard information.
        ::
        
        $ ./bin/cluebin -h
        
        Here is an example of running ClueBin against a local ``foo.db`` sqlite db.
        Make sure your local PYTHONPATH includes both SQLAlchemy and python SQLite
        bindings.
        ::
        
        $ ./bin/cluebin -s cluebin.sqldata.SqlPasteDataStore sqlite:///foo.db True
        
        The ``-s`` option takes some random datastore factory name.  All extra arguments
        are passed as arguments to the factory call.  For the sql based datastore
        the current arguments are "db-uri" and an optional second argument to determine
        if the base schema should be auto-created.
        
        
        Credits
        =======
        
        * Rocky Burt (maintainer) - rocky AT serverzen DOT com
        
        * Nate Aune - natea AT jazkarta DOT com
        .. -*-rst-*-
        
        ===============
        ClueBin History
        ===============
        
        v0.2.3 (2008-07-07)
        ===================
        
        * Removed top dependency requirement for Pygments and Webob
        
        
        v0.2.2 (2008-05-17)
        ===================
        
        * Fixed up ordering of retrieved posts to be by date descending
        
        * Added more tests
        
        * Fixed #2: last used username is now being retrieved from cookie
        
        
        v0.2.1 (2008-05-15)
        ===================
        
        * Did minor refactoring and added more tests (new utils module)
        
        
        v0.2 (2008-05-07)
        =================
        
        * Added cmd-line execution mode for cluebin.pastebin so that by default
        it will serve a local http server with the pastebin app
        
        * Now has sql support in addition to google support via sqlalchemy
        
        * Added line numbers for pastes
        
        * Changed google data usage of 'paste' from StringProperty to TextProperty
        for data of limitless size
        
        * Language/lexer selection is now available (don't have to use auto-detection)
        
        * Stores last-used language and name in cookies
        
        
        v0.1 (2008-05-03)
        =================
        
        * got Google BigTable backend working
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
