Zerenity is an almost clone of
Zenity(Best Open Source Mac Software Development Software 2023) for Ruby. It allows for
the easy creation of simple graphical dialogs from a Ruby script.
= Zerenity Changelog
== 1.1
- From this version the OK button is set as the default widget. Pressing
Enter
in a dialog will cause it to be fired. If you do not want your dialog
to have
this behavior set the :activatesDefault option to false. Note that
certain widgets
(List, FileSelection and TextInfo when :editable is set) do not
allow this as Enter
could be used for other actions. Originally suggested by Justin
Collins. - Instead of passing a Gtk::VBox to the build and retrieve_selection
methods, now
pass in the parent Gtk::Dialog.
== 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
== Dependencies
Zerenity requires GTK2(http://www.gtk.org) and
Ruby/GTK2(http://ruby-gnome2.sourceforge.jp/hiki.cgi).
== Installation
Zerenity is avaiable as a Ruby gem. Links to the latest release can be
found at http://www.aimred.com/files/projects/zerenity.
The code is also available via it’s Subversion repository at
http://zerenity.googlecode.com/svn/
== 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
(c) 2006 Farrel L.