lisp/url/url-irc.el

   1 ;;; url-irc.el --- IRC URL interface
   2
   3 ;; Copyright (C) 1996-1999, 2004-2017 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