fusuma 3.10.0 → 3.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7161de044b786ed9f12f64be26a497307ba1ea87159760e68b5ac90d87ea1d73
-  data.tar.gz: aa9359be7d9c0bcc6ca283ba5c2aa17b55f07424a26d3f22b056c47b924488bc
+  metadata.gz: '064986ef807ceb1aa5ce1d021cdaf8931e44a1099fe8b72cd6aee283bc7ccf3a'
+  data.tar.gz: 31d80cdd2c54c1f12a4e55005c4393ae4c3683ed0a0c3a4e506090cc2c0f4f73
 SHA512:
-  metadata.gz: 1187109a3b4b3ba67b35feaa274ab73a58dc3411ae8b3de6f62e5ef153c7ca8647383ae0cebeeb8e5632bd69ec0218477826e5e5aa4d32002233a87b521eba43
-  data.tar.gz: eec0e66de8f07b7e64ffec123b16a1b51103701346819b0b048850d83e8bf8a78c020f3d51e889f7ff5474218d534a7e7e6bf834bac36c6ff739f279a06da4c8
+  metadata.gz: f27789347f194611db15b63f8cd8f04c47e3737ad2349950ab2a9210612f76a96f166c50a136bd2e4e22cce8dd9e640f89a7f8be19f2c282b4a071650cc26af1
+  data.tar.gz: 86d0e0bac6c527e7453f4495bde1e58b4b74942b3670ee313d1a7f0323c7a4f9e5ed44c33f64614357ff8b38bbf9e265e074abbd6ce5915925233e3c7f3adc01

data/README.md

@@ -81,7 +81,7 @@ sudo apt-get install xdotool
 You need `libinput` release 1.0 or later. This is most probably installed by default on Manjaro
 
 ```sh
-sudo pacman -Syu libinput
+sudo pacman -Syu libinput-tools
 ```
 
 #### 2. Install Ruby

data/lib/fusuma/device.rb

@@ -44,18 +44,13 @@ module Fusuma
         end.flatten
       end
 
-      # @raise [SystemExit]
       # @return [Array]
       #: () -> Array[Device]
       def available
         @available ||= all.select(&:available).tap do |d|
           MultiLogger.debug(available_devices: d)
-          raise "Touchpad is not found" if d.empty?
+          MultiLogger.warn("Touchpad is not found") if d.empty?
         end
-      rescue RuntimeError => e
-        # FIXME: should not exit without Runner class
-        MultiLogger.error(e.message)
-        exit 1
       end
 
       #: () -> nil

data/lib/fusuma/libinput_command.rb

@@ -39,7 +39,10 @@ module Fusuma
     #: () { (String) -> void } -> void
     def list_devices(&block)
       cmd = list_devices_command
-      MultiLogger.debug(list_devices: cmd)
+      unless @logged_list_devices
+        MultiLogger.debug(list_devices: cmd)
+        @logged_list_devices = true
+      end
       o, _, s = Open3.capture3(cmd)
 
       unless s.success?

data/lib/fusuma/plugin/base.rb

@@ -8,7 +8,8 @@ module Fusuma
   module Plugin
     # Create a Plugin Class with extending this class
     class Base
-      # when inherited from subclass
+      # Callback when a subclass inherits from this class.
+      # Registers the subclass with the plugin manager.
       def self.inherited(subclass)
         super
 
@@ -17,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
 
@@ -28,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
@@ -42,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/filters/libinput_device_filter.rb

@@ -2,6 +2,7 @@
 
 require_relative "filter"
 require_relative "../../device"
+require_relative "../../multi_logger"
 
 module Fusuma
   module Plugin
@@ -72,12 +73,13 @@ module Fusuma
           #: () -> Array[Device]
           def all
             @all ||= if @name_patterns.empty?
-              Device.available
+              Device.all.select(&:available)
             else
               Device.all.select do |device|
                 match_pattern?(device.name)
               end
             end.tap do |devices|
+              MultiLogger.debug(available_devices: devices)
               print_not_found_messages if devices.empty?
             end
           end

data/lib/fusuma/plugin/manager.rb

@@ -33,6 +33,7 @@ module Fusuma
       end
 
       # @return [Array<String>] paths of external plugins (installed by gem)
+      #: () -> Array[untyped]
       def fusuma_external_plugin_paths
         @_fusuma_external_plugin_paths ||=
           Gem.find_latest_files(search_key).map do |siblings_plugin|
@@ -85,8 +86,13 @@ module Fusuma
         #                              Detectors::PinchDetector,
         #                              Detectors::SwipeDetector]}
 
-        # @param plugin_class [Class]
-        # return [Hash, false]
+        # 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)
 
@@ -108,7 +114,7 @@ module Fusuma
           manager.require_siblings_from_gems
         end
 
-        #: () -> void
+        #: () -> bool
         def require_base_plugins
           require_relative "base"
           require_relative "events/event"
@@ -120,7 +126,7 @@ module Fusuma
           require_relative "executors/executor"
         end
 
-        #: () -> Hash[untyped, untyped]
+        #: () -> Hash[String, Array[Class]]
         def plugins
           @plugins ||= {}
         end
@@ -136,9 +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.10.0"
+  VERSION = "3.11.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fusuma
 version: !ruby/object:Gem::Version
-  version: 3.10.0
+  version: 3.11.1
 platform: ruby
 authors:
 - iberianpig
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-19 00:00:00.000000000 Z
+date: 2026-01-10 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