elisp/geiser-company.el

   1 ;; geiser-company.el -- integration with company-mode
   2
   3 ;; Copyright (C) 2009, 2010, 2011, 2012, 2013, 2014, 2016 Jose Antonio Ortega Ruiz
   4
   5 ;; This program is free software; you can redistribute it and/or
   6 ;; modify it under the terms of the Modified BSD License. You should
   7 ;; have received a copy of the license along with this program. If
   8 ;; not, see <http://www.xfree86.org/3.3.6/COPYRIGHT2.html#5>.
   9
  10 ;; Start date: Mon Aug 24, 2009 12:44
  11
  12 \f
  13
  14 (require 'geiser-autodoc)
  15 (require 'geiser-completion)
  16 (require 'geiser-edit)
  17 (require 'geiser-base)
  18 (require 'geiser-doc)
  19
  20 (eval-when-compile (require 'cl))
  21
  22 \f
  23 ;;; Helpers:
  24
  25 (make-variable-buffer-local
  26  (defvar geiser-company--enabled-flag nil))
  27
  28 (make-variable-buffer-local
  29  (defvar geiser-company--autodoc-flag nil))
  30
  31 (make-variable-buffer-local
  32  (defvar geiser-company--completions nil))
  33
  34 (defun geiser-company--candidates (prefix)
  35   (and (equal prefix (car geiser-company--completions))
  36        (cdr geiser-company--completions)))
  37
  38 (defun geiser-company--doc (id)
  39   (ignore-errors
  40     (when (not (geiser-autodoc--inhibit))
  41       (let ((help (geiser-autodoc--autodoc `((,id 0)))))
  42         (and help (substring-no-properties help))))))
  43
  44 (defun geiser-company--doc-buffer (id)
  45   (let* ((impl geiser-impl--implementation)
  46          (module (geiser-eval--get-module))
  47          (symbol (make-symbol id))
  48          (ds (geiser-doc--get-docstring symbol module)))
  49     (if (or (not ds) (not (listp ds)))
  50         (progn
  51           (message "No documentation available for '%s'" symbol)
  52           nil)
  53       (with-current-buffer (get-buffer-create "*company-documentation*")
  54         (geiser-doc--render-docstring ds symbol module impl)
  55         (current-buffer)))))
  56
  57 (defun geiser-company--docstring (id)
  58   (let* ((module (geiser-eval--get-module))
  59          (symbol (make-symbol id))
  60          (ds (geiser-doc--get-docstring symbol module)))
  61     (and ds
  62          (listp ds)
  63          (concat (geiser-autodoc--str* (cdr (assoc "signature" ds)))
  64                  "\n\n"
  65                  (cdr (assoc "docstring" ds))))))
  66
  67 (defun geiser-company--location (id)
  68   (ignore-errors
  69     (when (not (geiser-autodoc--inhibit))
  70       (let ((id (make-symbol id)))
  71         (condition-case nil
  72             (geiser-edit-module id 'noselect)
  73           (error (geiser-edit-symbol id 'noselect)))))))
  74
  75 (defun geiser-company--prefix-at-point ()
  76   (ignore-errors
  77     (when (and (not (geiser-autodoc--inhibit)) geiser-company--enabled-flag)
  78       (if (nth 8 (syntax-ppss)) 'stop
  79         (let* ((prefix (and (looking-at-p "\\_>")
  80                             (geiser-completion--prefix nil)))
  81                (cmps1 (and prefix
  82                            (geiser-completion--complete prefix nil)))
  83                (cmps2 (and prefix
  84                            (geiser-completion--complete prefix t)))
  85                (mprefix (and (not cmps1) (not cmps2)
  86                              (geiser-completion--prefix t)))
  87                (cmps3 (and mprefix (geiser-completion--complete mprefix t)))
  88                (cmps (or cmps3 (append cmps1 cmps2)))
  89                (prefix (or mprefix prefix)))
  90           (setq geiser-company--completions (cons prefix cmps))
  91           prefix)))))
  92
  93 \f
  94 ;;; Activation
  95
  96 (defun geiser-company--setup (enable)
  97   (setq geiser-company--enabled-flag enable)
  98   (when (fboundp 'geiser-company--setup-company)
  99     (geiser-company--setup-company enable)))
 100
 101 (defun geiser-company--inhibit-autodoc (ignored)
 102   (when (setq geiser-company--autodoc-flag geiser-autodoc-mode)
 103     (geiser-autodoc-mode -1)))
 104
 105 (defun geiser-company--restore-autodoc (&optional ignored)
 106   (when geiser-company--autodoc-flag
 107     (geiser-autodoc-mode 1)))
 108
 109 \f
 110 ;;; Company activation
 111
 112 (declare-function company-begin-backend "ext:company")
 113 (declare-function company-cancel "ext:company")
 114 (declare-function company-mode "ext:company")
 115 (defvar company-backends)
 116 (defvar company-active-map)
 117 (eval-after-load "company"
 118   '(progn
 119      (defun geiser-company-backend (command &optional arg &rest ignored)
 120        "A `company-mode' completion back-end for `geiser-mode'."
 121        (interactive (list 'interactive))
 122        (case command
 123          ('interactive (company-begin-backend 'geiser-company-backend))
 124          ('prefix (geiser-company--prefix-at-point))
 125          ('candidates (geiser-company--candidates arg))
 126          ('meta (geiser-company--doc arg))
 127          ('doc-buffer (geiser-company--doc-buffer arg))
 128          ('quickhelp-string (geiser-company--docstring arg))
 129          ('location (geiser-company--location arg))
 130          ('sorted t)))
 131      (defun geiser-company--setup-company (enable)
 132        (when enable
 133          (set (make-local-variable 'company-backends)
 134               (add-to-list 'company-backends 'geiser-company-backend)))
 135        (company-mode (if enable 1 -1)))
 136      (add-hook 'company-completion-finished-hook
 137                'geiser-company--restore-autodoc)
 138      (add-hook 'company-completion-cancelled-hook
 139                'geiser-company--restore-autodoc)
 140      (add-hook 'company-completion-started-hook
 141                'geiser-company--inhibit-autodoc)
 142      (define-key company-active-map (kbd "M-`")
 143        (lambda ()
 144          (interactive)
 145          (company-cancel)
 146          (call-interactively 'geiser-completion--complete-module)))))
 147
 148
 149 \f
 150 (provide 'geiser-company)