aboutsummaryrefslogblamecommitdiffstats
path: root/smclient/eggdesktopfile.c
blob: f264a93cdb10ae68d774fb8d0017eb36fdc8c8eb (plain) (tree)





































                                                                      
                              
 
                                   
                           
                                     











                                                               
                                                                     

























                                                                         
                                                                     



                                                        
                   




























                                                                        

                                                                



                                                   
                   





























                                                                           
                                                         


                                                       
                        














                                                                   
                          
                 












































                                                                                
                      































                                                              
                 




























                                                                        
                 









































                                                                    
             


























                                                                     
             



















                                                                      
             






                                                        
                                                






                                                         
       
                                                           
                                                   






                                                            
       
                                                                  

                                                             








                                                                           
                                                    






                                                             
       
                                                            
                                                    






                                                            
        
                                                                
                                                        







                                                                         
        
                                                                       

                                                                  






























                                                                        
                                                                  
 

                                      
                 
         




















































































































                                                                                   
                                   


                                                 
                 


























                                                 
                                        





                                                   
             




































































                                                                            
              



                                          
                            






























































































                                                                         
                                      
                                                       
                        
















































                                                                     
       




                                                           
                 













                                                                        
             

























                                                                                
              

                                                         


                                                       

                                                        



                                    

























































                                                                             
                                                  









                                                               
                    
















                                                                   
                                                          












                                                                
                                              




                  
                   





                               
                             












                                                                      
                                    





















                                                                       

                           

                                    
                    

                          
                                 
                             

                                 





                                           

                                                                         












                                                                               
                                                                











                                                                
                                              







                                                   
                                          


                                               
                                                   

















                                                                          
                                            

                                                        
                                             

                                                        
                                             

                                                       
                                                   













                                                                  

                                                                        




































                                                                           
                                                                           













                                                              
                                                                      
































































                                                                      
                                                         



                                                                  
                                                         
                                                                     
                                                     

















                                                                         
                                                                    

                                                                 
                                                          

                                                                    
                                                           

                                                                    
                                                           









































                                                                                     
         

























                                                                           





                                                                     



                                        
                                                              



















































                                                                               
                                                     


















                                                                         
                                                                      





                                                           
  

                                                    
  












                                                                     
/* eggdesktopfile.c - Freedesktop.Org Desktop Files
 * Copyright (C) 2007 Novell, Inc.
 *
 * Based on gnome-desktop-item.c
 * Copyright (C) 1999, 2000 Red Hat Inc.
 * Copyright (C) 2001 George Lebl
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; either version 2 of
 * the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; see the file COPYING.LIB. If not,
 * write to the Free Software Foundation, Inc., 59 Temple Place -
 * Suite 330, Boston, MA 02111-1307, USA.
 */

#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include "eggdesktopfile.h"

#include <string.h>
#include <unistd.h>

#include <glib/gi18n.h>
#include <gdk/gdkx.h>
#include <gtk/gtk.h>

struct EggDesktopFile {
  GKeyFile           *key_file;
  gchar               *source;

  gchar               *name, *icon;
  EggDesktopFileType  type;
  gchar                document_code;
};

/**
 * egg_desktop_file_new:
 * @desktop_file_path: path to a Freedesktop-style Desktop file
 * @error: error pointer
 *
 * Creates a new #EggDesktopFile for @desktop_file.
 *
 * Return value: the new #EggDesktopFile, or %NULL on error.
 **/
EggDesktopFile *
egg_desktop_file_new (const gchar *desktop_file_path, GError **error)
{
  GKeyFile *key_file;

  key_file = g_key_file_new ();
  if (!g_key_file_load_from_file (key_file, desktop_file_path, 0, error))
    {
      g_key_file_free (key_file);
      return NULL;
    }

  return egg_desktop_file_new_from_key_file (key_file, desktop_file_path,
                         error);
}

/**
 * egg_desktop_file_new_from_data_dirs:
 * @desktop_file_path: relative path to a Freedesktop-style Desktop file
 * @error: error pointer
 *
 * Looks for @desktop_file_path in the paths returned from
 * g_get_user_data_dir() and g_get_system_data_dirs(), and creates
 * a new #EggDesktopFile from it.
 *
 * Return value: the new #EggDesktopFile, or %NULL on error.
 **/
EggDesktopFile *
egg_desktop_file_new_from_data_dirs (const gchar  *desktop_file_path,
                     GError     **error)
{
  EggDesktopFile *desktop_file;
  GKeyFile *key_file;
  gchar *full_path;

  key_file = g_key_file_new ();
  if (!g_key_file_load_from_data_dirs (key_file, desktop_file_path,
                       &full_path, 0, error))
    {
      g_key_file_free (key_file);
      return NULL;
    }

  desktop_file = egg_desktop_file_new_from_key_file (key_file,
                             full_path,
                             error);
  g_free (full_path);
  return desktop_file;
}

/**
 * egg_desktop_file_new_from_dirs:
 * @desktop_file_path: relative path to a Freedesktop-style Desktop file
 * @search_dirs: NULL-terminated array of directories to search
 * @error: error pointer
 *
 * Looks for @desktop_file_path in the paths returned from
 * g_get_user_data_dir() and g_get_system_data_dirs(), and creates
 * a new #EggDesktopFile from it.
 *
 * Return value: the new #EggDesktopFile, or %NULL on error.
 **/
EggDesktopFile *
egg_desktop_file_new_from_dirs (const gchar  *desktop_file_path,
                const gchar **search_dirs,
                GError     **error)
{
  EggDesktopFile *desktop_file;
  GKeyFile *key_file;
  gchar *full_path;

  key_file = g_key_file_new ();
  if (!g_key_file_load_from_dirs (key_file, desktop_file_path, search_dirs,
                  &full_path, 0, error))
    {
      g_key_file_free (key_file);
      return NULL;
    }

  desktop_file = egg_desktop_file_new_from_key_file (key_file,
                             full_path,
                             error);
  g_free (full_path);
  return desktop_file;
}

