auto_click 0.1.9 → 0.1.12

data/CHANGELOG

@@ -1,3 +1,9 @@
+0.1.11
+super ugly implementation of that method type (need refactoring or even rewite later)
+
+0.1.10
+implement get_key_state method
+refine the key_stroke, key_down and key_up method
 
 0.1.9
 Add support for keybaord region specific keys using US-keyboard standard

data/README.rdoc

@@ -1,5 +1,6 @@
 = AutoClick
 
+
 Smulating mouse click, cursor movement and keystrokes
 
 == Install
@@ -7,7 +8,31 @@ Smulating mouse click, cursor movement and keystrokes
 To install auto_click:
 
   gem install auto_click
-  
+
+== Method List
+
+- left_click
+
+- right_click
+
+- cursor_position
+
+- mouse_move(x,y)
+
+- mouse_scroll(step)
+
+- left_drag(sx,sy,ex,ey)
+
+- right_drag(sx,sy,ex,ey)
+
+- type(string)
+
+- key_stroke(key_name)
+
+- key_down(key_name)
+
+- key_up(key_name)
+
 == Usage
 
 To use the methods provided by auto_click. You need to require it.
@@ -36,6 +61,24 @@ To drag the icon on (50,50) to (200,300):
 
   left_drag(50,50,200,300)
  
