X-Git-Url: https://thelambdalab.xyz/gitweb/index.cgi?a=blobdiff_plain;f=elopher.el;h=374249724f644876db632b698757cb01566fadb5;hb=f0f484af61bc9482c8313f03e499646e80d21db7;hp=c9a63b58ad72b359a08cf19778eb6900088e9df2;hpb=62679752737a28609721478ed0fab221d062c2a2;p=elpher.git diff --git a/elopher.el b/elopher.el index c9a63b5..3742497 100644 --- a/elopher.el +++ b/elopher.el @@ -15,25 +15,33 @@ (defconst elopher-margin-width 6 "Width of left-hand margin used when rendering indicies.") -(defconst elopher-start-page - (concat "i\tfake\tfake\t1\r\n" - "i--------------------------------------------\tfake\tfake\t1\r\n" - "i Elopher Gopher Client \tfake\tfake\t1\r\n" - (format "i version %s\tfake\tfake\t1\r\n" elopher-version) - "i--------------------------------------------\tfake\tfake\t1\r\n" - "i\tfake\tfake\t1\r\n" - "iBasic usage:\tfake\tfake\t1\r\n" - "i - tab/shift-tab: next/prev directory entry\tfake\tfake\t1\r\n" - "i - RET/mouse-1: open directory entry\tfake\tfake\t1\r\n" - "i - u: return to parent directory entry\tfake\tfake\t1\r\n" - "i - g: go to a particular site\tfake\tfake\t1\r\n" - "i\tfake\tfake\t1\r\n" - "iPlaces to start exploring Gopherspace:\tfake\tfake\t1\r\n" - "1Floodgap Systems Gopher Server\t\tgopher.floodgap.com\t70\r\n" - "1Super-Dimensional Fortress\t\tsdf.org\t70\r\n" - "i\tfake\tfake\t1\r\n" - "iTest entries:\tfake\tfake\t1\r\n" - "pXKCD comic image\t/fun/xkcd/comics/2130/2137/text_entry.png\tgopher.floodgap.com\t70\r\n")) +(defconst elopher-start-index + (mapconcat 'identity + (list "i\tfake\tfake\t1" + "i--------------------------------------------\tfake\tfake\t1" + "i Elopher Gopher Client \tfake\tfake\t1" + (format "i version %s\tfake\tfake\t1" elopher-version) + "i--------------------------------------------\tfake\tfake\t1" + "i\tfake\tfake\t1" + "iBasic usage:\tfake\tfake\t1" + "i\tfake\tfake\t1" + "i - tab/shift-tab: next/prev directory entry on current page\tfake\tfake\t1" + "i - RET/mouse-1: open directory entry under cursor\tfake\tfake\t1" + "i - u: return to parent directory entry\tfake\tfake\t1" + "i - g: go to a particular page\tfake\tfake\t1" + "i - r: reload current page\tfake\tfake\t1" + "i - t: display the current page as text (i.e. \"source\")\tfake\tfake\t1" + "i\tfake\tfake\t1" + "iPlaces to start exploring Gopherspace:\tfake\tfake\t1" + "i\tfake\tfake\t1" + "1Floodgap Systems Gopher Server\t\tgopher.floodgap.com\t70" + "i\tfake\tfake\t1" + "iAlternatively, select the following item and enter some\tfake\tfake\t1" + "isearch terms:\tfake\tfake\t1" + "i\tfake\tfake\t1" + "7Veronica-2 Gopher Search Engine\t/v2/vs\tgopher.floodgap.com\t70" + ".") + "\r\n")) ;;; Customization group @@ -44,15 +52,37 @@ :group 'applications) (defcustom elopher-index-face '(foreground-color . "cyan") - "Face used for index records.") + "Face used for index records." + :type '(face)) + (defcustom elopher-text-face '(foreground-color . "white") - "Face used for text records.") + "Face used for text records." + :type '(face)) + (defcustom elopher-info-face '(foreground-color . "gray") - "Face used for info records.") + "Face used for info records." + :type '(face)) + (defcustom elopher-image-face '(foreground-color . "green") - "Face used for image records.") + "Face used for image records." + :type '(face)) + +(defcustom elopher-search-face '(foreground-color . "orange") + "Face used for image records." + :type '(face)) + +(defcustom elopher-http-face '(foreground-color . "yellow") + "Face used for image records." + :type '(face)) + (defcustom elopher-unknown-face '(foreground-color . "red") - "Face used for unknown record types.") + "Face used for unknown record types." + :type '(face)) + +(defcustom elopher-open-urls-with-eww nil + "If non-nil, open URL selectors using eww. +Otherwise, use the system browser via the BROWSE-URL function." + :type '(boolean)) ;;; Model ;; @@ -73,70 +103,103 @@ ;; Node -(defun elopher-make-node (parent address getter &optional content) - (list parent address content)) +(defun elopher-make-node (parent address getter &optional content pos) + (list parent address getter content pos)) (defun elopher-node-parent (node) - (car node)) + (elt node 0)) (defun elopher-node-address (node) - (cadr node)) + (elt node 1)) (defun elopher-node-getter (node) - (caddr node)) + (elt node 2)) (defun elopher-node-content (node) - (cadddr node)) + (elt node 3)) -(defvar elopher-start-node (elopher-make-node nil nil #'elopher-index-getter)) -(defvar elopher-current-node elopher-start-node) +(defun elopher-node-pos (node) + (elt node 4)) -(defun elopher-set-current-node-content (content) - (setcar (elopher-node-content elopher-current-node) - content)) +(defun elopher-set-node-content (node content) + (setcar (nthcdr 3 node) content)) -(defun elopher-visit-node (node) - (elopher-prepare-buffer) - (setq elopher-current-node node) - (funcall (elopher-node-getter))) +(defun elopher-set-node-pos (node pos) + (setcar (nthcdr 4 node) pos)) -(defun elopher-reload-current-node () - (elopher-prepare-buffer) - (elopher-set-current-node-content nil) - (funcall (elopher-node-getter))) +(defun elopher-save-pos () + (when elopher-current-node + (elopher-set-node-pos elopher-current-node (point)))) + +(defun elopher-restore-pos () + (let ((pos (elopher-node-pos elopher-current-node))) + (if pos + (goto-char pos) + (goto-char (point-min))))) + +;; Node graph traversal +(defvar elopher-current-node) + +(defun elopher-visit-node (node &optional raw) + (elopher-save-pos) + (setq elopher-current-node node) + (if raw + (elopher-get-node-raw) + (funcall (elopher-node-getter node)))) + +(defun elopher-visit-parent-node () + (let ((parent-node (elopher-node-parent elopher-current-node))) + (when parent-node + (elopher-visit-node parent-node)))) + +(defun elopher-reload-current-node () + (elopher-set-node-content elopher-current-node nil) + (elopher-visit-node elopher-current-node)) ;;; Buffer preparation ;; -(defun elopher-prepare-buffer () - (switch-to-buffer "*elopher*") - (elopher-mode)) - +(defmacro elopher-with-clean-buffer (&rest args) + (list 'progn + '(switch-to-buffer "*elopher*") + '(elopher-mode) + (append (list 'let '((inhibit-read-only t)) + '(erase-buffer)) + args))) ;;; Index rendering ;; (defun elopher-insert-index (string) - "Inserts the index corresponding to STRING into the current buffer." + "Insert the index corresponding to STRING into the current buffer." (dolist (line (split-string string "\r\n")) - (elopher-insert-index-record line))) + (unless (= (length line) 0) + (elopher-insert-index-record line)))) (defun elopher-insert-margin (&optional type-name) + "Insert index margin, optionally containing the TYPE-NAME, into the current buffer." (if type-name - (insert (format (concat "%" (number-to-string elopher-margin-width) "s" - (concat - (propertize "[" 'face '(foreground-color . "blue")) - (propertize type-name 'face '(foreground-color . "white")) - (propertize "]" 'face '(foreground-color . "blue")))))) + (progn + (insert (format (concat "%" (number-to-string (- elopher-margin-width 1)) "s") + (concat + (propertize "[" 'face '(foreground-color . "blue")) + (propertize type-name 'face '(foreground-color . "white")) + (propertize "]" 'face '(foreground-color . "blue"))))) + (insert " ")) (insert (make-string elopher-margin-width ?\s)))) (defun elopher-insert-index-record (line) - "Inserts the index record corresponding to LINE into the current buffer." + "Insert the index record corresponding to LINE into the current buffer." (let* ((type (elt line 0)) (fields (split-string (substring line 1) "\t")) (display-string (elt fields 0)) - (address (elopher-make-address (elt fields 1) (elt fields 2) (elt fields 3)))) + (selector (elt fields 1)) + (host (elt fields 2)) + (port (elt fields 3)) + (address (elopher-make-address selector host port)) + (help-string (format "mouse-1, RET: open %s on %s port %s" + selector host port))) (pcase type (?i (elopher-insert-margin) (insert (propertize display-string @@ -148,7 +211,8 @@ address #'elopher-get-text-node) 'action #'elopher-click-link - 'follow-link t)) + 'follow-link t + 'help-echo help-string)) (?1 (elopher-insert-margin "/") (insert-text-button display-string 'face elopher-index-face @@ -156,7 +220,34 @@ address #'elopher-get-index-node) 'action #'elopher-click-link - 'follow-link t)) + 'follow-link t + 'help-echo help-string)) + ((or ?g ?p ?I) (elopher-insert-margin "im") + (insert-text-button display-string + 'face elopher-image-face + 'elopher-node (elopher-make-node elopher-current-node + address + #'elopher-get-image-node) + 'action #'elopher-click-link + 'follow-link t + 'help-echo help-string)) + (?7 (elopher-insert-margin "S") + (insert-text-button display-string + 'face elopher-search-face + 'elopher-node (elopher-make-node elopher-current-node + address + #'elopher-get-search-node) + 'action #'elopher-click-link + 'follow-link t + 'help-echo help-string)) + (?h (elopher-insert-margin "W") + (let ((url (elt (split-string selector "URL:") 1))) + (insert-text-button display-string + 'face elopher-http-face + 'elopher-url url + 'action #'elopher-click-url + 'follow-link t + 'help-echo (format "mouse-1, RET: open url %s" url)))) (?.) ; Occurs at end of index, can safely ignore. (tp (elopher-insert-margin (concat (char-to-string tp) "?")) (insert (propertize display-string @@ -170,6 +261,8 @@ (defvar elopher-selector-string) (defun elopher-get-selector (address after) + "Retrieve selector specified by ADDRESS, then execute AFTER. +The result is stored as a string in the variable elopher-selector-string." (setq elopher-selector-string "") (let ((p (get-process "elopher-process"))) (if p (delete-process p))) @@ -186,33 +279,126 @@ ;; Index retrieval (defun elopher-get-index-node () - (let ((content (elopher-node-content elopher-node-current)) - (address (elopher-node-address elopher-node-current))) + (let ((content (elopher-node-content elopher-current-node)) + (address (elopher-node-address elopher-current-node))) (if content - (insert content) + (progn + (elopher-with-clean-buffer + (insert content)) + (elopher-restore-pos)) (if address - (elopher-get-selector address - (lambda (proc event) - (let ((inhibit-read-only t)) - (elopher-insert-index elopher-selector-string)) - (elopher-set-current-node-content (buffer-string)))) - (elopher-insert-index elopher-start-page))))) + (progn + (elopher-with-clean-buffer + (insert "LOADING DIRECTORY...")) + (elopher-get-selector address + (lambda (proc event) + (elopher-with-clean-buffer + (elopher-insert-index elopher-selector-string)) + (elopher-restore-pos) + (elopher-set-node-content elopher-current-node + (buffer-string))))) + (progn + (elopher-with-clean-buffer + (elopher-insert-index elopher-start-index)) + (elopher-restore-pos) + (elopher-set-node-content elopher-current-node + (buffer-string))))))) ;; Text retrieval +(defun elopher-process-text (string) + (let ((chopped-str (replace-regexp-in-string "\r\n\.\r\n$" "\r\n" string))) + (replace-regexp-in-string "\r" "" chopped-str))) + (defun elopher-get-text-node () (let ((content (elopher-node-content elopher-current-node)) (address (elopher-node-address elopher-current-node))) (if content - (let ((inhibit-read-only t)) - (insert content)) - (elopher-get-selector address - (lambda (proc event) - (let ((inhibit-read-only t)) - (insert elopher-selector-string)) - (elopher-set-current-node-content elopher-selector-string)))))) - -;;; Navigation methods + (progn + (elopher-with-clean-buffer + (insert content)) + (elopher-restore-pos)) + (progn + (elopher-with-clean-buffer + (insert "LOADING TEXT...")) + (elopher-get-selector address + (lambda (proc event) + (elopher-with-clean-buffer + (insert (elopher-process-text elopher-selector-string))) + (elopher-restore-pos) + (elopher-set-node-content elopher-current-node + (buffer-string)))))))) + +;; Image retrieval + +(defun elopher-get-image-node () + (let ((content (elopher-node-content elopher-current-node)) + (address (elopher-node-address elopher-current-node))) + (if content + (progn + (elopher-with-clean-buffer + (insert-image content)) + (setq cursor-type nil) + (elopher-restore-pos)) + (progn + (elopher-with-clean-buffer + (insert "LOADING IMAGE...")) + (elopher-get-selector address + (lambda (proc event) + (let ((image (create-image + (string-as-unibyte elopher-selector-string) + nil t))) + (elopher-with-clean-buffer + (insert-image image)) + (setq cursor-type nil) + (elopher-restore-pos) + (elopher-set-node-content elopher-current-node image)))))))) + +;; Search retrieval + +(defun elopher-get-search-node () + (let* ((content (elopher-node-content elopher-current-node)) + (address (elopher-node-address elopher-current-node))) + (if content + (progn + (elopher-with-clean-buffer + (insert content)) + (elopher-restore-pos) + (message "Displaying cached search results. Reload to perform a new search.")) + (let* ((query-string (read-string "Query: ")) + (query-selector (concat (elopher-address-selector address) "\t" query-string)) + (search-address (elopher-make-address query-selector + (elopher-address-host address) + (elopher-address-port address)))) + (elopher-with-clean-buffer + (insert "LOADING RESULTS...")) + (elopher-get-selector search-address + (lambda (proc event) + (elopher-with-clean-buffer + (elopher-insert-index elopher-selector-string)) + (goto-char (point-min)) + (elopher-set-node-content elopher-current-node + (buffer-string)))))))) + +(defun elopher-get-node-raw () + (let* ((content (elopher-node-content elopher-current-node)) + (address (elopher-node-address elopher-current-node))) + (elopher-with-clean-buffer + (insert "LOADING RAW SERVER RESPONSE...")) + (if address + (elopher-get-selector address + (lambda (proc event) + (elopher-with-clean-buffer + (insert elopher-selector-string)) + (goto-char (point-min)))) + (progn + (elopher-with-clean-buffer + (insert elopher-start-index)) + (goto-char (point-min))))) + (message "Displaying raw server response. Reload to return to standard view.")) + + +;;; Navigation procedures ;; (defun elopher-next-link () @@ -227,6 +413,12 @@ (let ((node (button-get button 'elopher-node))) (elopher-visit-node node))) +(defun elopher-click-url (button) + (let ((url (button-get button 'elopher-url))) + (if elopher-open-urls-with-eww + (browse-web url) + (browse-url url)))) + (defun elopher-follow-closest-link () (interactive) (push-button)) @@ -234,51 +426,68 @@ (defun elopher-go () "Go to a particular gopher site." (interactive) - (let* ((selector "") - (hostname (read-from-minibuffer "Gopher host: ")) - (port 70) + (let* ( + (hostname (read-string "Gopher host: ")) + (selector (read-string "Selector (default none): " nil nil "")) + (port (read-string "Port (default 70): " nil nil 70)) (address (list selector hostname port))) (elopher-visit-node (elopher-make-node elopher-current-node address - #'elopher-index-getter)))) + #'elopher-get-index-node)))) (defun elopher-reload () - "Reload current site." + "Reload current page." (interactive) (elopher-reload-current-node)) +(defun elopher-view-raw () + "View current page as plain text." + (interactive) + (elopher-visit-node elopher-current-node t)) -;;; Main start procedure -;; -(defun elopher () - "Start elopher with default landing page." +(defun elopher-back () + "Go to previous site." (interactive) - (elopher-visit-node elopher-start-node)) + (if (elopher-node-parent elopher-current-node) + (elopher-visit-parent-node) + (message "No previous site."))) ;;; Mode and keymap ;; -(setq elopher-mode-map +(defvar elopher-mode-map (let ((map (make-sparse-keymap))) (define-key map (kbd "") 'elopher-next-link) (define-key map (kbd "") 'elopher-prev-link) - (define-key map (kbd "u") 'elopher-pop-history) + (define-key map (kbd "u") 'elopher-back) (define-key map (kbd "g") 'elopher-go) (define-key map (kbd "r") 'elopher-reload) - (when (require 'evil nil t) + (define-key map (kbd "w") 'elopher-view-raw) + (when (fboundp 'evil-define-key) (evil-define-key 'normal map (kbd "C-]") 'elopher-follow-closest-link - (kbd "C-t") 'elopher-pop-history - (kbd "u") 'elopher-pop-history + (kbd "C-t") 'elopher-back + (kbd "u") 'elopher-back (kbd "g") 'elopher-go - (kbd "r") 'elopher-reload)) - map)) - ;; "Keymap for gopher client.") + (kbd "r") 'elopher-reload + (kbd "w") 'elopher-view-raw)) + map) + "Keymap for gopher client.") (define-derived-mode elopher-mode special-mode "elopher" "Major mode for elopher, an elisp gopher client.") +;;; Main start procedure +;; +(defun elopher () + "Start elopher with default landing page." + (interactive) + (setq elopher-current-node nil) + (let ((start-node (elopher-make-node nil nil #'elopher-get-index-node))) + (elopher-visit-node start-node))) + ;;; elopher.el ends here +