/**
 * egg_desktop_file_new_from_key_file:
 * @key_file: a #GKeyFile representing a desktop file
 * @source: the path or URI that @key_file was loaded from, or %NULL
 * @error: error pointer
 *
 * Creates a new #EggDesktopFile for @key_file. Assumes ownership of
 * @key_file (on success or failure); you should consider @key_file to
 * be freed after calling this function.
 *
 * Return value: the new #EggDesktopFile, or %NULL on error.
 **/
EggDesktopFile *
egg_desktop_file_new_from_key_file (GKeyFile    *key_file,
                    const gchar  *source,
                    GError     **error)
{
  EggDesktopFile *desktop_file;
  gchar *version, *type;

  if (!g_key_file_has_group (key_file, EGG_DESKTOP_FILE_GROUP))
    {
      g_set_error (error, EGG_DESKTOP_FILE_ERROR,
           EGG_DESKTOP_FILE_ERROR_INVALID,
           _("File is not a valid .desktop file"));
      g_key_file_free (key_file);
      return NULL;
    }

  version = g_key_file_get_value (key_file, EGG_DESKTOP_FILE_GROUP,
                  EGG_DESKTOP_FILE_KEY_VERSION,
                  NULL);
  if (version)
    {
      gdouble version_num;
      gchar *end;

      version_num = g_ascii_strtod (version, &end);
      if (*end)
    {
      g_warning ("Invalid Version string '%s' in %s",
             version, source ? source : "(unknown)");
    }
      else if (version_num > 1.0)
    {
      g_set_error (error, EGG_DESKTOP_FILE_ERROR,
               EGG_DESKTOP_FILE_ERROR_INVALID,
               _("Unrecognized desktop file Version '%s'"), version);
      g_free (version);
      g_key_file_free (key_file);
      return NULL;
    }
      g_free (version);
    }

  desktop_file = g_new0 (EggDesktopFile, 1);
  desktop_file->key_file = key_file;

  if (g_path_is_absolute (source))
    desktop_file->source = g_filename_to_uri (source, NULL, NULL);
  else
    desktop_file->source = g_strdup (source);

  desktop_file->name = g_key_file_get_string (key_file, EGG_DESKTOP_FILE_GROUP,
                          EGG_DESKTOP_FILE_KEY_NAME, error);
  if (!desktop_file->name)
    {
      egg_desktop_file_free (desktop_file);
      return NULL;
    }

  type = g_key_file_get_string (key_file, EGG_DESKTOP_FILE_GROUP,
                EGG_DESKTOP_FILE_KEY_TYPE, error);
  if (!type)
    {
      egg_desktop_file_free (desktop_file);
      return NULL;
    }

  if (!strcmp (type, "Application"))
    {
      gchar *exec, *p;

      desktop_file->type = EGG_DESKTOP_FILE_TYPE_APPLICATION;

      exec = g_key_file_get_string (key_file,
                    EGG_DESKTOP_FILE_GROUP,
                    EGG_DESKTOP_FILE_KEY_EXEC,
                    error);
      if (!exec)
    {
      egg_desktop_file_free (desktop_file);
      g_free (type);
      return NULL;
    }

      /* See if it takes paths or URIs or neither */
      for (p = exec; *p; p++)
    {
      if (*p == '%')
        {
          if (p[1] == '\0' || strchr ("FfUu", p[1]))
        {
          desktop_file->document_code = p[1];
          break;
        }
          p++;
        }
    }

      g_free (exec);
    }
  else if (!strcmp (type, "Link"))
    {
      gchar *url;

      desktop_file->type = EGG_DESKTOP_FILE_TYPE_LINK;

      url = g_key_file_get_string (key_file,
                   EGG_DESKTOP_FILE_GROUP,
                   EGG_DESKTOP_FILE_KEY_URL,
                   error);
      if (!url)
    {
      egg_desktop_file_free (desktop_file);
      g_free (type);
      return NULL;
    }
      g_free (url);
    }
  else if (!strcmp (type, "Directory"))
    desktop_file->type = EGG_DESKTOP_FILE_TYPE_DIRECTORY;
  else
    desktop_file->type = EGG_DESKTOP_FILE_TYPE_UNRECOGNIZED;

  g_free (type);

  /* Check the Icon key */
  desktop_file->icon = g_key_file_get_string (key_file,
                          EGG_DESKTOP_FILE_GROUP,
                          EGG_DESKTOP_FILE_KEY_ICON,
                          NULL);
  if (desktop_file->icon && !g_path_is_absolute (desktop_file->icon))
    {
      gchar *ext;

      /* Lots of .desktop files still get this wrong */
      ext = strrchr (desktop_file->icon, '.');
      if (ext && (!strcmp (ext, ".png") ||
          !strcmp (ext, ".xpm") ||
          !strcmp (ext, ".svg")))
    {
      g_warning ("Desktop file '%s' has malformed Icon key '%s'"
             "(should not include extension)",
             source ? source : "(unknown)",
             desktop_file->icon);
      *ext = '\0';
    }
    }

  return desktop_file;
}

/**
 * egg_desktop_file_free:
 * @desktop_file: an #EggDesktopFile
 *
 * Frees @desktop_file.
 **/
void
egg_desktop_file_free (EggDesktopFile *desktop_file)
{
  g_key_file_free (desktop_file->key_file);
  g_free (desktop_file->source);
  g_free (desktop_file->name);
  g_free (desktop_file->icon);
  g_free (desktop_file);
}

/**
 * egg_desktop_file_get_source:
 * @desktop_file: an #EggDesktopFile
 *
 * Gets the URI that @desktop_file was loaded from.
 *
 * Return value: @desktop_file's source URI
 **/
const gchar *
egg_desktop_file_get_source (EggDesktopFile *desktop_file)
{
  return desktop_file->source;
}

/**
 * egg_desktop_file_get_desktop_file_type:
 * @desktop_file: an #EggDesktopFile
 *
 * Gets the desktop file type of @desktop_file.
 *
 * Return value: @desktop_file's type
 **/