+Suppose the notepad window on the top left corner of the screen, to type "Auto Click" in notepad. (Methods like get_windows("notepad") will be implemented in future release. So that you do not need to use this left click things to get focus on the notepad window......in later release......) 
+
+  mouse_move(100,100)
+  leftclick
+  type('Auto Click')                
+  
+The type method will Send keystroke for every characters of the strings. It will ensure that the capslock is off and hold shift when it is typing a capital character. 
+Notice that you need to escape the character \ and ' in single quote string, and you need to escape \  " and # in double quote string.
+For example, to type #''\ , you can either do:
+
+  type('#\'\'\\')
+  
+or
+    
+  type("\#''\\)
+  
+To get more refine control of key stroke simulation, you can use the method key_stroke, key_up and key_down methods
+
 To send keystroke 'a':
 
   key_stroke('a')
@@ -43,11 +86,9 @@ To send keystroke 'a':
 To send keystroke tab:
 
   key_stroke('tab')
-  
-Suppose the notepad window on the top left corner of the screen, to type "Auto Click" in notepad (assume that the capslock is off):
 
-  mouse_move(100,100)
-  leftclick            
+Therefore, to type "Auto Click" , you can either use the type method stated before, or you can do:
+
   key_down('shift')        
   key_stroke('a')  
   key_up('shift')
@@ -61,8 +102,8 @@ Suppose the notepad window on the top left corner of the screen, to type "Auto C
   key_stroke('c')
   key_stroke('k')
   
-Methods like get_windows("notepad") will be implemented in future release.
-Notice that 'a' means the key 'a' instead of the letter 'a'. Therefore key_stroke('a') and key_stroke('A') is basically the same. If the capslock is off but you want to type the capitalized A, you need to:
+
+Notice that 'a' means the key 'a' instead of the letter 'a'. Therefore key_stroke('a') and key_stroke('A') are basically the same. If the capslock is off but you want to type the capitalized A, you need to:
 
   key_down('shift')        
   key_stroke('a')  
@@ -79,30 +120,14 @@ is the same as
   key_stroke('a')
   
   
-== Method List
-
-- left_click
-
-- right_click
-
-- cursor_position
-
-- mouse_move(x,y)
-
-- mouse_scroll(step)
-
-- left_drag(sx,sy,ex,ey)
-
-- right_drag(sx,sy,ex,ey)
-
-- key_stroke(key_name)
-
-- key_down(key_name)
-
-- key_up(key_name)
  
  
-== Change log (for full change log please refer to the CHANGELOG file in the repository
+== Change log 
+(for full change log please refer to the CHANGELOG file in the repository)
+
+- 0.1.11 Super ugly implementation of that method type (need refactoring or even rewite later)
+
+- 0.1.10 Implement get_key_state method. Refine the key_stroke, key_down and key_up method
 
 - 0.1.9 Add support for keybaord region specific keys using US-keyboard standard
 

data/auto_click.gemspec

@@ -8,16 +8,18 @@ Gem::Specification.new do |s|
   s.platform    = Gem::Platform::RUBY
   s.authors     = ["erinata"]
   s.email       = ["erinata@gmail.com"]
-  s.homepage    = ""
+  s.homepage    = "https://github.com/erinata/auto_click"
   s.summary     = %q{Smulating mouse click, cursor movement and keystrokes}
   s.description = %q{Provide several Ruby methods for simulating mouse click, cursor movement and keystrokes in Windows. 
                      This gem use DL library and SendInput method so there is no dependency on FFI, AutoIt or Win32-api. 
-                     Methods include mouse_move(x,y), left_click, right_click, cursor_position, mouse_scroll, key_up, key_down...etc.
-                     See https://github.com/erinata/auto_click for more details.
+                     Methods include mouse_move(x,y), left_click, right_click, mouse_scroll, type, key_up, key_down...etc.
+                     See https://github.com/erinata/auto_click for more details about instalation and usage.
                      (More control over mouse movement such as speed or locus will be implemented in future releases)}
   
   s.required_ruby_version = '>= 1.9.0'
-
+  
+  s.executables << 'testing'
+  
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }

data/lib/auto_click.rb

@@ -85,37 +85,171 @@ module AutoClick
     sleep 0.1
   end
   
-  def key_stroke(key)
-    code=VirtualKey.code_from_string(key)
+  def key_stroke(key_name)
+    code=VirtualKey.code_from_name(key_name)
     send_input([InputStructure.keyboard_input(code,0x0000),
                 InputStructure.keyboard_input(code,0x0002)])
   end
   
-  def key_down(key)
-    code=VirtualKey.code_from_string(key)
+  def key_down(key_name)
+    code=VirtualKey.code_from_name(key_name)
     send_input([InputStructure.keyboard_input(code,0x0000)])
   end
   
-  def key_up(key)
-    code=VirtualKey.code_from_string(key)
+  def key_up(key_name)
+    code=VirtualKey.code_from_name(key_name)
     send_input([InputStructure.keyboard_input(code,0x0002)])
   end
   
   def type(string)
-    puts string
+    key_stroke(:capslock) if get_key_state(:capslock)==1
+    string=string.to_s
+    string.each_char do |c|
+      if ('a'..'z').include? c
+        key_stroke(c.to_sym)
+      elsif ('A'..'Z').include? c
+        key_down(:leftshift)
+        key_stroke(c.to_sym)
+        key_up(:leftshift)
+      elsif ('0'..'9').include? c
+        key_stroke(('num'+c).to_sym)
+      else
+        case c
+        when ' '
+          key_stroke(:space)
+        when ';'
+          key_stroke(:semicolon)
+        when ':'
+          key_down(:leftshift)
+          key_stroke(:semicolon)
+          key_up(:leftshift)
+        when '='
+          key_stroke(:equal)
+        when '+'
+          key_down(:leftshift)
+          key_stroke(:plus)
+          key_up(:leftshift)
+        when ','
+          key_stroke(:comma)
+        when '<'
+          key_down(:leftshift)
+          key_stroke(:smallerthan)
+          key_up(:leftshift)  
+        when '-'
+          key_stroke(:hyphen)
+        when '_'
+          key_down(:leftshift)
+          key_stroke(:underscore)
+          key_up(:leftshift)
+        when '.'
+          key_stroke(:period)
+        when '>'
+          key_down(:leftshift)
+          key_stroke(:greaterthan)
+          key_up(:leftshift)
+        when '/'
+          key_stroke(:slash)
+        when '?'
+          key_down(:leftshift)
+          key_stroke(:question)
+          key_up(:leftshift)
+        when '`'
+          key_stroke(:grave)
+        when '~'
+          key_down(:leftshift)
+          key_stroke(:tilde)
+          key_up(:leftshift)
+        when '/'
+          key_stroke(:slash)
+        when '?'
+          key_down(:leftshift)
+          key_stroke(:question)
+          key_up(:leftshift)  
+        when '['
+          key_stroke(:branket)
+        when '{'
+          key_down(:leftshift)
+          key_stroke(:branket)
+          key_up(:leftshift)
+        when ']'
+          key_stroke(:closebranket)
+        when '}'
+          key_down(:leftshift)
+          key_stroke(:closebranket)
+          key_up(:leftshift)
+        when '\\'   # You need to esapce \ in the parameter string
+          key_stroke(:backslash)
+        when '|'
+          key_down(:leftshift)
+          key_stroke(:pipe)
+          key_up(:leftshift)
+        when '\''   # escape ' only for single quote string
+          key_stroke(:quote)
+        when '"'    # escape " only for double quote string
+          key_down(:leftshift)
+          key_stroke(:doublequote)
+          key_up(:leftshift)
+        when '!'
+          key_down(:leftshift)
+          key_stroke(:num1)
+          key_up(:leftshift)
+        when '@'
+          key_down(:leftshift)
+          key_stroke(:num2)
+          key_up(:leftshift)  
+        when '#'    # The sharp sign need to be escape in single quote string
+          key_down(:leftshift)
+          key_stroke(:num3)
+          key_up(:leftshift)
+        when '$'
+          key_down(:leftshift)
+          key_stroke(:num4)
+          key_up(:leftshift)
+        when '%'
+          key_down(:leftshift)
+          key_stroke(:num5)
+          key_up(:leftshift)
+        when '^'
+          key_down(:leftshift)
+          key_stroke(:num6)
+          key_up(:leftshift)
+        when '&'
+          key_down(:leftshift)
+          key_stroke(:num7)
+          key_up(:leftshift)  
+        when '*'
+          key_down(:leftshift)
+          key_stroke(:num8)
+          key_up(:leftshift)
+        when '('
+          key_down(:leftshift)
+          key_stroke(:num9)
+          key_up(:leftshift)
+        when ')'
+          key_down(:leftshift)
+          key_stroke(:num0)
+          key_up(:leftshift)  
+        end
+        
+      end
+    end
+  end
+  
+  def get_key_state(key_name)
+    code=VirtualKey.code_from_name(key_name)
+    User32.GetKeyState(code)
+    # For normal keys (such as a)
+    # When the key is down the value is -128
+    # When the key is up the value is 0
+     
+    # For toggle keys (such as capslock)  
+    # When the cap key is down and the caplock is on the value is -127
+    # When the cap key is down and the caplock is off the value is -128
+    # When the cap key is Up and the caplock is on the value is 1
+    # When the cap key is Up and the caplock is off the value is 0 
   end
-
 end
 
 
 include AutoClick  # This line allow auto include when the user require the gem
 
-  
-
-
-
-
-
-
-
-

data/lib/auto_click/user32.rb

@@ -4,4 +4,5 @@ module User32
   extern "int GetCursorPos(char*)"
   extern "int SetCursorPos(int,int)"
   extern "int SendInput(int,char*,int)"
+  extern "int GetKeyState(int)"
 end

data/lib/auto_click/version.rb

@@ -1,3 +1,3 @@
 module AutoClick
-  VERSION = "0.1.9"
+  VERSION = "0.1.12"
 end

data/lib/auto_click/virtual_key.rb

@@ -1,13 +1,13 @@
 module VirtualKey
-  def self.code_from_string(string)
+  def self.code_from_name(name)
         
-    if string.kind_of? Fixnum
-      return string
-    elsif string.kind_of? String
-      string=string.delete('_').delete('-').delete(' ')
+    if name.kind_of? Fixnum
+      return name
+    elsif name.kind_of? String
+      name=name.delete('_').delete('-').delete(' ')
     end
-    string = string.to_sym.downcase  
-    case string
+    name = name.to_sym.downcase  
+    case name
     #when
     #  0x00S
     #when
@@ -446,13 +446,13 @@ module VirtualKey
     #  0xD9
     #when
     #  0xDA
-    when :openbranket, :leftbranket, :opensquarebranket, :leftsquarebranket, :squarebranket 
+    when :branket, :openbranket, :leftbranket, :opensquarebranket, :leftsquarebranket, :squarebranket, :curlybranket, :opencurlybranket, :leftcurlybranket 
       0xDB
     when :pipe, :pipes, :bar, :brokenbar, :backslash
       0xDC
-    when :closebranket, :closesquarebranket, :rightbranket, :rightsquarebranket
+    when :closebranket, :closesquarebranket, :rightbranket, :rightsquarebranket, :closecurlybranket, :rightcurlybranket
       0xDD
-    when :quote,:singlequote,:doublequote, :rightquote
+    when :quote,:singlequote,:doublequote, :rightquote, :acute, :acuteaccent
       0xDE
     #when
     #  0xDF
@@ -520,10 +520,11 @@ module VirtualKey
     #  0xFE
     #when
     #  0xFF
-    else 0  
+    else
+      0  
     end
-    
-
   end
+  
+  
  
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 9
-  version: 0.1.9
+  - 12
+  version: 0.1.12
 platform: ruby
 authors: 
 - erinata
@@ -14,15 +14,15 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-03 00:00:00 -06:00
+date: 2011-01-04 00:00:00 -06:00
 default_executable: 
 dependencies: []
 
 description: |-
   Provide several Ruby methods for simulating mouse click, cursor movement and keystrokes in Windows. 
                        This gem use DL library and SendInput method so there is no dependency on FFI, AutoIt or Win32-api. 
-                       Methods include mouse_move(x,y), left_click, right_click, cursor_position, mouse_scroll, key_up, key_down...etc.
-                       See https://github.com/erinata/auto_click for more details.
+                       Methods include mouse_move(x,y), left_click, right_click, mouse_scroll, type, key_up, key_down...etc.
+                       See https://github.com/erinata/auto_click for more details about instalation and usage.
                        (More control over mouse movement such as speed or locus will be implemented in future releases)
 email: 
 - erinata@gmail.com
@@ -46,7 +46,7 @@ files:
 - lib/auto_click/version.rb
 - lib/auto_click/virtual_key.rb
 has_rdoc: true
-homepage: ""
+homepage: https://github.com/erinata/auto_click
 licenses: []
 
 post_install_message: