Linux 用 Xswitcher レイアウト修正ツール: ステップ XNUMX

として 以前の出版物 (xswitcher は「概念実証」段階) かなり多くの建設的なフィードバックを受け取りました (それはいいことです), 私は自由時間を費やしてプロジェクトの開発を続けました。 今、私はあなたのお金を少し使いたいと思っています... XNUMX 番目のステップは、通常とは異なります: 構成設計の提案/ディスカッションです。

どういうわけか、通常のプログラマがこれらすべてのコントロールを設定するのは信じられないほど退屈であることがわかりました。

根拠のないことのないように、内部では私が扱っているものの例を示します。
全体的に非常によく考えられた (そしてよく実装された) Apache Kafka と ZooKeeper です。
- 構成？ でも退屈だよ！ ダム XML (「すぐに使える」ものであるため)。
- ああ、ACLも欲しいですか？ でもそれはとても退屈です！ タップボロ…みたいな。

しかし、私の仕事では全く逆です。 右 （残念ながら、初めてのことはほとんどありません） 構築されたモデルにより、簡単かつ自然にさらに続けることができます （ほとんど） 図を組み立てます。

最近、データサイエンティストの懸命な努力についてのハブレに関する記事を見つけました...
この瞬間が彼らにとって完全に実現されていることがわかりました。 そして、私の練習では、彼らが言うように、「ライトバージョン」です。 マルチボリューム モデル、OOP を備えた熟練のプログラマーなど。 — これはすべて、後でそれが軌道に乗ったときに表示されます。 しかし、デザイナーは今ここから始める必要があります。

本題に入ります。 TOMLを構文の基礎として採用しました この国民から.

だって彼は (TOML) 一方で、人間による編集が可能です。 一方、XML、JSON、YAML などのより一般的な構文のいずれかに 1:1 で変換されます。
さらに、私が「github.com/BurntSushi/toml」から使用した実装は、最もファッショナブルではありませんが (まだ 1.4 構文です)、同じ (「組み込み」) JSON と構文的に互換性があります。

つまり、必要に応じて、「あなたの TOML を使って森を抜け、XXX が欲しい」と言うだけで、たった XNUMX 行でコードに「パッチ」を適用することができます。

したがって、xswitcher を設定するためにいくつかのウィンドウを作成したい場合は、 （よくわからない） 「あなたのこのいまいましい設定では」問題は起こらないと予想されます。

他のすべての場合、構文は「キー = 値」に基づきます。 (そして文字通り = [some, that, array] のようなさらに複雑なオプションがいくつかあります) 私は考えます
直感的に便利。
興味深いのは、 「焼けた」 同じ頃（2013年頃）。 ただ、私と違って、TOML の作者は適切な規模で取り組みました。

したがって、自分に合わせて実装を調整することが容易になり、その逆は起こりません。

一般に、TOML (古い Windows INI に非常に似ています) を採用します。 そして、キーボードからの最新のスキャン コードのセットに応じて一連のフックをアタッチする方法を記述する構成があります。 以下に、これまでに起こったことを一つずつ示します。 そして、なぜこのように決めたかの説明。

0. 基本的な抽象化

• スキャンコードの指定。 単純にデジタルコードは絶対に人間が判読できないため、これについては間違いなく何かをする必要があります（これは私だけです） ロロスイッチャー).
  私は「golang-evdev」から「ecodes.go」を削除しました（著者は非常に文化的にそれを示していましたが、私は元のソースを見るのが面倒でした）。 かなり怖かった点を（とりあえず）少し修正しました。 「LEFTBRACE」→「L_BRACE」のように。
• さらに、彼は「状態キー」の概念を導入しました。 通常の文法が使用されているため、長い文章は許可されません。 (ただし、最小限のオーバーヘッドでチェックできます。「直接」記録のみを使用する場合)。
• 押された内容の「重複除去機能」が組み込まれます。 したがって、状態 "repeat"=2 が書き込まれます。 1 回

