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