aboutsummaryrefslogblamecommitdiffstats
path: root/lib/ephy-file-helpers.c
blob: a55d453893e4fa34106e8727274c0e834247db14 (plain) (tree)
1
2
3
4
5
6
                                                                           
  


                                                  
                                 












                                                                        
                                                                                  
  

   
                   

                              
                       
                       
                               
                          
                        
 


                                
                 
                       
                    
                             
                   
                   
                     
                   
 







                                                                              


                          
                                
                                     
 
                                       
                            

                                 
                                           
 

                                     






                                                                      
            
                        





                                   
                                                                            
                                                             
                                                                             
                                                    
                   
                                              


                                





                                           



                       
 












                                                                              
   

                               









                                                                        


                                                                              
      

                                  
                           
 

                                                                             
 
                                                  
                                                        


                                                         
 
                            

 






                                                                          
      

                            
                                    
 


                                                                            
 

                                                                            

 

                          
                                                                       

                                                       

                                                                       
  




                                                                    
    
      





                                              
                              







                              

                              














                                                    







                                                                    



                                
                
 
                                           
         
                         
                                    
                                          
                                          

                              
                                    
                                   







                                                    
                                                  









                                                                              
                                                    



                    


                

                                                                    


                                                               


                   


                       
   













                                                                        

                                                       
                                                     




                                                                              
                                                                     
    
        
                                                
                                                   
                                       
 
                            
                                 
                                         
 

                                                                                               
                                                  


                                                                
 
                                                            
                                                                    
                                                                       
 
                                                                               



                                                 



                                                 



                                                                                              



                                                                 

                                                       


            
                                                                     

                                                       
                                          
         

                                                    




                                                                      
                                                                                   

































                                                                                                                      

 








                                      




                                                                            




                                     





                                                          

                               
                                                       



                                                  


                         

                            
                                    
                 








                                                                       

                 


                                 

 










                                                                           
        
                                        
                                       
 
                                                    
                                                   
         
                                   



                                                                                           
 

                             
 
                                                   
         

















                                                                                                  
         

                    
 


                                           



                                            
 




                                         
         
                                                      
                 

                                             

                                                                                     
                                                                               
                                                  
                         
                                                      
                         

                                                                                     

                         

                                  


         









                                                                 

                                 

                                  




                                                                  
 
   





                                                                             
    
                                      
 
                              
 











                                                                     
                                                           























                                                                            
                                                                                                  


                                                               
                                                                                                         


                                                                 
                                                                         


                                      
                                                                                           
                                                              
                                                                           







                                                 








                                                                          
























                                                                               
 












                                                                              
        



                                                
 
                                     

                            
                     
 
                   
         

                                                          
         
            
         

                                                     
         

                                                               







                                                                       

 


                                           
                                                                            







                                                                            

                                                    
                                                     

                                                 
 
                             
                           

                           
 
                                                




                                                       


                                                                                       

                                      
                   

 


                                                                
 
                             
 
                                                        


                              

                                                                 


            


                                     
                                                                    


                                                                                      

                                      







                                                                             

                                                                        
                                                                            
                 
                              

         

























                                                                              

                        




                                                                                
         
 

                   
 










                                                                          
        
                                 

                                       
                                                                             

 
   


                                      

                                                            

                                     
    

                                                                   
 

                                         
                             



                                                                              
                                      


















                                                                              
                                                                 

                                      
                                       




                                                                           
         










                                                        
 





                                      






                                      

                               













                                                       












                                                                         


                                                              



































                                                                                            




















                                                                               
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
 *  Copyright © 2002 Jorn Baayen
 *  Copyright © 2003, 2004 Marco Pesenti Gritti
 *  Copyright © 2004, 2005, 2006 Christian Persch
 *  Copyright © 2012 Igalia S.L.
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2, or (at your option)
 *  any later version.
 *
 *  This program 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 General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 */

#include "config.h"
#include "ephy-file-helpers.h"

#include "ephy-debug.h"
#include "ephy-prefs.h"
#include "ephy-profile-utils.h"
#include "ephy-settings.h"
#include "ephy-string.h"

#include <gdk/gdk.h>
#include <gio/gdesktopappinfo.h>
#include <gio/gio.h>
#include <glib.h>
#include <glib/gi18n.h>
#include <gtk/gtk.h>
#include <libxml/xmlreader.h>
#include <stdlib.h>
#include <string.h>
#include <sys/stat.h>
#include <unistd.h>

