chiark / gitweb /
Rearrange window layout and UI structure
[disorder] / disobedience / users.c
index 5b50b2599185c8b6128c5ba5a5c46b8600213021..80b6f421d49c53fce1a1b850787e5d704d324cb4 100644 (file)
  */
 /** @file disobedience/users.c
  * @brief User management for Disobedience
+ *
+ * The user management window contains:
+ * - a list of all the users
+ * - an add button
+ * - a delete button
+ * - a user details panel
+ * - an apply button
+ *
+ * When you select a user that user's details are displayed to the right of the
+ * list.  Hit the Apply button and any changes are applied.
+ *
+ * When you select 'add' a new empty set of details are displayed to be edited.
+ * Again Apply will commit them.
  */
 
 #include "disobedience.h"
@@ -28,21 +41,35 @@ static GtkWidget *users_window;
 static GtkListStore *users_list;
 static GtkTreeSelection *users_selection;
 
-static GtkWidget *users_details_window;
+static GtkWidget *users_details_table;
+static GtkWidget *users_apply_button;
+static GtkWidget *users_delete_button;
 static GtkWidget *users_details_name;
 static GtkWidget *users_details_email;
 static GtkWidget *users_details_password;
 static GtkWidget *users_details_password2;
 static GtkWidget *users_details_rights[32];
+static int users_details_row;
+static const char *users_selected;
 
-static const char *users_who, *users_email, *users_rights, *users_password;
+static int users_mode;
+#define MODE_NONE 0
+#define MODE_ADD 1
+#define MODE_EDIT 2
+
+static const char *users_email, *users_rights, *users_password;
 
 /** @brief qsort() callback for username comparison */
 static int usercmp(const void *a, const void *b) {
   return strcmp(*(char **)a, *(char **)b);
 }
 
