cgit.sxemacs.org Git - sxemacs/blob - lisp/package-ui.el

   1 ;;; package-ui.el ---
   2
   3 ;; Copyright (C) 1998 by Darryl Okahata
   4
   5 ;; Author: Darryl Okahata <darrylo@sr.hp.com>
   6 ;; Keywords: internal
   7
   8 ;; This file is part of SXEmacs.
   9
  10 ;; SXEmacs is free software: you can redistribute it and/or modify
  11 ;; it under the terms of the GNU General Public License as published by
  12 ;; the Free Software Foundation, either version 3 of the License, or
  13 ;; (at your option) any later version.
  14
  15 ;; SXEmacs is distributed in the hope that it will be useful,
  16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18 ;; GNU General Public License for more details.
  19
  20 ;; You should have received a copy of the GNU General Public License
  21 ;; along with this program.  If not, see <http://www.gnu.org/licenses/>.
  22
  23 ;;; Synched up with: Not in FSF
  24
  25 (require 'package-get)          ;; which, in turn, requires 'package-admin
  26
  27 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  28 ;; User-changeable variables:
  29 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  30
  31 (defgroup pui nil
  32   "Convenient interface to the package system."
  33   :group 'package-tools
  34   :tag "Package User interface"
  35   :prefix "pui-")
  36
  37 (defcustom pui-package-install-dest-dir nil
  38   "*If non-nil (Automatic) path to package tree to install packages in.
  39 Otherwise, use old path for installed packages and make a guess for
  40 new ones."
  41   :group 'pui
  42   :tag "Install Location"
  43   :type '(choice (const :tag "Automatic" nil)
  44                  (directory)))
  45
  46 (defcustom pui-list-verbose t
  47   "*If non-nil, display verbose info in the package list buffer."
  48   :group 'pui
  49   :tag "Verbose Listing"
  50   :type 'boolean)
  51
  52 (defcustom pui-up-to-date-package-face nil
  53   "*The face to use for packages that are up-to-date."
  54   :group 'pui
  55   :type 'face)
  56
  57 (defcustom pui-selected-package-face 'bold
  58   "*The face to use for selected packages.
  59 Set this to `nil' to use the `default' face."
  60   :group 'pui
  61   :type 'face)
  62
  63 (defcustom pui-deleted-package-face 'blue
  64   "*The face to use for packages marked for removal.
  65 Set this to `nil' to use the `default' face."
  66   :group 'pui
  67   :type 'face)
  68
  69 (defcustom pui-outdated-package-face 'red
  70   "*The face to use for outdated packages.
  71 Set this to `nil' to use the `default' face."
  72   :group 'pui
  73   :type 'face)
  74
  75 (defcustom pui-uninstalled-package-face 'italic
  76   "*The face to use for uninstalled packages.
  77 Set this to `nil' to use the `default' face."
  78    :group 'pui
  79    :type 'face)
  80
  81 (defcustom pui-info-buffer "*Packages*"
  82   "*Buffer to use for displaying package information."
  83   :group 'pui
  84   :type 'string)
  85
  86 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  87 ;; End of user-changeable variables.
  88 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  89
  90 (defvar pui-selected-packages nil
  91   "The list of user-selected packages to install.")
  92
  93 (defvar pui-deleted-packages nil
  94   "The list of user-selected packages to remove.")
  95
  96 (defvar pui-actual-package "")
  97
  98 (defvar pui-display-keymap
  99   (let ((m (make-keymap)))
 100     (suppress-keymap m)
 101     (set-keymap-name m 'pui-display-keymap)
 102     (define-key m "q" 'pui-quit)
 103     (define-key m "g" 'pui-list-packages)
 104     (define-key m "i" 'pui-display-info)
 105     (define-key m "m" 'pui-display-maintainer)
 106     (define-key m "?" 'describe-mode)
 107     (define-key m "v" 'pui-toggle-verbosity-redisplay)
 108     (define-key m "d" 'pui-toggle-package-delete-key)
 109     (define-key m "D" 'pui-toggle-package-delete-key)
 110     (define-key m [return] 'pui-toggle-package-key)
 111     (define-key m "x" 'pui-install-selected-packages)
 112     (define-key m "I" 'pui-install-selected-packages)
 113     (define-key m "r" 'pui-add-required-packages)
 114     (define-key m "n" 'next-line)
 115     (define-key m "+" 'pui-toggle-package-key)
 116     (define-key m "p" 'previous-line)
 117     (define-key m " " 'scroll-up-command)
 118     (define-key m [delete] 'scroll-down-command)
 119     m)
 120   "Keymap to use in the `pui-info-buffer' buffer")
 121
 122 (defvar pui-package-keymap
 123   (let ((m (make-sparse-keymap)))
 124     (set-keymap-name m 'pui-package-keymap)
 125     (define-key m 'button2 'pui-toggle-package-event)
 126 ;; We use a popup menu
 127     (define-key m 'button3 'pui-popup-context-sensitive)
 128     m)
 129   "Keymap to use over package names/descriptions.")
 130
 131 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 132 ;; End of variables
 133
 134
 135 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 136 ;; Configuration routines
 137
 138 ;;;###autoload
 139 (defun package-ui-add-site (site)
 140   "Add site to package-get-remote and possibly offer to update package list."
 141   (let ((had-none (null package-get-remote)))
 142     (setq package-get-remote site)
 143     (when (and had-none package-get-was-current
 144                (y-or-n-p "Update Package list?"))
 145       (setq package-get-was-current nil)
 146       (package-get-require-base t)
 147       (if (get-buffer pui-info-buffer)
 148           (save-window-excursion
 149             (pui-list-packages))))
 150     (set-menubar-dirty-flag)))
 151
 152 ;;;###autoload
 153 (defun package-ui-download-menu ()
 154   "Build the `Add Download Site' menu."
 155   (mapcar (lambda (site)
 156             (vector (car site)
 157                     `(if (equal package-get-remote (quote ,(cdr site)))
 158                       (setq package-get-remote nil)
 159                       (package-ui-add-site (quote ,(cdr site))))
 160                     ;; I've used radio buttons so that only a single
 161                     ;; site can be selected, but they are in fact
 162                     ;; toggles.  SY.
 163                     :style 'radio
 164                     :selected `(equal package-get-remote (quote ,(cdr site)))))
 165           package-get-download-sites))
 166
 167 ;;;###autoload
 168 (defun package-ui-pre-release-download-menu ()
 169   "Build the 'Pre-Release Download Sites' menu."
 170   (mapcar (lambda (site)
 171             (vector (car site)
 172                     `(if (equal package-get-remote (quote ,(cdr site)))
 173                       (setq package-get-remote nil)
 174                       (package-ui-add-site (quote ,(cdr site))))
 175                     ;; I've used radio buttons so that only a single
 176                     ;; site can be selected, but they are in fact
 177                     ;; toggles.  SY.
 178                     :style 'radio
 179                     :selected `(equal package-get-remote (quote ,(cdr site)))))
 180           package-get-pre-release-download-sites))
 181
 182 ;;;###autoload
 183 (defun package-ui-site-release-download-menu ()
 184   "Build the 'Site Release Download Sites' menu."
 185   (mapcar (lambda (site)
 186             (vector (car site)
 187                     `(if (equal package-get-remote (quote ,(cdr site)))
 188                       (setq package-get-remote nil)
 189                       (package-ui-add-site (quote ,(cdr site))))
 190                     ;; I've used radio buttons so that only a single
 191                     ;; site can be selected, but they are in fact
 192                     ;; toggles.  SY.
 193                     :style 'radio
 194                     :selected `(equal package-get-remote (quote ,(cdr site)))))
 195           package-get-site-release-download-sites))
 196
 197 ;;;###autoload
 198 (defun pui-set-local-package-get-directory ()
 199   "Set a new package binary directory in `package-get-remote'.
 200 Note that no provision is made for saving any changes made by this function.
 201 It exists mainly as a convenience for one-time package installations from
 202 disk."
 203   (interactive)
 204   (let ((dir (read-directory-name
 205               "New package binary directory to add? "
 206               nil nil t)))
 207     (setq package-get-remote (list nil dir))
 208     (message "Package directory \"%s\" added." dir)))
 209
 210 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 211 ;; Package list/installer routines
 212
 213 (defun pui-quit ()
 214   (interactive)
 215   (kill-buffer nil))
 216
 217 (defun pui-package-symbol-char (pkg-sym version)
 218   (progn
 219     (if (package-get-info-find-package packages-package-list pkg-sym)
 220         (let ((installed (package-get-key pkg-sym :version)))
 221           (if (>= (if (stringp installed)
 222                       (string-to-number installed)
 223                     installed)
 224                   (if (stringp version)
 225                       (string-to-number version)
 226                     version))
 227               (list " " pui-up-to-date-package-face)
 228             (list "*" pui-outdated-package-face)))
 229       (list "-" pui-uninstalled-package-face))))
 230
 231 (defun pui-update-package-display (extent &optional pkg-sym version)
 232   "Update the package status for EXTENT.
 233 If PKG-SYM or VERSION are not given, they are read from the extent.
 234 These are used to determine whether or not the package is installed,
 235 and whether or not it is up-to-date."
 236   (let (buffer-read-only disp sym-char)
 237     (if (not pkg-sym)
 238         (setq pkg-sym (extent-property extent 'pui-package)))
 239     (if (not version)
 240         (setq version (package-get-info-prop (extent-property extent 'pui-info)
 241                                              'version)))
 242     (cond ((member pkg-sym pui-selected-packages)
 243              (if pui-selected-package-face
 244                  (set-extent-face extent (get-face pui-selected-package-face))
 245                (set-extent-face extent (get-face 'default)))
 246              (setq sym-char "+"))
 247           ((member pkg-sym pui-deleted-packages)
 248            (if pui-deleted-package-face
 249                  (set-extent-face extent (get-face pui-deleted-package-face))
 250                (set-extent-face extent (get-face 'default)))
 251              (setq sym-char "D"))
 252           (t
 253            (setq disp (pui-package-symbol-char pkg-sym version))
 254            (setq sym-char (car disp))
 255            (if (car (cdr disp))
 256                (set-extent-face extent (get-face (car (cdr disp))))
 257              (set-extent-face extent (get-face 'default)))))
 258     (save-excursion
 259       (goto-char (extent-start-position extent))
 260       (delete-char 1)
 261       (insert sym-char)
 262       (set-buffer-modified-p nil))))
 263
 264 (defun pui-toggle-package (extent)
 265   (let (pkg-sym)
 266     (setq pkg-sym (extent-property extent 'pui-package))
 267     (if (member pkg-sym pui-selected-packages)
 268         (setq pui-selected-packages
 269               (delete pkg-sym pui-selected-packages))
 270       (setq pui-selected-packages
 271             (cons pkg-sym pui-selected-packages))
 272       (setq pui-deleted-packages
 273             (delete pkg-sym pui-deleted-packages)))
 274     (pui-update-package-display extent pkg-sym)))
 275
 276 (defun pui-toggle-package-key ()
 277   "Select/unselect package for installation, using the keyboard."
 278   (interactive)
 279   (let (extent)
 280     (if (setq extent (extent-at (point) (current-buffer) 'pui))
 281         (progn
 282           (pui-toggle-package extent)
 283           (forward-line 1))
 284       (error 'invalid-operation
 285              "No package under cursor!"))))
 286
 287 (defun pui-toggle-package-delete (extent)
 288   (let (pkg-sym)
 289     (setq pkg-sym (extent-property extent 'pui-package))
 290     (if (member pkg-sym pui-deleted-packages)
 291         (setq pui-deleted-packages
 292               (delete pkg-sym pui-deleted-packages))
 293       (setq pui-deleted-packages
 294             (cons pkg-sym pui-deleted-packages))
 295       (setq pui-selected-packages
 296             (delete pkg-sym pui-selected-packages)))
 297     (pui-update-package-display extent pkg-sym)))
 298
 299
 300 (defun pui-toggle-package-delete-key ()
 301   "Select/unselect package for removal, using the keyboard."
 302   (interactive)
 303   (let (extent)
 304     (if (setq extent (extent-at (point) (current-buffer) 'pui))
 305         (progn
 306           (pui-toggle-package-delete extent)
 307           (forward-line 1))
 308       (error 'invalid-operation
 309              "No package under cursor!"))))
 310
 311 (defun pui-current-package ()
 312   (let ((extent (extent-at (point) (current-buffer) 'pui)))
 313     (if extent
 314         (extent-property extent 'pui-package))))
 315
 316 (defun pui-toggle-package-event (event)
 317   "Select/unselect package for installation, using the mouse."
 318   (interactive "e")
 319   (let* ((ep (event-point event))
 320          (buffer (window-buffer (event-window event)))
 321          (extent (extent-at ep buffer 'pui-package)))
 322     (pui-toggle-package extent)))
 323
 324 (defun pui-toggle-verbosity-redisplay ()
 325   "Toggle verbose package info."
 326   (interactive)
 327   (progn
 328     (setq pui-list-verbose (not pui-list-verbose))
 329     (pui-list-packages)))
 330
 331 (defun pui-install-selected-packages ()
 332   "Install selected packages."
 333   (interactive)
 334   (let ((tmpbuf "*Packages-To-Remove*")
 335         do-delete)
 336     (when pui-deleted-packages
 337       (save-window-excursion
 338         (with-output-to-temp-buffer tmpbuf
 339           (display-completion-list (sort
 340                                     (mapcar #'symbol-name pui-deleted-packages)
 341                                     #'string<)
 342                                    :activate-callback nil
 343                                    :help-string "Packages selected for removal:\n"
 344                                    :completion-string t))
 345         (setq tmpbuf (get-buffer-create tmpbuf))
 346         (display-buffer tmpbuf)
 347         (setq do-delete (yes-or-no-p "Remove these packages? "))
 348         (kill-buffer tmpbuf))
 349       (when do-delete
 350         (message "Deleting selected packages ...") (sit-for 0)
 351         (mapcar (lambda (pkg)
 352                   (package-admin-delete-binary-package
 353                    pkg (package-admin-get-install-dir pkg)))
 354                 (nreverse pui-deleted-packages))
 355         (message "Packages deleted"))))
 356
 357   (let ((tmpbuf "*Packages-To-Install*")
 358         do-install)
 359     (if pui-selected-packages
 360         (progn
 361           ;; Don't change window config when asking the user if he really
 362           ;; wants to install the packages.  We do this to avoid messing up
 363           ;; the window configuration if errors occur (we don't want to
 364           ;; display random buffers in addition to the error buffer, if
 365           ;; errors occur, which would normally be caused by display-buffer).
 366           (save-window-excursion
 367             (with-output-to-temp-buffer tmpbuf
 368               (display-completion-list
 369                (sort (mapcar #'symbol-name pui-selected-packages) #'string<)
 370                :activate-callback nil
 371                :help-string "Packages selected for installation:\n"
 372                :completion-string t))
 373             (setq tmpbuf (get-buffer-create tmpbuf))
 374             (display-buffer tmpbuf)
 375             (setq do-install (y-or-n-p "Install these packages? "))
 376             (kill-buffer tmpbuf))
 377           (if do-install
 378               (progn
 379                 (save-excursion
 380                   ;; Clear old temp buffer history
 381                   (set-buffer (get-buffer-create package-admin-temp-buffer))
 382                   (buffer-disable-undo package-admin-temp-buffer)
 383                   (erase-buffer package-admin-temp-buffer))
 384                 (message "Installing selected packages ...") (sit-for 0)
 385                 (if (catch 'done
 386                       (mapcar (lambda (pkg)
 387                                 (if (not (package-get pkg nil nil
 388                                                       pui-package-install-dest-dir))
 389                                     (throw 'done nil)))
 390                               (nreverse pui-selected-packages))
 391                       t)
 392                     (progn
 393                       (pui-list-packages)
 394                       (message "Packages installed"))))
 395             (clear-message)))
 396       (if pui-deleted-packages
 397           (pui-list-packages)
 398         (error 'invalid-operation
 399                "No packages have been selected!")))))
 400
 401 (defun pui-add-required-packages ()
 402   "Select packages required by those already selected for installation."
 403   (interactive)
 404   (let ((tmpbuf "*Required-Packages*") do-select)
 405     (if pui-selected-packages
 406         (let ((dependencies
 407                (delq nil (mapcar
 408                           (lambda (pkg)
 409                             (let ((installed
 410                                    (package-get-key pkg :version))
 411                                   (current
 412                                    (package-get-info-prop
 413                                     (package-get-info-version
 414                                      (package-get-info-find-package
 415                                       package-get-base pkg) nil)
 416                                     'version)))
 417                               (if (or (null installed)
 418                                      (< (if (stringp installed)
 419                                          (string-to-number installed)
 420                                        installed)
 421                                      (if (stringp current)
 422                                          (string-to-number current)
 423                                        current)))
 424                                   pkg
 425                                 nil)))
 426                           (package-get-dependencies pui-selected-packages)))))
 427           ;; Don't change window config when asking the user if he really
 428           ;; wants to add the packages.  We do this to avoid messing up
 429           ;; the window configuration if errors occur (we don't want to
 430           ;; display random buffers in addition to the error buffer, if
 431           ;; errors occur, which would normally be caused by display-buffer).
 432           (save-window-excursion
 433             (with-output-to-temp-buffer tmpbuf
 434               (display-completion-list (sort
 435                                         (mapcar #'(lambda (pkg)
 436                                                     (symbol-name pkg))
 437                                                 dependencies)
 438                                         'string<)
 439                                        :activate-callback nil
 440                                        :help-string "Required packages:\n"
 441                                        :completion-string t))
 442             (setq tmpbuf (get-buffer-create tmpbuf))
 443             (display-buffer tmpbuf)
 444             (setq do-select (y-or-n-p "Select these packages? "))
 445             (kill-buffer tmpbuf))
 446           (if do-select
 447               (progn
 448                 (setq pui-selected-packages
 449                       (union pui-selected-packages dependencies))
 450                 (map-extents #'(lambda (extent maparg)
 451                                  (pui-update-package-display extent))
 452                              nil nil nil nil nil 'pui)
 453                 (message "added dependencies"))
 454               (clear-message)))
 455       (error 'invalid-operation
 456              "No packages have been selected!"))))
 457
 458 (defun pui-help-echo (extent &optional force-update)
 459   "Display additional package info in the modeline.
 460 EXTENT determines the package to display (the package information is
 461 attached to the extent as properties)."
 462   (let (pkg-sym info inst-ver inst-auth-ver auth-ver date maintainer balloon req)
 463     (if (or force-update (not (current-message))
 464             (string-match ".*: .*: " (current-message)))
 465         (progn
 466           (setq pkg-sym (extent-property extent 'pui-package)
 467                 info (extent-property extent 'pui-info)
 468                 inst-ver (package-get-key pkg-sym :version)
 469                 inst-auth-ver (package-get-key pkg-sym :author-version)
 470                 auth-ver (package-get-info-prop info 'author-version)
 471                 date (package-get-info-prop info 'date)
 472                 maintainer (package-get-info-prop info 'maintainer)
 473                 req (package-get-info-prop info 'requires))
 474           (if (not inst-ver)
 475               (setq inst-ver 0))
 476           (if (featurep 'balloon-help)
 477               (progn
 478                 (setq balloon (format "
 479 Package Information:  [For package: \"%s\"]\n================
 480 Installed Upstream Ver: %s  Available Upstream Ver: %s
 481 Maintainer : %s
 482 Released : %s
 483 Required Packages : %s\n\n"
 484                                       pkg-sym inst-auth-ver auth-ver maintainer
 485                                       date req))
 486                 (set-extent-property extent 'balloon-help balloon)))
 487           (format
 488            "Installed upstream ver: %s  Available upstream ver: %s"
 489            inst-auth-ver auth-ver)))))
 490
 491 (defun pui-display-info (&optional no-error event)
 492   "Display additional package info in the modeline.
 493 Designed to be called interactively (from a keypress)."
 494   (interactive)
 495   (let (extent)
 496     (save-excursion
 497       (beginning-of-line)
 498       (if (setq extent  (extent-at (point) (current-buffer) 'pui))
 499           (message (pui-help-echo extent t))
 500         (if no-error
 501             (clear-message nil)
 502           (error 'invalid-operation
 503                  "No package under cursor!"))))))
 504
 505 (defun pui-display-maintainer (&optional no-error event)
 506   "Display a package's maintainer in the minibuffer."
 507   (interactive)
 508   (let (extent ;pkg-sym
 509         info maintainer)
 510     (save-excursion
 511       (beginning-of-line)
 512       (if (setq extent  (extent-at (point) (current-buffer) 'pui))
 513           (progn
 514             (setq ;pkg-sym (extent-property extent 'pui-package)
 515              info (extent-property extent 'pui-info)
 516              maintainer (package-get-info-prop info 'maintainer))
 517             (message (format "Maintainer: %s" maintainer)))
 518         (if no-error
 519             (clear-message nil)
 520           (error 'invalid-operation
 521                  "No package under cursor!"))))))
 522
 523 (defvar pui-menu
 524   '("Packages"
 525     ["Toggle install " pui-toggle-package-key :active (pui-current-package) :suffix (format "`%s'" (or (pui-current-package) "..."))]
 526     ["Toggle delete " pui-toggle-package-delete-key :active (pui-current-package) :suffix (format "`%s'" (or (pui-current-package) "..."))]
 527     ["Info on" pui-display-info  :active (pui-current-package) :suffix (format "`%s'" (or (pui-current-package) "..."))]
 528     "---"
 529     ["Add Required" pui-add-required-packages t]
 530     ["Install/Remove Selected" pui-install-selected-packages t]
 531     "---"
 532     ["Verbose" pui-toggle-verbosity-redisplay
 533      :active t :style toggle :selected pui-list-verbose]
 534     ["Refresh" pui-list-packages t]
 535     ["Help" pui-help t]
 536     ["Quit" pui-quit t]))
 537
 538 ;;; "Why is there no standard function to do this?"
 539 (defun pui-popup-context-sensitive (event)
 540   (interactive "e")
 541   (save-excursion
 542     (set-buffer (event-buffer event))
 543     (goto-char (event-point event))
 544     (popup-menu pui-menu event)
 545     ;; I agree with dired.el - this is seriously bogus.
 546     (while (popup-up-p)
 547       (dispatch-event (next-event)))))
 548
 549 (defun list-packages-mode ()
 550     "Symbols in the leftmost column:
 551
 552   +     The package is marked for installation.
 553   -     The package has not been installed.
 554   D     The package has been marked for deletion.
 555   *     The currently installed package is old, and a newer version is
 556         available.
 557
 558 Useful keys:
 559
 560   `\\[pui-toggle-package-key]' to select/unselect the current package for installation.
 561   `\\[pui-toggle-package-delete-key]' to select/unselect the current package for removal.
 562   `\\[pui-add-required-packages]' to add any packages required by those selected.
 563   `\\[pui-install-selected-packages]' to install/delete selected packages.
 564   `\\[pui-display-info]' to display additional information about the package in the minibuffer.
 565   `\\[pui-display-maintainer]' to display the package's maintainer in the minibuffer
 566   `\\[pui-list-packages]' to refresh the package list.
 567   `\\[pui-toggle-verbosity-redisplay]' to toggle between a verbose and non-verbose display.
 568   `\\[pui-quit]' to kill this buffer.
 569 "
 570   (error 'invalid-operation
 571          "You cannot enter this mode directly. Use `pui-list-packages'"))
 572
 573 (put 'list-packages-mode 'mode-class 'special)
 574
 575 ;;;###autoload
 576 (defun pui-list-packages ()
 577   "List all packages and package information.
 578 The package name, version, and description are displayed.  From the displayed
 579 buffer, the user can see which packages are installed, which are not, and
 580 which are out-of-date (a newer version is available).  The user can then
 581 select packages for installation via the keyboard or mouse."
 582   (interactive)
 583   (package-get-require-base t)
 584   (let ((outbuf (get-buffer-create pui-info-buffer))
 585         (sep-string "===============================================================================\n")
 586         start)
 587     (message "Creating package list ...") (sit-for 0)
 588     (set-buffer outbuf)
 589     (setq buffer-read-only nil)
 590     (buffer-disable-undo outbuf)
 591     (erase-buffer outbuf)
 592     (kill-all-local-variables)
 593     (use-local-map pui-display-keymap)
 594     (setq major-mode 'list-packages-mode)
 595     (setq mode-name "Packages")
 596     (setq truncate-lines t)
 597
 598     (unless package-get-remote
 599       (insert "
 600 Warning: No download sites specified.  Package index may be out of date.
 601          If you intend to install packages, specify download sites first.
 602
 603 "))
 604
 605     (if pui-list-verbose
 606         (insert "                       Latest Installed
 607   Package name         Vers.  Vers.   Description
 608 ")
 609       (insert "                       Latest
 610   Package name         Vers.  Description
 611 "))
 612     (insert sep-string)
 613     (setq start (point))
 614     (mapcar
 615      #'(lambda (pkg)
 616          (let (pkg-sym info version desc
 617                        b e extent current-vers disp)
 618            (setq pkg-sym (car pkg)
 619                  info (package-get-info-version (cdr pkg) nil))
 620            (setq version (package-get-info-prop info 'version)
 621                  desc (package-get-info-prop info 'description))
 622
 623            (setq disp (pui-package-symbol-char pkg-sym
 624                                                version))
 625            (setq b (point))
 626            (if pui-list-verbose
 627                (progn
 628                  (setq current-vers (package-get-key pkg-sym :version))
 629                  (cond
 630                   ((not current-vers)
 631                    (setq current-vers "-----"))
 632                   ((stringp current-vers)
 633                    (setq current-vers
 634                          (format "%.2f"
 635                                  (string-to-number current-vers))))
 636                   ((numberp current-vers)
 637                    (setq current-vers (format "%.2f" current-vers))))
 638                  (insert
 639                   (format "%s %-20s %-5.2f  %-5s  %s\n"
 640                           (car disp) pkg-sym
 641                           (if (stringp version)
 642                               (string-to-number version)
 643                             version)
 644                           current-vers desc)))
 645              (insert (format "%s %-20s %-5s %s\n"
 646                              (car disp)
 647                              pkg-sym version desc)))
 648            (save-excursion
 649              (setq e (progn
 650                        (forward-line -1)
 651                        (end-of-line)
 652                        (point))))
 653            (setq extent (make-extent b e))
 654            (if (car (cdr disp))
 655                (set-extent-face extent (get-face (car (cdr disp))))
 656              (set-extent-face extent (get-face 'default)))
 657            (set-extent-property extent 'highlight t)
 658            (set-extent-property extent 'pui t)
 659            (set-extent-property extent 'pui-package pkg-sym)
 660            (set-extent-property extent 'pui-info info)
 661            (set-extent-property extent 'help-echo 'pui-help-echo)
 662            (set-extent-property extent 'keymap pui-package-keymap)))
 663      (sort (copy-sequence package-get-base)
 664            #'(lambda (a b)
 665                (string< (symbol-name (car a))
 666                         (symbol-name (car b))))))
 667     (insert sep-string)
 668     (insert (documentation 'list-packages-mode))
 669     (set-buffer-modified-p nil)
 670     (setq buffer-read-only t)
 671     (pop-to-buffer outbuf)
 672     (delete-other-windows)
 673     (goto-char start)
 674     (setq pui-selected-packages nil)    ; Reset list
 675     (setq pui-deleted-packages nil)     ; Reset list
 676     (when (featurep 'menubar)
 677       (set-buffer-menubar current-menubar)
 678       (add-submenu '() pui-menu)
 679       (setq mode-popup-menu pui-menu))
 680     (clear-message)))
 681
 682 ;;;###autoload
 683 (defalias 'list-packages 'pui-list-packages)
 684
 685 (provide 'package-ui)
 686
 687 ;;; package-ui.el ends here