recognise model/* mime type
[claws.git] / src / procmime.h
index c628d212e256cec722e3468dcc08960fbf25baea..ac734471a69e4d974d606e192dc56b9afd64a26d 100644 (file)
@@ -1,10 +1,10 @@
 /*
  * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
- * Copyright (C) 1999-2001 Hiroyuki Yamamoto
+ * Copyright (C) 1999-2012 Hiroyuki Yamamoto and the Claws Mail team
  *
  * 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 of the License, or
+ * the Free Software Foundation; either version 3 of the License, or
  * (at your option) any later version.
  *
  * This program is distributed in the hope that it will be useful,
  * 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ * 
  */
 
 #ifndef __PROCMIME_H__
 #define __PROCMIME_H__
 
 #ifdef HAVE_CONFIG_H
-#  include "config.h"
+#include "claws-features.h"
 #endif
 
-typedef struct _MimeType       MimeType;
-typedef struct _MimeInfo       MimeInfo;
+#include <gio/gio.h>
 
+#include "utils.h"
+#include "proctypes.h"
 typedef enum
 {
        ENC_7BIT,
@@ -47,7 +48,8 @@ typedef enum
        MIMETYPE_APPLICATION,
        MIMETYPE_MESSAGE,
        MIMETYPE_MULTIPART,
-       MIMETYPE_UNKNOWN,
+       MIMETYPE_MODEL,
+       MIMETYPE_UNKNOWN
 } MimeMediaType;
 
 typedef enum
@@ -57,11 +59,17 @@ typedef enum
        DISPOSITIONTYPE_UNKNOWN
 } DispositionType;
 
+typedef enum
+{
+       MIMECONTENT_EMPTY,
+       MIMECONTENT_FILE,               /* the file contains all content including sub parts */
+       MIMECONTENT_MEM
+} MimeContent;
+
 #include <glib.h>
 #include <stdio.h>
 
-#include "procmsg.h"
-#include "privacy.h"
+struct _PrivacyData;
 
 struct _MimeType
 {
@@ -71,6 +79,14 @@ struct _MimeType
        gchar *extension;
 };
 
+struct _MimeParser
+{
+       MimeMediaType type;
+       const gchar *sub_type;
+
+       gboolean (*parse)(MimeParser *parser, MimeInfo *mimeinfo);
+};
+
 /*
  * An example of MimeInfo structure:
  *
@@ -94,8 +110,13 @@ struct _MimeType
 struct _MimeInfo
 {
        /* Internal data */
-       gchar *filename;
-       gboolean tmpfile;
+       MimeContent content;
+       union
+       {
+               gchar *filename;
+               gchar *mem;
+       } data;
+       gboolean tmp;
 
        GNode *node;
 
@@ -104,7 +125,7 @@ struct _MimeInfo
        MimeMediaType    type;
        gchar           *subtype;
 
-       GHashTable      *parameters;
+       GHashTable      *typeparameters;
 
        /* Content-Transfer-Encoding */
        EncodingType     encoding_type;
@@ -115,14 +136,20 @@ struct _MimeInfo
        /* Content-ID */
        gchar           *id;
 
+       /* Content-Location */
+       gchar           *location;
+
        guint            offset;
        guint            length;
 
        /* Content-Disposition */
        DispositionType  disposition;
+       GHashTable      *dispositionparameters;
 
        /* Privacy */
-       PrivacyData     *privacy;
+       struct _PrivacyData     *privacy;
+
+       gboolean         broken;
 };
 
 #define IS_BOUNDARY(s, bnd, len) \
