Linux용 Xswitcher 레이아웃 교정기: XNUMX단계

으로 이전 출판물 ("개념 증명" 단계의 xswitcher)는 꽤 많은 건설적인 피드백을 받았습니다. (좋네요), 나는 계속해서 자유 시간을 프로젝트 개발에 보냈습니다. 이제 나는 당신의 작은 것을 쓰고 싶습니다 ... 두 번째 단계는 일반적이지 않습니다. 구성 설계 제안/토론입니다.

어쨌든 일반 프로그래머는 이러한 모든 컨트롤을 설정하는 것이 엄청나게 지루하다는 것이 밝혀졌습니다.

근거가 없는 일이 없도록 하기 위해 내가 다루고 있는 내용의 예가 내부에 있습니다.
전반적으로 훌륭하게 고안된(잘 구현된) Apache Kafka 및 ZooKeeper입니다.
- 구성? 하지만 지루해요! 멍청한 XML("즉시 사용 가능"하기 때문)
- 아, ACL도 원하시나요? 하지만 너무 지루해요! 탭블로퍼... 그런 거요.

하지만 내 작업에서는 정반대다. 오른쪽 (아아, 거의 처음이 아닙니다) 구축된 모델을 사용하면 더 쉽고 자연스럽게 계속할 수 있습니다. (거의) 다이어그램을 조립합니다.

최근 데이터 과학자들의 노고에 관한 Habré의 기사를 접했습니다...
이 순간이 그들에게 완전히 실현되었다는 것이 밝혀졌습니다. 그리고 실제로는 "라이트 버전"이라고 말합니다. 다중 볼륨 모델, OOP를 갖춘 노련한 프로그래머 등 — 이 모든 것은 나중에 이륙할 때 나타날 것입니다. 하지만 디자이너는 지금 여기 어딘가에서 시작해야 합니다.

요점을 파악하세요. TOML을 구문 기반으로 사용했습니다. 이 시민에게서.

그는 때문에 (TOML) 한편으로는 사람이 편집할 수 있습니다. 반면에 XML, JSON, YAML과 같은 보다 일반적인 구문으로 1:1로 변환됩니다.
더욱이, 제가 "github.com/BurntSushi/toml"에서 사용한 구현은 가장 유행하지는 않지만(여전히 1.4 구문) 동일한("내장") JSON과 구문적으로 호환됩니다.

즉, 원할 경우 간단히 "당신의 TOML로 숲을 통과하세요. 저는 XXX를 원합니다"라고 말하고 단 한 줄로 코드를 "패치"할 수 있습니다.

따라서 xswitcher를 구성하기 위해 일부 창을 작성하려는 경우 (잘 모르겠음) "이 빌어먹을 구성으로" 문제가 발생하지 않을 것으로 예상됩니다.

다른 모든 경우 구문은 "키 = 값"을 기반으로 합니다. (말 그대로 = [some, that, array]와 같은 몇 가지 더 복잡한 옵션) 나는 생각
직관적으로 편리합니다.
흥미로운 점은 "탄" 같은 시기(2013년경). 다만 저와 달리 TOML의 저자는 적당한 규모로 들어갔습니다.

따라서 이제 구현을 나 자신에게 맞게 조정하는 것이 더 쉬워졌으며 그 반대의 경우도 마찬가지입니다.

일반적으로 우리는 TOML을 사용합니다(이전 Windows INI와 매우 유사). 그리고 키보드의 최신 스캔 코드 세트에 따라 일련의 후크를 부착하는 방법을 설명하는 구성이 있습니다. 아래에는 지금까지 일어난 일이 하나씩 나와 있습니다. 그리고 내가 왜 이런 결정을 했는지에 대한 설명.

0. 기본 추상화

• 스캔 코드 지정. 단순히 디지털 코드는 사람이 읽을 수 없기 때문에 확실히 뭔가 조치를 취해야 합니다. 롤로스위치).
  나는 "golang-evdev"에서 "ecodes.go"를 흔들었습니다. (저자는 꽤 문화적으로 표시했지만 원본 소스를 보기에는 너무 게으른 상태였습니다.) 꽤 두려웠던 부분을 (지금은) 조금 수정했습니다. “LEFTBRACE” → “L_BRACE”와 같습니다.