EggDesktopFileType
egg_desktop_file_get_desktop_file_type (EggDesktopFile *desktop_file)
{
  return desktop_file->type;
}

/**
 * egg_desktop_file_get_name:
 * @desktop_file: an #EggDesktopFile
 *
 * Gets the (localized) value of @desktop_file's "Name" key.
 *
 * Return value: the application/link name
 **/
const gchar *
egg_desktop_file_get_name (EggDesktopFile *desktop_file)
{
  return desktop_file->name;
}

/**
 * egg_desktop_file_get_icon:
 * @desktop_file: an #EggDesktopFile
 *
 * Gets the value of @desktop_file's "Icon" key.
 *
 * If the icon string is a full path (that is, if g_path_is_absolute()
 * returns %TRUE when called on it), it points to a file containing an
 * unthemed icon. If the icon string is not a full path, it is the
 * name of a themed icon, which can be looked up with %GtkIconTheme,
 * or passed directly to a theme-aware widget like %GtkImage or
 * %GtkCellRendererPixbuf.
 *
 * Return value: the icon path or name
 **/
const gchar *
egg_desktop_file_get_icon (EggDesktopFile *desktop_file)
{
  return desktop_file->icon;
}

gboolean
egg_desktop_file_has_key (EggDesktopFile  *desktop_file,
              const gchar      *key,
              GError         **error)
{
  return g_key_file_has_key (desktop_file->key_file,
                 EGG_DESKTOP_FILE_GROUP, key,
                 error);
}

gchar *
egg_desktop_file_get_string (EggDesktopFile  *desktop_file,
                 const gchar      *key,
                 GError         **error)
{
  return g_key_file_get_string (desktop_file->key_file,
                EGG_DESKTOP_FILE_GROUP, key,
                error);
}

gchar *
egg_desktop_file_get_locale_string (EggDesktopFile  *desktop_file,
                    const gchar      *key,
                    const gchar      *locale,
                    GError         **error)
{
  return g_key_file_get_locale_string (desktop_file->key_file,
                       EGG_DESKTOP_FILE_GROUP, key, locale,
                       error);
}

gboolean
egg_desktop_file_get_boolean (EggDesktopFile  *desktop_file,
                  const gchar      *key,
                  GError         **error)
{
  return g_key_file_get_boolean (desktop_file->key_file,
                 EGG_DESKTOP_FILE_GROUP, key,
                 error);
}

gdouble
egg_desktop_file_get_numeric (EggDesktopFile  *desktop_file,
                  const gchar      *key,
                  GError         **error)
{
  return g_key_file_get_double (desktop_file->key_file,
                EGG_DESKTOP_FILE_GROUP, key,
                error);
}

gchar **
egg_desktop_file_get_string_list (EggDesktopFile  *desktop_file,
                  const gchar      *key,
                  gsize           *length,
                  GError         **error)
{
  return g_key_file_get_string_list (desktop_file->key_file,
                     EGG_DESKTOP_FILE_GROUP, key, length,
                     error);
}

gchar **
egg_desktop_file_get_locale_string_list (EggDesktopFile  *desktop_file,
                     const gchar      *key,
                     const gchar      *locale,
                     gsize           *length,
                     GError         **error)
{
  return g_key_file_get_locale_string_list (desktop_file->key_file,
                        EGG_DESKTOP_FILE_GROUP, key,
                        locale, length,
                        error);
}

/**
 * egg_desktop_file_can_launch:
 * @desktop_file: an #EggDesktopFile
 * @desktop_environment: the name of the running desktop environment,
 * or %NULL
 *
 * Tests if @desktop_file can/should be launched in the current
 * environment. If @desktop_environment is non-%NULL, @desktop_file's
 * "OnlyShowIn" and "NotShowIn" keys are checked to make sure that
 * this desktop_file is appropriate for the named environment.
 *
 * Furthermore, if @desktop_file has type
 * %EGG_DESKTOP_FILE_TYPE_APPLICATION, its "TryExec" key (if any) is
 * also checked, to make sure the binary it points to exists.
 *
 * egg_desktop_file_can_launch() does NOT check the value of the
 * "Hidden" key.
 *
 * Return value: %TRUE if @desktop_file can be launched
 **/
gboolean
egg_desktop_file_can_launch (EggDesktopFile *desktop_file,
                 const gchar     *desktop_environment)
{
  gchar *try_exec, *found_program;
  gchar **only_show_in, **not_show_in;
  gboolean found;
  gint i;

  if (desktop_file->type != EGG_DESKTOP_FILE_TYPE_APPLICATION &&
      desktop_file->type != EGG_DESKTOP_FILE_TYPE_LINK)
    return FALSE;

  if (desktop_environment)
    {
      only_show_in = g_key_file_get_string_list (desktop_file->key_file,
                         EGG_DESKTOP_FILE_GROUP,
                         EGG_DESKTOP_FILE_KEY_ONLY_SHOW_IN,
                         NULL, NULL);
      if (only_show_in)
    {
      for (i = 0, found = FALSE; only_show_in[i] && !found; i++)
        {
          if (!strcmp (only_show_in[i], desktop_environment))
        found = TRUE;
        }

      g_strfreev (only_show_in);

      if (!found)
        return FALSE;
    }

      not_show_in = g_key_file_get_string_list (desktop_file->key_file,
                        EGG_DESKTOP_FILE_GROUP,
                        EGG_DESKTOP_FILE_KEY_NOT_SHOW_IN,
                        NULL, NULL);
      if (not_show_in)
    {
      for (i = 0, found = FALSE; not_show_in[i] && !found; i++)
        {
          if (!strcmp (not_show_in[i], desktop_environment))
        found = TRUE;
        }

      g_strfreev (not_show_in);

      if (found)
        return FALSE;
    }
    }

  if (desktop_file->type == EGG_DESKTOP_FILE_TYPE_APPLICATION)
    {
      try_exec = g_key_file_get_string (desktop_file->key_file,
                    EGG_DESKTOP_FILE_GROUP,
                    EGG_DESKTOP_FILE_KEY_TRY_EXEC,
                    NULL);
      if (try_exec)
    {
      found_program = g_find_program_in_path (try_exec);
      g_free (try_exec);

      if (!found_program)
        return FALSE;
      g_free (found_program);
    }
    }

  return TRUE;
}

