Contents

= GirFFI

by Matijs van Zuijlen

http://www.github.com/mvz/ruby-gir-ffi

== Description

Ruby-FFI-based binding of the GObject Introspection Repository

== Features/Problems

* Create bindings to GObject-based libraries at runtime
* Not done yet

== Synopsis

  require 'gir_ffi'

  GirFFI.setup :Gtk
  Gtk.init
  win = Gtk::Window.new :toplevel

== Requirements

* Ruby-FFI of course
* gobject-introspection installed with some introspection data
* The `rr` and `shoulda` gems for testing.

The current implementation needs the actual libraries to be available under
the name ending in just `.so`. On Debian and Ubuntu at least, this means
you have to install the -dev packages of any library you may want to
access. The following set of packages should do the trick:
`libgirepository1.0-dev` (at least version 0.10), and either
`gir1.2-gtk-3.0` and `libgtk-3-dev`, or `gir1.2-gtk-2.0` and
`libgtk2.0-dev`.

== Hacking

This is still very much a work in progress. You can start exploring by
running the example programs in the examples/ folder. Some illustrate what
works, some are a test bed for how things should work. Have a look at
`rake -T`. Feel free to file bugs or send pull requests.

== Install

* sudo gem install gir_ffi

== License

Copyright (c) 2009--2011 Matijs van Zuijlen

GirFFI is free software, distributed under the terms of the GNU Lesser
General Public License, version 2.1 or later. See the file COPYING.LIB for
more information.

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
gir_ffi-0.0.10	README.rdoc
gir_ffi-0.0.9	README.rdoc
gir_ffi-0.0.8	README.rdoc