• 또한 그는 "상태 키"라는 개념을 도입했습니다. 사용되는 정규 문법은 긴 문장을 허용하지 않기 때문입니다. (단, 최소한의 오버헤드로 확인할 수 있습니다. "직접" 녹음만 사용하는 경우)
• 누른 내용에 대한 "중복 제거기"가 내장되어 있습니다. 따라서 "repeat"=2 상태가 기록됩니다. 한 시간.

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 코드에 "놀라움"을 포착하는 기능을 삽입했습니다).
내부에서는 "무엇을 해야할지" 함수에 대한 링크로 배열을 채우는 방법을 설명했습니다. 골랑에서는 이것이다 (갑자기) 편리하고 분명한 것으로 나타났습니다.

• 이곳에서는 '드롭'을 최소한으로 줄이려고 합니다. 보다 유연한 처리를 선호합니다(아래에 표시하겠습니다).

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. 하나 이상의 클릭 시퀀스가 ​​하나 또는 다른 후크를 트리거합니다.

# 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)" ]

후크는 두 가지 유형으로 나뉩니다. "말하는" 이름(NewWord, NewSentence, Compose)이 내장되어 있으며 프로그래밍 가능합니다.

프로그래밍 가능한 이름은 "Action"으로 시작됩니다. 왜냐하면 TOML v1.4, 점이 있는 이름은 따옴표로 묶어야 합니다.

각 섹션은 아래에 설명되어 있습니다. 같은 이름으로.

"벌거벗은" 단골 손님으로 사람들의 마음을 사로잡지 않기 위해(경험상, 그들의 쓰기아마도 열에 하나쯤은 전문가), 즉시 추가 구문을 구현합니다.

• "끄기:"(또는 "켜기:") 정규식(정규식)을 사용하려면 다음 버튼을 떼거나 눌러야 합니다.
  다음으로 "불공평한" 정규식을 만들어 보겠습니다. 파이프 "|" 사이의 조각을 별도로 검사합니다. "[LR]_SHIFT"와 같은 레코드 수를 줄이기 위해(분명히 필요하지 않은 경우)
• "순서:" 이전 조건이 충족되거나 없으면 "정상적인" 정규식을 확인합니다. 자세한 내용을 보려면 즉시 "regexp" 라이브러리를 ^W로 보냅니다. 왜냐하면 나는 내가 가장 좋아하는 pcre(“perl 호환”)와의 호환성 정도를 아직까지 알아내려고 애쓰지 않았기 때문입니다.
• 표현은 다음과 같은 형식으로 작성됩니다. "BUTTON_1: CODE1, BUTTON_2: CODE2" 등, 스캔 코드가 수신되는 순서대로.
• 수표는 항상 시퀀스의 마지막 부분에 "밀착"됩니다.이므로 꼬리에 "$"를 추가할 필요가 없습니다.
• 한 줄의 모든 검사는 차례로 수행됩니다. "나"로 결합됩니다. 하지만 값이 배열로 설명되므로 쉼표 뒤에 대체 검사를 작성할 수 있습니다. 어떤 이유로든 이것이 필요한 경우.
• 가치 "순서 길이 = 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”라고 쓰고 다른 섹션을 작성하는 데 너무 게으르지 마십시오).
특히 수정된 레이아웃에서 단어를 다시 입력하는 작업은 두 부분으로 나뉩니다. "거기에 지정된 대로 레이아웃을 변경하세요" и “다시 입력”(“RetypeWord”).

나머지 매개변수는 "사전"에 기록됩니다. (golang의 "지도") 특정 작업에 대한 목록은 "작업"에 작성된 내용에 따라 달라집니다.

여러 가지 다른 작업을 하나의 힙으로 설명할 수 있습니다. (섹션). 아니면 당겨서 분리할 수도 있습니다. 위에서 보여드린 것처럼.

즉시 외부 스크립트를 실행하도록 "Exec" 작업을 설정했습니다. 기록된 버퍼를 stdin으로 푸시하는 옵션이 있습니다.

• "대기 = 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