lisp/net/tramp-uu.el

   1 ;;; tramp-uu.el --- uuencode in Lisp
   2
   3 ;; Copyright (C) 2002-2013 Free Software Foundation, Inc.
   4
   5 ;; Author: Kai Großjohann <kai.grossjohann@gmx.net>
   6 ;; Keywords: comm, terminals
   7 ;; Package: tramp
   8
   9 ;; This file is part of GNU Emacs.
  10
  11 ;; GNU Emacs is free software: you can redistribute it and/or modify
  12 ;; it under the terms of the GNU General Public License as published by
  13 ;; the Free Software Foundation, either version 3 of the License, or
  14 ;; (at your option) any later version.
  15
  16 ;; GNU Emacs is distributed in the hope that it will be useful,
  17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19 ;; GNU General Public License for more details.
  20
  21 ;; You should have received a copy of the GNU General Public License
  22 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  23
  24 ;;; Commentary:
  25
  26 ;; An implementation of "uuencode" in Lisp.  Uses the function
  27 ;; base64-encode-region which is built-in to modern Emacsen.
  28
  29 ;;; Code:
  30
  31 (defvar tramp-uu-b64-alphabet
  32   "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"
  33   "Mapping from base64-encoded character to the byte it represents.")
  34
  35 (defvar tramp-uu-b64-char-to-byte
  36   (let ((i 0))
  37     (mapcar (lambda (c)
  38               (prog1
  39                   (cons c i)
  40                 (setq i (1+ i))))
  41             tramp-uu-b64-alphabet))
  42   "Alist of mapping from base64 character to its byte.")
  43
  44 (defun tramp-uu-byte-to-uu-char (byte)
  45   "Return the character encoding BYTE."
  46   (if (zerop byte) ?` (+ byte 32)))
  47
  48 (defun tramp-uu-b64-char-to-byte (char)
  49   "Return the byte that is encoded as CHAR."
  50   (cdr (assq char tramp-uu-b64-char-to-byte)))
  51
  52 ;;;###tramp-autoload
  53 (defun tramp-uuencode-region (beg end)
  54   "UU-encode the region between BEG and END."
  55   ;; First we base64 encode the region, then we transmogrify that into
  56   ;; uu encoding.
  57   (let ((len (base64-encode-region beg end t))
  58         (padding 0)
  59         i c)
  60     (save-excursion
  61       (goto-char beg)
  62       (setq i 0)
  63       (while (< i len)
  64         (setq c (char-after (point)))
  65         (delete-char 1)
  66         (if (equal c ?=)
  67             ;; "=" means padding.  Insert "`" instead.  Not counted for length.
  68             (progn (insert "`") (setq len (1- len)))
  69           (insert (tramp-uu-byte-to-uu-char (tramp-uu-b64-char-to-byte c)))
  70           (setq i (1+ i)))
  71         ;; Every 60 characters, add "M" at beginning of line (as
  72         ;; length byte) and insert a newline.
  73         (when (zerop (% i 60))
  74           (save-excursion
  75             (beginning-of-line)
  76             (insert (char-to-string (+ 32 (/ (* 3 60) 4)))))
  77           (insert "\n")))
  78       ;; If there is something leftover, we compute the length byte
  79       ;; for that stuff and insert it and a trailing newline.
  80       (unless (zerop (% i 60))
  81         (save-excursion
  82           (beginning-of-line)
  83           (insert (char-to-string (+ 32 (% (- end beg) 45)))))
  84         (insert "\n"))
  85       ;; Why is there always a "`" line at the end?
  86       (insert "`\nend\n")
  87       (goto-char beg)
  88       (insert "begin 600 xxx\n"))))
  89
  90 (add-hook 'tramp-unload-hook
  91           (lambda ()
  92             (unload-feature 'tramp-uu 'force)))
  93
  94 (provide 'tramp-uu)
  95
  96 ;;; tramp-uu.el ends here
  97
  98 ;; Local Variables:
  99 ;; mode: Emacs-Lisp
 100 ;; coding: utf-8
 101 ;; End: