/* vim: set sw=2 ts=2 sts=2 et: */ /* -*- Mode: C; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* * ephy-download.c * This file is part of Epiphany * * Copyright © 2011 - Igalia S.L. * * Epiphany 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 of the License, or * (at your option) any later version. * * Epiphany 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 Epiphany; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, * Boston, MA 02110-1301 USA */ #include "config.h" #include "ephy-debug.h" #include "ephy-download.h" #include "ephy-embed.h" #include "ephy-embed-shell.h" #include "ephy-embed-type-builtins.h" #include "ephy-file-helpers.h" #include "ephy-prefs.h" #include "ephy-settings.h" #include #include #include #include G_DEFINE_TYPE (EphyDownload, ephy_download, G_TYPE_OBJECT) #define EPHY_DOWNLOAD_GET_PRIVATE(o) \ (G_TYPE_INSTANCE_GET_PRIVATE ((o), EPHY_TYPE_DOWNLOAD, EphyDownloadPrivate)) struct _EphyDownloadPrivate { WebKitDownload *download; char *destination; char *source; EphyDownloadActionType action; guint32 start_time; GtkWidget *window; GtkWidget *widget; }; enum { PROP_0, PROP_DOWNLOAD, PROP_DESTINATION, PROP_SOURCE, PROP_ACTION, PROP_START_TIME, PROP_WINDOW, PROP_WIDGET }; static void ephy_download_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec) { EphyDownload *download; EphyDownloadPrivate *priv; download = EPHY_DOWNLOAD (object); priv = download->priv; switch (property_id) { case PROP_WIDGET: g_value_set_object (value, priv->widget); break; case PROP_WINDOW: g_value_set_object (value, priv->window); break; case PROP_DOWNLOAD: g_value_set_object (value, ephy_download_get_webkit_download (download)); break; case PROP_DESTINATION: g_value_set_string (value, ephy_download_get_destination_uri (download)); break; case PROP_SOURCE: g_value_set_string (value, ephy_download_get_source_uri (download)); break; case PROP_ACTION: g_value_set_enum (value, ephy_download_get_action (download)); break; case PROP_START_TIME: g_value_set_uint (value, ephy_download_get_start_time (download)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec); break; } } static void ephy_download_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec) { EphyDownload *download; download = EPHY_DOWNLOAD (object); switch (property_id) { case PROP_DESTINATION: ephy_download_set_destination_uri (download, g_value_get_string (value)); break; case PROP_ACTION: ephy_download_set_action (download, g_value_get_enum (value)); break; case PROP_WINDOW: ephy_download_set_window (download, g_value_get_object (value)); break; case PROP_WIDGET: ephy_download_set_widget (download, g_value_get_object (value)); break; case PROP_DOWNLOAD: case PROP_SOURCE: case PROP_START_TIME: default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec); break; } } /** * ephy_download_get_content_type: * @download: an #EphyDownload * * Gets content-type information for @download. If the file is already * present on the filesystem and readable, uses GIO to get the * content-type. Otherwise it uses WebKit and Soup. * * Returns: content-type for @download, must be freed with g_free() **/ char * ephy_download_get_content_type (EphyDownload *download) { WebKitNetworkResponse *response; SoupMessage *message; char *content_type = NULL; GFile *destination; GFileInfo *info; GError *error = NULL; destination = g_file_new_for_uri (download->priv->destination); info = g_file_query_info (destination, G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE, G_FILE_QUERY_INFO_NONE, NULL, &error); if (error) { LOG ("ephy_download_get_content_type: error getting file " "content-type: %s", error->message); g_error_free (error); /* Fallback to Soup */ response = webkit_download_get_network_response (download->priv->download); message = webkit_network_response_get_message (response); if (message != NULL) content_type = g_strdup (soup_message_headers_get_content_type (message->response_headers, NULL)); LOG ("ephy_download_get_content_type: Soup: %s", content_type); } else { content_type = g_strdup (g_file_info_get_content_type (info)); LOG ("ephy_download_get_content_type: GIO: %s", content_type); } if (info) g_object_unref (info); if (destination) g_object_unref (destination); LOG ("ephy_download_get_content_type: %s", content_type); return content_type; } static EphyDownloadActionType decide_action_from_mime (EphyDownload *ephy_download) { WebKitNetworkResponse *response; SoupMessage *message; char *mime_description = NULL; GAppInfo *helper_app = NULL; EphyDownloadActionType action; WebKitDownload *download; download = ephy_download_get_webkit_download (ephy_download); response = webkit_download_get_network_response (download); message = webkit_network_response_get_message (response); if (message) { char *content_type = ephy_download_get_content_type (ephy_download); if (content_type) { mime_description = g_content_type_get_description (content_type); helper_app = g_app_info_get_default_for_type (content_type, FALSE); if (helper_app) action = EPHY_DOWNLOAD_ACTION_OPEN; g_free (content_type); } } if (mime_description == NULL) { mime_description = g_strdup (C_("file type", "Unknown")); action = EPHY_DOWNLOAD_ACTION_BROWSE_TO; } /* Sometimes downloads can have a mime_description but a NULL helper_app * in that case action is never changed so DOWNLOAD_ACTION_DOWNLOAD remains * as action value. This is the same response value as Save as... * button, which is wrong for the Download button. */ if (helper_app == NULL) action = EPHY_DOWNLOAD_ACTION_BROWSE_TO; return action; } /* From the old embed/mozilla/MozDownload.cpp */ static const char* file_is_compressed (const char *filename) { int i; static const char * const compression[] = {".gz", ".bz2", ".Z", ".lz", NULL}; for (i = 0; compression[i] != NULL; i++) { if (g_str_has_suffix (filename, compression[i])) return compression[i]; } return NULL; } static const char* parse_extension (const char *filename) { const char *compression; const char *last_separator; compression = file_is_compressed (filename); /* if the file is compressed we might have a double extension */ if (compression != NULL) { int i; static const char * const extensions[] = {"tar", "ps", "xcf", "dvi", "txt", "text", NULL}; for (i = 0; extensions[i] != NULL; i++) { char *suffix; suffix = g_strdup_printf (".%s%s", extensions[i], compression); if (g_str_has_suffix (filename, suffix)) { char *p; p = g_strrstr (filename, suffix); g_free (suffix); return p; } g_free (suffix); } } /* no compression, just look for the last dot in the filename */ last_separator = strrchr (filename, G_DIR_SEPARATOR); return strrchr ((last_separator) ? last_separator : filename, '.'); } static char * define_destination_uri (EphyDownload *download) { char *dest_dir; char *dest_name; char *destination_filename; char *destination_uri; const char *suggested_filename; suggested_filename = webkit_download_get_suggested_filename (download->priv->download); dest_dir = ephy_file_get_downloads_dir (); /* Make sure the download directory exists */ if (g_mkdir_with_parents (dest_dir, 0700) == -1) { g_critical ("Could not create downloads directory \"%s\": %s", dest_dir, strerror (errno)); g_free (dest_dir); return NULL; } if (suggested_filename != NULL) { dest_name = g_strdup (suggested_filename); } else { dest_name = ephy_file_tmp_filename ("ephy-download-XXXXXX", NULL); } destination_filename = g_build_filename (dest_dir, dest_name, NULL); g_free (dest_dir); g_free (dest_name); /* Append (n) as needed. */ if (g_file_test (destination_filename, G_FILE_TEST_EXISTS)) { int i = 1; const char *dot_pos; gssize position; char *serial = NULL; GString *tmp_filename; dot_pos = parse_extension (destination_filename); if (dot_pos) position = dot_pos - destination_filename; else position = strlen (destination_filename); tmp_filename = g_string_new (NULL); do { serial = g_strdup_printf ("(%d)", i++); g_string_assign (tmp_filename, destination_filename); g_string_insert (tmp_filename, position, serial); g_free (serial); } while (g_file_test (tmp_filename->str, G_FILE_TEST_EXISTS)); destination_filename = g_strdup (tmp_filename->str); g_string_free (tmp_filename, TRUE); } destination_uri = g_filename_to_uri (destination_filename, NULL, NULL); g_free (destination_filename); g_assert (destination_uri); return destination_uri; } /** * ephy_download_set_destination_uri: * @download: an #EphyDownload * @destination: URI where to save @download * * Sets the destination URI of @download. It must be a proper URI, with a * scheme like file:/// or similar. **/ void ephy_download_set_destination_uri (EphyDownload *download, const char *destination) { EphyDownloadPrivate *priv; char *scheme; g_return_if_fail (EPHY_IS_DOWNLOAD (download)); g_return_if_fail (destination != NULL); priv = download->priv; scheme = g_uri_parse_scheme (destination); g_return_if_fail (scheme != NULL); g_free (scheme); priv->destination = g_strdup (destination); webkit_download_set_destination_uri (priv->download, priv->destination); g_object_notify (G_OBJECT (download), "destination"); } /** * ephy_download_set_auto_destination: * @download: an #EphyDownload * * Tells @download to automatically determine a destination for itself. **/ void ephy_download_set_auto_destination (EphyDownload *download) { char *dest; g_return_if_fail (EPHY_IS_DOWNLOAD (download)); dest = define_destination_uri (download); ephy_download_set_destination_uri (download, dest); g_free (dest); } /** * ephy_download_set_action: * @download: an #EphyDownload * @action: #EphyDownloadActionType to execute * * Sets the @action to be executed when ephy_download_do_download_action () is * called on @download or on finish when "Automatically download and open * files" is set. **/ void ephy_download_set_action (EphyDownload *download, EphyDownloadActionType action) { g_return_if_fail (EPHY_IS_DOWNLOAD (download)); download->priv->action = action; g_object_notify (G_OBJECT (download), "action"); } /** * ephy_download_set_window: * @download: an #EphyDownload * @window: #GtkWidget that produced @download * * Sets @window to be @download's parent, this means that @download will be * shown on @window's #EphyWindow (where it is contained). **/ void ephy_download_set_window (EphyDownload *download, GtkWidget *window) { g_return_if_fail (EPHY_IS_DOWNLOAD (download)); if (download->priv->window != NULL) g_object_unref (download->priv->window); download->priv->window = NULL; if (window != NULL) download->priv->window = g_object_ref (window); g_object_notify (G_OBJECT (download), "window"); } /** * ephy_download_set_widget: * @download: an #EphyDownload * @widget: a #GtkWidget * * Sets @widget to be associated with @download as its UI. **/ void ephy_download_set_widget (EphyDownload *download, GtkWidget *widget) { g_return_if_fail (EPHY_IS_DOWNLOAD (download)); if (download->priv->widget != NULL) g_object_unref (download->priv->widget); download->priv->widget = NULL; if (widget != NULL) download->priv->widget = g_object_ref (widget); g_object_notify (G_OBJECT (download), "widget"); } /** * ephy_download_get_widget: * @download: an #EphyDownload * * Gets the #GtkWidget associated to this download. * * Returns: (transfer none): a #GtkWidget. **/ GtkWidget * ephy_download_get_widget (EphyDownload *download) { g_return_val_if_fail (EPHY_IS_DOWNLOAD (download), NULL); return download->priv->widget; } /** * ephy_download_get_webkit_download: * @download: an #EphyDownload * * Gets the #WebKitDownload being wrapped by @download. * * Returns: (transfer none): a #WebKitDownload. **/ WebKitDownload * ephy_download_get_webkit_download (EphyDownload *download) { g_return_val_if_fail (EPHY_IS_DOWNLOAD (download), NULL); return download->priv->download; } /** * ephy_download_get_window: * @download: an #EphyDownload * * Gets the window set as the parent of @download, this can be NULL if no * specific window generated this download. * * Returns: (transfer none): a #GtkWidget **/ GtkWidget * ephy_download_get_window (EphyDownload *download) { g_return_val_if_fail (EPHY_IS_DOWNLOAD (download), NULL); return download->priv->window; } /** * ephy_download_get_destination_uri: * @download: an #EphyDownload * * Gets the destination URI where the download is being saved. * * Returns: (transfer none): destination URI. **/ const char * ephy_download_get_destination_uri (EphyDownload *download) { g_return_val_if_fail (EPHY_IS_DOWNLOAD (download), NULL); return download->priv->destination; } /** * ephy_download_get_source_uri: * @download: an #EphyDownload * * Gets the source URI that this download is/will download. * * Returns: source URI. **/ const char * ephy_download_get_source_uri (EphyDownload *download) { g_return_val_if_fail (EPHY_IS_DOWNLOAD (download), NULL); return download->priv->source; } /** * ephy_download_get_action: * @download: an #EphyDownload * * Gets the #EphyDownloadActionType that this download will execute when * ephy_download_do_download_action () is called on it. This action is * performed automatically is "Automatically download and open files" is * enabled. * * Returns: the #EphyDownloadActionType to be executed **/ EphyDownloadActionType ephy_download_get_action (EphyDownload *download) { g_return_val_if_fail (EPHY_IS_DOWNLOAD (download), EPHY_DOWNLOAD_ACTION_NONE); return download->priv->action; } /** * ephy_download_get_start_time: * @download: an #EphyDownload * * Gets the time (returned by gtk_get_current_event_time ()) when @download was * started with ephy_download_start (). Defaults to 0. * * Returns: the time when @download was started. **/ guint32 ephy_download_get_start_time (EphyDownload *download) { g_return_val_if_fail (EPHY_IS_DOWNLOAD (download), 0); return download->priv->start_time; } /** * ephy_download_start: * @download: an #EphyDownload * * Starts the wrapped #WebKitDownload. **/ void ephy_download_start (EphyDownload *download) { EphyDownloadPrivate *priv; g_return_if_fail (EPHY_IS_DOWNLOAD (download)); priv = download->priv; priv->start_time = gtk_get_current_event_time (); if (priv->destination == NULL) ephy_download_set_auto_destination (download); webkit_download_start (priv->download); } /** * ephy_download_cancel: * @download: an #EphyDownload * * Cancels the wrapped #WebKitDownload. **/ void ephy_download_cancel (EphyDownload *download) { g_return_if_fail (EPHY_IS_DOWNLOAD (download)); webkit_download_cancel (download->priv->download); } /** * ephy_download_do_download_action: * @download: an #EphyDownload * @action: one of #EphyDownloadActionType * * Executes the given @action for @download, this can be any of * #EphyDownloadActionType, including #EPHY_DOWNLOAD_ACTION_AUTO which decides * the default action from the mime type of @download. * * Returns: %TRUE if the action was executed succesfully. * **/ gboolean ephy_download_do_download_action (EphyDownload *download, EphyDownloadActionType action) { GFile *destination; const char *destination_uri; EphyDownloadPrivate *priv; gboolean ret = FALSE; priv = download->priv; destination_uri = webkit_download_get_destination_uri (priv->download); destination = g_file_new_for_uri (destination_uri); switch ((action ? action : priv->action)) { case EPHY_DOWNLOAD_ACTION_AUTO: LOG ("ephy_download_do_download_action: auto"); ret = ephy_download_do_download_action (download, decide_action_from_mime (download)); break; case EPHY_DOWNLOAD_ACTION_BROWSE_TO: LOG ("ephy_download_do_download_action: browse_to"); ret = ephy_file_browse_to (destination, priv->start_time); break; case EPHY_DOWNLOAD_ACTION_OPEN: LOG ("ephy_download_do_download_action: open"); ret = ephy_file_launch_handler (NULL, destination, priv->start_time); break; case EPHY_DOWNLOAD_ACTION_NONE: LOG ("ephy_download_do_download_action: none"); ret = TRUE; break; default: LOG ("ephy_download_do_download_action: unhandled action"); ret = FALSE; break; } g_object_unref (destination); return ret; } static void ephy_download_dispose (GObject *object) { EphyDownload *download = EPHY_DOWNLOAD (object); EphyDownloadPrivate *priv; LOG ("EphyDownload disposed %p", object); priv = download->priv; if (priv->download) { g_object_unref (priv->download); priv->download = NULL; } if (priv->window) { g_object_unref (priv->window); priv->window = NULL; } if (priv->widget) { g_object_unref (priv->widget); priv->widget = NULL; } ephy_embed_shell_remove_download (embed_shell, download); G_OBJECT_CLASS (ephy_download_parent_class)->dispose (object); } static void ephy_download_finalize (GObject *object) { EphyDownload *download = EPHY_DOWNLOAD (object); EphyDownloadPrivate *priv; priv = download->priv; g_free (priv->destination); g_free (priv->source); LOG ("EphyDownload finalised %p", object); G_OBJECT_CLASS (ephy_download_parent_class)->finalize (object); } static void ephy_download_class_init (EphyDownloadClass *klass) { GObjectClass *object_class = G_OBJECT_CLASS (klass); g_type_class_add_private (klass, sizeof (EphyDownloadPrivate)); object_class->get_property = ephy_download_get_property; object_class->set_property = ephy_download_set_property; object_class->dispose = ephy_download_dispose; object_class->finalize = ephy_download_finalize; /** * EphyDownload::download: * * Internal WebKitDownload. */ g_object_class_install_property (object_class, PROP_DOWNLOAD, g_param_spec_object ("download", "Internal WebKitDownload", "The WebKitDownload used internally by EphyDownload", WEBKIT_TYPE_DOWNLOAD, G_PARAM_READABLE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB)); /** * EphyDownload::destination: * * The destination URI where to store the download. */ g_object_class_install_property (object_class, PROP_DESTINATION, g_param_spec_string ("destination", "Destination", "Destination file URI", NULL, G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB)); /** * EphyDownload::source: * * Download's origin URI */ g_object_class_install_property (object_class, PROP_SOURCE, g_param_spec_string ("source", "Source", "Source URI", NULL, G_PARAM_READABLE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB)); /** * EphyDownload::action: * * Action to take when the download finishes and "Automatically download and * open files" is enabled, or when ephy_download_do_download_action () is * called. */ g_object_class_install_property (object_class, PROP_ACTION, g_param_spec_enum ("action", "Download action", "Action to take when download finishes", EPHY_TYPE_DOWNLOAD_ACTION_TYPE, EPHY_DOWNLOAD_ACTION_NONE, G_PARAM_READABLE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB)); /** * EphyDownload::start-time: * * User time when the download started, useful for launching applications * aware of focus stealing. */ g_object_class_install_property (object_class, PROP_START_TIME, g_param_spec_uint ("start-time", "Event start time", "Time for focus-stealing prevention.", 0, G_MAXUINT32, 0, G_PARAM_READABLE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB)); /** * EphyDownload::window: * * Window that produced the download, the download will be shown in its * parent window. */ g_object_class_install_property (object_class, PROP_WINDOW, g_param_spec_object ("window", "A GtkWindow", "Window that produced this download.", GTK_TYPE_WIDGET, G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB)); /** * EphyDownload::widget: * * An EphyDownloadWidget -or any other GtkWidget- that is representing this * EphyDownload to the user. */ g_object_class_install_property (object_class, PROP_WIDGET, g_param_spec_object ("widget", "A GtkWidget", "GtkWidget showing this download.", GTK_TYPE_WIDGET, G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_STATIC_NICK | G_PARAM_STATIC_BLURB)); /** * EphyDownload::completed: * * The ::completed signal is emitted when @download has finished downloading. **/ g_signal_new ("completed", G_OBJECT_CLASS_TYPE (object_class), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (EphyDownloadClass, completed), NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * EphyDownload::error: * * The ::error signal wraps the @download ::error signal. **/ g_signal_new ("error", G_OBJECT_CLASS_TYPE (object_class), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (EphyDownloadClass, error), NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 0); } static void ephy_download_init (EphyDownload *download) { download->priv = EPHY_DOWNLOAD_GET_PRIVATE (download); LOG ("EphyDownload initialising %p", download); download->priv->download = NULL; download->priv->destination = NULL; download->priv->action = EPHY_DOWNLOAD_ACTION_NONE; download->priv->start_time = 0; download->priv->window = NULL; download->priv->widget = NULL; } static void download_status_changed_cb (GObject *object, GParamSpec *pspec, EphyDownload *download) { WebKitDownloadStatus status; EphyDownloadPrivate *priv; priv = download->priv; status = webkit_download_get_status (priv->download); if (status == WEBKIT_DOWNLOAD_STATUS_FINISHED) { g_signal_emit_by_name (download, "completed"); if (g_settings_get_boolean (EPHY_SETTINGS_MAIN, EPHY_PREFS_AUTO_DOWNLOADS)) { ephy_download_do_download_action (download, EPHY_DOWNLOAD_ACTION_AUTO); } else { ephy_download_do_download_action (download, EPHY_DOWNLOAD_ACTION_NONE); } ephy_embed_shell_remove_download (embed_shell, download); } else if (status == WEBKIT_DOWNLOAD_STATUS_CANCELLED || status == WEBKIT_DOWNLOAD_STATUS_ERROR) { } else if (status == WEBKIT_DOWNLOAD_STATUS_STARTED) { ephy_embed_shell_add_download (embed_shell, download); } } static gboolean download_error_cb (WebKitDownload *download, gint error_code, gint error_detail, char *reason, gpointer user_data) { EphyDownload *ephy_download; gboolean ret = FALSE; ephy_download = EPHY_DOWNLOAD (user_data); LOG ("error (%d - %d)! %s", error_code, error_detail, reason); g_signal_emit_by_name (ephy_download, "error", error_code, error_detail, reason, &ret); return ret; } /** * ephy_download_new: * * Creates a new #EphyDownload. You can use ephy_download_new_for_download and * ephy_download_new_for_uri as convenience functions to create #EphyDownload * objects. * * Returns: an #EphyDownload. **/ EphyDownload * ephy_download_new (void) { return g_object_new (EPHY_TYPE_DOWNLOAD, NULL); } static EphyDownload * _ephy_download_new (WebKitDownload *webkit_download, const char *uri) { EphyDownload *ephy_download; ephy_download = ephy_download_new (); if (webkit_download == NULL) { WebKitNetworkRequest *request; request = webkit_network_request_new (uri); webkit_download = webkit_download_new (request); g_return_val_if_fail (webkit_download != NULL, NULL); g_object_unref (request); } g_signal_connect (webkit_download, "notify::status", G_CALLBACK (download_status_changed_cb), ephy_download); g_signal_connect (webkit_download, "error", G_CALLBACK (download_error_cb), ephy_download); ephy_download->priv->download = g_object_ref (webkit_download); ephy_download->priv->source = g_strdup (webkit_download_get_uri (webkit_download)); return ephy_download; } /** * ephy_download_new_for_download: * @download: a #WebKitDownload to wrap * * Wraps @download in an #EphyDownload. * * Returns: an #EphyDownload. **/ EphyDownload * ephy_download_new_for_download (WebKitDownload *download) { g_return_val_if_fail (WEBKIT_IS_DOWNLOAD (download), NULL); return _ephy_download_new (download, NULL); } /** * ephy_download_new_for_uri: * @uri: a source URI from where to download * * Creates an #EphyDownload to download @uri. * * Returns: an #EphyDownload. **/ EphyDownload * ephy_download_new_for_uri (const char *uri) { g_return_val_if_fail (uri != NULL, NULL); return _ephy_download_new (NULL, uri); }