X-Git-Url: https://code.delx.au/gnu-emacs-elpa/blobdiff_plain/cf1c75514a0c54c3d777f10b1785164dca9c8729..83cbc7d328415bdf7aedfa02ca3017d5cb16dd11:/company-elisp.el diff --git a/company-elisp.el b/company-elisp.el index 74f88972c..e4baca170 100644 --- a/company-elisp.el +++ b/company-elisp.el @@ -1,97 +1,149 @@ -;;; company-elisp.el --- a company-mode completion back-end for emacs-lisp-mode -;; -;; Copyright (C) 2009 Nikolaj Schumacher -;; -;; This file is part of company 0.3. -;; -;; This program is free software; you can redistribute it and/or -;; modify it under the terms of the GNU General Public License -;; as published by the Free Software Foundation; either version 2 -;; of the License, or (at your option) any later version. -;; -;; This program is distributed in the hope that it will be useful, +;;; company-elisp.el --- A company-mode completion back-end for emacs-lisp-mode -*- lexical-binding: t -*- + +;; Copyright (C) 2009, 2011-2013 Free Software Foundation, Inc. + +;; Author: Nikolaj Schumacher + +;; This file is part of GNU Emacs. + +;; GNU Emacs is free software: you can redistribute it and/or modify +;; it under the terms of the GNU General Public License as published by +;; the Free Software Foundation, either version 3 of the License, or +;; (at your option) any later version. + +;; GNU Emacs is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. -;; + ;; You should have received a copy of the GNU General Public License -;; along with this program. If not, see . +;; along with GNU Emacs. If not, see . + + +;;; Commentary: +;; + +;;; Code: (require 'company) (eval-when-compile (require 'cl)) (require 'help-mode) +(require 'find-func) (defcustom company-elisp-detect-function-context t - "*If enabled, offer lisp functions only in appropriate contexts. + "If enabled, offer Lisp functions only in appropriate contexts. Functions are offered for completion only after ' and \(." :group 'company :type '(choice (const :tag "Off" nil) (const :tag "On" t))) +(defcustom company-elisp-show-locals-first t + "If enabled, locally bound variables and functions are displayed +first in the candidates list.") + (defun company-grab-lisp-symbol () (let ((prefix (company-grab-symbol))) - (unless (and (company-in-string-or-comment (- (point) (length prefix))) - (/= (char-before (- (point) (length prefix))) ?`)) - prefix))) + (if prefix + (unless (and (company-in-string-or-comment) + (/= (char-before (- (point) (length prefix))) ?`)) + prefix) + 'stop))) (defun company-elisp-predicate (symbol) (or (boundp symbol) - (fboundp symbol))) + (fboundp symbol) + (facep symbol) + (featurep symbol))) (defvar company-elisp-parse-limit 30) (defvar company-elisp-parse-depth 100) -(defvar company-elisp-binding-regexp - (concat "([ \t\n]*\\_<" (regexp-opt '("let" "defun" "defmacro" "defsubst" - "lambda" "lexical-let")) - "\\*?") - "Regular expression matching sexps containing variable bindings.") +(defvar company-elisp-var-binding-regexp + (concat "\\_<" (regexp-opt '("let" "defun" "defmacro" "defsubst" + "lambda" "lexical-let")) + "\\*?\\_>") + "Regular expression matching head of a multiple variable bindings form.") -(defvar company-elisp-binding-regexp-1 - (concat "([ \t\n]*\\_<" (regexp-opt '("dolist" "dotimes"))) - "Regular expression matching sexps containing one variable binding.") +(defvar company-elisp-var-binding-regexp-1 + (concat "\\_<\\(?:cl-\\)?" (regexp-opt '("dolist" "dotimes")) "\\_>") + "Regular expression matching head of a form with one variable binding.") -(defun company-elisp-parse-local (prefix vars) +(defvar company-elisp-fun-binding-regexp + (concat "\\_<\\(?:cl-\\)?" (regexp-opt '("flet" "labels")) "\\_>") + "Regular expression matching head of a function bindings form.") + +(defun company-elisp-locals (prefix functions-p) (let ((regexp (concat "[ \t\n]*\\(\\_<" (regexp-quote prefix) "\\(?:\\sw\\|\\s_\\)*\\_>\\)")) - (pos (point))) - (ignore-errors - (save-excursion - (dotimes (i company-elisp-parse-depth) - (up-list -1) - (save-excursion - (cond - ((looking-at company-elisp-binding-regexp) - (down-list 2) - (ignore-errors - (dotimes (i company-elisp-parse-limit) - (save-excursion - (when (looking-at "[ \t\n]*(") - (down-list 1)) - (and (looking-at regexp) - ;; Don't add incomplete text as candidate. - (not (eq (match-end 0) pos)) - (add-to-list 'vars (match-string-no-properties 1)))) - (forward-sexp)))) - ((looking-at company-elisp-binding-regexp-1) - (down-list 2) - (and (looking-at regexp) - ;; Don't add incomplete text as candidate. - (not (eq (match-end 0) pos)) - (add-to-list 'vars (match-string-no-properties 1))))))))) - vars)) + (pos (point)) + res) + (condition-case nil + (save-excursion + (dotimes (i company-elisp-parse-depth) + (up-list -1) + (save-excursion + (when (eq (char-after) ?\() + (forward-char 1) + (when (ignore-errors + (save-excursion (forward-list) + (<= (point) pos))) + (skip-chars-forward " \t\n") + (cond + ((looking-at (if functions-p + company-elisp-fun-binding-regexp + company-elisp-var-binding-regexp)) + (down-list 1) + (condition-case nil + (dotimes (i company-elisp-parse-limit) + (save-excursion + (when (looking-at "[ \t\n]*(") + (down-list 1)) + (when (looking-at regexp) + (pushnew (match-string-no-properties 1) res))) + (forward-sexp)) + (scan-error nil))) + ((unless functions-p + (looking-at company-elisp-var-binding-regexp-1)) + (down-list 1) + (when (looking-at regexp) + (pushnew (match-string-no-properties 1) res))))))))) + (scan-error nil)) + res)) (defun company-elisp-candidates (prefix) + (let* ((predicate (company-elisp-candidates-predicate prefix)) + (locals (company-elisp-locals prefix (eq predicate 'fboundp))) + (globals (company-elisp-globals prefix predicate)) + (locals (loop for local in locals + when (not (member local globals)) + collect local))) + (if company-elisp-show-locals-first + (append (sort locals 'string<) + (sort globals 'string<)) + (append locals globals)))) + +(defun company-elisp-globals (prefix predicate) + (all-completions prefix obarray predicate)) + +(defun company-elisp-candidates-predicate (prefix) (let* ((completion-ignore-case nil) - (before (char-before (- (point) (length prefix)))) - (predicate (if (and company-elisp-detect-function-context - (not (eq before ?'))) - (if (eq before ?\() - 'fboundp - 'boundp) - 'company-elisp-predicate)) - (candidates (all-completions prefix obarray predicate))) - (company-elisp-parse-local prefix candidates))) + (before (char-before (- (point) (length prefix))))) + (if (and company-elisp-detect-function-context + (not (eq before ?'))) + (if (and (eq before ?\() + (not + (save-excursion + (ignore-errors + (up-list -2) + (and (save-excursion + (forward-char 1) + (looking-at "[ \t\n]*(")) + (prog1 (search-backward "(") + (forward-char 1)) + (looking-at company-elisp-var-binding-regexp)))))) + 'fboundp + 'boundp) + 'company-elisp-predicate))) (defun company-elisp-doc (symbol) (let* ((symbol (intern symbol)) @@ -107,20 +159,30 @@ Functions are offered for completion only after ' and \(." "A `company-mode' completion back-end for `emacs-lisp-mode'." (interactive (list 'interactive)) (case command - ('interactive (company-begin-backend 'company-elisp)) - ('prefix (and (eq (derived-mode-p 'emacs-lisp-mode) 'emacs-lisp-mode) - (company-grab-lisp-symbol))) - ('candidates (company-elisp-candidates arg)) - ('meta (company-elisp-doc arg)) - ('doc-buffer (let ((symbol (intern arg))) - (save-window-excursion - (when (or (ignore-errors (describe-function symbol)) - (ignore-errors (describe-variable symbol))) - (help-buffer))))) - ('location (let ((sym (intern arg))) - (or (ignore-errors (find-definition-noselect sym nil)) - (ignore-errors (find-definition-noselect sym 'defvar)) - (ignore-errors (find-definition-noselect sym t))))))) + (interactive (company-begin-backend 'company-elisp)) + (prefix (and (eq (derived-mode-p 'emacs-lisp-mode) 'emacs-lisp-mode) + (company-grab-lisp-symbol))) + (candidates (company-elisp-candidates arg)) + (sorted company-elisp-show-locals-first) + (meta (company-elisp-doc arg)) + (doc-buffer (let ((symbol (intern arg))) + (save-window-excursion + (ignore-errors + (cond + ((fboundp symbol) (describe-function symbol)) + ((boundp symbol) (describe-variable symbol)) + ((featurep symbol) (describe-package symbol)) + ((facep symbol) (describe-face symbol)) + (t (signal 'user-error nil))) + (help-buffer))))) + (location (let ((sym (intern arg))) + (cond + ((fboundp sym) (find-definition-noselect sym nil)) + ((boundp sym) (find-definition-noselect sym 'defvar)) + ((featurep sym) (cons (find-file-noselect (find-library-name + (symbol-name sym))) + 0)) + ((facep sym) (find-definition-noselect sym 'defface))))))) (provide 'company-elisp) ;;; company-elisp.el ends here