rubydotool 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4204b7f5a9a8afcf17f2d34996457fa29fe254150e9fb48c3e57ed1a7e14f849
+  data.tar.gz: c45d27723c689f97720775569d3db6ec1a3024ff33087fa66c00c1b4a6b17330
+SHA512:
+  metadata.gz: 8dcb3c06002f374cbb9a17c98763429d2acb67498f8ab6aaafe153ef93bc4ec62b20c32875d5ef97e5859b2ccdd9c45fb703937ea3c50434699660f13aa6f049
+  data.tar.gz: c9fcdb211db7294bcf9f481ee6436ef0b59ae196c45187f1a221802f36f9462e091c4d8ae722b4c8c9d1c1e00b257c18312cdc5549913bf537959b007efd09b6

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gavff
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,24 @@
+# Rubydotool
+
+A small Ruby wrapper for `ydotool`.
+
+Install `ydotool` with your system package manager, then add the gem:
+
+```ruby
+gem "rubydotool"
+```
+
+```ruby
+require "rubydotool"
+
+Rubydotool.type("Hello from Ruby")
+Rubydotool.key(28)
+Rubydotool.click
+Rubydotool.right_click
+Rubydotool.move(50, -20)
+Rubydotool.move_to(800, 450)
+```
+
+The daemon starts on the first command and stops when the Ruby process exits. `Rubydotool.start` and `Rubydotool.stop` are also available.
+
+Keys use Linux input keycodes. Mouse buttons use ydotool button codes. The process needs permission to access `/dev/uinput`.

data/lib/rubydotool/version.rb

@@ -0,0 +1,3 @@
+module Rubydotool
+  VERSION = "0.1.1"
+end

data/lib/rubydotool.rb

@@ -0,0 +1,102 @@
+require_relative "rubydotool/version"
+
+module Rubydotool
+  SOCKET = "/tmp/rubydotool-#{Process.pid}.sock"
+
+  @pid = nil
+
+  def self.start
+    return if @pid
+
+    @pid = Process.spawn(
+      "ydotoold",
+      "-p",
+      SOCKET,
+      out: File::NULL,
+      err: File::NULL
+    )
+
+    sleep 2
+  end
+
+  def self.stop
+    return unless @pid
+
+    Process.kill("TERM", @pid)
+    Process.wait(@pid)
+    @pid = nil
+
+    if File.exist?(SOCKET)
+      File.delete(SOCKET)
+    end
+  rescue Errno::ESRCH, Errno::ECHILD
+    @pid = nil
+  end
+
+  def self.run(*arguments)
+    start
+
+    environment = {"YDOTOOL_SOCKET" => SOCKET}
+
+    text_arguments = []
+
+    arguments.each do |argument|
+      text_arguments << argument.to_s
+    end
+
+    worked = system(
+      environment,
+      "ydotool",
+      *text_arguments,
+      out: File::NULL
+    )
+
+    sleep 0.1
+
+    if !worked
+      raise "ydotool command failed"
+    end
+  end
+
+  def self.type(text)
+    run("type", text)
+  end
+
+  def self.key(*keycodes)
+    events = []
+
+    keycodes.each do |keycode|
+      events << "#{keycode}:1"
+    end
+
+    keycodes.reverse.each do |keycode|
+      events << "#{keycode}:0"
+    end
+
+    run("key", *events)
+  end
+
+  def self.hotkey(*keycodes)
+    key(*keycodes)
+  end
+
+  def self.click(button = "0xC0")
+    run("click", button)
+  end
+
+  def self.right_click
+    run("click", "0xC1")
+  end
+
+  def self.move(x, y)
+    run("mousemove", x, y)
+  end
+
+  def self.move_to(x, y)
+    run("mousemove", "--absolute", x, y)
+  end
+end
+
+at_exit do
+  Rubydotool.stop
+end

metadata

@@ -0,0 +1,42 @@
+--- !ruby/object:Gem::Specification
+name: rubydotool
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- gavff
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: A small Ruby API for keyboard and mouse input through ydotool.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/rubydotool.rb
+- lib/rubydotool/version.rb
+homepage: https://github.com/gavff64/rubydotool
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.18
+specification_version: 4
+summary: A small Ruby wrapper for ydotool
+test_files: []