@@ -135,7 +162,7 @@ extern "C" {
 /* MimeInfo handling */
 
 MimeInfo *procmime_mimeinfo_new                (void);
-void procmime_mimeinfo_free_all                (MimeInfo       *mimeinfo);
+void procmime_mimeinfo_free_all                (MimeInfo       **mimeinfo_ptr);
 
 MimeInfo *procmime_mimeinfo_insert     (MimeInfo       *parent,
                                         MimeInfo       *mimeinfo);
@@ -146,6 +173,7 @@ MimeInfo *procmime_mimeinfo_parent  (MimeInfo       *mimeinfo);
 MimeInfo *procmime_mimeinfo_next       (MimeInfo       *mimeinfo);
 
 MimeInfo *procmime_scan_message                (MsgInfo        *msginfo);
+MimeInfo *procmime_scan_message_short  (MsgInfo        *msginfo);
 void procmime_scan_multipart_message   (MimeInfo       *mimeinfo,
                                         FILE           *fp);
 const gchar *procmime_mimeinfo_get_parameter
@@ -167,37 +195,56 @@ void procmime_scan_subject              (MimeInfo       *mimeinfo,
 MimeInfo *procmime_scan_mime_header    (FILE           *fp);
 
 gboolean procmime_decode_content       (MimeInfo       *mimeinfo);
+gboolean procmime_encode_content       (MimeInfo       *mimeinfo, EncodingType encoding);
 gint procmime_get_part                 (const gchar    *outfile,
                                         MimeInfo       *mimeinfo);
-FILE *procmime_get_text_content                (MimeInfo       *mimeinfo);
 FILE *procmime_get_first_text_content  (MsgInfo        *msginfo);
-
-gboolean procmime_find_string_part     (MimeInfo       *mimeinfo,
-                                        const gchar    *filename,
-                                        const gchar    *str,
-                                        gboolean        case_sens);
-gboolean procmime_find_string          (MsgInfo        *msginfo,
-                                        const gchar    *str,
-                                        gboolean        case_sens);
+FILE *procmime_get_first_encrypted_text_content
+                                       (MsgInfo        *msginfo);
 
 gchar *procmime_get_tmp_file_name      (MimeInfo       *mimeinfo);
+gchar *procmime_get_part_file_name     (MimeInfo       *mimeinfo);
 
 gchar *procmime_get_mime_type          (const gchar    *filename);
 
 GList *procmime_get_mime_type_list     (void);
 
 EncodingType procmime_get_encoding_for_charset (const gchar    *charset);
-EncodingType procmime_get_encoding_for_file    (const gchar    *file);
+EncodingType procmime_get_encoding_for_text_file(const gchar   *file,
+                                                gboolean       *has_binary);
 const gchar *procmime_get_encoding_str         (EncodingType    encoding);
-MimeInfo *procmime_scan_file                   (gchar          *filename);
-MimeInfo *procmime_scan_queue_file             (gchar          *filename);
-const gchar *procmime_get_type_str             (MimeMediaType   type);
-gchar *procmime_get_content_type_str           (MimeMediaType   type,
-                                                const char     *subtype);
+MimeInfo *procmime_scan_file                   (const gchar    *filename);
+MimeInfo *procmime_scan_queue_file             (const gchar    *filename);
+const gchar *procmime_get_media_type_str       (MimeMediaType   type);
+MimeMediaType procmime_get_media_type          (const gchar    *str);
+gchar *procmime_get_content_type_str           (MimeMediaType   type,
+                                                const gchar    *subtype);
 void procmime_force_charset                    (const gchar    *str);
 void procmime_force_encoding                   (EncodingType    encoding);
+gboolean procmime_msginfo_is_encrypted         (MsgInfo        *msginfo);
+int procmime_write_mime_header                 (MimeInfo       *mimeinfo, 
+                                                FILE           *fp);
 void renderer_read_config(void);
-void renderer_write_config(void);
+
+gint procmime_write_mimeinfo(MimeInfo *mimeinfo, FILE *fp);
+
+void procmime_mimeparser_register(MimeParser *mimeparser);
+void procmime_mimeparser_unregister(MimeParser *mimeparser);
+FILE *procmime_get_text_content(MimeInfo *mimeinfo);
+FILE *procmime_get_binary_content(MimeInfo *mimeinfo);
+
+/* scans mimeinfo contents, calling scan_callback() once per line.
+ * return TRUE and scan is aborted if scan_callback returns TRUE.
+ * return TRUE on error.
+ * return FALSE if scan completed and scan_callback never returned TRUE.
+ */
+gboolean procmime_scan_text_content(MimeInfo *mimeinfo,
+               gboolean (*scan_callback)(const gchar *str, gpointer cb_data),
+               gpointer cb_data);
+void *procmime_get_part_as_string(MimeInfo *mimeinfo,
+               gboolean null_terminate);
+GInputStream *procmime_get_part_as_inputstream(MimeInfo *mimeinfo,
+               GError **error);
 
 #ifdef __cplusplus
 }