cmd-display-menu.c

   1 /* $OpenBSD$ */
   2
   3 /*
   4  * Copyright (c) 2019 Nicholas Marriott <nicholas.marriott@gmail.com>
   5  *
   6  * Permission to use, copy, modify, and distribute this software for any
   7  * purpose with or without fee is hereby granted, provided that the above
   8  * copyright notice and this permission notice appear in all copies.
   9  *
  10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  14  * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
  15  * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
  16  * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  17  */
  18
  19 #include <sys/types.h>
  20
  21 #include <paths.h>
  22 #include <stdlib.h>
  23 #include <string.h>
  24
  25 #include "tmux.h"
  26
  27 /*
  28  * Display a menu on a client.
  29  */
  30
  31 static enum args_parse_type     cmd_display_menu_args_parse(struct args *,
  32                                     u_int, char **);
  33 static enum cmd_retval          cmd_display_menu_exec(struct cmd *,
  34                                     struct cmdq_item *);
  35 static enum cmd_retval          cmd_display_popup_exec(struct cmd *,
  36                                     struct cmdq_item *);
  37
  38 const struct cmd_entry cmd_display_menu_entry = {
  39         .name = "display-menu",
  40         .alias = "menu",
  41
  42         .args = { "c:t:S:OT:x:y:", 1, -1, cmd_display_menu_args_parse },
  43         .usage = "[-O] [-c target-client] [-S starting-choice] "
  44                  CMD_TARGET_PANE_USAGE " [-T title] [-x position] "
  45                  "[-y position] name key command ...",
  46
  47         .target = { 't', CMD_FIND_PANE, 0 },
  48
  49         .flags = CMD_AFTERHOOK|CMD_CLIENT_CFLAG,
  50         .exec = cmd_display_menu_exec
  51 };
  52
  53 const struct cmd_entry cmd_display_popup_entry = {
  54         .name = "display-popup",
  55         .alias = "popup",
  56
  57         .args = { "Bb:Cc:d:e:Eh:s:S:t:T:w:x:y:", 0, -1, NULL },
  58         .usage = "[-BCE] [-b border-lines] [-c target-client] "
  59                  "[-d start-directory] [-e environment] [-h height] "
  60                  "[-s style] [-S border-style] " CMD_TARGET_PANE_USAGE
  61                  "[-T title] [-w width] [-x position] [-y position] "
  62                  "[shell-command]",
  63
  64         .target = { 't', CMD_FIND_PANE, 0 },
  65
  66         .flags = CMD_AFTERHOOK|CMD_CLIENT_CFLAG,
  67         .exec = cmd_display_popup_exec
  68 };
  69
  70 static enum args_parse_type
  71 cmd_display_menu_args_parse(struct args *args, u_int idx, __unused char **cause)
  72 {
  73         u_int                    i = 0;
  74         enum args_parse_type     type = ARGS_PARSE_STRING;
  75
  76         for (;;) {
  77                 type = ARGS_PARSE_STRING;
  78                 if (i == idx)
  79                         break;
  80                 if (*args_string(args, i++) == '\0')
  81                         continue;
  82
  83                 type = ARGS_PARSE_STRING;
  84                 if (i++ == idx)
  85                         break;
  86
  87                 type = ARGS_PARSE_COMMANDS_OR_STRING;
  88                 if (i++ == idx)
  89                         break;
  90         }
  91         return (type);
  92 }
  93
  94 static int
  95 cmd_display_menu_get_position(struct client *tc, struct cmdq_item *item,
  96     struct args *args, u_int *px, u_int *py, u_int w, u_int h)
  97 {
  98         struct tty              *tty = &tc->tty;
  99         struct cmd_find_state   *target = cmdq_get_target(item);
 100         struct key_event        *event = cmdq_get_event(item);
 101         struct session          *s = tc->session;
 102         struct winlink          *wl = target->wl;
 103         struct window_pane      *wp = target->wp;
 104         struct style_ranges     *ranges = NULL;
 105         struct style_range      *sr = NULL;
 106         const char              *xp, *yp;
 107         char                    *p;
 108         int                      top;
 109         u_int                    line, ox, oy, sx, sy, lines, position;
 110         long                     n;
 111         struct format_tree      *ft;
 112
 113         /*
 114          * Work out the position from the -x and -y arguments. This is the
 115          * bottom-left position.
 116          */
 117
 118         /* If the popup is too big, stop now. */
 119         if (w > tty->sx || h > tty->sy)
 120                 return (0);
 121
 122         /* Create format with mouse position if any. */
 123         ft = format_create_from_target(item);
 124         if (event->m.valid) {
 125                 format_add(ft, "popup_mouse_x", "%u", event->m.x);
 126                 format_add(ft, "popup_mouse_y", "%u", event->m.y);
 127         }
 128
 129         /*
 130          * If there are any status lines, add this window position and the
 131          * status line position.
 132          */
 133         top = status_at_line(tc);
 134         if (top != -1) {
 135                 lines = status_line_size(tc);
 136                 if (top == 0)
 137                         top = lines;
 138                 else
 139                         top = 0;
 140                 position = options_get_number(s->options, "status-position");
 141
 142                 for (line = 0; line < lines; line++) {
 143                         ranges = &tc->status.entries[line].ranges;
 144                         TAILQ_FOREACH(sr, ranges, entry) {
 145                                 if (sr->type != STYLE_RANGE_WINDOW)
 146                                         continue;
 147                                 if (sr->argument == (u_int)wl->idx)
 148                                         break;
 149                         }
 150                         if (sr != NULL)
 151                                 break;
 152                 }
 153
 154                 if (sr != NULL) {
 155                         format_add(ft, "popup_window_status_line_x", "%u",
 156                             sr->start);
 157                         if (position == 0) {
 158                                 format_add(ft, "popup_window_status_line_y",
 159                                     "%u", line + 1 + h);
 160                         } else {
 161                                 format_add(ft, "popup_window_status_line_y",
 162                                     "%u", tty->sy - lines + line);
 163                         }
 164                 }
 165
 166                 if (position == 0)
 167                         format_add(ft, "popup_status_line_y", "%u", lines + h);
 168                 else {
 169                         format_add(ft, "popup_status_line_y", "%u",
 170                             tty->sy - lines);
 171                 }
 172         } else
 173                 top = 0;
 174
 175         /* Popup width and height. */
 176         format_add(ft, "popup_width", "%u", w);
 177         format_add(ft, "popup_height", "%u", h);
 178
 179         /* Position so popup is in the centre. */
 180         n = (long)(tty->sx - 1) / 2 - w / 2;
 181         if (n < 0)
 182                 format_add(ft, "popup_centre_x", "%u", 0);
 183         else
 184                 format_add(ft, "popup_centre_x", "%ld", n);
 185         n = (tty->sy - 1) / 2 + h / 2;
 186         if (n >= tty->sy)
 187                 format_add(ft, "popup_centre_y", "%u", tty->sy - h);
 188         else
 189                 format_add(ft, "popup_centre_y", "%ld", n);
 190
 191         /* Position of popup relative to mouse. */
 192         if (event->m.valid) {
 193                 n = (long)event->m.x - w / 2;
 194                 if (n < 0)
 195                         format_add(ft, "popup_mouse_centre_x", "%u", 0);
 196                 else
 197                         format_add(ft, "popup_mouse_centre_x", "%ld", n);
 198                 n = event->m.y - h / 2;
 199                 if (n + h >= tty->sy) {
 200                         format_add(ft, "popup_mouse_centre_y", "%u",
 201                             tty->sy - h);
 202                 } else
 203                         format_add(ft, "popup_mouse_centre_y", "%ld", n);
 204                 n = (long)event->m.y + h;
 205                 if (n >= tty->sy)
 206                         format_add(ft, "popup_mouse_top", "%u", tty->sy - 1);
 207                 else
 208                         format_add(ft, "popup_mouse_top", "%ld", n);
 209                 n = event->m.y - h;
 210                 if (n < 0)
 211                         format_add(ft, "popup_mouse_bottom", "%u", 0);
 212                 else
 213                         format_add(ft, "popup_mouse_bottom", "%ld", n);
 214         }
 215
 216         /* Position in pane. */
 217         tty_window_offset(&tc->tty, &ox, &oy, &sx, &sy);
 218         n = top + wp->yoff - oy + h;
 219         if (n >= tty->sy)
 220                 format_add(ft, "popup_pane_top", "%u", tty->sy - h);
 221         else
 222                 format_add(ft, "popup_pane_top", "%ld", n);
 223         format_add(ft, "popup_pane_bottom", "%u", top + wp->yoff + wp->sy - oy);
 224         format_add(ft, "popup_pane_left", "%u", wp->xoff - ox);
 225         n = (long)wp->xoff + wp->sx - ox - w;
 226         if (n < 0)
 227                 format_add(ft, "popup_pane_right", "%u", 0);
 228         else
 229                 format_add(ft, "popup_pane_right", "%ld", n);
 230
 231         /* Expand horizontal position. */
 232         xp = args_get(args, 'x');
 233         if (xp == NULL || strcmp(xp, "C") == 0)
 234                 xp = "#{popup_centre_x}";
 235         else if (strcmp(xp, "R") == 0)
 236                 xp = "#{popup_pane_right}";
 237         else if (strcmp(xp, "P") == 0)
 238                 xp = "#{popup_pane_left}";
 239         else if (strcmp(xp, "M") == 0)
 240                 xp = "#{popup_mouse_centre_x}";
 241         else if (strcmp(xp, "W") == 0)
 242                 xp = "#{popup_window_status_line_x}";
 243         p = format_expand(ft, xp);
 244         n = strtol(p, NULL, 10);
 245         if (n + w >= tty->sx)
 246                 n = tty->sx - w;
 247         else if (n < 0)
 248                 n = 0;
 249         *px = n;
 250         log_debug("%s: -x: %s = %s = %u (-w %u)", __func__, xp, p, *px, w);
 251         free(p);
 252
 253         /* Expand vertical position  */
 254         yp = args_get(args, 'y');
 255         if (yp == NULL || strcmp(yp, "C") == 0)
 256                 yp = "#{popup_centre_y}";
 257         else if (strcmp(yp, "P") == 0)
 258                 yp = "#{popup_pane_bottom}";
 259         else if (strcmp(yp, "M") == 0)
 260                 yp = "#{popup_mouse_top}";
 261         else if (strcmp(yp, "S") == 0)
 262                 yp = "#{popup_status_line_y}";
 263         else if (strcmp(yp, "W") == 0)
 264                 yp = "#{popup_window_status_line_y}";
 265         p = format_expand(ft, yp);
 266         n = strtol(p, NULL, 10);
 267         if (n < h)
 268                 n = 0;
 269         else
 270                 n -= h;
 271         if (n + h >= tty->sy)
 272                 n = tty->sy - h;
 273         else if (n < 0)
 274                 n = 0;
 275         *py = n;
 276         log_debug("%s: -y: %s = %s = %u (-h %u)", __func__, yp, p, *py, h);
 277         free(p);
 278
 279         format_free(ft);
 280         return (1);
 281 }
 282
 283 static enum cmd_retval
 284 cmd_display_menu_exec(struct cmd *self, struct cmdq_item *item)
 285 {
 286         struct args             *args = cmd_get_args(self);
 287         struct cmd_find_state   *target = cmdq_get_target(item);
 288         struct key_event        *event = cmdq_get_event(item);
 289         struct client           *tc = cmdq_get_target_client(item);
 290         struct menu             *menu = NULL;
 291         struct menu_item         menu_item;
 292         const char              *key, *name;
 293         char                    *title, *cause;
 294         int                      flags = 0, starting_choice = 0;
 295         u_int                    px, py, i, count = args_count(args);
 296
 297         if (tc->overlay_draw != NULL)
 298                 return (CMD_RETURN_NORMAL);
 299
 300         if (args_has(args, 'S')) {
 301                 if (strcmp(args_get(args, 'S'), "-") == 0)
 302                         starting_choice = -1;
 303                 else {
 304                         starting_choice = args_strtonum(args, 'S', 0, UINT_MAX,
 305                             &cause);
 306                         if (cause != NULL) {
 307                                 cmdq_error(item, "starting choice %s", cause);
 308                                 free(cause);
 309                                 return (CMD_RETURN_ERROR);
 310                         }
 311                 }
 312         }
 313
 314         if (args_has(args, 'T'))
 315                 title = format_single_from_target(item, args_get(args, 'T'));
 316         else
 317                 title = xstrdup("");
 318         menu = menu_create(title);
 319
 320         for (i = 0; i != count; /* nothing */) {
 321                 name = args_string(args, i++);
 322                 if (*name == '\0') {
 323                         menu_add_item(menu, NULL, item, tc, target);
 324                         continue;
 325                 }
 326
 327                 if (count - i < 2) {
 328                         cmdq_error(item, "not enough arguments");
 329                         free(title);
 330                         menu_free(menu);
 331                         return (CMD_RETURN_ERROR);
 332                 }
 333                 key = args_string(args, i++);
 334
 335                 menu_item.name = name;
 336                 menu_item.key = key_string_lookup_string(key);
 337                 menu_item.command = args_string(args, i++);
 338
 339                 menu_add_item(menu, &menu_item, item, tc, target);
 340         }
 341         free(title);
 342         if (menu == NULL) {
 343                 cmdq_error(item, "invalid menu arguments");
 344                 return (CMD_RETURN_ERROR);
 345         }
 346         if (menu->count == 0) {
 347                 menu_free(menu);
 348                 return (CMD_RETURN_NORMAL);
 349         }
 350         if (!cmd_display_menu_get_position(tc, item, args, &px, &py,
 351             menu->width + 4, menu->count + 2)) {
 352                 menu_free(menu);
 353                 return (CMD_RETURN_NORMAL);
 354         }
 355
 356         if (args_has(args, 'O'))
 357                 flags |= MENU_STAYOPEN;
 358         if (!event->m.valid)
 359                 flags |= MENU_NOMOUSE;
 360         if (menu_display(menu, flags, starting_choice, item, px, py, tc, target,
 361             NULL, NULL) != 0)
 362                 return (CMD_RETURN_NORMAL);
 363         return (CMD_RETURN_WAIT);
 364 }
 365
 366 static enum cmd_retval
 367 cmd_display_popup_exec(struct cmd *self, struct cmdq_item *item)
 368 {
 369         struct args             *args = cmd_get_args(self);
 370         struct cmd_find_state   *target = cmdq_get_target(item);
 371         struct session          *s = target->s;
 372         struct client           *tc = cmdq_get_target_client(item);
 373         struct tty              *tty = &tc->tty;
 374         const char              *value, *shell, *shellcmd = NULL;
 375         const char              *style = args_get(args, 's');
 376         const char              *border_style = args_get(args, 'S');
 377         char                    *cwd, *cause = NULL, **argv = NULL, *title;
 378         int                      flags = 0, argc = 0;
 379         enum box_lines           lines = BOX_LINES_DEFAULT;
 380         u_int                    px, py, w, h, count = args_count(args);
 381         struct args_value       *av;
 382         struct environ          *env = NULL;
 383         struct options          *o = s->curw->window->options;
 384         struct options_entry    *oe;
 385
 386         if (args_has(args, 'C')) {
 387                 server_client_clear_overlay(tc);
 388                 return (CMD_RETURN_NORMAL);
 389         }
 390         if (tc->overlay_draw != NULL)
 391                 return (CMD_RETURN_NORMAL);
 392
 393         h = tty->sy / 2;
 394         if (args_has(args, 'h')) {
 395                 h = args_percentage(args, 'h', 1, tty->sy, tty->sy, &cause);
 396                 if (cause != NULL) {
 397                         cmdq_error(item, "height %s", cause);
 398                         free(cause);
 399                         return (CMD_RETURN_ERROR);
 400                 }
 401         }
 402
 403         w = tty->sx / 2;
 404         if (args_has(args, 'w')) {
 405                 w = args_percentage(args, 'w', 1, tty->sx, tty->sx, &cause);
 406                 if (cause != NULL) {
 407                         cmdq_error(item, "width %s", cause);
 408                         free(cause);
 409                         return (CMD_RETURN_ERROR);
 410                 }
 411         }
 412
 413         if (w > tty->sx)
 414                 w = tty->sx;
 415         if (h > tty->sy)
 416                 h = tty->sy;
 417         if (!cmd_display_menu_get_position(tc, item, args, &px, &py, w, h))
 418                 return (CMD_RETURN_NORMAL);
 419
 420         value = args_get(args, 'b');
 421         if (args_has(args, 'B'))
 422                 lines = BOX_LINES_NONE;
 423         else if (value != NULL) {
 424                 oe = options_get(o, "popup-border-lines");
 425                 lines = options_find_choice(options_table_entry(oe), value,
 426                     &cause);
 427                 if (cause != NULL) {
 428                         cmdq_error(item, "popup-border-lines %s", cause);
 429                         free(cause);
 430                         return (CMD_RETURN_ERROR);
 431                 }
 432         }
 433
 434         value = args_get(args, 'd');
 435         if (value != NULL)
 436                 cwd = format_single_from_target(item, value);
 437         else
 438                 cwd = xstrdup(server_client_get_cwd(tc, s));
 439         if (count == 0)
 440                 shellcmd = options_get_string(s->options, "default-command");
 441         else if (count == 1)
 442                 shellcmd = args_string(args, 0);
 443         if (count <= 1 && (shellcmd == NULL || *shellcmd == '\0')) {
 444                 shellcmd = NULL;
 445                 shell = options_get_string(s->options, "default-shell");
 446                 if (!checkshell(shell))
 447                         shell = _PATH_BSHELL;
 448                 cmd_append_argv(&argc, &argv, shell);
 449         } else
 450                 args_to_vector(args, &argc, &argv);
 451
 452         if (args_has(args, 'e') >= 1) {
 453                 env = environ_create();
 454                 av = args_first_value(args, 'e');
 455                 while (av != NULL) {
 456                         environ_put(env, av->string, 0);
 457                         av = args_next_value(av);
 458                 }
 459         }
 460
 461         if (args_has(args, 'T'))
 462                 title = format_single_from_target(item, args_get(args, 'T'));
 463         else
 464                 title = xstrdup("");
 465         if (args_has(args, 'E') > 1)
 466                 flags |= POPUP_CLOSEEXITZERO;
 467         else if (args_has(args, 'E'))
 468                 flags |= POPUP_CLOSEEXIT;
 469         if (popup_display(flags, lines, item, px, py, w, h, env, shellcmd, argc,
 470             argv, cwd, title, tc, s, style, border_style, NULL, NULL) != 0) {
 471                 cmd_free_argv(argc, argv);
 472                 if (env != NULL)
 473                         environ_free(env);
 474                 free(cwd);
 475                 free(title);
 476                 return (CMD_RETURN_NORMAL);
 477         }
 478         if (env != NULL)
 479                 environ_free(env);
 480         free(cwd);
 481         free(title);
 482         cmd_free_argv(argc, argv);
 483         return (CMD_RETURN_WAIT);
 484 }