[vte/wip/command-notify: 1/2] emulation: Add sequences and signals for desktop notification

[Debarshi Ray <debarshir src gnome org>]

commit 6e05d8872434f7295f88a6f740f4358f180cddfb
Author: Debarshi Ray <debarshir gnome org>
Date:   Wed Jan 7 16:01:00 2015 +0100

    emulation: Add sequences and signals for desktop notification
    
    Add sequences
      OSC 777 ; notify ; SUMMARY ; BODY BEL
      OSC 777 ; notify ; SUMMARY BEL
      OSC 777 ; notify ; SUMMARY ; BODY ST
      OSC 777 ; notify ; SUMMARY ST
    
    that let terminal applications send a notification to the desktop
    environment.
    
    Based on Enlightenment's Terminology:
    https://phab.enlightenment.org/T1765

 src/caps.c         |    4 ++
 src/marshal.list   |    1 +
 src/vte-private.h  |    5 +++
 src/vte.c          |   38 ++++++++++++++++++++++
 src/vteseq-n.gperf |    1 +
 src/vteseq.c       |   90 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 src/vteterminal.h  |    3 +-
 7 files changed, 141 insertions(+), 1 deletions(-)
---
diff --git a/src/caps.c b/src/caps.c
index b51882f..0fe0661 100644
--- a/src/caps.c
+++ b/src/caps.c
@@ -254,6 +254,8 @@ const char _vte_xterm_capability_strings[] =
         ENTRY(OSC "117" BEL, "reset-highlight-background-color")
         ENTRY(OSC "118" BEL, "reset-tek-cursor-color")
         ENTRY(OSC "119" BEL, "reset-highlight-foreground-color")
+        ENTRY(OSC "777;%s;%s;%s" BEL, "send-notification")
+        ENTRY(OSC "777;%s;%s" BEL, "send-notification")
 
         COMMENT(/* Set text parameters, ST-terminated versions. */)
         ENTRY(OSC ";%s" ST, "set-icon-and-window-title") COMMENT(/* undocumented default */)
@@ -289,6 +291,8 @@ const char _vte_xterm_capability_strings[] =
         ENTRY(OSC "117" ST, "reset-highlight-background-color")
         ENTRY(OSC "118" ST, "reset-tek-cursor-color")
         ENTRY(OSC "119" ST, "reset-highlight-foreground-color")
+        ENTRY(OSC "777;%s;%s;%s" ST, "send-notification")
+        ENTRY(OSC "777;%s;%s" ST, "send-notification")
 
         COMMENT(/* These may be bogus, I can't find docs for them anywhere (#104154). */)
         ENTRY(OSC "21;%s" BEL, "set-text-property-21")
diff --git a/src/marshal.list b/src/marshal.list
index 0276422..2c35c68 100644
--- a/src/marshal.list
+++ b/src/marshal.list
@@ -1,4 +1,5 @@
 VOID:INT,INT
 VOID:OBJECT,OBJECT
+VOID:STRING,STRING
 VOID:STRING,UINT
 VOID:UINT,UINT