1. テンプレートセクション

[Templates] # "@name@" to simplify expressions
 # Words can consist of these chars (regex)
 "WORD" = "([0-9A-Z`;']|[LR]_BRACE|COMMA|DOT|SLASH|KP[0-9])"

音声表記のある人間の言語の単語は何で構成されていますか? (書記素、別名「象形文字」の問題のいずれか)? ある種の恐ろしい「シート」。 そこで、早速「テンプレート」という概念を導入します。

2. 何かがクリックされた場合の動作 (別のスキャンコードが到着した場合)

[ActionKeys]
 # Collect key and do the test for command sequence
 # !!! Repeat codes (code=2) must be collected once per key!
 Add = ["1..0", "=", "BS", "Q..]", "L_CTRL..CAPS", "N_LOCK", "S_LOCK",
        "KP7..KPDOT", "R_CTRL", "KPSLASH", "R_ALT", "KPEQUAL..PAUSE",
        "KPCOMMA", "L_META..COMPOSE", "KPLEFTPAREN", "KPRIGHTPAREN"]

 # Drop all collected keys, including this.  This is default action.
 Drop = ["ESC", "-", "TAB", "ENTER", "KPENTER", "LINEFEED..POWER"]
 # Store extra map for these keys, when any is in "down" state.
 # State is checked via "OFF:"|"ON:" conditions in action.
 # (Also, state of these keys must persist between buffer drops.)
 # ??? How to deal with CAPS and "LOCK"-keys ???
 StateKeys = ["L_CTRL", "L_SHIFT", "L_ALT", "L_META", "CAPS", "N_LOCK", "S_LOCK",
              "R_CTRL", "R_SHIFT", "R_ALT", "R_META"]

 # Test only, but don't collect.
 # E.g., I use F12 instead of BREAK on dumb laptops whith shitty keyboards (new ThinkPads)
 Test = ["F1..F10", "ZENKAKUHANKAKU", "102ND", "F11", "F12",
          "RO..KPJPCOMMA", "SYSRQ", "SCALE", "HANGEUL..YEN",
          "STOP..SCROLLDOWN", "NEW..MAX"]

コードは全部で 768 個あります。 (ただし、「念のため」、xswitcher コードにキャッチな「サプライズ」を挿入しました)。
内部では、配列に「何をするか」関数へのリンクを埋め込むことを説明しました。 golangではこれは （突然） それは便利で明白であることがわかりました。

• ここでは「ドロップ」を最小限に抑えるつもりです。 より柔軟な処理を支持します (以下に示します)。

3. ウィンドウクラスを含むテーブル

# Some behaviour can depend on application currently doing the input.
[[WindowClasses]]
 # VNC, VirtualBox, qemu etc. emulates there input independently, so never intercept.
 # With the exception of some stupid VNC clients, which does high-level (layout-based) keyboard input.
 Regex = "^VirtualBox"
 Actions = "" # Do nothing while focus stays in VirtualBox

[[WindowClasses]]
 Regex = "^konsole"
 # In general, mouse clicks leads to unpredictable (at the low-level where xswitcher resides) cursor jumps.
 # So, it's good choise to drop all buffers after click.
 # But some windows, e.g. terminals, can stay out of this problem.
 MouseClickDrops = 0
 Actions = "Actions"

[[WindowClasses]] # Default behaviour: no Regex (or wildcard like ".")
 MouseClickDrops = 1
 Actions = "Actions"

テーブルの行は、名前とともに二重角かっこで囲まれています。 すぐにこれほど簡単なことはありませんでした。 現在アクティブなウィンドウに応じて、次のオプションを選択できます。