/**
 * SECTION:ephy-file-helpers
 * @short_description: miscellaneous file related utility functions
 *
 * File related functions, including functions to launch, browse or move files
 * atomically.
 */

#define DELAY_MAX_TICKS 64
#define INITIAL_TICKS   2

static GHashTable *files = NULL;
static GHashTable *mime_table = NULL;

static gboolean keep_directory = FALSE;
static char *dot_dir = NULL;
static char *tmp_dir = NULL;
static GList *del_on_exit = NULL;
static gboolean is_default_dot_dir = FALSE;

GQuark ephy_file_helpers_error_quark;

/**
 * ephy_file_tmp_dir:
 *
 * Returns the name of the temp dir for the running Epiphany instance.
 *
 * Returns: the name of the temp dir, this string belongs to Epiphany.
 **/
const char *
ephy_file_tmp_dir (void)
{
    if (tmp_dir == NULL)
    {
        char *partial_name;
        char *full_name;

        partial_name = g_strconcat ("epiphany-", g_get_user_name (),
                        "-XXXXXX", NULL);
        full_name = g_build_filename (g_get_tmp_dir (), partial_name,
                          NULL);
#ifdef HAVE_MKDTEMP
        tmp_dir = mkdtemp (full_name);
#else
#error no mkdtemp implementation
#endif
        g_free (partial_name);

        if (tmp_dir == NULL)
        {
            g_free (full_name);
        }
    }

    return tmp_dir;
}

static char *
ephy_file_download_dir (void)
{
    const char *xdg_download_dir;

    xdg_download_dir = g_get_user_special_dir (G_USER_DIRECTORY_DOWNLOAD);
    if (xdg_download_dir != NULL)
        return g_strdup (xdg_download_dir);

    /* If we don't have XDG user dirs info, return an educated guess. */
    return g_build_filename (g_get_home_dir (), _("Downloads"), NULL);
}

/**
 * ephy_file_get_downloads_dir:
 *
 * Returns a proper downloads destination by checking the
 * EPHY_PREFS_STATE_DOWNLOAD_DIR GSettings key and following this logic:
 *
 *  - An absolute path: considered user-set, use this value directly.
 *
 *  - "Desktop" keyword in GSettings: the directory returned by
 *    ephy_file_desktop_dir().
 *
 *  - "Downloads" keyword in GSettings, or any other value: the XDG
 *  downloads directory, or ~/Downloads.
 *
 * Returns: a newly-allocated string containing the path to the downloads dir.
 **/
char *
ephy_file_get_downloads_dir (void)
{
    char *download_dir;

    download_dir = g_settings_get_string (EPHY_SETTINGS_STATE,
                          EPHY_PREFS_STATE_DOWNLOAD_DIR);

    if (g_str_equal (download_dir, "Desktop"))
        download_dir = ephy_file_desktop_dir ();
    if (g_str_equal (download_dir, "Downloads") ||
        g_path_is_absolute (download_dir) != TRUE)
        download_dir = ephy_file_download_dir ();

    return download_dir;
}

/**
 * ephy_file_desktop_dir:
 *
 * Gets the XDG desktop dir path or a default homedir/Desktop alternative.
 *
 * Returns: a newly-allocated string containing the desktop dir path.
 **/
char *
ephy_file_desktop_dir (void)
{
    const char *xdg_desktop_dir;

    xdg_desktop_dir = g_get_user_special_dir (G_USER_DIRECTORY_DESKTOP);
    if (xdg_desktop_dir != NULL)
        return g_strdup (xdg_desktop_dir);

    /* If we don't have XDG user dirs info, return an educated guess. */
    return g_build_filename (g_get_home_dir (), _("Desktop"), NULL);
}

/**
 * ephy_file_tmp_filename:
 * @base: the base name of the temp file to create, containing "XXXXXX"
 * @extension: an optional extension for @base or %NULL
 *
 * Gets a usable temp filename with g_mkstemp() using @base as the name
 * with an optional @extension. @base should contain "XXXXXX" in it.
 *
 * Notice that this does not create the file. It only gets a valid
 * filename.
 *
 * Returns: a newly-allocated string containing the name of the temp
 * file name or %NULL.
 **/
