fusuma 3.11.0 → 3.11.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 55410ba5fd5d7543fe4089aa09f2af2229400d49be8d9572f1e6d41af79b1079
-  data.tar.gz: fcf73fd3254b1f9ba58cf61ba5705bbbd76d8448e91a2d12a12fc08116325367
+  metadata.gz: 515a37e5be710edfd3beda67d734a49ad516dd9c01654afb0bf0d3145ab20c6d
+  data.tar.gz: ab7ab39b5097de21b58e403d3b4cdcebc3fab41327ddf0a5fb0c7a3ae6d531a3
 SHA512:
-  metadata.gz: fac06a520334b1ff98e9467f06633e801c2bd86e56860232c54bfd0a36df2cec77bc8fa1f97a8ceafbb6561221fb5ea9bd4766e58e37b780c9ba450a8ec2fdd2
-  data.tar.gz: 28098f90c6aadef6f44f4f0cc6c3e8244e9921f9e70a1dc18293f9374d1e4d3a7c0d340458e2d758bfa9a5fb0e8c2fa124170f40e8c4b3fee03de142ed1c7196
+  metadata.gz: 8f84ab4bddf97600928b348dec236008205b7261a90bdf87ee8f6409f8524864ffe587ace33569b64b8ecac773a02a58c3776908186b3a08298dac55f9b0a0ed
+  data.tar.gz: 1c2b88e154697a95e96ce8e4b4df1b712f80ac2e27d63ac06c7d6f5824e566d1479df51975241277b881a537a1fd883364e19ed4d9338a9465d39438ed644370

data/bin/console

@@ -1,8 +1,8 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require 'bundler/setup'
-require 'fusuma'
+require "bundler/setup"
+require "fusuma"
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -10,9 +10,9 @@ require 'fusuma'
 # (If you use this, don't forget to add pry to your Gemfile!)
 
 def reload!(print = true)
-  puts 'Reloading ...' if print
+  puts "Reloading ..." if print
   # Main project directory.
-  root_dir = File.expand_path('..', __dir__)
+  root_dir = File.expand_path("..", __dir__)
   # Directories within the project that should be reloaded.
   reload_dirs = %w[lib]
   # Loop through and reload every file in all relevant project directories.

data/exe/fusuma

@@ -1,47 +1,47 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require 'optparse'
-require_relative '../lib/fusuma'
+require "optparse"
+require_relative "../lib/fusuma"
 
 option = {}
 opt = OptionParser.new
 
-opt.on('-c', '--config=path/to/file',
-       'Use an alternative config file') do |v|
+opt.on("-c", "--config=path/to/file",
+  "Use an alternative config file") do |v|
   option[:config_path] = v
 end
 
-opt.on('-d', '--daemon',
-       'Daemonize process') do |v|
+opt.on("-d", "--daemon",
+  "Daemonize process") do |v|
   option[:daemon] = v
 end
 
-opt.on('-l', '--list-devices',
-       'List available devices') do |v|
+opt.on("-l", "--list-devices",
+  "List available devices") do |v|
   option[:list] = v
 end
 
-opt.on('--log=path/to/file',
-       'Print logs to file') do |v|
+opt.on("--log=path/to/file",
+  "Print logs to file") do |v|
   option[:log_filepath] = v
 end
 
-opt.on('--show-config', 'Show config as YAML format which is loaded internally') do |v|
+opt.on("--show-config", "Show config as YAML format which is loaded internally") do |v|
   option[:show_config] = v
 end
 
 opt.on('--device="Device name"',
-       'Open the given device only (DEPRECATED)') do |v|
+  "Open the given device only (DEPRECATED)") do |v|
   option[:device] = v
 end
 
-opt.on('-v', '--verbose',
-       'Show details about the results of running fusuma') do |v|
+opt.on("-v", "--verbose",
+  "Show details about the results of running fusuma") do |v|
   option[:verbose] = v
 end
 
-opt.on('--version', 'Show fusuma version') do |v|
+opt.on("--version", "Show fusuma version") do |v|
   option[:version] = v
 end
 

data/lib/fusuma/config/searcher.rb

@@ -19,18 +19,16 @@ module Fusuma
       def search(index, location:)
         key = index.keys.first
         return location if key.nil?
-
         return nil if location.nil?
-
         return nil unless location.is_a?(Hash)
 
-        next_index = Index.new(Array(index.keys[1..-1]))
+        next_index = Index.new(index.keys.drop(1))
 
-        value = nil
-        next_location_cadidates(location, key).find do |next_location|
-          value = search(next_index, location: next_location)
+        next_location_cadidates(location, key).each do |next_location|
+          result = search(next_index, location: next_location)
+          return result if result
         end
-        value
+        nil
       end
 
       #: (Fusuma::Config::Index, location: Array[untyped], context: Hash[untyped, untyped] | nil) -> untyped
@@ -77,7 +75,7 @@ module Fusuma
       def next_location_cadidates(location, key)
         [
           location[key.symbol],
-          key.skippable && location
+          key.skippable ? location : nil
         ].compact
       end
 

data/lib/fusuma/device.rb

@@ -41,9 +41,7 @@ module Fusuma
       def all
         @all ||= fetch_devices.partition do |d|
           d.capabilities.match?(/gesture/)
-        end.flatten.tap do |devices|
-          log_if_changed(devices)
-        end
+        end.flatten
       end
 
       # @return [Array]
@@ -59,22 +57,10 @@ module Fusuma
       def reset
         @all = nil
         @available = nil
-        @previous_device_ids = nil
       end
 
       private
 
