Linux සඳහා Xswitcher පිරිසැලසුම් නිවැරදි කරන්නා: දෙවන පියවර

සිට පෙර ප්රකාශනය ("සංකල්පයේ සාධනය" අදියරේ xswitcher) බොහෝ නිර්මාණාත්මක ප්‍රතිපෝෂණ ලැබිණි (හොඳයි), මම ව්‍යාපෘතිය සංවර්ධනය කිරීම සඳහා මගේ නිදහස් කාලය දිගටම ගත කළෙමි. දැන් මට ඔයාගෙන් ටිකක් වියදම් කරන්න ඕන... දෙවන පියවර සාමාන්‍ය දෙයක් නොවේ: වින්‍යාස නිර්මාණය පිළිබඳ යෝජනාව/සාකච්ඡාව.

කෙසේ හෝ සාමාන්‍ය ක්‍රමලේඛකයින්ට මෙම සියලු පාලනයන් සැකසීම ඇදහිය නොහැකි තරම් නීරස බව පෙනේ.

පදනම් විරහිත නොවීමට, ඇතුළත මා කටයුතු කරන දෙයට උදාහරණයක්.
සමස්තයක් ලෙස විශිෂ්ට ලෙස පිළිසිඳගත් (සහ හොඳින් ක්‍රියාත්මක කරන ලද) Apache Kafka සහ ZooKeeper.
- වින්‍යාසය? නමුත් එය කම්මැලියි! ගොළු xml (එය "කොටුවෙන් පිටත" නිසා).
- ඔහ්, ඔබටත් ACL අවශ්යද? නමුත් එය ඉතා කම්මැලියි! Tap-blooper... ඒ වගේ දෙයක්.

නමුත් මගේ කාර්යයේදී එය හරියටම ප්රතිවිරුද්ධයයි. හරි (අහෝ, පළමු වතාවට කිසිදාක පාහේ) ඉදිකරන ලද ආකෘතිය ඔබට තවදුරටත් පහසුවෙන් සහ ස්වභාවිකව ඉදිරියට යාමට ඉඩ සලසයි (පාහේ) රූප සටහනක් එකලස් කරන්න.

දත්ත විද්‍යාඥයින්ගේ වෙහෙස මහන්සි වී වැඩ කිරීම ගැන හබ්‍රේ හි ලිපියක් මට මෑතකදී හමු විය.
මෙම මොහොත ඔවුන් සඳහා සම්පූර්ණයෙන්ම අවබෝධ වී ඇති බව පෙනේ. මගේ භාවිතයේ දී, ඔවුන් පවසන පරිදි, "සැහැල්ලු අනුවාදය". බහු-පරිමා ආකෘති, OOP සූදානම්ව ඇති පළපුරුදු ක්‍රමලේඛකයින් යනාදිය. - මේ සියල්ල පසුව දිස්වනු ඇත, එය ඉවත් වූ විට / නම්. නමුත් නිර්මාණකරුවා මෙතැනින් සහ දැන් කොතැනක හෝ ආරම්භ කළ යුතුය.

කාරණයට එන්න. මම වාක්‍ය පදනමක් ලෙස TOML ගත්තා මෙම පුරවැසියාගෙන්.

ඔහු නිසා (TOML) එක් අතකින් මිනිසා විසින් සංස්කරණය කළ හැකි ය. අනෙක් අතට, එය 1:1 වඩාත් පොදු වාක්‍ය ඛණ්ඩවලට පරිවර්තනය කර ඇත: XML, JSON, YAML.
එපමනක් නොව, "github.com/BurntSushi/toml" වෙතින් මා භාවිතා කළ ක්‍රියාත්මක කිරීම, වඩාත්ම විලාසිතාමය (තවමත් 1.4 වාක්‍ය ඛණ්ඩය) නොවුනත්, එම ("බිල්ට්-ඉන්") JSON සමඟ වාක්‍යානුකූලව අනුකූල වේ.

එනම්, ඔබට අවශ්‍ය නම්, ඔබට සරලව “ඔබේ එම TOML සමඟ වනාන්තරය හරහා යන්න, මට XXX අවශ්‍යයි” සහ එක් පේළියකින් කේතය “පැච්” කරන්න.