diff --git a/src/vte-private.h b/src/vte-private.h
index 3a40131..f1dc0e5 100644
--- a/src/vte-private.h
+++ b/src/vte-private.h
@@ -420,6 +420,11 @@ struct _VteTerminalPrivate {
        gboolean cursor_moved_pending;
        gboolean contents_changed_pending;
 
+       /* desktop notification */
+       gboolean notification_received;
+       gchar *notification_summary;
+       gchar *notification_body;
+
        /* window name changes */
         gchar *window_title;
        gchar *window_title_changed;
diff --git a/src/vte.c b/src/vte.c
index a2f9a2c..ad7af36 100644
--- a/src/vte.c
+++ b/src/vte.c
@@ -8579,6 +8579,9 @@ vte_terminal_finalize(GObject *object)
 
        remove_update_timeout (terminal);
 
+       g_free (terminal->pvt->notification_summary);
+       g_free (terminal->pvt->notification_body);
+
        /* discard title updates */
         g_free(terminal->pvt->window_title);
         g_free(terminal->pvt->window_title_changed);
@@ -10304,6 +10307,7 @@ vte_terminal_class_init(VteTerminalClass *klass)
        klass->child_exited = NULL;
        klass->encoding_changed = NULL;
        klass->char_size_changed = NULL;
+       klass->notification_received = NULL;
        klass->window_title_changed = NULL;
        klass->icon_title_changed = NULL;
        klass->selection_changed = NULL;
@@ -10378,6 +10382,25 @@ vte_terminal_class_init(VteTerminalClass *klass)
                      1, G_TYPE_INT);
 
         /**
+         * VteTerminal::notification-received:
+         * @vteterminal: the object which received the signal
+         * @summary: The summary
+         * @body: (allow-none): Extra optional text
+         *
+         * Emitted when a process running in the terminal wants to
+         * send a notification to the desktop environment.
+         */
+        g_signal_new(I_("notification-received"),
+                     G_OBJECT_CLASS_TYPE(klass),
+                     G_SIGNAL_RUN_LAST,
+                     G_STRUCT_OFFSET(VteTerminalClass, notification_received),
+                     NULL,
+                     NULL,
+                     _vte_marshal_VOID__STRING_STRING,
+                     G_TYPE_NONE,
+                     2, G_TYPE_STRING, G_TYPE_STRING);
+
+        /**
          * VteTerminal::window-title-changed:
          * @vteterminal: the object which received the signal
          *
@@ -12374,6 +12397,16 @@ need_processing (VteTerminal *terminal)
        return _vte_incoming_chunks_length (terminal->pvt->incoming) != 0;
 }
 
+static void
+vte_terminal_emit_notification_received (VteTerminal *terminal)
+{
+       _vte_debug_print (VTE_DEBUG_SIGNALS,
+                         "Emitting `notification-received'.\n");
+       g_signal_emit_by_name (terminal, "notification-received",
+                              terminal->pvt->notification_summary,
+                              terminal->pvt->notification_body);
+}
+
 /* Emit an "icon-title-changed" signal. */
 static void
 vte_terminal_emit_icon_title_changed(VteTerminal *terminal)
@@ -12421,6 +12454,11 @@ vte_terminal_emit_pending_signals(VteTerminal *terminal)
 
        vte_terminal_emit_adjustment_changed (terminal);
 