• 独自の「ホット キー」セット「アクション = …」。 そうでない場合、または空の場合は、何も行いません。
• 「MouseClickDrops」スイッチ - マウスクリックが検出されたときに何をするか。 xswitcher がオンになった時点では「どこでクリックされるか」に関する詳細がないため、デフォルトでバッファをリセットします。 しかし、ターミナルでは（たとえば）これを行う必要はありません （いつもの）.

4. XNUMX つ (または複数) のクリック シーケンスにより、XNUMX つまたは別のフックがトリガーされます。

# action = [ regex1, regex2, ... ]
# "CLEAN" state: all keys are released
[Actions]
# Inverse regex is hard to understand, so extract negation to external condition.
# Expresions will be checked in direct order, one-by-one. Condition succceds when ALL results are True.
 # Maximum key sequence length, extra keys will be dropped. More length - more CPU.
 SeqLength = 8
 # Drop word buffer and start collecting new one
 NewWord = [ "OFF:(CTRL|ALT|META)  SEQ:(((BACK)?SPACE|[LR]_SHIFT):[01],)*(@WORD@:1)", # "@WORD@:0" then collects the char
             "SEQ:(@WORD@:2,@WORD@:0)", # Drop repeated char at all: unlikely it needs correction
             "SEQ:((KP)?MINUS|(KP)?ENTER|ESC|TAB)" ] # Be more flexible: chars line "-" can start new word, but must not completelly invalidate buffer!
 # Drop all buffers
 NewSentence = [ "SEQ:(ENTER:0)" ]

 # Single char must be deleted by single BS, so there is need in compose sequence detector.
 Compose = [ "OFF:(CTRL|L_ALT|META|SHIFT)  SEQ:(R_ALT:1,(R_ALT:2,)?(,@WORD@:1,@WORD@:0){2},R_ALT:0)" ]

 "Action.RetypeWord" = [ "OFF:(CTRL|ALT|META|SHIFT)  SEQ:(PAUSE:0)" ]
 "Action.CyclicSwitch" = [ "OFF:(R_CTRL|ALT|META|SHIFT)  SEQ:(L_CTRL:1,L_CTRL:0)" ] # Single short LEFT CONTROL
 "Action.Respawn" = [ "OFF:(CTRL|ALT|META|SHIFT)  SEQ:(S_LOCK:2,S_LOCK:0)" ] # Long-pressed SCROLL LOCK

 "Action.Layout0" = [ "OFF:(CTRL|ALT|META|R_SHIFT)  SEQ:(L_SHIFT:1,L_SHIFT:0)" ] # Single short LEFT SHIFT
 "Action.Layout1" = [ "OFF:(CTRL|ALT|META|L_SHIFT)  SEQ:(R_SHIFT:1,R_SHIFT:0)" ] # Single short RIGHT SHIFT

 "Action.Hook1" = [ "OFF:(CTRL|R_ALT|META|SHIFT)  SEQ:(L_ALT:1,L_ALT:0)" ]

フックはXNUMX種類に分かれます。 「話す」名前 (NewWord、NewSentence、Compose) が組み込まれており、プログラム可能です。

プログラム可能な名前は「Action」で始まります。 なぜならTOML v1.4、ドットを含む名前は引用符で囲む必要があります。

各セクションについては以下で説明します 同じ名前で.

「裸の」常連客に人々の心を驚かせないために（経験上、彼らの 書くたぶんXNUMX人にXNUMX人 専門家)、すぐに追加の構文を実装します。

• 「オフ:」(または「オン:」) regexp (正規表現) の前に、次のボタンを放す (または押す) 必要があります。
  次に「不公平」な正規表現を作成します。 パイプ「|」間の部分を個別にチェックします。 "[LR]_SHIFT" のようなレコードの数を減らすため (これは明らかに必要ではありません)。