-      # Log device list only when it changes
-      # @param devices [Array<Device>]
-      #: (Array[Device]) -> void
-      def log_if_changed(devices)
-        device_ids = devices.map(&:id).sort
-        return if @previous_device_ids == device_ids
-
-        MultiLogger.debug(detected_devices: devices.map { |d| {id: d.id, name: d.name} })
-        @previous_device_ids = device_ids
-      end
-
       # @return [Array]
       #: () -> Array[Device]
       def fetch_devices

data/lib/fusuma/plugin/base.rb

@@ -8,8 +8,8 @@ module Fusuma
   module Plugin
     # Create a Plugin Class with extending this class
     class Base
-      # when inherited from subclass
-      #: (Class) -> Array[untyped]
+      # Callback when a subclass inherits from this class.
+      # Registers the subclass with the plugin manager.
       def self.inherited(subclass)
         super
 
@@ -18,7 +18,11 @@ module Fusuma
           raise "Plugin class #{subclass.name} must be defined in a file."
         end
 
-        subclass_path = locations.first.path
+        subclass_path = locations.first&.path
+        if subclass_path.nil?
+          raise "Plugin class #{subclass.name} must have a valid file path."
+        end
+
         Manager.add(plugin_class: subclass, plugin_path: subclass_path)
       end
 
@@ -29,13 +33,12 @@ module Fusuma
       end
 
       # @abstract override `#shutdown` to implement
-      #: () -> nil
+      #: () -> void
       def shutdown
       end
 
       # config parameter name and Type of the value of parameter
       # @return [Hash]
-      #: () -> Hash[Symbol, Array[Class] | Class]
       def config_param_types
         raise NotImplementedError, "override #{self.class.name}##{__method__}"
       end
@@ -43,7 +46,8 @@ module Fusuma
       # @param key [Symbol]
       # @param base [Config::Index]
       # @return [Object]
-      #: (?Symbol?) -> (String | Hash[untyped, untyped] | Float | bool)?
+      #: () -> Hash[untyped, untyped]
+      #: (Symbol) -> untyped
       def config_params(key = nil)
         @config_params ||= {}
         if @config_params["#{config_index.cache_key},#{key}"]

data/lib/fusuma/plugin/detectors/detector.rb

@@ -8,6 +8,7 @@ module Fusuma
     module Detectors
       # Inherite this base
       class Detector < Base
+        #: (String) -> String
         def self.type(tag_name)
           tag_name.gsub("_detector", "")
         end

data/lib/fusuma/plugin/inputs/timer_input.rb

@@ -9,6 +9,7 @@ module Fusuma
       # libinput commands wrapper
       class TimerInput < Input
         include Singleton
+
         DEFAULT_INTERVAL = 5
         EPSILON_TIME = 0.02
         def config_param_types

data/lib/fusuma/plugin/manager.rb

@@ -86,9 +86,13 @@ module Fusuma
         #                              Detectors::PinchDetector,
         #                              Detectors::SwipeDetector]}
 
-        # @param plugin_class [Class]
-        # return [Hash, false]
-        #: (plugin_class: Class, plugin_path: String) -> Array[untyped]?
+        # Register a plugin class with the manager.
+        # @param plugin_class [Class] the plugin class to register
+        # @param plugin_path [String] the file path of the plugin
+        # @return [false] if plugin already exists
+        # @return [nil] if search_key was already required
+        # @return [Array<String>] loaded plugin paths from gems
+        #: (plugin_class: Class, plugin_path: String) -> (Array[String] | false | nil)
         def add(plugin_class:, plugin_path:)
           return false if exist?(plugin_class: plugin_class, plugin_path: plugin_path)
 
@@ -110,7 +114,7 @@ module Fusuma
           manager.require_siblings_from_gems
         end
 
-        #: () -> void
+        #: () -> bool
         def require_base_plugins
           require_relative "base"
           require_relative "events/event"
@@ -122,7 +126,7 @@ module Fusuma
           require_relative "executors/executor"
         end
 
-        #: () -> Hash[untyped, untyped]
+        #: () -> Hash[String, Array[Class]]
         def plugins
           @plugins ||= {}
         end
@@ -138,10 +142,16 @@ module Fusuma
           @load_paths ||= []
         end
 
-        # @param plugin_class [Class]
-        # @return [Boolean]
+        # Check if a plugin class is already registered.
+        # Note: This intentionally returns false if only the path is registered,
+        # allowing multiple plugin classes from the same file (e.g., subclasses).
+        # @param plugin_class [Class] the plugin class to check
+        # @param plugin_path [String] the file path of the plugin (not used for existence check)
+        # @return [Boolean] true if plugin class is already registered
         #: (plugin_class: Class, plugin_path: String) -> bool
         def exist?(plugin_class:, plugin_path:)
+          # Skip existence check if path is already in load_paths
+          # This allows multiple classes from the same file to be registered
           return false if load_paths.include?(plugin_path)
 
           base = plugin_class.superclass.name

data/lib/fusuma/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fusuma
-  VERSION = "3.11.0"
+  VERSION = "3.11.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fusuma
 version: !ruby/object:Gem::Version
-  version: 3.11.0
+  version: 3.11.2
 platform: ruby
 authors:
 - iberianpig
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-09 00:00:00.000000000 Z
+date: 2026-01-19 00:00:00.000000000 Z
 dependencies: []
 description: Fusuma is multitouch gesture recognizer. This gem makes your touchpad
   on Linux able to recognize swipes or pinchs and assign command to them. Read installation