මේ අනුව, ඔබට xswitcher වින්‍යාස කිරීමට කවුළු කිහිපයක් ලිවීමට අවශ්‍ය නම් (මට විශ්වාස නැහැ) "ඔබේ මෙම අමන වින්‍යාසය සමඟ" කිසිදු ගැටළුවක් අපේක්ෂා නොකෙරේ.

අනෙක් සියල්ල සඳහා, වාක්‍ය ඛණ්ඩය "යතුර = අගය" මත පදනම් වේ. (සහ වචනාර්ථයෙන් වඩාත් සංකීර්ණ විකල්ප කිහිපයක්, වැනි = [සමහර, ඒ, අරාව]) මම අනුමාන කරනවා
intuitively පහසුයි.
සිත්ගන්නා කරුණ නම් එයයි "දැවෙන" එම කාලයේදීම (2013 දී පමණ). මම මෙන් නොව, TOML හි කතුවරයා නිසි පරිමාණයෙන් ඇතුළු විය.

එමනිසා, එය ක්‍රියාත්මක කිරීම මට ගැලපෙන පරිදි සකස් කිරීම දැන් මට පහසු ය, අනෙක් අතට නොවේ.

පොදුවේ, අපි TOML (පැරණි Windows INI වලට බෙහෙවින් සමාන) ගනිමු. යතුරුපුවරුවේ නවතම ස්කෑන් කේත කට්ටලය අනුව කොකු මාලාවක් අමුණන ආකාරය විස්තර කරන වින්‍යාසයක් අප සතුව ඇත. කෑල්ලෙන් කෑල්ල පහලින් තියෙන්නේ මෙච්චර කල් වෙච්ච දේ. සහ මම මේ ආකාරයෙන් තීරණය කළේ ඇයිද යන්න පැහැදිලි කිරීමක්.

0 මූලික වියුක්ත කිරීම්

• කේත තනතුරු පරිලෝකනය කරන්න. සරලව ඩිජිටල් කේත මිනිසුන්ට කියවිය නොහැකි බැවින් (ඒ මම පමණි) මේ ගැන යමක් අනිවාර්යයෙන්ම කළ යුතුය loloswitcher).
  මම "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 කේතයට "විස්මයන්" අල්ලා ගත්තා).
ඇතුළත මම විස්තර කළේ "කුමක් කළ යුතුද" යන ශ්‍රිතවලට සබැඳි සමඟ අරාව පිරවීමයි. ගොලන්ග්හි මෙය වේ (හදිසියේ) එය පහසු සහ පැහැදිලි විය.

• මෙම ස්ථානයේ "Drop" අවම කිරීමට මම සැලසුම් කරමි. වඩාත් නම්‍යශීලී සැකසුම් වලට පක්ෂව (මම එය පහතින් පෙන්වන්නම්).

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) සහ ක්‍රමලේඛගත කළ හැකි, ගොඩනගා ඇත.

වැඩසටහන්ගත කළ හැකි නම් ආරම්භ වන්නේ "ක්‍රියාව" යන්නෙනි. නිසා TOML v1.4, තිත් සහිත නම් උද්ධෘතවල තිබිය යුතුය.

එක් එක් කොටස පහත විස්තර කළ යුතුය එකම නමින්.

"නිරුවත්" නිතිපතා (අත්දැකීම් අනුව, ඔවුන්ගේ ලිවීමටසමහර විට දහයෙන් එකක් වෘත්තිකයන්), මම වහාම අතිරේක වාක්‍ය ඛණ්ඩ ක්‍රියාත්මක කරමි.

• "අක්‍රිය:" (හෝ "සක්‍රිය:") regexp (සාමාන්‍ය ප්‍රකාශනය) ට පෙර පහත බොත්තම් මුදා හැරීම (හෝ එබීම) අවශ්‍ය වේ.
  ඊළඟට මම "අසාධාරණ" නිතිපතා ප්රකාශනයක් කරන්නෙමි. "|" පයිප්ප අතර කැබලි වෙනම පරීක්ෂා කිරීමත් සමඟ. "[LR]_SHIFT" වැනි වාර්තා ගණන අඩු කිරීම සඳහා (මෙය පැහැදිලිවම අවශ්‍ය නොවේ).
