1gbs3(1) User Commands gbs3(1)
2
6 gbs3 - GAMBAS Scripter.
7
10 gbs3 [options] [--] [<script file> | <project directory> | -]
11 gbs3 --convert-project <source project directory> <destination script
12 directory>
13 gbs3 --convert-script <script file> [<Destination where project direc‐
14 tory is created>]
15 gbs3 [-p | --plugin] <script file> [<Destination directory where plugin
16 is created>]
17
20 Gambas is a free development environment based on a Basic interpreter
21 with object extensions,
22 a mix of Java(tm) and Visual Basic(tm).
23 With Gambas, you can quickly design your program GUI, access MySQL or
24 PostgreSQL databases,
25 pilot KDE applications with DCOP, translate your program into many lan‐
26 guages, and so on...
27 gbs3 is the interpreter that allows you to compile and execute a Gambas
29 script.
30 gbs3 may also be used to convert a Gambas project to a script or a
31 script back to a project.
32
35 -b, --buildonly
36 process and compile the script without executing it
37 -c, --nocache
39 force the script compilation (do not check cache)
40 --convert-project
42 convert a Gambas project into an executable Gambas script file
43 --convert-script
45 convert a Gambas script file into a Gambas project
46 -e execute the source code provided by the command line ( ':' sepa‐
48 rator )
49 -f, --fast
51 use just-in-time compiler
52 -g, --debug
54 add debugging information to application
55 -h, --help
57 display help and exit
58 -L, --license
60 display license
61 -p, --plugin
63 generate a plugin executable that can be loaded by other scripts
64 -S --strict
66 fail if 'Public' or 'Sub' are defined without a 'main' function
67 otherwise create main()
68 -t, --trace
70 turn on tracing option during execution
71 -T, --terse
73 only print a very terse error report on compile errors
74 -u, --use
76 load component or libraries ('comp1,comp2,lib1...')
77 -v, --verbose
79 be verbose
80 -V, --version
82 display version
83 -w, --warnings
85 display warnings during compilation
86
89 gbs3 can convert a Gambas project into an executable script file using
90 the --convert-project option. The input project directory is used to
91 create the script which is written to the output script directory. The
92 script is created and named the same as the originating project.
93 gbs3 MyProjectDirectory DestinationScriptDirectory
94
98 gbs3 can convert a script file to a full Gambas project using the
99 --convert-script option.
100 The input script is translated into a project by the same basename as
101 the script and is created in the specified directory. In the case in
102 which no output directory is specified, the environment variable PWD is
103 used as the location to create the Gambas project.
104 gbs3 MyScript.gbs ~/Projects
105 This created the project 'MyScript' directory in the users 'Projects'
106 directory.
107
110 gbs3 can create plugins that can be used by other scripts or Gambas ap‐
111 plications after being built using the --plugin or -p option. Plugins
112 are created in a user-selected directory and are also executed and
113 cached in this directory, unlike a normal script, in which executables
114 are created in the temp directory and are executed from there. This
115 allows plugins to persist after the scripter exits.
116 If no output destination is specified, then the plugin is created in
117 the ~/.local/lib/gambas directory. and may be loaded from there using
118 the component.load() function.
119 gbs3 MyPluginScript [Plugin Destination Directory]
120
123 #!/usr/bin/env gbs3
124 for i as integer = 0 to 10
125 print i;;
126 next
127
130 The latest version of Gambas can always be obtained from
131 gambas.sourceforge.net,
132 documentation about the language is at
133 http://gambaswiki.org/wiki.
134
137 Report bugs to http://gambaswiki.org/bugtracker
138
141 Copyright© Benoît Minisini <g4mba5@gmail.com>;
142 This is free software; see the source for copying conditions. There is
144 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
145 PURPOSE.
146Ubuntu March 2021 gbs3(1)