/**
 * egg_desktop_file_accepts_documents:
 * @desktop_file: an #EggDesktopFile
 *
 * Tests if @desktop_file represents an application that can accept
 * documents on the command line.
 *
 * Return value: %TRUE or %FALSE
 **/
gboolean
egg_desktop_file_accepts_documents (EggDesktopFile *desktop_file)
{
  return desktop_file->document_code != 0;
}

/**
 * egg_desktop_file_accepts_multiple:
 * @desktop_file: an #EggDesktopFile
 *
 * Tests if @desktop_file can accept multiple documents at once.
 *
 * If this returns %FALSE, you can still pass multiple documents to
 * egg_desktop_file_launch(), but that will result in multiple copies
 * of the application being launched. See egg_desktop_file_launch()
 * for more details.
 *
 * Return value: %TRUE or %FALSE
 **/
gboolean
egg_desktop_file_accepts_multiple (EggDesktopFile *desktop_file)
{
  return (desktop_file->document_code == 'F' ||
      desktop_file->document_code == 'U');
}

/**
 * egg_desktop_file_accepts_uris:
 * @desktop_file: an #EggDesktopFile
 *
 * Tests if @desktop_file can accept (non-"file:") URIs as documents to
 * open.
 *
 * Return value: %TRUE or %FALSE
 **/
gboolean
egg_desktop_file_accepts_uris (EggDesktopFile *desktop_file)
{
  return (desktop_file->document_code == 'U' ||
      desktop_file->document_code == 'u');
}

static void
append_quoted_word (GString    *str,
            const gchar *s,
            gboolean    in_single_quotes,
            gboolean    in_double_quotes)
{
  const gchar *p;

  if (!in_single_quotes && !in_double_quotes)
    g_string_append_c (str, '\'');
  else if (!in_single_quotes && in_double_quotes)
    g_string_append (str, "\"'");

  if (!strchr (s, '\''))
    g_string_append (str, s);
  else
    {
      for (p = s; *p != '\0'; p++)
    {
      if (*p == '\'')
        g_string_append (str, "'\\''");
      else
        g_string_append_c (str, *p);
    }
    }

  if (!in_single_quotes && !in_double_quotes)
    g_string_append_c (str, '\'');
  else if (!in_single_quotes && in_double_quotes)
    g_string_append (str, "'\"");
}

static void
do_percent_subst (EggDesktopFile *desktop_file,
          gchar            code,
          GString        *str,
          GSList        **documents,
          gboolean        in_single_quotes,
          gboolean        in_double_quotes)
{
  GSList *d;
  gchar *doc;

  switch (code)
    {
    case '%':
      g_string_append_c (str, '%');
      break;

    case 'F':
    case 'U':
      for (d = *documents; d; d = d->next)
    {
      doc = d->data;
      g_string_append (str, " ");
      append_quoted_word (str, doc, in_single_quotes, in_double_quotes);
    }
      *documents = NULL;
      break;

    case 'f':
    case 'u':
      if (*documents)
    {
      doc = (*documents)->data;
      g_string_append (str, " ");
      append_quoted_word (str, doc, in_single_quotes, in_double_quotes);
      *documents = (*documents)->next;
    }
      break;

    case 'i':
      if (desktop_file->icon)
    {
      g_string_append (str, "--icon ");
      append_quoted_word (str, desktop_file->icon,
                  in_single_quotes, in_double_quotes);
    }
      break;

    case 'c':
      if (desktop_file->name)
    {
      append_quoted_word (str, desktop_file->name,
                  in_single_quotes, in_double_quotes);
    }
      break;

    case 'k':
      if (desktop_file->source)
    {
      append_quoted_word (str, desktop_file->source,
                  in_single_quotes, in_double_quotes);
    }
      break;

    case 'D':
    case 'N':
    case 'd':
    case 'n':
    case 'v':
    case 'm':
      /* Deprecated; skip */
      break;

    default:
      g_warning ("Unrecognized %%-code '%%%c' in Exec", code);
      break;
    }
}

static gchar *
parse_exec (EggDesktopFile  *desktop_file,
        GSList         **documents,
        GError         **error)
{
  gchar *exec, *p, *command;
  gboolean escape, single_quot, double_quot;
  GString *gs;

  exec = g_key_file_get_string (desktop_file->key_file,
                EGG_DESKTOP_FILE_GROUP,
                EGG_DESKTOP_FILE_KEY_EXEC,
                error);
  if (!exec)
    return NULL;

  /* Build the command */
  gs = g_string_new (NULL);
  escape = single_quot = double_quot = FALSE;

  for (p = exec; *p != '\0'; p++)
    {
      if (escape)
    {
      escape = FALSE;
      g_string_append_c (gs, *p);
    }
      else if (*p == '\\')
    {
      if (!single_quot)
        escape = TRUE;
      g_string_append_c (gs, *p);
    }
      else if (*p == '\'')
    {
      g_string_append_c (gs, *p);
      if (!single_quot && !double_quot)
        single_quot = TRUE;
      else if (single_quot)
        single_quot = FALSE;
    }
      else if (*p == '"')
    {
      g_string_append_c (gs, *p);
      if (!single_quot && !double_quot)
        double_quot = TRUE;
      else if (double_quot)
        double_quot = FALSE;
    }
      else if (*p == '%' && p[1])
    {
      do_percent_subst (desktop_file, p[1], gs, documents,
                single_quot, double_quot);
      p++;
    }
      else
    g_string_append_c (gs, *p);
    }

  g_free (exec);
  command = g_string_free (gs, FALSE);

  /* Prepend "xdg-terminal " if needed (FIXME: use gvfs) */
  if (g_key_file_has_key (desktop_file->key_file,
              EGG_DESKTOP_FILE_GROUP,
              EGG_DESKTOP_FILE_KEY_TERMINAL,
              NULL))
    {
      GError *terminal_error = NULL;
      gboolean use_terminal =
    g_key_file_get_boolean (desktop_file->key_file,
                EGG_DESKTOP_FILE_GROUP,
                EGG_DESKTOP_FILE_KEY_TERMINAL,
                &terminal_error);
      if (terminal_error)
    {
      g_free (command);
      g_propagate_error (error, terminal_error);
      return NULL;
    }

      if (use_terminal)
    {
      gs = g_string_new ("xdg-terminal ");
      append_quoted_word (gs, command, FALSE, FALSE);
      g_free (command);
      command = g_string_free (gs, FALSE);
    }
    }

  return command;
}