char *
ephy_file_tmp_filename (const char *base,
            const char *extension)
{
    int fd;
    char *name = g_strdup (base);

    fd = g_mkstemp (name);

    if (fd != -1)
    {
        unlink (name);
        close (fd);
    }
    else
    {
        g_free (name);

        return NULL;
    }

    if (extension)
    {
        char *tmp;
        tmp = g_strconcat (name, ".",
                   extension, NULL);
        g_free (name);
        name = tmp;
    }

    return name;
}

/**
 * ephy_file:
 * @filename: the name of the Epiphany file requested
 *
 * Looks for @filename in Epiphany's directories and relevant paths.
 *
 * Returns: the full path to the requested file
 **/
const char *
ephy_file (const char *filename)
{
    char *ret;
    guint i;

    static const char * const paths[] =
    {
#ifdef GNOME_ENABLE_DEBUG
        TOP_SRC_DATADIR "/",
        TOP_SRC_DATADIR "/icons/",
        TOP_SRC_DATADIR "/pages/",
#endif
        SHARE_DIR "/",
        SHARE_DIR "/icons/",
        SHARE_DIR "/pages/"
    };

    g_assert (files != NULL);

    ret = g_hash_table_lookup (files, filename);
    if (ret != NULL)
        return ret;

    for (i = 0; i < G_N_ELEMENTS (paths); i++)
    {
        ret = g_strconcat (paths[i], filename, NULL);
        if (g_file_test (ret, G_FILE_TEST_EXISTS) == TRUE)
        {
            g_hash_table_insert (files, g_strdup (filename), ret);
            return (const char *) ret;
        }
        g_free (ret);
    }

    g_warning ("Failed to find %s\n", filename);

    return NULL;
}

/**
 * ephy_dot_dir:
 *
 * Gets Epiphany's configuration directory, usually .config/epiphany
 * under user's homedir.
 *
 * Returns: the full path to Epiphany's configuration directory
 **/
const char *
ephy_dot_dir (void)
{
    return dot_dir;
}

/**
 * ephy_dot_dir_is_default:
 *
 * Returns whether the dot directory in use is the default one, found in
 * ~/.config
 *
 * Returns: %TRUE if it is the default dot dir, %FALSE for others
 **/
gboolean
ephy_dot_dir_is_default (void)
{
    return is_default_dot_dir;
}

/**
 * ephy_file_helpers_init:
 * @profile_dir: directory to use as Epiphany's profile
 * @flags: the %EphyFileHelpersFlags for this session
 * @error: an optional #GError
 *
 * Initializes Epiphany file helper functions, sets @profile_dir as Epiphany's
 * profile dir and whether the running session will be private.
 *
 * Returns: %FALSE if the profile dir couldn't be created or accessed
 **/
gboolean
ephy_file_helpers_init (const char *profile_dir,
            EphyFileHelpersFlags flags,
            GError **error)
{
    gboolean ret = TRUE;
    gboolean private_profile;
    gboolean steal_data_from_profile;

    ephy_file_helpers_error_quark = g_quark_from_static_string ("ephy-file-helpers-error");

    files = g_hash_table_new_full (g_str_hash,
                       g_str_equal,
                       (GDestroyNotify) g_free,
                       (GDestroyNotify) g_free);

    keep_directory = flags & EPHY_FILE_HELPERS_KEEP_DIR;
    private_profile = flags & EPHY_FILE_HELPERS_PRIVATE_PROFILE;
    steal_data_from_profile = flags & EPHY_FILE_HELPERS_STEAL_DATA;

    if (private_profile && profile_dir != NULL && !steal_data_from_profile)
    {
        dot_dir = g_strdup (profile_dir);
    }
    else if (private_profile)
    {
        if (ephy_file_tmp_dir () == NULL)
        {
            g_set_error (error,
                     EPHY_FILE_HELPERS_ERROR_QUARK,
                     0,
                     _("Could not create a temporary directory in “%s”."),
                     g_get_tmp_dir ());
            return FALSE;
        }

        dot_dir = g_build_filename (ephy_file_tmp_dir (),
                        "epiphany",
                        NULL);
    }
    else
    {
        dot_dir = g_build_filename (g_get_user_config_dir (),
                        "epiphany",
                        NULL);
        is_default_dot_dir = TRUE;
    }

    if (flags & EPHY_FILE_HELPERS_ENSURE_EXISTS)
        ret = ephy_ensure_dir_exists (ephy_dot_dir (), error);

    if (steal_data_from_profile && profile_dir)
    {
        int i;
        char *files_to_copy[] = { EPHY_HISTORY_FILE, EPHY_BOOKMARKS_FILE };
        
        for (i = 0; i < G_N_ELEMENTS (files_to_copy); i++)
        {
            char *filename;
            GError *error = NULL;
            GFile *source, *destination;

            filename = g_build_filename (profile_dir,
                             files_to_copy[i],
                             NULL);
            source = g_file_new_for_path (filename);
            g_free (filename);
            
            filename = g_build_filename (dot_dir,
                             files_to_copy[i],
                             NULL);
            destination = g_file_new_for_path (filename);
            g_free (filename);

            g_file_copy (source, destination,
                     G_FILE_COPY_OVERWRITE,
                     NULL, NULL, NULL, &error);
            if (error)
            {
                printf("Error stealing file %s from profile: %s\n", files_to_copy[i], error->message);
                g_error_free (error);
            }
                
            g_object_unref (source);
            g_object_unref (destination);
        }
    }

    return ret;
}

