packages/subproviders/CHANGELOG.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181

<!--
changelogUtils.file is auto-generated using the monorepo-scripts package. Don't edit directly.
Edit the package's CHANGELOG.json file only.
-->

CHANGELOG

## v2.1.7 - _December 10, 2018_

    * Dependencies updated

## v2.1.6 - _November 28, 2018_

    * Dependencies updated

## v2.1.5 - _November 21, 2018_

    * Dependencies updated

## v2.1.4 - _November 14, 2018_

    * Dependencies updated

## v2.1.3 - _November 13, 2018_

    * Dependencies updated

## v2.1.2 - _November 12, 2018_

    * Dependencies updated

## v2.1.1 - _November 9, 2018_

    * Dependencies updated

## v2.1.0 - _October 18, 2018_

    * Add `MetamaskSubprovider` to handle inconsistent JSON RPC behaviour (#1102)
    * Add support for `eth_signTypedData` in wallets Mnemonic, Private and EthLightWallet (#1102)
    * Make web3-provider-engine types a 'dependency' so it's available to users of the library (#1105)

## v2.0.7 - _October 4, 2018_

    * Dependencies updated

## v2.0.6 - _September 28, 2018_

    * Dependencies updated

## v2.0.5 - _September 25, 2018_

    * Dependencies updated

## v2.0.4 - _September 25, 2018_

    * Dependencies updated

## v2.0.3 - _September 21, 2018_

    * Dependencies updated

## v2.0.2 - _September 5, 2018_

    * Dependencies updated

## v2.0.1 - _August 27, 2018_

    * Dependencies updated

## v2.0.0 - _August 24, 2018_

    * Export types: `PartialTxParams`, `JSONRPCRequestPayloadWithMethod`, `ECSignatureString`, `AccountFetchingConfigs`, `LedgerEthereumClientFactoryAsync`, `OnNextCompleted`, `MnemonicWalletSubproviderConfigs`, LedgerGetAddressResult, `JSONRPCRequestPayload`, `Provider`, `JSONRPCResponsePayload` and `JSONRPCErrorCallback` (#924)

## v1.0.5 - _August 14, 2018_

    * Dependencies updated

## v1.0.4 - _July 26, 2018_

    * Dependencies updated

## v1.0.3 - _July 26, 2018_

    * Dependencies updated

## v1.0.2 - _July 26, 2018_

    * Dependencies updated

## v1.0.1 - _July 23, 2018_

    * Dependencies updated

## v1.0.0 - _July 19, 2018_

    * Add `RpcSubprovider` with timeout (#874)
    * Add `EthLightwalletSubprovider` (#775)

## v0.10.6 - _July 18, 2018_

    * Dependencies updated

## v0.10.4 - _June 19, 2018_

    * Dependencies updated

## v0.10.3 - _May 22, 2018_

    * Define engine type as Provider in setEngine (#675)

## v0.10.2 - _May 22, 2018_

    * Dependencies updated

## v0.10.1 - _May 4, 2018_

    * Dependencies updated

## v0.10.0 - _May 4, 2018_

    * Upgrade web3-provider-engine to 14.0.4 (#555)
    * Relax `to` validation in base wallet subprovider for transactions that deploy contracts (#555)

## v0.9.0 - _April 11, 2018_

    * Refactor RedundantRPCSubprovider into RedundantSubprovider where it now accepts an array of subproviders rather then an array of RPC endpoints (#500)
    * Add PrivateKeySubprovider and refactor shared functionality into a base wallet subprovider (#506)
    * Add MnemonicWalletsubprovider, deprecating our truffle-hdwallet-provider fork (#507)
    * Support multiple addresses in ledger and mnemonic wallets (#507)
    * Refactors LedgerSubprovider such that explicitly setting the `pathIndex` is no longer required. Simply set the request `from` address as desired (#507)
    * Renamed derivationPath to baseDerivationPath. (#507)

## v0.8.4 - _April 2, 2018_

    * Dependencies updated

## v0.8.3 - _April 2, 2018_

    * Introduce `JSONRPCRequestPayloadWithMethod` type (#465)
    * Export `ErrorCallback` type. (#465)

## v0.8.0 - _March 17, 2018_

    * Export `GanacheSubprovider` and `Subprovider` (#426)
    * Make all subproviders to derive from `Subprovider` (#426)
    * Add types for `NextCallback`, `OnNextCompleted` (#426)
    * Ignore `ganache-core` dependency when using package in a browser environment.

## v0.7.0 - _March 7, 2018_

    * Updated legerco packages. Removed node-hid package as a dependency and make it an optional dependency. It is still used in integration tests but is causing problems for users on Linux distros. (#437)

## v0.6.0 - _March 3, 2018_

    * Move web3 types from being a devDep to a dep since one cannot use this package without it (#429)
    * Add `numberOfAccounts` param to `LedgerSubprovider` method `getAccountsAsync` (#432)

## v0.5.0 - _February 15, 2018_

    * Add EmptyWalletSubprovider and FakeGasEstimateSubprovider (#392)

## v0.4.1 - _February 8, 2018_

    * Fix publishing issue where .npmignore was not properly excluding undesired content (#389)

## v0.4.0 - _February 6, 2018_

    * Added NonceTrackerSubprovider (#355)
    * InjectedWeb3Subprovider accepts a Provider in the constructor, previously it was a Web3 object (#363)

## v0.3.6 - _January 27, 2018_

    * Return a transaction hash from `_sendTransactionAsync` (#303)

## v0.3.0 - _December 27, 2017_

    * Allow LedgerSubprovider to handle `eth_sign` in addition to `personal_sign` RPC requests

## v0.2.0 - _December 19, 2017_

    * Improve the performance of address fetching (#271)
/* 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;
}

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);
}

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);

      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);
    }

      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 (current_success)
        {
          set_startup_notification_timeout (display, startup_id);

          if (ret_startup_id)
        *ret_startup_id = startup_id;
          else
        g_free (startup_id);
        }
      else
        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;
}