ffi-tk 2009.11.29

data/MANIFEST

@@ -0,0 +1,188 @@
+CHANGELOG
+MANIFEST
+README.md
+Rakefile
+TODO.md
+bin/rwish
+doc/MIT_LICENSE
+doc/TCL_LICENSE
+example/choose_color.rb
+example/choose_directory.rb
+example/dialog.rb
+example/hello.rb
+example/message_box.rb
+example/option_menu.rb
+example/popup.rb
+example/set_palette.rb
+example/text.rb
+example/tile/kroc_demo_small.rb
+example/tile/kroc_rb_demo.rb
+example/tile/notebook.rb
+example/tile/theme_hello.rb
+example/tile/treeview.rb
+example/various.rb
+example/wait.rb
+ffi-tk.gemspec
+lib/ffi-tk.rb
+lib/ffi-tk/command.rb
+lib/ffi-tk/command/after.rb
+lib/ffi-tk/command/bell.rb
+lib/ffi-tk/command/bind.rb
+lib/ffi-tk/command/bindtags.rb
+lib/ffi-tk/command/cget.rb
+lib/ffi-tk/command/choose_color.rb
+lib/ffi-tk/command/choose_directory.rb
+lib/ffi-tk/command/clipboard.rb
+lib/ffi-tk/command/configure.rb
+lib/ffi-tk/command/destroy.rb
+lib/ffi-tk/command/dialog.rb
+lib/ffi-tk/command/event.rb
+lib/ffi-tk/command/focus.rb
+lib/ffi-tk/command/font.rb
+lib/ffi-tk/command/get_open_file.rb
+lib/ffi-tk/command/get_save_file.rb
+lib/ffi-tk/command/grab.rb
+lib/ffi-tk/command/grid.rb
+lib/ffi-tk/command/image.rb
+lib/ffi-tk/command/lower.rb
+lib/ffi-tk/command/message_box.rb
+lib/ffi-tk/command/option_menu.rb
+lib/ffi-tk/command/pack.rb
+lib/ffi-tk/command/place.rb
+lib/ffi-tk/command/popup.rb
+lib/ffi-tk/command/raise.rb
+lib/ffi-tk/command/scrollable.rb
+lib/ffi-tk/command/selection.rb
+lib/ffi-tk/command/set_palette.rb
+lib/ffi-tk/command/tk_cmd.rb
+lib/ffi-tk/command/vars.rb
+lib/ffi-tk/command/wait.rb
+lib/ffi-tk/command/winfo.rb
+lib/ffi-tk/command/wm.rb
+lib/ffi-tk/core_extensions.rb
+lib/ffi-tk/event/data.rb
+lib/ffi-tk/event/handler.rb
+lib/ffi-tk/ffi/tcl.rb
+lib/ffi-tk/ffi/tcl/cmd_proc.rb
+lib/ffi-tk/ffi/tcl/eval_result.rb
+lib/ffi-tk/ffi/tcl/interp.rb
+lib/ffi-tk/ffi/tcl/obj.rb
+lib/ffi-tk/ffi/tcl/time.rb
+lib/ffi-tk/ffi/tk.rb
+lib/ffi-tk/geometry.rb
+lib/ffi-tk/thread_sender.rb
+lib/ffi-tk/tk.rb
+lib/ffi-tk/variable.rb
+lib/ffi-tk/widget.rb
+lib/ffi-tk/widget/button.rb
+lib/ffi-tk/widget/canvas.rb
+lib/ffi-tk/widget/canvas/arc.rb
+lib/ffi-tk/widget/canvas/bitmap.rb
+lib/ffi-tk/widget/canvas/image.rb
+lib/ffi-tk/widget/canvas/item.rb
+lib/ffi-tk/widget/canvas/line.rb
+lib/ffi-tk/widget/canvas/oval.rb
+lib/ffi-tk/widget/canvas/polygon.rb
+lib/ffi-tk/widget/canvas/rectangle.rb
+lib/ffi-tk/widget/canvas/text.rb
+lib/ffi-tk/widget/canvas/window.rb
+lib/ffi-tk/widget/checkbutton.rb
+lib/ffi-tk/widget/entry.rb
+lib/ffi-tk/widget/frame.rb
+lib/ffi-tk/widget/label.rb
+lib/ffi-tk/widget/labelframe.rb
+lib/ffi-tk/widget/listbox.rb
+lib/ffi-tk/widget/menu.rb
+lib/ffi-tk/widget/menubutton.rb
+lib/ffi-tk/widget/message.rb
+lib/ffi-tk/widget/panedwindow.rb
+lib/ffi-tk/widget/radiobutton.rb
+lib/ffi-tk/widget/root.rb
+lib/ffi-tk/widget/scale.rb
+lib/ffi-tk/widget/scrollbar.rb
+lib/ffi-tk/widget/spinbox.rb
+lib/ffi-tk/widget/text.rb
+lib/ffi-tk/widget/text/peer.rb
+lib/ffi-tk/widget/tile.rb
+lib/ffi-tk/widget/tile/button.rb
+lib/ffi-tk/widget/tile/checkbutton.rb
+lib/ffi-tk/widget/tile/combobox.rb
+lib/ffi-tk/widget/tile/entry.rb
+lib/ffi-tk/widget/tile/frame.rb
+lib/ffi-tk/widget/tile/label.rb
+lib/ffi-tk/widget/tile/labelframe.rb
+lib/ffi-tk/widget/tile/menubutton.rb
+lib/ffi-tk/widget/tile/notebook.rb
+lib/ffi-tk/widget/tile/panedwindow.rb
+lib/ffi-tk/widget/tile/progressbar.rb
+lib/ffi-tk/widget/tile/radiobutton.rb
+lib/ffi-tk/widget/tile/scale.rb
+lib/ffi-tk/widget/tile/scrollbar.rb
+lib/ffi-tk/widget/tile/separator.rb
+lib/ffi-tk/widget/tile/sizegrip.rb
+lib/ffi-tk/widget/tile/style.rb
+lib/ffi-tk/widget/tile/treeview.rb
+lib/ffi-tk/widget/toplevel.rb
+spec/ffi-tk/command/bindtags.rb
+spec/ffi-tk/command/clipboard.rb
+spec/ffi-tk/command/font.rb
+spec/ffi-tk/command/grid.rb
+spec/ffi-tk/command/image.rb
+spec/ffi-tk/command/pack.rb
+spec/ffi-tk/command/place.rb
+spec/ffi-tk/command/selection.rb
+spec/ffi-tk/command/vars.rb
+spec/ffi-tk/command/winfo.rb
+spec/ffi-tk/command/wm.rb
+spec/ffi-tk/event.rb
+spec/ffi-tk/tile/button.rb
+spec/ffi-tk/tile/checkbutton.rb
+spec/ffi-tk/tile/combobox.rb
+spec/ffi-tk/tile/entry.rb
+spec/ffi-tk/tile/frame.rb
+spec/ffi-tk/tile/label.rb
+spec/ffi-tk/tile/labelframe.rb
+spec/ffi-tk/tile/menubutton.rb
+spec/ffi-tk/tile/notebook.rb
+spec/ffi-tk/tile/panedwindow.rb
+spec/ffi-tk/tile/progressbar.rb
+spec/ffi-tk/tile/radiobutton.rb
+spec/ffi-tk/tile/scale.rb
+spec/ffi-tk/tile/scrollbar.rb
+spec/ffi-tk/tile/separator.rb
+spec/ffi-tk/tile/sizegrip.rb
+spec/ffi-tk/tile/style.rb
+spec/ffi-tk/tile/treeview.rb
+spec/ffi-tk/variable.rb
+spec/ffi-tk/widget/button.rb
+spec/ffi-tk/widget/canvas.rb
+spec/ffi-tk/widget/checkbutton.rb
+spec/ffi-tk/widget/entry.rb
+spec/ffi-tk/widget/frame.rb
+spec/ffi-tk/widget/label.rb
+spec/ffi-tk/widget/labelframe.rb
+spec/ffi-tk/widget/listbox.rb
+spec/ffi-tk/widget/menu.rb
+spec/ffi-tk/widget/menubutton.rb
+spec/ffi-tk/widget/message.rb
+spec/ffi-tk/widget/panedwindow.rb
+spec/ffi-tk/widget/radiobutton.rb
+spec/ffi-tk/widget/root.rb
+spec/ffi-tk/widget/scale.rb
+spec/ffi-tk/widget/scrollbar.rb
+spec/ffi-tk/widget/spinbox.rb
+spec/ffi-tk/widget/text.rb
+spec/ffi-tk/widget/toplevel.rb
+spec/helper.rb
+tasks/authors.rake
+tasks/bacon.rake
+tasks/changelog.rake
+tasks/gem.rake
+tasks/gem_setup.rake
+tasks/grancher.rake
+tasks/manifest.rake
+tasks/rcov.rake
+tasks/release.rake
+tasks/reversion.rake
+tasks/setup.rake
+tasks/ycov.rake