-/** @brief Called with the list of users */
+/** @brief Called with the list of users
+ *
+ * Currently this is called when the window is created, and is responsible for
+ * showing it.  There's currently no facility for refreshing the list, which
+ * hopefuly would preserve the select user (if any).
+ */
 static void users_got_list(void attribute((unused)) *v, int nvec, char **vec) {
   int n;
   GtkTreeIter iter;
@@ -59,23 +86,6 @@ static void users_got_list(void attribute((unused)) *v, int nvec, char **vec) {
   gtk_widget_show_all(users_window);
 }
 
-/** @brief Pick the selected user from the list */
-static char *users_getuser(void) {
-  GtkTreeIter iter;
-  char *who, *c;
-
-  if(gtk_tree_selection_get_selected(users_selection, 0, &iter)) {
-    gtk_tree_model_get(GTK_TREE_MODEL(users_list), &iter,
-                       0, &who, -1);
-    if(who) {
-      c = xstrdup(who);
-      g_free(who);
-      return c;
-    }
-  }
-  return 0;
-}
-
 /** @brief Text should be visible */
 #define DETAIL_VISIBLE 1
 
@@ -83,69 +93,66 @@ static char *users_getuser(void) {
 #define DETAIL_EDITABLE 2
 
 /** @brief Add a row to the user detail table */
-static GtkWidget *users_detail_generic(GtkWidget *table,
-                                       int *rowp,
-                                       const char *title,
-                                       GtkWidget *selector) {
-  const int row = (*rowp)++;
+static void users_detail_generic(const char *title,
+                                 GtkWidget *selector) {
+  const int row = users_details_row++;
   GtkWidget *const label = gtk_label_new(title);
   gtk_misc_set_alignment(GTK_MISC(label), 1, 0);
-  gtk_table_attach(GTK_TABLE(table),
+  gtk_table_attach(GTK_TABLE(users_details_table),
                    label,
                    0, 1,                /* left/right_attach */
                    row, row+1,          /* top/bottom_attach */
                    GTK_FILL,            /* xoptions */
                    0,                   /* yoptions */
                    1, 1);               /* x/ypadding */
-  gtk_table_attach(GTK_TABLE(table),
+  gtk_table_attach(GTK_TABLE(users_details_table),
                    selector,
                    1, 2,                /* left/right_attach */
                    row, row + 1,        /* top/bottom_attach */
                    GTK_EXPAND|GTK_FILL, /* xoptions */
                    GTK_FILL,            /* yoptions */
                    1, 1);               /* x/ypadding */
-  return selector;
 }
 
 /** @brief Add a row to the user details table
- * @param table Containin table widget
- * @param rowp Pointer to row number, incremented
+ * @param entryp Where to put GtkEntry
  * @param title Label for this row
  * @param value Initial value or NULL
  * @param flags Flags word
- * @return The text entry widget
  */
-static GtkWidget *users_add_detail(GtkWidget *table,
-                                   int *rowp,
-                                   const char *title,
-                                   const char *value,
-                                   unsigned flags) {
-  GtkWidget *entry = gtk_entry_new();
-
+static void users_add_detail(GtkWidget **entryp,
+                             const char *title,
+                             const char *value,
+                             unsigned flags) {
+  GtkWidget *entry;
+
+  if(!(entry = *entryp)) {
+    *entryp = entry = gtk_entry_new();
+    users_detail_generic(title, entry);
+  }
   gtk_entry_set_visibility(GTK_ENTRY(entry),
                            !!(flags & DETAIL_VISIBLE));
   gtk_editable_set_editable(GTK_EDITABLE(entry),
                             !!(flags & DETAIL_EDITABLE));
-  if(value)
-    gtk_entry_set_text(GTK_ENTRY(entry), value);
-  return users_detail_generic(table, rowp, title, entry);
+  gtk_entry_set_text(GTK_ENTRY(entry), value ? value : "");
 }
 
 /** @brief Add a checkbox for a right
- * @param table Containing table
- * @param rowp Pointer to row number, incremented
  * @param title Label for this row
- * @param value Right bit (masked but not necessarily normalized)
+ * @param value Current value
+ * @param right Right bit
  */
-static void users_add_right(GtkWidget *table,
-                            int *rowp,
-                            const char *title,
-                            rights_type value) {
-  GtkWidget *check = gtk_check_button_new();
-  
-  gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(check), !!value);
-  users_details_rights[leftmost_bit(value)] = check;
-  users_detail_generic(table, rowp, title, check);
+static void users_add_right(const char *title,
+                            rights_type value,
+                            rights_type right) {
+  GtkWidget *check;
+  GtkWidget **checkp = &users_details_rights[leftmost_bit(right)];
+
+  if(!(check = *checkp)) {
+    *checkp = check = gtk_check_button_new();
+    users_detail_generic(title, check);
+  }
+  gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(check), !!(value & right));
 }
 
 /** @brief Set sensitivity of particular mine/random rights bits */
@@ -158,11 +165,31 @@ static void users_details_sensitize(rights_type r) {
   gtk_widget_set_sensitive(users_details_rights[bit + 2], sensitive);
 }
 
-/** @brief Set sensitivity of all mine/random rights bits */
+/** @brief Set sensitivity of everything in sight */
 static void users_details_sensitize_all(void) {
+  int apply_sensitive;
+
+  /* Three-right groups */
   users_details_sensitize(RIGHT_MOVE_ANY);
   users_details_sensitize(RIGHT_REMOVE_ANY);
   users_details_sensitize(RIGHT_SCRATCH_ANY);
+  /* Apply button */
+  switch(users_mode) {
+  case MODE_NONE:
+    apply_sensitive = 0;
+    break;
+  case MODE_EDIT:
+    apply_sensitive = 1;
+    break;
+  case MODE_ADD:
+    apply_sensitive = !!*gtk_entry_get_text(GTK_ENTRY(users_details_name));
+    break;
+  default:
+    assert(!"reached");
+  }
+  gtk_widget_set_sensitive(users_apply_button, apply_sensitive);
+  /* Delete button */
+  gtk_widget_set_sensitive(users_delete_button, !!users_selected);
 }
 
 /** @brief Called when an _ALL widget is toggled
@@ -176,24 +203,36 @@ static void users_any_toggled(GtkToggleButton attribute((unused)) *togglebutton,
 }
 
 /** @brief Add a checkbox for a three-right group
- * @param table Containing table
- * @param rowp Pointer to row number, incremented
  * @param title Label for this row
  * @param bits Rights bits (not masked or normalized)
- * @param mask Mask for this group (must be 7.2^n)
+ * @param mask Mask for this group (must be 7*2^n)
  */
-static void users_add_right_group(GtkWidget *table,
-                                  int *rowp,
-                                  const char *title,
+static void users_add_right_group(const char *title,
                                   rights_type bits,
                                   rights_type mask) {
-  GtkWidget *any = gtk_check_button_new_with_label("Any");
-  GtkWidget *mine = gtk_check_button_new_with_label("Own");
-  GtkWidget *random = gtk_check_button_new_with_label("Random");
-  GtkWidget *hbox = gtk_hbox_new(FALSE, 2);
   const uint32_t first = mask / 7;
   const int bit = leftmost_bit(first);
-
+  GtkWidget **widgets = &users_details_rights[bit], *any, *mine, *random;
+
+  if(!*widgets) {
+    GtkWidget *hbox = gtk_hbox_new(FALSE, 2);
+
+    any = widgets[0] = gtk_check_button_new_with_label("Any");
+    mine = widgets[1] = gtk_check_button_new_with_label("Own");
+    random = widgets[2] = gtk_check_button_new_with_label("Random");
+    gtk_box_pack_start(GTK_BOX(hbox), any, FALSE, FALSE, 0);
+    gtk_box_pack_start(GTK_BOX(hbox), mine, FALSE, FALSE, 0);
+    gtk_box_pack_start(GTK_BOX(hbox), random, FALSE, FALSE, 0);
+    users_detail_generic(title, hbox);
+    g_signal_connect(any, "toggled", G_CALLBACK(users_any_toggled), NULL);
+    users_details_rights[bit] = any;
+    users_details_rights[bit + 1] = mine;
+    users_details_rights[bit + 2] = random;
+  } else {
+    any = widgets[0];
+    mine = widgets[1];
+    random = widgets[2];
+  }
   /* Discard irrelevant bits */
   bits &= mask;
   /* Shift down to bits 0-2; the mask is always 3 contiguous bits */
@@ -201,88 +240,86 @@ static void users_add_right_group(GtkWidget *table,
   gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(any), !!(bits & 1));
   gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(mine), !!(bits & 2));
   gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(random), !!(bits & 4));
-  gtk_box_pack_start(GTK_BOX(hbox), any, FALSE, FALSE, 0);
-  gtk_box_pack_start(GTK_BOX(hbox), mine, FALSE, FALSE, 0);
-  gtk_box_pack_start(GTK_BOX(hbox), random, FALSE, FALSE, 0);
-  users_details_rights[bit] = any;
-  users_details_rights[bit + 1] = mine;
-  users_details_rights[bit + 2] = random;
-  users_detail_generic(table, rowp, title, hbox);
-  g_signal_connect(any, "toggled", G_CALLBACK(users_any_toggled), NULL);
 }
 
-/** @brief Create the user details window
- * @param title Window title
+/** @brief Create or modify the user details table
  * @param name User name (users_edit()) or NULL (users_add())
  * @param email Email address
  * @param rights User rights string
  * @param password Password
- *
- * This is used both by users_add() and users_edit().
- *
- * The window contains:
- * - display or edit fields for the username
- * - edit fields for the email address
- * - two hidden edit fields for the password (they must match)
- * - check boxes for the rights
  */
-static void users_makedetails(const char *title,
-                              const char *name,
+static void users_makedetails(const char *name,
                               const char *email,
                               const char *rights,
-                              const char *password) {
-  GtkWidget *table;
-  int row = 0;
+                              const char *password,
+                              unsigned nameflags,
+                              unsigned flags) {
   rights_type r = 0;
   
-  /* Create the window */
-  users_details_window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
-  gtk_widget_set_style(users_details_window, tool_style);
-  g_signal_connect(users_details_window, "destroy",
-                  G_CALLBACK(gtk_widget_destroyed), &users_details_window);
-  gtk_window_set_title(GTK_WINDOW(users_details_window), title);
-  gtk_window_set_transient_for(GTK_WINDOW(users_details_window),
-                               GTK_WINDOW(users_window));
-  table = gtk_table_new(4, 2, FALSE/*!homogeneous*/);
-
-  users_details_name = users_add_detail(table, &row, "Username", name,
-                                        (name ? 0 : DETAIL_EDITABLE)
-                                        |DETAIL_VISIBLE);
-
-  users_details_email = users_add_detail(table, &row, "Email", email,
-                                         DETAIL_EDITABLE|DETAIL_VISIBLE);
-
-  users_details_password = users_add_detail(table, &row, "Password",
-                                            password,
-                                            DETAIL_EDITABLE);
-  users_details_password2 = users_add_detail(table, &row, "Password",
-                                             password,
-                                             DETAIL_EDITABLE);
-
-  parse_rights(rights, &r, 1);
-  users_add_right(table, &row, "Read operations", r & RIGHT_READ);
-  users_add_right(table, &row, "Play track", r & RIGHT_PLAY);
-  users_add_right_group(table, &row, "Move", r, RIGHT_MOVE__MASK);
-  users_add_right_group(table, &row, "Remove", r, RIGHT_REMOVE__MASK);
-  users_add_right_group(table, &row, "Scratch", r, RIGHT_SCRATCH__MASK);
-  users_add_right(table, &row, "Set volume", r & RIGHT_VOLUME);
-  users_add_right(table, &row, "Admin operations", r & RIGHT_ADMIN);
-  users_add_right(table, &row, "Rescan", r & RIGHT_RESCAN);
-  users_add_right(table, &row, "Register new users", r & RIGHT_REGISTER);
-  users_add_right(table, &row, "Modify own userinfo", r & RIGHT_USERINFO);
-  users_add_right(table, &row, "Modify track preferences", r & RIGHT_PREFS);
-  users_add_right(table, &row, "Modify global preferences", r & RIGHT_GLOBAL_PREFS);
-  users_add_right(table, &row, "Pause/resume tracks", r & RIGHT_PAUSE);
+  /* Create the table if it doesn't already exist */
+  if(!users_details_table)
+    users_details_table = gtk_table_new(4, 2, FALSE/*!homogeneous*/);
+
+  /* Create or update the widgets */
+  users_add_detail(&users_details_name, "Username", name,
+                   (DETAIL_EDITABLE|DETAIL_VISIBLE) & nameflags);
+
+  users_add_detail(&users_details_email, "Email", email,
+                   (DETAIL_EDITABLE|DETAIL_VISIBLE) & flags);
+
+  users_add_detail(&users_details_password, "Password", password,
+                   DETAIL_EDITABLE & flags);
+  users_add_detail(&users_details_password2, "Password", password,
+                   DETAIL_EDITABLE & flags);
+
+  parse_rights(rights, &r, 0);
+  users_add_right("Read operations", r, RIGHT_READ);
+  users_add_right("Play track", r, RIGHT_PLAY);
+  users_add_right_group("Move", r, RIGHT_MOVE__MASK);
+  users_add_right_group("Remove", r, RIGHT_REMOVE__MASK);
+  users_add_right_group("Scratch", r, RIGHT_SCRATCH__MASK);
+  users_add_right("Set volume", r, RIGHT_VOLUME);
+  users_add_right("Admin operations", r, RIGHT_ADMIN);
+  users_add_right("Rescan", r, RIGHT_RESCAN);
+  users_add_right("Register new users", r, RIGHT_REGISTER);
+  users_add_right("Modify own userinfo", r, RIGHT_USERINFO);
+  users_add_right("Modify track preferences", r, RIGHT_PREFS);
+  users_add_right("Modify global preferences", r, RIGHT_GLOBAL_PREFS);
+  users_add_right("Pause/resume tracks", r, RIGHT_PAUSE);
   users_details_sensitize_all();
-
-  gtk_container_add(GTK_CONTAINER(users_details_window), table);
-  gtk_widget_show_all(users_details_window);
 }
 
 /** @brief Called when the 'add' button is pressed */
 static void users_add(GtkButton attribute((unused)) *button,
                      gpointer attribute((unused)) userdata) {
-  /* TODO */
+  /* Unselect whatever is selected */
+  gtk_tree_selection_unselect_all(users_selection);
+  /* Reset the form */
+  users_makedetails("",
+                    "",
+                    "",                 /* TODO default_rights */
+                    "",
+                    DETAIL_EDITABLE|DETAIL_VISIBLE,
+                    DETAIL_EDITABLE|DETAIL_VISIBLE);
+  /* Remember we're adding a user */
+  users_mode = MODE_ADD;
+}
+
+/** @brief Called when the 'Apply' button is pressed */
+static void users_apply(GtkButton attribute((unused)) *button,
+                        gpointer attribute((unused)) userdata) {
+  switch(users_mode) {
+  case MODE_NONE:
+    return;
+  case MODE_ADD:
+    if(!*gtk_entry_get_text(GTK_ENTRY(users_details_name)))
+      return;
+    /* TODO create user */
+    break;
+  case MODE_EDIT:
+    /* TODO */
+    break;
+  }
 }
 
 /** @brief Called when user deletion goes wrong */
@@ -318,24 +355,24 @@ static void users_deleted(void *v) {
 static void users_delete(GtkButton attribute((unused)) *button,
                         gpointer attribute((unused)) userdata) {
   GtkWidget *yesno;
-  char *who;
   int res;
   struct callbackdata *cbd;
 
-  if(!(who = users_getuser()))
+  if(!users_selected)
     return;
   yesno = gtk_message_dialog_new(GTK_WINDOW(users_window),
                                  GTK_DIALOG_MODAL,
                                  GTK_MESSAGE_QUESTION,
                                  GTK_BUTTONS_YES_NO,
                                  "Do you really want to delete user %s?"
-                                 " This action cannot be undone.", who);
+                                 " This action cannot be undone.",
+                                 users_selected);
   res = gtk_dialog_run(GTK_DIALOG(yesno));
   gtk_widget_destroy(yesno);
   if(res == GTK_RESPONSE_YES) {
     cbd = xmalloc(sizeof *cbd);
     cbd->onerror = users_deleted_error;
-    cbd->u.user = who;
+    cbd->u.user = users_selected;
     disorder_eclient_deluser(client, users_deleted, cbd->u.user, cbd);
   }
 }
@@ -350,48 +387,69 @@ static void users_got_rights(void attribute((unused)) *v, const char *value) {
 
 static void users_got_password(void attribute((unused)) *v, const char *value) {
   users_password = value;
-  users_makedetails("editing user details",
-                    users_who,
+  users_makedetails(users_selected,
                     users_email,
                     users_rights,
-                    users_password);
+                    users_password,
+                    DETAIL_VISIBLE,
+                    DETAIL_EDITABLE|DETAIL_VISIBLE);
+  users_mode = MODE_EDIT;
 }
 
-/** @brief Called when the 'Edit' button is pressed */
-static void users_edit(GtkButton attribute((unused)) *button,
-                      gpointer attribute((unused)) userdata) {
-  if(!(users_who = users_getuser()))
+/** @brief Called when the selection MIGHT have changed */
+static void users_selection_changed(GtkTreeSelection attribute((unused)) *treeselection,
+                                    gpointer attribute((unused)) user_data) {
+  GtkTreeIter iter;
+  char *gselected, *selected;
+  
+  /* Identify the current selection */
+  if(gtk_tree_selection_get_selected(users_selection, 0, &iter)) {
+    gtk_tree_model_get(GTK_TREE_MODEL(users_list), &iter,
+                       0, &gselected, -1);
+    selected = xstrdup(gselected);
+    g_free(gselected);
+  } else
+    selected = 0;
+  /* Eliminate no-change cases */
+  if(!selected && !users_selected)
+    return;
+  if(selected && users_selected && !strcmp(selected, users_selected))
     return;
-  /* Schedule user lookups for all the properties we know about.  This is all a
-   * bit ad-hoc but will do for now. */
-  disorder_eclient_userinfo(client, users_got_email, users_who, "email", 0);
-  disorder_eclient_userinfo(client, users_got_rights, users_who, "rights", 0);
-  disorder_eclient_userinfo(client, users_got_password, users_who, "password", 0);
+  /* There's been a change; junk the old data and fetch new data in
+   * background. */
+  users_selected = selected;
+  users_makedetails("", "", "", "",
+                    DETAIL_VISIBLE,
+                    DETAIL_VISIBLE);
+  disorder_eclient_userinfo(client, users_got_email, users_selected,
+                            "email", 0);
+  disorder_eclient_userinfo(client, users_got_rights, users_selected,
+                            "rights", 0);
+  disorder_eclient_userinfo(client, users_got_password, users_selected,
+                            "password", 0);
+  users_mode = MODE_NONE;               /* not editing *yet* */
 }
 
-/** @brief Table of buttons for the user window */
-static const struct button users_buttons[] = {
+/** @brief Table of buttons below the user list */
+static struct button users_buttons[] = {
   {
     "Add user",
     users_add,
-    "Create a new user"
-  },
-  {
-    "Edit user",
-    users_edit,
-    "Edit a user"
+    "Create a new user",
+    0
   },
   {
     "Delete user",
     users_delete,
-    "Delete a user"
+    "Delete a user",
+    0
   },
 };
 #define NUSERS_BUTTONS (sizeof users_buttons / sizeof *users_buttons)
 
 /** @brief Pop up the user management window */
 void manage_users(void) {
-  GtkWidget *tree, *buttons, *hbox;
+  GtkWidget *tree, *buttons, *hbox, *vbox, *vbox2;
   GtkCellRenderer *cr;
   GtkTreeViewColumn *col;
   
@@ -421,17 +479,41 @@ void manage_users(void) {
                                                 "text", 0,
                                                 NULL);
   gtk_tree_view_append_column(GTK_TREE_VIEW(tree), col);
-  /* Get the selection for the view and set its mode */
+  /* Get the selection for the view; set its mode; arrange for a callback when
+   * it changes */
   users_selection = gtk_tree_view_get_selection(GTK_TREE_VIEW(tree));
   gtk_tree_selection_set_mode(users_selection, GTK_SELECTION_BROWSE);
+  g_signal_connect(users_selection, "changed",
+                   G_CALLBACK(users_selection_changed), NULL);
+
   /* Create the control buttons */
   buttons = create_buttons_box(users_buttons,
                               NUSERS_BUTTONS,
-                              gtk_vbox_new(FALSE, 1));
-  /* Put it all together in an hbox */
+                              gtk_hbox_new(FALSE, 1));
+  users_delete_button = users_buttons[1].widget;
+
+  /* Buttons live below the list */
+  vbox = gtk_vbox_new(FALSE, 2);
+  gtk_box_pack_start(GTK_BOX(vbox), tree, TRUE/*expand*/, TRUE/*fill*/, 0);
+  gtk_box_pack_start(GTK_BOX(vbox), buttons, FALSE/*expand*/, FALSE, 0);
+
+  /* Create an empty user details table, and put an apply button below it */
+  users_makedetails("", "", "", "",
+                    DETAIL_VISIBLE,
+                    DETAIL_VISIBLE);
+  users_apply_button = gtk_button_new_from_stock(GTK_STOCK_APPLY);
+  g_signal_connect(users_apply_button, "clicked",
+                   G_CALLBACK(users_apply), NULL);
+  vbox2 = gtk_vbox_new(FALSE, 2);
+  gtk_box_pack_start(GTK_BOX(vbox2), users_details_table,
+                     TRUE/*expand*/, TRUE/*fill*/, 0);
+  gtk_box_pack_start(GTK_BOX(vbox2), users_apply_button,
+                     FALSE/*expand*/, FALSE, 0);
+  
+    /* User details are to the right of the list */
   hbox = gtk_hbox_new(FALSE, 2);
-  gtk_box_pack_start(GTK_BOX(hbox), tree, TRUE/*expand*/, TRUE/*fill*/, 0);
-  gtk_box_pack_start(GTK_BOX(hbox), buttons, FALSE, FALSE, 0);
+  gtk_box_pack_start(GTK_BOX(hbox), vbox, FALSE/*expand*/, FALSE, 0);
+  gtk_box_pack_start(GTK_BOX(hbox), vbox2, TRUE/*expand*/, TRUE/*fill*/, 0);
   gtk_container_add(GTK_CONTAINER(users_window), hbox);
 }