From dc7b26268398cc72eb7fad17acc4adc07fd6f55e Mon Sep 17 00:00:00 2001 From: Case Duckworth Date: Tue, 15 Nov 2022 19:51:16 -0600 Subject: Customize browse-url --- lisp/+browse-url.el | 88 ++++++++++++++++++++++++++++++++++++++++++++ lisp/browse-url-transform.el | 45 ++++++++++++++++++++++ 2 files changed, 133 insertions(+) create mode 100644 lisp/+browse-url.el create mode 100644 lisp/browse-url-transform.el (limited to 'lisp') diff --git a/lisp/+browse-url.el b/lisp/+browse-url.el new file mode 100644 index 0000000..12e433c --- /dev/null +++ b/lisp/+browse-url.el @@ -0,0 +1,88 @@ +;;; +browse-url.el -*- lexical-binding: t -*- + +(require 'browse-url) + +(cl-defmacro +browse-url-make-external-viewer-handler + (viewer default-args + &optional (prompt "URL: ") + &key + (custom-group 'browse-url) + (name (intern (format "+browse-url-with-%s" viewer))) + doc vardoc + (varname (intern (format "%s-args" name))) + (fallback t)) + "Create a `browse-url' handler function calling VIEWER on the url. +This macro also creates a `customize' setting in CUSTOM-GROUP for +VIEWER's command-line arguments. DEFAULT-ARGS specifies the +default arguments for that setting. + +PROMPT is shown to the user in the function's `interactive' spec, +as an argument to `browse-url-interactive-arg'. + +The resulting function is named NAME, which defaults to +`+browse-url-wth-VIEWER'. The custom variable is named VARNAME, +which defaults to `NAME-args'. If DOC or VARDOC are provided, +they'll be the documentation of the function and variable +respectively; otherwise, basic docstrings are used. + +Finally, if FALLBACK is non-nil (by default, it's +`browse-url-generic'), the function will call that if unable to +start VIEWER." + (declare (indent 1)) + `(progn + (defcustom ,varname ,default-args + ,(or doc (format "Arguments to pass to %s in `%s'." viewer name)) + :type '(repeat :tag "Command-line argument" string) + :group ',custom-group) + (defun ,name (url &optional new-window) + ,(or vardoc (format "Open URL in %s." viewer)) + (interactive (browse-url-interactive-arg ,prompt)) + (let* ((url (browse-url-encode-url url)) + (process-environment (browse-url-process-environment))) + (message ,(format "Opening %%s in %s..." viewer) url) + (unless (ignore-errors (apply #'start-process + (format "%s %s" ,viewer url) nil + ,viewer + (append ,varname (list url)))) + ,@(cond + ((eq fallback t) '((browse-url-generic url new-window))) + (fallback `((funcall ,fallback url new-window))) + (:else `((message "Can't find viewer: `%s'" ,viewer) + nil)))))))) + +(defcustom +browse-url-download-open t + "Whether to open downloaded files afterward." + :group 'browse-url + :type 'boolean) + +(defun +browse-url-download-callback (status url dir) + ;; A slight change to `eww-download-callback' that returns the downloaded + ;; filename. + (unless (plist-get status :error) + (let* ((obj (url-generic-parse-url url)) + (path (directory-file-name (car (url-path-and-query obj)))) + (file (eww-make-unique-file-name + (eww-decode-url-file-name (file-name-nondirectory path)) + dir))) + (goto-char (point-min)) + (re-search-forward "\r?\n\r?\n") + (let ((coding-system-for-write 'no-conversion)) + (write-region (point) (point-max) file)) + (message "Saved %s" file) + file))) + +(defun +browse-url-download (url &rest _) + "Download URL to `eww-download-directory'." + (interactive "sDownload URL: ") + (let ((dir eww-download-directory)) + (when (functionp dir) (setq dir (funcall dir))) + (make-directory dir :parents) + (url-retrieve url + (lambda (s u d) + (let ((file (+browse-url-download-callback s u d))) + (when +browse-url-download-open + (browse-url-xdg-open file)))) + (list url dir)))) + +(provide '+browse-url) +;;; +browse-url.el ends here diff --git a/lisp/browse-url-transform.el b/lisp/browse-url-transform.el new file mode 100644 index 0000000..c290a1f --- /dev/null +++ b/lisp/browse-url-transform.el @@ -0,0 +1,45 @@ +;;; browse-url-transform --- transform URLs + +(defgroup browse-url-transform nil + "Transformations for urls passed to `browse-url'." + :group 'browse-url) + +(defcustom browse-url-transform-alist nil + "Transformation rules for URLs. +The keys are regexps matching URLs, and the values are how to +transform them. The replacements will use match capture data." + :type '(alist :key-type (string :tag "URL regexp match") + :value-type (string :tag "URL regexp transformation"))) + +(defun browse-url-transform-url (url) + "Transform URL before passing it to `browse-url'." + (cl-loop with url = (substring-no-properties + (if (consp url) (car url) url)) + for (regex . transformation) in browse-url-transform-alist + if (string-match regex url) + return (replace-match transformation nil nil url) + finally return url)) + +(defun browse-url-transform-advice (url &rest args) + "Advice to `browse-url' for URL transformations. +ARGS are passed on for further processing." + (apply #'list (and url (browse-url-transform-url url)) args)) + +(define-minor-mode browse-url-transform-mode + "Minor mode to transform a URL before passing it to `browse-url'. +This can be used to \"redirect\" URLs, for example from an +information silo to a more privacy-respecting one (e.g., +\"twitter.com\" -> \"nitter.com\"), by adding advice to `browse-url'. + +When using this mode, ensure that the transformed URL is also in +`browse-url-handlers', since that's what `browse-url' will see." + :lighter " Turl" + :keymap nil + :global t + (cond (browse-url-transform-mode + (advice-add 'browse-url :filter-args #'browse-url-transform-advice)) + (:else + (advice-remove 'browse-url #'browse-url-transform-advice)))) + +(provide 'browse-url-transform) +;;; browse-url-transform.el ends here -- cgit 1.4.1-21-gabe81