ruby-wmctrl 0.0.4 → 0.0.5

data/README.md

@@ -7,8 +7,10 @@ Ruby bindings to control windows in EWMH and NetWM compatible X Window manager.
 
 ## Installation
 
-ruby-wmctrl is a C extended library, which uses glib and x11.
-For ubuntu 11.04, we should install packages.
+ruby-wmctrl is a C extended library, which uses glib and x11,
+and is not a program to parse the output of command "wmctrl".
+
+On ubuntu 11.04, we should install the following packages.
 
     apt-get install libx11-dev libglib2.0-dev libxmu-dev
 
@@ -16,28 +18,49 @@ Then we can install ruby-wmctrl from rubygems.
 
     gem install ruby-wmctrl
 
+## Remark
+
+Note that values of positions of windows aredifferent from
+those of original "wmctrl" and include frame sizes.
+
 ## Usage
 
-We load 'wmctrl' as below
+We load 'wmctrl' as below;
 
     require 'wmctrl'
 
-and call methods of an instance of WMCtrl.
+We get desktops and windows as follows;
+
+    pp WMCtrl.instance.desktops
+    pp WMCtrl.instance.windows
+
+We can specify search conditions of windows; for example,
+
+    pp WMCtrl.instance.windows(:wm_class => /^emacs/)
+
+## Usage (Basic method similar to the command "wmctrl")
+
+ruby-wmctrl has some basic methods derived from wmctrl,
+but the author think that these methods may be changed in future release.
 
 ### List windows
 
     require 'wmctrl'
     require 'pp'
-    wm = WMCtrl.new
+    wm = WMCtrl.instance
     pp wm.list_windows
 
+If you want to get properties of windows, you pass true as an argument.
+
+    pp wm.list_windows(true)
+
 ### Activate a window
 
     wm.action_window(window_id, :activate)
 
-The method 'action_window' takes window ID as first argument.
-We can get window ID by the method 'list_windows'.
-The second argument of 'action_window' is an action that
+The method 'action\_window' takes window ID as first argument.
+We can get window ID by the method 'list\_windows'.
+The second argument of 'action\_window' is an action that
 manages the window of window ID.
 The rest arguments are arguments of the action.
 
@@ -66,6 +89,11 @@ width, and height, respectively. That is,
 
     pp wm.list_desktops
 
+## rwmctrl
+
+ruby-wmctrl includes the command "rwmctrl", which imitates the command "wmctrl"
+but does not implement all functionalities of "wmctrl".
+
 ## License
 
 GPLv2

data/Rakefile

@@ -2,3 +2,48 @@ require "bundler/gem_tasks"
 
 require 'yard'
 YARD::Rake::YardocTask.new
+
+def each_extconf_directory(&block)
+  Dir.glob("ext/**/extconf.rb").each do |extconf|
+    cd File.dirname(extconf) do
+      yield
+    end
+  end
+end
+
+desc 'Compile extended library'
+task 'ext:compile' do |t|
+  each_extconf_directory do
+    sh 'ruby extconf.rb' unless File.exist?('Makefile')
+    sh 'make'
+  end
+end
+
+desc 'Compile extended library'
+task 'ext:recompile' do |t|
+  each_extconf_directory do
+    sh 'make distclean' if File.exist?('Makefile')
+    sh 'ruby extconf.rb'
+    sh 'make'
+  end
+end
+
+desc 'Clean'
+task 'ext:clean' do |t|
+  each_extconf_directory do
+    sh 'make clean' if File.exist?('Makefile')
+  end
+end
+
+desc 'Clean completely'
+task 'ext:distclean' do |t|
+  each_extconf_directory do
+    sh 'make distclean' if File.exist?('Makefile')
+  end
+end
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end

data/bin/rwmctrl

@@ -20,7 +20,7 @@ begin
     opt.on('-p', 'Display PID of windows.') do |v|
       options[:pid] = true
     end
-    opt.on('-x', 'Display class name.') do |v|
+    opt.on('-x', 'Display class name or interpret <WIN> as the WM_CLASS name.') do |v|
       options[:class] = true
     end
     opt.on('-G', 'Display geometry of windows.') do |v|
