;;; Code: (require 'json) (require 'plz) (require 'message) (require 'rx) (defgroup discoursel nil "Discourse TODO") (defcustom discoursel-instance "https://discourse.ubuntu.com" "The Discourse instance." :group 'discoursel :type 'string) (defcustom discoursel-fetch-all-posts-from-topic t "Whether to fetch all posts from a certain topic. If t, the default, all posts are fetched (which may take a while depending on the topic's length). If nil, pagination is enabled and the user needs to ask for more posts manually and incrementally." :group 'discoursel :type 'boolean) (defvar discoursel-buffer-list nil "List of discoursel buffers.") (defface discoursel-topic-face '((((class color) (background light)) (:foreground "#000")) (((class color) (background dark)) (:foreground "#fff"))) "Face used for topics." :group 'discoursel) (defface discoursel-username-face '((((class color) (background light)) (:foreground "#aa0")) (((class color) (background dark)) (:foreground "#ff0"))) "Face used for usernames." :group 'discoursel) (defface discoursel-code-face '((((class color) (background light)) (:background "#cdcecc" :extend t)) (((class color) (background dark)) (:background "#17211c" :extend t))) "Face used for code blocks." :group 'discoursel) (defun discoursel--parse-pre (tag) (let ((p (point)) (shr-folding-mode 'none)) (shr-ensure-newline) (shr-generic tag) (shr-ensure-newline) (add-text-properties p (point) '(pre-tag t face discoursel-code-face)))) (defun discoursel--get (endpoint &optional args) (condition-case plzerror (plz 'get (concat discoursel-instance "/" endpoint ".json" (when args (concat "?" (mapconcat (lambda (elt) (concat (car elt) "=" (cdr elt))) args "&")))) :as #'json-read) (plz-error (error "Could not query endpoint '%s': '%s'" endpoint (plz-error-message plzerror))))) (defun discoursel--latest-topics () (let* ((r (discoursel--get "latest")) (topics (alist-get 'topics (alist-get 'topic_list r))) (users (alist-get 'users r))) (with-current-buffer (discoursel-get-create-buffer) (cl-map 'vector (lambda (topic) (let* ((userid (alist-get 'user_id (aref (alist-get 'posters topic) 0))) (username (seq-find (lambda (v) (= (alist-get 'id v) userid)) users)) (inhibit-read-only t)) (insert (propertize (format "%s (by %s)\n" (propertize (alist-get 'title topic) 'face 'discoursel-topic-face) (propertize (alist-get 'name username) 'face 'discoursel-username-face)) 'discoursel-topic-slug (alist-get 'slug topic) 'discoursel-topic-id (alist-get 'id topic))))) topics)))) ;;;###autoload (defun discoursel-update () (interactive) (with-current-buffer (discoursel-get-create-buffer) (save-excursion (let ((inhibit-read-only t)) (discoursel--latest-topics))))) (defun discoursel--get-name-or-username (post) (let ((name (alist-get 'display_username post))) (if (and name (not (string-empty-p name))) name (alist-get 'username post)))) (defun discoursel--parse-heading (dom) "Prepend tag (DOM) with the equivalent number of sharp (#) characters." (let* ((idx (1- (length dom))) ;; This is a bit hacky and assumes that the text will always ;; be available as the last item in the list. (tagname (symbol-name (car dom))) (level (string-to-number (string-remove-prefix "h" tagname))) (sharps (make-string level ?#)) (face (intern (concat "shr-" tagname))) (possible-text (nth idx dom))) (when (stringp possible-text) (setf (nth idx dom) (concat sharps " " possible-text))) (shr-heading dom face))) (defun discoursel-topic-next-entry () (interactive) (let ((pos (point))) (save-excursion (setq pos (next-single-char-property-change pos 'post-id)) (goto-char pos) (while (and (not (eobp)) (not (looking-at-p (rx line-start "Author:")))) (setq pos (next-single-char-property-change pos 'post-id)) (goto-char pos)) (when (eobp) (setq pos nil))) (when pos (goto-char pos)))) (defun discoursel-topic-previous-entry () (interactive) (let ((pos (point))) (setq pos (or (previous-single-property-change pos 'post-id) (point-min))) (goto-char pos) (while (and (not (bobp)) (not (looking-at-p (rx line-start (or "Author:" "Title:"))))) (setq pos (or (previous-single-property-change pos 'post-id) (point-min))) (goto-char pos)))) (defun discoursel--insert-post (post &optional post-title) (let* ((post-slug (alist-get 'topic_slug post)) (post-id (alist-get 'id post)) ; (topic-title (alist-get 'title r)) (post-date (alist-get 'created_at post)) (post-date-string (format-time-string "%c" (encode-time (parse-time-string post-date)))) (post-author (discoursel--get-name-or-username post)) (post-html-content (alist-get 'cooked post))) ;; (userid (alist-get 'user_id r)) ;; (participants (alist-get 'participants (alist-get 'details r))) ;; (topic-username (alist-get 'username first-post)) ;; (topic-author-alist (seq-find (lambda (p) ;; (string= (alist-get 'username p) topic-username)) ;; participants)) ;; ; (topic-author (alist-get 'username topic-author-alist)) ;; (topic-flairname (alist-get 'name topic-author-alist)) ;; (topic-author (concat topic-flairname " ("(alist-get 'username first-post) ")")) (save-excursion (insert (with-temp-buffer (when post-title (insert (format (propertize "Title: %s\n" 'face 'message-header-name) (propertize post-title 'face 'message-header-subject)))) (insert (format (propertize "Author: %s\n" 'face 'message-header-name) (propertize post-author 'face 'message-header-to))) (insert (format (propertize "Date: %s\n" 'face 'message-header-name) (propertize post-date-string 'face 'message-header-other))) (insert "\n") (save-excursion (insert post-html-content)) (let ((shr-use-fonts nil) (shr-external-rendering-functions '((pre . discoursel--parse-pre) (h1 . discoursel--parse-heading) (h2 . discoursel--parse-heading) (h3 . discoursel--parse-heading) (h4 . discoursel--parse-heading) (h5 . discoursel--parse-heading) (h6 . discoursel--parse-heading)))) (shr-render-region (point) (point-max))) (put-text-property (point-min) (point-max) 'post-id post-id) (buffer-string)))))) (defun discoursel-render-posts-from-topic (topic &optional start-idx) (let* ((posts (alist-get 'posts (alist-get 'post_stream topic))) (topic-slug (alist-get 'slug topic)) (buf (discoursel-get-create-buffer topic-slug)) (startidx (or start-idx 0))) (with-current-buffer buf (save-excursion (let ((inhibit-read-only t)) (cl-loop for idx from startidx to (1- (length posts)) do (goto-char (point-max)) (insert "\n" (with-temp-buffer (insert "
") (shr-render-region (point-min) (point-max)) (buffer-string))) (discoursel--insert-post (aref posts idx)))))))) (defun discoursel--fetch-all-posts-from-topic (topic-id number-of-pages) (cl-loop for page from 2 to number-of-pages do (with-delayed-message (2 (format "Rendering page %d out of %d..." page number-of-pages)) (let* ((topic (discoursel--get (concat "t/" topic-id) `(("page" . ,(number-to-string page))))) (posts (alist-get 'posts (alist-get 'post_stream topic)))) (discoursel-render-posts-from-topic topic))))) (defun discoursel--open-topic (&optional id) (interactive) (when (and (not (eq major-mode 'discoursel-mode)) (not id)) (user-error "You must be in a discoursel buffer")) (let* ((topic-id (number-to-string (or id (get-text-property (point) 'discoursel-topic-id)))) (topic (discoursel--get (concat "t/" topic-id))) (posts (alist-get 'posts (alist-get 'post_stream topic))) (first-post (aref posts 0)) (topic-slug (alist-get 'slug topic)) (topic-title (alist-get 'title topic)) (buf (discoursel-get-create-buffer topic-slug)) (number-of-pages (ceiling (/ (float (alist-get 'posts_count topic)) (float (alist-get 'chunk_size topic)))))) (switch-to-buffer buf) (with-current-buffer buf (discoursel-topic-mode) (save-excursion (let ((inhibit-read-only t)) (erase-buffer) (discoursel--insert-post first-post topic-title) (discoursel-render-posts-from-topic topic 1) (when (> number-of-pages 1) (if discoursel-fetch-all-posts-from-topic (discoursel--fetch-all-posts-from-topic topic-id number-of-pages) (message "TODO")))))))) (defun discoursel-open-topic (id) (interactive "nTopic ID: ") (discoursel--open-topic id)) (defun discoursel-get-create-buffer (&optional name) (let* ((bufname (concat "*discoursel" (when name (concat "-" name)) "*")) (buf (get-buffer-create bufname))) (prog1 buf (unless (memq buf discoursel-buffer-list) (add-to-list 'discoursel-buffer-list buf))))) (defun discoursel-kill-buffer (&optional buf) (interactive) (let* ((tmpb (or buf (current-buffer))) (b (get-buffer tmpb))) (unless b (error "Invalid buffer %s" b)) (with-current-buffer b (unless (derived-mode-p 'discoursel-mode) (error "Cannot kill buffer %s: not a discoursel buffer" (buffer-name)))) (kill-buffer b) (setq discoursel-buffer-list (remove b discoursel-buffer-list)))) (defun discoursel-exit () (interactive) (dolist (buf discoursel-buffer-list) (kill-buffer buf)) (setq discoursel-buffer-list nil)) (defvar discoursel-mode-map (let ((map (make-sparse-keymap))) (prog1 map (suppress-keymap map) (define-key map "n" #'next-line) (define-key map "p" #'previous-line) (define-key map (kbd "RET") #'discoursel--open-topic) (define-key map "j" #'discoursel-open-topic) (define-key map "q" #'discoursel-exit) (define-key map "g" #'discoursel-update))) "Keymap for `discoursel-mode'.") (defvar discoursel-topic-mode-map (let ((map (make-sparse-keymap))) (prog1 map (suppress-keymap map) (define-key map "n" #'next-line) (define-key map "p" #'previous-line) (define-key map (kbd "M-n") #'discoursel-topic-next-entry) (define-key map (kbd "M-p") #'discoursel-topic-previous-entry) (define-key map "q" #'discoursel-kill-buffer))) "Keymap for `discoursel-topic-mode'.") (define-derived-mode discoursel-mode special-mode "Discourse client" "Major mode for interacting with Discourse instances. \\{discoursel-mode-map}" (use-local-map discoursel-mode-map)) (define-derived-mode discoursel-topic-mode discoursel-mode "Discoursel topic" "Major mode for interacting with Discourse topics. \\{discoursel-topic-mode-map}" (use-local-map discoursel-topic-mode-map)) (defun discoursel () "Enter discoursel." (interactive) (switch-to-buffer (discoursel-get-create-buffer)) (unless (eq major-mode 'discoursel-mode) (discoursel-mode)) (discoursel-update)) ;; TODO ;; (with-current-buffer (get-buffer-create "test-discourse") ;; (insert (plz 'get "https://discourse.ubuntu.com/raw/39765")) ;; (markdown-mode) ;; (setq buffer-read-only t)) ;; (with-current-buffer (get-buffer-create "test-discourse4") ;; (let* ((ttt (plz 'get "https://discourse.ubuntu.com/latest.json" :as #'json-read)) ;; (topics (alist-get 'topics (alist-get 'topic_list ttt))) ;; (users (alist-get 'users ttt))) ;; (cl-map 'vector ;; (lambda (topic) ;; (let* ((uid (alist-get 'user_id (aref (alist-get 'posters topic) 0))) ;; (user (seq-find (lambda (v) (= (alist-get 'id v) uid)) ;; users))) ;; (insert ;; (propertize (format "%s [%s]\n" (alist-get 'title topic) (alist-get 'name user)) ;; 'discoursel-slug (alist-get 'slug topic))))) ;; topics))) (provide 'discoursel) ;;; discoursel.el ends here