fusuma 2.5.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c6f872a195572cd05d5cbf86ff5a55e3b7419b9ddc3a2e1b1b09bd395adde36
-  data.tar.gz: 51c32b562df304b04a0b607b9e4404bfb7fb031fee73388a2902b56a6a94c4a5
+  metadata.gz: 4670e37d93cd689661c036a4d2a25361af7a283f407b3ffc98dd1d275d6ef675
+  data.tar.gz: 78735688ac87ab4c09ebd0f7b69000a56e5543916bd41b490df02b7130525832
 SHA512:
-  metadata.gz: 90da79d6210fc47324fda9d3b5e4f9ed1f4e820ccead8c2dc0341d2bb69e3bd691c34db39bdb83cd94529f9e69efe478d02c1cca43f4b953bddd4b0eb46f8888
-  data.tar.gz: adbd22a0b5a1d8213d96994e33a38c4cf2c6f667d33d16019cf1e4f90dee7d114301fee0c544e18e1e532fa7f10c5aa13c09963d5694072c63721bbc8f5ab065
+  metadata.gz: 998e0a7cd21c42870a7b747a0280f4aa55695bea79139f0bef3b2dbcedefc448548f4ed261b2993a67c6e9e5921fa2dcab93b595153fc9b9a04818816fdf605f
+  data.tar.gz: 8892cf28ab5d7bce157fbf7eca3c9458565585b223d36f9c15f7cc0b2d3d08248c643504f00bc33aac51b88e86270c59b3c886d968e1ce52f7f51a4614dcb16e

data/README.md

