autoit-ffi 0.0.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3613690a78037261fc15a2a6723f52c469b87694
+  data.tar.gz: 18ea7e0989be9142041bfd6f689e94e465df4076
+SHA512:
+  metadata.gz: f392109bdfb476f33e133a061c18dd46786088c56120931880da6f499e53625d7f59997ff778f17e95b59fc3d6206b7b8307d1373dd0f20377ce0d7a483e5a11
+  data.tar.gz: d80020b667b23952752531214b71c1e9545365a6c6762b8ecb17f20872fb7e6f378d382dc30347c23212c9bc8927feccfb62c4073441a3c927203155b9624e3d

data/lib/autoit-ffi.rb

@@ -0,0 +1,145 @@
+#encoding: utf-8
+
+require 'ffi'
+require_relative 'function_attacher'
+
+module AutoItFFI
+
+  module AutoIt
+
+    # "Default" value for _some_ int parameters (largest negative number)
+    AU3_INTDEFAULT = -2147483647
+    # Used when constructing strings consumed by AutoIt
+    UTF_16LE_NULL = "\0".encode("UTF-16LE")
+
+    extend FFI::Library
+    ffi_lib File.expand_path(File.dirname(__FILE__)) + "/../dll/AutoItX3.dll"
+    ffi_convention :stdcall
+
+    FunctionAttacher.attach(self)
+    self.AU3_Init
+
+    module_function
+
+    def error
+      self.AU3_error
+    end
+
+    def auto_it_set_option(option, value)
+      self.AU3_AutoItSetOption(to_utf16(option), value.to_i)
+    end
+
+    def admin?
+      self.AU3_IsAdmin == 1
+    end
+
+    def block_input(flag)
+      flag_int = flag ? 1 : 0
+      self.AU3_BlockInput(flag_int)
+    end
+
+    def cd_tray(drive, action)
+      result = self.AU3_CDTray(to_utf16(drive), to_utf16(action))
+      result == 1
+    end
+
+    #
+    # TODO: currently this method allocates a buffer that can hold 10000 utf16 characters to which
+    # the clipboard data is read to. A better approach would be to first query the size of the clipboard
+    # and allocate a buffer that fits that size. Note that the program will crash if there is more than 10000
+    # characters in the clipboard.
+    #
+    def clip_get
+      buffer = FFI::MemoryPointer.new(:uint16, 10000, true) # allocate 20000 bytes and zero out the memory.
+      self.AU3_ClipGet(buffer, 10000)
+      clipboard_data = buffer.read_string(buffer.size)
+      clipboard_data.force_encoding("UTF-16LE").encode("UTF-8").rstrip
+    end
+
+    def control_click(title, text, control, button, num_clicks, x = AU3_INTDEFAULT, y = AU3_INTDEFAULT) 
+      self.AU3_ControlClick(to_utf16(title),
+                            to_utf16(text),
+                            to_utf16(control),
+                            to_utf16(button),
+                            num_clicks.to_i,
+                            x.to_i,
+                            y.to_i)
+    end
+
+    def move_mouse(x, y, speed = 10)
+      self.AU3_MouseMove(x.to_i, y.to_i, speed.to_i)
+    end
+
+    def get_mouse_pos_x
+      self.AU3_MouseGetPosX
+    end
+
+    def get_mouse_pos_y
+      self.AU3_MouseGetPosY
+    end
+
+    def window_minimize_all
+      self.AU3_WinMinimizeAll
+    end
+
+    def window_minimize_all_undo
+      self.AU3_WinMinimizeAllUndo
+    end
+
+    def mouse_wheel(direction, clicks)
+      self.AU3_MouseWheel(to_utf16(direction), clicks.to_i)
+    end
+
+    def send(text, mode = :special)
+      mode_int = mode.to_sym == :raw ? 1 : 0
+      self.AU3_Send(to_utf16(text), mode_int)
+    end
+
+    def sleep(milliseconds)
+      self.AU3_Sleep(milliseconds.to_i)
+    end
+
+    def shutdown(*args)
+      if args.size == 1 && args.first.is_a?(Fixnum)
+        self.AU3_Shutdown(args.first.to_i)
+      else
+        options_hash = {logoff: 0, shutdown: 1, reboot: 2, force: 4, power_down: 8}
+        options = options_hash.keys & args.map(&:to_sym)
+        opt_num = options.map { |option| options_hash[option] }.inject(:+)
+        raise ArgumentError, "Illegal arguments #{args.inspect}" if opt_num.nil?
+        self.AU3_Shutdown(opt_num.to_i)
+      end
+    end
+
+    def tool_tip(tip, x = AU3_INTDEFAULT, y = AU3_INTDEFAULT)
+      self.AU3_ToolTip(to_utf16(tip), x.to_i, y.to_i)
+    end
+
+    def win_close(title, text = "")
+      result = self.AU3_WinClose(to_utf16(title), to_utf16(text))
+      result == 1
+    end
+
+    def win_exists?(title, text = "")
+      result = self.AU3_WinExists(to_utf16(title), to_utf16(text))
+      result == 1
+    end
+
+    def win_kill(title, text = "")
+      self.AU3_WinKill(to_utf16(title), to_utf16(text))
+    end
+
+    # --- Helpers ----
+  
+    # All AutoIt functions that take strings expect the strings to be of the "LPCWSTR"
+    # or "LPWSTR" types, which use 2 bytes per character. This method calls to_s on its
+    # argument and converts the string to UTF-16LE so that AutoIt can use it. Note that the
+    # NULL character must be explicitly added.
+    #
+    def to_utf16(object)
+      object.to_s.encode("UTF-16LE") + UTF_16LE_NULL
+    end
+    private_class_method :to_utf16
+
+  end
+end