@@ -43,6 +43,10 @@ begin
       options[:mode] = :close
       options[:target] = v
     end
+    opt.on('-a <WIN>', String, 'Switch desktop and make the specified window active.') do |v|
+      options[:mode] = :make_active
+      options[:target] = v
+    end
     opt.on('-d', 'List all desktops.') do |v|
       options[:mode] = :desktop
     end
@@ -54,19 +58,62 @@ begin
       options[:change_state] = v
     end
     opt.on('-n N', Integer, 'Change the number of desktops.') do |v|
-      options[:mode] = :desktop_number
+      options[:mode] = :change_number_of_desktops
+      options[:arguments] = [v]
+    end
+    opt.on('-R <WIN>', String, 'Move <WIN> to the current desktop.') do |v|
+      options[:mode] = :move_to_current
+      options[:target] = v
+    end
+    opt.on('-t <DESK>', Integer, 'Move a window specified by -r to the desktop <DESK>.') do |v|
+      options[:mode] = :move_to_desktop
       options[:desktop_number] = v
     end
+    opt.on('-g SIZE', String, 'Change the geometry of all desktops. SIZE is the form w,h') do |v|
+      options[:mode] = :change_geometry
+      w, h = v.split(',').map(&:to_i)
+      if w && h
+        options[:arguments] = [w, h]
+      else
+        raise "Invalid argument"
+      end
+    end
+    opt.on('-o SIZE', String, 'Change the viewport. SIZE is the form w,h') do |v|
+      options[:mode] = :change_viewport
+      w, h = v.split(',').map(&:to_i)
+      if w && h
+        options[:arguments] = [w, h]
+      else
+        raise "Invalid argument"
+      end
+    end
+    opt.on('-N STR', String, 'Set long title of specified window.') do |v|
+      options[:mode] = :set_title_long
+      options[:arguments] = [v]
+    end
+    opt.on('-I STR', String, 'Set short title of specified window.') do |v|
+      options[:mode] = :set_title_short
+      options[:arguments] = [v]
+    end
+    opt.on('-T STR', String, 'Set long and short title of specified window.') do |v|
+      options[:mode] = :set_title_both
+      options[:arguments] = [v]
+    end
+    opt.on('-k ARG', String, 'Turn on or off "show the desktop". ARG is on or off.') do |v|
+      options[:mode] = :showing_desktop
+      if v == "on"
+        options[:arguments] = [true]
+      elsif v == "off"
+        options[:arguments] = [false]
+      else
+        raise "Invalid argument"
+      end
+    end
+    opt.on('-s <DESK>', Integer, 'Switch to the desktop <DESK>') do |v|
+      options[:mode] = :switch_desktop
+      options[:arguments] = [v]
+    end
     # Not implemented options
-    # '-g'
-    # '-I'
-    # '-k'
-    # '-N'
-    # '-o'
-    # '-R'
-    # '-s'
-    # '-t'
-    # '-T'
     # '-w'
 
     # '-u'
@@ -75,7 +122,7 @@ begin
       options[:use_wid] = true
     end
     opt.on('-F', 'Use exact match of window title.') do |v|
-      option[:use_exact] = true
+      options[:use_exact] = true
     end
     opt.on('--ignore-case', 'Ignore case to specfy target window.') do |v|
       options[:ignore_case] = true
@@ -96,32 +143,27 @@ MES
   exit(2)
 end
 
-wm = WMCtrl.new
+wm = WMCtrl.instance
 
-def specify_window(wm, arg, options)
+# Return first window specified by arg and options
+def specify_window(arg, options)
+  wm = WMCtrl.instance
+  win = nil
   if arg == ':ACTIVE:'
-    wm.list_windows.find do |w|
-      w[:active] ? w : nil
-    end
+    win = wm.windows(:active => true).first
   elsif arg == ':SELECT:'
     raise 'Not implemented.'
   elsif options[:use_wid]
-    wid = Integer(arg)
-    wm.list_windows.find do |w|
-      wid == w[:id] ? w : nil
-    end
+    win = wm.windows(:id => Integer(arg)).first
   else