static GSList *
translate_document_list (EggDesktopFile *desktop_file, GSList *documents)
{
  gboolean accepts_uris = egg_desktop_file_accepts_uris (desktop_file);
  GSList *ret, *d;

  for (d = documents, ret = NULL; d; d = d->next)
    {
      const gchar *document = d->data;
      gboolean is_uri = !g_path_is_absolute (document);
      gchar *translated;

      if (accepts_uris)
    {
      if (is_uri)
        translated = g_strdup (document);
      else
        translated = g_filename_to_uri (document, NULL, NULL);
    }
      else
    {
      if (is_uri)
        translated = g_filename_from_uri (document, NULL, NULL);
      else
        translated = g_strdup (document);
    }

      if (translated)
    ret = g_slist_prepend (ret, translated);
    }

  return g_slist_reverse (ret);
}

static void
free_document_list (GSList *documents)
{
  GSList *d;

  for (d = documents; d; d = d->next)
    g_free (d->data);
  g_slist_free (documents);
}

/**
 * egg_desktop_file_parse_exec:
 * @desktop_file: a #EggDesktopFile
 * @documents: a list of document paths or URIs
 * @error: error pointer
 *
 * Parses @desktop_file's Exec key, inserting @documents into it, and
 * returns the result.
 *
 * If @documents contains non-file: URIs and @desktop_file does not
 * accept URIs, those URIs will be ignored. Likewise, if @documents
 * contains more elements than @desktop_file accepts, the extra
 * documents will be ignored.
 *
 * Return value: the parsed Exec string
 **/
gchar *
egg_desktop_file_parse_exec (EggDesktopFile  *desktop_file,
                 GSList          *documents,
                 GError         **error)
{
  GSList *translated, *docs;
  gchar *command;

  docs = translated = translate_document_list (desktop_file, documents);
  command = parse_exec (desktop_file, &docs, error);
  free_document_list (translated);

  return command;
}

static gboolean
parse_link (EggDesktopFile  *desktop_file,
        EggDesktopFile **app_desktop_file,
        GSList         **documents,
        GError         **error)
{
  gchar *url;
  GKeyFile *key_file;

  url = g_key_file_get_string (desktop_file->key_file,
                   EGG_DESKTOP_FILE_GROUP,
                   EGG_DESKTOP_FILE_KEY_URL,
                   error);
  if (!url)
    return FALSE;
  *documents = g_slist_prepend (NULL, url);

  /* FIXME: use gvfs */
  key_file = g_key_file_new ();
  g_key_file_set_string (key_file, EGG_DESKTOP_FILE_GROUP,
             EGG_DESKTOP_FILE_KEY_NAME,
             "xdg-open");
  g_key_file_set_string (key_file, EGG_DESKTOP_FILE_GROUP,
             EGG_DESKTOP_FILE_KEY_TYPE,
             "Application");
  g_key_file_set_string (key_file, EGG_DESKTOP_FILE_GROUP,
             EGG_DESKTOP_FILE_KEY_EXEC,
             "xdg-open %u");
  *app_desktop_file = egg_desktop_file_new_from_key_file (key_file, NULL, NULL);
  return TRUE;
}

#if GTK_CHECK_VERSION (2, 12, 0)
static gchar *
start_startup_notification (GdkDisplay     *display,
                EggDesktopFile *desktop_file,
                const gchar     *argv0,
                gint             screen,
                gint             workspace,
                guint32         launch_time)
{
  static gint sequence = 0;
  gchar *startup_id;
  gchar *description, *wmclass;
  gchar *screen_str, *workspace_str;

  if (g_key_file_has_key (desktop_file->key_file,
              EGG_DESKTOP_FILE_GROUP,
              EGG_DESKTOP_FILE_KEY_STARTUP_NOTIFY,
              NULL))
    {
      if (!g_key_file_get_boolean (desktop_file->key_file,
                   EGG_DESKTOP_FILE_GROUP,
                   EGG_DESKTOP_FILE_KEY_STARTUP_NOTIFY,
                   NULL))
    return NULL;
      wmclass = NULL;
    }
  else
    {
      wmclass = g_key_file_get_string (desktop_file->key_file,
                       EGG_DESKTOP_FILE_GROUP,
                       EGG_DESKTOP_FILE_KEY_STARTUP_WM_CLASS,
                       NULL);
      if (!wmclass)
    return NULL;
    }

  if (launch_time == (guint32)-1)
    launch_time = gdk_x11_display_get_user_time (display);
  startup_id = g_strdup_printf ("%s-%lu-%s-%s-%d_TIME%lu",
                g_get_prgname (),
                (unsigned long)getpid (),
                g_get_host_name (),
                argv0,
                sequence++,
                (unsigned long)launch_time);

  description = g_strdup_printf (_("Starting %s"), desktop_file->name);
  screen_str = g_strdup_printf ("%d", screen);
  workspace_str = workspace == -1 ? NULL : g_strdup_printf ("%d", workspace);

  gdk_x11_display_broadcast_startup_message (display, "new",
                         "ID", startup_id,
                         "NAME", desktop_file->name,
                         "SCREEN", screen_str,
                         "BIN", argv0,
                         "ICON", desktop_file->icon,
                         "DESKTOP", workspace_str,
                         "DESCRIPTION", description,
                         "WMCLASS", wmclass,
                         NULL);

  g_free (description);
  g_free (wmclass);
  g_free (screen_str);
  g_free (workspace_str);

  return startup_id;
}

