Zerenity

Version

1.3

Author

Farrel Lifson www.lifson.info www.aimred.com

Contributors

Daniel Lucraft www.daniellucraft.com

Synopsis

Zerenity is an almost clone of Zenity(freshmeat.net/projects/zenity) for Ruby. It allows for the easy creation of simple graphical dialogs from a Ruby script.

Features

Zerenity allows for the creation of the following dialogs

  • Date selection

  • Text entry

  • Error display

  • File/directory selection

  • Information display

  • List display and selection

  • Progress display

  • Question display

  • Text information display and editing

  • Warning display

  • Sliding scales

  • Color selection

Dependencies

Zerenity requires GTK2(www.gtk.org) and Ruby/GTK2(ruby-gnome2.sourceforge.jp/hiki.cgi).

Installation

Zerenity is avaiable as a Ruby gem. Links to the latest release can be found at www.aimred.com/files/projects/zerenity.

The code is also available via it’s Github repository at github.com/farrel/zerenity/tree/master

Example Usage

User Input and Display

require 'zerenity'

if (name = Zerenity::Entry(:text=>"What is your name?")) 
  Zerenity::Info(:text=>"Hello #{name}")
else
  puts "No name entered"
end

Progress

require 'zerenity'

fileList = filesToProcess(folder)
Zerenity::Progress(:text=>'Processing files',:autoClose=>true) do |progress|
 fileList.each_index do |file,index|
   processFile(file)
   progress.update(index/fileList.length,"#{100*index/fileList.length}% processed...")
 end
end

License

Zerenity is released under the BSD license.

Copyright

© 2006 - 2009 Farrel Lifson