-    if options[:use_exact]
-      wm.list_windows.find do |w|
-        arg == w[:title] ? w : nil
-      end
-    else
-      reg = Regexp.new(arg, options[:ignore_case] ? Regexp::IGNORECASE : 0)
-      wm.list_windows.find do |w|
-        reg =~ w[:title] ? w : nil
-      end
-    end
+    key_name = (options[:class] ? :class : :title)
+    cond_title = (options[:use_exact] ? arg : Regexp.new(arg, options[:ignore_case] ? Regexp::IGNORECASE : 0))
+    win = wm.windows(key_name => cond_title).first
   end
+  unless win
+    raise "Any window is not specified."
+  end
+  win
 end
 
 case options[:mode]
@@ -154,37 +196,39 @@ when :list_windows
     puts s
   end
 when :move_resize
-  if target_win = specify_window(wm, options[:target], options)
-    args = options[:move_resize].split(',').map(&:to_i)
-    if args.size == 5
-      wm.action_window(target_win[:id], :move_resize, *args)
-    else
-      puts "Invalid arguments."
-    end
+  target_win = specify_window(options[:target], options)
+  args = options[:move_resize].split(',').map(&:to_i)
+  if args.size == 5
+    wm.action_window(target_win[:id], :move_resize, *args)
   else
-    puts "Can not specify target window."
+    puts "Invalid arguments."
   end
 when :change_state
-  if target_win = specify_window(wm, options[:target], options)
-    args = options[:change_state].split(',')
-    if args.size == 2 || args.size == 3
-      wm.action_window(target_win[:id], :change_state, *args)
-    else
-      puts "Invalid property string."
-    end
+  target_win = specify_window(options[:target], options)
+  args = options[:change_state].split(',')
+  if args.size == 2 || args.size == 3
+    target_win.change_state(*args)
+  else
+    puts "Invalid property string: #{args.inspect}"
   end
 when :close
-  if target_win = specify_window(wm, options[:target], options)
-    wm.action_window(target_win[:id], :close)
-  end
+  specify_window(options[:target], options).close
+when :make_active
+  specify_window(options[:target], options).activate
 when :desktop
   wm.list_desktops.each do |dt|
     printf("%d  %s DG: %dx%d  VP: %d,%d WA: %d,%d %dx%d  %s\n",
            dt[:id], dt[:current] ? '*' : '-', dt[:geometry][0], dt[:geometry][1], dt[:viewport][0], dt[:viewport][1],
            dt[:workarea][0], dt[:workarea][1], dt[:workarea][2], dt[:workarea][3], dt[:title])
   end
-when :desktop_number
-  wm.change_number_of_desktops(options[:desktop_number])
+when :move_to_desktop
+  wm.action_window(specify_window(options[:target], options)[:id], :move_to_desktop, options[:desktop_number])
+when :move_to_current
+  wm.action_window(specify_window(options[:target], options)[:id], :move_to_current)
+when :change_number_of_desktops, :change_geometry, :change_viewport, :showing_desktop, :switch_desktop
+  wm.__send__(options[:mode], *options[:arguments])
+when :set_title_both, :set_title_short, :set_title_long
+  wm.action_window(specify_window(options[:target], options)[:id], options[:mode], *options[:arguments])
 when :wm_info
   info = wm.info
   puts "Name: #{info[:name]}"

data/ext/wmctrl.c

@@ -61,7 +61,9 @@ static ID id_select, id_active, id_activate, id_close, id_move_resize,
 
 static void rb_wmctrl_free (void **ptr)
 {
-  XCloseDisplay(*ptr);
+  Display **disp;
+  disp = (Display **) ptr;
+  XCloseDisplay(*disp);
   free(ptr);
 }
 