data/README.md

@@ -0,0 +1,85 @@
+# FFI::Tk
+
+This library provides you with a wrapper for the Tk windowing toolkit.
+
+
+## Installation
+
+Right now this project only exists on github, and tarballs of the repository may
+be obtained there.
+Once feature-complete, a gem will be provided.
+
+No compilation is required, but I'm not yet confident that this will run on
+every architecture without changes, FFI::Tk is being developed on Archlinux and
+Debian on Intel i686 and AMD x86_64, testers for other platforms are invited to
+give it a try and report any problems that occur.
+
+
+## Ruby-FFI
+
+Ruby-FFI is a ruby extension for programmatically loading dynamic libraries,
+binding functions within them, and calling those functions from Ruby code.
+
+It lives at: http://wiki.github.com/ffi/ffi
+
+Ruby-FFI ships with JRuby and Rubinius, and is available as a gem for MRI.
+
+
+## Hello, World!
+
+    require 'ffi-tk'
+
+    Tk.init
+
+    Tk::Button.new('.', text: 'Press me'){
+      Tk::MessageBox.new(message: 'Hello, World!')
+    }.pack
+
+    Tk.mainloop
+
+
+## Aims and Means
+
+First of all, FFI::Tk doesn't try to be a drop-in replacement for the tk library
+of Ruby's stdlib.
+
+We will try to keep things as simple as possible, and there will not be 10
+different ways to achieve the same thing through numerous aliases.
+
+We will not rely on any compiled extensions and the only dependency is FFI to
+keep things portable between different Ruby implementations (as far as they do
+implement the 1.9.1 standard syntax and core functinoality.)
+
+I (manveru) will not provide a version of FFI::Tk for 1.8.x, there may be other
+persons that undertake this step, but due to lack of true encoding support it
+will be significant overhead to cater to both versions as you can see if you
+read a bit through the stdlib tk library.
+We will provide only wrapping for the standard distribution of tcl/tk as of
+version 8.5.7.
+Earlier versions have not been tested, and later versions may be used by taking
+advantage of the Tcl stub mechanism.
+
+Custom extensions of tcl/tk may be wrapped by other people, and we will add a
+link to any such project, but we try to keep things simple here.
+
+A comprehensive suite of specs describes the behaviour of FFI::Tk as well as
+possible.
+
+The namespaces used are:
+
+* Tk
+* FFI::Tk
+* FFI::Tcl
+
+The Tk namespace conflicts with the name of the Ruby's stdlib tk, but the use of
+them within one application is mutually exclusive anyway.
+
+
+## License
+
+FFI::Tk is distributed under MIT license.
+Parts of the documentation were obtained from the tcl/tk manpages and modified
+to clarify and apply to the specifics of the FFI::Tk wrapper.
+These parts of the documentation are under Tcl license.
+
+The licenses can be found in doc/TCL_LICENSE and doc/MIT_LICENSE respectively.