static void
end_startup_notification (GdkDisplay *display,
              const gchar *startup_id)
{
  gdk_x11_display_broadcast_startup_message (display, "remove",
                         "ID", startup_id,
                         NULL);
}

#define EGG_DESKTOP_FILE_SN_TIMEOUT_LENGTH (30 /* seconds */)

typedef struct {
  GdkDisplay *display;
  gchar *startup_id;
} StartupNotificationData;

static gboolean
startup_notification_timeout (gpointer data)
{
  StartupNotificationData *sn_data = data;

  end_startup_notification (sn_data->display, sn_data->startup_id);
  g_object_unref (sn_data->display);
  g_free (sn_data->startup_id);
  g_free (sn_data);

  return FALSE;
}

static void
set_startup_notification_timeout (GdkDisplay *display,
                  const gchar *startup_id)
{
  StartupNotificationData *sn_data;

  sn_data = g_new (StartupNotificationData, 1);
  sn_data->display = g_object_ref (display);
  sn_data->startup_id = g_strdup (startup_id);

  g_timeout_add_seconds (EGG_DESKTOP_FILE_SN_TIMEOUT_LENGTH,
             startup_notification_timeout, sn_data);
}
#endif /* GTK 2.12 */

static GPtrArray *
array_putenv (GPtrArray *env, gchar *variable)
{
  guint i, keylen;

  if (!env)
    {
      gchar **envp;

      env = g_ptr_array_new ();

      envp = g_listenv ();
      for (i = 0; envp[i]; i++)
        {
          const gchar *value;

          value = g_getenv (envp[i]);
          g_ptr_array_add (env, g_strdup_printf ("%s=%s", envp[i],
                                                 value ? value : ""));
        }
      g_strfreev (envp);
    }

  keylen = strcspn (variable, "=");

  /* Remove old value of key */
  for (i = 0; i < env->len; i++)
    {
      gchar *envvar = env->pdata[i];

      if (!strncmp (envvar, variable, keylen) && envvar[keylen] == '=')
    {
      g_free (envvar);
      g_ptr_array_remove_index_fast (env, i);
      break;
    }
    }

  /* Add new value */
  g_ptr_array_add (env, g_strdup (variable));

  return env;
}

static gboolean
egg_desktop_file_launchv (EggDesktopFile *desktop_file,
              GSList *documents, va_list args,
              GError **error)
{
  EggDesktopFileLaunchOption option;
  GSList *translated_documents = NULL, *docs = NULL;
  gchar *command, **argv;
  gint argc, i, screen_num;
  gboolean success, current_success;
  GdkDisplay *display;
  gchar *startup_id;

  GPtrArray   *env = NULL;
  gchar       **variables = NULL;
  GdkScreen   *screen = NULL;
  gint          workspace = -1;
  const gchar  *directory = NULL;
  guint32      launch_time = (guint32)-1;
  GSpawnFlags  flags = G_SPAWN_SEARCH_PATH;
  GSpawnChildSetupFunc setup_func = NULL;
  gpointer     setup_data = NULL;

  GPid        *ret_pid = NULL;
  gint         *ret_stdin = NULL, *ret_stdout = NULL, *ret_stderr = NULL;
  gchar       **ret_startup_id = NULL;

  if (documents && desktop_file->document_code == 0)
    {
      g_set_error (error, EGG_DESKTOP_FILE_ERROR,
           EGG_DESKTOP_FILE_ERROR_NOT_LAUNCHABLE,
           _("Application does not accept documents on command line"));
      return FALSE;
    }

  /* Read the options: technically it's incorrect for the caller to
   * NULL-terminate the list of options (rather than 0-terminating
   * it), but NULL-terminating lets us use G_GNUC_NULL_TERMINATED,
   * it's more consistent with other glib/gtk methods, and it will
   * work as long as sizeof (gint) <= sizeof (NULL), and NULL is
   * represented as 0. (Which is true everywhere we care about.)
   */
  while ((option = va_arg (args, EggDesktopFileLaunchOption)))
    {
      switch (option)
    {
    case EGG_DESKTOP_FILE_LAUNCH_CLEARENV:
      if (env)
        g_ptr_array_free (env, TRUE);
      env = g_ptr_array_new ();
      break;
    case EGG_DESKTOP_FILE_LAUNCH_PUTENV:
      variables = va_arg (args, gchar **);
      for (i = 0; variables[i]; i++)
        env = array_putenv (env, variables[i]);
      break;

    case EGG_DESKTOP_FILE_LAUNCH_SCREEN:
      screen = va_arg (args, GdkScreen *);
      break;
    case EGG_DESKTOP_FILE_LAUNCH_WORKSPACE:
      workspace = va_arg (args, gint);
      break;

    case EGG_DESKTOP_FILE_LAUNCH_DIRECTORY:
      directory = va_arg (args, const gchar *);
      break;
    case EGG_DESKTOP_FILE_LAUNCH_TIME:
      launch_time = va_arg (args, guint32);
      break;
    case EGG_DESKTOP_FILE_LAUNCH_FLAGS:
      flags |= va_arg (args, GSpawnFlags);
      /* Make sure they didn't set any flags that don't make sense. */
      flags &= ~G_SPAWN_FILE_AND_ARGV_ZERO;
      break;
    case EGG_DESKTOP_FILE_LAUNCH_SETUP_FUNC:
      setup_func = va_arg (args, GSpawnChildSetupFunc);
      setup_data = va_arg (args, gpointer);
      break;

    case EGG_DESKTOP_FILE_LAUNCH_RETURN_PID:
      ret_pid = va_arg (args, GPid *);
      break;
    case EGG_DESKTOP_FILE_LAUNCH_RETURN_STDIN_PIPE:
      ret_stdin = va_arg (args, gint *);
      break;
    case EGG_DESKTOP_FILE_LAUNCH_RETURN_STDOUT_PIPE:
      ret_stdout = va_arg (args, gint *);
      break;
    case EGG_DESKTOP_FILE_LAUNCH_RETURN_STDERR_PIPE:
      ret_stderr = va_arg (args, gint *);
      break;
    case EGG_DESKTOP_FILE_LAUNCH_RETURN_STARTUP_ID:
      ret_startup_id = va_arg (args, gchar **);
      break;

    default:
      g_set_error (error, EGG_DESKTOP_FILE_ERROR,
               EGG_DESKTOP_FILE_ERROR_UNRECOGNIZED_OPTION,
               _("Unrecognized launch option: %d"),
               GPOINTER_TO_INT (option));
      success = FALSE;
      goto out;
    }
    }

  if (screen)
    {
      gchar *display_name = gdk_screen_make_display_name (screen);
      gchar *display_env = g_strdup_printf ("DISPLAY=%s", display_name);
      env = array_putenv (env, display_env);
      g_free (display_name);
      g_free (display_env);

      display = gdk_screen_get_display (screen);
    }
  else
    {
      display = gdk_display_get_default ();
      screen = gdk_display_get_default_screen (display);
    }
  screen_num = gdk_screen_get_number (screen);

  translated_documents = translate_document_list (desktop_file, documents);
  docs = translated_documents;

  success = FALSE;

  do
    {
      command = parse_exec (desktop_file, &docs, error);
      if (!command)
    goto out;

      if (!g_shell_parse_argv (command, &argc, &argv, error))
    {
      g_free (command);
      goto out;
    }
      g_free (command);

#if GTK_CHECK_VERSION (2, 12, 0)
      startup_id = start_startup_notification (display, desktop_file,
                           argv[0], screen_num,
                           workspace, launch_time);
      if (startup_id)
    {
      gchar *startup_id_env = g_strdup_printf ("DESKTOP_STARTUP_ID=%s",
                          startup_id);
      env = array_putenv (env, startup_id_env);
      g_free (startup_id_env);
    }
#else
      startup_id = NULL;
#endif /* GTK 2.12 */

      if (env != NULL)
    g_ptr_array_add (env, NULL);

      current_success =
    g_spawn_async_with_pipes (directory,
                  argv,
                  env ? (gchar **)(env->pdata) : NULL,
                  flags,
                  setup_func, setup_data,
                  ret_pid,
                  ret_stdin, ret_stdout, ret_stderr,
                  error);
      g_strfreev (argv);

      if (startup_id)
    {
#if GTK_CHECK_VERSION (2, 12, 0)
      if (current_success)
        {
          set_startup_notification_timeout (display, startup_id);

          if (ret_startup_id)
        *ret_startup_id = startup_id;
          else
        g_free (startup_id);
        }
      else
#endif /* GTK 2.12 */
        g_free (startup_id);
    }
      else if (ret_startup_id)
    *ret_startup_id = NULL;

      if (current_success)
    {
      /* If we successfully launch any instances of the app, make
       * sure we return TRUE and don't set @error.
       */
      success = TRUE;
      error = NULL;

      /* Also, only set the output params on the first one */
      ret_pid = NULL;
      ret_stdin = ret_stdout = ret_stderr = NULL;
      ret_startup_id = NULL;
    }
    }
  while (docs && current_success);

 out:
  if (env)
    {
      g_ptr_array_foreach (env, (GFunc)g_free, NULL);
      g_ptr_array_free (env, TRUE);
    }
  free_document_list (translated_documents);

  return success;
}

