emacs/lisp/erc/erc-replace.el

94 lines
2.9 KiB
EmacsLisp

;;; erc-replace.el --- wash and massage messages inserted into the buffer -*- lexical-binding: t; -*-
;; Copyright (C) 2001-2024 Free Software Foundation, Inc.
;; Author: Andreas Fuchs <asf@void.at>
;; Maintainer: Amin Bandali <bandali@gnu.org>, F. Jason Park <jp@neverwas.me>
;; URL: https://www.emacswiki.org/emacs/ErcReplace
;; Keywords: comm, IRC, client, Internet
;; This file is part of GNU Emacs.
;; GNU Emacs 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.
;; GNU Emacs 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 GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
;;; Commentary:
;; This module allows you to systematically replace text in incoming
;; messages. Load erc-replace, and customize `erc-replace-alist'.
;; Then add to your init file:
;; (require 'erc-replace)
;; (erc-replace-mode 1)
;;; Code:
(require 'erc)
(defgroup erc-replace nil
"Replace text from incoming messages."
:group 'erc)
(defcustom erc-replace-alist nil
"Alist describing text to be replaced in incoming messages.
This is useful for filters.
The alist has elements of the form (FROM . TO). FROM can be a regular
expression or a variable, or any sexp, TO can be a string or a
function to call, or any sexp. If a function, it will be called with
one argument, the string to be replaced, and it should return a
replacement string."
:type '(repeat (cons :tag "Search & Replace"
(choice :tag "From"
regexp
variable
sexp)
(choice :tag "To"
string
function
sexp))))
(defun erc-replace-insert ()
"Function to run from `erc-insert-modify-hook'.
It replaces text according to `erc-replace-alist'."
(mapcar (lambda (elt)
(goto-char (point-min))
(let ((from (car elt))
(to (cdr elt)))
(unless (stringp from)
(setq from (eval from t)))
(while (re-search-forward from nil t)
(cond ((stringp to)
(replace-match to))
((functionp to)
(replace-match (funcall to (match-string 0))))
(t
(eval to t))))))
erc-replace-alist))
;;;###autoload(autoload 'erc-replace-mode "erc-replace")
(define-erc-module replace nil
"This mode replaces incoming text according to `erc-replace-alist'."
((add-hook 'erc-insert-modify-hook
#'erc-replace-insert))
((remove-hook 'erc-insert-modify-hook
#'erc-replace-insert)))
(provide 'erc-replace)
;;; erc-replace.el ends here
;;
;; Local Variables:
;; generated-autoload-file: "erc-loaddefs.el"
;; End: