← Back to branch summary

~stephen-j-boddy/terminator/bugfix-1318542-double-chars

« back to all changes in this revision

Viewing changes to doc/apidoc/_build/html/_modules/terminatorlib/keybindings.html

  • Committer: Stephen Boddy
  • Date: 2015-08-08 02:11:30 UTC
  • Revision ID: stephen.j.boddy@gmail.com-20150808021130-9c1npu4gvenkcb1p
A manual has been added to Terminator
* Added source and generated html of manual, and API doc
* setup.py can install the manual (and by extension do can debuild)
* setup.py has (inactive) code for generating the html from the source
  but this will break if rtd theme is not available
* A few changes to doc strings to make the autodoc prettier
* Added help shortcut, by default F1 to open the local manual
* Added button to About tab to launch manual
* A couple of additional string to translate related to manual/help

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/apidoc/_build/html/_modules/terminatorlib/keybindings.html
 
1
 
 
2
 
 
3
<!DOCTYPE html>
 
4
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 
5
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 
6
<head>
 
7
  <meta charset="utf-8">
 
8
  
 
9
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
 
10
  
 
11
  <title>terminatorlib.keybindings &mdash; terminatorlib 0.98 documentation</title>
 
12
  
 
13
 
 
14
  
 
15
  
 
16
 
 
17
  
 
18
 
 
19
  
 
20
  
 
21
    
 
22
 
 
23
  
 
24
 
 
25
  
 
26
  
 
27
    <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
 
28
  
 
29
 
 
30
  
 
31
 
 
32
  
 
33
    <link rel="top" title="terminatorlib 0.98 documentation" href="../../index.html"/>
 
34
        <link rel="up" title="Module code" href="../index.html"/> 
 
35
 
 
36
  
 
37
  <script src="_static/js/modernizr.min.js"></script>
 
38
 
 
39
</head>
 
40
 
 
41
<body class="wy-body-for-nav" role="document">
 
42
 
 
43
  <div class="wy-grid-for-nav">
 
44
 
 
45
    
 
46
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 
47
      <div class="wy-side-nav-search">
 
48
        
 
49
 
 
50
        
 
51
          <a href="../../index.html" class="icon icon-home"> terminatorlib
 
52
        
 
53
 
 
54
        
 
55
        </a>
 
56
 
 
57
        
 
58
<div role="search">
 
59
  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
 
60
    <input type="text" name="q" placeholder="Search docs" />
 
61
    <input type="hidden" name="check_keywords" value="yes" />
 
62
    <input type="hidden" name="area" value="default" />
 
63
  </form>
 
64
</div>
 
65
 
 
66
        
 
67
      </div>
 
68
 
 
69
      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
 
70
        
 
71
          
 
72
          
 
73
              <ul>
 
74
<li class="toctree-l1"><a class="reference internal" href="../../terminatorlib.html">terminatorlib package</a><ul>
 
75
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#subpackages">Subpackages</a><ul>
 
76
<li class="toctree-l3"><a class="reference internal" href="../../terminatorlib.configobj.html">terminatorlib.configobj package</a><ul>
 
77
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.configobj.html#submodules">Submodules</a></li>
 
78
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.configobj.html#module-terminatorlib.configobj.configobj">terminatorlib.configobj.configobj module</a></li>
 
79
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.configobj.html#module-terminatorlib.configobj.validate">terminatorlib.configobj.validate module</a></li>
 
80
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.configobj.html#module-terminatorlib.configobj">Module contents</a></li>
 
81
</ul>
 
82
</li>
 
83
<li class="toctree-l3"><a class="reference internal" href="../../terminatorlib.plugins.html">terminatorlib.plugins package</a><ul>
 
84
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.plugins.html#submodules">Submodules</a></li>
 
85
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.plugins.html#module-terminatorlib.plugins.activitywatch">terminatorlib.plugins.activitywatch module</a></li>
 
86
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.plugins.html#module-terminatorlib.plugins.custom_commands">terminatorlib.plugins.custom_commands module</a></li>
 
87
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.plugins.html#module-terminatorlib.plugins.logger">terminatorlib.plugins.logger module</a></li>
 
88
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.plugins.html#module-terminatorlib.plugins.maven">terminatorlib.plugins.maven module</a></li>
 
89
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.plugins.html#module-terminatorlib.plugins.terminalshot">terminatorlib.plugins.terminalshot module</a></li>
 
