code.delx.au - gnu-emacs-elpa/blob - company.el

   1 ;;; company.el --- extensible inline text completion mechanism
   2 ;;
   3 ;; Copyright (C) 2009 Nikolaj Schumacher
   4 ;;
   5 ;; Author: Nikolaj Schumacher <bugs * nschum de>
   6 ;; Version:
   7 ;; Keywords: abbrev, convenience, matchis
   8 ;; URL: http://nschum.de/src/emacs/company/
   9 ;; Compatibility: GNU Emacs 23.x
  10 ;;
  11 ;; This file is NOT part of GNU Emacs.
  12 ;;
  13 ;; This program is free software; you can redistribute it and/or
  14 ;; modify it under the terms of the GNU General Public License
  15 ;; as published by the Free Software Foundation; either version 2
  16 ;; of the License, or (at your option) any later version.
  17 ;;
  18 ;; This program is distributed in the hope that it will be useful,
  19 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21 ;; GNU General Public License for more details.
  22 ;;
  23 ;; You should have received a copy of the GNU General Public License
  24 ;; along with this program.  If not, see <http://www.gnu.org/licenses/>.
  25 ;;
  26 ;;; Commentary:
  27 ;;
  28 ;;; Change Log:
  29 ;;
  30 ;;    Initial release.
  31 ;;
  32 ;;; Code:
  33
  34 (eval-when-compile (require 'cl))
  35
  36 (add-to-list 'debug-ignored-errors
  37              "^Pseudo tooltip frontend cannot be used twice$")
  38 (add-to-list 'debug-ignored-errors "^Preview frontend cannot be used twice$")
  39 (add-to-list 'debug-ignored-errors "^Echo area cannot be used twice$")
  40 (add-to-list 'debug-ignored-errors "^No documentation available$")
  41
  42 (defgroup company nil
  43   ""
  44   :group 'abbrev
  45   :group 'convenience
  46   :group 'maching)
  47
  48 (defface company-tooltip
  49   '((t :background "yellow"
  50        :foreground "black"))
  51   "*"
  52   :group 'company)
  53
  54 (defface company-tooltip-selection
  55   '((t :background "orange1"
  56        :foreground "black"))
  57   "*"
  58   :group 'company)
  59
  60 (defface company-tooltip-common
  61   '((t :inherit company-tooltip
  62        :foreground "red"))
  63   "*"
  64   :group 'company)
  65
  66 (defface company-tooltip-common-selection
  67   '((t :inherit company-tooltip-selection
  68        :foreground "red"))
  69   "*"
  70   :group 'company)
  71
  72 (defcustom company-tooltip-limit 10
  73   "*"
  74   :group 'company
  75   :type 'integer)
  76
  77 (defface company-preview
  78   '((t :background "blue4"
  79        :foreground "wheat"))
  80   "*"
  81   :group 'company)
  82
  83 (defface company-preview-common
  84   '((t :inherit company-preview
  85        :foreground "red"))
  86   "*"
  87   :group 'company)
  88
  89 (defface company-echo nil
  90   "*"
  91   :group 'company)
  92
  93 (defface company-echo-common
  94   '((((background dark)) (:foreground "firebrick1"))
  95     (((background light)) (:background "firebrick4")))
  96   "*"
  97   :group 'company)
  98
  99 (defun company-frontends-set (variable value)
 100   ;; uniquify
 101   (let ((remainder value))
 102     (setcdr remainder (delq (car remainder) (cdr remainder))))
 103   (and (memq 'company-pseudo-tooltip-unless-just-one-frontend value)
 104        (memq 'company-pseudo-tooltip-frontend value)
 105        (error "Pseudo tooltip frontend cannot be used twice"))
 106   (and (memq 'company-preview-if-just-one-frontend value)
 107        (memq 'company-preview-frontend value)
 108        (error "Preview frontend cannot be used twice"))
 109   (and (memq 'company-echo value)
 110        (memq 'company-echo-metadata-frontend value)
 111        (error "Echo area cannot be used twice"))
 112   ;; preview must come last
 113   (dolist (f '(company-preview-if-just-one-frontend company-preview-frontend))
 114     (when (memq f value)
 115       (setq value (append (delq f value) (list f)))))
 116   (set variable value))
 117
 118 (defcustom company-frontends '(company-pseudo-tooltip-unless-just-one-frontend
 119                                company-preview-if-just-one-frontend
 120                                company-echo-metadata-frontend)
 121   "*"
 122   :set 'company-frontends-set
 123   :group 'company
 124   :type '(repeat (choice (const :tag "echo" company-echo-frontend)
 125                          (const :tag "pseudo tooltip"
 126                                 company-pseudo-tooltip-frontend)
 127                          (const :tag "pseudo tooltip, multiple only"
 128                                 company-pseudo-tooltip-unless-just-one-frontend)
 129                          (const :tag "preview" company-preview-frontend)
 130                          (const :tag "preview, unique only"
 131                                 company-preview-if-just-one-frontend)
 132                          (function :tag "custom function" nil))))
 133
 134 (defcustom company-backends '(company-elisp company-nxml company-css
 135                               company-semantic company-gtags company-oddmuse
 136                               company-files company-dabbrev)
 137   "*"
 138   :group 'company
 139   :type '(repeat (function :tag "function" nil)))
 140
 141 (defcustom company-minimum-prefix-length 3
 142   "*"
 143   :group 'company
 144   :type '(integer :tag "prefix length"))
 145
 146 (defcustom company-idle-delay .7
 147   "*"
 148   :group 'company
 149   :type '(choice (const :tag "never (nil)" nil)
 150                  (const :tag "immediate (t)" t)
 151                  (number :tag "seconds")))
 152
 153 ;;; mode ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 154
 155 (defvar company-mode-map (make-sparse-keymap))
 156
 157 (defvar company-active-map
 158   (let ((keymap (make-sparse-keymap)))
 159     (define-key keymap (kbd "M-n") 'company-select-next)
 160     (define-key keymap (kbd "M-p") 'company-select-previous)
 161     (define-key keymap "\C-m" 'company-complete-selection)
 162     (define-key keymap "\t" 'company-complete-common)
 163     (define-key keymap (kbd "<f1>") 'company-show-doc-buffer)
 164     (define-key keymap "\C-s" 'company-search-candidates)
 165     keymap))
 166
 167 ;;;###autoload
 168 (define-minor-mode company-mode
 169   ""
 170   nil " comp" company-mode-map
 171   (if company-mode
 172       (progn
 173         (add-hook 'pre-command-hook 'company-pre-command nil t)
 174         (add-hook 'post-command-hook 'company-post-command nil t))
 175     (remove-hook 'pre-command-hook 'company-pre-command t)
 176     (remove-hook 'post-command-hook 'company-post-command t)
 177     (company-cancel)
 178     (kill-local-variable 'company-point)))
 179
 180 ;;; keymaps ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 181
 182 (defvar company-overriding-keymap-bound nil)
 183 (make-variable-buffer-local 'company-overriding-keymap-bound)
 184
 185 (defvar company-old-keymap nil)
 186 (make-variable-buffer-local 'company-old-keymap)
 187
 188 (defvar company-my-keymap nil)
 189 (make-variable-buffer-local 'company-my-keymap)
 190
 191 (defsubst company-enable-overriding-keymap (keymap)
 192   (setq company-my-keymap keymap)
 193   (when company-overriding-keymap-bound
 194     (company-uninstall-map)))
 195
 196 (defun company-install-map ()
 197   (unless (or company-overriding-keymap-bound
 198               (null company-my-keymap))
 199     (setq company-old-keymap overriding-terminal-local-map
 200           overriding-terminal-local-map company-my-keymap
 201           company-overriding-keymap-bound t)))
 202
 203 (defun company-uninstall-map ()
 204   (when (and company-overriding-keymap-bound
 205              (eq overriding-terminal-local-map company-my-keymap))
 206     (setq overriding-terminal-local-map company-old-keymap
 207           company-overriding-keymap-bound nil)))
 208
 209 ;; Hack:
 210 ;; Emacs calculates the active keymaps before reading the event.  That means we
 211 ;; cannot change the keymap from a timer.  So we send a bogus command.
 212 (defun company-ignore ()
 213   (interactive))
 214
 215 (global-set-key '[31415926] 'company-ignore)
 216
 217 (defun company-input-noop ()
 218   (push 31415926 unread-command-events))
 219
 220 ;;; backends ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 221
 222 (defun company-grab (regexp &optional expression)
 223   (when (looking-back regexp)
 224     (or (match-string-no-properties (or expression 0)) "")))
 225
 226 (defun company-in-string-or-comment (&optional point)
 227   (let ((pos (syntax-ppss)))
 228     (or (nth 3 pos) (nth 4 pos) (nth 7 pos))))
 229
 230 ;;; completion mechanism ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 231
 232 (defvar company-backend nil)
 233 (make-variable-buffer-local 'company-backend)
 234
 235 (defvar company-prefix nil)
 236 (make-variable-buffer-local 'company-prefix)
 237
 238 (defvar company-candidates nil)
 239 (make-variable-buffer-local 'company-candidates)
 240
 241 (defvar company-candidates-length nil)
 242 (make-variable-buffer-local 'company-candidates-length)
 243
 244 (defvar company-candidates-cache nil)
 245 (make-variable-buffer-local 'company-candidates-cache)
 246
 247 (defvar company-candidates-predicate nil)
 248 (make-variable-buffer-local 'company-candidates-predicate)
 249
 250 (defvar company-common nil)
 251 (make-variable-buffer-local 'company-common)
 252
 253 (defvar company-selection 0)
 254 (make-variable-buffer-local 'company-selection)
 255
 256 (defvar company-selection-changed nil)
 257 (make-variable-buffer-local 'company-selection-changed)
 258
 259 (defvar company-point nil)
 260 (make-variable-buffer-local 'company-point)
 261
 262 (defvar company-timer nil)
 263
 264 (defvar company-disabled-backends nil)
 265
 266 (defsubst company-strip-prefix (str)
 267   (substring str (length company-prefix)))
 268
 269 (defsubst company-reformat (candidate)
 270   ;; company-ispell needs this, because the results are always lower-case
 271   ;; It's mory efficient to fix it only when they are displayed.
 272   (concat company-prefix (substring candidate (length company-prefix))))
 273
 274 (defsubst company-should-complete (prefix)
 275   (and (eq company-idle-delay t)
 276        (>= (length prefix) company-minimum-prefix-length)))
 277
 278 (defsubst company-call-frontends (command)
 279   (dolist (frontend company-frontends)
 280     (condition-case err
 281         (funcall frontend command)
 282       (error (error "Company: Front-end %s error \"%s\" on command %s"
 283                     frontend (error-message-string err) command)))))
 284
 285 (defsubst company-set-selection (selection &optional force-update)
 286   (setq selection (max 0 (min (1- company-candidates-length) selection)))
 287   (when (or force-update (not (equal selection company-selection)))
 288     (setq company-selection selection
 289           company-selection-changed t)
 290     (company-call-frontends 'update)))
 291
 292 (defun company-apply-predicate (candidates predicate)
 293   (let (new)
 294     (dolist (c candidates)
 295       (when (funcall predicate c)
 296         (push c new)))
 297     (nreverse new)))
 298
 299 (defun company-update-candidates (candidates)
 300   (setq company-candidates-length (length candidates))
 301   (if (> company-selection 0)
 302       ;; Try to restore the selection
 303       (let ((selected (nth company-selection company-candidates)))
 304         (setq company-selection 0
 305               company-candidates candidates)
 306         (when selected
 307           (while (and candidates (string< (pop candidates) selected))
 308             (incf company-selection))
 309           (unless candidates
 310             ;; Make sure selection isn't out of bounds.
 311             (setq company-selection (min (1- company-candidates-length)
 312                                          company-selection)))))
 313     (setq company-selection 0
 314           company-candidates candidates))
 315   ;; Calculate common.
 316   (let ((completion-ignore-case (funcall company-backend 'ignore-case)))
 317     (setq company-common (try-completion company-prefix company-candidates)))
 318   (when (eq company-common t)
 319     (setq company-candidates nil)))
 320
 321 (defsubst company-calculate-candidates (prefix)
 322   (setq company-prefix prefix)
 323   (company-update-candidates
 324    (or (cdr (assoc prefix company-candidates-cache))
 325        (when company-candidates-cache
 326          (let ((len (length prefix))
 327                (completion-ignore-case (funcall company-backend 'ignore-case))
 328                prev)
 329            (dotimes (i len)
 330              (when (setq prev (cdr (assoc (substring prefix 0 (- len i))
 331                                           company-candidates-cache)))
 332                (return (all-completions prefix prev))))))
 333        (let ((candidates (funcall company-backend 'candidates prefix)))
 334          (when company-candidates-predicate
 335            (setq candidates
 336                  (company-apply-predicate candidates
 337                                           company-candidates-predicate)))
 338          (unless (funcall company-backend 'sorted)
 339            (setq candidates (sort candidates 'string<)))
 340          candidates)))
 341   (unless (assoc prefix company-candidates-cache)
 342     (push (cons prefix company-candidates) company-candidates-cache))
 343   company-candidates)
 344
 345 (defun company-idle-begin (buf win tick pos)
 346   (and company-mode
 347        (eq buf (current-buffer))
 348        (eq win (selected-window))
 349        (eq tick (buffer-chars-modified-tick))
 350        (eq pos (point))
 351        (not company-candidates)
 352        (not (equal (point) company-point))
 353        (let ((company-idle-delay t))
 354          (company-begin)
 355          (when company-candidates
 356            (company-input-noop)
 357            (company-post-command)))))
 358
 359 (defun company-manual-begin ()
 360   (and company-mode
 361        (not company-candidates)
 362        (let ((company-idle-delay t)
 363              (company-minimum-prefix-length 0))
 364          (company-begin)))
 365   ;; Return non-nil if active.
 366   company-candidates)
 367
 368 (defun company-continue ()
 369   (when company-candidates
 370     (when (funcall company-backend 'no-cache company-prefix)
 371       ;; Don't complete existing candidates, fetch new ones.
 372       (setq company-candidates-cache nil))
 373     (let ((new-prefix (funcall company-backend 'prefix)))
 374       (unless (and (= (- (point) (length new-prefix))
 375                       (- company-point (length company-prefix)))
 376                    (or (equal company-prefix new-prefix)
 377                        (company-calculate-candidates new-prefix)))
 378         (setq company-candidates nil)))))
 379
 380 (defun company-begin ()
 381   (if (or buffer-read-only overriding-terminal-local-map overriding-local-map)
 382       ;; Don't complete in these cases.
 383       (setq company-candidates nil)
 384     (company-continue)
 385     (unless company-candidates
 386       (let (prefix)
 387         (dolist (backend company-backends)
 388           (unless (fboundp backend)
 389             (ignore-errors (require backend nil t)))
 390           (if (fboundp backend)
 391               (when (setq prefix (funcall backend 'prefix))
 392                 (when (company-should-complete prefix)
 393                   (setq company-backend backend)
 394                   (company-calculate-candidates prefix))
 395                 (return prefix))
 396             (unless (memq backend company-disabled-backends)
 397               (push backend company-disabled-backends)
 398               (message "Company back-end '%s' could not be initialized"
 399                        backend)))))))
 400   (if company-candidates
 401       (progn
 402         (setq company-point (point))
 403         (company-enable-overriding-keymap company-active-map)
 404         (company-call-frontends 'update))
 405     (company-cancel)))
 406
 407 (defun company-cancel ()
 408   (setq company-backend nil
 409         company-prefix nil
 410         company-candidates nil
 411         company-candidates-length nil
 412         company-candidates-cache nil
 413         company-candidates-predicate nil
 414         company-common nil
 415         company-selection 0
 416         company-selection-changed nil
 417         company-point nil)
 418   (when company-timer
 419     (cancel-timer company-timer))
 420   (company-search-mode 0)
 421   (company-call-frontends 'hide)
 422   (company-enable-overriding-keymap nil))
 423
 424 (defun company-abort ()
 425   (company-cancel)
 426   ;; Don't start again, unless started manually.
 427   (setq company-point (point)))
 428
 429 (defun company-pre-command ()
 430   (unless (eq this-command 'company-show-doc-buffer)
 431     (condition-case err
 432         (when company-candidates
 433           (company-call-frontends 'pre-command))
 434       (error (message "Company: An error occurred in pre-command")
 435              (message "%s" (error-message-string err))
 436              (company-cancel))))
 437   (when company-timer
 438     (cancel-timer company-timer))
 439   (company-uninstall-map))
 440
 441 (defun company-post-command ()
 442   (unless (eq this-command 'company-show-doc-buffer)
 443     (condition-case err
 444         (progn
 445           (unless (equal (point) company-point)
 446             (company-begin))
 447           (when company-candidates
 448             (company-call-frontends 'post-command))
 449           (when (numberp company-idle-delay)
 450             (setq company-timer
 451                   (run-with-timer company-idle-delay nil 'company-idle-begin
 452                                   (current-buffer) (selected-window)
 453                                   (buffer-chars-modified-tick) (point)))))
 454       (error (message "Company: An error occurred in post-command")
 455              (message "%s" (error-message-string err))
 456              (company-cancel))))
 457   (company-install-map))
 458
 459 ;;; search ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 460
 461 (defvar company-search-string nil)
 462 (make-variable-buffer-local 'company-search-string)
 463
 464 (defvar company-search-lighter " Search: \"\"")
 465 (make-variable-buffer-local 'company-search-lighter)
 466
 467 (defvar company-search-old-map nil)
 468 (make-variable-buffer-local 'company-search-old-map)
 469
 470 (defvar company-search-old-selection 0)
 471 (make-variable-buffer-local 'company-search-old-selection)
 472
 473 (defun company-search (text lines)
 474   (let ((quoted (regexp-quote text))
 475         (i 0))
 476     (dolist (line lines)
 477       (when (string-match quoted line (length company-prefix))
 478         (return i))
 479       (incf i))))
 480
 481 (defun company-search-printing-char ()
 482   (interactive)
 483   (setq company-search-string
 484         (concat (or company-search-string "") (string last-command-event))
 485         company-search-lighter (concat " Search: \"" company-search-string
 486                                         "\""))
 487   (let ((pos (company-search company-search-string
 488                               (nthcdr company-selection company-candidates))))
 489     (if (null pos)
 490         (ding)
 491       (company-set-selection (+ company-selection pos) t))))
 492
 493 (defun company-search-repeat-forward ()
 494   (interactive)
 495   (let ((pos (company-search company-search-string
 496                               (cdr (nthcdr company-selection
 497                                            company-candidates)))))
 498     (if (null pos)
 499         (ding)
 500       (company-set-selection (+ company-selection pos 1) t))))
 501
 502 (defun company-search-repeat-backward ()
 503   (interactive)
 504   (let ((pos (company-search company-search-string
 505                               (nthcdr (- company-candidates-length
 506                                          company-selection)
 507                                       (reverse company-candidates)))))
 508     (if (null pos)
 509         (ding)
 510       (company-set-selection (- company-selection pos 1) t))))
 511
 512 (defsubst company-create-match-predicate (search-string)
 513   `(lambda (candidate)
 514      ,(if company-candidates-predicate
 515           `(and (string-match ,search-string candidate)
 516                 (funcall ,company-candidates-predicate candidate))
 517         `(string-match ,company-search-string candidate))))
 518
 519 (defun company-search-kill-others ()
 520   (interactive)
 521   (let ((predicate (company-create-match-predicate company-search-string)))
 522     (setq company-candidates-predicate predicate)
 523     (company-update-candidates (company-apply-predicate company-candidates
 524                                                         predicate))
 525     (company-search-mode 0)
 526     (company-call-frontends 'update)))
 527
 528 (defun company-search-abort ()
 529   (interactive)
 530   (company-set-selection company-search-old-selection t)
 531   (company-search-mode 0))
 532
 533 (defun company-search-other-char ()
 534   (interactive)
 535   (company-search-mode 0)
 536   (when last-input-event
 537     (clear-this-command-keys t)
 538     (setq unread-command-events (list last-input-event))))
 539
 540 (defvar company-search-map
 541   (let ((i 0)
 542         (keymap (make-keymap)))
 543     (if (fboundp 'max-char)
 544         (set-char-table-range (nth 1 keymap) (cons #x100 (max-char))
 545                               'company-search-printing-char)
 546       (with-no-warnings
 547         ;; obselete in Emacs 23
 548         (let ((l (generic-character-list))
 549               (table (nth 1 keymap)))
 550           (while l
 551             (set-char-table-default table (car l) 'isearch-printing-char)
 552             (setq l (cdr l))))))
 553     (define-key keymap [t] 'company-search-other-char)
 554     (while (< i ?\s)
 555       (define-key keymap (make-string 1 i) 'company-search-other-char)
 556       (incf i))
 557     (while (< i 256)
 558       (define-key keymap (vector i) 'company-search-printing-char)
 559       (incf i))
 560     (let ((meta-map (make-sparse-keymap)))
 561       (define-key keymap (char-to-string meta-prefix-char) meta-map)
 562       (define-key keymap [escape] meta-map))
 563     (define-key keymap (vector meta-prefix-char t) 'company-search-other-char)
 564     (define-key keymap "\e\e\e" 'company-search-other-char)
 565     (define-key keymap  [escape escape escape] 'company-search-other-char)
 566
 567     (define-key keymap "\C-g" 'company-search-abort)
 568     (define-key keymap "\C-s" 'company-search-repeat-forward)
 569     (define-key keymap "\C-r" 'company-search-repeat-backward)
 570     (define-key keymap "\C-o" 'company-search-kill-others)
 571     keymap))
 572
 573 (define-minor-mode company-search-mode
 574   ""
 575   nil company-search-lighter nil
 576   (if company-search-mode
 577       (if (company-manual-begin)
 578           (progn
 579             (setq company-search-old-selection company-selection)
 580             (company-enable-overriding-keymap company-search-map)
 581             (company-call-frontends 'update))
 582         (setq company-search-mode nil))
 583     (kill-local-variable 'company-search-string)
 584     (kill-local-variable 'company-search-lighter)
 585     (kill-local-variable 'company-search-old-selection)
 586     (company-enable-overriding-keymap company-active-map)))
 587
 588 (defun company-search-candidates ()
 589   (interactive)
 590   (company-search-mode 1))
 591
 592 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 593
 594 (defun company-select-next ()
 595   (interactive)
 596   (when (company-manual-begin)
 597     (company-set-selection (1+ company-selection))))
 598
 599 (defun company-select-previous ()
 600   (interactive)
 601   (when (company-manual-begin)
 602     (company-set-selection (1- company-selection))))
 603
 604 (defun company-complete-selection ()
 605   (interactive)
 606   (when (company-manual-begin)
 607     (insert (company-strip-prefix (nth company-selection company-candidates)))
 608     (company-abort)))
 609
 610 (defun company-complete-common ()
 611   (interactive)
 612   (when (company-manual-begin)
 613     (insert (company-strip-prefix company-common))))
 614
 615 (defun company-complete ()
 616   (interactive)
 617   (when (company-manual-begin)
 618     (if (or company-selection-changed
 619             (eq last-command 'company-complete-common))
 620         (call-interactively 'company-complete-selection)
 621       (call-interactively 'company-complete-common)
 622       (setq this-command 'company-complete-common))))
 623
 624 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 625
 626 (defconst company-space-strings-limit 100)
 627
 628 (defconst company-space-strings
 629   (let (lst)
 630     (dotimes (i company-space-strings-limit)
 631       (push (make-string (- company-space-strings-limit 1 i) ?\  ) lst))
 632     (apply 'vector lst)))
 633
 634 (defsubst company-space-string (len)
 635   (if (< len company-space-strings-limit)
 636       (aref company-space-strings len)
 637     (make-string len ?\ )))
 638
 639 (defsubst company-safe-substring (str from &optional to)
 640   (let ((len (length str)))
 641     (if (> from len)
 642         ""
 643       (if (and to (> to len))
 644           (concat (substring str from)
 645                   (company-space-string (- to len)))
 646         (substring str from to)))))
 647
 648 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 649
 650 (defvar company-last-metadata nil)
 651 (make-variable-buffer-local 'company-last-metadata)
 652
 653 (defun company-fetch-metadata ()
 654   (let ((selected (nth company-selection company-candidates)))
 655     (unless (equal selected (car company-last-metadata))
 656       (setq company-last-metadata
 657             (cons selected (funcall company-backend 'meta selected))))
 658     (cdr company-last-metadata)))
 659
 660 (defun company-doc-buffer (&optional string)
 661   (with-current-buffer (get-buffer-create "*Company meta-data*")
 662     (erase-buffer)
 663     (current-buffer)))
 664
 665 (defun company-show-doc-buffer ()
 666   (interactive)
 667   (when company-candidates
 668     (save-window-excursion
 669       (let* ((height (window-height))
 670              (row (cdr (posn-col-row (posn-at-point))))
 671              (selected (nth company-selection company-candidates))
 672              (buffer (funcall company-backend 'doc-buffer selected)))
 673         (if (not buffer)
 674             (error "No documentation available.")
 675           (display-buffer buffer)
 676           (and (< (window-height) height)
 677                (< (- (window-height) row 2) company-tooltip-limit)
 678                (recenter (- (window-height) row 2)))
 679           (while (eq 'scroll-other-window
 680                      (key-binding (vector (list (read-event)))))
 681             (scroll-other-window))
 682           (when last-input-event
 683             (clear-this-command-keys t)
 684             (setq unread-command-events (list last-input-event))))))))
 685
 686 ;;; pseudo-tooltip ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 687
 688 (defvar company-pseudo-tooltip-overlay nil)
 689 (make-variable-buffer-local 'company-pseudo-tooltip-overlay)
 690
 691 (defvar company-tooltip-offset 0)
 692 (make-variable-buffer-local 'company-tooltip-offset)
 693
 694 (defun company-pseudo-tooltip-update-offset (selection num-lines limit)
 695
 696   (decf limit 2)
 697   (setq company-tooltip-offset
 698         (max (min selection company-tooltip-offset)
 699              (- selection -1 limit)))
 700
 701   (when (<= company-tooltip-offset 1)
 702     (incf limit)
 703     (setq company-tooltip-offset 0))
 704
 705   (when (>= company-tooltip-offset (- num-lines limit 1))
 706     (incf limit)
 707     (when (= selection (1- num-lines))
 708       (decf company-tooltip-offset)
 709       (when (<= company-tooltip-offset 1)
 710         (setq company-tooltip-offset 0)
 711         (incf limit))))
 712
 713   limit)
 714
 715 ;;; propertize
 716
 717 (defsubst company-round-tab (arg)
 718   (* (/ (+ arg tab-width) tab-width) tab-width))
 719
 720 (defun company-untabify (str)
 721   (let* ((pieces (split-string str "\t"))
 722          (copy pieces))
 723     (while (cdr copy)
 724       (setcar copy (company-safe-substring
 725                     (car copy) 0 (company-round-tab (string-width (car copy)))))
 726       (pop copy))
 727     (apply 'concat pieces)))
 728
 729 (defun company-fill-propertize (line width selected)
 730   (setq line (company-safe-substring line 0 width))
 731   (add-text-properties 0 width (list 'face 'company-tooltip) line)
 732   (add-text-properties 0 (length company-common)
 733                        (list 'face 'company-tooltip-common) line)
 734   (when selected
 735     (if (and company-search-string
 736              (string-match (regexp-quote company-search-string) line
 737                            (length company-prefix)))
 738         (progn
 739           (add-text-properties (match-beginning 0) (match-end 0)
 740                                '(face company-tooltip-selection) line)
 741           (when (< (match-beginning 0) (length company-common))
 742             (add-text-properties (match-beginning 0) (length company-common)
 743                                  '(face company-tooltip-common-selection)
 744                                  line)))
 745       (add-text-properties 0 width '(face company-tooltip-selection) line)
 746       (add-text-properties 0 (length company-common)
 747                            (list 'face 'company-tooltip-common-selection)
 748                            line)))
 749   line)
 750
 751 ;;; replace
 752
 753 (defun company-buffer-lines (beg end)
 754   (goto-char beg)
 755   (let ((row (cdr (posn-col-row (posn-at-point))))
 756         lines)
 757     (while (and (equal (move-to-window-line (incf row)) row)
 758                 (<= (point) end))
 759       (push (buffer-substring beg (min end (1- (point)))) lines)
 760       (setq beg (point)))
 761     (unless (eq beg end)
 762       (push (buffer-substring beg end) lines))
 763     (nreverse lines)))
 764
 765 (defsubst company-modify-line (old new offset)
 766   (concat (company-safe-substring old 0 offset)
 767           new
 768           (company-safe-substring old (+ offset (length new)))))
 769
 770 (defun company-replacement-string (old lines column nl)
 771   (let (new)
 772     ;; Inject into old lines.
 773     (while old
 774       (push (company-modify-line (pop old) (pop lines) column) new))
 775     ;; Append whole new lines.
 776     (while lines
 777       (push (concat (company-space-string column) (pop lines)) new))
 778     (concat (when nl "\n")
 779             (mapconcat 'identity (nreverse new) "\n")
 780             "\n")))
 781
 782 (defun company-create-lines (column selection limit)
 783
 784   (let ((len company-candidates-length)
 785         lines
 786         width
 787         lines-copy
 788         previous
 789         remainder
 790         new)
 791
 792     ;; Scroll to offset.
 793     (setq limit (company-pseudo-tooltip-update-offset selection len limit))
 794
 795     (when (> company-tooltip-offset 0)
 796       (setq previous (format "...(%d)" company-tooltip-offset)))
 797
 798     (setq remainder (- len limit company-tooltip-offset)
 799           remainder (when (> remainder 0)
 800                       (setq remainder (format "...(%d)" remainder))))
 801
 802     (decf selection company-tooltip-offset)
 803     (setq width (min (length previous) (length remainder))
 804           lines (nthcdr company-tooltip-offset company-candidates)
 805           len (min limit len)
 806           lines-copy lines)
 807
 808     (dotimes (i len)
 809       (setq width (max (length (pop lines-copy)) width)))
 810     (setq width (min width (- (window-width) column)))
 811
 812     (when previous
 813       (push (propertize (company-safe-substring previous 0 width)
 814                         'face 'company-tooltip)
 815             new))
 816
 817     (dotimes (i len)
 818       (push (company-fill-propertize (company-reformat (pop lines))
 819                                      width (equal i selection))
 820             new))
 821
 822     (when remainder
 823       (push (propertize (company-safe-substring remainder 0 width)
 824                         'face 'company-tooltip)
 825             new))
 826
 827     (setq lines (nreverse new))))
 828
 829 ;; show
 830
 831 (defsubst company-pseudo-tooltip-height ()
 832   "Calculate the appropriate tooltip height."
 833   (max 3 (min company-tooltip-limit
 834               (- (window-height) 2
 835                  (count-lines (window-start) (point-at-bol))))))
 836
 837 (defun company-pseudo-tooltip-show (row column selection)
 838   (company-pseudo-tooltip-hide)
 839   (save-excursion
 840
 841     (move-to-column 0)
 842
 843     (let* ((height (company-pseudo-tooltip-height))
 844            (lines (company-create-lines column selection height))
 845            (nl (< (move-to-window-line row) row))
 846            (beg (point))
 847            (end (save-excursion
 848                   (move-to-window-line (+ row height))
 849                   (point)))
 850            (old-string
 851             (mapcar 'company-untabify (company-buffer-lines beg end)))
 852            str)
 853
 854       (setq company-pseudo-tooltip-overlay (make-overlay beg end))
 855
 856       (overlay-put company-pseudo-tooltip-overlay 'company-old old-string)
 857       (overlay-put company-pseudo-tooltip-overlay 'company-column column)
 858       (overlay-put company-pseudo-tooltip-overlay 'company-nl nl)
 859       (overlay-put company-pseudo-tooltip-overlay 'company-before
 860                    (company-replacement-string old-string lines column nl))
 861       (overlay-put company-pseudo-tooltip-overlay 'company-height height)
 862
 863       (overlay-put company-pseudo-tooltip-overlay 'window (selected-window)))))
 864
 865 (defun company-pseudo-tooltip-show-at-point (pos)
 866   (let ((col-row (posn-col-row (posn-at-point pos))))
 867     (company-pseudo-tooltip-show (1+ (cdr col-row)) (car col-row) company-selection)))
 868
 869 (defun company-pseudo-tooltip-edit (lines selection)
 870   (let* ((old-string (overlay-get company-pseudo-tooltip-overlay 'company-old))
 871          (column (overlay-get company-pseudo-tooltip-overlay 'company-column))
 872          (nl (overlay-get company-pseudo-tooltip-overlay 'company-nl))
 873          (height (overlay-get company-pseudo-tooltip-overlay 'company-height))
 874          (lines (company-create-lines column selection height)))
 875     (overlay-put company-pseudo-tooltip-overlay 'company-before
 876                  (company-replacement-string old-string lines column nl))))
 877
 878 (defun company-pseudo-tooltip-hide ()
 879   (when company-pseudo-tooltip-overlay
 880     (delete-overlay company-pseudo-tooltip-overlay)
 881     (setq company-pseudo-tooltip-overlay nil)))
 882
 883 (defun company-pseudo-tooltip-hide-temporarily ()
 884   (when (overlayp company-pseudo-tooltip-overlay)
 885     (overlay-put company-pseudo-tooltip-overlay 'invisible nil)
 886     (overlay-put company-pseudo-tooltip-overlay 'before-string nil)))
 887
 888 (defun company-pseudo-tooltip-unhide ()
 889   (when company-pseudo-tooltip-overlay
 890     (overlay-put company-pseudo-tooltip-overlay 'invisible t)
 891     (overlay-put company-pseudo-tooltip-overlay 'before-string
 892                  (overlay-get company-pseudo-tooltip-overlay 'company-before))))
 893
 894 (defun company-pseudo-tooltip-frontend (command)
 895   (case command
 896     ('pre-command (company-pseudo-tooltip-hide-temporarily))
 897     ('post-command
 898      (unless (and (overlayp company-pseudo-tooltip-overlay)
 899                   (equal (overlay-get company-pseudo-tooltip-overlay
 900                                       'company-height)
 901                          (company-pseudo-tooltip-height)))
 902        ;; Redraw needed.
 903        (company-pseudo-tooltip-show-at-point (- (point)
 904                                                 (length company-prefix))))
 905      (company-pseudo-tooltip-unhide))
 906     ('hide (company-pseudo-tooltip-hide)
 907            (setq company-tooltip-offset 0))
 908     ('update (when (overlayp company-pseudo-tooltip-overlay)
 909                (company-pseudo-tooltip-edit company-candidates
 910                                             company-selection)))))
 911
 912 (defun company-pseudo-tooltip-unless-just-one-frontend (command)
 913   (unless (and (eq command 'post-command)
 914                (not (cdr company-candidates)))
 915     (company-pseudo-tooltip-frontend command)))
 916
 917 ;;; overlay ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 918
 919 (defvar company-preview-overlay nil)
 920 (make-variable-buffer-local 'company-preview-overlay)
 921
 922 (defun company-preview-show-at-point (pos)
 923   (company-preview-hide)
 924
 925   (setq company-preview-overlay (make-overlay pos pos))
 926
 927   (let ((completion (company-strip-prefix (nth company-selection
 928                                                company-candidates))))
 929     (and (equal pos (point))
 930          (not (equal completion ""))
 931          (add-text-properties 0 1 '(cursor t) completion))
 932
 933     (setq completion (propertize completion 'face 'company-preview))
 934     (add-text-properties 0 (- (length company-common) (length company-prefix))
 935                          '(face company-preview-common) completion)
 936
 937     (overlay-put company-preview-overlay 'after-string completion)
 938     (overlay-put company-preview-overlay 'window (selected-window))))
 939
 940 (defun company-preview-hide ()
 941   (when company-preview-overlay
 942     (delete-overlay company-preview-overlay)
 943     (setq company-preview-overlay nil)))
 944
 945 (defun company-preview-frontend (command)
 946   (case command
 947     ('pre-command (company-preview-hide))
 948     ('post-command (company-preview-show-at-point (point)))
 949     ('hide (company-preview-hide))))
 950
 951 (defun company-preview-if-just-one-frontend (command)
 952   (unless (and (eq command 'post-command)
 953                (cdr company-candidates))
 954     (company-preview-frontend command)))
 955
 956 ;;; echo ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 957
 958 (defvar company-echo-last-msg nil)
 959 (make-variable-buffer-local 'company-echo-last-msg)
 960
 961 (defvar company-echo-timer nil)
 962
 963 (defvar company-echo-delay .1)
 964
 965 (defun company-echo-show (&optional getter)
 966   (when getter
 967     (setq company-echo-last-msg (funcall getter)))
 968   (let ((message-log-max nil))
 969     (if company-echo-last-msg
 970         (message "%s" company-echo-last-msg)
 971       (message ""))))
 972
 973 (defsubst company-echo-show-soon (&optional getter)
 974   (when company-echo-timer
 975     (cancel-timer company-echo-timer))
 976   (setq company-echo-timer (run-with-timer company-echo-delay nil
 977                                            'company-echo-show getter)))
 978
 979 (defun company-echo-format ()
 980
 981   (let ((limit (window-width (minibuffer-window)))
 982         (len -1)
 983         ;; Roll to selection.
 984         (candidates (nthcdr company-selection company-candidates))
 985         comp msg)
 986
 987     (while candidates
 988       (setq comp (company-reformat (pop candidates))
 989             len (+ len 1 (length comp)))
 990       (if (>= len limit)
 991           (setq candidates nil)
 992         (setq comp (propertize comp 'face 'company-echo))
 993         (add-text-properties 0 (length company-common)
 994                              '(face company-echo-common) comp)
 995         (push comp msg)))
 996
 997     (mapconcat 'identity (nreverse msg) " ")))
 998
 999 (defun company-echo-hide ()
1000   (when company-echo-timer
1001     (cancel-timer company-echo-timer))
1002   (setq company-echo-last-msg "")
1003   (company-echo-show))
1004
1005 (defun company-echo-frontend (command)
1006   (case command
1007     ('pre-command (company-echo-show-soon))
1008     ('post-command (company-echo-show-soon 'company-echo-format))
1009     ('hide (company-echo-hide))))
1010
1011 (defun company-echo-metadata-frontend (command)
1012   (case command
1013     ('pre-command (company-echo-show-soon))
1014     ('post-command (company-echo-show-soon 'company-fetch-metadata))
1015     ('hide (company-echo-hide))))
1016
1017 (provide 'company)
1018 ;;; company.el ends here