View Code? Open in Web Editor NEW

A set of bindings for the GNOME libraries to use from Ruby.

License: Other

Shell 0.12% Ruby 50.33% C++ 0.03% C 45.79% Emacs Lisp 0.01% CSS 0.36% Makefile 0.01% GLSL 0.01% Dockerfile 0.10% R 3.25%

ruby-gnome's Introduction

Ruby-GNOME

Ruby bindings for GNOME

This is a set of bindings for the GNOME 3.x and 4.x libraries to use from Ruby 2.5, 2.6 and 2.7.

Installation

Install the current releases.

The gems of the Ruby-GNOME projects can be easily installed with the gem command. For example in order to install the gtk3 gem and its dependencies:

gem install gtk3

Install from GitHub master branch

You can also install these gems from GitHub master branch.

Create Gemfile like the following:

source "https://rubygems.org/"

git "https://github.com/ruby-gnome/ruby-gnome.git" do
  gem "gtk3"
end

Install these gems by Bundler:

% bundle install

Advanced Installation

% ruby extconf.rb
% make
% sudo make install

To compile and install a particular sub-binding, you can add arguments:

% ruby extconf.rb [subdir]...
e.g.) ruby extconf.rb glib2 pango atk gdk_pixbuf2 gtk2

Or you can compile each sub-binding:

% cd <each sub-directory>
% ruby extconf.rb
% make
% sudo make install

extconf.rb options

--ruby
- ruby directory
--topsrcdir
- top source directory
--topdir
- top directory
--strict
- if some libraries fail to compile/install, "make" command returns 1(exit 1)

Bugs

Please report bugs either in our bug tracker

https://github.com/ruby-gnome/ruby-gnome/issues (current)

or on the ruby-gnome2-devel-en / ruby-gnome2-devel-ja mailing list

http://sourceforge.net/mail/?group_id=53614

Copying

This program is free software. You can distribute/modify this program under the terms of the GNU LESSER GENERAL PUBLIC LICENSE Version 2.1.

Exceptions

Some GTK+ 3 examples are licensed under GNU Free Documentation License 1.3 or any later version later; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

Because they are based on scripts in PyGObject-Tutorial. PyGObject-Tutorial is licensed under GFDL 1.3.

See gtk3/sample/ directory for details.