/**
 * egg_desktop_file_launch:
 * @desktop_file: an #EggDesktopFile
 * @documents: a list of URIs or paths to documents to open
 * @error: error pointer
 * @...: additional options
 *
 * Launches @desktop_file with the given arguments. Additional options
 * can be specified as follows:
 *
 *   %EGG_DESKTOP_FILE_LAUNCH_CLEARENV: (no arguments)
 *       clears the environment in the child process
 *   %EGG_DESKTOP_FILE_LAUNCH_PUTENV: (gchar **variables)
 *       adds the NAME=VALUE strings in the given %NULL-terminated
 *       array to the child process's environment
 *   %EGG_DESKTOP_FILE_LAUNCH_SCREEN: (GdkScreen *screen)
 *       causes the application to be launched on the given screen
 *   %EGG_DESKTOP_FILE_LAUNCH_WORKSPACE: (gint workspace)
 *       causes the application to be launched on the given workspace
 *   %EGG_DESKTOP_FILE_LAUNCH_DIRECTORY: (gchar *dir)
 *       causes the application to be launched in the given directory
 *   %EGG_DESKTOP_FILE_LAUNCH_TIME: (guint32 launch_time)
 *       sets the "launch time" for the application. If the user
 *       interacts with another window after @launch_time but before
 *       the launched application creates its first window, the window
 *       manager may choose to not give focus to the new application.
 *       Passing 0 for @launch_time will explicitly request that the
 *       application not receive focus.
 *   %EGG_DESKTOP_FILE_LAUNCH_FLAGS (GSpawnFlags flags)
 *       Sets additional #GSpawnFlags to use. See g_spawn_async() for
 *       more details.
 *   %EGG_DESKTOP_FILE_LAUNCH_SETUP_FUNC (GSpawnChildSetupFunc, gpointer)
 *       Sets the child setup callback and the data to pass to it.
 *       (See g_spawn_async() for more details.)
 *
 *   %EGG_DESKTOP_FILE_LAUNCH_RETURN_PID (GPid **pid)
 *       On a successful launch, sets *@pid to the PID of the launched
 *       application.
 *   %EGG_DESKTOP_FILE_LAUNCH_RETURN_STARTUP_ID (gchar **startup_id)
 *       On a successful launch, sets *@startup_id to the Startup
 *       Notification "startup id" of the launched application.
 *   %EGG_DESKTOP_FILE_LAUNCH_RETURN_STDIN_PIPE (gint *fd)
 *       On a successful launch, sets *@fd to the file descriptor of
 *       a pipe connected to the application's stdin.
 *   %EGG_DESKTOP_FILE_LAUNCH_RETURN_STDOUT_PIPE (gint *fd)
 *       On a successful launch, sets *@fd to the file descriptor of
 *       a pipe connected to the application's stdout.
 *   %EGG_DESKTOP_FILE_LAUNCH_RETURN_STDERR_PIPE (gint *fd)
 *       On a successful launch, sets *@fd to the file descriptor of
 *       a pipe connected to the application's stderr.
 *
 * The options should be terminated with a single %NULL.
 *
 * If @documents contains multiple documents, but
 * egg_desktop_file_accepts_multiple() returns %FALSE for
 * @desktop_file, then egg_desktop_file_launch() will actually launch
 * multiple instances of the application. In that case, the return
 * value (as well as any values passed via
 * %EGG_DESKTOP_FILE_LAUNCH_RETURN_PID, etc) will only reflect the
 * first instance of the application that was launched (but the
 * %EGG_DESKTOP_FILE_LAUNCH_SETUP_FUNC will be called for each
 * instance).
 *
 * Return value: %TRUE if the application was successfully launched.
 **/