90
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.plugins.html#module-terminatorlib.plugins.testplugin">terminatorlib.plugins.testplugin module</a></li>
 
91
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.plugins.html#module-terminatorlib.plugins.url_handlers">terminatorlib.plugins.url_handlers module</a></li>
 
92
<li class="toctree-l4"><a class="reference internal" href="../../terminatorlib.plugins.html#module-terminatorlib.plugins">Module contents</a></li>
 
93
</ul>
 
94
</li>
 
95
</ul>
 
96
</li>
 
97
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#submodules">Submodules</a></li>
 
98
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.borg">terminatorlib.borg module</a></li>
 
99
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.config">terminatorlib.config module</a></li>
 
100
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.container">terminatorlib.container module</a></li>
 
101
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.cwd">terminatorlib.cwd module</a></li>
 
102
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.debugserver">terminatorlib.debugserver module</a></li>
 
103
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.editablelabel">terminatorlib.editablelabel module</a></li>
 
104
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.encoding">terminatorlib.encoding module</a></li>
 
105
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.factory">terminatorlib.factory module</a></li>
 
106
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.freebsd">terminatorlib.freebsd module</a></li>
 
107
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.ipc">terminatorlib.ipc module</a></li>
 
108
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.keybindings">terminatorlib.keybindings module</a></li>
 
109
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.layoutlauncher">terminatorlib.layoutlauncher module</a></li>
 
110
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.notebook">terminatorlib.notebook module</a></li>
 
111
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.optionparse">terminatorlib.optionparse module</a></li>
 
112
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.paned">terminatorlib.paned module</a></li>
 
113
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.plugin">terminatorlib.plugin module</a></li>
 
114
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.prefseditor">terminatorlib.prefseditor module</a></li>
 
115
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.searchbar">terminatorlib.searchbar module</a></li>
 
116
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.signalman">terminatorlib.signalman module</a></li>
 
117
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.terminal">terminatorlib.terminal module</a></li>
 
118
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.terminal_popup_menu">terminatorlib.terminal_popup_menu module</a></li>
 
119
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.terminator">terminatorlib.terminator module</a></li>
 
120
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.titlebar">terminatorlib.titlebar module</a></li>
 
121
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.translation">terminatorlib.translation module</a></li>
 
122
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.util">terminatorlib.util module</a></li>
 
123
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.version">terminatorlib.version module</a></li>
 
124
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib.window">terminatorlib.window module</a></li>
 
125
<li class="toctree-l2"><a class="reference internal" href="../../terminatorlib.html#module-terminatorlib">Module contents</a></li>
 
126
</ul>
 
127
</li>
 
128
</ul>
 
129
 
 
130
          
 
131
        
 
132
      </div>
 
133
      &nbsp;
 
134
    </nav>
 
135
 
 
136
    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
 
137
 
 
138
      
 
139
      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
 
140
        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
 
141
        <a href="../../index.html">terminatorlib</a>
 
142
      </nav>
 
143
 
 
144
 
 
145
      
 
146
      <div class="wy-nav-content">
 
147
        <div class="rst-content">
 
148
          <div role="navigation" aria-label="breadcrumbs navigation">
 
149
  <ul class="wy-breadcrumbs">
 
150
    <li><a href="../../index.html">Docs</a> &raquo;</li>
 
151
      
 
152
          <li><a href="../index.html">Module code</a> &raquo;</li>
 
153
      
 
154
    <li>terminatorlib.keybindings</li>
 
155
      <li class="wy-breadcrumbs-aside">
 
156
        
 
157
          
 
158
        
 
159
      </li>
 
160
  </ul>
 
161
  <hr/>
 
162
</div>
 
163
          <div role="main" class="document">
 
164
            
 
165
  <h1>Source code for terminatorlib.keybindings</h1><div class="highlight"><pre>
 
166
<span class="c">#!/usr/bin/python</span>
 
167
<span class="c">#  Terminator - multiple gnome terminals in one window</span>
 
168
<span class="c">#   Copyright (C) 2006-2010  cmsj@tenshu.net</span>
 
169
<span class="c">#</span>
 
170
<span class="c"># This program is free software; you can redistribute it and/or modify</span>
 
171
<span class="c"># it under the terms of the GNU General Public License as published by</span>
 
172
<span class="c"># the Free Software Foundation, version 2 only.</span>
 