data/Rakefile

@@ -0,0 +1,47 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'time'
+require 'date'
+
+PROJECT_SPECS = FileList['spec/ffi-tk/**/*.rb']
+PROJECT_MODULE = 'FFI::Tk'
+PROJECT_README = 'README.md'
+PROJECT_VERSION = ENV['VERSION'] || Date.today.strftime('%Y.%m.%d')
+
+DEPENDENCIES = {
+  'ffi' => {:version => '~> 0.5.1'},
+}
+
+DEVELOPMENT_DEPENDENCIES = {
+  'bacon'     => {:version => '>= 1.1.0'},
+}
+
+GEMSPEC = Gem::Specification.new{|s|
+  s.name         = 'ffi-tk'
+  s.author       = "Michael 'manveru' Fellinger"
+  s.summary      = "Pure Ruby FFI wrapper for the Tk GUI toolkit."
+  s.description  = "Pure Ruby FFI wrapper for the Tk GUI toolkit."
+  s.email        = 'm.fellinger@gmail.com'
+  s.homepage     = 'http://github.com/manveru/ffi-tk'
+  s.platform     = Gem::Platform::RUBY
+  s.version      = PROJECT_VERSION
+  s.files        = `git ls-files`.split("\n").sort
+  s.has_rdoc     = true
+  s.require_path = 'lib'
+  s.required_rubygems_version = '>= 1.3.5'
+}
+
+DEPENDENCIES.each do |name, options|
+  GEMSPEC.add_dependency(name, options[:version])
+end
+
+DEVELOPMENT_DEPENDENCIES.each do |name, options|
+  GEMSPEC.add_development_dependency(name, options[:version])
+end
+
+Dir['tasks/*.rake'].each{|f| import(f) }
+
+task :default => [:bacon]
+
+CLEAN.include('')

