ruby-libvirt
============

Ruby bindings for libvirt (http://libvirt.org)

Usage
-----

In your ruby code, do a "require 'libvirt'"; to obtain a connection, use
'Libvirt::open' or 'Libvirt::open_read_only'. See tests/*.rb for more
examples.

Hacking
-------

On a Fedora machine, run
  yum install libvirt-devel ruby-devel rubygem-rake
and then
  rake build
  rake test

To run against the checkout, make sure you set RUBYLIB (assuming DIR is the
toplevel of your source checkout):

  export RUBYLIB=$dir/lib:$dir/ext/libvirt
  ruby -rlibvirt -e 'puts Libvirt::version[0]'

Notes
-----
As of June 24, 2011, the ruby-libvirt bindings support all of the libvirt
APIs up to libvirt commit hash 2c5ded6e8269463d2daab3dfa0ecae1477730ee2
with the following exceptions:

- virConnectRef
- virDomainGetConnect
- virDomainRef
- virDomainOpenConsole
- virNetworkGetConnect
- virNetworkRef
- virInterfaceGetConnect
- virInterfaceRef
- virStoragePoolGetConnect
- virStoragePoolRef
- virStorageVolGetConnect
- virStorageVolRef
- virNodeDeviceRef
- virSecretGetConnect
- virSecretRef
- virStreamRef
- virNWFilterRef
- virEventRegisterDefaultImpl
- virEventRunDefaultImpl