173
<span class="c">#</span>
 
174
<span class="c"># This program is distributed in the hope that it will be useful,</span>
 
175
<span class="c"># but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
 
176
<span class="c"># MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the</span>
 
177
<span class="c"># GNU General Public License for more details.</span>
 
178
<span class="c">#</span>
 
179
<span class="c"># You should have received a copy of the GNU General Public License</span>
 
180
<span class="c"># along with this program; if not, write to the Free Software</span>
 
181
<span class="c"># Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA</span>
 
182
 
 
183
<span class="sd">&quot;&quot;&quot;Terminator by Chris Jones &lt;cmsj@tenshu.net&gt;</span>
 
184
 
 
185
<span class="sd">Validator and functions for dealing with Terminator&#39;s customisable </span>
 
186
<span class="sd">keyboard shortcuts.</span>
 
187
 
 
188
<span class="sd">&quot;&quot;&quot;</span>
 
189
 
 
190
<span class="kn">import</span> <span class="nn">re</span>
 
191
<span class="kn">import</span> <span class="nn">gtk</span>
 
192
<span class="kn">from</span> <span class="nn">util</span> <span class="kn">import</span> <span class="n">err</span>
 
193
 
 
194
<div class="viewcode-block" id="KeymapError"><a class="viewcode-back" href="../../terminatorlib.html#terminatorlib.keybindings.KeymapError">[docs]</a><span class="k">class</span> <span class="nc">KeymapError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
 
195
    <span class="sd">&quot;&quot;&quot;Custom exception for errors in keybinding configurations&quot;&quot;&quot;</span>
 
196
</div>
 
197
<span class="n">MODIFIER</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">compile</span><span class="p">(</span><span class="s">&#39;&lt;([^&lt;]+)&gt;&#39;</span><span class="p">)</span>
 
198
<div class="viewcode-block" id="Keybindings"><a class="viewcode-back" href="../../terminatorlib.html#terminatorlib.keybindings.Keybindings">[docs]</a><span class="k">class</span> <span class="nc">Keybindings</span><span class="p">:</span>
 
199
    <span class="sd">&quot;&quot;&quot;Class to handle loading and lookup of Terminator keybindings&quot;&quot;&quot;</span>
 
200
 
 
201
    <span class="n">modifiers</span> <span class="o">=</span> <span class="p">{</span>
 
202
        <span class="s">&#39;ctrl&#39;</span><span class="p">:</span>     <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">CONTROL_MASK</span><span class="p">,</span>
 
203
        <span class="s">&#39;control&#39;</span><span class="p">:</span>  <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">CONTROL_MASK</span><span class="p">,</span>
 
204
        <span class="s">&#39;primary&#39;</span><span class="p">:</span>  <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">CONTROL_MASK</span><span class="p">,</span>
 
205
        <span class="s">&#39;shift&#39;</span><span class="p">:</span>    <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">SHIFT_MASK</span><span class="p">,</span>
 
206
        <span class="s">&#39;alt&#39;</span><span class="p">:</span>      <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">MOD1_MASK</span><span class="p">,</span>
 
207
        <span class="s">&#39;super&#39;</span><span class="p">:</span>    <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">SUPER_MASK</span><span class="p">,</span>
 
208
    <span class="p">}</span>
 
209
 
 
210
    <span class="n">empty</span> <span class="o">=</span> <span class="p">{}</span>
 
211
    <span class="n">keys</span> <span class="o">=</span> <span class="bp">None</span>
 
212
    <span class="n">_masks</span> <span class="o">=</span> <span class="bp">None</span>
 
213
    <span class="n">_lookup</span> <span class="o">=</span> <span class="bp">None</span>
 
214
 
 
215
<div class="viewcode-block" id="Keybindings.__init__"><a class="viewcode-back" href="../../terminatorlib.html#terminatorlib.keybindings.Keybindings.__init__">[docs]</a>    <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
216
        <span class="bp">self</span><span class="o">.</span><span class="n">keymap</span> <span class="o">=</span> <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">keymap_get_default</span><span class="p">()</span>
 
217
        <span class="bp">self</span><span class="o">.</span><span class="n">configure</span><span class="p">({})</span>
 
218
</div>
 