static void
delete_files (GList *l)
{
    for (; l != NULL; l = l->next)
    {
        unlink (l->data);
    }
}

/**
 * ephy_file_helpers_shutdown:
 *
 * Cleans file helpers information, corresponds to ephy_file_helpers_init().
 **/
void
ephy_file_helpers_shutdown (void)
{
    g_hash_table_destroy (files);

    del_on_exit = g_list_reverse (del_on_exit);
    delete_files (del_on_exit);
    g_list_foreach (del_on_exit, (GFunc)g_free, NULL);
    g_list_free (del_on_exit);
    del_on_exit = NULL;

    if (mime_table != NULL)
    {
        LOG ("Destroying mime type hashtable");
        g_hash_table_destroy (mime_table);
        mime_table = NULL;
    }

    g_free (dot_dir);
    dot_dir = NULL;

    if (tmp_dir != NULL)
    {
        if (!keep_directory)
        {
            GFile *tmp_dir_file;
            tmp_dir_file = g_file_new_for_path (tmp_dir);

            /* recursively delete the contents and the
             * directory */
            LOG ("shutdown: delete tmp_dir %s", tmp_dir);
            ephy_file_delete_dir_recursively (tmp_dir_file,
                              NULL);
            g_object_unref (tmp_dir_file);
        }

        g_free (tmp_dir);
        tmp_dir = NULL;
    }
}

/**
 * ephy_ensure_dir_exists:
 * @dir: path to a directory
 * @error: an optional GError to fill or %NULL
 *
 * Checks if @dir exists and is a directory, if it it exists and it's not a
 * directory %FALSE is returned. If @dir doesn't exist and can't be created
 * then %FALSE is returned.
 *
 * Returns: %TRUE if @dir exists and is a directory
 **/
gboolean
ephy_ensure_dir_exists (const char *dir,
                GError **error)
{
    if (g_file_test (dir, G_FILE_TEST_EXISTS) &&
        !g_file_test (dir, G_FILE_TEST_IS_DIR))
    {
        g_set_error (error,
                 EPHY_FILE_HELPERS_ERROR_QUARK,
                 0,
                 _("The file “%s” exists. Please move it out of the way."),
                 dir);

        return FALSE;
    }

    if (!g_file_test (dir, G_FILE_TEST_EXISTS))
    {
        if (g_mkdir_with_parents (dir, 488) == 0)
        {
            /* We need to set the .migrated file to the
             * current profile migration version,
             * otherwise the next time the browser runs
             * things might go awry. */
            ephy_profile_utils_set_migration_version (EPHY_PROFILE_MIGRATION_VERSION);
        }
        else
        {
            g_set_error (error,
                     EPHY_FILE_HELPERS_ERROR_QUARK,
                     0,
                     _("Failed to create directory “%s”."),
                     dir);

            return FALSE;
        }
    }

    return TRUE;
}

