Revised.
[riece] / lisp / riece-message.el
1 ;;; riece-message.el --- generate and display message line
2 ;; Copyright (C) 1999-2003 Daiki Ueno
3
4 ;; Author: Daiki Ueno <ueno@unixuser.org>
5 ;; Keywords: message
6
7 ;; This file is part of Riece.
8
9 ;; This program is free software; you can redistribute it and/or modify
10 ;; it under the terms of the GNU General Public License as published by
11 ;; the Free Software Foundation; either version 2, or (at your option)
12 ;; any later version.
13
14 ;; This program is distributed in the hope that it will be useful,
15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17 ;; GNU General Public License for more details.
18
19 ;; You should have received a copy of the GNU General Public License
20 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
21 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 ;; Boston, MA 02111-1307, USA.
23
24 ;;; Code:
25
26 (require 'riece-identity)
27 (require 'riece-channel)
28 (require 'riece-user)
29 (require 'riece-display)
30 (require 'riece-misc)
31
32 (defgroup riece-message nil
33   "Messages"
34   :tag "Message"
35   :prefix "riece-"
36   :group 'riece)
37
38 (defcustom riece-message-filter-functions nil
39   "Functions to filter incoming messages."
40   :type 'function
41   :group 'riece-message)
42
43 (defcustom riece-message-make-open-bracket-function
44   #'riece-message-make-open-bracket
45   "Function which makes `open-bracket' string for each message."
46   :type 'function
47   :group 'riece-message)
48
49 (defcustom riece-message-make-close-bracket-function
50   #'riece-message-make-close-bracket
51   "Function which makes `close-bracket' string for each message."
52   :type 'function
53   :group 'riece-message)
54
55 (defcustom riece-message-make-name-function
56   #'riece-message-make-name
57   "Function which makes local identity for each message."
58   :type 'function
59   :group 'riece-message)
60
61 (defcustom riece-message-make-global-name-function
62   #'riece-message-make-global-name
63   "Function which makes global identity for each message."
64   :type 'function
65   :group 'riece-message)
66
67 (defun riece-message-make-open-bracket (message)
68   "Make `open-bracket' string for MESSAGE."
69   (if (riece-message-own-p message)
70       ">"
71     (if (eq (riece-message-type message) 'notice)
72         "{"
73       (if (riece-message-private-p message)
74           "="
75         (if (riece-message-external-p message)
76             "("
77           "<")))))
78
79 (defun riece-message-make-close-bracket (message)
80   "Make `close-bracket' string for MESSAGE."
81   (if (riece-message-own-p message)
82       "<"
83     (if (eq (riece-message-type message) 'notice)
84         "}"
85       (if (riece-message-private-p message)
86           "="
87         (if (riece-message-external-p message)
88             ")"
89           ">")))))
90
91 (defun riece-message-make-name (message)
92   "Make local identity for MESSAGE."
93   (if (riece-message-private-p message)
94       (if (riece-message-own-p message)
95           (riece-format-identity (riece-message-target message) t)
96         (riece-format-identity (riece-message-speaker message) t))
97     (riece-format-identity (riece-message-speaker message) t)))
98
99 (defun riece-message-make-global-name (message)
100   "Make global identity for MESSAGE."
101   (if (riece-message-private-p message)
102       (if (riece-message-own-p message)
103           (riece-format-identity (riece-message-target message) t)
104         (riece-format-identity (riece-message-speaker message) t))
105     (concat (riece-format-identity (riece-message-target message) t) ":"
106             (riece-format-identity (riece-message-speaker message) t))))
107
108 (defun riece-message-buffer (message)
109   "Return the buffer where MESSAGE should appear."
110   (let ((target (if (riece-message-private-p message)
111                     (if (riece-message-own-p message)
112                         (riece-message-target message)
113                       (riece-message-speaker message))
114                   (riece-message-target message))))
115     (unless (riece-identity-member target riece-current-channels)
116       (riece-join-channel target)
117       ;; If you are not joined any channel,
118       ;; switch to the target immediately.
119       (unless riece-current-channel
120         (riece-switch-to-channel target)))
121     (riece-channel-buffer target)))
122
123 (defun riece-message-parent-buffers (message buffer)
124   "Return the parents of BUFFER where MESSAGE should appear.
125 Normally they are *Dialogue* and/or *Others*."
126   (if (and buffer (riece-frozen buffer)) ;the message might not be
127                                          ;visible in buffer's window
128       (list riece-dialogue-buffer riece-others-buffer)
129     (if (and riece-current-channel      ;the message is not sent to
130                                         ;the current channel
131              (if (riece-message-private-p message)
132                  (if (riece-message-own-p message)
133                      (not (riece-identity-equal
134                            (riece-message-target message)
135                            riece-current-channel))
136                    (not (riece-identity-equal
137                          (riece-message-speaker message)
138                          riece-current-channel)))
139                (not (riece-identity-equal
140                      (riece-message-target message)
141                      riece-current-channel))))
142         (list riece-dialogue-buffer riece-others-buffer)
143       riece-dialogue-buffer)))
144
145 (defun riece-format-message (message &optional global)
146   (let ((open-bracket
147          (funcall riece-message-make-open-bracket-function message))
148         (close-bracket
149          (funcall riece-message-make-close-bracket-function message))
150         (name
151          (if global
152              (funcall riece-message-make-global-name-function message)
153            (funcall riece-message-make-name-function message)))
154         (server-name (riece-identity-server (riece-message-speaker message))))
155     (riece-with-server-buffer (riece-current-server-name)
156       (concat
157        (riece-concat-server-name
158         (concat open-bracket name close-bracket
159                 " " (riece-message-text message)))
160        "\n"))))
161
162 (defun riece-display-message-1 (message)
163   (let ((buffer (riece-message-buffer message))
164         parent-buffers)
165     (when (and buffer
166                (riece-message-own-p message)
167                (riece-own-frozen buffer))
168       (with-current-buffer buffer
169         (setq riece-freeze nil))
170       (riece-emit-signal 'buffer-freeze-changed buffer nil))
171     (setq parent-buffers (riece-message-parent-buffers message buffer))
172     (riece-insert buffer (riece-format-message message))
173     (riece-insert parent-buffers (riece-format-message message t))
174     (run-hook-with-args 'riece-after-display-message-functions message)))
175
176 (defun riece-display-message (message)
177   "Display MESSAGE object."
178   (let ((functions riece-message-filter-functions))
179     (setq message (copy-sequence message))
180     (while functions
181       (setq message (funcall (car functions) message)
182             functions (cdr functions)))
183     (if message
184         (riece-display-message-1 message))))
185
186 (defun riece-make-message (speaker target text &optional type own-p)
187   "Make an instance of message object.
188 Arguments are appropriate to the sender, the receiver, and text
189 content, respectively.
190 Optional 4th argument TYPE specifies the type of the message.
191 Currently possible values are `action' and `notice'.
192 Optional 5th argument is the flag to indicate that this message is not
193 from the network."
194   (vector speaker target text type own-p))
195
196 (defun riece-message-speaker (message)
197   "Return the sender of MESSAGE."
198   (aref message 0))
199
200 (defun riece-message-target (message)
201   "Return the receiver of MESSAGE."
202   (aref message 1))
203
204 (defun riece-message-text (message)
205   "Return the text part of MESSAGE."
206   (aref message 2))
207
208 (defun riece-message-type (message)
209   "Return the type of MESSAGE.
210 Currently possible values are `action' and `notice'."
211   (aref message 3))
212
213 (defun riece-message-own-p (message)
214   "Return t if MESSAGE is not from the network."
215   (aref message 4))
216
217 (defun riece-message-private-p (message)
218   "Return t if MESSAGE is a private message."
219   (not (or (riece-channel-p (riece-identity-prefix
220                              (riece-message-speaker message)))
221            (riece-channel-p (riece-identity-prefix
222                              (riece-message-target message))))))
223
224 (defun riece-message-external-p (message)
225   "Return t if MESSAGE is from outside the channel."
226   (not (riece-identity-member
227         (riece-message-speaker message)
228         (let ((target (riece-message-target message)))
229           (riece-with-server-buffer (riece-identity-server target)
230             (mapcar
231              (lambda (user)
232                (riece-make-identity (car user) riece-server-name))
233              (riece-channel-get-users (riece-identity-prefix target))))))))
234
235 (provide 'riece-message)
236
237 ;;; riece-message.el ends here