raptcha-0.0.1

NAME

   raptcha

SYNOPSIS

   low drain bamage, storage-less, session-less, plugin-less, zero admin,
   single-source-file secure captcha system for ruby and/or rails

DESCRIPTION

   raptcha manages image generation via a streaming controller. the result is
   that no disk storage is ever needed for captcha images. it also manages
   authentication via blowfish encoded hidden fields, obviating the need for
   session/database interaction for captcha validation. the library is useful
   outside of rails, even from the command line.

INSTALL

   DEPENDS

   ### sudo port install ImageMagick rb-rmagick

   GEM

     gem install raptcha --no-wrappers

   SINGLE FILE INTO RAILS APP

     cp raptcha.rb ./app/lib/

URIS

   http://codeforpeople.com/
   http://rubyforge.org/projects/codeforpeople

EXAMPLES

   GENERATE A SET OF TAGS TO FOR CAPTCHA PLUS FORM INPUT FIELDS

     Raptcha.input
       :foreground => 'pink', :background => 'mauve', :distort => 'low'

   GENERATE AN INLINE (Base64 encoded png) INPUT TAG SET

     Raptcha.input((
       :inline => true, :foreground => 'pink', :distort => 'low',
       :width => 142, :height => 42, :type => 'jpg'
     ))

   USING IN RAILS

     1) setup the raptcha controller
       prompt:~/rails_root/ > raptcha generate controller

     2) use in your controllers
     class WickedEasyController < ApplicationController
       def form
         @valid = Raptcha.valid? params

         render :inline => <<-rhtml
           <html> <body>
              valid :<%= valid %>

             <form method=post>
               <%= Raptcha.input %>

               <input type=submit name=submit value=submit />
             </form>
           </body> </html>
         rhtml
       end
     end

   COMMAND LINE USAGE

     ruby raptcha.rb foreground:pink > pink.png && display ping.png

     ruby raptcha.rb generate lib

SAMPLES

   see http://drawohara.tumblr.com/post/5125054

DOC

   vim raptcha.rb

enjoy.

-a