1 ;;; company-dabbrev.el --- dabbrev-like company-mode completion back-end -*- lexical-binding: t -*-
3 ;; Copyright (C) 2009, 2011, 2014 Free Software Foundation, Inc.
5 ;; Author: Nikolaj Schumacher
7 ;; This file is part of GNU Emacs.
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.
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.
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/>.
31 (defgroup company-dabbrev nil
32 "dabbrev-like completion back-end."
35 (defcustom company-dabbrev-other-buffers 'all
36 "Determines whether `company-dabbrev' should search other buffers.
37 If `all', search all other buffers. If t, search buffers with the same
39 See also `company-dabbrev-time-limit'."
40 :type '(choice (const :tag "Off" nil)
41 (const :tag "Same major mode" t)
42 (const :tag "All" all)))
44 (defcustom company-dabbrev-time-limit .1
45 "Determines how many seconds `company-dabbrev' should look for matches."
46 :type '(choice (const :tag "Off" nil)
47 (number :tag "Seconds")))
49 (defcustom company-dabbrev-char-regexp "\\sw"
50 "A regular expression matching the characters `company-dabbrev' looks for."
53 (defcustom company-dabbrev-ignore-case 'keep-prefix
54 "Non-nil to ignore case when collecting completion candidates.
55 When it's `keep-prefix', the text before point will remain unchanged after
56 candidate is inserted, even some of its characters have different case.")
58 (defcustom company-dabbrev-downcase 'case-replace
59 "Whether to downcase the returned candidates.
61 The value of nil means keep them as-is.
62 `case-replace' means use the value of `case-replace'.
63 Any other value means downcase.
65 If you set this value to nil, you may also want to set
66 `company-dabbrev-ignore-case' to any value other than `keep-prefix'.")
68 (defcustom company-dabbrev-minimum-length 4
69 "The minimum length for the completion candidate to be included.
70 This variable affects both `company-dabbrev' and `company-dabbrev-code'."
72 :package-version '(company . "0.8.3"))
74 (defmacro company-dabrev--time-limit-while (test start limit &rest body)
75 (declare (indent 3) (debug t))
76 `(let ((company-time-limit-while-counter 0))
81 (eq (cl-incf company-time-limit-while-counter) 25)
82 (setq company-time-limit-while-counter 0)
83 (> (float-time (time-since ,start)) ,limit)
84 (throw 'done 'company-time-out))))))
86 (defsubst company-dabbrev--make-regexp (prefix)
87 (concat "\\<" (if (equal prefix "")
88 company-dabbrev-char-regexp
89 (regexp-quote prefix))
90 "\\(" company-dabbrev-char-regexp "\\)*\\>"))
92 (defun company-dabbrev--search-buffer (regexp pos symbols start limit
96 (goto-char (if pos (1- pos) (point-min)))
98 (company-dabrev--time-limit-while (re-search-backward regexp nil t)
100 (setq match (match-string-no-properties 0))
101 (if (and ignore-comments (company-in-string-or-comment))
102 (goto-char (nth 8 (syntax-ppss)))
103 (when (>= (length match) company-dabbrev-minimum-length)
104 (push match symbols))))
105 (goto-char (or pos (point-min)))
107 (company-dabrev--time-limit-while (re-search-forward regexp nil t)
109 (setq match (match-string-no-properties 0))
110 (if (and ignore-comments (company-in-string-or-comment))
111 (re-search-forward "\\s>\\|\\s!\\|\\s\"" nil t)
112 (when (>= (length match) company-dabbrev-minimum-length)
113 (push match symbols))))
116 (defun company-dabbrev--search (regexp &optional limit other-buffer-modes
118 (let* ((start (current-time))
119 (symbols (company-dabbrev--search-buffer regexp (point) nil start limit
121 (when other-buffer-modes
122 (cl-dolist (buffer (delq (current-buffer) (buffer-list)))
123 (with-current-buffer buffer
124 (when (if (eq other-buffer-modes 'all)
125 (not (string-match-p "\\`[ *]" (buffer-name)))
126 (apply #'derived-mode-p other-buffer-modes))
128 (company-dabbrev--search-buffer regexp nil symbols start
129 limit ignore-comments))))
131 (> (float-time (time-since start)) limit)
136 (defun company-dabbrev (command &optional arg &rest ignored)
137 "dabbrev-like `company-mode' completion back-end."
138 (interactive (list 'interactive))
140 (interactive (company-begin-backend 'company-dabbrev))
141 (prefix (company-grab-word))
143 (let* ((case-fold-search company-dabbrev-ignore-case)
144 (words (company-dabbrev--search (company-dabbrev--make-regexp arg)
145 company-dabbrev-time-limit
146 (pcase company-dabbrev-other-buffers
147 (`t (list major-mode))
149 (downcase-p (if (eq company-dabbrev-downcase 'case-replace)
151 company-dabbrev-downcase)))
153 (mapcar 'downcase words)
155 (ignore-case company-dabbrev-ignore-case)
158 (provide 'company-dabbrev)
159 ;;; company-dabbrev.el ends here