@@ -237,11 +239,12 @@ static gchar *get_window_title (Display *disp, Window win)
 }
 
 /*
-  call-seq:
-    wm.list_windows(get_state = nil)
+  @overload list_windows(get_state = nil)
 
   Get list of information of windows.
   @param get_state [Boolean] If the value is true then we get some properties at the same time
+
+  @return [Hash] An array of hashes of window information.
 */
 static VALUE rb_wmctrl_list_windows (int argc, VALUE *argv, VALUE self) {
   Display **ptr, *disp;
@@ -387,7 +390,11 @@ static VALUE rb_wmctrl_list_windows (int argc, VALUE *argv, VALUE self) {
   return window_ary;
 }
 
-/* Get list of information of desktops. */
+/*
+  Get list of information of desktops.
+  
+  @return [Hash] An array of hashes of desktop information.
+*/
 static VALUE rb_wmctrl_list_desktops (VALUE self) {
   Display **ptr, *disp;
   unsigned long *num_desktops = NULL;
@@ -609,7 +616,15 @@ static VALUE rb_wmctrl_list_desktops (VALUE self) {
   return ret;
 }
 
-/* Switch desktop. */
+/*
+  @overload switch_desktop(desktop_id)
+  
+  Switch desktop.
+
+  @param desktop_id [Integer] ID number of desktop.
+  
+  @return [Qtrue]
+*/
 static VALUE rb_wmctrl_switch_desktop (VALUE self, VALUE desktop_id) {
   int target;
   Display **ptr, *disp;
@@ -624,7 +639,11 @@ static VALUE rb_wmctrl_switch_desktop (VALUE self, VALUE desktop_id) {
   return Qtrue;
 }
 
-/* Get hash of information of window manager. */
+/*
+  Get hash of information of window manager.
+  
+  @return [Hash]
+*/
 static VALUE rb_wmctrl_info (VALUE self) {
   Display **ptr, *disp;
   Window *sup_window = NULL;
@@ -632,7 +651,7 @@ static VALUE rb_wmctrl_info (VALUE self) {
   gchar *wm_class = NULL;
   unsigned long *wm_pid = NULL;
   unsigned long *showing_desktop = NULL;
-  gboolean name_is_utf8 = TRUE;
+  gboolean name_is_utf8;
   VALUE ret = rb_hash_new();
 
   Data_Get_Struct(self, Display*, ptr);
@@ -644,11 +663,13 @@ static VALUE rb_wmctrl_info (VALUE self) {
 					       XA_CARDINAL, "_WIN_SUPPORTING_WM_CHECK", NULL))) {
       fputs("Cannot get window manager info properties.\n"
 	    "(_NET_SUPPORTING_WM_CHECK or _WIN_SUPPORTING_WM_CHECK)\n", stderr);
-      return EXIT_FAILURE;
+      /* return EXIT_FAILURE; */
+      return Qfalse;
     }
   }
 
   /* WM_NAME */
+  name_is_utf8 = TRUE;
   if (! (wm_name = get_property(disp, *sup_window,
 				XInternAtom(disp, "UTF8_STRING", False), "_NET_WM_NAME", NULL))) {
     name_is_utf8 = FALSE;
@@ -657,8 +678,12 @@ static VALUE rb_wmctrl_info (VALUE self) {
       p_verbose("Cannot get name of the window manager (_NET_WM_NAME).\n");
     }
   }
+  if (wm_name) {
+    rb_hash_aset(ret, key_name, (name_is_utf8 ? RB_UTF8_STRING_NEW2(wm_name) : rb_str_new(wm_name, strlen(wm_name))));
+  }
 
   /* WM_CLASS */
+  name_is_utf8 = TRUE;
   if (! (wm_class = get_property(disp, *sup_window,
 				 XInternAtom(disp, "UTF8_STRING", False), "WM_CLASS", NULL))) {
     name_is_utf8 = FALSE;
@@ -667,6 +692,9 @@ static VALUE rb_wmctrl_info (VALUE self) {
       p_verbose("Cannot get class of the window manager (WM_CLASS).\n");
     }
   }
+  if (wm_class) {
+    rb_hash_aset(ret, key_class, (name_is_utf8 ? RB_UTF8_STRING_NEW2(wm_class) : rb_str_new(wm_class, strlen(wm_class))));
+  }
 
   /* WM_PID */
   if (! (wm_pid = (unsigned long *)get_property(disp, *sup_window,
@@ -680,8 +708,6 @@ static VALUE rb_wmctrl_info (VALUE self) {
     p_verbose("Cannot get the _NET_SHOWING_DESKTOP property.\n");
   }
 
-  rb_hash_aset(ret, key_name, (wm_name ? RB_UTF8_STRING_NEW2(wm_name) : Qnil));
-  rb_hash_aset(ret, key_class, (wm_class ? RB_UTF8_STRING_NEW2(wm_class) : Qnil));
   rb_hash_aset(ret, key_pid, (wm_pid ? UINT2NUM(*wm_pid) : Qnil));
   rb_hash_aset(ret, key_showing_desktop,
 	       (showing_desktop ? RB_UTF8_STRING_NEW2(*showing_desktop == 1 ? "ON" : "OFF") : Qnil));
@@ -695,7 +721,15 @@ static VALUE rb_wmctrl_info (VALUE self) {
   return ret;
 }
 
-/* Minimize windows to show desktop. */
+/*
+  @overload showing_desktop(state)
+  
+  Minimize windows to show desktop if the window manager implements "show the desktop" mode.
+  
+  @param state [boolean] We set true if we want to turn on showing desktop mode.
+  
+  @return [true]
+*/
 static VALUE rb_wmctrl_showing_desktop (VALUE self, VALUE state) {
   Display **ptr, *disp;
   Data_Get_Struct(self, Display*, ptr);
@@ -704,6 +738,16 @@ static VALUE rb_wmctrl_showing_desktop (VALUE self, VALUE state) {
   return Qtrue;
 }
 
+/*
+  @overload change_viewport(x, y)
+  
+  Change the viewport. A window manager may ignore this request.
+  
+  @param x [Integer] Offset of top position
+  @param y [Integer] Offset of left position
+
+  @return [true]
+ */
 static VALUE rb_wmctrl_change_viewport (VALUE self, VALUE xnum, VALUE ynum) {
   long x, y;
   Display **ptr, *disp;
@@ -718,6 +762,16 @@ static VALUE rb_wmctrl_change_viewport (VALUE self, VALUE xnum, VALUE ynum) {
   return Qtrue;
 }
 
+/*
+  @overload change_geometry(w, h)
+  
+  Change geometry of all desktops. A window manager may ignore this request.
+
+  @param w [Ineteger] Width
+  @param h [Ineteger] Height
+
+  @return [true]
+*/
 static VALUE rb_wmctrl_change_geometry (VALUE self, VALUE xnum, VALUE ynum) {
   long x, y;
   Display **ptr, *disp;
@@ -732,7 +786,15 @@ static VALUE rb_wmctrl_change_geometry (VALUE self, VALUE xnum, VALUE ynum) {
   return Qtrue;
 }
 
-/* Change number of desktops. */
+/*
+  @overload change_number_of_desktops(num)
+  
+  Change number of desktops.
+  
+  @param num [Integer] Number of desktops.
+
+  @return [true]
+*/
 static VALUE rb_wmctrl_change_number_of_desktops (VALUE self, VALUE num) {
   long n;
   Display **ptr, *disp;
@@ -1109,15 +1171,17 @@ static Window get_target_window (Display *disp, VALUE obj)
 }
 
 /*
-  call-seq:
-    wm.action_window(wid, cmd, *args)
+  @overload action_window(wid, cmd, *args)
   
   Manage windows.
   @param wid Window ID
   @param cmd [Symbol] Symbol of command
   @param args [Array] Arguments for the command
+
+  @return [boolean] true if succeeded. Otherwise, false.
   
   @example
+    wm.action_window(wid, :activate)
     wm.action_window(wid, :close)
     wm.action_window(wid, :move_resize, grav, x, y, w, h)
     wm.action_window(wid, :change_state, add, prop1, prop2 = nil)
@@ -1169,6 +1233,11 @@ static VALUE rb_wmctrl_action_window(int argc, VALUE *argv, VALUE self) {
   }
 }
 
+/*
+  Get an array of _NET_SUPPORTED property.
+
+  @return [Array] An array of strings.
+ */
 static VALUE rb_wmctrl_supported (VALUE self)
 {
   Atom *list;
@@ -1207,8 +1276,8 @@ void Init_wmctrl()
   rb_define_method(rb_wmctrl_class, "switch_desktop", rb_wmctrl_switch_desktop, 1);
   rb_define_method(rb_wmctrl_class, "info", rb_wmctrl_info, 0);
   rb_define_method(rb_wmctrl_class, "showing_desktop", rb_wmctrl_showing_desktop, 1);
-  rb_define_method(rb_wmctrl_class, "change_viewport", rb_wmctrl_change_viewport, 0);
-  rb_define_method(rb_wmctrl_class, "change_geometry", rb_wmctrl_change_geometry, 0);
+  rb_define_method(rb_wmctrl_class, "change_viewport", rb_wmctrl_change_viewport, 2);
+  rb_define_method(rb_wmctrl_class, "change_geometry", rb_wmctrl_change_geometry, 2);
   rb_define_method(rb_wmctrl_class, "change_number_of_desktops", rb_wmctrl_change_number_of_desktops, 1);
   rb_define_method(rb_wmctrl_class, "action_window", rb_wmctrl_action_window, -1);
   rb_define_method(rb_wmctrl_class, "supported", rb_wmctrl_supported, 0);

data/lib/wmctrl.rb

@@ -1,2 +1,2 @@
-require 'wmctrl.so'
+require 'wmctrl/wmctrl'
 require 'wmctrl/version'

data/lib/wmctrl/version.rb

@@ -1,3 +1,3 @@
 class WMCtrl
-  VERSION = "0.0.4"
+  VERSION = "0.0.5"
 end

data/lib/wmctrl/wmctrl.rb

@@ -0,0 +1,131 @@
+require 'wmctrl.so'
+
+class WMCtrl
+  def self.instance
+    @wmctrl ||= self.new
+  end
+
+  class DataHash
+    def initialize(data_hash)
+      @data = data_hash
+    end
+
+    def method_missing(*args, &block)
+      @data.__send__(*args, &block)
+    end
+  end
+
+  class Desktop < DataHash
+    [:id, :current, :title, :geometry, :viewport, :workarea].each do |key|
+      define_method(key) do
+        self[key]
+      end
+    end
+
+    # Valid keys of the method[] are :id, :current, :title, :geometry, :viewport, and :workarea.
+  end
+
+  class Window < DataHash
+    [:id, :title, :active, :desktop, :client_machine,
+     :pid, :geometry, :state, :exterior_frame, :frame_extents, :strut].each do |key|
+      define_method(key) do
+        self[key]
+      end
+    end
+
+    # Because method name "class" is a basic ruby method, we use "wm_class" to get window class.
+    def wm_class
+      self[:class]
+    end
+
+    # @param [Symbol] key Valid keys are :class, :id, :title, :active, :desktop, :client_machine,
+    #   :pid, :geometry, :state, :exterior_frame, :frame_extents, and :strut.
+    #   :wm_class is an alias of :class.
+    def [](key)
+      if key == :wm_class
+        self.wm_class
+      else
+        super(key)
+      end
+    end
+
+    def sticky?
+      self[:desktop] == -1
+    end
+
+    def active?
+      self[:active]
+    end
+
+    def action(*args)
+      WMCtrl.instance.action_window(self[:id], *args)
+    end
+    private :action
+
+    def close
+      action(:close)
+    end
+
+    def change_state(*args)
+      action(:change_state, *args)
+    end
+
+    def activate
+      action(:activate)
+    end
+
+    # @param [Hash] opts Options
+    # @option opts [Integer] :x X coordinate
+    # @option opts [Integer] :y Y coordinate
+    # @option opts [Integer] :width Width of window
+    # @option opts [Integer] :height Height of window
+    # @option opts [Integer,:current] :desktop Desktop number
+    def place(opts = {})
+      if opts[:desktop]
+        if opts[:desktop] == :current
+          action(:move_to_current)
+        elsif (opts[:desktop] != self[:desktop])
+          action(:move_to_desktop, opts[:desktop])
+        end
+      end
+      x = self[:exterior_frame][0]
+      y = self[:exterior_frame][1]
+      width = self[:exterior_frame][2]
+      height = self[:exterior_frame][3]
+      extent_horizontal = self[:frame_extents][0] + self[:frame_extents][1]
+      extent_vertical = self[:frame_extents][2] + self[:frame_extents][3]
+      width = opts[:width] if opts[:width] && (opts[:width] != width)
+      height = opts[:height] if opts[:height] && (opts[:height] != height)
+      x = opts[:x] if opts[:x] && (opts[:x] != x)
+      y = opts[:y] if opts[:y] && (opts[:y] != y)
+      action(:move_resize, 0, x + self[:frame_extents][0], y + self[:frame_extents][1], width - extent_horizontal, height - extent_vertical)
+    end
+  end
+
+  # @return [Array] An array of WMCtrl::Desktop
+  def desktops
+    list_desktops.map { |hash| WMCtrl::Desktop.new(hash) }
+  end
+
+  # @param [Array] conditions An array of condition hash. The values of hash are tested by the method ===.
+  # @return [Array] An array of WMCtrl::Window
+  def windows(*conditions)
+    wins = list_windows(true).map { |hash| WMCtrl::Window.new(hash) }
+    unless conditions.empty?
+      wins_selected = []
+      conditions.each do |condition|
+        wins_rest = []
+        wins.each do |win|
+          if condition.all? { |k, v| v === win[k] }
+            wins_selected << win
+          else
+            wins_rest << win
+          end
+        end
+        wins = wins_rest
+      end
+      wins = wins_selected
+    end
+    wins
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'ext'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'rspec'
+require 'wmctrl'

data/spec/wmctrl_spec.rb

@@ -0,0 +1,46 @@
+require "spec_helper"
+
+describe WMCtrl do
+  before(:all) do
+    @wm = WMCtrl.new
+  end
+
+  let :wm do
+    @wm
+  end
+
+  it "should get an array of hashes." do
+    wins = wm.list_windows
+    wins.should be_an_instance_of Array
+    wins.each do |w|
+      w.should be_an_instance_of Hash
+    end
+  end
+
+  it "should get an array of hashes." do
+    desktops = wm.list_desktops
+    desktops.should be_an_instance_of Array
+    desktops.each do |w|
+      w.should be_an_instance_of Hash
+    end
+  end
+
+  it "should get information of window manager." do
+    wm.info.should be_an_instance_of Hash
+  end
+
+  it "should get an array." do
+    sp = wm.supported
+    sp.should be_an_instance_of Array
+    sp.each do |prop|
+      prop.should be_an_instance_of String
+    end
+  end
+
+  # action_window(wid, cmd, *args)
+  # change_geometry(w, h)
+  # change_number_of_desktops(num)
+  # change_viewport(x, y)
+  # showing_desktop(state)
+  # switch_desktop(desktop_id)
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-wmctrl
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
   prerelease: 
 platform: ruby
 authors:
@@ -9,41 +9,56 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-09-25 00:00:00.000000000 Z
+date: 2013-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &7241240 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *7241240
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &7240760 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *7240760
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pkg-config
-  requirement: &7240220 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *7240220
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Ruby bindings to control windows in EWMH and NetWM compatible X Window
   manager, which is created from source code of wmctrl command.
 email:
@@ -65,6 +80,7 @@ files:
 - ext/wmctrl.c
 - lib/wmctrl.rb
 - lib/wmctrl/version.rb
+- lib/wmctrl/wmctrl.rb
 - ruby-wmctrl.gemspec
 - sample/activate.rb
 - sample/change_number_of_desktops.rb
@@ -80,6 +96,8 @@ files:
 - sample/showing_desktop.rb
 - sample/supported.rb
 - sample/switch_desktop.rb
+- spec/spec_helper.rb
+- spec/wmctrl_spec.rb
 homepage: ''
 licenses: []
 post_install_message: 
@@ -90,19 +108,20 @@ require_paths:
 required_ruby_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: ruby-wmctrl
-rubygems_version: 1.8.5
+rubygems_version: 1.8.25
 signing_key: 
 specification_version: 3
 summary: Ruby bindings to control windows
 test_files: []
+has_rdoc: