/usr/share/doc/gnat-gps/html/Reloading-a-python-file-in-GPS.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 2002-2010 AdaCore.

This document is free; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, see http://www.gnu.org/licenses/.

A copy of the license is included in the section entitled
"GNU General Public License". -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Using the GNAT Programming Studio: Reloading a python file in GPS</title>

<meta name="description" content="Using the GNAT Programming Studio: Reloading a python file in GPS">
<meta name="keywords" content="Using the GNAT Programming Studio: Reloading a python file in GPS">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index-table.html#Index-table" rel="index" title="Index table">
<link href="Python-FAQ.html#Python-FAQ" rel="up" title="Python FAQ">
<link href="Printing-the-GPS-Python-documentation.html#Printing-the-GPS-Python-documentation" rel="next" title="Printing the GPS Python documentation">
<link href="Redirecting-the-output-to-specific-windows.html#Redirecting-the-output-to-specific-windows" rel="previous" title="Redirecting the output to specific windows">
<style type="text/css">
<!--
   

a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
pre.smallexample {background-color:rgb(240,240,240);
                     font-family: courier new,courier,fixed;
                     font-size: 14px;
                     margin: 0px 40px 0px 40px;
                     border-width: 1px 2px 2px 1px;
                     border-top-style: dotted;
                     border-left-style: dotted;
                     border-right-style: solid;
                     border-bottom-style: solid;
                     border-color: black;}
   code             {color:black;
                     font-family: courier new,courier,fixed;
                     font-size: 14px;}
   body             {font-family: arial,helvetica,sans-serif;
                     font-size: 16px;
                     max-width: 800px;
                     text-align: justify}
   samp             {font-family: courier new,courier,fixed;
                     font-size: 14px}
                    

-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Reloading-a-python-file-in-GPS"></a>
<div class="header">
<p>
Next: <a href="Printing-the-GPS-Python-documentation.html#Printing-the-GPS-Python-documentation" accesskey="n" rel="next">Printing the GPS Python documentation</a>, Previous: <a href="Redirecting-the-output-to-specific-windows.html#Redirecting-the-output-to-specific-windows" accesskey="p" rel="previous">Redirecting the output to specific windows</a>, Up: <a href="Python-FAQ.html#Python-FAQ" accesskey="u" rel="up">Python FAQ</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Reloading-a-python-file-in-GPS-1"></a>
<h4 class="subsubsection">16.8.7.6 Reloading a python file in GPS</h4>

<p>After you have made modification to a python file, you might want to
reload it in GPS. This requires careful use of python commands.
</p>
<p>Here is an example. Lets assume you have a python file (<samp>&quot;mymod.py&quot;</samp>)
which contains the following:
</p>
<div class="smallexample">
<pre class="smallexample">GPS.parse_xml (&quot;&quot;&quot;
   &lt;action name=&quot;my_action&quot;&gt;
      &lt;shell lang=&quot;python&quot;&gt;mymod.myfunc()&lt;/shell&gt;
   &lt;/action&gt;&quot;&quot;&quot;)

def myfunc():
   print &quot;In myfunc\n&quot;
</pre></div>

<p>As you can guess from this file, it defines an action &quot;my_action&quot;, that you
can for instance associate with a keybinding through the Edit-&gt;Key shortcuts
menu.
</p>
<p>If this file has been copied in one of the <samp>plug-ins</samp> directories,
it will be automatically loaded at startup.
</p>
<p>Notice that the function <code>myfunc</code> is thus found in a separate namespace,
with the name <code>mymod</code>, same as the file.
</p>
<p>If you decide, during your GPS session, to edit this file and have the
function print &quot;In myfunc2&quot; instead, you then have to reload the file by
typing the following command in the Python console:
</p>
<div class="smallexample">
<pre class="smallexample">&gt; execfile (&quot;HOME/.gps/plug-ins/mymod.py&quot;, mymod.__dict__)
</pre></div>

<p>The first parameter is the full path to the file that you want to reload.
The second argument is less obvious, but indicates that the file should be
reloaded in the namespace <code>mymod</code>.
</p>
<p>If you omit the optional second parameter, Python will load the file, but
the function <code>myfunc</code> will be defined in the global namespace, and thus
the new definition is accessible through
</p>
<div class="smallexample">
<pre class="smallexample">&gt; myfunc()
</pre></div>

<p>Thus, the key shortcut you had set, which still executes <code>mymod.myfunc()</code>
will keep executing the old definition.
</p>
<p>By default, GPS provides a contextual menu when you are editing a Python
file. This contextual menu (Python-&gt;Reload module) will take care of all
the above details.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Printing-the-GPS-Python-documentation.html#Printing-the-GPS-Python-documentation" accesskey="n" rel="next">Printing the GPS Python documentation</a>, Previous: <a href="Redirecting-the-output-to-specific-windows.html#Redirecting-the-output-to-specific-windows" accesskey="p" rel="previous">Redirecting the output to specific windows</a>, Up: <a href="Python-FAQ.html#Python-FAQ" accesskey="u" rel="up">Python FAQ</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
gnat-gps-doc 5.0-16 / usr / share / doc / gnat-gps / html / Reloading-a-python-file-in-GPS.html