static void
ephy_find_file_recursive (const char *path,
              const char *fname,
              GSList **list,
              gint depth,
              gint maxdepth)
{
    GDir *dir;
    const gchar *file;

    dir = g_dir_open (path, 0, NULL);
    if (dir != NULL)
    {
        while ((file = g_dir_read_name (dir)))
        {
            if (depth < maxdepth)
            {
                char *new_path = g_build_filename (path, file, NULL);
                ephy_find_file_recursive (new_path, fname, list,
                              depth + 1, maxdepth);
                g_free (new_path);
            }
            if (strcmp (file, fname) == 0)
            {
                char *new_path = g_build_filename (path, file, NULL);
                *list = g_slist_prepend (*list, new_path);
            }
        }

        g_dir_close (dir);
    }
}

/**
 * ephy_file_find:
 * @path: path to search for @fname
 * @fname: filename to search for
 * @maxdepth: maximum directory depth when searching @path
 *
 * Searchs for @fname in @path with a maximum depth of @maxdepth.
 *
 * Returns: a GSList of matches
 **/
GSList *
ephy_file_find (const char *path,
            const char *fname,
            gint maxdepth)
{
    GSList *ret = NULL;
    ephy_find_file_recursive (path, fname, &ret, 0, maxdepth);
    return ret;
}

/**
 * ephy_file_delete_on_exit:
 * @file: a #GFile
 *
 * Schedules @file to be deleted when Epiphany exits. This function currently
 * does nothing.
 **/
void
ephy_file_delete_on_exit (GFile *file)
{
    /* does nothing now */
}

static void
load_mime_from_xml (void)
{
    xmlTextReaderPtr reader;
    const char *xml_file;
    int ret;
    EphyMimePermission permission = EPHY_MIME_PERMISSION_UNKNOWN;

    g_return_if_fail (mime_table == NULL);

    mime_table = g_hash_table_new_full (g_str_hash, g_str_equal,
                        xmlFree, NULL);

    xml_file = ephy_file ("mime-types-permissions.xml");
    if (xml_file == NULL)
    {
        g_warning ("MIME types permissions file not found!\n");
        return;
    }

    reader = xmlNewTextReaderFilename (xml_file);
    if (reader == NULL)
    {
        g_warning ("Could not load MIME types permissions file!\n");
        return;
    }

    ret = xmlTextReaderRead (reader);
    while (ret == 1)
    {
        const xmlChar *tag;
        xmlReaderTypes type;

        tag = xmlTextReaderConstName (reader);
        type = xmlTextReaderNodeType (reader);

        if (xmlStrEqual (tag, (const xmlChar *)"safe") && type == XML_READER_TYPE_ELEMENT)
        {
            permission = EPHY_MIME_PERMISSION_SAFE;
        }
        else if (xmlStrEqual (tag, (const xmlChar *)"unsafe") && type == XML_READER_TYPE_ELEMENT)
        {
            permission = EPHY_MIME_PERMISSION_UNSAFE;
        }
        else if (xmlStrEqual (tag, (const xmlChar *)"mime-type"))
        {
            xmlChar *type;

            type = xmlTextReaderGetAttribute (reader, (const xmlChar *)"type");
            g_hash_table_insert (mime_table, type,
                         GINT_TO_POINTER (permission));
        }

        ret = xmlTextReaderRead (reader);
    }

    xmlFreeTextReader (reader);
}

/**
 * ephy_file_check_mime:
 * @mime_type: a mime type
 *
 * Checks @mime_type against our safe/unsafe database of types, returns an
 * #EphyMimePermission.
 *
 * Returns: an #EphyMimePermission
 **/
EphyMimePermission
ephy_file_check_mime (const char *mime_type)
{
    EphyMimePermission permission;
    gpointer tmp;

    g_return_val_if_fail (mime_type != NULL, EPHY_MIME_PERMISSION_UNKNOWN);

    if (mime_table == NULL)
    {
        load_mime_from_xml ();
    }

    tmp = g_hash_table_lookup (mime_table, mime_type);
    if (tmp == NULL)
    {
        permission = EPHY_MIME_PERMISSION_UNKNOWN;
    }
    else
    {
        permission = GPOINTER_TO_INT (tmp);
    }

    return permission;
}

/**
 * ephy_file_launch_application:
 * @app: the application to launch
 * @files: files to pass to @app
 * @user_time: user time to prevent focus stealing
 * @widget: a relevant widget from where to get the #GdkScreen and #GdkDisplay
 *
 * Launches @app to open @files. If @widget is set the screen and display from
 * it will be used to launch the application, otherwise the defaults will be
 * used.
 *
 * Returns: %TRUE if g_app_info_launch() succeeded
 **/
