;;; MURK --- Multiserver Unibuffer iRc Klient -*- lexical-binding:t -*- ;; Copyright (C) 2024 plugd ;; Author: plugd ;; Created: 11 May 2024 ;; Version: 0.0 ;; Keywords: network ;; Homepage: http://thelambdalab.xyz/murk ;; Package-Requires: ((emacs "26")) ;; This file is not part of GNU Emacs. ;; This program is free software: you can redistribute it and/or modify ;; it under the terms of the GNU General Public License as published by ;; the Free Software Foundation, either version 3 of the License, or ;; (at your option) any later version. ;; This program is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; You should have received a copy of the GNU General Public License ;; along with this file. If not, see . ;;; Commentary: ;;; Code: (provide 'murk) ;;; Customizations (defgroup murk nil "Multiserver Unibuffer iRc Klient" :group 'network) (defcustom murk-nick "plugd" "Default nick.") (defcustom murk-default-quit-msg "Bye" "Default quit message when none supplied.") (defcustom murk-networks '(("libera" "irc.libera.chat" 6697) ("tilde" "tilde.chat" 6697)) "IRC networks.") (defcustom murk-display-header t "If non-nil, use buffer header to display information on current host and channel.") ;;; Faces ;; ;;; Global variables ;; (defvar murk-version "Murk v0.0" "Value of this string is used in response to CTCP version queries.") (defvar murk-notice-prefix "-!-") (defvar murk-error-prefix "!!!") (defvar murk-prompt-string ">") ;;; Utility procedures ;; (defun murk--filtered-join (&rest args) (string-join (seq-filter (lambda (el) el) args) " ")) (defun murk--as-string (obj) (if obj (with-output-to-string (princ obj)) nil)) ;;; Network processes ;; (defvar murk-connection-table nil "An alist associating servers to connection information. This includes the process and the response string.") (defun murk-connection-process (server) (elt (assoc server murk-connection-table) 1)) (defun murk-connection-response (server) (elt (assoc server murk-connection-table) 2)) (defun murk-set-connection-response (server string) (setf (elt (assoc server murk-connection-table) 2) string)) (defun murk-connection-close (server) (setq murk-connection-table (assoc-delete-all server murk-connection-table))) (defun murk-make-server-filter (server) (lambda (proc string) (dolist (line (split-string (concat (murk-connection-response server) string) "\n")) (if (string-suffix-p "\r" line) (murk-eval-msg-string server (string-trim line)) (murk-set-connection-response line))))) (defun murk-make-server-sentinel (server) (lambda (proc string) (unless (equal "open" (string-trim string)) (murk-display-error "Disconnected from server.") (murk-remove-contexts-for-server server) (murk-render-prompt) (murk-connection-close server)))) (defun murk-start-process (server) (let* ((row (assoc server murk-networks)) (host (elt row 1)) (port (elt row 2)) (flags (seq-drop row 3))) (make-network-process :name (concat "murk-" server) :host host :service port :family nil :filter (murk-make-server-filter server) :sentinel (murk-make-server-sentinel server) :nowait nil :tls-parameters (if (memq :notls flags) nil (cons 'gnutls-x509pki (gnutls-boot-parameters :type 'gnutls-x509pki :hostname host))) :buffer "*murk*"))) (defvar murk-ping-period 60) ;; IDEA: Have a single ping timer which pings all connected hosts (defun murk-connect (server) (if (assoc server murk-connection-table) (murk-display-error "Already connected to this network.") (if (not (assoc server murk-networks)) (murk-display-error "Network '" server "' is unknown.") (let ((proc (murk-start-process server))) (add-to-list murk-connection-table (list server proc ""))) (murk-send-msg server (murk-msg nil nil "USER" murk-nick 0 "*" murk-nick)) (murk-send-msg server (murk-msg nil nil "NICK" murk-nick))))) (defun murk-send-msg (server msg) (if murk-debug (murk-display-string nil nil (murk-msg->string msg))) (let ((proc (murk-connection-process server))) (if (and proc (eq (process-status proc) 'open)) (process-send-string proc (concat (murk-msg->string msg) "\r\n")) (murk-display-error "No server connection established.") (error "No server connection established")))) ;;; Server messages ;; (defun murk-msg (tags src cmd &rest params) (list (murk--as-string tags) (murk--as-string src) (upcase (murk--as-string cmd)) (mapcar #'murk--as-string (if (and params (listp (elt params 0))) (elt params 0) params)))) (defun murk-msg-tags (msg) (elt msg 0)) (defun murk-msg-src (msg) (elt msg 1)) (defun murk-msg-cmd (msg) (elt msg 2)) (defun murk-msg-params (msg) (elt msg 3)) (defun murk-msg-trail (msg) (let ((params (murk-msg-params msg))) (if params (elt params (- (length params) 1))))) (defvar murk-msg-regex (rx (opt (: "@" (group (* (not (or "\n" "\r" ";" " "))))) (* whitespace)) (opt (: ":" (: (group (* (not (any space "!" "@")))) (* (not (any space))))) (* whitespace)) (group (: (* (not whitespace)))) (* whitespace) (opt (group (+ not-newline)))) "Regex used to parse IRC messages. Note that this regex is incomplete. Noteably, we discard the non-nick portion of the source component of the message, as mURK doesn't use this.") (defun murk-string->msg (string) (if (string-match murk-msg-regex string) (let* ((tags (match-string 1 string)) (src (match-string 2 string)) (cmd (upcase (match-string 3 string))) (params-str (match-string 4 string)) (params (if params-str (let* ((idx (cl-search ":" params-str)) (l (split-string (string-trim (substring params-str 0 idx)))) (r (if idx (list (substring params-str (+ 1 idx))) nil))) (append l r)) nil))) (apply #'murk-msg (append (list tags src cmd) params))) (error "Failed to parse string " string))) (defun murk-msg->string (msg) (let ((tags (murk-msg-tags msg)) (src (murk-msg-src msg)) (cmd (murk-msg-cmd msg)) (params (murk-msg-params msg))) (murk--filtered-join (if tags (concat "@" tags) nil) (if src (concat ":" src) nil) cmd (if (> (length params) 1) (string-join (seq-take params (- (length params) 1)) " ") nil) (if (> (length params) 0) (concat ":" (elt params (- (length params) 1))) nil)))) ;;; Contexts and Servers ;; ;; A context is a list (server name ...) where name is a string ;; representing either a channel name or nick, and server is a symbol ;; identifying the server. ;; ;; Each server has a special context (server) used for messages ;; to/from the server itself. (defvar murk-contexts nil "List of currently-available contexts. The head of this list is always the current context.") (defun murk-current-context () "Returns the current context." (if murk-contexts (car murk-contexts) nil)) (defun murk-context-server (ctx) (elt ctx 0)) (defun murk-context-name (ctx) (elt ctx 1)) ;;; Buffer ;; (defun murk-render-prompt () (with-current-buffer "*murk*" (let ((update-point (= murk-input-marker (point))) (update-window-points (mapcar (lambda (w) (list (= (window-point w) murk-input-marker) w)) (get-buffer-window-list nil nil t)))) (save-excursion (set-marker-insertion-type murk-prompt-marker nil) (set-marker-insertion-type murk-input-marker t) (let ((inhibit-read-only t)) (delete-region murk-prompt-marker murk-input-marker) (goto-char murk-prompt-marker) (insert (propertize (let ((ctx (murk-current-context))) (if ctx (concat (murk-context-name) "@" (murk-context-server ctx)) "")) 'face 'murk-context 'read-only t) (propertize murk-prompt-string 'face 'murk-prompt 'read-only t) (propertize " " ; Need this to be separate to mark it as rear-nonsticky 'read-only t 'rear-nonsticky t))) (set-marker-insertion-type murk-input-marker nil)) (if update-point (goto-char murk-input-marker)) (dolist (v update-window-points) (if (car v) (set-window-point (cadr v) murk-input-marker)))))) (defvar murk-prompt-marker nil "Marker for prompt position in murk buffer.") (defvar murk-input-marker nil "Marker for prompt position in murk buffer.") (defun murk-setup-header () ;; To do ) (defun murk-setup-buffer () (with-current-buffer (get-buffer-create "*murk*") (setq-local scroll-conservatively 1) (setq-local buffer-invisibility-spec nil) (if (markerp murk-prompt-marker) (set-marker murk-prompt-marker (point-max)) (setq murk-prompt-marker (point-max-marker))) (if (markerp murk-input-marker) (set-marker murk-input-marker (point-max)) (setq murk-input-marker (point-max-marker))) (goto-char (point-max)) (murk-render-prompt) (if murk-display-header (murk-setup-header)))) (defun murk-clear-buffer () "Completely erase all non-prompt and non-input text from murk buffer." (with-current-buffer "*murk*" (let ((inhibit-read-only t)) (delete-region (point-min) murk-prompt-marker)))) ;;; Output formatting and highlighting ;; (defun murk--fill-strings (col indent &rest strings) (with-temp-buffer (setq buffer-invisibility-spec nil) (let ((fill-column col) (adaptive-fill-regexp (rx-to-string `(= ,indent anychar)))) (apply #'insert strings) (fill-region (point-min) (point-max) nil t) (buffer-string)))) (defun murk-context->string (context) (if context (concat (murk-context-name) "@" (murk-context-server context)) nil)) (defun murk-display-string (context prefix &rest strings) (with-current-buffer "*murk*" (save-excursion (goto-char murk-prompt-marker) (let* ((inhibit-read-only t) (old-pos (marker-position murk-prompt-marker)) (padded-timestamp (concat (format-time-string "%H:%M "))) (padded-prefix (if prefix (concat prefix " ") "")) (context-atom (if context (intern (murk-context->string context)) nil))) (insert-before-markers (murk--fill-strings 80 (+ (length padded-timestamp) (length padded-prefix)) (propertize padded-timestamp 'face 'murk-timestamp 'read-only t 'context context 'invisible context-atom) (propertize padded-prefix 'read-only t 'context context 'invisible context-atom) (concat (apply #'murk-buttonify-urls strings) "\n")))))) (murk-scroll-windows-to-last-line)) (defun murk--start-of-final-line () (with-current-buffer "*murk*" (save-excursion (goto-char (point-max)) (line-beginning-position)))) (defun murk-scroll-windows-to-last-line () (with-current-buffer "*murk*" (dolist (window (get-buffer-window-list)) (if (>= (window-point window) (murk--start-of-final-line)) (with-selected-window window (recenter -1)))))) (defconst murk-url-regex (rx (: (group (+ alpha)) "://" (group (or (+ (any alnum "." "-")) (+ (any alnum ":")))) (opt (group (: ":" (+ digit)))) (opt (group (: "/" (opt (* (any alnum "-/.,#:%=&_?~@+")) (any alnum "-/#:%=&_~@+"))))))) "Imperfect regex used to find URLs in plain text.") (defun murk-click-url (button) (browse-url (button-get button 'url))) (defun murk-buttonify-urls (&rest strings) "Turn substrings which look like urls in STRING into clickable buttons." (with-temp-buffer (apply #'insert strings) (goto-char (point-min)) (while (re-search-forward murk-url-regex nil t) (let ((url (match-string 0))) (make-text-button (match-beginning 0) (match-end 0) 'action #'murk-click-url 'url url 'follow-link t 'face 'button 'help-echo "Open URL in browser."))) (buffer-string))) ;;; Mode ;; (defvar murk-mode-map (let ((map (make-sparse-keymap))) (define-key map (kbd "RET") 'murk-enter) (define-key map (kbd "TAB") 'murk-complete-input) (when (fboundp 'evil-define-key*) (evil-define-key* 'motion map (kbd "TAB") 'murk-complete-input)) map)) (define-derived-mode murk-mode text-mode "murk" "Major mode for murk.") (when (fboundp 'evil-set-initial-state) (evil-set-initial-state 'murk-mode 'insert)) ;;; Main start procedure ;; (defun murk () "Start murk or just switch to the murk buffer if one already exists." (interactive) (if (get-buffer "*murk*") (switch-to-buffer "*murk*") (switch-to-buffer "*murk*") (murk-mode) (murk-setup-buffer)) "Started murk.") ;;; murk.el ends here