1 ;;; lurk.el --- Little Unified iRc Klient -*- lexical-binding:t -*-
3 ;; Copyright (C) 2021 Tim Vaughan
5 ;; Author: Tim Vaughan <timv@ughan.xyz>
6 ;; Created: 14 June 2021
9 ;; Homepage: http://thelambdalab.xyz/lurk
10 ;; Package-Requires: ((emacs "26"))
12 ;; This file is not part of GNU Emacs.
14 ;; This program is free software: you can redistribute it and/or modify
15 ;; it under the terms of the GNU General Public License as published by
16 ;; the Free Software Foundation, either version 3 of the License, or
17 ;; (at your option) any later version.
19 ;; This program is distributed in the hope that it will be useful,
20 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
21 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 ;; GNU General Public License for more details.
24 ;; You should have received a copy of the GNU General Public License
25 ;; along with this file. If not, see <http://www.gnu.org/licenses/>.
38 "Little Unified iRc Klient."
41 (defcustom lurk-nick "plugd"
43 (defcustom lurk-full-name "plugd"
45 (defcustom lurk-user-name "plugd"
48 (defcustom lurk-networks
49 '(("libera" "irc.libera.chat" 6697)
50 ("freenode" "chat.freenode.net" 6697)
51 ("local" "localhost" 6697))
54 (defcustom lurk-allow-ipv6 nil
55 "Set to non-nil to allow use of IPv6.")
61 '((t :inherit font-lock-preprocessor-face))
62 "Face used for Lurk text.")
64 (defface lurk-your-nick
65 '((t :inherit font-lock-constant-face))
66 "Face used for highlighting your nick.")
69 '((t :inherit org-level-2))
70 "Face used for the prompt.")
73 '((t :inherit org-list-dt))
74 "Face used for the context name in the prompt.")
77 '((t :inherit font-lock-preprocessor-face))
78 "Face used for faded Lurk text.")
81 '((t :inherit font-lock-function-name-face))
82 "Face used for bold Lurk text.")
85 '((t :inherit font-lock-regexp-grouping-construct))
86 "Face used for Lurk error text.")
91 (defvar lurk-version "Lurk v0.1")
93 (defvar lurk-notice-prefix
96 "-" 'face 'lurk-faded)
100 "-" 'face 'lurk-faded)))
102 (defvar lurk-error-prefix
103 (propertize "!!!" 'face 'lurk-error))
106 (defvar lurk-prompt-string
107 (propertize "> " 'face 'lurk-prompt))
113 (defvar lurk-response "")
115 (defun lurk-filter (proc string)
116 (dolist (line (split-string (concat lurk-response string) "\n"))
117 (if (string-suffix-p "\r" line)
118 (lurk-eval-msg-string (string-trim line))
119 (setq lurk-response line))))
121 (defun lurk-sentinel (proc string)
122 (unless (equal "open" (string-trim string))
123 (lurk-display-error "Disconnected from server.")
124 (clrhash lurk-contexts)
125 (setq lurk-current-context nil)
127 (cancel-timer lurk-ping-timer)))
129 (defun lurk-start-process (network)
130 (let* ((row (assoc network lurk-networks))
133 (flags (seq-drop row 3)))
134 (make-network-process :name "lurk"
137 :family (if lurk-allow-ipv6 nil 'ipv4)
138 :filter #'lurk-filter
139 :sentinel #'lurk-sentinel
141 :tls-parameters (if (memq :notls flags)
143 (cons 'gnutls-x509pki
144 (gnutls-boot-parameters
145 :type 'gnutls-x509pki
149 (defvar lurk-ping-timer nil)
150 (defvar lurk-ping-period 60)
152 (defun lurk-ping-function ()
153 (lurk-send-msg (lurk-msg nil nil "PING" (car (process-contact (get-process "lurk")))))
154 (setq lurk-ping-timer (run-with-timer lurk-ping-period nil #'lurk-ping-function)))
156 (defun lurk-connect (network)
157 (if (get-process "lurk")
158 (lurk-display-error "Already connected. Disconnect first.")
159 (if (not (assoc network lurk-networks))
160 (lurk-display-error "Network '" network "' is unknown.")
161 (clrhash lurk-contexts)
162 (setq lurk-current-context nil)
163 (lurk-start-process network)
164 (lurk-send-msg (lurk-msg nil nil "USER" lurk-user-name 0 "*" lurk-full-name))
165 (lurk-send-msg (lurk-msg nil nil "NICK" lurk-nick))
166 (setq lurk-ping-timer (run-with-timer lurk-ping-period nil #'lurk-ping-function)))))
169 (defun lurk-send-msg (msg)
170 (let ((proc (get-process "lurk")))
171 (if (and proc (eq (process-status proc) 'open))
172 (process-send-string proc (concat (lurk-msg->string msg) "\r\n"))
173 (lurk-display-error "No server connection established.")
174 (error "No server connection established"))))
180 (defun lurk--as-string (obj)
182 (with-output-to-string (princ obj))
185 (defun lurk-msg (tags src cmd &rest params)
186 (list (lurk--as-string tags)
187 (lurk--as-string src)
188 (upcase (lurk--as-string cmd))
189 (mapcar #'lurk--as-string
190 (if (and params (listp (elt params 0)))
194 (defun lurk-msg-tags (msg) (elt msg 0))
195 (defun lurk-msg-src (msg) (elt msg 1))
196 (defun lurk-msg-cmd (msg) (elt msg 2))
197 (defun lurk-msg-params (msg) (elt msg 3))
198 (defun lurk-msg-trail (msg)
199 (let ((params (lurk-msg-params msg)))
201 (elt params (- (length params) 1)))))
203 (defvar lurk-msg-regex
205 (opt (: "@" (group (* (not (or "\n" "\r" ";" " ")))))
207 (opt (: ":" (: (group (* (not (any space "!" "@"))))
208 (* (not (any space)))))
210 (group (: (* (not whitespace))))
212 (opt (group (+ not-newline))))
213 "Regex used to parse IRC messages.
214 Note that this regex is incomplete. Noteably, we discard the non-nick
215 portion of the source component of the message, as LURK doesn't use this.")
217 (defun lurk-string->msg (string)
218 (if (string-match lurk-msg-regex string)
219 (let* ((tags (match-string 1 string))
220 (src (match-string 2 string))
221 (cmd (upcase (match-string 3 string)))
222 (params-str (match-string 4 string))
225 (let* ((idx (cl-search ":" params-str))
226 (l (split-string (string-trim (substring params-str 0 idx))))
227 (r (if idx (list (substring params-str (+ 1 idx))) nil)))
230 (apply #'lurk-msg (append (list tags src cmd) params)))
231 (error "Failed to parse string " string)))
233 (defun lurk--filtered-join (&rest args)
234 (string-join (seq-filter (lambda (el) el) args) " "))
236 (defun lurk-msg->string (msg)
237 (let ((tags (lurk-msg-tags msg))
238 (src (lurk-msg-src msg))
239 (cmd (lurk-msg-cmd msg))
240 (params (lurk-msg-params msg)))
242 (if tags (concat "@" tags) nil)
243 (if src (concat ":" src) nil)
245 (if (> (length params) 1)
246 (string-join (seq-take params (- (length params) 1)) " ")
248 (if (> (length params) 0)
249 (concat ":" (elt params (- (length params) 1)))
256 (defvar lurk-current-context nil)
257 (defvar lurk-contexts (make-hash-table :test #'equal))
259 (defun lurk-add-context (name)
260 (puthash name nil lurk-contexts))
262 (defun lurk-del-context (name)
263 (remhash name lurk-contexts))
265 (defun lurk-get-context-users (name)
266 (gethash name lurk-contexts))
268 (defun lurk-add-context-users (context users)
271 (gethash context lurk-contexts))
274 (defun lurk-del-context-user (context user)
276 (remove user (gethash context lurk-contexts))
279 (defun lurk-del-user (user)
280 (dolist (context (lurk-get-context-list))
281 (lurk-del-context-user context user)))
283 (defun lurk-get-context-type (name)
285 ((string-prefix-p "#" name) 'channel)
286 ((string-match-p (rx (or "." "localhost")) name) 'host)
289 (defun lurk-get-context-list ()
291 (maphash (lambda (key val)
292 (cl-pushnew key res))
296 (defun lurk-get-next-context (&optional prev)
297 (if lurk-current-context
298 (let* ((context-list (if prev
299 (reverse (lurk-get-context-list))
300 (lurk-get-context-list)))
301 (context-list* (member lurk-current-context context-list)))
302 (if (> (length context-list*) 1)
307 (defun lurk-cycle-contexts (&optional rev)
308 (if lurk-current-context
310 (setq lurk-current-context (lurk-get-next-context rev))
311 (lurk-render-prompt))
312 (lurk-display-error "No channels joined.")))
314 (defun lurk-cycle-contexts-forward ()
316 (lurk-cycle-contexts))
318 (defun lurk-cycle-contexts-reverse ()
320 (lurk-cycle-contexts t))
326 (defun lurk-display-string (&rest strings)
327 (with-current-buffer (get-buffer-create "*lurk*")
329 (goto-char lurk-prompt-marker)
330 (let ((inhibit-read-only t)
331 (old-pos (marker-position lurk-prompt-marker))
332 (adaptive-fill-regexp (rx (= 6 anychar))))
333 (insert-before-markers
334 (propertize (concat (format-time-string "%H:%M") " ")
337 (propertize (concat (apply #'concat strings) "\n")
339 (fill-region old-pos lurk-prompt-marker)))))
341 (defun lurk-render-prompt ()
342 (with-current-buffer "*lurk*"
343 (let ((update-point (= lurk-input-marker (point)))
344 (update-window-points (mapcar (lambda (w)
345 (list (= (window-point w) lurk-input-marker)
347 (get-buffer-window-list nil nil t))))
349 (set-marker-insertion-type lurk-prompt-marker nil)
350 (set-marker-insertion-type lurk-input-marker t)
351 (let ((inhibit-read-only t))
352 (delete-region lurk-prompt-marker lurk-input-marker)
353 (goto-char lurk-prompt-marker)
355 (propertize (if lurk-current-context
360 (propertize lurk-prompt-string
364 (set-marker-insertion-type lurk-input-marker nil))
366 (goto-char lurk-input-marker))
367 (dolist (v update-window-points)
369 (set-window-point (cadr v) lurk-input-marker))))))
371 (defvar lurk-prompt-marker nil
372 "Marker for prompt position in LURK buffer.")
374 (defvar lurk-input-marker nil
375 "Marker for prompt position in LURK buffer.")
377 (defun lurk-setup-buffer ()
378 (with-current-buffer (get-buffer-create "*lurk*")
379 (setq-local scroll-conservatively 1)
380 (if (markerp lurk-prompt-marker)
381 (set-marker lurk-prompt-marker (point-max))
382 (setq lurk-prompt-marker (point-max-marker)))
383 (if (markerp lurk-input-marker)
384 (set-marker lurk-input-marker (point-max))
385 (setq lurk-input-marker (point-max-marker)))
386 (goto-char (point-max))
387 (lurk-render-prompt)))
390 ;;; Output formatting
393 (defun lurk-display-message (from to text)
394 (let ((context (if (equal from lirc-nick) to from)))
397 (pcase (lurk-get-context-type to)
398 ('channel (concat to " <" from "> " text))
399 ('nick (concat "[" from " -> " to "] " text))
401 (error "Unsupported context type")))
403 'help-echo (concat "Context: " to)))))
405 (defun lurk-display-notice (context &rest notices)
408 (concat lurk-notice-prefix " " (apply #'concat notices))
409 'help-echo (concat "Context: " (or context "none")))))
411 (defun lurk-display-error (&rest messages)
413 (concat lurk-error-prefix " "
414 (propertize (apply #'concat messages)
415 'face 'lurk-error))))
417 ;;; Message evaluation
420 (defun lurk-eval-msg-string (string)
421 ;; (lurk-display-string string)
422 (let* ((msg (lurk-string->msg string)))
423 (pcase (lurk-msg-cmd msg)
426 (lurk-msg nil nil "PONG" (lurk-msg-params msg))))
427 ;; (lurk-display-notice nil "ping-pong (server initiated)"))
430 ;; (lurk-display-notice nil "ping-pong (client initiated)"))
433 (let* ((params (lurk-msg-params msg))
434 (channel (elt params 2))
435 (names (split-string (elt params 3))))
436 (lurk-add-context-users channel names)))
439 (lurk-display-notice nil
440 (lurk--as-string (length (lurk-get-context-users lurk-current-context)))
441 " users in " lurk-current-context))
443 ((rx (= 3 (any digit)))
444 (lurk-display-notice nil (mapconcat 'identity (cdr (lurk-msg-params msg)) " ")))
447 (guard (equal lurk-nick (lurk-msg-src msg))))
448 (let ((channel (car (lurk-msg-params msg))))
449 (lurk-add-context channel)
450 (setq lurk-current-context channel)
451 (lurk-display-notice nil "Joining channel " channel)
452 (lurk-render-prompt)))
455 (let ((channel (car (lurk-msg-params msg)))
456 (nick (lurk-msg-src msg)))
457 (lurk-add-context-users channel (list nick))
458 (lurk-display-notice channel nick " joined channel " channel)))
461 (guard (equal lurk-nick (lurk-msg-src msg))))
462 (let ((channel (car (lurk-msg-params msg))))
463 (lurk-display-notice channel "Left channel " channel)
464 (lurk-del-context channel)
465 (if (equal channel lurk-current-context)
466 (setq lurk-current-context (lurk-get-next-context)))
467 (lurk-render-prompt)))
470 (let ((channel (car (lurk-msg-params msg)))
471 (nick (lurk-msg-src msg)))
472 (lurk-del-context-user channel nick)
473 (lurk-display-notice channel nick " left channel " channel)))
476 (let ((nick (lurk-msg-src msg))
477 (reason (mapconcat 'identity (lurk-msg-params msg) " ")))
479 (lurk-display-notice nil nick " quit: " reason)))
482 (guard (equal lurk-nick (lurk-msg-src msg))))
483 (setq lurk-nick (car (lurk-msg-params msg)))
484 (lurk-display-notice nil "Set nick to " lurk-nick))
487 (let ((old-nick (lurk-msg-src msg))
488 (new-nick (car (lurk-msg-params msg))))
489 (lurk-display-notice nil nick " is now known as " new-nick)
490 (lurk-rename-user nick new-nick)))
493 (let ((nick (lurk-msg-src msg))
494 (channel (car (lurk-msg-params msg)))
495 (text (cadr (lurk-msg-params msg))))
497 ((rx (: "\01VERSION "
498 (let version (* (not "\01")))
500 (lurk-display-notice nil "CTCP version reply from " nick ": " version))
502 (lurk-display-notice nil text)))))
505 (let* ((from (lurk-msg-src msg))
506 (params (lurk-msg-params msg))
508 (text (cadr params)))
511 (let ((version-string (concat lurk-version " - running on GNU Emacs " emacs-version)))
512 (lurk-send-msg (lurk-msg nil nil "NOTICE"
513 (list from (concat "\01VERSION "
516 (lurk-display-notice nil "CTCP version request received from " from))
518 ((rx (let ping (: "\01PING " (* (not "\01")) "\01")))
519 (lurk-send-msg (lurk-msg nil nil "NOTICE" (list from ping)))
520 (lurk-display-notice "CTCP ping received from " from))
523 (lurk-display-notice "CTCP userinfo request from " from " (no response sent)"))
526 (lurk-display-message from to text)))))
528 (lurk-display-string (lurk-msg->string msg))))))
534 (defun lurk-enter-string (string)
535 (if (string-prefix-p "/" string)
536 (pcase (substring string 1)
537 ((rx (: "CONNECT " (let network (* not-newline))))
538 (lurk-display-notice nil "Attempting to connect to " network "...")
539 (lurk-connect network))
541 ((rx (: "TOPIC " (let new-topic (* not-newline))))
542 (lurk-send-msg (lurk-msg nil nil "TOPIC" lurk-current-context new-topic)))
544 ((rx (: "ME " (let action (* not-newline))))
545 (lurk-send-msg (lurk-msg nil nil "PRIVMSG"
546 (list lurk-current-context
547 (concat "\01ACTION " action "\01"))))
548 (lurk-display-action lurk-nick action))
550 ((rx (: "VERSION" " " (let nick (* (not whitespace)))))
551 (lurk-send-msg (lurk-msg nil nil "PRIVMSG"
552 (list nick "\01VERSION\01")))
553 (lurk-display-notice nil "CTCP version request sent to " nick))
555 ((rx "PART" (opt (: " " (let channel (* not-newline)))))
556 (if (or lurk-current-context channel)
557 (lurk-send-msg (lurk-msg nil nil "PART" (if channel
559 lurk-current-context)))
560 (lurk-display-error "No current channel to leave.")))
563 (let to (* (not whitespace)))
565 (let text (* not-newline)))
566 (lurk-send-msg (lurk-msg nil nil "PRIVMSG" to text))
567 (lurk-display-message lurk-nick to text))
569 ((rx (: (let cmd-str (+ (not whitespace)))
570 (opt (: " " (let params-str (* not-newline))))))
571 (lurk-send-msg (lurk-msg nil nil (upcase cmd-str)
573 (split-string params-str)
576 (unless (string-empty-p string)
577 (if lurk-current-context
579 (lurk-send-msg (lurk-msg nil nil "PRIVMSG"
582 (lurk-display-message lurk-nick lurk-current-context string))
583 (lurk-display-error "No current context.")))))
586 "Enter current contents of line after prompt."
588 (with-current-buffer "*lurk*"
590 (buffer-substring lurk-input-marker (point-max)))
591 (let ((inhibit-read-only t))
592 (delete-region lurk-input-marker (point-max)))))
598 (defvar lurk-mode-map
599 (let ((map (make-sparse-keymap)))
600 (define-key map (kbd "RET") 'lurk-enter)
601 (define-key map (kbd "<C-tab>") 'lurk-cycle-contexts-forward)
602 (define-key map (kbd "<C-S-tab>") 'lurk-cycle-contexts-reverse)
605 (define-derived-mode lurk-mode text-mode "lurk"
606 "Major mode for LURK.")
608 (when (fboundp 'evil-set-initial-state)
609 (evil-set-initial-state 'lurk-mode 'insert))
611 ;;; Main start procedure
615 "Switch to *lurk* buffer."
617 (if (get-buffer "*lurk*")
618 (switch-to-buffer "*lurk*")
619 (switch-to-buffer "*lurk*"))
626 ;;; lurk.el ends here