gboolean
ephy_file_launch_application (GAppInfo *app,
                  GList *files,
                  guint32 user_time,
                  GtkWidget *widget)
{
    GdkAppLaunchContext *context;
    GdkDisplay *display;
    GdkScreen *screen;
    gboolean res;

    if (widget)
    {
        display = gtk_widget_get_display (widget);
        screen = gtk_widget_get_screen (widget);
    }
    else
    {
        display = gdk_display_get_default ();
        screen = gdk_screen_get_default ();
    }

    context = gdk_display_get_app_launch_context (display);
    gdk_app_launch_context_set_screen (context, screen);
    gdk_app_launch_context_set_timestamp (context, user_time);

    res = g_app_info_launch (app, files,
                 G_APP_LAUNCH_CONTEXT (context), NULL);
    g_object_unref (context);

    return res;
}

/**
 * ephy_file_launch_desktop_file:
 * @filename: the path to the .desktop file
 * @parameter: path to an optional parameter file to pass to the application
 * @user_time: user time to prevent focus stealing
 * @widget: an optional widget for ephy_file_launch_application()
 *
 * Calls ephy_file_launch_application() for the application described by the
 * .desktop file @filename. Can pass @parameter as optional file arguments.
 *
 * Returns: %TRUE if the application launch was successful
 **/
gboolean
ephy_file_launch_desktop_file (const char *filename,
                   const char *parameter,
                   guint32 user_time,
                   GtkWidget *widget)
{
    GDesktopAppInfo *app;
    GFile *file = NULL;
    GList *list = NULL;
    gboolean ret;

    app = g_desktop_app_info_new (filename);
    if (parameter)
    {
        file = g_file_new_for_path (parameter);
        list = g_list_append (list, file);
    }
    
    ret = ephy_file_launch_application (G_APP_INFO (app), list, user_time, widget);
    g_list_free (list);
    if (file)
        g_object_unref (file);
    return ret;
}

GAppInfo *
ephy_file_launcher_get_app_info_for_file (GFile *file,
                      const char *mime_type)
{
    GAppInfo *app = NULL;

    g_return_val_if_fail (file || mime_type, FALSE);

    if (mime_type != NULL)
    {
        app = g_app_info_get_default_for_type (mime_type,
                               FALSE);
    }
    else
    {
        GFileInfo *file_info;
        char *type;

        /* Sniff mime type and check if it's safe to open */
        file_info = g_file_query_info (file,
                           G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE,
                           0, NULL, NULL);
        if (file_info == NULL)
        {
            return FALSE;
        }
        type = g_strdup (g_file_info_get_content_type (file_info));
        
        g_object_unref (file_info);

        if (type != NULL && type[0] != '\0' &&
            ephy_file_check_mime (type) == EPHY_MIME_PERMISSION_SAFE)
        {
            /* FIXME rename tmp file to right extension ? */
            app = g_app_info_get_default_for_type (type, FALSE);
        }
        g_free (type);
    }

    return app;
}

/**
 * ephy_file_launch_handler:
 * @mime_type: the mime type of @file or %NULL
 * @file: a #GFile to pass as argument
 * @user_time: user time to prevent focus stealing
 *
 * Launches @file with its default handler application, if @mime_type is %NULL
 * then @file will be queried for its type.
 *
 * Returns: %TRUE on success
 **/
gboolean
ephy_file_launch_handler (const char *mime_type,
              GFile *file,
              guint32 user_time)
{
    GAppInfo *app = NULL;
    gboolean ret = FALSE;

    g_return_val_if_fail (file != NULL, FALSE);

    app = ephy_file_launcher_get_app_info_for_file (file, mime_type);

    if (app != NULL)
    {
        GList *list = NULL;
        
        list = g_list_append (list, file);
        ret = ephy_file_launch_application (app, list, user_time, NULL);
        g_list_free (list);
    }

    return ret;
}

/**
 * ephy_file_browse_to:
 * @file: a #GFile
 * @user_time: user_time to prevent focus stealing
 *
 * Launches the default application for browsing directories, with @file's
 * parent directory as its target. Passes @user_time to
 * ephy_file_launch_handler() to prevent focus stealing.
 *
 * Returns: %TRUE if the launch succeeded
 **/