data/lib/function_attacher.rb

@@ -0,0 +1,46 @@
+#encoding: utf-8
+
+module AutoItFFI
+
+  module FunctionAttacher
+
+    FUNCTION_PROTOTYPES = [
+      [ :AU3_error,                 [],                          :long ],
+      [ :AU3_AutoItSetOption,       [:pointer, :long],           :long ],
+      [ :AU3_ClipGet,               [:pointer, :long],           :void ],
+      [ :AU3_Init,                  [],                          :void ],
+      [ :AU3_BlockInput,            [:long],                     :void ],
+      [ :AU3_MouseGetPosX,          [],                          :int  ],
+      [ :AU3_MouseGetPosY,          [],                          :int  ],
+      [ :AU3_IsAdmin,               [],                          :int  ],
+      [ :AU3_MouseMove,             [:long, :long, :long],       :long ],
+      [ :AU3_WinMinimizeAll,        [],                          :void ],
+      [ :AU3_WinMinimizeAllUndo,    [],                          :void ],
+      [ :AU3_MouseWheel,            [:pointer, :long],           :void ],
+      [ :AU3_CDTray,                [:pointer, :pointer],        :long ],
+      [ :AU3_Send,                  [:pointer, :long],           :void ],
+      [ :AU3_Sleep,                 [:long],                     :void ],
+      [ :AU3_Shutdown,              [:long],                     :long ],
+      [ :AU3_ToolTip,               [:pointer, :long, :long],    :void ],
+      [ :AU3_WinClose,              [:pointer, :pointer],        :long ],
+      [ :AU3_WinExists,             [:pointer, :pointer],        :long ],
+      [ :AU3_WinKill,               [:pointer, :pointer],        :long ]
+    ] 
+
+
+    # Attaches the AutoIt DLL functions to lib (which must extend FFI::Library).
+    # See "doc/Function Prototypes (C).txt" for the C header file.
+    #
+    def self.attach(lib)
+      FUNCTION_PROTOTYPES.each { |fun| lib.attach_function *fun }
+    end
+
+  end
+end
+
+# AU3_API void WINAPI AU3_MouseWheel(LPCWSTR szDirection, long nClicks);
+# AU3_API long WINAPI AU3_CDTray(LPCWSTR szDrive, LPCWSTR szAction);
+
+#AU3_API long WINAPI AU3_WinKill(LPCWSTR szTitle, /*[in,defaultvalue("")]*/LPCWSTR szText);
+#AU3_API long WINAPI AU3_Shutdown(long nFlags);
+

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: autoit-ffi
+version: !ruby/object:Gem::Version
+  version: 0.0.4
+platform: ruby
+authors:
+- Kalle Lindström
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-08 00:00:00.000000000 Z
+dependencies: []
+description: FFI bindings for AutoIt
+email: lindstrom.kalle@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/autoit-ffi.rb
+- lib/function_attacher.rb
+- dll/AutoItX3.dll
+homepage: http://github.com/kl/autoit-ffi
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: FFI bindings for AutoIt
+test_files: []