Changeset 319 in code for trunk/logger.go

Timestamp:

Jun 5, 2020, 9:50:31 PM (5 years ago)

Author:

delthas

Message:

Add support for downstream CHATHISTORY

This adds support for the WIP (at the time of this commit)
draft/chathistory extension, based on the draft at [1] and the
additional comments at [2].

This gets the history by parsing the chat logs, and is therefore only
enabled when the logs are enabled and the log path is configured.

Getting the history only from the logs adds some restrictions:

• we cannot get history by msgid (those are not logged)
• we cannot get the users masks (maybe they could be inferred from the JOIN etc, but it is not worth the effort and would not work every time)

The regular soju network history is not sent to clients that support
draft/chathistory, so that they can fetch what they need by manually
calling CHATHISTORY.

The only supported command is BEFORE for now, because that is the only
required command for an app that offers an "infinite history scrollback"
feature.

Regarding implementation, rather than reading the file from the end in
reverse, we simply start from the beginning of each log file, store each
PRIVMSG into a ring, then add the last lines of that ring into the
history we'll return later. The message parsing implementation must be
kept somewhat fast because an app could potentially request thousands of
messages in several files. Here we are using simple sscanf and indexOf
rather than regexps.

In case some log files do not contain any message (for example because
the user had not joined a channel at that time), we try up to a 100 days
of empty log files before giving up.

[1]: ​https://github.com/prawnsalad/ircv3-specifications/pull/3/files
[2]: ​https://github.com/ircv3/ircv3-specifications/pull/393/files#r350210018

File:

• trunk/logger.go (modified) (2 diffs)

trunk/logger.go

@@ -2 +2 @@
 
 import (
+        "bufio"
         "fmt"
         "os"
@@ -133 +134 @@
         }
 }
+
+func parseMessagesBefore(network *network, entity string, timestamp time.Time, limit int) ([]*irc.Message, error) {
+        year, month, day := timestamp.Date()
+        path := logPath(network, entity, timestamp)
+        f, err := os.Open(path)
+        if err != nil {
+                if os.IsNotExist(err) {
+                        return nil, nil
+                }
+                return nil, err
+        }
+        defer f.Close()
+
+        historyRing := make([]*irc.Message, limit)
+        cur := 0
+
+        sc := bufio.NewScanner(f)
+        for sc.Scan() {
+                line := sc.Text()
+                var hour, minute, second int
+                _, err := fmt.Sscanf(line, "[%02d:%02d:%02d] ", &hour, &minute, &second)
+                if err != nil {
+                        return nil, err
+                }
+                message := line[11:]
+                // TODO: support NOTICE
+                if !strings.HasPrefix(message, "<") {
+                        continue
+                }
+                i := strings.Index(message, "> ")
+                if i == -1 {
+                        continue
+                }
+                t := time.Date(year, month, day, hour, minute, second, 0, time.Local)
+                if !t.Before(timestamp) {
+                        break
+                }
+
+                sender := message[1:i]
+                text := message[i+2:]
+                historyRing[cur%limit] = &irc.Message{
+                        Tags: map[string]irc.TagValue{
+                                "time": irc.TagValue(t.UTC().Format(serverTimeLayout)),
+                        },
+                        Prefix: &irc.Prefix{
+                                Name: sender,
+                        },
+                        Command: "PRIVMSG",
+                        Params:  []string{entity, text},
+                }
+                cur++
+        }
+        if sc.Err() != nil {
+                return nil, sc.Err()
+        }
+
+        n := limit
+        if cur < limit {
+                n = cur
+        }
+        start := (cur - n + limit) % limit
+
+        if start+n <= limit { // ring doesnt wrap
+                return historyRing[start : start+n], nil
+        } else { // ring wraps
+                history := make([]*irc.Message, n)
+                r := copy(history, historyRing[start:])
+                copy(history[r:], historyRing[:n-r])
+                return history, nil
+        }
+}