gboolean
ephy_file_browse_to (GFile *file,
             guint32 user_time)
{
    return ephy_file_launch_handler ("inode/directory", file, user_time);
}

/**
 * ephy_file_delete_dir_recursively:
 * @directory: directory to remove
 * @error: location to set any #GError
 *
 * Remove @path and its contents. Like calling rm -rf @path.
 *
 * Returns: %TRUE if delete succeeded
 **/
gboolean
ephy_file_delete_dir_recursively (GFile *directory, GError **error)
{
    GFileEnumerator *children = NULL;
    GFileInfo *info;
    gboolean ret = FALSE;

    children = g_file_enumerate_children (directory,
                          "standard::name,standard::type",
                          0, NULL, error);
    if (children == NULL || error)
        goto out;

    info = g_file_enumerator_next_file (children, NULL, error);
    while (info || error) {
        GFile *child;
        const char *name;
        GFileType type;

        if (error)
            goto out;

        name = g_file_info_get_name (info);
        child = g_file_get_child (directory, name);
        type = g_file_info_get_file_type (info);

        LOG ("ephy-file-delete-dir: delete child %s", name);
        if (type == G_FILE_TYPE_DIRECTORY)
            ret = ephy_file_delete_dir_recursively (child, error);
        else if (type == G_FILE_TYPE_REGULAR)
            ret = g_file_delete (child, NULL, error);

        g_object_unref (info);
        g_object_unref (child);

        if (!ret)
            goto out;

        info = g_file_enumerator_next_file (children, NULL, error);
    }

    ret = TRUE;

    LOG ("ephy-file-delete-dir: delete successful");
    g_file_delete (directory, NULL, error);

out:
    if (children)
        g_object_unref (children);

    return ret;
}

/**
 * ephy_file_delete_uri
 * @uri: URI of the file to be deleted
 *
 * Remove the given URI.
 */
void
ephy_file_delete_uri (const char *uri)
{
    GFile *file;
    gboolean ret;

    g_return_if_fail (uri);

    file = g_file_new_for_uri (uri);

    ret = g_file_delete (file, NULL, NULL);

    if (ret == TRUE)
    {
        LOG ("Deleted file at URI '%s'", uri);
    }
    else
    {
        LOG ("Couldn't file at URI '%s'", uri);
    }
    g_object_unref (file);
}

/**
 * ephy_file_create_data_uri_for_filename:
 * @filename: the filename of a local path
 * @mime_type: the MIME type of the filename, or %NULL
 *
 * Create a data uri using the contents of @filename.
 * If @mime_type is %NULL, the %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE
 * attribute of @filename will be used.
 *
 * Returns: a new allocated string containg the data uri, or %NULL if the
 *   data uri could not be created
 */
char *
ephy_file_create_data_uri_for_filename (const char *filename,
                    const char *mime_type)
{
    gchar *data;
    gsize data_length;
    gchar *base64;
    gchar *uri = NULL;
    GFileInfo *file_info = NULL;

    g_return_val_if_fail (filename != NULL, NULL);

    if (!g_file_get_contents (filename, &data, &data_length, NULL))
        return NULL;

    base64 = g_base64_encode ((const guchar *)data, data_length);
    g_free (data);

    if (!mime_type) {
        GFile *file;

        file = g_file_new_for_path (filename);
        file_info = g_file_query_info (file, G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE,
                           G_FILE_QUERY_INFO_NONE, NULL, NULL);
        if (file_info)
            mime_type = g_file_info_get_content_type (file_info);

        g_object_unref (file);
    }

    if (mime_type)
        uri = g_strdup_printf ("data:%s;charset=utf8;base64,%s", mime_type, base64);
    g_free(base64);

    if (file_info)
        g_object_unref (file_info);

    return uri;
}

/**
 * ephy_sanitize_filename:
 * @filename: a filename
 *
 * Sanitize @filename to make sure it's a valid filename. If the
 * filename contains directory separators, they will be converted to
 * underscores, so that they are not interpreted as a path by the
 * filesystem.
 *
 * Note that it modifies string in place. The return value is to allow nesting.
 *
 * Returns: the sanitized filename
 */
char *
ephy_sanitize_filename (char *filename)
{
    g_return_val_if_fail (filename != NULL, NULL);

    return g_strdelimit (filename, G_DIR_SEPARATOR_S, '_');
}