data/TODO.md

@@ -0,0 +1,62 @@
+# Todo List
+
+Things left to do, most of this is simple, but still a lot of code.
+Items are ordered roughly by their priority.
+Done items should be removed after a couple of revisions.
+
+An item is marked as done when:
+  * the code is complete.
+  * specs are written for all things possible to spec.
+  * the documentation has been sketched. I simply copy that part from the
+    offical doc first, but since we're not clear about copyright we might have
+    to use links and examples instead.
+
+## Commands
+
+Commands that operate on any widget as argument have highest priority.
+
+[ ] image
+    [ ] photo
+    [ ] bitmap
+[ ] loadTk
+[ ] send
+[ ] tk_bisque
+
+## Widgets
+
+The Tile widgets should have priority, as they will be needed most.
+Some widgets don't have a tile equivalent, they have highes priority.
+
+[ ] console
+
+### Tile Widgets
+
+[ ] ttk::style
+[ ] ttk::frame
+[ ] ttk::entry
+[ ] ttk::label
+[ ] ttk::treeview
+[ ] ttk::progressbar
+[ ] ttk::button
+[ ] ttk::checkbutton
+[ ] ttk::combobox
+[ ] ttk::image
+[ ] ttk::intro
+[ ] ttk::labelframe
+[ ] ttk::menubutton
+[ ] ttk::notebook
+[ ] ttk::panedwindow
+[ ] ttk::radiobutton
+[ ] ttk::scale
+[ ] ttk::scrollbar
+[ ] ttk::separator
+[ ] ttk::sizegrip
+[ ] ttk::widget
+
+## Examples
+
+There are a lot of examples that we can provide, both from the old Ruby bindings
+and the Tk library.
+They will have to be translated though, so it's still a lot of work.
+Our current examples should be removed sometime, they are more or less just
+proving that things run.

data/bin/rwish

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+
+if File.symlink?(__FILE__)
+  lib = File.expand_path('../../lib/ffi-tk', File.readlink(__FILE__))
+else
+  lib = File.expand_path('../../lib/ffi-tk', __FILE__)
+end
+
+require lib
+
+Tk.init
+
+begin
+  require 'readline'
+
+  while line = Readline.readline('> ', true)
+    begin
+      p eval(line)
+    rescue => ex
+      puts "#{ex.class}: #{ex}", *ex.backtrace
+    end
+  end
+rescue LoadError
+  while line = $stdin.gets
+    line.strip!
+
+    begin
+      p eval(line)
+    rescue => ex
+      puts "#{ex.class}: #{ex}", *ex.backtrace
+    end
+  end
+end

data/doc/MIT_LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2008 Michael Fellinger <m.fellinger@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/doc/TCL_LICENSE

@@ -0,0 +1,39 @@
+This software is copyrighted by the Regents of the University of
+California, Sun Microsystems, Inc., and other parties.  The following
+terms apply to all files associated with the software unless explicitly
+disclaimed in individual files.
+
+The authors hereby grant permission to use, copy, modify, distribute,
+and license this software and its documentation for any purpose, provided
+that existing copyright notices are retained in all copies and that this
+notice is included verbatim in any distributions. No written agreement,
+license, or royalty fee is required for any of the authorized uses.
+Modifications to this software may be copyrighted by their authors
+and need not follow the licensing terms described here, provided that
+the new terms are clearly indicated on the first page of each file where
+they apply.
+
+IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
+FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
+ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
+DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.  THIS SOFTWARE
+IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
+NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
+MODIFICATIONS.
+
+GOVERNMENT USE: If you are acquiring this software on behalf of the
+U.S. government, the Government shall have only "Restricted Rights"
+in the software and related documentation as defined in the Federal 
+Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2).  If you
+are acquiring the software on behalf of the Department of Defense, the
+software shall be classified as "Commercial Computer Software" and the
+Government shall have only "Restricted Rights" as defined in Clause
+252.227-7013 (c) (1) of DFARs.  Notwithstanding the foregoing, the
+authors grant the U.S. Government and others acting in its behalf
+permission to use and distribute the software in accordance with the
+terms specified in this license.