Pastebin application
Project 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
=======
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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ClueBin-0.2.3.tar.gz
(12.1 kB
view hashes)
Built Distribution
ClueBin-0.2.3-py2.5.egg
(19.1 kB
view hashes)