• 「配列:」 前の条件が満たされる (または満たされない) 場合は、「通常の」正規表現と照合します。 詳細については、すぐに ^W に「regexp」ライブラリを送信します。 なぜなら、私はまだ、私のお気に入りの pcre との互換性 (「perl 互換性」) の程度を調べる気にはなっていないからです。
• 式は次の形式で記述されます。 「BUTTON_1: コード 1、BUTTON_2: コード 2」 スキャンコードを受信した順に続きます。
• チェックは常にシーケンスの最後に「ぴったり」付けられます。なので、末尾に「$」を追加する必要はありません。
• XNUMX 行内のすべてのチェックが順番に実行されます と「I」を組み合わせたものです。 ただし、値は配列として記述されるため、カンマの後に代替チェックを記述することができます。 何らかの理由でこれが必要な場合。
• 値 「SeqLength = 8」 すべてのチェックが実行されるバッファのサイズを制限します。 なぜなら私は（これまで）人生で無限のリソースに出会ったことはありません。

5. 前のセクションで説明したフックの設定

# Action is the array, so actions could be chained (m.b., infinitely... Have I to check this?).
# For each action type, extra named parameters could be collected. Invalid parameters will be ignored(?).
[Action.RetypeWord] # Switch layout, drop last word and type it again
 Action = [ "Action.CyclicSwitch", "RetypeWord" ] # Call Switch() between layouts tuned below, then RetypeWord()

[Action.CyclicSwitch] # Cyclic layout switching
 Action = [ "Switch" ] # Internal layout switcher func
 Layouts = [0, 1]

[Action.Layout0] # Direct layout selection
 Action = [ "Layout" ] # Internal layout selection func
 Layout = 0

[Action.Layout1] # Direct layout selection
 Action = [ "Layout" ] # Internal layout selection func
 Layout = 1

[Action.Respawn] # Completely respawn xswitcher. Reload config as well
 Action = [ "Respawn" ]

[Action.Hook1] # Run external commands
  Action = [ "Exec" ]
  Exec = "/path/to/exec -a -b --key_x"
  Wait = 1
  SendBuffer = "Word" # External hook can process collected buffer by it's own means.

ここで重要なことは、 「アクション = [配列]」。 前のセクションと同様に、組み込みアクションのセットは限られています。 そしてドッキングの可能性は原則として制限されません (「Action.XXX」と書きます。別のセクションを書くのが面倒にならないようにしてください).
特に、修正されたレイアウトでの単語の再入力は XNUMX つの部分に分かれています。 「そこに指定されているようにレイアウトを変更します」 и 「再入力」（「RetypeWord」）.

残りのパラメータは「辞書」に書き込まれます。 (golangでは「地図」) 特定のアクションについて、そのリストは「アクション」に書かれた内容によって異なります。

複数の異なるアクションを XNUMX つのヒープに記述できます (セクション)。 あるいは、引き離すこともできます。 上で示したように。

すぐに「Exec」アクションを設定して外部スクリプトを実行します。 記録されたバッファを標準入力にプッシュするオプション付き。

• 「Wait = 1」 — 実行中のプロセスが完了するまで待ちます。
• おそらく、環境に追加の人を「ヒープに」配置する必要があるでしょう。 インターセプト元のウィンドウ クラスの名前などの情報。
  「ハンドラーに接続しますか? ここがあなたが行かなければならない場所です。」

ふぅ（息を吐く）。 何も忘れていないようです。

おっとっと！ そう、忘れてなかったんだ…
起動設定はどこにありますか? ハードコードで? そのように：

[ScanDevices]
 # Must exist on start. Self-respawn in case it is younger then 30s
 Test = "/dev/input/event0"
 Respawn = 30
 # Search mask
 Search = "/dev/input/event*"
 # In my thinkPads there are such a pseudo-keyboards whith tons of unnecessary events
 Bypass = "(?i)Video|Camera" # "(?i)" obviously differs from "classic" pcre's.

どこを忘れた/間違えたのでしょうか? (これなしでは無理)、注意深い読者が、鼻を突くのを怠らないことを心から願っています。

頑張ってください！

出所： habr.com