/usr/share/doc/gnat-gps/html/Scripts.html

<html lang="en">
<head>
<title>Scripts - Using the GNAT Programming Studio</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using the GNAT Programming Studio">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Scripting-GPS.html#Scripting-GPS" title="Scripting GPS">
<link rel="next" href="Scripts-and-GPS-actions.html#Scripts-and-GPS-actions" title="Scripts and GPS actions">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
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 3 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/'.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
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>
<div class="node">
<a name="Scripts"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Scripts-and-GPS-actions.html#Scripts-and-GPS-actions">Scripts and GPS actions</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Scripting-GPS.html#Scripting-GPS">Scripting GPS</a>
<hr>
</div>

<h4 class="subsection">16.8.1 Scripts</h4>

<!--  -->
<p class="noindent">Scripts are small programs that interact with GPS and allow you to
perform complex tasks repetitively and easily. GPS includes support
for two scripting languages currently, although additional languages
might be added in the future. These two languages are described in the
following section.

   <p>Support for scripting is currently work in progress in GPS. As a
result, not many commands are currently exported by GPS, although
their number is increasing daily. These commands are similar to what
is available to people who extend GPS directly in Ada, but with a
strong advantage: they do not require any recompilation of the GPS
core, and can be tested and executed interactively.

   <p>The goal of such scripts is to be able to help automate processes such
as builds, automatic generation of graphs, <small class="dots">...</small>

   <p>These languages all have a separate console associated with them,
which you can open from the <code>Tools</code> menu. In each of these
console, GPS will display a prompt, at which you can type interactive
commands. These console provide completion of the command names
through the &lt;tab&gt; key.

   <p>For instance, in the GPS shell console you can start typing
<pre class="smallexample">     GPS&gt; File
</pre>
   <p>then press the &lt;tab&gt; key, which will list all the functions whose
name starts with "File".

   <p>A similar feature is available in the python console, which also
provides completion for all the standard python commands and modules.

   <p>All the scripting languages share the same set of commands exported by
GPS, thanks to a abstract interface defined in the GPS core. As a
result, GPS modules do not have to be modified when new scripting
languages are added.

   <p><a name="index-g_t_002d_002dload-890"></a>Scripts can be executed immediately upon startup of GPS by using the
command line switch <code>--load</code>. Specifying the following command
line:

<pre class="smallexample">     gps --load=shell:mytest.gps
</pre>
   <p>will force the gps script <samp><span class="file">mytest.gps</span></samp> to be executed
immediately, before GPS starts reacting to user's requests. This is
useful if you want to do some special initializations of the
environment. It can also be used as a command line interface to GPS,
if you script's last command is to exit GPS.

   <p><a name="index-g_t_002d_002deval-891"></a>In-line commands can also be given directly on the command line through
<code>--eval</code> command line switch.

   <p>For instance, if you want to analyze an entity in the entity browser
from the command line, you would pass the following command switches:

<pre class="smallexample">     gps --eval=shell:'Entity entity_name file_name; Entity.show %1'
</pre>
   <p>See the section <a href="Customizing-through-XML-and-Python-files.html#Customizing-through-XML-and-Python-files">Customizing through XML and Python files</a> on how to bind key
shortcuts to shell commands.

<!--  -->
   </body></html>
gnat-gps-doc 5.0-6 / usr / share / doc / gnat-gps / html / Scripts.html