• "SEQ:" පෙර කොන්දේසිය සපුරා ඇත්නම් (හෝ නොමැති), එවිට අපි "සාමාන්‍ය" නිත්‍ය ප්‍රකාශනයකට එරෙහිව පරීක්ෂා කරන්නෙමු. විස්තර සඳහා, මම වහාම "regexp" පුස්තකාලය වෙත ^W යවන්නෙමි. මගේ ප්‍රියතම pcre (“perl compatible”) සමඟ ගැළපෙන තරම සොයා ගැනීමට මම තවමත් වෙහෙස වී නැති නිසා.
• ප්රකාශනය ස්වරූපයෙන් ලියා ඇත "BUTTON_1: CODE1, BUTTON_2: CODE2" ආදිය, ස්කෑන් කේතයන් ලැබෙන අනුපිළිවෙල අනුව.
• චෙක්පත සෑම විටම අනුපිළිවෙලෙහි අවසානය දක්වා "snugged" වේ, එබැවින් වලිගයට "$" එකතු කිරීම අවශ්ය නොවේ.
• එක් පේළියක ඇති සියලුම චෙක්පත් එකින් එක සිදු කරනු ලැබේ සහ "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" ලියන්න සහ ඒ සඳහා තවත් කොටසක් ලිවීමට කම්මැලි නොවන්න).
විශේෂයෙන්, නිවැරදි කළ පිරිසැලසුමෙහි වචනයක් නැවත ටයිප් කිරීම කොටස් දෙකකට බෙදා ඇත: "එහි දක්වා ඇති පරිදි පිරිසැලසුම වෙනස් කරන්න" и "retype" ("RetypeWord").

ඉතිරි පරාමිතීන් "ශබ්දකෝෂය" වෙත ලියා ඇත. ("සිතියම" golang වලින්) දී ඇති ක්‍රියාවක් සඳහා, ඔවුන්ගේ ලැයිස්තුව "ක්‍රියාව" හි ලියා ඇති දේ මත රඳා පවතී.

එක ගොඩක විවිධ ක්‍රියා කිහිපයක් විස්තර කළ හැක (කොටස්). නැතහොත් ඔබට එය කඩා දැමිය හැකිය. මම ඉහත පෙන්වා දුන් පරිදි.

මම වහාම බාහිර ස්ක්‍රිප්ට් ක්‍රියාත්මක කිරීමට "Exec" ක්‍රියාව සකස් කළෙමි. පටිගත කළ බෆරය stdin වෙතට තල්ලු කිරීමේ විකල්පය සමඟ.

• "රැඳී සිටින්න = 1" - ධාවන ක්රියාවලිය සම්පූර්ණ වන තෙක් රැඳී සිටින්න.
• බොහෝ විට, "ගොඩට" ඔබට අතිරේක පුද්ගලයින් පරිසරයට දැමීමට අවශ්ය වනු ඇත. එය බාධා කළ කවුළු පන්තියේ නම වැනි තොරතුරු.
  “ඔබට ඔබේ හසුරුවන්නා සම්බන්ධ කිරීමට අවශ්‍යද? ඔබ යා යුතු ස්ථානය මෙයයි. ”

Phew (හුස්ම පිට කරයි). මට කිසිවක් අමතක වී නැති බව පෙනේ.

අපොයි! ඔව්, මට අමතක වුණේ නැහැ ...
දියත් කිරීමේ වින්‍යාසය කොහිද? දෘඪ කේතයේ ද? ඒ වගේ:

[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.

මට අමතක වුණේ/වැරැද්දක් වුණේ කොහෙද? (මෙය නොමැතිව මගක් නැත), අවධානයෙන් සිටින පාඨකයින් නහය විදින්නට කම්මැලි නොවනු ඇතැයි මම සැබවින්ම බලාපොරොත්තු වෙමි.

සුබ පැතුම්!

මූලාශ්රය: www.habr.com