219
<div class="viewcode-block" id="Keybindings.configure"><a class="viewcode-back" href="../../terminatorlib.html#terminatorlib.keybindings.Keybindings.configure">[docs]</a>    <span class="k">def</span> <span class="nf">configure</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">bindings</span><span class="p">):</span>
 
220
        <span class="sd">&quot;&quot;&quot;Accept new bindings and reconfigure with them&quot;&quot;&quot;</span>
 
221
        <span class="bp">self</span><span class="o">.</span><span class="n">keys</span> <span class="o">=</span> <span class="n">bindings</span>
 
222
        <span class="bp">self</span><span class="o">.</span><span class="n">reload</span><span class="p">()</span>
 
223
</div>
 
224
<div class="viewcode-block" id="Keybindings.reload"><a class="viewcode-back" href="../../terminatorlib.html#terminatorlib.keybindings.Keybindings.reload">[docs]</a>    <span class="k">def</span> <span class="nf">reload</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 
225
        <span class="sd">&quot;&quot;&quot;Parse bindings and mangle into an appropriate form&quot;&quot;&quot;</span>
 
226
        <span class="bp">self</span><span class="o">.</span><span class="n">_lookup</span> <span class="o">=</span> <span class="p">{}</span>
 
227
        <span class="bp">self</span><span class="o">.</span><span class="n">_masks</span> <span class="o">=</span> <span class="mi">0</span>
 
228
        <span class="k">for</span> <span class="n">action</span><span class="p">,</span> <span class="n">bindings</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">keys</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
 
229
            <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">bindings</span><span class="p">,</span> <span class="nb">tuple</span><span class="p">):</span>
 
230
                <span class="n">bindings</span> <span class="o">=</span> <span class="p">(</span><span class="n">bindings</span><span class="p">,)</span>
 
231
 
 
232
            <span class="k">for</span> <span class="n">binding</span> <span class="ow">in</span> <span class="n">bindings</span><span class="p">:</span>
 
233
                <span class="k">if</span> <span class="ow">not</span> <span class="n">binding</span> <span class="ow">or</span> <span class="n">binding</span> <span class="o">==</span> <span class="s">&quot;None&quot;</span><span class="p">:</span>
 
234
                    <span class="k">continue</span>
 
235
 
 
236
                <span class="k">try</span><span class="p">:</span>
 
237
                    <span class="n">keyval</span><span class="p">,</span> <span class="n">mask</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parsebinding</span><span class="p">(</span><span class="n">binding</span><span class="p">)</span>
 
238
                    <span class="c"># Does much the same, but with poorer error handling.</span>
 
239
                    <span class="c">#keyval, mask = gtk.accelerator_parse(binding)</span>
 
240
                <span class="k">except</span> <span class="n">KeymapError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
 
