GnuCash  5.6-150-g038405b370+
dialog-file-access.c
1 /********************************************************************\
2  * dialog-file-access.c -- dialog for opening a file or making a *
3  * connection to a libdbi database *
4  * *
5  * Copyright (C) 2009 Phil Longstaff (plongstaff@rogers.com) *
6  * *
7  * This program is free software; you can redistribute it and/or *
8  * modify it under the terms of the GNU General Public License as *
9  * published by the Free Software Foundation; either version 2 of *
10  * the License, or (at your option) any later version. *
11  * *
12  * This program is distributed in the hope that it will be useful, *
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of *
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
15  * GNU General Public License for more details. *
16  * *
17  * You should have received a copy of the GNU General Public License*
18  * along with this program; if not, contact: *
19  * *
20  * Free Software Foundation Voice: +1-617-542-5942 *
21  * 51 Franklin Street, Fifth Floor Fax: +1-617-542-2652 *
22  * Boston, MA 02110-1301, USA gnu@gnu.org *
23 \********************************************************************/
24 
25 #include <stdbool.h>
26 #include <config.h>
27 
28 #include <gtk/gtk.h>
29 #include <glib/gi18n.h>
30 
31 #include "gnc-ui.h"
32 #include "gnc-ui-util.h"
33 #include "gnc-uri-utils.h"
34 #include "dialog-utils.h"
35 #include "dialog-file-access.h"
36 #include "gnc-file.h"
37 #include "gnc-filepath-utils.h"
39 #include "gnc-session.h"
40 
41 static QofLogModule log_module = GNC_MOD_GUI;
42 
43 /* MariaDB/MySQL/Postgres optimize localhost to a unix socket but
44  * flatpak won't connect to unix sockets without gymnastics default to
45  * the localhost IP to force a network connection.
46  */
47 #define DEFAULT_HOST "127.0.0.1"
48 #define DEFAULT_DATABASE PROJECT_NAME
49 #define FILE_ACCESS_OPEN 0
50 #define FILE_ACCESS_SAVE_AS 1
51 #define FILE_ACCESS_EXPORT 2
52 
53 typedef struct FileAccessWindow
54 {
55  /* Parts of the dialog */
56  int type;
57 
58  GtkWidget *dialog;
59  GtkWidget *frame_file;
60  GtkWidget *frame_database;
61  GtkWidget *readonly_checkbutton;
62  GtkFileChooser *fileChooser;
63  gchar *starting_dir;
64  GtkComboBoxText *cb_uri_type;
65  GtkEntry *tf_host;
66  GtkEntry *tf_database;
67  GtkEntry *tf_username;
68  GtkEntry *tf_password;
70 
71 void gnc_ui_file_access_file_activated_cb( GtkFileChooser *chooser,
72  FileAccessWindow *faw );
73 void gnc_ui_file_access_response_cb( GtkDialog *, gint, GtkDialog * );
74 static void cb_uri_type_changed_cb( GtkComboBoxText* cb );
75 
76 static gchar*
77 geturl( FileAccessWindow* faw )
78 {
79  gchar* url = NULL;
80  const gchar* host = NULL;
81  const gchar* username = NULL;
82  const gchar* password = NULL;
83  /* Not const as return value of gtk_combo_box_text_get_active_text must be freed */
84  gchar* type = NULL;
85  /* Not const as return value of gtk_file_chooser_get_filename must be freed */
86  gchar* path = NULL;
87 
88  type = gtk_combo_box_text_get_active_text (faw->cb_uri_type);
89  if (gnc_uri_is_file_scheme (type))
90  {
91  path = gtk_file_chooser_get_filename (faw->fileChooser);
92  if ( !path ) /* file protocol was chosen but no filename was set */
93  {
94  g_free (type);
95  return NULL;
96  }
97  }
98  else /* db protocol was chosen */
99  {
100  host = gtk_entry_get_text( faw->tf_host );
101  path = g_strdup(gtk_entry_get_text(faw->tf_database));
102  username = gtk_entry_get_text( faw->tf_username );
103  password = gtk_entry_get_text( faw->tf_password );
104  }
105 
106  url = gnc_uri_create_uri (type, host, 0, username, password, path);
107 
108  g_free (type);
109  g_free (path);
110 
111  return url;
112 }
113 
114 void
115 gnc_ui_file_access_file_activated_cb( GtkFileChooser *chooser, FileAccessWindow *faw )
116 {
117  g_return_if_fail( chooser != NULL );
118 
119  gnc_ui_file_access_response_cb( GTK_DIALOG(faw->dialog), GTK_RESPONSE_OK, NULL );
120 }
121 
122 void
123 gnc_ui_file_access_response_cb(GtkDialog *dialog, gint response, GtkDialog *unused)
124 {
125  FileAccessWindow* faw;
126  gchar* url;
127 
128  g_return_if_fail( dialog != NULL );
129 
130  faw = g_object_get_data( G_OBJECT(dialog), "FileAccessWindow" );
131  g_return_if_fail( faw != NULL );
132 
133  switch ( response )
134  {
135  case GTK_RESPONSE_HELP:
136  gnc_gnome_help (GTK_WINDOW(dialog), DF_MANUAL, DL_GLOBPREFS );
137  break;
138 
139  case GTK_RESPONSE_OK:
140  url = geturl( faw );
141  if ( url == NULL )
142  {
143  return;
144  }
145  if (g_str_has_prefix (url, "file://"))
146  {
147  if ( g_file_test( g_filename_from_uri( url, NULL, NULL ),
148  G_FILE_TEST_IS_DIR ))
149  {
150  gtk_file_chooser_set_current_folder_uri( faw->fileChooser, url );
151  return;
152  }
153  }
154  if ( faw->type == FILE_ACCESS_OPEN )
155  {
156  gboolean open_readonly = faw->readonly_checkbutton
157  ? gtk_toggle_button_get_active(GTK_TOGGLE_BUTTON(faw->readonly_checkbutton))
158  : FALSE;
159  gnc_file_open_file (GTK_WINDOW(dialog), url, open_readonly);
160  }
161  else if ( faw->type == FILE_ACCESS_SAVE_AS )
162  {
163  gnc_file_do_save_as (GTK_WINDOW(dialog), url);
164  }
165  else if ( faw->type == FILE_ACCESS_EXPORT )
166  {
167  gnc_file_do_export (GTK_WINDOW(dialog), url);
168  }
169  break;
170 
171  case GTK_RESPONSE_CANCEL:
172  case GTK_RESPONSE_DELETE_EVENT:
173  break;
174 
175  default:
176  PERR( "Invalid response" );
177  break;
178  }
179 
180  if ( response != GTK_RESPONSE_HELP )
181  {
182  gtk_widget_destroy( GTK_WIDGET(dialog) );
183  }
184 }
185 
186 /* Activate the file chooser and deactivate the db selection fields */
187 static void
188 set_widget_sensitivity( FileAccessWindow* faw, gboolean is_file_based_uri )
189 {
190  if (is_file_based_uri)
191  {
192  gtk_widget_show(faw->frame_file);
193  gtk_widget_hide(faw->frame_database);
194  gtk_file_chooser_set_current_folder(faw->fileChooser, faw->starting_dir);
195  }
196  else
197  {
198  gtk_widget_show(faw->frame_database);
199  gtk_widget_hide(faw->frame_file);
200  }
201 // gtk_widget_set_sensitive( faw->frame_file, is_file_based_uri );
202 // gtk_widget_set_sensitive( faw->frame_database, !is_file_based_uri );
203 }
204 
205 static void
206 set_widget_sensitivity_for_uri_type( FileAccessWindow* faw, const gchar* uri_type )
207 {
208  if ( strcmp( uri_type, "file" ) == 0 || strcmp( uri_type, "xml" ) == 0
209  || strcmp( uri_type, "sqlite3" ) == 0 )
210  {
211  set_widget_sensitivity( faw, /* is_file_based_uri */ TRUE );
212  }
213  else if ( strcmp( uri_type, "mysql" ) == 0 || strcmp( uri_type, "postgres" ) == 0 )
214  {
215  set_widget_sensitivity( faw, /* is_file_based_uri */ FALSE );
216  }
217  else
218  {
219  g_assert( FALSE );
220  }
221 }
222 
223 static void
224 cb_uri_type_changed_cb( GtkComboBoxText* cb )
225 {
226  GtkWidget* dialog;
227  FileAccessWindow* faw;
228  const gchar* type;
229 
230  g_return_if_fail( cb != NULL );
231 
232  dialog = gtk_widget_get_toplevel( GTK_WIDGET(cb) );
233  g_return_if_fail( dialog != NULL );
234  faw = g_object_get_data( G_OBJECT(dialog), "FileAccessWindow" );
235  g_return_if_fail( faw != NULL );
236 
237  type = gtk_combo_box_text_get_active_text( cb );
238  set_widget_sensitivity_for_uri_type( faw, type );
239 }
240 
241 static const char*
242 get_default_database( void )
243 {
244  const gchar* default_db;
245 
246  default_db = g_getenv( "GNC_DEFAULT_DATABASE" );
247  if ( default_db == NULL )
248  {
249  default_db = DEFAULT_DATABASE;
250  }
251 
252  return default_db;
253 }
254 
255 typedef bool (*CharToBool)(const char*);
256 
257 static bool datafile_filter (const GtkFileFilterInfo* filter_info,
258  CharToBool filename_checker)
259 {
260  return filter_info && filter_info->filename &&
261  filename_checker (filter_info->filename);
262 }
263 
264 static void free_file_access_window (FileAccessWindow *faw)
265 {
266  g_free (faw->starting_dir);
267  g_free (faw);
268 }
269 
270 static void
271 gnc_ui_file_access (GtkWindow *parent, int type)
272 {
273  FileAccessWindow *faw;
274  GtkBuilder* builder;
275  GtkButton* op;
276  GtkWidget* file_chooser;
277  GtkFileChooserWidget* fileChooser;
278  GtkFileChooserAction fileChooserAction = GTK_FILE_CHOOSER_ACTION_OPEN;
279  GList* list;
280  GList* node;
281  GtkWidget* uri_type_container;
282  gboolean need_access_method_file = FALSE;
283  gboolean need_access_method_mysql = FALSE;
284  gboolean need_access_method_postgres = FALSE;
285  gboolean need_access_method_sqlite3 = FALSE;
286  gboolean need_access_method_xml = FALSE;
287  gint access_method_index = -1;
288  gint active_access_method_index = -1;
289  const gchar* default_db;
290  const gchar *button_label = NULL;
291  const gchar *settings_section = NULL;
292  gchar *last;
293 
294  g_return_if_fail( type == FILE_ACCESS_OPEN || type == FILE_ACCESS_SAVE_AS || type == FILE_ACCESS_EXPORT );
295 
296  faw = g_new0(FileAccessWindow, 1);
297  g_return_if_fail( faw != NULL );
298 
299  faw->type = type;
300  faw->starting_dir = NULL;
301 
302  /* Open the dialog */
303  builder = gtk_builder_new();
304  gnc_builder_add_from_file (builder, "dialog-file-access.glade", "file_access_dialog" );
305  faw->dialog = GTK_WIDGET(gtk_builder_get_object (builder, "file_access_dialog" ));
306  gtk_window_set_transient_for (GTK_WINDOW (faw->dialog), parent);
307  g_object_set_data_full (G_OBJECT(faw->dialog), "FileAccessWindow", faw,
308  (GDestroyNotify)free_file_access_window);
309 
310  // Set the name for this dialog so it can be easily manipulated with css
311  gtk_widget_set_name (GTK_WIDGET(faw->dialog), "gnc-id-file-access");
312 
313  faw->frame_file = GTK_WIDGET(gtk_builder_get_object (builder, "frame_file" ));
314  faw->frame_database = GTK_WIDGET(gtk_builder_get_object (builder, "frame_database" ));
315  faw->readonly_checkbutton = GTK_WIDGET(gtk_builder_get_object (builder, "readonly_checkbutton"));
316  faw->tf_host = GTK_ENTRY(gtk_builder_get_object (builder, "tf_host" ));
317  gtk_entry_set_text( faw->tf_host, DEFAULT_HOST );
318  faw->tf_database = GTK_ENTRY(gtk_builder_get_object (builder, "tf_database" ));
319  default_db = get_default_database();
320  gtk_entry_set_text( faw->tf_database, default_db );
321  faw->tf_username = GTK_ENTRY(gtk_builder_get_object (builder, "tf_username" ));
322  faw->tf_password = GTK_ENTRY(gtk_builder_get_object (builder, "tf_password" ));
323 
324  switch ( type )
325  {
326  case FILE_ACCESS_OPEN:
327  gtk_window_set_title(GTK_WINDOW(faw->dialog), _("Open…"));
328  button_label = _("_Open");
329  fileChooserAction = GTK_FILE_CHOOSER_ACTION_OPEN;
330  settings_section = GNC_PREFS_GROUP_OPEN_SAVE;
331  break;
332 
333  case FILE_ACCESS_SAVE_AS:
334  gtk_window_set_title(GTK_WINDOW(faw->dialog), _("Save As…"));
335  button_label = _("_Save As");
336  fileChooserAction = GTK_FILE_CHOOSER_ACTION_SAVE;
337  settings_section = GNC_PREFS_GROUP_OPEN_SAVE;
338  gtk_widget_destroy(faw->readonly_checkbutton);
339  faw->readonly_checkbutton = NULL;
340  break;
341 
342  case FILE_ACCESS_EXPORT:
343  gtk_window_set_title(GTK_WINDOW(faw->dialog), _("Export"));
344  button_label = _("_Save As");
345  fileChooserAction = GTK_FILE_CHOOSER_ACTION_SAVE;
346  settings_section = GNC_PREFS_GROUP_EXPORT;
347  gtk_widget_destroy(faw->readonly_checkbutton);
348  faw->readonly_checkbutton = NULL;
349  break;
350  }
351 
352  op = GTK_BUTTON(gtk_builder_get_object (builder, "pb_op" ));
353  if ( op != NULL )
354  gtk_button_set_label( op, button_label );
355 
356  file_chooser = GTK_WIDGET(gtk_builder_get_object (builder, "file_chooser" ));
357  fileChooser = GTK_FILE_CHOOSER_WIDGET(gtk_file_chooser_widget_new( fileChooserAction ));
358  faw->fileChooser = GTK_FILE_CHOOSER(fileChooser);
359  gtk_box_pack_start( GTK_BOX(file_chooser), GTK_WIDGET(fileChooser), TRUE, TRUE, 6 );
360 
361  /* set up .gnucash filters for Datafile operations */
362  GtkFileFilter *filter = gtk_file_filter_new ();
363  gtk_file_filter_set_name (filter, _("All files"));
364  gtk_file_filter_add_pattern (filter, "*");
365  gtk_file_chooser_add_filter (faw->fileChooser, filter);
366 
367  filter = gtk_file_filter_new ();
368  /* Translators: *.gnucash and *.xac are file patterns and must not
369  be translated*/
370  gtk_file_filter_set_name (filter, _("Datafiles only (*.gnucash, *.xac)"));
371  gtk_file_filter_add_custom (filter, GTK_FILE_FILTER_FILENAME,
372  (GtkFileFilterFunc)datafile_filter,
373  gnc_filename_is_datafile, NULL);
374  gtk_file_chooser_add_filter (faw->fileChooser, filter);
375  gtk_file_chooser_set_filter (faw->fileChooser, filter);
376 
377  filter = gtk_file_filter_new ();
378  /* Translators: *.gnucash.*.gnucash, *.xac.*.xac are file
379  patterns and must not be translated*/
380  gtk_file_filter_set_name (filter, _("Backups only (*.gnucash.*.gnucash, *.xac.*.xac)"));
381  gtk_file_filter_add_custom (filter, GTK_FILE_FILTER_FILENAME,
382  (GtkFileFilterFunc)datafile_filter,
383  gnc_filename_is_backup, NULL);
384  gtk_file_chooser_add_filter (faw->fileChooser, filter);
385 
386  /* Set the default directory */
387  if (type == FILE_ACCESS_OPEN || type == FILE_ACCESS_SAVE_AS)
388  {
389  last = gnc_history_get_last();
390  if ( last && *last && gnc_uri_targets_local_fs (last))
391  {
392  gchar *filepath = gnc_uri_get_path ( last );
393  faw->starting_dir = g_path_get_dirname( filepath );
394  g_free ( filepath );
395  }
396  g_free (last);
397  }
398  if (!faw->starting_dir)
399  faw->starting_dir = gnc_get_default_directory(settings_section);
400  gtk_file_chooser_set_current_folder(faw->fileChooser, faw->starting_dir);
401 
402  g_object_connect( G_OBJECT(faw->fileChooser), "signal::file-activated",
403  gnc_ui_file_access_file_activated_cb, faw, NULL );
404 
405  uri_type_container = GTK_WIDGET(gtk_builder_get_object (builder, "vb_uri_type_container" ));
406  faw->cb_uri_type = GTK_COMBO_BOX_TEXT(gtk_combo_box_text_new());
407  gtk_container_add( GTK_CONTAINER(uri_type_container), GTK_WIDGET(faw->cb_uri_type) );
408  gtk_box_set_child_packing( GTK_BOX(uri_type_container), GTK_WIDGET(faw->cb_uri_type),
409  /*expand*/TRUE, /*fill*/FALSE, /*padding*/0, GTK_PACK_START );
410  g_object_connect( G_OBJECT(faw->cb_uri_type),
411  "signal::changed", cb_uri_type_changed_cb, NULL,
412  NULL );
413 
414  /* Autoconnect signals */
415  gtk_builder_connect_signals_full (builder, gnc_builder_connect_full_func, faw);
416 
417  /* See what qof backends are available and add appropriate ones to the combo box */
419  for ( node = list; node != NULL; node = node->next )
420  {
421  const gchar* access_method = node->data;
422 
423  /* For the different access methods, "mysql" and "postgres" are added if available. Access
424  methods "xml" and "sqlite3" are compressed to "file" if opening a file, but when saving a file,
425  both access methods are added. */
426  if ( strcmp( access_method, "mysql" ) == 0 )
427  {
428  need_access_method_mysql = TRUE;
429  }
430  else if ( strcmp( access_method, "postgres" ) == 0 )
431  {
432  need_access_method_postgres = TRUE;
433  }
434  else if ( strcmp( access_method, "xml" ) == 0 )
435  {
436  if ( type == FILE_ACCESS_OPEN )
437  {
438  need_access_method_file = TRUE;
439  }
440  else
441  {
442  need_access_method_xml = TRUE;
443  }
444  }
445  else if ( strcmp( access_method, "sqlite3" ) == 0 )
446  {
447  if ( type == FILE_ACCESS_OPEN )
448  {
449  need_access_method_file = TRUE;
450  }
451  else
452  {
453  need_access_method_sqlite3 = TRUE;
454  }
455  }
456  }
457  g_list_free(list);
458 
459  /* Now that the set of access methods has been ascertained, add them to the list, and set the
460  default. */
461  access_method_index = -1;
462  if ( need_access_method_file )
463  {
464  gtk_combo_box_text_append_text( faw->cb_uri_type, "file" );
465  active_access_method_index = ++access_method_index;
466  }
467  if ( need_access_method_mysql )
468  {
469  gtk_combo_box_text_append_text( faw->cb_uri_type, "mysql" );
470  ++access_method_index;
471  }
472  if ( need_access_method_postgres )
473  {
474  gtk_combo_box_text_append_text( faw->cb_uri_type, "postgres" );
475  ++access_method_index;
476  }
477  if ( need_access_method_sqlite3 )
478  {
479  gtk_combo_box_text_append_text( faw->cb_uri_type, "sqlite3" );
480  active_access_method_index = ++access_method_index;
481  }
482  if ( need_access_method_xml )
483  {
484  gtk_combo_box_text_append_text( faw->cb_uri_type, "xml" );
485  ++access_method_index;
486 
487  // Set XML as default if it is offered (which mean we are in
488  // the "Save As" dialog)
489  active_access_method_index = access_method_index;
490  }
491  g_assert( active_access_method_index >= 0 );
492 
493  g_object_unref(G_OBJECT(builder));
494 
495  /* Run the dialog */
496  gtk_widget_show_all( faw->dialog );
497 
498  /* Hide the frame that's not required for the active access method so either only
499  * the File or only the Database frame are presented. */
500  gtk_combo_box_set_active(GTK_COMBO_BOX(faw->cb_uri_type), active_access_method_index );
501  set_widget_sensitivity_for_uri_type( faw, gtk_combo_box_text_get_active_text( faw->cb_uri_type ));
502 }
503 
504 void
505 gnc_ui_file_access_for_open (GtkWindow *parent)
506 {
507  gnc_ui_file_access (parent, FILE_ACCESS_OPEN);
508 }
509 
510 
511 void
512 gnc_ui_file_access_for_save_as (GtkWindow *parent)
513 {
514  gnc_ui_file_access (parent, FILE_ACCESS_SAVE_AS);
515 }
516 
517 
518 void
519 gnc_ui_file_access_for_export (GtkWindow *parent)
520 {
521  gnc_ui_file_access (parent, FILE_ACCESS_EXPORT);
522 }
utility functions for the GnuCash UI
gboolean gnc_uri_is_file_scheme(const gchar *scheme)
Checks if the given scheme is used to refer to a file (as opposed to a network service like a databas...
Definition: gnc-uri-utils.c:90
gchar * gnc_uri_get_path(const gchar *uri)
Extracts the path part from a uri.
#define PERR(format, args...)
Log a serious error.
Definition: qoflog.h:244
char * gnc_history_get_last(void)
Retrieve the name of the file most recently accessed.
void gnc_gnome_help(GtkWindow *parent, const char *file_name, const char *anchor)
Launch the systems default help browser, gnome&#39;s yelp for linux, and open to a given link within a gi...
Functions providing the file history menu.
GList * qof_backend_get_registered_access_method_list(void)
Return a list of strings for the registered access methods.
Definition: qofsession.cpp:103
gboolean gnc_uri_targets_local_fs(const gchar *uri)
Checks if the given uri is either a valid file uri or a local filesystem path.
This file contains the functions to present a GUI to select a file or a database connection.
Utility functions for convert uri in separate components and back.
File path resolution utility functions.
gchar * gnc_uri_create_uri(const gchar *scheme, const gchar *hostname, gint32 port, const gchar *username, const gchar *password, const gchar *path)
Composes a normalized uri starting from its separate components.