నుండి ("ప్రూఫ్ ఆఫ్ కాన్సెప్ట్" దశలో xswitcher) చాలా నిర్మాణాత్మక అభిప్రాయాన్ని పొందింది (ఇది బాగుంది), నేను ప్రాజెక్ట్‌ను అభివృద్ధి చేయడానికి నా ఖాళీ సమయాన్ని వెచ్చించడం కొనసాగించాను. ఇప్పుడు నేను మీలో కొంచెం ఖర్చు చేయాలనుకుంటున్నాను ... రెండవ దశ చాలా సాధారణమైనది కాదు: కాన్ఫిగరేషన్ డిజైన్ యొక్క ప్రతిపాదన/చర్చ.
ఏదో ఒకవిధంగా సాధారణ ప్రోగ్రామర్లు ఈ నియంత్రణలన్నింటినీ సెటప్ చేయడం చాలా బోరింగ్ అని తేలింది.
నిరాధారంగా ఉండకుండా ఉండటానికి, లోపల నేను వ్యవహరిస్తున్న దానికి ఒక ఉదాహరణ.
మొత్తంమీద అద్భుతంగా రూపొందించబడింది (మరియు బాగా అమలు చేయబడింది) Apache Kafka & ZooKeeper.
- ఆకృతీకరణ? కానీ బోరింగ్! మూగ xml (ఎందుకంటే ఇది "అవుట్ ఆఫ్ ది బాక్స్").
- ఓహ్, మీకు కూడా ACL కావాలా? కానీ ఇది చాలా బోరింగ్! ట్యాప్-బ్లూపర్... అలాంటిదే.
కానీ నా పనిలో ఇది సరిగ్గా వ్యతిరేకం. కుడి (అయ్యో, దాదాపు ఎప్పుడూ మొదటిసారి) నిర్మించిన మోడల్ మిమ్మల్ని మరింత సులభంగా మరియు సహజంగా కొనసాగించడానికి అనుమతిస్తుంది (దాదాపు) రేఖాచిత్రాన్ని సమీకరించండి.
డేటా సైంటిస్టుల కృషి గురించి నేను ఇటీవల హబ్రేలో ఒక కథనాన్ని చూశాను...
ఈ క్షణం వారికి పూర్తిగా గ్రహించబడిందని తేలింది. మరియు నా ఆచరణలో, వారు చెప్పినట్లు, "లైట్ వెర్షన్". బహుళ-వాల్యూమ్ మోడల్‌లు, సిద్ధంగా ఉన్న OOPతో అనుభవజ్ఞులైన ప్రోగ్రామర్లు మొదలైనవి. — ఇది ఎప్పుడు/తీసినట్లయితే ఇవన్నీ తర్వాత కనిపిస్తాయి. కానీ డిజైనర్ ఇక్కడ మరియు ఇప్పుడు ఎక్కడా ప్రారంభించాలి.
పాయింట్ పొందండి. నేను వాక్యనిర్మాణ ప్రాతిపదికగా TOMLని తీసుకున్నాను .
ఎందుకంటే అతను (TOML) ఒక వైపు, మానవ-సవరించదగినది. మరోవైపు, ఇది 1:1 అత్యంత సాధారణ సింటాక్స్‌లలోకి అనువదించబడింది: XML, JSON, YAML.
అంతేకాకుండా, "github.com/BurntSushi/toml" నుండి నేను ఉపయోగించిన ఇంప్లిమెంటేషన్, అత్యంత ఫ్యాషనబుల్ (ఇప్పటికీ 1.4 సింటాక్స్) కానప్పటికీ, అదే ("అంతర్నిర్మిత") JSONతో వాక్యనిర్మాణంగా అనుకూలంగా ఉంటుంది.
అంటే, మీరు కోరుకుంటే, "మీ TOMLతో అడవుల్లోకి వెళ్లండి, నాకు XXX కావాలి" అని మరియు కేవలం ఒక లైన్‌తో కోడ్‌ను "ప్యాచ్ చేయండి" అని చెప్పవచ్చు.
అందువలన, మీరు xswitcherని కాన్ఫిగర్ చేయడానికి కొన్ని విండోలను వ్రాయాలనుకుంటే (నాకు ఖచ్చితంగా తెలియదు) "మీ యొక్క ఈ హేయమైన కాన్ఫిగరేషన్‌తో" ఎటువంటి సమస్యలు ఆశించబడవు.
మిగతా వారందరికీ, వాక్యనిర్మాణం “కీ = విలువ”పై ఆధారపడి ఉంటుంది (మరియు అక్షరాలా కొన్ని సంక్లిష్టమైన ఎంపికలు, = [కొన్ని, ఆ, శ్రేణి]) నేను ఊహిస్తున్నాను
అకారణంగా అనుకూలమైనది.
ఆసక్తికరమైన విషయం ఏమిటంటే దాదాపు అదే సమయంలో (సుమారు 2013). కేవలం, నాలా కాకుండా, TOML రచయిత సరైన స్థాయిలో ప్రవేశించారు.
అందువల్ల, ఇప్పుడు దాని అమలును నాకు సరిపోయేలా సర్దుబాటు చేయడం నాకు సులభం, మరియు దీనికి విరుద్ధంగా కాదు.
సాధారణంగా, మేము TOML తీసుకుంటాము (పాత Windows INIకి చాలా పోలి ఉంటుంది). మరియు మేము కీబోర్డ్ నుండి తాజా స్కాన్ కోడ్‌ల సెట్‌పై ఆధారపడి హుక్‌ల శ్రేణిని ఎలా అటాచ్ చేయాలో వివరించే కాన్ఫిగరేషన్‌ను కలిగి ఉన్నాము. క్రింద, ముక్క ముక్క, ఇప్పటివరకు ఏమి జరిగింది. మరియు నేను ఈ విధంగా ఎందుకు నిర్ణయించుకున్నాను అనేదానికి వివరణ.
0. ప్రాథమిక సంగ్రహణలు
- కోడ్ హోదాలను స్కాన్ చేయండి. దీని గురించి ఖచ్చితంగా ఏదైనా చేయవలసి ఉంది, ఎందుకంటే కేవలం డిజిటల్ కోడ్‌లు ఖచ్చితంగా మానవులకు చదవదగినవి కావు (అది నేను మాత్రమే ).
నేను "గోలాంగ్-ఎవ్దేవ్" నుండి "ecodes.go"ని షేక్ చేసాను (అసలు మూలాన్ని చూడటానికి నేను చాలా సోమరిగా ఉన్నాను, అయినప్పటికీ రచయిత దానిని సాంస్కృతికంగా సూచించాడు). నేను కొంచెం (ప్రస్తుతానికి) చాలా భయానకంగా ఉన్నదాన్ని సరిదిద్దాను. “LEFTBRACE” → “L_BRACE” లాగా. - అదనంగా, అతను "స్టేట్ కీలు" అనే భావనను ప్రవేశపెట్టాడు. ఉపయోగించిన సాధారణ వ్యాకరణం దీర్ఘ గద్యాలై అనుమతించదు కాబట్టి. (కానీ ఇది మినిమల్ ఓవర్‌హెడ్‌తో తనిఖీ చేయడానికి మిమ్మల్ని అనుమతిస్తుంది. మీరు “డైరెక్ట్” రికార్డింగ్‌ను మాత్రమే ఉపయోగిస్తే.)
- నొక్కిన దానిలో అంతర్నిర్మిత "డ్యూప్లికేటర్" ఉంటుంది. అందువలన, రాష్ట్రం "రిపీట్"=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)" ]
హుక్స్ రెండు రకాలుగా విభజించబడ్డాయి. అంతర్నిర్మిత, "మాట్లాడే" పేర్లతో (న్యూవర్డ్, న్యూ సెంటెన్స్, కంపోజ్) మరియు ప్రోగ్రామబుల్.
ప్రోగ్రామబుల్ పేర్లు "యాక్షన్"తో ప్రారంభమవుతాయి. ఎందుకంటే TOML v1.4, చుక్కలతో ఉన్న పేర్లు తప్పనిసరిగా కోట్‌లలో ఉండాలి.
ప్రతి విభాగాన్ని క్రింద వివరించాలి అదే పేరుతో.
"నగ్న" రెగ్యులర్‌లతో ప్రజల మనస్సులను చెదరగొట్టకుండా ఉండటానికి (అనుభవం నుండి, వారి రాయడానికిబహుశా పదిలో ఒకటి కావచ్చు నిపుణులు), నేను వెంటనే అదనపు వాక్యనిర్మాణాన్ని అమలు చేస్తాను.
- "ఆఫ్:" (లేదా "ఆన్:") regexp ముందు (రెగ్యులర్ ఎక్స్‌ప్రెషన్) కింది బటన్‌లను విడుదల చేయాలి (లేదా నొక్కాలి).
తదుపరి నేను "అన్యాయమైన" సాధారణ వ్యక్తీకరణ చేయబోతున్నాను. పైపుల మధ్య ముక్కలను విడిగా తనిఖీ చేయడంతో "|". "[LR]_SHIFT" (ఇది స్పష్టంగా అవసరం లేని చోట) వంటి రికార్డుల సంఖ్యను తగ్గించడానికి. - "SEQ:" మునుపటి షరతు నెరవేరినట్లయితే (లేదా హాజరుకాకపోతే), అప్పుడు మేము "సాధారణ" సాధారణ వ్యక్తీకరణకు వ్యతిరేకంగా తనిఖీ చేస్తాము. వివరాల కోసం, నేను వెంటనే ^W "regexp" లైబ్రరీకి పంపుతాను. ఎందుకంటే నాకు ఇష్టమైన pcre (“perl compatible”)తో అనుకూలత స్థాయిని తెలుసుకోవడానికి నేను ఇంకా బాధపడలేదు.
- వ్యక్తీకరణ రూపంలో వ్రాయబడింది "BUTTON_1: CODE1, BUTTON_2: CODE2" మొదలైనవి, స్కాన్ కోడ్‌లను స్వీకరించే క్రమంలో.
- చెక్ ఎల్లప్పుడూ సీక్వెన్స్ చివరి వరకు "స్నగ్డ్" అవుతుంది, కాబట్టి తోకకు "$" జోడించాల్సిన అవసరం లేదు.
- ఒక లైన్‌లోని అన్ని తనిఖీలు ఒకదాని తర్వాత ఒకటి నిర్వహించబడతాయి మరియు "I" ద్వారా కలుపుతారు. కానీ విలువ శ్రేణిగా వివరించబడినందున, మీరు కామా తర్వాత ప్రత్యామ్నాయ తనిఖీని వ్రాయవచ్చు. ఇది కొన్ని కారణాల వల్ల అవసరమైతే.
- విలువ "సీక్లెంగ్త్ = 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”).
మిగిలిన పారామితులు "నిఘంటువు"కి వ్రాయబడ్డాయి (గోలాంగ్‌లో "మ్యాప్") ఇచ్చిన చర్య కోసం, వారి జాబితా "యాక్షన్"లో వ్రాయబడినదానిపై ఆధారపడి ఉంటుంది.
అనేక విభిన్న చర్యలను ఒక కుప్పలో వివరించవచ్చు (విభాగాలు). లేదా మీరు దానిని విడదీయవచ్చు. నేను పైన చూపించినట్లు.
బాహ్య స్క్రిప్ట్‌ని అమలు చేయడానికి నేను వెంటనే "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.
నేను ఎక్కడ మర్చిపోయాను/తప్పు చేశాను? (ఇది లేకుండా మార్గం లేదు), నేను నిజంగా శ్రద్ధగల పాఠకులు వారి ముక్కులు దూర్చు చాలా సోమరి కాదు ఆశిస్తున్నాము.
గుడ్ లక్!
మూలం: www.habr.com