1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5 <html xmlns="http://www.w3.org/1999/xhtml">
7 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
9 <title>flake8_integration.windowactivatable — gedit Flake8 integration 0.1 documentation</title>
11 <link rel="stylesheet" href="../../_static/default.css" type="text/css" />
12 <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
14 <script type="text/javascript">
15 var DOCUMENTATION_OPTIONS = {
18 COLLAPSE_INDEX: false,
23 <script type="text/javascript" src="../../_static/jquery.js"></script>
24 <script type="text/javascript" src="../../_static/underscore.js"></script>
25 <script type="text/javascript" src="../../_static/doctools.js"></script>
26 <script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
27 <link rel="top" title="gedit Flake8 integration 0.1 documentation" href="../../index.html" />
28 <link rel="up" title="Module code" href="../index.html" />
34 <li class="right" style="margin-right: 10px">
35 <a href="../../genindex.html" title="General Index"
36 accesskey="I">index</a></li>
38 <a href="../../py-modindex.html" title="Python Module Index"
40 <li><a href="../../index.html">gedit Flake8 integration 0.1 documentation</a> »</li>
41 <li><a href="../index.html" accesskey="U">Module code</a> »</li>
45 <div class="document">
46 <div class="documentwrapper">
47 <div class="bodywrapper">
50 <h1>Source code for flake8_integration.windowactivatable</h1><div class="highlight"><pre>
51 <span class="c">#-*- coding: utf-8 -*-</span>
53 <span class="sd">"""Main module of the Plugin for gedit that allow flake8 integration</span>
55 <span class="sd">:author: Sébastien CHAZALLET <s.chazallet@gmail.com></span>
56 <span class="sd">:organization: InsPyration EURL</span>
57 <span class="sd">:copyright: Copyright © InsPyration EURL <www.inspyration.org></span>
58 <span class="sd">:license: GPL 3 <http://www.gnu.org/licenses/gpl.html></span>
60 <span class="sd">:version: 0.1</span>
61 <span class="sd">"""</span>
64 <span class="kn">from</span> <span class="nn">gettext</span> <span class="kn">import</span> <span class="n">gettext</span> <span class="k">as</span> <span class="n">_</span>
66 <span class="kn">from</span> <span class="nn">gi.repository</span> <span class="kn">import</span> <span class="n">GObject</span><span class="p">,</span> <span class="n">Gtk</span><span class="p">,</span> <span class="n">Gedit</span><span class="p">,</span> <span class="n">PeasGtk</span>
68 <span class="kn">from</span> <span class="nn">integrated</span> <span class="kn">import</span> <span class="n">check_code_and_get_formated_result</span> <span class="k">as</span> <span class="n">check_code</span>
69 <span class="kn">from</span> <span class="nn">settings</span> <span class="kn">import</span> <span class="n">SettingsManager</span>
70 <span class="kn">from</span> <span class="nn">tree</span> <span class="kn">import</span> <span class="n">GeditFlake8Tree</span>
71 <span class="kn">from</span> <span class="nn">configuration</span> <span class="kn">import</span> <span class="n">GeditFlake8ConfigWidget</span>
73 <span class="c"># Menu to insert in gedit's 'Tools' menu</span>
74 <span class="n">ui_str</span> <span class="o">=</span> <span class="s">"""<ui></span>
75 <span class="s"> <menubar name="MenuBar"></span>
76 <span class="s"> <menu name="ToolsMenu" action="Tools"></span>
77 <span class="s"> <placeholder name="ToolsOps_2"></span>
78 <span class="s"> <menuitem name="GeditFlake8" action="GeditFlake8"/></span>
79 <span class="s"> </placeholder></span>
80 <span class="s"> </menu></span>
81 <span class="s"> </menubar></span>
82 <span class="s"></ui></span>
83 <span class="s">"""</span>
86 <div class="viewcode-block" id="GeditFlake8WindowActivatable"><a class="viewcode-back" href="../../flake8_integration.html#flake8_integration.windowactivatable.GeditFlake8WindowActivatable">[docs]</a><span class="k">class</span> <span class="nc">GeditFlake8WindowActivatable</span><span class="p">(</span><span class="n">GObject</span><span class="o">.</span><span class="n">Object</span><span class="p">,</span>
87 <span class="n">Gedit</span><span class="o">.</span><span class="n">WindowActivatable</span><span class="p">,</span>
88 <span class="n">PeasGtk</span><span class="o">.</span><span class="n">Configurable</span><span class="p">):</span>
89 <span class="sd">"""Main module of the gedit flake8 plugin"""</span>
91 <span class="n">__gtype_name__</span> <span class="o">=</span> <span class="s">"GeditFlake8WindowActivatable"</span>
93 <span class="n">window</span> <span class="o">=</span> <span class="n">GObject</span><span class="o">.</span><span class="n">property</span><span class="p">(</span><span class="nb">type</span><span class="o">=</span><span class="n">Gedit</span><span class="o">.</span><span class="n">Window</span><span class="p">)</span>
95 <div class="viewcode-block" id="GeditFlake8WindowActivatable.__init__"><a class="viewcode-back" href="../../flake8_integration.html#flake8_integration.windowactivatable.GeditFlake8WindowActivatable.__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>
96 <span class="sd">"""Initialize plugin</span>
98 <span class="sd"> :type action: function</span>
99 <span class="sd"> :param action: Called function that we intercept prints</span>
101 <span class="sd"> :rtype: None</span>
102 <span class="sd"> """</span>
103 <span class="n">GObject</span><span class="o">.</span><span class="n">Object</span><span class="o">.</span><span class="n">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
104 <span class="c"># Initialize settings</span>
105 <span class="bp">self</span><span class="o">.</span><span class="n">_settings</span> <span class="o">=</span> <span class="n">SettingsManager</span><span class="p">()</span>
106 <span class="bp">self</span><span class="o">.</span><span class="n">flake8_tree</span> <span class="o">=</span> <span class="bp">None</span>
108 <div class="viewcode-block" id="GeditFlake8WindowActivatable.do_activate"><a class="viewcode-back" href="../../flake8_integration.html#flake8_integration.windowactivatable.GeditFlake8WindowActivatable.do_activate">[docs]</a> <span class="k">def</span> <span class="nf">do_activate</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
109 <span class="sd">"""Activate the plugin</span>
111 <span class="sd"> :type self: GeditFlake8WindowActivatable</span>
112 <span class="sd"> :param self: Current plugin</span>
114 <span class="sd"> :rtype: None</span>
115 <span class="sd"> """</span>
116 <span class="c"># Get the Gtk.UIManager</span>
117 <span class="n">manager</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">window</span><span class="o">.</span><span class="n">get_ui_manager</span><span class="p">()</span>
119 <span class="c"># Create a new action group</span>
120 <span class="bp">self</span><span class="o">.</span><span class="n">_action_group</span> <span class="o">=</span> <span class="n">Gtk</span><span class="o">.</span><span class="n">ActionGroup</span><span class="p">(</span><span class="s">"GeditFlake8PluginActions"</span><span class="p">)</span>
121 <span class="bp">self</span><span class="o">.</span><span class="n">_action_group</span><span class="o">.</span><span class="n">add_actions</span><span class="p">([(</span><span class="s">"GeditFlake8"</span><span class="p">,</span>
122 <span class="bp">None</span><span class="p">,</span>
123 <span class="n">_</span><span class="p">(</span><span class="s">"Check Python source code"</span><span class="p">),</span>
124 <span class="bp">None</span><span class="p">,</span>
125 <span class="n">_</span><span class="p">(</span><span class="s">"Check Python source code"</span><span class="p">),</span>
126 <span class="bp">self</span><span class="o">.</span><span class="n">on_check_source_code</span><span class="p">)])</span>
128 <span class="c"># Insert the action group</span>
129 <span class="n">manager</span><span class="o">.</span><span class="n">insert_action_group</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_action_group</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="p">)</span>
131 <span class="c"># Merge the UI</span>
132 <span class="bp">self</span><span class="o">.</span><span class="n">_ui_id</span> <span class="o">=</span> <span class="n">manager</span><span class="o">.</span><span class="n">add_ui_from_string</span><span class="p">(</span><span class="n">ui_str</span><span class="p">)</span>
134 <span class="c"># Create a tree</span>
135 <span class="bp">self</span><span class="o">.</span><span class="n">flake8_tree</span> <span class="o">=</span> <span class="n">GeditFlake8Tree</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">window</span><span class="p">)</span>
137 <div class="viewcode-block" id="GeditFlake8WindowActivatable.do_deactivate"><a class="viewcode-back" href="../../flake8_integration.html#flake8_integration.windowactivatable.GeditFlake8WindowActivatable.do_deactivate">[docs]</a> <span class="k">def</span> <span class="nf">do_deactivate</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
138 <span class="sd">"""Deactivate the plugin</span>
140 <span class="sd"> :type self: GeditFlake8WindowActivatable</span>
141 <span class="sd"> :param self: Current plugin</span>
143 <span class="sd"> :rtype: None</span>
144 <span class="sd"> """</span>
145 <span class="c"># Remove the tree from the side panel</span>
146 <span class="bp">self</span><span class="o">.</span><span class="n">flake8_tree</span><span class="o">.</span><span class="n">remove</span><span class="p">()</span>
148 <span class="c"># Delete tree object</span>
149 <span class="bp">self</span><span class="o">.</span><span class="n">flake8_tree</span> <span class="o">=</span> <span class="bp">None</span>
151 <span class="c"># Get the Gtk.UIManager</span>
152 <span class="n">manager</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">window</span><span class="o">.</span><span class="n">get_ui_manager</span><span class="p">()</span>
154 <span class="c"># Remove the ui</span>
155 <span class="n">manager</span><span class="o">.</span><span class="n">remove_ui</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_ui_id</span><span class="p">)</span>
157 <span class="c"># Remove the action group</span>
158 <span class="n">manager</span><span class="o">.</span><span class="n">remove_action_group</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_action_group</span><span class="p">)</span>
160 <span class="c"># Delete the action group object</span>
161 <span class="bp">self</span><span class="o">.</span><span class="n">_action_group</span> <span class="o">=</span> <span class="bp">None</span>
163 <span class="c"># Make sure the manager updates</span>
164 <span class="n">manager</span><span class="o">.</span><span class="n">ensure_update</span><span class="p">()</span>
166 <div class="viewcode-block" id="GeditFlake8WindowActivatable.do_update_state"><a class="viewcode-back" href="../../flake8_integration.html#flake8_integration.windowactivatable.GeditFlake8WindowActivatable.do_update_state">[docs]</a> <span class="k">def</span> <span class="nf">do_update_state</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
167 <span class="sd">"""Allow to activate the plugin only if the document is python code</span>
168 <span class="sd"> If the document is a new document, it hasto be saved or the language of</span>
169 <span class="sd"> the document has to be set.</span>
171 <span class="sd"> :type self: GeditFlake8WindowActivatable</span>
172 <span class="sd"> :param self: Current plugin</span>
174 <span class="sd"> :rtype: None</span>
175 <span class="sd"> """</span>
176 <span class="n">state</span> <span class="o">=</span> <span class="bp">False</span>
177 <span class="n">doc</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">window</span><span class="o">.</span><span class="n">get_active_document</span><span class="p">()</span>
178 <span class="k">if</span> <span class="n">doc</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span>
179 <span class="n">language</span> <span class="o">=</span> <span class="n">doc</span><span class="o">.</span><span class="n">get_language</span><span class="p">()</span>
180 <span class="k">if</span> <span class="n">language</span> <span class="ow">is</span> <span class="ow">not</span> <span class="bp">None</span><span class="p">:</span>
181 <span class="n">state</span> <span class="o">=</span> <span class="n">language</span><span class="o">.</span><span class="n">get_id</span><span class="p">()</span> <span class="ow">in</span> <span class="p">[</span><span class="s">"python"</span><span class="p">,</span> <span class="s">"python3"</span><span class="p">]</span>
182 <span class="bp">self</span><span class="o">.</span><span class="n">_action_group</span><span class="o">.</span><span class="n">set_sensitive</span><span class="p">(</span><span class="n">state</span><span class="p">)</span>
184 <div class="viewcode-block" id="GeditFlake8WindowActivatable.do_create_configure_widget"><a class="viewcode-back" href="../../flake8_integration.html#flake8_integration.windowactivatable.GeditFlake8WindowActivatable.do_create_configure_widget">[docs]</a> <span class="k">def</span> <span class="nf">do_create_configure_widget</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
185 <span class="sd">"""Action when a user want to configure the plugin</span>
187 <span class="sd"> :type self: GeditFlake8WindowActivatable</span>
188 <span class="sd"> :param self: Current plugin</span>
190 <span class="sd"> :rtype: GeditFlake8ConfigWidget</span>
191 <span class="sd"> :return: a configuration widget</span>
192 <span class="sd"> """</span>
193 <span class="k">return</span> <span class="n">GeditFlake8ConfigWidget</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_settings</span><span class="p">)</span>
195 <div class="viewcode-block" id="GeditFlake8WindowActivatable.on_check_source_code"><a class="viewcode-back" href="../../flake8_integration.html#flake8_integration.windowactivatable.GeditFlake8WindowActivatable.on_check_source_code">[docs]</a> <span class="k">def</span> <span class="nf">on_check_source_code</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">action</span><span class="p">):</span>
196 <span class="sd">"""The user ask to check code source :</span>
197 <span class="sd"> 1\ check there is a doc and the doc is python code</span>
198 <span class="sd"> 2\ use flake8</span>
199 <span class="sd"> 3\ put flake8 results into the tree and activate it</span>
201 <span class="sd"> :type self: GeditFlake8WindowActivatable</span>
202 <span class="sd"> :param self: Current plugin</span>
204 <span class="sd"> :type action: Gtk.Action</span>
205 <span class="sd"> :param action: Called function that we intercept prints</span>
207 <span class="sd"> :rtype: None</span>
208 <span class="sd"> """</span>
210 <span class="c"># Get the document content</span>
211 <span class="n">doc</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">window</span><span class="o">.</span><span class="n">get_active_document</span><span class="p">()</span>
212 <span class="k">if</span> <span class="ow">not</span> <span class="n">doc</span><span class="p">:</span>
213 <span class="k">return</span>
215 <span class="c"># check the language of current document is set</span>
216 <span class="n">language</span> <span class="o">=</span> <span class="n">doc</span><span class="o">.</span><span class="n">get_language</span><span class="p">()</span>
217 <span class="k">if</span> <span class="n">language</span> <span class="ow">is</span> <span class="bp">None</span><span class="p">:</span>
218 <span class="k">return</span>
220 <span class="c"># check the language of current document is python</span>
221 <span class="k">if</span> <span class="n">language</span><span class="o">.</span><span class="n">get_id</span><span class="p">()</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">[</span><span class="s">"python"</span><span class="p">,</span> <span class="s">"python3"</span><span class="p">]:</span>
222 <span class="k">return</span>
224 <span class="c"># Use flake8 to get warnings</span>
225 <span class="n">warnings</span> <span class="o">=</span> <span class="n">check_code</span><span class="p">(</span>
226 <span class="n">doc</span><span class="o">.</span><span class="n">get_text</span><span class="p">(</span><span class="n">doc</span><span class="o">.</span><span class="n">get_start_iter</span><span class="p">(),</span> <span class="n">doc</span><span class="o">.</span><span class="n">get_end_iter</span><span class="p">(),</span> <span class="bp">False</span><span class="p">),</span>
227 <span class="nb">map</span><span class="p">(</span><span class="nb">str</span><span class="o">.</span><span class="n">upper</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_settings</span><span class="o">.</span><span class="n">get_ignore_list</span><span class="p">()),</span>
228 <span class="bp">self</span><span class="o">.</span><span class="n">_settings</span><span class="o">.</span><span class="n">get_complexity</span><span class="p">())</span>
230 <span class="c"># Empty store</span>
231 <span class="bp">self</span><span class="o">.</span><span class="n">flake8_tree</span><span class="o">.</span><span class="n">update_model</span><span class="p">(</span><span class="n">warnings</span><span class="p">)</span>
233 <span class="c"># Activate tree</span>
234 <span class="bp">self</span><span class="o">.</span><span class="n">flake8_tree</span><span class="o">.</span><span class="n">activate</span><span class="p">()</span></div></div>
240 <div class="sphinxsidebar">
241 <div class="sphinxsidebarwrapper">
242 <div id="searchbox" style="display: none">
243 <h3>Quick search</h3>
244 <form class="search" action="../../search.html" method="get">
245 <input type="text" name="q" />
246 <input type="submit" value="Go" />
247 <input type="hidden" name="check_keywords" value="yes" />
248 <input type="hidden" name="area" value="default" />
250 <p class="searchtip" style="font-size: 90%">
251 Enter search terms or a module, class or function name.
254 <script type="text/javascript">$('#searchbox').show(0);</script>
257 <div class="clearer"></div>
259 <div class="related">
262 <li class="right" style="margin-right: 10px">
263 <a href="../../genindex.html" title="General Index"
266 <a href="../../py-modindex.html" title="Python Module Index"
268 <li><a href="../../index.html">gedit Flake8 integration 0.1 documentation</a> »</li>
269 <li><a href="../index.html" >Module code</a> »</li>
273 © Copyright 2013, Sébastien CHAZALLET.
274 Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2b1.