241
                  <span class="n">err</span> <span class="p">(</span><span class="s">&quot;keybindings.reload failed to parse binding &#39;</span><span class="si">%s</span><span class="s">&#39;: </span><span class="si">%s</span><span class="s">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">binding</span><span class="p">,</span> <span class="n">e</span><span class="p">))</span>
 
242
                <span class="k">else</span><span class="p">:</span>
 
243
                    <span class="k">if</span> <span class="n">mask</span> <span class="o">&amp;</span> <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">SHIFT_MASK</span><span class="p">:</span>
 
244
                        <span class="k">if</span> <span class="n">keyval</span> <span class="o">==</span> <span class="n">gtk</span><span class="o">.</span><span class="n">keysyms</span><span class="o">.</span><span class="n">Tab</span><span class="p">:</span>
 
245
                            <span class="n">keyval</span> <span class="o">=</span> <span class="n">gtk</span><span class="o">.</span><span class="n">keysyms</span><span class="o">.</span><span class="n">ISO_Left_Tab</span>
 
246
                            <span class="n">mask</span> <span class="o">&amp;=</span> <span class="o">~</span><span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">SHIFT_MASK</span>
 
247
                        <span class="k">else</span><span class="p">:</span>
 
248
                            <span class="n">keyvals</span> <span class="o">=</span> <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">keyval_convert_case</span><span class="p">(</span><span class="n">keyval</span><span class="p">)</span>
 
249
                            <span class="k">if</span> <span class="n">keyvals</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">!=</span> <span class="n">keyvals</span><span class="p">[</span><span class="mi">1</span><span class="p">]:</span>
 
250
                                <span class="n">keyval</span> <span class="o">=</span> <span class="n">keyvals</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
 
251
                                <span class="n">mask</span> <span class="o">&amp;=</span> <span class="o">~</span><span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">SHIFT_MASK</span>
 
252
                    <span class="k">else</span><span class="p">:</span>
 
253
                        <span class="n">keyval</span> <span class="o">=</span> <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">keyval_to_lower</span><span class="p">(</span><span class="n">keyval</span><span class="p">)</span>
 
254
                    <span class="bp">self</span><span class="o">.</span><span class="n">_lookup</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">mask</span><span class="p">,</span> <span class="p">{})</span>
 
255
                    <span class="bp">self</span><span class="o">.</span><span class="n">_lookup</span><span class="p">[</span><span class="n">mask</span><span class="p">][</span><span class="n">keyval</span><span class="p">]</span> <span class="o">=</span> <span class="n">action</span>
 
256
                    <span class="bp">self</span><span class="o">.</span><span class="n">_masks</span> <span class="o">|=</span> <span class="n">mask</span>
 
257
</div>
 
258
<div class="viewcode-block" id="Keybindings._parsebinding"><a class="viewcode-back" href="../../terminatorlib.html#terminatorlib.keybindings.Keybindings._parsebinding">[docs]</a>    <span class="k">def</span> <span class="nf">_parsebinding</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">binding</span><span class="p">):</span>
 
259
        <span class="sd">&quot;&quot;&quot;Parse an individual binding using gtk&#39;s binding function&quot;&quot;&quot;</span>
 
260
        <span class="n">mask</span> <span class="o">=</span> <span class="mi">0</span>
 
261
        <span class="n">modifiers</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">findall</span><span class="p">(</span><span class="n">MODIFIER</span><span class="p">,</span> <span class="n">binding</span><span class="p">)</span>
 
262
        <span class="k">if</span> <span class="n">modifiers</span><span class="p">:</span>
 
263
            <span class="k">for</span> <span class="n">modifier</span> <span class="ow">in</span> <span class="n">modifiers</span><span class="p">:</span>
 
264
                <span class="n">mask</span> <span class="o">|=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_lookup_modifier</span><span class="p">(</span><span class="n">modifier</span><span class="p">)</span>
 
265
        <span class="n">key</span> <span class="o">=</span> <span class="n">re</span><span class="o">.</span><span class="n">sub</span><span class="p">(</span><span class="n">MODIFIER</span><span class="p">,</span> <span class="s">&#39;&#39;</span><span class="p">,</span> <span class="n">binding</span><span class="p">)</span>
 
266
        <span class="k">if</span> <span class="n">key</span> <span class="o">==</span> <span class="s">&#39;&#39;</span><span class="p">:</span>
 
267
            <span class="k">raise</span> <span class="n">KeymapError</span><span class="p">(</span><span class="s">&#39;No key found&#39;</span><span class="p">)</span>
 
268
        <span class="n">keyval</span> <span class="o">=</span> <span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">keyval_from_name</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
 
269
        <span class="k">if</span> <span class="n">keyval</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
 
270
            <span class="k">raise</span> <span class="n">KeymapError</span><span class="p">(</span><span class="s">&quot;Key &#39;</span><span class="si">%s</span><span class="s">&#39; is unrecognised&quot;</span> <span class="o">%</span> <span class="n">key</span><span class="p">)</span>
 
271
        <span class="k">return</span> <span class="p">(</span><span class="n">keyval</span><span class="p">,</span> <span class="n">mask</span><span class="p">)</span>
 
272
</div>
 
273
<div class="viewcode-block" id="Keybindings._lookup_modifier"><a class="viewcode-back" href="../../terminatorlib.html#terminatorlib.keybindings.Keybindings._lookup_modifier">[docs]</a>    <span class="k">def</span> <span class="nf">_lookup_modifier</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">modifier</span><span class="p">):</span>
 
274
        <span class="sd">&quot;&quot;&quot;Map modifier names to gtk values&quot;&quot;&quot;</span>
 
275
        <span class="k">try</span><span class="p">:</span>
 
276
            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">modifiers</span><span class="p">[</span><span class="n">modifier</span><span class="o">.</span><span class="n">lower</span><span class="p">()]</span>
 
277
        <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
 
278
            <span class="k">raise</span> <span class="n">KeymapError</span><span class="p">(</span><span class="s">&quot;Unhandled modifier &#39;&lt;</span><span class="si">%s</span><span class="s">&gt;&#39;&quot;</span> <span class="o">%</span> <span class="n">modifier</span><span class="p">)</span>
 
279
</div>
 
280
<div class="viewcode-block" id="Keybindings.lookup"><a class="viewcode-back" href="../../terminatorlib.html#terminatorlib.keybindings.Keybindings.lookup">[docs]</a>    <span class="k">def</span> <span class="nf">lookup</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
 
281
        <span class="sd">&quot;&quot;&quot;Translate a keyboard event into a mapped key&quot;&quot;&quot;</span>
 
282
        <span class="k">try</span><span class="p">:</span>
 
283
            <span class="n">keyval</span><span class="p">,</span> <span class="n">_egp</span><span class="p">,</span> <span class="n">_lvl</span><span class="p">,</span> <span class="n">consumed</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">keymap</span><span class="o">.</span><span class="n">translate_keyboard_state</span><span class="p">(</span>
 
284
                                              <span class="n">event</span><span class="o">.</span><span class="n">hardware_keycode</span><span class="p">,</span> 
 
285
                                              <span class="n">event</span><span class="o">.</span><span class="n">state</span> <span class="o">&amp;</span> <span class="o">~</span><span class="n">gtk</span><span class="o">.</span><span class="n">gdk</span><span class="o">.</span><span class="n">LOCK_MASK</span><span class="p">,</span> 
 
286
                                              <span class="n">event</span><span class="o">.</span><span class="n">group</span><span class="p">)</span>
 
287
        <span class="k">except</span> <span class="ne">TypeError</span><span class="p">:</span>
 
288
            <span class="n">err</span> <span class="p">(</span><span class="s">&quot;keybindings.lookup failed to translate keyboard event: </span><span class="si">%s</span><span class="s">&quot;</span> <span class="o">%</span> 
 
289
                     <span class="nb">dir</span><span class="p">(</span><span class="n">event</span><span class="p">))</span>
 
290
            <span class="k">return</span> <span class="bp">None</span>
 
291
        <span class="n">mask</span> <span class="o">=</span> <span class="p">(</span><span class="n">event</span><span class="o">.</span><span class="n">state</span> <span class="o">&amp;</span> <span class="o">~</span><span class="n">consumed</span><span class="p">)</span> <span class="o">&amp;</span> <span class="bp">self</span><span class="o">.</span><span class="n">_masks</span>
 
292
        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_lookup</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">mask</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">empty</span><span class="p">)</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">keyval</span><span class="p">,</span> <span class="bp">None</span><span class="p">)</span>
 
293
</pre></div></div></div>
 
294
 
 
295
          </div>
 
296
          <footer>
 
297
  
 
298
 
 
299
  <hr/>
 
300
 
 
301
  <div role="contentinfo">
 
302
    <p>
 
303
        &copy; Copyright 2015, Stephen Boddy, licensed under the CC-BY-SA..
 
304
    </p>
 
305
  </div>
 
306
  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 
307
 
 
308
</footer>
 
309
 
 
310
        </div>
 
311
      </div>
 
312
 
 
313
    </section>
 
314
 
 
315
  </div>
 
316
  
 
317
 
 
318
 
 
319
  
 
320
 
 
321
    <script type="text/javascript">
 
322
        var DOCUMENTATION_OPTIONS = {
 
323
            URL_ROOT:'../../',
 
324
            VERSION:'0.98',
 
325
            COLLAPSE_INDEX:false,
 
326
            FILE_SUFFIX:'.html',
 
327
            HAS_SOURCE:  true
 
328
        };
 
329
    </script>
 
330
      <script type="text/javascript" src="../../_static/jquery.js"></script>
 
331
      <script type="text/javascript" src="../../_static/underscore.js"></script>
 
332
      <script type="text/javascript" src="../../_static/doctools.js"></script>
 
333
 
 
334
  
 
335
 
 
336
  
 
337
  
 
338
    <script type="text/javascript" src="../../_static/js/theme.js"></script>
 
339
  
 
340
 
 
341
  
 
342
  
 
343
  <script type="text/javascript">
 
344
      jQuery(function () {
 
345
          SphinxRtdTheme.StickyNav.enable();
 
346
      });
 
347
  </script>
 
348
   
 
349
 
 
350
</body>
 
351
</html>
 
 
b'\\ No newline at end of file'