src/osm-traces.c

   1 /*
   2  * viking -- GPS Data and Topo Analyzer, Explorer, and Manager
   3  *
   4  * Copyright (C) 2007, Guilhem Bonnefille <guilhem.bonnefille@gmail.com>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19  *
  20  */
  21 #ifdef HAVE_CONFIG_H
  22 #include "config.h"
  23 #endif
  24
  25 #include <stdio.h>
  26 #include <string.h>
  27 #include <errno.h>
  28 #include <time.h>
  29
  30 #include <curl/curl.h>
  31 #include <curl/easy.h>
  32
  33 #include <glib.h>
  34 #include <glib/gstdio.h>
  35 #include <glib/gi18n.h>
  36
  37 #include "viking.h"
  38 #include "viktrwlayer.h"
  39 #include "osm-traces.h"
  40 #include "gpx.h"
  41 #include "background.h"
  42 #include "preferences.h"
  43
  44 /* params will be osm_traces.username, osm_traces.password */
  45 /* we have to make sure these don't collide. */
  46 #define VIKING_OSM_TRACES_PARAMS_GROUP_KEY "osm_traces"
  47 #define VIKING_OSM_TRACES_PARAMS_NAMESPACE "osm_traces."
  48
  49 /**
  50  * Login to use for OSM uploading.
  51  */
  52 static gchar *user = NULL;
  53
  54 /**
  55  * Password to use for OSM uploading.
  56  */
  57 static gchar *password = NULL;
  58
  59 /**
  60  * Mutex to protect auth. token
  61  */
  62 static GMutex *login_mutex = NULL;
  63
  64 /**
  65  * Different type of trace visibility.
  66  */
  67 typedef struct _OsmTraceVis_t {
  68         const gchar *combostr;
  69         const gchar *apistr;
  70 } OsmTraceVis_t;
  71
  72 static const OsmTraceVis_t OsmTraceVis[] = {
  73         { N_("Identifiable (public w/ timestamps)"),    "identifiable" },
  74         { N_("Trackable (private w/ timestamps)"),      "trackable" },
  75         { N_("Public"),                                 "public" },
  76         { N_("Private"),                                "private" },
  77         { NULL, NULL },
  78 };
  79
  80 /**
  81  * Struct hosting needed info.
  82  */
  83 typedef struct _OsmTracesInfo {
  84   gchar *name;
  85   gchar *description;
  86   gchar *tags;
  87   const OsmTraceVis_t *vistype;
  88   VikTrwLayer *vtl;
  89   VikTrack *trk;
  90 } OsmTracesInfo;
  91
  92 static VikLayerParam prefs[] = {
  93   { VIKING_OSM_TRACES_PARAMS_NAMESPACE "username", VIK_LAYER_PARAM_STRING, VIK_LAYER_GROUP_NONE, N_("OSM username:"), VIK_LAYER_WIDGET_ENTRY },
  94   { VIKING_OSM_TRACES_PARAMS_NAMESPACE "password", VIK_LAYER_PARAM_STRING, VIK_LAYER_GROUP_NONE, N_("OSM password:"), VIK_LAYER_WIDGET_PASSWORD },
  95 };
  96
  97 /**
  98  * Free an OsmTracesInfo struct.
  99  */
 100 static void oti_free(OsmTracesInfo *oti)
 101 {
 102   if (oti) {
 103     /* Fields have been g_strdup'ed */
 104     g_free(oti->name); oti->name = NULL;
 105     g_free(oti->description); oti->description = NULL;
 106     g_free(oti->tags); oti->tags = NULL;
 107
 108     g_object_unref(oti->vtl); oti->vtl = NULL;
 109   }
 110   /* Main struct has been g_malloc'ed */
 111   g_free(oti);
 112 }
 113
 114 static const gchar *get_default_user()
 115 {
 116   const gchar *default_user = NULL;
 117
 118   /* Retrieve "standard" EMAIL varenv */
 119   default_user = g_getenv("EMAIL");
 120
 121   return default_user;
 122 }
 123
 124 static void set_login(const gchar *user_, const gchar *password_)
 125 {
 126   /* Allocate mutex */
 127   if (login_mutex == NULL)
 128   {
 129     login_mutex = g_mutex_new();
 130   }
 131   g_mutex_lock(login_mutex);
 132   g_free(user); user = NULL;
 133   g_free(password); password = NULL;
 134   user        = g_strdup(user_);
 135   password    = g_strdup(password_);
 136   g_mutex_unlock(login_mutex);
 137 }
 138
 139 static gchar *get_login()
 140 {
 141   gchar *user_pass = NULL;
 142   g_mutex_lock(login_mutex);
 143   user_pass = g_strdup_printf("%s:%s", user, password);
 144   g_mutex_unlock(login_mutex);
 145   return user_pass;
 146 }
 147
 148 /* initialisation */
 149 void osm_traces_init () {
 150   /* Preferences */
 151   a_preferences_register_group ( VIKING_OSM_TRACES_PARAMS_GROUP_KEY, _("OpenStreetMap Traces") );
 152
 153   VikLayerParamData tmp;
 154   tmp.s = "";
 155   a_preferences_register(prefs, tmp, VIKING_OSM_TRACES_PARAMS_GROUP_KEY);
 156   tmp.s = "";
 157   a_preferences_register(prefs+1, tmp, VIKING_OSM_TRACES_PARAMS_GROUP_KEY);
 158
 159 }
 160
 161 /*
 162  * Upload a file
 163  * returns a basic status:
 164  *   < 0  : curl error
 165  *   == 0 : OK
 166  *   > 0  : HTTP error
 167   */
 168 static gint osm_traces_upload_file(const char *user,
 169                                    const char *password,
 170                                    const char *file,
 171                                    const char *filename,
 172                                    const char *description,
 173                                    const char *tags,
 174                                    const OsmTraceVis_t *vistype)
 175 {
 176   CURL *curl;
 177   CURLcode res;
 178   char curl_error_buffer[CURL_ERROR_SIZE];
 179   struct curl_slist *headers = NULL;
 180   struct curl_httppost *post=NULL;
 181   struct curl_httppost *last=NULL;
 182
 183   char *base_url = "http://www.openstreetmap.org/api/0.6/gpx/create";
 184
 185   gchar *user_pass = get_login();
 186
 187   gint result = 0; // Default to it worked!
 188
 189   g_debug("%s: %s %s %s %s %s %s", __FUNCTION__,
 190           user, password, file, filename, description, tags);
 191
 192   /* Init CURL */
 193   curl = curl_easy_init();
 194
 195   /* Filling the form */
 196   curl_formadd(&post, &last,
 197                CURLFORM_COPYNAME, "description",
 198                CURLFORM_COPYCONTENTS, description, CURLFORM_END);
 199   curl_formadd(&post, &last,
 200                CURLFORM_COPYNAME, "tags",
 201                CURLFORM_COPYCONTENTS, tags, CURLFORM_END);
 202   curl_formadd(&post, &last,
 203                CURLFORM_COPYNAME, "visibility",
 204                CURLFORM_COPYCONTENTS, vistype->apistr, CURLFORM_END);
 205   curl_formadd(&post, &last,
 206                CURLFORM_COPYNAME, "file",
 207                CURLFORM_FILE, file,
 208                CURLFORM_FILENAME, filename,
 209                CURLFORM_CONTENTTYPE, "text/xml", CURLFORM_END);
 210
 211   /* Prepare request */
 212   /* As explained in http://wiki.openstreetmap.org/index.php/User:LA2 */
 213   /* Expect: header seems to produce incompatibilites between curl and httpd */
 214   headers = curl_slist_append(headers, "Expect: ");
 215   curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
 216   curl_easy_setopt(curl, CURLOPT_HTTPPOST, post);
 217   curl_easy_setopt(curl, CURLOPT_URL, base_url);
 218   curl_easy_setopt(curl, CURLOPT_USERPWD, user_pass);
 219   curl_easy_setopt(curl, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
 220   curl_easy_setopt(curl, CURLOPT_ERRORBUFFER, curl_error_buffer);
 221   if (vik_verbose)
 222     curl_easy_setopt ( curl, CURLOPT_VERBOSE, 1 );
 223
 224   /* Execute request */
 225   res = curl_easy_perform(curl);
 226   if (res == CURLE_OK)
 227   {
 228     long code;
 229     res = curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code);
 230     if (res == CURLE_OK)
 231     {
 232       g_debug("received valid curl response: %ld", code);
 233       if (code != 200) {
 234         g_warning(_("failed to upload data: HTTP response is %ld"), code);
 235         result = code;
 236       }
 237     }
 238     else {
 239       g_critical(_("curl_easy_getinfo failed: %d"), res);
 240       result = -1;
 241     }
 242   }
 243   else {
 244     g_warning(_("curl request failed: %s"), curl_error_buffer);
 245     result = -2;
 246   }
 247
 248   /* Memory */
 249   g_free(user_pass); user_pass = NULL;
 250
 251   curl_formfree(post);
 252   curl_easy_cleanup(curl);
 253   return result;
 254 }
 255
 256 /**
 257  * uploading function executed by the background" thread
 258  */
 259 static void osm_traces_upload_thread ( OsmTracesInfo *oti, gpointer threaddata )
 260 {
 261   /* Due to OSM limits, we have to enforce ele and time fields */
 262   static GpxWritingOptions options = { TRUE, TRUE };
 263   FILE *file = NULL;
 264   gchar *filename = NULL;
 265   int fd;
 266   GError *error = NULL;
 267   int ret;
 268
 269   g_assert(oti != NULL);
 270
 271   /* Opening temporary file */
 272   fd = g_file_open_tmp("viking_osm_upload_XXXXXX.gpx", &filename, &error);
 273   if (fd < 0) {
 274     g_error(_("failed to open temporary file: %s"), strerror(errno));
 275     return;
 276   }
 277   g_clear_error(&error);
 278   g_debug("%s: temporary file = %s", __FUNCTION__, filename);
 279
 280   /* Creating FILE* */
 281   file = fdopen(fd, "w");
 282
 283   /* writing gpx file */
 284   if (oti->trk != NULL)
 285   {
 286     /* Upload only the selected track */
 287     a_gpx_write_track_file_options(&options, oti->trk, file);
 288   }
 289   else
 290   {
 291     /* Upload the whole VikTrwLayer */
 292     a_gpx_write_file_options(&options, oti->vtl, file);
 293   }
 294
 295   /* We can close the file */
 296   /* This also close the associated fd */
 297   fclose(file);
 298   file = NULL;
 299
 300   /* finally, upload it */
 301   gint ans = osm_traces_upload_file(user, password, filename,
 302                    oti->name, oti->description, oti->tags, oti->vistype);
 303
 304   //
 305   // Show result in statusbar or failure in dialog for user feedback
 306   //
 307
 308   // Get current time to put into message to show when result was generated
 309   //  since need to show difference between operations (when displayed on statusbar)
 310   // NB If on dialog then don't need time.
 311   time_t timenow;
 312   struct tm* timeinfo;
 313   time ( &timenow );
 314   timeinfo = localtime ( &timenow );
 315   gchar timestr[80];
 316   // Compact time only - as days/date isn't very useful here
 317   strftime ( timestr, sizeof(timestr), "%X)", timeinfo );
 318
 319   //
 320   // Test to see if window it was invoked on is still valid
 321   // Not sure if this test really works! (i.e. if the window was closed in the mean time)
 322   //
 323   if ( IS_VIK_WINDOW ((VikWindow *)VIK_GTK_WINDOW_FROM_LAYER(oti->vtl)) ) {
 324     gchar* msg;
 325     if ( ans == 0 ) {
 326       // Success
 327       msg = g_strdup_printf ( "%s (@%s)", _("Uploaded to OSM"), timestr );
 328     }
 329     // Use UPPER CASE for bad news :(
 330     else if ( ans < 0 ) {
 331       msg = g_strdup_printf ( "%s (@%s)", _("FAILED TO UPLOAD DATA TO OSM - CURL PROBLEM"), timestr );
 332     }
 333     else {
 334       msg = g_strdup_printf ( "%s : %s %d (@%s)", _("FAILED TO UPLOAD DATA TO OSM"), _("HTTP response code"), ans, timestr );
 335     }
 336     // From the background so should use the signalling method to update display:
 337     // TODO: This only works with statically assigned strings ATM
 338     vik_window_signal_statusbar_update ( (VikWindow*)VIK_GTK_WINDOW_FROM_LAYER(oti->vtl), msg, VIK_STATUSBAR_INFO );
 339     // Thus can't free the memory yet...
 340     // Luckily OSM traces isn't heavily used so this is not a significant memory leak
 341     //g_free (msg);
 342     // But this is better than potentially crashing from multi thread GUI updates
 343   }
 344   /* Removing temporary file */
 345   ret = g_unlink(filename);
 346   if (ret != 0) {
 347     g_critical(_("failed to unlink temporary file: %s"), strerror(errno));
 348   }
 349 }
 350
 351 /**
 352  * Uploading a VikTrwLayer
 353  *
 354  * @param vtl VikTrwLayer
 355  * @param trk if not null, the track to upload
 356  */
 357 static void osm_traces_upload_viktrwlayer ( VikTrwLayer *vtl, VikTrack *trk )
 358 {
 359   GtkWidget *dia = gtk_dialog_new_with_buttons (_("OSM upload"),
 360                                                  VIK_GTK_WINDOW_FROM_LAYER(vtl),
 361                                                  GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
 362                                                  GTK_STOCK_CANCEL,
 363                                                  GTK_RESPONSE_REJECT,
 364                                                  GTK_STOCK_OK,
 365                                                  GTK_RESPONSE_ACCEPT,
 366                                                  NULL);
 367
 368   const gchar *default_user = get_default_user();
 369   const gchar *pref_user = a_preferences_get(VIKING_OSM_TRACES_PARAMS_NAMESPACE "username")->s;
 370   const gchar *pref_password = a_preferences_get(VIKING_OSM_TRACES_PARAMS_NAMESPACE "password")->s;
 371   const gchar *name = NULL;
 372   GtkWidget *user_label, *user_entry;
 373   GtkWidget *password_label, *password_entry;
 374   GtkWidget *name_label, *name_entry;
 375   GtkWidget *description_label, *description_entry;
 376   GtkWidget *tags_label, *tags_entry;
 377   GtkComboBox *visibility;
 378   const OsmTraceVis_t *vis_t;
 379
 380   user_label = gtk_label_new(_("Email:"));
 381   user_entry = gtk_entry_new();
 382   if (user != NULL && user[0] != '\0')
 383     gtk_entry_set_text(GTK_ENTRY(user_entry), user);
 384   else if (pref_user != NULL && pref_user[0] != '\0')
 385     gtk_entry_set_text(GTK_ENTRY(user_entry), pref_user);
 386   else if (default_user != NULL)
 387     gtk_entry_set_text(GTK_ENTRY(user_entry), default_user);
 388   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), user_label, FALSE, FALSE, 0);
 389   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), user_entry, FALSE, FALSE, 0);
 390   gtk_widget_set_tooltip_markup(GTK_WIDGET(user_entry),
 391                         _("The email used as login\n"
 392                         "<small>Enter the email you use to login into www.openstreetmap.org.</small>"));
 393
 394   password_label = gtk_label_new(_("Password:"));
 395   password_entry = gtk_entry_new();
 396   if (password != NULL && password[0] != '\0')
 397     gtk_entry_set_text(GTK_ENTRY(password_entry), password);
 398   else if (pref_password != NULL)
 399     gtk_entry_set_text(GTK_ENTRY(password_entry), pref_password);
 400   /* This is a password -> invisible */
 401   gtk_entry_set_visibility(GTK_ENTRY(password_entry), FALSE);
 402   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), password_label, FALSE, FALSE, 0);
 403   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), password_entry, FALSE, FALSE, 0);
 404   gtk_widget_set_tooltip_markup(GTK_WIDGET(password_entry),
 405                         _("The password used to login\n"
 406                         "<small>Enter the password you use to login into www.openstreetmap.org.</small>"));
 407
 408   name_label = gtk_label_new(_("File's name:"));
 409   name_entry = gtk_entry_new();
 410   if (trk != NULL)
 411     name = trk->name;
 412   else
 413     name = vik_layer_get_name(VIK_LAYER(vtl));
 414   gtk_entry_set_text(GTK_ENTRY(name_entry), name);
 415   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), name_label, FALSE, FALSE, 0);
 416   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), name_entry, FALSE, FALSE, 0);
 417   gtk_widget_set_tooltip_markup(GTK_WIDGET(name_entry),
 418                         _("The name of the file on OSM\n"
 419                         "<small>This is the name of the file created on the server."
 420                         "This is not the name of the local file.</small>"));
 421
 422   description_label = gtk_label_new(_("Description:"));
 423   description_entry = gtk_entry_new();
 424   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), description_label, FALSE, FALSE, 0);
 425   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), description_entry, FALSE, FALSE, 0);
 426   gtk_widget_set_tooltip_text(GTK_WIDGET(description_entry),
 427                         _("The description of the trace"));
 428
 429   tags_label = gtk_label_new(_("Tags:"));
 430   tags_entry = gtk_entry_new();
 431   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), tags_label, FALSE, FALSE, 0);
 432   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), tags_entry, FALSE, FALSE, 0);
 433   gtk_widget_set_tooltip_text(GTK_WIDGET(tags_entry),
 434                         _("The tags associated to the trace"));
 435
 436   visibility = GTK_COMBO_BOX(gtk_combo_box_new_text ());
 437   for (vis_t = OsmTraceVis; vis_t->combostr != NULL; vis_t++)
 438         gtk_combo_box_append_text(visibility, vis_t->combostr);
 439   /* Set identifiable by default */
 440   gtk_combo_box_set_active(visibility, 0);
 441   gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dia)->vbox), GTK_WIDGET(visibility), FALSE, FALSE, 0);
 442
 443   /* User should think about it first... */
 444   gtk_dialog_set_default_response ( GTK_DIALOG(dia), GTK_RESPONSE_REJECT );
 445
 446   gtk_widget_show_all ( dia );
 447   gtk_widget_grab_focus ( description_entry );
 448
 449   if ( gtk_dialog_run ( GTK_DIALOG(dia) ) == GTK_RESPONSE_ACCEPT )
 450   {
 451     gchar *title = NULL;
 452
 453     /* overwrite authentication info */
 454     set_login(gtk_entry_get_text(GTK_ENTRY(user_entry)),
 455               gtk_entry_get_text(GTK_ENTRY(password_entry)));
 456
 457     /* Storing data for the future thread */
 458     OsmTracesInfo *info = g_malloc(sizeof(OsmTracesInfo));
 459     info->name        = g_strdup(gtk_entry_get_text(GTK_ENTRY(name_entry)));
 460     info->description = g_strdup(gtk_entry_get_text(GTK_ENTRY(description_entry)));
 461     /* TODO Normalize tags: they will be used as URL part */
 462     info->tags        = g_strdup(gtk_entry_get_text(GTK_ENTRY(tags_entry)));
 463     info->vistype     = &OsmTraceVis[gtk_combo_box_get_active(visibility)];
 464     info->vtl         = VIK_TRW_LAYER(g_object_ref(vtl));
 465     info->trk         = trk;
 466
 467     title = g_strdup_printf(_("Uploading %s to OSM"), info->name);
 468
 469     /* launch the thread */
 470     a_background_thread(VIK_GTK_WINDOW_FROM_LAYER(vtl),          /* parent window */
 471                         title,                                   /* description string */
 472                         (vik_thr_func) osm_traces_upload_thread, /* function to call within thread */
 473                         info,                                    /* pass along data */
 474                         (vik_thr_free_func) oti_free,            /* function to free pass along data */
 475                         (vik_thr_free_func) NULL,
 476                         1 );
 477     g_free ( title ); title = NULL;
 478   }
 479   gtk_widget_destroy ( dia );
 480 }
 481
 482 /**
 483  * Function called by the entry menu of a TrwLayer
 484  */
 485 void osm_traces_upload_cb ( gpointer layer_and_vlp[2], guint file_type )
 486 {
 487   osm_traces_upload_viktrwlayer(VIK_TRW_LAYER(layer_and_vlp[0]), NULL);
 488 }
 489
 490 /**
 491  * Function called by the entry menu of a single track
 492  */
 493 // TODO: Fix this dodgy usage of magic 8 ball array sized numbering
 494 //       At least have some common definition somewhere...
 495 void osm_traces_upload_track_cb ( gpointer pass_along[8] )
 496 {
 497   if ( pass_along[7] ) {
 498     VikTrack *trk = VIK_TRACK(pass_along[7]);
 499     osm_traces_upload_viktrwlayer(VIK_TRW_LAYER(pass_along[0]), trk);
 500   }
 501 }