[Kde-bindings] New qtbindings gem for Ruby

[Melton, Ryan]

Hi Everyone,

I put together a new cross-platform gem for the Ruby bindings to Qt and put it out on rubygems.org as "qtbindings".  This should make it a lot easier for people to install the ruby bindings on non-KDE systems. I've tested it out on Windows XP, Ubuntu Linux, and Mac OSX Snow Leopard so far and it seems to work great.  It is mainly the code straight from KDE bindings, but it also includes the patches for building on Windows I submitted to this list back in February, the fix for ExtraSelection, and some new fixes I've put in for the HWND__* classes on Windows.   I will be submitting the new patches back to this list soon.  Some other changes include minor modifications to the CMakelists.txt files, and reorganizing the folders into a standard ruby gem structure that I doubt you would want to incorporate back into the kdebindings repository.  Enjoy and I hope this increases the adoption of the great bindings you guys put together!  :)

Here is a link to the github repository:
http://github.com/ryanmelt/qtbindings

Here is the README.txt:

qtbindings
----------
This project provides bindings that allow the QT Gui toolkit to be used from the
Ruby Programming language. Overall it is a repackaging of a subset of the KDE
bindings ruby and smoke systems into a format that lends itself well to
packaging into a Ruby gem.

Goals
-----
1. To make it easy to install a Qt binding for Ruby on all platforms using
   RubyGems
2. To maintain an up-to-date binary gem for Windows that is bundled with
   the latest version of Qt from http://qt.nokia.com
3. To reduce the scope and maintenance of the bindings to only bind to the
   libraries provided by the Qt SDK.
4. To increase compatibility with non-linux platforms

Tested Environments
--------------------
Mac OSX 10.6.4 (Snow Leopard)
XCode 3.2.3
Macports 1.9.1
qt4-mac 4.6.3
Cmake 2.8.2

Windows XP SP3
QT SDK 4.6.3
Cmake 2.8.2
Ruby 1.8.7p299 installed from rubyinstaller.org

Ubuntu Linux
QT SDK 4.6.3
Cmake 2.8.2

Compiling
---------
Compiling qtbindings requires the following prerequisites:
1. cmake 2.6.3+ installed and in your path
2. QT 4.6.x installed and in your path
3. Ruby installed and in your path
4. gcc 4.x

Additionally: all of the operating system prequisites for compiling,
window system development, opengl, etc must be installed.

Operating Systems Notes:

Debian Linux
------------
1. The following should get you the packages you need:
sudo aptitude install build-essential bison openssl libreadline5
  libreadline-dev curl git-core zlib1g zlib1g-dev libssl-dev vim
  libsqlite3-0 libsqlite3-dev sqlite3 libreadline5-dev libreadline6-dev
  libxml2-dev git-core subversion autoconf xorg-dev libgl1-mesa-dev
  libglu1-mesa-dev

Mac OSX Snow Leopard
-----------------------
1. XCode
2. qt4-mac installed from macports - NOTE: For some reason smokegen does
   not work with the SDK or Cocoa libraries directly from qt.nokia.com -
   Uninstall these if necessary using:
   sudo python /Developer/Tools/uninstall_qt.py

Windows - Note: Only necessary for debugging (binary gem available)
--------
1. mingw from the Qt SDK in your path: ie C:\Qt\2010.04\mingw\bin

Install
------
On linux/MacOSX you must make sure you have all the necessary prerequisites
installed or the compile will fail.

gem install qtbindings

This should always work flawlessly on Windows because everything is nicely
packaged into a binary gem.

To get help:
Sign up to the kdebindings mailing list at:
https://mail.kde.org/mailman/listinfo/kde-bindings
You can also file tickets here at github for issues specific to the
qtbindings gem.

License:
This library is released under the LGPL Version 2.1.
See COPYING.LIB.txt

Disclaimer:
Almost all of this code was written by the great guys who work on the KDE
bindings project, particurly Arno Rehn and Richard Dale. I hope to increase
the adoption and use of the code that they have written.




This message and any enclosures are intended only for the addressee.  Please  
notify the sender by email if you are not the intended recipient.  If you are  
not the intended recipient, you may not use, copy, disclose, or distribute this  
message or its contents or enclosures to any other person and any such actions  
may be unlawful.  Ball reserves the right to monitor and review all messages  
and enclosures sent to or from this email address.