G_BEGIN_DECLS
+typedef struct
+{
+ guint local_size;
+ guint msg_count;
+ guint folders;
+} ModestFolderStats;
+
/**
* modest_tny_account_new_from_account:
* @account_mgr: a valid account mgr instance
* @forget_pass_func: the forget-password function
*
* get a tnyaccount corresponding to the server_accounts (store or transport) for this account.
- * NOTE: this function does not set the camel session or the get/forget password functions
*
* Returns: a new TnyAccount or NULL in case of error.
*/
/**
+ * modest_tny_account_update_from_account:
+ * @tny_account: a valid tny_account
+ *
+ * update a tnyaccount corresponding to the server_accounts (store or transport) for this account.
+ *
+ * Returns: a TRUE or FALSE in case of error.
+ */
+gboolean
+modest_tny_account_update_from_account (TnyAccount *tny_account,
+ TnyGetPassFunc get_pass_func,
+ TnyForgetPassFunc forget_pass_func);
+
+
+/**
* modest_tny_account_new_for_local_folders:
* @account_mgr: a valid account mgr instance
* @session: a tny camel session
+ * @location_filepath: The location at which the local-folders directory exists, or NULL to specify $HOME.
*
* get the local folders (pseudo) account; you should only need one such account.
*
* Returns: a new local folders TnyAccount or NULL in case of error.
*/
TnyAccount* modest_tny_account_new_for_local_folders (ModestAccountMgr *account_mgr,
- TnySessionCamel *session);
+ TnySessionCamel *session,
+ const gchar* location_filepath);
/**
* modest_tny_account_new_for_per_account_local_outbox_folder:
/**
* modest_tny_account_new_from_server_account_name:
* @account_mgr: a valid account mgr instance
+ * @session: a valid TnySessionCamel instance.
* @server_account_name: the name of a server account in the configuration system.
*
* Returns: a new TnyAccount or NULL in case of error.
*/
TnyAccount*
modest_tny_account_new_from_server_account_name (ModestAccountMgr *account_mgr,
- const gchar* server_account_name);
-
+ TnySessionCamel *session,
+ const gchar* server_account_name,
+ TnyGetPassFunc get_pass_func,
+ TnyForgetPassFunc forget_pass_func);
+
/**
* modest_tny_account_get_special_folder:
* @self: a TnyAccount
* such as (for example) server-side Sent/Junk mail for IMAP accounts
*
* Returns: the tny folder corresponding to this special folder, or NULL in case
- * of error, or if the special folder does not exist for this account
+ * of error, or if the special folder does not exist for this account.
+ * This must be unrefed with g_object_unref().
*/
TnyFolder* modest_tny_account_get_special_folder (TnyAccount *self,
TnyFolderType special_type);
-/**
- * modest_tny_folder_store_get_folder_count:
- * @self: a #TnyFolderStore
- *
- * gets the number of folders of the account
- *
- * Returns: the number of folder, or -1 in case of error
- **/
-gint modest_tny_folder_store_get_folder_count (TnyFolderStore *self);
+typedef void (*GetFolderStatsCallback) (ModestFolderStats stats,
+ gpointer user_data);
/**
- * modest_tny_folder_store_get_message_count:
- * @self:
- *
- * gets the number of messages in the account
+ * modest_tny_folder_store_get_folder_stats:
+ * @self: a #TnyFolderStore
*
- * Returns: the number of messages, or -1 in case of error
**/
-gint modest_tny_folder_store_get_message_count (TnyFolderStore *self);
+void
+modest_tny_folder_store_get_folder_stats (TnyFolderStore *self,
+ GetFolderStatsCallback callback,
+ GetFolderStatsCallback status_callback,
+ gpointer user_data);
/**
- * modest_tny_folder_store_get_local_size:
- * @self:
- *
- * gets the total size occupied by the account in the local storage
- * device
- *
- * Returns: the total size in bytes, or -1 in case of error
- **/
-gint modest_tny_folder_store_get_local_size (TnyFolderStore *self);
+ * modest_tny_folder_store_is_remote:
+ * @folder_store: The folder store (folder or account) that needs to
+ * decide if need a connection in subsequent operations.
+ * @return value: Whether a connection is necessary for this folder_store.
+ */
+gboolean modest_tny_folder_store_is_remote (TnyFolderStore *self);
/** modest_tny_account_get_parent_modest_account_name_for_server_account:
* Get the name of the parent modest account of which the server account is a part.
* so it can be retrieved later with
* modest_tny_account_get_parent_modest_account_name_for_server_account().
*/
-void modest_tny_account_set_parent_modest_account_name_for_server_account (TnyAccount *self, const gchar* parent_modest_acount_name);
+void modest_tny_account_set_parent_modest_account_name_for_server_account (TnyAccount *account, const gchar* parent_modest_acount_name);
+
+
+typedef void (*ModestTnyAccountGetMmcAccountNameCallback) (TnyStoreAccount* self, gpointer user_data);
+
+/** modest_tny_account_get_mmc_account_name:
+ * Asnchronously get the name of a memory card account and set it in the TnyAccount,
+ * calling the callback (if not NULL) to notify that the name is changed.
+ * if the name was changed. The callback will not be called if the name was not changed.
+ */
+void modest_tny_account_get_mmc_account_name (TnyStoreAccount* self,
+ ModestTnyAccountGetMmcAccountNameCallback callback,
+ gpointer user_data);
+
+
+/** modest_tny_account_is_virtual_local_folders:
+ * @self A TnyAccount.
+ *
+ * A convenience function to identify whether TnyAccount
+ * is the virtual local folders account, containing the folders from local_folders/
+ * and the outboxes from outboxes/<account-name>/.
+ **/
+gboolean modest_tny_account_is_virtual_local_folders (TnyAccount *self);
+
+/** modest_tny_account_is_memory_card_account:
+ * @self A TnyAccount.
+ *
+ * A convenience function to identify whether TnyAccount
+ * is the memory card account.
+ **/
+gboolean modest_tny_account_is_memory_card_account (TnyAccount *self);
+
+/**
+ * modest_tny_account_get_protocol_type:
+ * @self: a #TnyAccount
+ *
+ * obtains the transport/store protocol type of @self
+ *
+ * Returns: a #ModestProtocolType
+ */
+ModestProtocolType modest_tny_account_get_protocol_type (TnyAccount *self);
+
G_END_DECLS