+       if (terminal->pvt->notification_received) {
+               vte_terminal_emit_notification_received (terminal);
+               terminal->pvt->notification_received = FALSE;
+       }
+
        if (terminal->pvt->window_title_changed) {
                g_free (terminal->pvt->window_title);
                terminal->pvt->window_title = terminal->pvt->window_title_changed;
diff --git a/src/vteseq-n.gperf b/src/vteseq-n.gperf
index f28625b..7ee43be 100644
--- a/src/vteseq-n.gperf
+++ b/src/vteseq-n.gperf
@@ -167,3 +167,4 @@ struct vteseq_n_struct {
 #"reset-mouse-cursor-foreground-color", VTE_SEQUENCE_HANDLER_NULL
 "set-current-directory-uri", VTE_SEQUENCE_HANDLER(vte_sequence_handler_set_current_directory_uri)
 "set-current-file-uri", VTE_SEQUENCE_HANDLER(vte_sequence_handler_set_current_file_uri)
+"send-notification", VTE_SEQUENCE_HANDLER(vte_sequence_handler_send_notification)
diff --git a/src/vteseq.c b/src/vteseq.c
index b2f4b7d..eb34848 100644
--- a/src/vteseq.c
+++ b/src/vteseq.c
@@ -2221,6 +2221,96 @@ vte_sequence_handler_return_terminal_id (VteTerminal *terminal, GValueArray *par
        vte_sequence_handler_send_primary_device_attributes (terminal, params);
 }
 
+static void
+vte_sequence_handler_send_notification (VteTerminal *terminal, GValueArray *params)
+{
+       GValue *value;
+       const char *end;
+       char *option = NULL;
+       char *str = NULL;
+       char *p, *validated;
+
+       g_clear_pointer (&terminal->pvt->notification_summary, g_free);
+       g_clear_pointer (&terminal->pvt->notification_body, g_free);
+
+       value = g_value_array_get_nth (params, 0);
+       if (value == NULL) {
+               goto out;
+       }
+
+       if (G_VALUE_HOLDS_STRING (value)) {
+               option = g_value_dup_string (value);
+       } else if (G_VALUE_HOLDS_POINTER (value)) {
+               option = vte_ucs4_to_utf8 (terminal, g_value_get_pointer (value));
+       } else {
+               goto out;
+       }
+
+       if (g_strcmp0 (option, "notify") != 0) {
+               goto out;
+       }
+
+       value = g_value_array_get_nth (params, 1);
+       if (value == NULL) {
+               goto out;
+       }
+
+       if (G_VALUE_HOLDS_STRING (value)) {
+               str = g_value_dup_string (value);
+       } else if (G_VALUE_HOLDS_POINTER (value)) {
+               str = vte_ucs4_to_utf8 (terminal, g_value_get_pointer (value));
+       } else {
+               goto out;
+       }
+
+       g_utf8_validate (str, strlen (str), &end);
+       validated = g_strndup (str, end - str);
+
+       /* No control characters allowed. */
+       for (p = validated; *p != '\0'; p++) {
+               if ((*p & 0x1f) == *p) {
+                       *p = ' ';
+               }
+       }
+
+       terminal->pvt->notification_summary = validated;
+       g_free (str);
+
+       terminal->pvt->notification_received = TRUE;
+       if (params->n_values == 2) {
+               goto out;
+       }
+
+       value = g_value_array_get_nth (params, 2);
+       if (value == NULL) {
+               goto out;
+       }
+
+       if (G_VALUE_HOLDS_STRING (value)) {
+               str = g_value_dup_string (value);
+       } else if (G_VALUE_HOLDS_POINTER (value)) {
+               str = vte_ucs4_to_utf8 (terminal, g_value_get_pointer (value));
+       } else {
+               goto out;
+       }
+
+       g_utf8_validate (str, strlen (str), &end);
+       validated = g_strndup (str, end - str);
+
+       /* No control characters allowed. */
+       for (p = validated; *p != '\0'; p++) {
+               if ((*p & 0x1f) == *p) {
+                       *p = ' ';
+               }
+       }
+
+       terminal->pvt->notification_body = validated;
+       g_free (str);
+
+ out:
+       g_free (option);
+}
+
 /* Send secondary device attributes. */
 static void
 vte_sequence_handler_send_secondary_device_attributes (VteTerminal *terminal, GValueArray *params)
diff --git a/src/vteterminal.h b/src/vteterminal.h
index 59f8ce7..c73267e 100644
--- a/src/vteterminal.h
+++ b/src/vteterminal.h
@@ -72,6 +72,7 @@ struct _VteTerminalClass {
        void (*child_exited)(VteTerminal* terminal, int status);
        void (*encoding_changed)(VteTerminal* terminal);
        void (*char_size_changed)(VteTerminal* terminal, guint char_width, guint char_height);
+       void (*notification_received)(VteTerminal* terminal, const gchar *summary, const gchar *body);
        void (*window_title_changed)(VteTerminal* terminal);
        void (*icon_title_changed)(VteTerminal* terminal);
        void (*selection_changed)(VteTerminal* terminal);
@@ -105,7 +106,7 @@ struct _VteTerminalClass {
        void (*bell)(VteTerminal* terminal);
 
         /* Padding for future expansion. */
-        gpointer padding[16];
+        gpointer padding[15];
 
         VteTerminalClassPrivate *priv;
 };