Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: master
310 lines (256 sloc) 12.578 kB
;;; readline-complete.el --- offers completions in shell mode
;; Copyright (C) 2012 Christopher Monsanto
;; Copyright (C) 2014 Dmitry Gutov
;; Author: Christopher Monsanto <>
;; Version: 1.0
;; 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 3 of the License, or
;; (at your option) any later version.
;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; 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 <>.
;;; Commentary:
;; I find it particularly annoying that Emacs *shell* buffers do not
;; offer satisfactory completions, but xterm does. I even used
;; ansi-term for a while because of this (oh god). What I really
;; wanted was for Emacs to show completions via auto-complete.el, like
;; every other mode I use often. This package hopes to deliver on that
;; promise.
;; xterm and friends get their completions from readline, a GNU
;; library that is aware of your context and monitors your keystrokes
;; for TABs and what not so you can be shown a list of
;; completions. readline-complete.el gives you a process filter that
;; tries to parse readline completion menus and give Emacs a list of
;; strings that are valid for completion in the current context.
;;; Installation:
;; There is no one "right" way to install this package, because it
;; does not provide any user level commands. I find that it works
;; particularly well with shell-mode and auto-complete.el, so I'll
;; describe how my setup works.
;; First, let us setup shell-mode. shell-mode, by default, does not
;; create a tty (terminal) and does not echo input, both of which are
;; required for proper operation. To fix this, adjust the arguments to
;; your shell:
;; (setq explicit-shell-file-name "bash")
;; (setq explicit-bash-args '("-c" "export EMACS=; stty echo; bash"))
;; (setq comint-process-echoes t)
;; ASIDE: if you call ssh from shell directly, add "-t" to explicit-ssh-args to enable terminal.
;; The simplest way is to install from melpa, and add to your init file:
;; (require 'readline-complete)
;; This package also supports lazy loading via a loaddefs file.
;; Two completion frameworks are supported, you only need to pick one.
;; Auto-Complete setup:
;; Go ahead and get auto-complete.el from
;;, and follow the
;; instructions for setup.
;; Then enable it in your init file.
;; (add-to-list 'ac-modes 'shell-mode)
;; (add-hook 'shell-mode-hook 'ac-rlc-setup-sources)
;; Company setup:
;; See installation instructions at
;; Set up completion back-end:
;; (push 'company-readline company-backends)
;; (add-hook 'rlc-no-readline-hook (lambda () (company-mode -1)))
;; Finally, M-x shell, and start typing!
;; For customization, see the docstrings of `rlc-timeout`,
;; `rlc-attempts`, and `ac-rlc-prompts`.
;;; Gotchas:
;; GNU readline, unfortunately, was not made for this kind of
;; operation. That is not to say this package isn't stable (how could
;; you think such a thing!), but it is sensitive to some readline
;; customizations. Consider putting some of the following lines in
;; your bashrc (you can test if we are using Emacs for the session by
;; testing [[ $INSIDE_EMACS ]]. Note that readline-complete should
;; work with the default readline settings.
;; - bell-style: it is preferable to disable the bell.
;; bind 'set bell-style none'
;; - completion-display-width: saves bandwidth to set this to zero:
;; bind 'set completion-display-width 0'
;; - completion-prefix-display-length: ***MUST*** be 0, otherwise
;; readline truncates the completions. This is the default.
;; - completion-query-items: Controls the "Display ... possible
;; completions?" menu. Adjust this to keep readline-complete from
;; downloading tons and tons of completions. The default of 100 is
;; pretty good.
;; - disable-completion: ***MUST*** be off! Default.
;; - expand-tilde: ***MUST*** be off! Default.
;; - horizontal-scroll-mode: Default is off, but on will save
;; bandwidth. bind 'set horizontal-scroll-mode on'.
;; - page-completions: Default is on (off on Ubuntu), but causes
;; readline-complete to disregard completions with the --More--
;; menu. Best to disable this with bind 'set page-completions off'.
;; - print-completions-horizontally: Default is off, but saves
;; bandwidth to turn it on.
;; bind 'set print-completions-horizontally on'.
;; - bindings: When a command is executed, readline processes the text
;; as input according to its bindings. Best to make tab characters not
;; replaced by the default binding "\C-i": complete. Instead:
;; bind '"\C-i": self-insert'
;; *** Note that this package works with READLINE. Maybe editline (BSD
;; programs), NOT haskeline (ghci, unfortunately). Shells that don't use
;; readline (like zsh?) won't work. Use bash instead. (come on, with
;; shopt you can enable most of zsh's cool features, and the user
;; experience is given by Emacs!!).
;; I don't use a Mac (Linux all the way), but I hear Apple uses
;; editline instead of readline. Consider recompiling bash, python,
;; etc with readline support instead.
;; Patches welcome!
;;; Code:
(require 'cl))
(require 'comint)
(require 'shell)
(defvar rlc-attempts 30
"How many times should we wait for readline output, before
aborting and running `rlc-no-readline-hook'?")
(defvar rlc-timeout 0.03
"Time, in seconds, to wait for readline output. If readline is
not enabled on your terminal, you will wait a total of
rlc-attempts * rlc-timeout seconds.")
(defvar rlc-no-readline-hook nil
"Hook that is run when readline-complete cannot parse the
output. Useful for disabling autocompletion.")
(defvar rlc-accumulated-input nil
"The input obtained so far by `rlc-filter'.")
(defun rlc-filter (proc string)
"Process filter which accumulates text in `rlc-accumulated-input'."
(setq rlc-accumulated-input (concat rlc-accumulated-input string)))
(defun rlc-candidates ()
"Return the list of completions that readline would have given via completion-menu."
(let* ((proc (get-buffer-process (current-buffer)))
(filt (process-filter proc))
(current-command (buffer-substring-no-properties
(save-excursion (comint-bol) (point))
; Must start with 'n' to cancel menus.
(lentodel (+ (length current-command) (length "n*")))
; Regexp matching readline output. Highly sensitive!
(regexp (concat; "^"
(regexp-quote current-command)
; branch one: more dialog?
"\\(?:\\(?:.*\n\\)+\\)" ; match a bunch of lines (ignored)
"--More--\C-m\C-m" ; A more dialog...
".*?" ; prompt
(regexp-quote current-command)
"\\*" ; terminator
(format "\\(?:\C-h \C-h\\)\\{%s\\}" (1- lentodel))
"\C-g?" ; maybe bell at the end (too many deletions)
"Display all [0-9]+ possibilities\\? (y or n)" ; branch two: too many.
"\C-m?\n.*?" ; prompt
(regexp-quote current-command)
"\\*" ; A terminator
; Once for position backwards, once for space, once for reposition...
(format "\\(?:\C-h \C-h\\)\\{%s\\}" (1- lentodel))
"\C-g?" ; maybe bell at the end (too many deletions)
"\\(?:" ; branch three: enough
"\\(\\(?:.*\n\\)+\\)" ; success; match a bunch of lines
".*?" ; then match the prompt followed by our old input
; stack overflow without non-greedy
(regexp-quote current-command)
"\C-g?" ; maybe bell otherwise
"n\\*" ; Terminator
; Once for position backwards, once for space, once for reposition...
(format "\\(?:\C-h \C-h\\)\\{%s\\}" lentodel)
(setq rlc-accumulated-input "")
(set-process-filter proc 'rlc-filter)
(process-send-string proc (concat current-command
"\e?" ; show menu,
"n*" ; terminator
(make-string lentodel ?\C-h)))
(loop repeat rlc-attempts
if (string-match regexp rlc-accumulated-input)
return (split-string (or (match-string 1 rlc-accumulated-input) ""))
else do (sleep-for rlc-timeout)
finally (run-hooks 'rlc-no-readline-hook))
(set-process-filter proc filt))))
;; Auto-Complete
(defvar ac-rlc-prompts
`(("^>>> " ac-prefix-default ac-prefix-c-dot) ; python, you have to
; setup python to work with
; readline though. use ipython instead.
("^In \\[[0-9]+\\]: " ac-prefix-rlc-dot) ; ipython
("^sftp> " ac-prefix-rlc-disable) ; sftp has no readline
("^lftp [^>]+> " ac-prefix-rlc-shell) ; lftp
("^\\[[0-9]+\\] pry([^>]> " ac-prefix-rlc-dot) ; pry
("^irb([^>]> " ac-prefix-rlc-dot) ; irb, need irb -r irb/completion
(,shell-prompt-pattern ac-prefix-rlc-shell) ; Shell
"ac-rlc works by checking the current prompt. This list holds
all of ac-rlc's known prompts, along with an auto-complete
prefix to recognize contexts appropriate to the application.
To disable ac-rlc for an application, add '(prompt ac-prefix-rlc-disable).")
(defun ac-prefix-rlc-disable ()
"Disable autocomplete on readline."
(defun ac-prefix-rlc-shell ()
(if (re-search-backward "[ /]\\([^ /]*\\)\\=" nil t)
(match-beginning 1)))
(defun ac-prefix-rlc-dot ()
(if (re-search-backward "[^a-zA-Z0-9_.]\\([a-zA-Z0-9_.]+\\)\\=" nil t)
(match-beginning 1)))
(defun ac-rlc-setup-sources ()
"Add me to shell-mode-hook!"
(add-to-list 'ac-sources 'ac-source-shell)
(add-hook 'rlc-no-readline-hook '(lambda () (auto-complete-mode -1))))
(defun ac-rlc-prefix-shell-dispatcher ()
(let ((prefix (and (not isearch-mode)
(loop for (regexp prefix) in ac-rlc-prompts
when (looking-back regexp)
return prefix)))))
(when prefix
(funcall prefix))))
(eval-after-load 'auto-complete
;; eval to avoid compiling. compiler needs ac-define-source macro
;; definition loaded or else we get runtime error, but we want to keep
;; installation of auto-complete optional
'(eval '(ac-define-source shell
'((candidates . rlc-candidates)
(prefix . ac-rlc-prefix-shell-dispatcher)
(requires . 0)))))
;; Company
(defun company-readline (command &optional arg &rest _ignore)
"`company-mode' back-end using `readline-complete'."
(interactive (list 'interactive))
(case command
(interactive (company-begin-backend 'company-readline))
(prefix (save-excursion
(let ((pt (point))
(beg (ac-rlc-prefix-shell-dispatcher)))
(and beg (buffer-substring-no-properties beg pt)))))
(candidates (rlc-candidates))))
(provide 'readline-complete)
;;; readline-complete.el ends here
Jump to Line
Something went wrong with that request. Please try again.