Initial Commit
[packages] / xemacs-packages / w3 / lisp / url-irc.el
1 ;;; url-irc.el --- IRC URL interface
2
3 ;; Copyright (C) 1996-1999, 2004-2012  Free Software Foundation, Inc.
4
5 ;; Keywords: comm, data, processes
6
7 ;; This file is part of GNU Emacs.
8
9 ;; GNU Emacs 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 3 of the License, or
12 ;; (at your option) any later version.
13
14 ;; GNU Emacs 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.  If not, see <http://www.gnu.org/licenses/>.
21
22 ;;; Commentary:
23
24 ;; IRC URLs are defined in
25 ;; http://www.w3.org/Addressing/draft-mirashi-url-irc-01.txt
26
27 ;;; Code:
28
29 (require 'url-vars)
30 (require 'url-parse)
31
32 (defconst url-irc-default-port 6667 "Default port for IRC connections.")
33
34 (defcustom url-irc-function 'url-irc-rcirc
35   "Function to actually open an IRC connection.
36 The function should take the following arguments:
37     HOST - the hostname of the IRC server to contact
38     PORT - the port number of the IRC server to contact
39  CHANNEL - What channel on the server to visit right away (can be nil)
40     USER - What username to use
41 PASSWORD - What password to use"
42   :type '(choice (const :tag "rcirc" :value url-irc-rcirc)
43                  (const :tag "ERC" :value url-irc-erc)
44                  (const :tag "ZEN IRC" :value url-irc-zenirc)
45                  (function :tag "Other"))
46   :group 'url)
47
48 ;; External.
49 (declare-function zenirc "ext:zenirc" (&optional prefix))
50 (declare-function zenirc-send-line "ext:zenirc" ())
51
52 (defun url-irc-zenirc (host port channel user password)
53   (let ((zenirc-buffer-name (if (and user host port)
54                                 (format "%s@%s:%d" user host port)
55                               (format "%s:%d" host port)))
56         (zenirc-server-alist
57          (list
58           (list host port password nil user))))
59     (zenirc)
60     (goto-char (point-max))
61     (if (not channel)
62         nil
63       (insert "/join " channel)
64       (zenirc-send-line))))
65
66 (defun url-irc-rcirc (host port channel user password)
67   (let ((chan (when channel (concat "#" channel))))
68     (rcirc-connect host port user nil nil (when chan (list chan)))
69     (when chan
70       (switch-to-buffer (concat chan "@" host)))))
71
72 (defun url-irc-erc (host port channel user password)
73   (erc-handle-irc-url host port channel user password))
74
75 ;;;###autoload
76 (defun url-irc (url)
77   (let* ((host (url-host url))
78          (port (url-port url))
79          (pass (url-password url))
80          (user (url-user url))
81          (chan (url-filename url)))
82     (if (url-target url)
83         (setq chan (concat chan "#" (url-target url))))
84     (if (string-match "^/" chan)
85         (setq chan (substring chan 1 nil)))
86     (if (= (length chan) 0)
87         (setq chan nil))
88     (funcall url-irc-function host port chan user pass)
89     nil))
90
91 (provide 'url-irc)
92
93 ;;; url-irc.el ends here