You are looking at historical revision 24784 of this page. It may differ significantly from its current revision.

pastiche - An awfully simple pastebin.

Introduction

pastiche is a BSD licensed awful application providing a basic pastebin service. It has been named pastiche in honor of lisppaste where loads of ideas and the syntax highlighting (indirectly via the colorize egg has been borrowed.

Usage

After installation create and compile the following file:

(use awful pastiche)

(pastiche "/" "paste.db"
          awful-settings:
          (lambda (handler)
            (parameterize
                ((debug-file "/tmp/paste")
                 (page-css "http://wiki.call-cc.org/chicken.css")
                 (page-charset "UTF-8")
                 (page-doctype "<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Strict//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd\">"))
              (handler))))

load this then with awful

$ awful example-app.so

This will run the pastebin service using call-cc.org's css look and feel on your host. Access http://localhost/ for your paste app.

Requirements

stty awful >= version 0.31 awful-sql-de-lite >= version 0.4 colorize miscmacros

Documentation

pastiche

[procedure] (pastiche base-path db-file #!key (vandusen-port 22722) (vandusen-host "localhost") (base-url "http://paste.call-cc.org") (use-captcha? #t) (num-captchas 500) (browsing-steps 15) (awful-settings (lambda (_) (_))))

Starts pastiche with base-path as the root URL and the sqlite database file db-file. If the database file does not exist, pastiche will create and initialize an empty database.

It supports sending the paste event to the chicken IRC bot vandusen. The message contains of the author, the title of the paste and the url to the paste on one line.

Keywords:
vandusen-port
TCP port number which the vandusen bot listens on
vandusen-host
hostname which vandusen resides on. Set to #f to disable vandusen notifications
base-url
The absolute base URL to the root of pastiche
use-captcha
If #t it will try to use figlet for creating a captcha. Set to #f to disable captchas
num-captchas
Defines the number of different captchas that will get created
browsing-steps
The number of paste entries per page
awful-settings
A procedure that will get the path before passed to awful's handler. See awful's documentation for details.

Author

Christian Kellermann

License

Copyright 2011 Christian Kellermann <ckeen@pestilenz.org>. All
rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
   1. Redistributions of source code must retain the above
   copyright notice, this list of conditions and the following
   disclaimer.
   2. Redistributions in binary form must reproduce the above
   copyright notice, this list of conditions and the following
   disclaimer in the documentation and/or other materials provided
   with the distribution.
THIS SOFTWARE IS PROVIDED BY CHRISTIAN KELLERMANN ``AS IS'' AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CHRISTIAN KELLERMANN OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
The views and conclusions contained in the software and
documentation are those of the authors and should not be
interpreted as representing official policies, either expressed or
implied, of Christian Kellermann.

Version History

0.1
initial release
0.2
bugfix release, thanks to Andy Bennet, Peter Bex, Mario Goulart, Moritz Heidkamp