2 * viking -- GPS Data and Topo Analyzer, Explorer, and Manager
4 * Copyright (C) 2003-2005, Evan Battaglia <gtoevan@gmx.net>
5 * Copyright (C) 2006, Quy Tonthat <qtonthat@gmail.com>
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25 * @short_description: running external programs and redirecting to TRWLayers.
27 * GPSBabel may not be necessary for everything -- for instance,
28 * use a_babel_convert_from_shellcommand() with input_file_type == %NULL
29 * for an external program that outputs GPX.
40 #ifdef HAVE_SYS_WAIT_H
48 #include <glib/gstdio.h>
50 /* TODO in the future we could have support for other shells (change command strings), or not use a shell at all */
51 #define BASH_LOCATION "/bin/bash"
56 static gchar *gpsbabel_loc = NULL;
61 static gchar *unbuffer_loc = NULL;
64 * List of file formats supported by gpsbabel.
66 GList *a_babel_file_list;
69 * List of device supported by gpsbabel.
71 GList *a_babel_device_list;
75 * @vt: The TRW layer to modify. All data will be deleted, and replaced by what gpsbabel outputs.
76 * @babelargs: A string containing gpsbabel command line filter options. No file types or names should
78 * @cb: A callback function.
80 * This function modifies data in a trw layer using gpsbabel filters. This routine is synchronous;
81 * that is, it will block the calling program until the conversion is done. To avoid blocking, call
82 * this routine from a worker thread.
84 * Returns: %TRUE on success
86 gboolean a_babel_convert( VikTrwLayer *vt, const char *babelargs, BabelStatusFunc cb, gpointer user_data )
90 gchar *name_src = NULL;
92 gchar *bargs = g_strconcat(babelargs, " -i gpx", NULL);
94 if ((fd_src = g_file_open_tmp("tmp-viking.XXXXXX", &name_src, NULL)) >= 0) {
95 f = fdopen(fd_src, "w");
96 a_gpx_write_file(vt, f);
99 ret = a_babel_convert_from ( vt, bargs, name_src, cb, user_data );
109 * Perform any cleanup actions once GPSBabel has completed running
111 static void babel_watch ( GPid pid,
115 g_spawn_close_pid ( pid );
119 * babel_general_convert:
120 * @args: The command line arguments passed to GPSBabel
121 * @cb: callback that is run for each line of GPSBabel output and at completion of the run
122 * callback may be NULL
123 * @user_data: passed along to cb
125 * The function to actually invoke the GPSBabel external command
127 * Returns: %TRUE on successful invocation of GPSBabel command
129 static gboolean babel_general_convert( BabelStatusFunc cb, gchar **args, gpointer user_data )
131 gboolean ret = FALSE;
133 GError *error = NULL;
136 if (!g_spawn_async_with_pipes (NULL, args, NULL, G_SPAWN_DO_NOT_REAP_CHILD, NULL, NULL, &pid, NULL, &babel_stdout, NULL, &error)) {
137 g_error("Async command failed: %s", error->message);
144 diag = fdopen(babel_stdout, "r");
145 setvbuf(diag, NULL, _IONBF, 0);
147 while (fgets(line, sizeof(line), diag)) {
149 cb(BABEL_DIAG_OUTPUT, line, user_data);
152 cb(BABEL_DONE, NULL, user_data);
156 g_child_watch_add ( pid, (GChildWatchFunc) babel_watch, NULL );
165 * babel_general_convert_from:
166 * @vtl: The TrackWaypoint Layer to save the data into
167 * If it is null it signifies that no data is to be processed,
168 * however the gpsbabel command is still ran as it can be for non-data related options eg:
169 * for use with the power off command - 'command_off'
170 * @cb: callback that is run upon new data from STDOUT (?)
171 * (TODO: STDERR would be nice since we usually redirect STDOUT)
172 * @user_data: passed along to cb
174 * Runs args[0] with the arguments and uses the GPX module
175 * to import the GPX data into layer vt. Assumes that upon
176 * running the command, the data will appear in the (usually
177 * temporary) file name_dst.
179 * Returns: %TRUE on success
181 static gboolean babel_general_convert_from( VikTrwLayer *vt, BabelStatusFunc cb, gchar **args, const gchar *name_dst, gpointer user_data )
183 gboolean ret = FALSE;
186 if (babel_general_convert(cb, args, user_data)) {
188 /* No data actually required but still need to have run gpsbabel anyway
189 - eg using the device power command_off */
193 f = g_fopen(name_dst, "r");
195 ret = a_gpx_read_file ( vt, f );
205 * a_babel_convert_from:
206 * @vt: The TRW layer to place data into. Duplicate items will be overwritten.
207 * @babelargs: A string containing gpsbabel command line options. In addition to any filters, this string
208 * must include the input file type (-i) option.
209 * @cb: Optional callback function. Same usage as in a_babel_convert().
211 * Loads data into a trw layer from a file, using gpsbabel. This routine is synchronous;
212 * that is, it will block the calling program until the conversion is done. To avoid blocking, call
213 * this routine from a worker thread.
215 * Returns: %TRUE on success
217 gboolean a_babel_convert_from( VikTrwLayer *vt, const char *babelargs, const char *from, BabelStatusFunc cb, gpointer user_data )
221 gchar *name_dst = NULL;
222 gboolean ret = FALSE;
225 if ((fd_dst = g_file_open_tmp("tmp-viking.XXXXXX", &name_dst, NULL)) >= 0) {
229 gchar **sub_args = g_strsplit(babelargs, " ", 0);
233 args[i++] = unbuffer_loc;
234 args[i++] = gpsbabel_loc;
235 for (j = 0; sub_args[j]; j++) {
236 /* some version of gpsbabel can not take extra blank arg */
237 if (sub_args[j][0] != '\0')
238 args[i++] = sub_args[j];
243 args[i++] = (char *)from;
245 args[i++] = name_dst;
248 ret = babel_general_convert_from ( vt, cb, args, name_dst, user_data );
250 g_strfreev(sub_args);
252 g_critical("gpsbabel not found in PATH");
261 * a_babel_convert_from_shellcommand:
263 * Runs the input command in a shell (bash) and optionally uses GPSBabel to convert from input_file_type.
264 * If input_file_type is %NULL, doesn't use GPSBabel. Input must be GPX (or Geocaching *.loc)
266 * Uses babel_general_convert_from() to actually run the command. This function
267 * prepares the command and temporary file, and sets up the arguments for bash.
269 gboolean a_babel_convert_from_shellcommand ( VikTrwLayer *vt, const char *input_cmd, const char *input_file_type, BabelStatusFunc cb, gpointer user_data )
272 gchar *name_dst = NULL;
273 gboolean ret = FALSE;
276 if ((fd_dst = g_file_open_tmp("tmp-viking.XXXXXX", &name_dst, NULL)) >= 0) {
277 gchar *shell_command;
278 if ( input_file_type )
279 shell_command = g_strdup_printf("%s | %s -i %s -f - -o gpx -F %s",
280 input_cmd, gpsbabel_loc, input_file_type, name_dst);
282 shell_command = g_strdup_printf("%s > %s", input_cmd, name_dst);
284 g_debug("%s: %s", __FUNCTION__, shell_command);
287 args = g_malloc(sizeof(gchar *)*4);
288 args[0] = BASH_LOCATION;
290 args[2] = shell_command;
293 ret = babel_general_convert_from ( vt, cb, args, name_dst, user_data );
295 g_free ( shell_command );
303 gboolean a_babel_convert_from_url ( VikTrwLayer *vt, const char *url, const char *input_type, BabelStatusFunc cb, gpointer user_data )
305 static DownloadMapOptions options = { FALSE, FALSE, NULL, 0, a_check_kml_file};
308 gboolean ret = FALSE;
309 gchar *name_src = NULL;
310 gchar *babelargs = NULL;
312 g_debug("%s: input_type=%s url=%s", __FUNCTION__, input_type, url);
314 if ((fd_src = g_file_open_tmp("tmp-viking.XXXXXX", &name_src, NULL)) >= 0) {
318 babelargs = g_strdup_printf(" -i %s", input_type);
320 fetch_ret = a_http_download_get_url(url, "", name_src, &options, NULL);
322 ret = a_babel_convert_from( vt, babelargs, name_src, NULL, NULL);
332 static gboolean babel_general_convert_to( VikTrwLayer *vt, BabelStatusFunc cb, gchar **args, const gchar *name_src, gpointer user_data )
334 if (!a_file_export(vt, name_src, FILE_TYPE_GPX, NULL)) {
335 g_critical("Error exporting to %s", name_src);
339 return babel_general_convert (cb, args, user_data);
342 gboolean a_babel_convert_to( VikTrwLayer *vt, const char *babelargs, const char *to, BabelStatusFunc cb, gpointer user_data )
346 gchar *name_src = NULL;
347 gboolean ret = FALSE;
350 if ((fd_src = g_file_open_tmp("tmp-viking.XXXXXX", &name_src, NULL)) >= 0) {
354 gchar **sub_args = g_strsplit(babelargs, " ", 0);
358 args[i++] = unbuffer_loc;
359 args[i++] = gpsbabel_loc;
362 for (j = 0; sub_args[j]; j++)
363 /* some version of gpsbabel can not take extra blank arg */
364 if (sub_args[j][0] != '\0')
365 args[i++] = sub_args[j];
367 args[i++] = name_src;
369 args[i++] = (char *)to;
372 ret = babel_general_convert_to ( vt, cb, args, name_src, user_data );
374 g_strfreev(sub_args);
376 g_critical("gpsbabel not found in PATH");
384 static void set_mode(BabelMode mode, gchar *smode)
386 mode.waypointsRead = smode[0] == 'r';
387 mode.waypointsWrite = smode[1] == 'w';
388 mode.tracksRead = smode[2] == 'r';
389 mode.tracksWrite = smode[3] == 'w';
390 mode.routesRead = smode[4] == 'r';
391 mode.routesWrite = smode[5] == 'w';
397 * Load a single feature stored in the given line.
399 static void load_feature_parse_line (gchar *line)
401 gchar **tokens = g_strsplit ( line, "\t", 0 );
403 && tokens[0] != NULL ) {
404 if ( strcmp("serial", tokens[0]) == 0 ) {
405 if ( tokens[1] != NULL
408 && tokens[4] != NULL ) {
409 BabelDevice *device = g_malloc ( sizeof (BabelDevice) );
410 set_mode (device->mode, tokens[1]);
411 device->name = g_strdup (tokens[2]);
412 device->label = g_strndup (tokens[4], 50); // Limit really long label text
413 a_babel_device_list = g_list_append (a_babel_device_list, device);
414 g_debug ("New gpsbabel device: %s", device->name);
416 g_warning ( "Unexpected gpsbabel format string: %s", line);
418 } else if ( strcmp("file", tokens[0]) == 0 ) {
419 if ( tokens[1] != NULL
422 && tokens[4] != NULL ) {
423 BabelFile *file = g_malloc ( sizeof (BabelFile) );
424 set_mode (file->mode, tokens[1]);
425 file->name = g_strdup (tokens[2]);
426 file->ext = g_strdup (tokens[3]);
427 file->label = g_strdup (tokens[4]);
428 a_babel_file_list = g_list_append (a_babel_file_list, file);
429 g_debug ("New gpsbabel file: %s", file->name);
431 g_warning ( "Unexpected gpsbabel format string: %s", line);
435 g_warning ( "Unexpected gpsbabel format string: %s", line);
437 g_strfreev ( tokens );
440 static void load_feature_cb (BabelProgressCode code, gpointer line, gpointer user_data)
443 load_feature_parse_line (line);
446 static gboolean load_feature ()
449 gboolean ret = FALSE;
452 if ( gpsbabel_loc ) {
455 args[i++] = unbuffer_loc;
456 args[i++] = gpsbabel_loc;
460 ret = babel_general_convert (load_feature_cb, args, NULL);
462 g_critical("gpsbabel not found in PATH");
469 /* TODO allow to set gpsbabel path via command line */
470 gpsbabel_loc = g_find_program_in_path( "gpsbabel" );
472 g_critical( "gpsbabel not found in PATH" );
473 unbuffer_loc = g_find_program_in_path( "unbuffer" );
475 g_warning( "unbuffer not found in PATH" );
480 void a_babel_uninit ()
482 g_free ( gpsbabel_loc );
483 g_free ( unbuffer_loc );
485 if ( a_babel_file_list ) {
487 for (gl = a_babel_file_list; gl != NULL; gl = g_list_next(gl)) {
488 BabelFile *file = gl->data;
489 g_free ( file->name );
490 g_free ( file->ext );
491 g_free ( file->label );
494 g_list_free ( a_babel_file_list );
497 if ( a_babel_device_list ) {
499 for (gl = a_babel_device_list; gl != NULL; gl = g_list_next(gl)) {
500 BabelDevice *device = gl->data;
501 g_free ( device->name );
502 g_free ( device->label );
505 g_list_free ( a_babel_device_list );