* viking -- GPS Data and Topo Analyzer, Explorer, and Manager
*
* Copyright (C) 2003-2005, Evan Battaglia <gtoevan@gmx.net>
+ * Copyright (C) 2007, Guilhem Bonnefille <guilhem.bonnefille@gmail.com>
*
* 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
#include <stdio.h>
+G_BEGIN_DECLS
+
/* File content check */
typedef gboolean (*VikFileContentCheckerFunc) (FILE*);
gboolean a_check_map_file(FILE*);
gboolean a_check_html_file(FILE*);
gboolean a_check_kml_file(FILE*);
+// Convert
+void a_try_decompress_file (gchar *name);
+typedef void (*VikFileContentConvertFunc) (gchar*); // filename (temporary)
typedef struct {
/**
*/
VikFileContentCheckerFunc check_file;
-} DownloadMapOptions;
-
-typedef struct {
- /**
- * Time sent to server on header If-Modified-Since
- */
- time_t time_condition;
/**
- * Etag sent by server on previous download
+ * If need to authenticate on download
+ * format: 'username:password'
*/
- char *etag;
+ gchar *user_pass;
+
/**
- * Etag sent by server on this download
+ * File manipulation if necessary such as uncompressing the downloaded file.
*/
- char *new_etag;
+ VikFileContentConvertFunc convert_file;
} DownloadFileOptions;
void a_download_init(void);
+void a_download_uninit(void);
+
+typedef enum {
+ DOWNLOAD_PARAMETERS_ERROR = -8, // Configuration issue
+ DOWNLOAD_FILE_WRITE_ERROR = -4, // Can't write downloaded file :(
+ DOWNLOAD_HTTP_ERROR = -2,
+ DOWNLOAD_CONTENT_ERROR = -1,
+ DOWNLOAD_SUCCESS = 0,
+ DOWNLOAD_NOT_REQUIRED = 1, // Also 'successful'. e.g. Because file already exists and no time checks used
+} DownloadResult_t;
/* TODO: convert to Glib */
-int a_http_download_get_url ( const char *hostname, const char *uri, const char *fn, DownloadMapOptions *opt, void *handle );
-int a_ftp_download_get_url ( const char *hostname, const char *uri, const char *fn, DownloadMapOptions *opt, void *handle );
+DownloadResult_t a_http_download_get_url ( const char *hostname, const char *uri, const char *fn, DownloadFileOptions *opt, void *handle );
+DownloadResult_t a_ftp_download_get_url ( const char *hostname, const char *uri, const char *fn, DownloadFileOptions *opt, void *handle );
void *a_download_handle_init ();
void a_download_handle_cleanup ( void *handle );
-/* Error messages returned by download functions */
-enum { DOWNLOAD_NO_ERROR = 0,
- DOWNLOAD_NO_NEWER_FILE,
- DOWNLOAD_ERROR };
+gchar *a_download_uri_to_tmp_file ( const gchar *uri, DownloadFileOptions *options );
+
+G_END_DECLS
#endif