@@ -1,4 +1,5 @@
-# Fusuma [![Gem Version](https://badge.fury.io/rb/fusuma.svg)](https://badge.fury.io/rb/fusuma) [![Build Status](https://github.com/iberianpig/fusuma/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/iberianpig/fusuma/actions/workflows/ubuntu.yml)
+# Fusuma
+![Gem](https://img.shields.io/gem/v/fusuma?color=brightgreen) [![Build Status](https://github.com/iberianpig/fusuma/actions/workflows/main.yml/badge.svg)](https://github.com/iberianpig/fusuma/actions/workflows/main.yml)
 
 Fusuma is multitouch gesture recognizer.
 This gem makes your linux able to recognize swipes or pinchs and assign commands to them.
@@ -21,23 +22,28 @@ This gem makes your linux able to recognize swipes or pinchs and assign commands
 
 **IMPORTANT**: You **MUST** be a member of the **INPUT** group to read touchpad by Fusuma.
 
-```bash
+```sh
 sudo gpasswd -a $USER input
 ```
 
 Then, You apply the change with no logout or reboot.
 
-```bash
+```sh
 newgrp input
 ```
 
+**IMPORTANT**: This makes `/dev/input/` readable, so if that's an issue for you for some reason (like for privacy- or securityconcerns etc. or if it causes other parts of your OS to misbehave), **consider this your heads-up.** 
+
+<details>
+<summary>For Debian Based Distros (Ubuntu, Debian, Mint, Pop!OS)</summary>
+
 ### For Debian Based Distros (Ubuntu, Debian, Mint, Pop!OS)
 
 #### 1. Install libinput-tools
 
 You need `libinput` release 1.0 or later.
 
-```bash
+```sh
 sudo apt-get install libinput-tools
 ```
 
@@ -45,13 +51,13 @@ sudo apt-get install libinput-tools
 
 Fusuma runs in Ruby, so you must install it first.
 
-```bash
+```sh
 sudo apt-get install ruby
 ```
 
 #### 3. Install Fusuma
 
-```bash
+```sh
 sudo gem install fusuma
 ```
 
@@ -59,26 +65,31 @@ sudo gem install fusuma
 
 For sending shortcuts:
 
-```bash
+```sh
 sudo apt-get install xdotool
 ```
 
+</details>
+
+<details>
+<summary> For Arch Based Distros (Manjaro, Arch) </summary>
+
 ### For Arch Based Distros (Manjaro, Arch)
 
 #### 1. Install libinput.
 
 You need `libinput` release 1.0 or later. This is most probably installed by default on Manjaro
 
-```z-h
-sudo pacman -S libinput
+```sh
+sudo pacman -Syu libinput
 ```
 
 #### 2. Install Ruby
 
 Fusuma runs in Ruby, so you must install it first.
 
-```zsh
-sudo pacman -S ruby
+```sh
+sudo pacman -Syu ruby
 ```
 
 #### 3. Install Fusuma
@@ -87,7 +98,7 @@ sudo pacman -S ruby
 
 To install gems system-wide, see any of the methods listed on [Arch Wiki](https://wiki.archlinux.org/index.php/ruby#Installing_gems_system-wide)
 
-```zsh
+```sh
 sudo gem install fusuma
 ```
 
@@ -95,9 +106,19 @@ sudo gem install fusuma
 
 For sending shortcuts:
 
-```zsh
-sudo pacman -S xdotool
+```sh
+sudo pacman -Syu xdotool
 ```
+**For the truly lazy people:** As with pretty much anything else available as Open-Source-Software, you can install Fusuma via a package from the AUR. As off time of writing (March 2023), the package you would want is called `ruby-fusuma`.
+
+Please keep in mind that this community-built package is NOT officially supported here and while it might do the job, it is not the intended way to install.
+Installing Fusuma this way means that if things do not work as intended during or after the installation, you are on your own.
+So please do not bombard the Issues-Page here on Github if Fusuma isn't working correctly after installing it via the AUR.
+Fusuma's plugins as listed below here in this Readme can be installed as optional dependencies also via the AUR, namescheme being `ruby-fusuma-replacewithnameofplugin`.
+</details>
+
+<details>
+<summary>For Fedora</summary>
 
 ### For Fedora
 
@@ -105,7 +126,7 @@ sudo pacman -S xdotool
 
 You need `libinput` release 1.0 or later.
 
-```bash
+```sh
 sudo dnf install libinput
 ```
 
@@ -113,13 +134,13 @@ sudo dnf install libinput
 
 Fusuma runs in Ruby, so you must install it first.
 
-```bash
+```sh
 sudo dnf install ruby
 ```
 
 #### 3. Install Fusuma
 
-```bash
+```sh
 sudo gem install fusuma
 ```
 
@@ -127,27 +148,28 @@ sudo gem install fusuma
 
 For sending shortcuts:
 
-```bash
+```sh
 sudo dnf install xdotool
 ```
+</details>
 
 ### Touchpad not working in GNOME
 
 Ensure the touchpad events are being sent to the GNOME desktop by running the following command:
 
-```bash
+```sh
 gsettings set org.gnome.desktop.peripherals.touchpad send-events enabled
 ```
 
 ## Usage
 
-```bash
+```sh
 fusuma
 ```
 
 ## Update
 
-```bash
+```sh
 sudo gem update fusuma
 ```
 
@@ -156,7 +178,7 @@ sudo gem update fusuma
 You can customize the settings for gestures to put and edit `~/.config/fusuma/config.yml`.
 **NOTE: You will need to create the `~/.config/fusuma` directory if it doesn't exist yet.**
 
-```bash
+```sh
 mkdir -p ~/.config/fusuma        # create config directory
 nano ~/.config/fusuma/config.yml # edit config file.
 ```
@@ -322,7 +344,6 @@ swipe:
 #### Alternatives to xdotool
 
 - [fusuma-plugin-sendkey](https://github.com/iberianpig/fusuma-plugin-sendkey)
-
   - Emulates keyboard events
   - Low latency
   - Wayland compatible
@@ -334,7 +355,8 @@ swipe:
 - [ydotool](https://github.com/ReimuNotMoe/ydotool)
   - Wayland compatible
   - Needs more maintainers.
-  - Requires only replacing `xdotool` with `ydotool` in fusuma conf.
+
+
 
 ## Options
 
@@ -376,22 +398,22 @@ Following features are provided as plugins.
 
 Fusuma plugins are provided with the `fusuma-plugin-XXXXX` naming convention and hosted on [RubyGems](https://rubygems.org/search?utf8=%E2%9C%93&query=fusuma-plugins).
 
-| Name                                                                               | Version                                                               | About                                         |
-| ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------- |
-| [fusuma-plugin-sendkey](https://github.com/iberianpig/fusuma-plugin-sendkey)       | ![Gem Version](https://badge.fury.io/rb/fusuma-plugin-sendkey.svg)    | Emulates keyboard events                      |
-| [fusuma-plugin-wmctrl](https://github.com/iberianpig/fusuma-plugin-wmctrl)         | ![Gem Version](https://badge.fury.io/rb/fusuma-plugin-wmctrl.svg)     | Manages Window and Workspace                  |
-| [fusuma-plugin-keypress](https://github.com/iberianpig/fusuma-plugin-keypress)     | ![Gem Version](https://badge.fury.io/rb/fusuma-plugin-keypress.svg)   | Detects gestures while pressing multiple keys |
-| [fusuma-plugin-tap](https://github.com/iberianpig/fusuma-plugin-tap)               | ![Gem Version](https://badge.fury.io/rb/fusuma-plugin-tap.svg)        | Detects Tap and Hold gestures                 |
-| [fusuma-plugin-appmatcher](https://github.com/iberianpig/fusuma-plugin-appmatcher) | ![Gem Version](https://badge.fury.io/rb/fusuma-plugin-appmatcher.svg) | Configure app-specific gestures               |
+| Name                                                                               | Version                                                                         | About                                                        |
+| ---                                                                                | ---                                                                             | ---                                                          |
+| [fusuma-plugin-sendkey](https://github.com/iberianpig/fusuma-plugin-sendkey)       | ![Gem](https://img.shields.io/gem/v/fusuma-plugin-sendkey?color=brightgreen)    | Emulates keyboard events(Wayland compatible)                 |
+| [fusuma-plugin-wmctrl](https://github.com/iberianpig/fusuma-plugin-wmctrl)         | ![Gem](https://img.shields.io/gem/v/fusuma-plugin-wmctrl?color=brightgreen)     | Manages Window and Workspace                                 |
+| [fusuma-plugin-keypress](https://github.com/iberianpig/fusuma-plugin-keypress)     | ![Gem](https://img.shields.io/gem/v/fusuma-plugin-keypress?color=brightgreen)   | Detecting a combination of key presses and touchpad gestures |
+| [fusuma-plugin-tap](https://github.com/iberianpig/fusuma-plugin-tap)               | ![Gem](https://img.shields.io/gem/v/fusuma-plugin-tap?color=brightgreen)        | Detects Tap gesture                                          |
+| [fusuma-plugin-appmatcher](https://github.com/iberianpig/fusuma-plugin-appmatcher) | ![Gem](https://img.shields.io/gem/v/fusuma-plugin-appmatcher?color=brightgreen) | Configure app-specific gestures                              |
 
 
 ### Installation of Fusuma plugins
 
-```bash
+```sh
 # install fusuma-plugin-XXXX
 sudo gem install fusuma-plugin-XXXXX`
 ```
-```bash
+```sh
 # update
 sudo gem list fusuma-plugin- | cut -d' ' -f1 | xargs --no-run-if-empty sudo gem update
 ```
@@ -408,7 +430,6 @@ Currently, my open-source contribution times is not enough.
 If you like my work and want to contribute and become a sponsor, I will be able to focus on my projects.
 
 - [GitHub Sponsors](https://github.com/sponsors/iberianpig)
-- [Patreon](https://www.patreon.com/iberianpig)
 
 ## Contributing
 

data/bin/console

@@ -23,5 +23,5 @@ def reload!(print = true)
   true
 end
 
-require 'pry'
-Pry.start
+require "irb"
+IRB.start(__FILE__)

data/lib/fusuma/config/index.rb

@@ -6,17 +6,19 @@ module Fusuma
     # index for config.yml
     class Index
       def initialize(keys)
-        @keys = case keys
+        @count = 0
+        case keys
         when Array
-          keys.map do |key|
-            if key.is_a? Key
-              key
-            else
-              Key.new(key)
-            end
-          end
+          @keys = []
+          @cache_key = keys.map do |key|
+            key = Key.new(key) if !key.is_a? Key
+            @keys << key
+            key.symbol
+          end.join(",")
         else
-          [Key.new(keys)]
+          key = Key.new(keys)
+          @cache_key = key.symbol
+          @keys = [key]
         end
       end
 
@@ -24,36 +26,11 @@ module Fusuma
         @keys.map(&:inspect)
       end
 
-      attr_reader :keys
-
-      def cache_key
-        case @keys
-        when Array
-          @keys.map(&:symbol).join(",")
-        when Key
-          @keys.symbol
-        else
-          raise "invalid keys"
-        end
-      end
-
-      # @return [Index]
-      def with_context
-        keys = @keys.map do |key|
-          next if Searcher.skip? && key.skippable
-
-          if Searcher.fallback? && key.fallback
-            key.fallback
-          else
-            key
-          end
-        end
-        self.class.new(keys.compact)
-      end
+      attr_reader :keys, :cache_key
 
       # Keys in Index
       class Key
-        def initialize(symbol_word, skippable: false, fallback: nil)
+        def initialize(symbol_word, skippable: false)
           @symbol = begin
             symbol_word.to_sym
           rescue
@@ -61,21 +38,17 @@ module Fusuma
           end
 
           @skippable = skippable
-
-          @fallback = begin
-            fallback.to_sym
-          rescue
-            fallback
-          end
         end
 
         def inspect
-          skip_marker = @skippable && Searcher.skip? ? "(skip)" : ""
-          fallback_marker = @fallback && Searcher.fallback? ? "(fallback)" : ""
-          "#{@symbol}#{skip_marker}#{fallback_marker}"
+          if @skippable
+            "#{@symbol}(skippable)"
+          else
+            "#{@symbol}"
+          end
         end
 
-        attr_reader :symbol, :skippable, :fallback
+        attr_reader :symbol, :skippable
       end
     end
   end

data/lib/fusuma/config/searcher.rb

@@ -6,7 +6,7 @@ module Fusuma
     # Search config.yml
     class Searcher
       def initialize
-        @cache = nil
+        @cache = {}
       end
 
       # @param index [Index]
@@ -36,10 +36,11 @@ module Fusuma
 
         return search(index, location: location[0]) if context == {}
 
-        new_location = location.find do |conf|
-          search(index, location: conf) if conf[:context] == context
+        value = nil
+        location.find do |conf|
+          value = search(index, location: conf) if conf[:context] == context
         end
-        search(index, location: new_location)
+        value
       end
 
       # @param index [Index]
@@ -48,13 +49,12 @@ module Fusuma
       # @return [Hash]
       # @return [Object]
       def search_with_cache(index, location:)
-        cache([index.cache_key, Searcher.context, Searcher.skip?, Searcher.fallback?]) do
+        cache([index.cache_key, Searcher.context]) do
           search_with_context(index, location: location, context: Searcher.context)
         end
       end
 
       def cache(key)
-        @cache ||= {}
         key = key.join(",") if key.is_a? Array
         if @cache.key?(key)
           @cache[key]
@@ -71,37 +71,11 @@ module Fusuma
       def next_location_cadidates(location, key)
         [
           location[key.symbol],
-          Searcher.skip? && key.skippable && location
+          key.skippable && location
         ].compact
       end
 
       class << self
-        # @return [Hash]
-        def conditions(&block)
-          {
-            nothing: -> { block.call },
-            skip: -> { Config::Searcher.skip { block.call } }
-          }
-        end
-
-        # Execute block with specified conditions
-        # @param conidtion [Symbol]
-        # @return [Object]
-        def with_condition(condition, &block)
-          conditions(&block)[condition].call
-        end
-
-        # Execute block with all conditions
-        # @return [Array<Symbol, Object>]
-        def find_condition(&block)
-          conditions(&block).find do |c, l|
-            result = l.call
-            return [c, result] if result
-
-            nil
-          end
-        end
-
         # Search with context from load_streamed Config
         # @param context [Hash]
         # @return [Object]
@@ -117,48 +91,27 @@ module Fusuma
         # @return [Hash]
         def find_context(request_context, &block)
           # Search in blocks in the following order.
-          # 1. complete match config[:context] == request_context
-          # 2. partial match config[:context] =~ request_context
-          # 3. no context
+          # 1. primary context(no context)
+          # 2. complete match config[:context] == request_context
+          # 3. partial match config[:context] =~ request_context
+          return {} if with_context({}, &block)
+
           Config.instance.keymap.each do |config|
             next unless config[:context] == request_context
-            return config[:context] if with_context(config[:context]) { block.call }
+            return config[:context] if with_context(config[:context], &block)
           end
           if request_context.keys.size > 1
             Config.instance.keymap.each do |config|
               next if config[:context].nil?
 
               next unless config[:context].all? { |k, v| request_context[k] == v }
-              return config[:context] if with_context(config[:context]) { block.call }
+              return config[:context] if with_context(config[:context], &block)
             end
           end
-          return {} if with_context({}) { block.call }
         end
 
         attr_reader :context
 
-        def fallback?
-          @fallback
-        end
-
-        def skip?
-          @skip
-        end
-
-        # switch context for fallback
-        def fallback(&block)
-          @fallback = true
-          result = block.call
-          @fallback = false
-          result
-        end
-
-        def skip(&block)
-          @skip = true
-          result = block.call
-          @skip = false
-          result
-        end
       end
     end
   end

data/lib/fusuma/custom_process.rb

@@ -7,15 +7,47 @@ module Fusuma
   module CustomProcess
     attr_writer :proctitle
 
+    def child_pids
+      @child_pids ||= []
+    end
+
     def fork
-      Process.fork do
+      pid = Process.fork do
         Process.setproctitle(proctitle)
+        set_trap # for child process
         yield
       end
+      child_pids << pid
+      pid
+    end
+
+    def shutdown
+      child_pids.each do |pid|
+        Process.kill("TERM", pid)
+      rescue Errno::ESRCH
+        # ignore
+      end
+
+      child_pids.each do |pid|
+        Process.wait(pid)
+      rescue Errno::ECHILD
+        # ignore
+      end
     end
 
     def proctitle
       @proctitle ||= self.class.name.underscore
     end
+
+    def set_trap
+      Signal.trap("INT") {
+        shutdown
+        exit
+      } # Trap ^C
+      Signal.trap("TERM") {
+        shutdown
+        exit
+      } # Trap `Kill `
+    end
   end
 end

data/lib/fusuma/device.rb

@@ -66,6 +66,7 @@ module Fusuma
         line_parser = LineParser.new
 
         libinput_command = Plugin::Inputs::LibinputCommandInput.new.command
+        # note: this libinput command takes a nontrivial amout of time (~200ms)
         libinput_command.list_devices do |line|
           line_parser.push(line)
         end

data/lib/fusuma/multi_logger.rb

@@ -32,6 +32,8 @@ module Fusuma
     def debug(msg)
       return unless debug_mode?
 
+      return if ignore_pattern?(msg)
+
       super(msg)
     end
 
@@ -47,6 +49,20 @@ module Fusuma
       debug_mode
     end
 
+    def ignore_pattern?(msg)
+      # TODO: configurable from config.yml
+      pattern = /timer_input/
+      case msg
+      when Hash
+        e = msg.values.find { |v| v.is_a? Fusuma::Plugin::Events::Event }
+        return unless e
+
+        e.tag.match?(pattern)
+      else
+        false
+      end
+    end
+
     class << self
       def info(msg)
         instance.info(msg)

data/lib/fusuma/plugin/base.rb

@@ -8,7 +8,6 @@ module Fusuma
   module Plugin
     # Create a Plugin Class with extending this class
     class Base
-      include CustomProcess
       # when inherited from subclass
       def self.inherited(subclass)
         super
@@ -22,6 +21,10 @@ module Fusuma
         Manager.plugins[name]
       end
 
+      # @abstract override `#shutdown` to implement
+      def shutdown
+      end
+
       # config parameter name and Type of the value of parameter
       # @return [Hash]
       def config_param_types