gboolean
egg_desktop_file_launch (EggDesktopFile *desktop_file,
             GSList *documents, GError **error,
             ...)
{
  va_list args;
  gboolean success;
  EggDesktopFile *app_desktop_file;

  switch (desktop_file->type)
    {
    case EGG_DESKTOP_FILE_TYPE_APPLICATION:
      va_start (args, error);
      success = egg_desktop_file_launchv (desktop_file, documents,
                      args, error);
      va_end (args);
      break;

    case EGG_DESKTOP_FILE_TYPE_LINK:
      if (documents)
    {
      g_set_error (error, EGG_DESKTOP_FILE_ERROR,
               EGG_DESKTOP_FILE_ERROR_NOT_LAUNCHABLE,
               _("Can't pass document URIs to a 'Type=Link' desktop entry"));
      return FALSE;
    }

      if (!parse_link (desktop_file, &app_desktop_file, &documents, error))
    return FALSE;

      va_start (args, error);
      success = egg_desktop_file_launchv (app_desktop_file, documents,
                      args, error);
      va_end (args);

      egg_desktop_file_free (app_desktop_file);
      free_document_list (documents);
      break;

    case EGG_DESKTOP_FILE_TYPE_UNRECOGNIZED:
    case EGG_DESKTOP_FILE_TYPE_DIRECTORY:
    default:
      g_set_error (error, EGG_DESKTOP_FILE_ERROR,
           EGG_DESKTOP_FILE_ERROR_NOT_LAUNCHABLE,
           _("Not a launchable item"));
      success = FALSE;
      break;
    }

  return success;
}

GQuark
egg_desktop_file_error_quark (void)
{
  return g_quark_from_static_string ("egg-desktop_file-error-quark");
}

G_LOCK_DEFINE_STATIC (egg_desktop_file);
static EggDesktopFile *egg_desktop_file;

static void
egg_set_desktop_file_internal (const gchar *desktop_file_path,
                               gboolean set_defaults)
{
  GError *error = NULL;

  G_LOCK (egg_desktop_file);
  if (egg_desktop_file)
    egg_desktop_file_free (egg_desktop_file);

  egg_desktop_file = egg_desktop_file_new (desktop_file_path, &error);
  if (error)
    {
      g_warning ("Could not load desktop file '%s': %s",
         desktop_file_path, error->message);
      g_error_free (error);
    }

  if (set_defaults && egg_desktop_file != NULL) {
    /* Set localized application name and default window icon */
    if (egg_desktop_file->name)
      g_set_application_name (egg_desktop_file->name);
    if (egg_desktop_file->icon)
      {
        if (g_path_is_absolute (egg_desktop_file->icon))
          gtk_window_set_default_icon_from_file (egg_desktop_file->icon, NULL);
        else
          gtk_window_set_default_icon_name (egg_desktop_file->icon);
      }
  }

  G_UNLOCK (egg_desktop_file);
}

/**
 * egg_set_desktop_file:
 * @desktop_file_path: path to the application's desktop file
 *
 * Creates an #EggDesktopFile for the application from the data at
 * @desktop_file_path. This will also call g_set_application_name()
 * with the localized application name from the desktop file, and
 * gtk_window_set_default_icon_name() or
 * gtk_window_set_default_icon_from_file() with the application's
 * icon. Other code may use additional information from the desktop
 * file.
 * See egg_set_desktop_file_without_defaults() for a variant of this
 * function that does not set the application name and default window
 * icon.
 *
 * Note that for thread safety reasons, this function can only
 * be called once, and is mutually exclusive with calling
 * egg_set_desktop_file_without_defaults().
 **/
void
egg_set_desktop_file (const gchar *desktop_file_path)
{
  egg_set_desktop_file_internal (desktop_file_path, TRUE);
}

/**
 * egg_set_desktop_file_without_defaults:
 * @desktop_file_path: path to the application's desktop file
 *
 * Creates an #EggDesktopFile for the application from the data at
 * @desktop_file_path.
 * See egg_set_desktop_file() for a variant of this function that
 * sets the application name and default window icon from the information
 * in the desktop file.
 *
 * Note that for thread safety reasons, this function can only
 * be called once, and is mutually exclusive with calling
 * egg_set_desktop_file().
 **/
void
egg_set_desktop_file_without_defaults (const gchar *desktop_file_path)
{
  egg_set_desktop_file_internal (desktop_file_path, FALSE);
}

/**
 * egg_get_desktop_file:
 *
 * Gets the application's #EggDesktopFile, as set by
 * egg_set_desktop_file().
 *
 * Return value: the #EggDesktopFile, or %NULL if it hasn't been set.
 **/
EggDesktopFile *
egg_get_desktop_file (void)
{
  EggDesktopFile *retval;

  G_LOCK (egg_desktop_file);
  retval = egg_desktop_file;
  G_UNLOCK (egg_desktop_file);

  return retval;
}