[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] master 9f15c4b: externals-list (ivy, counsel): Convert to :extern
From: |
Stefan Monnier |
Subject: |
[elpa] master 9f15c4b: externals-list (ivy, counsel): Convert to :external |
Date: |
Wed, 2 Dec 2020 14:04:46 -0500 (EST) |
branch: master
commit 9f15c4bcb308ac7cd8b0c59df114ea6a3760bed9
Author: Stefan Monnier <monnier@iro.umontreal.ca>
Commit: Stefan Monnier <monnier@iro.umontreal.ca>
externals-list (ivy, counsel): Convert to :external
---
externals-list | 2 +
packages/counsel/counsel.el | 6040 -------------------------------------------
packages/ivy/colir.el | 124 -
packages/ivy/dir | 18 -
packages/ivy/ivy-hydra.el | 133 -
packages/ivy/ivy-overlay.el | 154 --
packages/ivy/ivy.el | 5056 ------------------------------------
packages/ivy/ivy.info | 1954 --------------
8 files changed, 2 insertions(+), 13479 deletions(-)
diff --git a/externals-list b/externals-list
index aa855ee..e581408 100644
--- a/externals-list
+++ b/externals-list
@@ -87,6 +87,7 @@
("company-math" :external "https://github.com/vspinu/company-math.git")
("company-statistics" :external
"https://github.com/company-mode/company-statistics")
("context-coloring" :external
"https://github.com/jacksonrayhamilton/context-coloring.git")
+ ("counsel" :external "https://github.com/abo-abo/swiper")
("cpio-mode" :external "https://github.com/dlewan/cpio-mode")
("crisp" :external nil)
("csv-mode" :external nil)
@@ -152,6 +153,7 @@
("hyperbole" :external
"http://git.savannah.gnu.org/r/hyperbole.git")
("ioccur" :external
"https://github.com/thierryvolpiatto/ioccur.git")
("iterators" :external nil)
+ ("ivy" :external "https://github.com/abo-abo/swiper")
("ivy-explorer" :external "https://github.com/clemera/ivy-explorer")
("ivy-posframe" :external "https://github.com/tumashu/ivy-posframe")
("javaimp" :external nil)
diff --git a/packages/counsel/counsel.el b/packages/counsel/counsel.el
deleted file mode 100644
index 3cb817f..0000000
--- a/packages/counsel/counsel.el
+++ /dev/null
@@ -1,6040 +0,0 @@
-;;; counsel.el --- Various completion functions using Ivy -*- lexical-binding:
t -*-
-
-;; Copyright (C) 2015-2019 Free Software Foundation, Inc.
-
-;; Author: Oleh Krehel <ohwoeowho@gmail.com>
-;; URL: https://github.com/abo-abo/swiper
-;; Version: 0.13.1
-;; Package-Requires: ((emacs "24.5") (swiper "0.13.1"))
-;; Keywords: convenience, matching, tools
-
-;; This file is part of GNU Emacs.
-
-;; This file 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, 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
-;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-;; GNU General Public License for more details.
-
-;; For a full copy of the GNU General Public License
-;; see <https://www.gnu.org/licenses/>.
-
-;;; Commentary:
-
-;; Just call one of the interactive functions in this file to complete
-;; the corresponding thing using `ivy'.
-;;
-;; Currently available:
-;; - Symbol completion for Elisp, Common Lisp, Python, Clojure, C, C++.
-;; - Describe functions for Elisp: function, variable, library, command,
-;; bindings, theme.
-;; - Navigation functions: imenu, ace-line, semantic, outline.
-;; - Git utilities: git-files, git-grep, git-log, git-stash, git-checkout.
-;; - Grep utilities: grep, ag, pt, recoll, ack, rg.
-;; - System utilities: process list, rhythmbox, linux-app.
-;; - Many more.
-
-;;; Code:
-
-(require 'swiper)
-(require 'compile)
-(require 'dired)
-
-(defgroup counsel nil
- "Completion functions using Ivy."
- :group 'matching
- :prefix "counsel-")
-
-;;* Utility
-(defun counsel--elisp-to-pcre (regex &optional look-around)
- "Convert REGEX from Elisp format to PCRE format, on best-effort basis.
-REGEX may be of any format returned by an Ivy regex function,
-namely a string or a list. The return value is always a string.
-
-Note that incorrect results may be returned for sufficiently
-complex regexes."
- (if (consp regex)
- (if (and look-around
- (or (cdr regex)
- (not (cdar regex))))
- (concat
- "^"
- (mapconcat
- (lambda (pair)
- (let ((subexp (counsel--elisp-to-pcre (car pair))))
- (format "(?%c.*%s)"
- (if (cdr pair) ?= ?!)
- subexp)))
- regex
- ""))
- (mapconcat
- (lambda (pair)
- (let ((subexp (counsel--elisp-to-pcre (car pair))))
- (if (string-match-p "|" subexp)
- (format "(?:%s)" subexp)
- subexp)))
- (cl-remove-if-not #'cdr regex)
- ".*"))
- (replace-regexp-in-string
- "\\\\[(){}|`']\\|[()]"
- (lambda (s)
- (or (cdr (assoc s '(("\\(" . "(")
- ("\\)" . ")")
- ("(" . "\\(")
- (")" . "\\)")
- ("\\{" . "{")
- ("\\}" . "}")
- ("\\|" . "|")
- ("\\`" . "^")
- ("\\'" . "$"))))
- (error
- "Unexpected error in `counsel--elisp-to-pcre' (got match %S)" s)))
- regex t t)))
-
-(defun counsel-directory-name (dir)
- "Return the name of directory DIR with a slash."
- (file-name-as-directory
- (file-name-nondirectory
- (directory-file-name dir))))
-
-(defun counsel-string-compose (prefix str)
- "Make PREFIX the display prefix of STR through text properties."
- (let ((str (copy-sequence str)))
- (put-text-property
- 0 1 'display
- (concat prefix (substring str 0 1))
- str)
- str))
-
-(defun counsel-require-program (cmd)
- "Check system for program used in CMD, printing error if not found.
-CMD is either a string or a list of strings.
-To skip the `executable-find' check, start the string with a space."
- (unless (and (stringp cmd) (string-match-p "^ " cmd))
- (let ((program (if (listp cmd)
- (car cmd)
- (car (split-string cmd)))))
- (or (and (stringp program)
- (not (string= program ""))
- (executable-find program))
- (user-error "Required program \"%s\" not found in your path"
program)))))
-
-(declare-function eshell-split-path "esh-util")
-
-(defun counsel-prompt-function-dir ()
- "Return prompt appended with the parent directory."
- (require 'esh-util)
- (let* ((dir (ivy-state-directory ivy-last))
- (parts (nthcdr 3 (eshell-split-path dir)))
- (dir (format " [%s]: " (if parts (apply #'concat "..." parts) dir))))
- (ivy-add-prompt-count
- (replace-regexp-in-string ; Insert dir before any trailing colon.
- "\\(?:: ?\\)?\\'" dir (ivy-state-prompt ivy-last) t t))))
-
-;;* Async Utility
-(defvar counsel--async-time nil
- "Store the time when a new process was started.
-Or the time of the last minibuffer update.")
-
-(defvar counsel--async-start nil
- "Store the time when a new process was started.
-Or the time of the last minibuffer update.")
-
-(defvar counsel--async-duration nil
- "Store the time a process takes to gather all its candidates.
-The time is measured in seconds.")
-
-(defvar counsel--async-exit-code-plist ()
- "Associate commands with their exit code descriptions.
-This plist maps commands to a plist mapping their exit codes to
-descriptions.")
-
-(defvar counsel--async-last-error-string nil
- "When the process returned non-0, store the output here.")
-
-(defun counsel-set-async-exit-code (cmd number str)
- "For CMD, associate NUMBER exit code with STR."
- (let ((plist (plist-get counsel--async-exit-code-plist cmd)))
- (setq counsel--async-exit-code-plist
- (plist-put counsel--async-exit-code-plist
- cmd
- (plist-put plist number str)))))
-
-(defvar counsel-async-split-string-re-alist '((t . "\n"))
- "Store the regexp for splitting shell command output.")
-
-(defvar counsel-async-ignore-re-alist nil
- "An alist of regexp matching candidates to ignore in
`counsel--async-filter'.")
-
-(defvar counsel--async-last-command nil
- "Store the last command ran by `counsel--async-command'.")
-
-(defun counsel--async-command (cmd &optional sentinel filter name)
- "Start and return new counsel process by calling CMD.
-CMD can be either a shell command as a string, or a list of the
-program name to be called directly, followed by its arguments.
-If the default counsel process or one with NAME already exists,
-kill it and its associated buffer before starting a new one.
-Give the process the functions SENTINEL and FILTER, which default
-to `counsel--async-sentinel' and `counsel--async-filter',
-respectively."
- (counsel-delete-process name)
- (setq name (or name " *counsel*"))
- (when (get-buffer name)
- (kill-buffer name))
- (setq counsel--async-last-command cmd)
- (let* ((buf (get-buffer-create name))
- (proc (if (listp cmd)
- (apply #'start-file-process name buf cmd)
- (start-file-process-shell-command name buf cmd))))
- (setq counsel--async-time (current-time))
- (setq counsel--async-start counsel--async-time)
- (set-process-sentinel proc (or sentinel #'counsel--async-sentinel))
- (set-process-filter proc (or filter #'counsel--async-filter))
- proc))
-
-(defun counsel--split-string (&optional str)
- (split-string
- (or str (buffer-string))
- (ivy-alist-setting counsel-async-split-string-re-alist)
- t))
-
-(defun counsel--async-sentinel (process _msg)
- "Sentinel function for an asynchronous counsel PROCESS."
- (when (eq (process-status process) 'exit)
- (if (zerop (process-exit-status process))
- (progn
- (ivy--set-candidates
- (ivy--sort-maybe
- (with-current-buffer (process-buffer process)
- (counsel--split-string))))
- (when counsel--async-start
- (setq counsel--async-duration
- (time-to-seconds (time-since counsel--async-start))))
- (let ((re (ivy-re-to-str (funcall ivy--regex-function ivy-text))))
- (if ivy--old-cands
- (if (eq (ivy-alist-setting ivy-index-functions-alist)
'ivy-recompute-index-zero)
- (ivy-set-index 0)
- (ivy--recompute-index ivy-text re ivy--all-candidates))
- (unless (ivy-set-index
- (ivy--preselect-index
- (ivy-state-preselect ivy-last)
- ivy--all-candidates))
- (ivy--recompute-index ivy-text re ivy--all-candidates))))
- (setq ivy--old-cands ivy--all-candidates)
- (if ivy--all-candidates
- (ivy--exhibit)
- (ivy--insert-minibuffer "")))
- (setq counsel--async-last-error-string
- (with-current-buffer (process-buffer process) (buffer-string)))
- (setq ivy--all-candidates
- (let ((status (process-exit-status process))
- (plist (plist-get counsel--async-exit-code-plist
- (ivy-state-caller ivy-last))))
- (list (or (plist-get plist status)
- (format "error code %d" status)))))
- (setq ivy--old-cands ivy--all-candidates)
- (ivy--exhibit))))
-
-(defcustom counsel-async-filter-update-time 500000
- "The amount of microseconds to wait until updating `counsel--async-filter'."
- :type 'integer)
-
-(defun counsel--async-filter (process str)
- "Receive from PROCESS the output STR.
-Update the minibuffer with the amount of lines collected every
-`counsel-async-filter-update-time' microseconds since the last update."
- (with-current-buffer (process-buffer process)
- (insert str))
- (when (time-less-p (list 0 0 counsel-async-filter-update-time)
- (time-since counsel--async-time))
- (let (numlines)
- (with-current-buffer (process-buffer process)
- (setq numlines (count-lines (point-min) (point-max)))
- (ivy--set-candidates
- (let ((lines (counsel--split-string))
- (ignore-re (ivy-alist-setting counsel-async-ignore-re-alist)))
- (if (stringp ignore-re)
- (cl-remove-if (lambda (line)
- (string-match-p ignore-re line))
- lines)
- lines))))
- (let ((ivy--prompt (format "%d++ %s" numlines (ivy-state-prompt
ivy-last))))
- (ivy--insert-minibuffer (ivy--format ivy--all-candidates)))
- (setq counsel--async-time (current-time)))))
-
-(defun counsel-delete-process (&optional name)
- "Delete current counsel process or that with NAME."
- (let ((process (get-process (or name " *counsel*"))))
- (when process
- (delete-process process))))
-
-;;* Completion at point
-;;** `counsel-el'
-;;;###autoload
-(defun counsel-el ()
- "Elisp completion at point."
- (interactive)
- (let* ((bnd (unless (and (looking-at ")")
- (eq (char-before) ?\())
- (bounds-of-thing-at-point 'symbol)))
- (str (if bnd
- (buffer-substring-no-properties
- (car bnd)
- (cdr bnd))
- ""))
- (pred (and (eq (char-before (car bnd)) ?\()
- #'fboundp))
- symbol-names)
- (setq ivy-completion-beg (car bnd))
- (setq ivy-completion-end (cdr bnd))
- (if (string= str "")
- (mapatoms
- (lambda (x)
- (when (and (symbolp x) (funcall pred x))
- (push (symbol-name x) symbol-names))))
- (setq symbol-names (all-completions str obarray pred)))
- (ivy-read "Symbol name: " symbol-names
- :initial-input str
- :action #'ivy-completion-in-region-action
- :caller 'counsel-el)))
-
-(ivy-configure 'counsel-el
- :height 7)
-
-;;** `counsel-cl'
-(declare-function slime-symbol-start-pos "ext:slime")
-(declare-function slime-symbol-end-pos "ext:slime")
-(declare-function slime-contextual-completions "ext:slime-c-p-c")
-
-;;;###autoload
-(defun counsel-cl ()
- "Common Lisp completion at point."
- (interactive)
- (setq ivy-completion-beg (slime-symbol-start-pos))
- (setq ivy-completion-end (slime-symbol-end-pos))
- (ivy-read "Symbol name: "
- (car (slime-contextual-completions
- ivy-completion-beg
- ivy-completion-end))
- :action #'ivy-completion-in-region-action))
-
-;;** `counsel-jedi'
-(declare-function deferred:sync! "ext:deferred")
-(declare-function jedi:complete-request "ext:jedi-core")
-(declare-function jedi:ac-direct-matches "ext:jedi")
-
-;;;###autoload
-(defun counsel-jedi ()
- "Python completion at point."
- (interactive)
- (let ((bnd (bounds-of-thing-at-point 'symbol)))
- (setq ivy-completion-beg (car bnd))
- (setq ivy-completion-end (cdr bnd)))
- (deferred:sync!
- (jedi:complete-request))
- (ivy-read "Symbol name: " (jedi:ac-direct-matches)
- :action #'counsel--py-action))
-
-(defun counsel--py-action (symbol-name)
- "Insert SYMBOL-NAME, erasing the previous one."
- (when (stringp symbol-name)
- (with-ivy-window
- (when ivy-completion-beg
- (delete-region
- ivy-completion-beg
- ivy-completion-end))
- (setq ivy-completion-beg (point))
- (insert symbol-name)
- (setq ivy-completion-end (point)))))
-
-;;** `counsel-clj'
-(declare-function cider-sync-request:complete "ext:cider-client")
-(defun counsel--generic (completion-fn)
- "Complete thing at point with COMPLETION-FN."
- (let* ((bnd (or (bounds-of-thing-at-point 'symbol)
- (cons (point) (point))))
- (str (buffer-substring-no-properties
- (car bnd) (cdr bnd)))
- (candidates (funcall completion-fn str))
- (res (ivy-read (format "pattern (%s): " str)
- candidates
- :caller 'counsel--generic)))
- (when (stringp res)
- (when bnd
- (delete-region (car bnd) (cdr bnd)))
- (insert res))))
-
-(ivy-configure 'counsel--generic
- :height 7)
-
-;;;###autoload
-(defun counsel-clj ()
- "Clojure completion at point."
- (interactive)
- (counsel--generic
- (lambda (str)
- (mapcar
- #'cl-caddr
- (cider-sync-request:complete str ":same")))))
-
-;;** `counsel-company'
-(defvar company-candidates)
-(defvar company-common)
-(defvar company-prefix)
-(declare-function company-abort "ext:company")
-(declare-function company-complete "ext:company")
-(declare-function company-mode "ext:company")
-
-;;;###autoload
-(defun counsel-company ()
- "Complete using `company-candidates'."
- (interactive)
- (company-mode 1)
- (unless company-candidates
- (company-complete))
- (let ((len (cond (company-common
- (length company-common))
- (company-prefix
- (length company-prefix)))))
- (when len
- (setq ivy-completion-beg (- (point) len))
- (setq ivy-completion-end (point))
- (ivy-read "Candidate: " company-candidates
- :action #'ivy-completion-in-region-action
- :caller 'counsel-company))))
-
-(ivy-configure 'counsel-company
- :unwind-fn #'company-abort)
-
-;;** `counsel-irony'
-(declare-function irony-completion-candidates-async "ext:irony-completion")
-(declare-function irony-completion-symbol-bounds "ext:irony-completion")
-(declare-function irony-completion-annotation "ext:irony-completion")
-
-;;;###autoload
-(defun counsel-irony ()
- "Inline C/C++ completion using Irony."
- (interactive)
- (irony-completion-candidates-async 'counsel-irony-callback))
-
-(defun counsel-irony-callback (candidates)
- "Callback function for Irony to search among CANDIDATES."
- (interactive)
- (let* ((symbol-bounds (irony-completion-symbol-bounds))
- (beg (car symbol-bounds))
- (end (cdr symbol-bounds))
- (prefix (buffer-substring-no-properties beg end)))
- (setq ivy-completion-beg beg
- ivy-completion-end end)
- (ivy-read "code: " (mapcar #'counsel-irony-annotate candidates)
- :predicate (lambda (candidate)
- (string-prefix-p prefix (car candidate)))
- :caller 'counsel-irony
- :action #'ivy-completion-in-region-action)))
-
-(defun counsel-irony-annotate (x)
- "Make Ivy candidate from Irony candidate X."
- (cons (concat (car x) (irony-completion-annotation x))
- (car x)))
-
-(add-to-list 'ivy-display-functions-alist '(counsel-irony .
ivy-display-function-overlay))
-
-;;* Elisp symbols
-;;** `counsel-describe-variable'
-(defvar counsel-describe-map
- (let ((map (make-sparse-keymap)))
- (define-key map (kbd "C-.") #'counsel-find-symbol)
- (define-key map (kbd "C-,") #'counsel--info-lookup-symbol)
- map))
-
-(ivy-set-actions
- 'counsel-describe-variable
- '(("I" counsel-info-lookup-symbol "info")
- ("d" counsel--find-symbol "definition")))
-
-(defvar counsel-describe-symbol-history ()
- "History list for variable and function names.
-Used by commands `counsel-describe-variable' and
-`counsel-describe-function'.")
-
-(defun counsel-find-symbol ()
- "Jump to the definition of the current symbol."
- (interactive)
- (ivy-exit-with-action #'counsel--find-symbol))
-(put 'counsel-find-symbol 'no-counsel-M-x t)
-
-(defun counsel--info-lookup-symbol ()
- "Lookup the current symbol in the info docs."
- (interactive)
- (ivy-exit-with-action #'counsel-info-lookup-symbol))
-
-(defvar find-tag-marker-ring)
-(declare-function xref-push-marker-stack "xref")
-
-(defalias 'counsel--push-xref-marker
- (if (require 'xref nil t)
- #'xref-push-marker-stack
- (require 'etags)
- (lambda (&optional m)
- (ring-insert (with-no-warnings find-tag-marker-ring) (or m
(point-marker)))))
- "Compatibility shim for `xref-push-marker-stack'.")
-
-(defun counsel--find-symbol (x)
- "Find symbol definition that corresponds to string X."
- (with-ivy-window
- (counsel--push-xref-marker)
- (let ((full-name (get-text-property 0 'full-name x)))
- (if full-name
- (find-library full-name)
- (let ((sym (read x)))
- (cond ((and (eq (ivy-state-caller ivy-last)
- 'counsel-describe-variable)
- (boundp sym))
- (find-variable sym))
- ((fboundp sym)
- (find-function sym))
- ((boundp sym)
- (find-variable sym))
- ((or (featurep sym)
- (locate-library
- (prin1-to-string sym)))
- (find-library
- (prin1-to-string sym)))
- (t
- (error "Couldn't find definition of %s"
- sym))))))))
-
-(defun counsel--variable-p (symbol)
- "Return non-nil if SYMBOL is a bound or documented variable."
- (or (and (boundp symbol)
- (not (keywordp symbol)))
- (get symbol 'variable-documentation)))
-
-(defcustom counsel-describe-variable-function #'describe-variable
- "Function to call to describe a variable passed as parameter."
- :type 'function)
-
-(defun counsel-describe-variable-transformer (var)
- "Propertize VAR if it's a custom variable."
- (if (custom-variable-p (intern var))
- (ivy-append-face var 'ivy-highlight-face)
- var))
-
-;;;###autoload
-(defun counsel-describe-variable ()
- "Forward to `describe-variable'.
-
-Variables declared using `defcustom' are highlighted according to
-`ivy-highlight-face'."
- (interactive)
- (let ((enable-recursive-minibuffers t))
- (ivy-read "Describe variable: " obarray
- :predicate #'counsel--variable-p
- :require-match t
- :history 'counsel-describe-symbol-history
- :keymap counsel-describe-map
- :preselect (ivy-thing-at-point)
- :action (lambda (x)
- (funcall counsel-describe-variable-function (intern
x)))
- :caller 'counsel-describe-variable)))
-
-(ivy-configure 'counsel-describe-variable
- :initial-input "^"
- :display-transformer-fn #'counsel-describe-variable-transformer
- :sort-fn #'ivy-string<)
-
-;;** `counsel-describe-function'
-(ivy-set-actions
- 'counsel-describe-function
- '(("I" counsel-info-lookup-symbol "info")
- ("d" counsel--find-symbol "definition")))
-
-(defcustom counsel-describe-function-function #'describe-function
- "Function to call to describe a function passed as parameter."
- :type 'function)
-
-(defun counsel-describe-function-transformer (function-name)
- "Propertize FUNCTION-NAME if it's an interactive function."
- (if (commandp (intern function-name))
- (ivy-append-face function-name 'ivy-highlight-face)
- function-name))
-
-(defun ivy-function-called-at-point ()
- (let ((f (function-called-at-point)))
- (and f (symbol-name f))))
-
-(defcustom counsel-describe-function-preselect #'ivy-thing-at-point
- "Determine what `counsel-describe-function' should preselect."
- :type '(radio
- (function-item ivy-thing-at-point)
- (function-item ivy-function-called-at-point)))
-
-;;;###autoload
-(defun counsel-describe-function ()
- "Forward to `describe-function'.
-
-Interactive functions (i.e., commands) are highlighted according
-to `ivy-highlight-face'."
- (interactive)
- (let ((enable-recursive-minibuffers t))
- (ivy-read "Describe function: " obarray
- :predicate (lambda (sym)
- (or (fboundp sym)
- (get sym 'function-documentation)))
- :require-match t
- :history 'counsel-describe-symbol-history
- :keymap counsel-describe-map
- :preselect (funcall counsel-describe-function-preselect)
- :action (lambda (x)
- (funcall counsel-describe-function-function (intern
x)))
- :caller 'counsel-describe-function)))
-
-(ivy-configure 'counsel-describe-function
- :initial-input "^"
- :display-transformer-fn #'counsel-describe-function-transformer
- :sort-fn #'ivy-string<)
-
-;;** `counsel-set-variable'
-(defvar counsel-set-variable-history nil
- "Store history for `counsel-set-variable'.")
-
-(defun counsel-read-setq-expression (sym)
- "Read and eval a setq expression for SYM."
- (setq this-command 'eval-expression)
- (let* ((minibuffer-completing-symbol t)
- (sym-value (symbol-value sym))
- (expr (minibuffer-with-setup-hook
- (lambda ()
- (add-function :before-until (local
'eldoc-documentation-function)
- #'elisp-eldoc-documentation-function)
- (add-hook 'completion-at-point-functions
#'elisp-completion-at-point nil t)
- (run-hooks 'eval-expression-minibuffer-setup-hook)
- (goto-char (minibuffer-prompt-end))
- (forward-char 6)
- (insert (format "%S " sym)))
- (read-from-minibuffer "Eval: "
- (format
- (if (and sym-value (consp sym-value))
- "(setq '%S)"
- "(setq %S)")
- sym-value)
- read-expression-map t
- 'read-expression-history))))
- (eval-expression expr)))
-
-(defun counsel--setq-doconst (x)
- "Return a cons of description and value for X.
-X is an item of a radio- or choice-type defcustom."
- (when (listp x)
- (let ((v (car-safe (last x)))
- (tag (and (eq (car x) 'const)
- (plist-get (cdr x) :tag))))
- (when (and (or v tag) (not (eq v 'function)))
- (cons
- (concat
- (when tag
- (concat tag ": "))
- (if (stringp v) v (prin1-to-string v)))
- (if (symbolp v)
- (list 'quote v)
- v))))))
-
-(declare-function lv-message "ext:lv")
-(declare-function lv-delete-window "ext:lv")
-(declare-function custom-variable-documentation "cus-edit")
-
-(defface counsel-variable-documentation
- '((t :inherit font-lock-comment-face))
- "Face for displaying Lisp documentation."
- :group 'ivy-faces)
-
-;;;###autoload
-(defun counsel-set-variable (sym)
- "Set a variable SYM, with completion.
-
-When the selected variable is a `defcustom' with the type boolean
-or radio, offer completion of all possible values.
-
-Otherwise, offer a variant of `eval-expression', with the initial
-input corresponding to the chosen variable.
-
-With a prefix arg, restrict list to variables defined using
-`defcustom'."
- (interactive (list (intern
- (ivy-read "Set variable: " obarray
- :predicate (if current-prefix-arg
- #'custom-variable-p
- #'counsel--variable-p)
- :history 'counsel-set-variable-history
- :preselect (ivy-thing-at-point)))))
- (let ((doc (and (require 'cus-edit)
- (require 'lv nil t)
- (not (string= "nil" (custom-variable-documentation sym)))
- (propertize (custom-variable-documentation sym)
- 'face 'counsel-variable-documentation)))
- sym-type
- cands)
- (unwind-protect
- (progn
- (when doc
- (lv-message (ivy--quote-format-string doc)))
- (if (and (boundp sym)
- (setq sym-type (get sym 'custom-type))
- (cond
- ((and (consp sym-type)
- (memq (car sym-type) '(choice radio)))
- (setq cands (delq nil (mapcar #'counsel--setq-doconst
- (cdr sym-type)))))
- ((eq sym-type 'boolean)
- (setq cands '(("nil" . nil) ("t" . t))))
- (t nil)))
- (let* ((sym-val (symbol-value sym))
- (res (ivy-read (format "Set (%S <%s>): " sym sym-val)
- cands
- :preselect (prin1-to-string sym-val))))
- (when res
- (setq res
- (if (assoc res cands)
- (cdr (assoc res cands))
- (read res)))
- (set sym (if (and (listp res) (eq (car res) 'quote))
- (cadr res)
- res))))
- (unless (boundp sym)
- (set sym nil))
- (counsel-read-setq-expression sym)))
- (when doc
- (lv-delete-window)))))
-
-;;** `counsel-apropos'
-;;;###autoload
-(defun counsel-apropos ()
- "Show all matching symbols.
-See `apropos' for further information on what is considered
-a symbol and how to search for them."
- (interactive)
- (ivy-read "Search for symbol (word list or regexp): " obarray
- :predicate (lambda (sym)
- (or (fboundp sym)
- (boundp sym)
- (facep sym)
- (symbol-plist sym)))
- :history 'counsel-apropos-history
- :preselect (ivy-thing-at-point)
- :action (lambda (pattern)
- (when (string= pattern "")
- (user-error "Please specify a pattern"))
- ;; If the user selected a candidate form the list, we use
- ;; a pattern which matches only the selected symbol.
- (if (memq this-command '(ivy-immediate-done
ivy-alt-done))
- ;; Regexp pattern are passed verbatim, other input is
- ;; split into words.
- (if (string= (regexp-quote pattern) pattern)
- (apropos (split-string pattern "[ \t]+" t))
- (apropos pattern))
- (apropos (concat "\\`" pattern "\\'"))))
- :caller 'counsel-apropos))
-
-(ivy-configure 'counsel-apropos
- :sort-fn #'ivy-string<)
-
-;;** `counsel-info-lookup-symbol'
-(defvar info-lookup-mode)
-(declare-function info-lookup-guess-default "info-look")
-(declare-function info-lookup->completions "info-look")
-(declare-function info-lookup->mode-value "info-look")
-(declare-function info-lookup-select-mode "info-look")
-(declare-function info-lookup-change-mode "info-look")
-(declare-function info-lookup "info-look")
-
-;;;###autoload
-(defun counsel-info-lookup-symbol (symbol &optional mode)
- "Forward SYMBOL to `info-lookup-symbol' with ivy completion.
-With prefix arg MODE a query for the symbol help mode is offered."
- (interactive
- (progn
- (require 'info-look)
- ;; Courtesy of `info-lookup-interactive-arguments'
- (let* ((topic 'symbol)
- (mode (cond (current-prefix-arg
- (info-lookup-change-mode topic))
- ((info-lookup->mode-value
- topic (info-lookup-select-mode))
- info-lookup-mode)
- ((info-lookup-change-mode topic))))
- (enable-recursive-minibuffers t))
- (list (ivy-read "Describe symbol: " (info-lookup->completions topic
mode)
- :history 'info-lookup-history
- :preselect (info-lookup-guess-default topic mode)
- :caller 'counsel-info-lookup-symbol)
- mode))))
- (info-lookup-symbol symbol mode))
-
-(ivy-configure 'counsel-info-lookup-symbol
- :sort-fn #'ivy-string<)
-
-;;** `counsel-M-x'
-(defface counsel-key-binding
- '((t :inherit font-lock-keyword-face))
- "Face used by `counsel-M-x' for key bindings."
- :group 'ivy-faces)
-
-(defface counsel-active-mode
- '((t :inherit font-lock-builtin-face))
- "Face used by `counsel-M-x' for activated modes."
- :group 'ivy-faces)
-
-(defcustom counsel-alias-expand t
- "When non-nil, show the expansion of aliases in `counsel-M-x'."
- :type 'boolean
- :group 'ivy)
-
-(defun counsel-M-x-transformer (cmd)
- "Return CMD annotated with its active key binding, if any."
- (let* ((sym (intern cmd))
- (alias (symbol-function sym))
- (key (where-is-internal sym nil t)))
- (when (or (eq sym major-mode)
- (and
- (memq sym minor-mode-list)
- (boundp sym)
- (buffer-local-value sym (ivy-state-buffer ivy-last))))
- (setq cmd (propertize cmd 'face 'counsel-active-mode)))
- (concat cmd
- (when (and (symbolp alias) counsel-alias-expand)
- (format " (%s)" alias))
- (when key
- ;; Prefer `<f2>' over `C-x 6' where applicable
- (let ((i (cl-search [?\C-x ?6] key)))
- (when i
- (let ((dup (vconcat (substring key 0 i) [f2] (substring key
(+ i 2))))
- (map (current-global-map)))
- (when (equal (lookup-key map key)
- (lookup-key map dup))
- (setq key dup)))))
- (setq key (key-description key))
- (put-text-property 0 (length key) 'face 'counsel-key-binding key)
- (format " (%s)" key)))))
-
-(defvar amx-initialized)
-(defvar amx-cache)
-(declare-function amx-initialize "ext:amx")
-(declare-function amx-detect-new-commands "ext:amx")
-(declare-function amx-update "ext:amx")
-(declare-function amx-rank "ext:amx")
-(defvar smex-initialized-p)
-(defvar smex-ido-cache)
-(declare-function smex-initialize "ext:smex")
-(declare-function smex-detect-new-commands "ext:smex")
-(declare-function smex-update "ext:smex")
-(declare-function smex-rank "ext:smex")
-
-(defun counsel--M-x-externs ()
- "Return `counsel-M-x' candidates from external packages.
-The return value is a list of strings. The currently supported
-packages are, in order of precedence, `amx' and `smex'."
- (cond ((require 'amx nil t)
- (unless amx-initialized
- (amx-initialize))
- (when (amx-detect-new-commands)
- (amx-update))
- (mapcar (lambda (entry)
- (symbol-name (car entry)))
- amx-cache))
- ((require 'smex nil t)
- (unless smex-initialized-p
- (smex-initialize))
- (when (smex-detect-new-commands)
- (smex-update))
- smex-ido-cache)))
-
-(defun counsel--M-x-prompt ()
- "String for `M-x' plus the string representation of `current-prefix-arg'."
- (concat (cond ((null current-prefix-arg)
- nil)
- ((eq current-prefix-arg '-)
- "- ")
- ((integerp current-prefix-arg)
- (format "%d " current-prefix-arg))
- ((= (car current-prefix-arg) 4)
- "C-u ")
- (t
- (format "%d " (car current-prefix-arg))))
- "M-x "))
-
-(defvar counsel-M-x-history nil
- "History for `counsel-M-x'.")
-
-(defun counsel-M-x-action (cmd)
- "Execute CMD."
- (setq cmd (intern cmd))
- (cond ((bound-and-true-p amx-initialized)
- (amx-rank cmd))
- ((bound-and-true-p smex-initialized-p)
- (smex-rank cmd)))
- (setq prefix-arg current-prefix-arg)
- (setq this-command cmd)
- (setq real-this-command cmd)
- (command-execute cmd 'record))
-
-;;;###autoload
-(defun counsel-M-x (&optional initial-input)
- "Ivy version of `execute-extended-command'.
-Optional INITIAL-INPUT is the initial input in the minibuffer.
-This function integrates with either the `amx' or `smex' package
-when available, in that order of precedence."
- (interactive)
- ;; When `counsel-M-x' returns, `last-command' would be set to
- ;; `counsel-M-x' because :action hasn't been invoked yet.
- ;; Instead, preserve the old value of `this-command'.
- (setq this-command last-command)
- (setq real-this-command real-last-command)
- (let ((externs (counsel--M-x-externs)))
- (ivy-read (counsel--M-x-prompt) (or externs obarray)
- :predicate (if externs
- (lambda (x)
- (not (get (intern x) 'no-counsel-M-x)))
- (lambda (sym)
- (and (commandp sym)
- (not (get sym 'byte-obsolete-info))
- (not (get sym 'no-counsel-M-x)))))
- :require-match t
- :history 'counsel-M-x-history
- :action #'counsel-M-x-action
- :keymap counsel-describe-map
- :initial-input initial-input
- :caller 'counsel-M-x)))
-
-(ivy-configure 'counsel-M-x
- :initial-input "^"
- :display-transformer-fn #'counsel-M-x-transformer)
-
-(ivy-set-actions
- 'counsel-M-x
- `(("d" counsel--find-symbol "definition")
- ("h" ,(lambda (x) (funcall counsel-describe-function-function (intern x)))
"help")))
-
-;;** `counsel-command-history'
-(defun counsel-command-history-action-eval (cmd)
- "Eval the command CMD."
- (eval (read cmd)))
-
-(defun counsel-command-history-action-edit-and-eval (cmd)
- "Edit and eval the command CMD."
- (edit-and-eval-command "Eval: " (read cmd)))
-
-(ivy-set-actions
- 'counsel-command-history
- '(("r" counsel-command-history-action-eval "eval command")
- ("e" counsel-command-history-action-edit-and-eval "edit and eval
command")))
-
-;;;###autoload
-(defun counsel-command-history ()
- "Show the history of commands."
- (interactive)
- (ivy-read "Command: " (mapcar #'prin1-to-string command-history)
- :require-match t
- :action #'counsel-command-history-action-eval
- :caller 'counsel-command-history))
-
-;;** `counsel-load-library'
-(defun counsel-library-candidates ()
- "Return a list of completion candidates for `counsel-load-library'."
- (let ((suffix (concat (regexp-opt '(".el" ".el.gz") t) "\\'"))
- (cands (make-hash-table :test #'equal))
- short-name
- old-val
- dir-parent
- res)
- (dolist (dir load-path)
- (setq dir (or dir default-directory)) ;; interpret nil in load-path as
default-directory
- (when (file-directory-p dir)
- (dolist (file (file-name-all-completions "" dir))
- (when (string-match suffix file)
- (unless (string-match "pkg.elc?$" file)
- (setq short-name (substring file 0 (match-beginning 0)))
- (if (setq old-val (gethash short-name cands))
- (progn
- ;; assume going up directory once will resolve name clash
- (setq dir-parent (counsel-directory-name (cdr old-val)))
- (puthash short-name
- (cons
- (counsel-string-compose dir-parent (car old-val))
- (cdr old-val))
- cands)
- (setq dir-parent (counsel-directory-name dir))
- (puthash (concat dir-parent short-name)
- (cons
- (propertize
- (counsel-string-compose
- dir-parent short-name)
- 'full-name (expand-file-name file dir))
- dir)
- cands))
- (puthash short-name
- (cons (propertize
- short-name
- 'full-name (expand-file-name file dir))
- dir)
- cands)))))))
- (maphash (lambda (_k v) (push (car v) res)) cands)
- (nreverse res)))
-
-;;;###autoload
-(defun counsel-load-library ()
- "Load a selected the Emacs Lisp library.
-The libraries are offered from `load-path'."
- (interactive)
- (let ((cands (counsel-library-candidates)))
- (ivy-read "Load library: " cands
- :action (lambda (x)
- (load-library
- (get-text-property 0 'full-name x)))
- :keymap counsel-describe-map)))
-
-(ivy-set-actions
- 'counsel-load-library
- '(("d" counsel--find-symbol "definition")))
-
-;;** `counsel-find-library'
-(declare-function find-library-name "find-func")
-(defun counsel-find-library-other-window (library)
- (let ((buf (find-file-noselect (find-library-name library))))
- (pop-to-buffer buf 'other-window)))
-
-(defun counsel-find-library-other-frame (library)
- (let ((buf (find-file-noselect (find-library-name library))))
- (condition-case nil
- (switch-to-buffer-other-frame buf)
- (error (pop-to-buffer buf)))))
-
-(ivy-set-actions
- 'counsel-find-library
- '(("j" counsel-find-library-other-window "other window")
- ("f" counsel-find-library-other-frame "other frame")))
-
-;;;###autoload
-(defun counsel-find-library ()
- "Visit a selected the Emacs Lisp library.
-The libraries are offered from `load-path'."
- (interactive)
- (let ((cands (counsel-library-candidates)))
- (ivy-read "Find library: " cands
- :action #'counsel--find-symbol
- :keymap counsel-describe-map
- :caller 'counsel-find-library)))
-
-;;** `counsel-load-theme'
-(declare-function powerline-reset "ext:powerline")
-
-(defun counsel-load-theme-action (x)
- "Disable current themes and load theme X."
- (condition-case nil
- (progn
- (mapc #'disable-theme custom-enabled-themes)
- (load-theme (intern x) t)
- (when (fboundp 'powerline-reset)
- (powerline-reset)))
- (error "Problem loading theme %s" x)))
-
-;;;###autoload
-(defun counsel-load-theme ()
- "Forward to `load-theme'.
-Usable with `ivy-resume', `ivy-next-line-and-call' and
-`ivy-previous-line-and-call'."
- (interactive)
- (ivy-read "Load custom theme: "
- (mapcar 'symbol-name
- (custom-available-themes))
- :action #'counsel-load-theme-action
- :caller 'counsel-load-theme))
-
-;;** `counsel-descbinds'
-(ivy-set-actions
- 'counsel-descbinds
- '(("d" counsel-descbinds-action-find "definition")
- ("I" counsel-descbinds-action-info "info")
- ("x" counsel-descbinds-action-exec "execute")))
-
-(defvar counsel-descbinds-history nil
- "History for `counsel-descbinds'.")
-
-(defun counsel--descbinds-cands (&optional prefix buffer)
- "Get key bindings starting with PREFIX in BUFFER.
-See `describe-buffer-bindings' for further information."
- (let ((buffer (or buffer (current-buffer)))
- (re-exclude (regexp-opt
- '("<vertical-line>" "<bottom-divider>" "<right-divider>"
- "<mode-line>" "<C-down-mouse-2>" "<left-fringe>"
- "<right-fringe>" "<header-line>"
- "<vertical-scroll-bar>" "<horizontal-scroll-bar>")))
- res)
- (with-temp-buffer
- (let ((indent-tabs-mode t))
- (describe-buffer-bindings buffer prefix))
- (goto-char (point-min))
- ;; Skip the "Key translations" section
- (re-search-forward "")
- (forward-char 1)
- (while (not (eobp))
- (when (looking-at "^\\([^\t\n]+\\)[\t ]*\\(.*\\)$")
- (let ((key (match-string 1))
- (fun (match-string 2))
- cmd)
- (unless (or (member fun '("??" "self-insert-command"))
- (string-match re-exclude key)
- (not (or (commandp (setq cmd (intern-soft fun)))
- (member fun '("Prefix Command")))))
- (push
- (cons (format
- "%-15s %s"
- (propertize key 'face 'counsel-key-binding)
- fun)
- (cons key cmd))
- res))))
- (forward-line 1)))
- (nreverse res)))
-
-(defcustom counsel-descbinds-function #'describe-function
- "Function to call to describe a function passed as parameter."
- :type 'function)
-
-(defun counsel-descbinds-action-describe (x)
- "Describe function of candidate X.
-See `describe-function' for further information."
- (let ((cmd (cddr x)))
- (funcall counsel-descbinds-function cmd)))
-
-(defun counsel-descbinds-action-exec (x)
- "Run candidate X.
-See `execute-extended-command' for further information."
- (let ((cmd (cddr x)))
- (command-execute cmd 'record)))
-
-(defun counsel-descbinds-action-find (x)
- "Find symbol definition of candidate X.
-See `counsel--find-symbol' for further information."
- (let ((cmd (cddr x)))
- (counsel--find-symbol (symbol-name cmd))))
-
-(defun counsel-descbinds-action-info (x)
- "Display symbol definition of candidate X, as found in the relevant manual.
-See `info-lookup-symbol' for further information."
- (let ((cmd (cddr x)))
- (counsel-info-lookup-symbol (symbol-name cmd))))
-
-;;;###autoload
-(defun counsel-descbinds (&optional prefix buffer)
- "Show a list of all defined keys and their definitions.
-If non-nil, show only bindings that start with PREFIX.
-BUFFER defaults to the current one."
- (interactive)
- (ivy-read "Bindings: " (counsel--descbinds-cands prefix buffer)
- :action #'counsel-descbinds-action-describe
- :history 'counsel-descbinds-history
- :caller 'counsel-descbinds))
-
-;;** `counsel-describe-face'
-(defcustom counsel-describe-face-function #'describe-face
- "Function to call to describe a face or face name argument."
- :type 'function)
-
-(defun counsel--face-at-point ()
- "Return name of face around point.
-Try detecting a face name in the text around point before falling
-back to the face of the character after point, and finally the
-`default' face."
- (symbol-name (or (face-at-point t) 'default)))
-
-;;;###autoload
-(defun counsel-describe-face ()
- "Completion for `describe-face'."
- (interactive)
- (ivy-read "Face: " (face-list)
- :require-match t
- :history 'face-name-history
- :preselect (counsel--face-at-point)
- :action counsel-describe-face-function
- :caller 'counsel-describe-face))
-
-(ivy-configure 'counsel-describe-face
- :sort-fn #'ivy-string<)
-
-(defun counsel-customize-face (name)
- "Customize face with NAME."
- (customize-face (intern name)))
-
-(defun counsel-customize-face-other-window (name)
- "Customize face with NAME in another window."
- (customize-face-other-window (intern name)))
-
-(ivy-set-actions
- 'counsel-describe-face
- '(("c" counsel-customize-face "customize")
- ("C" counsel-customize-face-other-window "customize other window")))
-
-;;** `counsel-faces'
-(defvar counsel--faces-format "%-40s %s")
-
-(defun counsel--faces-format-function (names)
- "Format NAMES according to `counsel--faces-format'."
- (let ((formatter
- (lambda (name)
- (format counsel--faces-format name
- (propertize list-faces-sample-text
- 'face (intern name))))))
- (ivy--format-function-generic
- (lambda (name)
- (funcall formatter (ivy--add-face name 'ivy-current-match)))
- formatter names "\n")))
-
-;;;###autoload
-(defun counsel-faces ()
- "Complete faces with preview.
-Actions are provided by default for describing or customizing the
-selected face."
- (interactive)
- (let* ((names (mapcar #'symbol-name (face-list)))
- (counsel--faces-format
- (format "%%-%ds %%s"
- (apply #'max 0 (mapcar #'string-width names)))))
- (ivy-read "Face: " names
- :require-match t
- :history 'face-name-history
- :preselect (counsel--face-at-point)
- :action counsel-describe-face-function
- :caller 'counsel-faces)))
-
-(ivy-configure 'counsel-faces
- :sort-fn #'ivy-string<
- :format-fn #'counsel--faces-format-function)
-
-(ivy-set-actions
- 'counsel-faces
- '(("c" counsel-customize-face "customize")
- ("C" counsel-customize-face-other-window "customize other window")))
-
-;;* Git
-;;** `counsel-git'
-(defvar counsel-git-cmd "git ls-files --full-name --"
- "Command for `counsel-git'.")
-
-(ivy-set-actions
- 'counsel-git
- '(("j" find-file-other-window "other window")
- ("x" counsel-find-file-extern "open externally")))
-
-(defun counsel--dominating-file (file &optional dir)
- "Look up directory hierarchy for FILE, starting in DIR.
-Like `locate-dominating-file', but DIR defaults to
-`default-directory' and the return value is expanded."
- (and (setq dir (locate-dominating-file (or dir default-directory) file))
- (expand-file-name dir)))
-
-(defun counsel-locate-git-root ()
- "Return the root of the Git repository containing the current buffer."
- (or (counsel--git-root)
- (error "Not in a Git repository")))
-
-(defun counsel-git-cands ()
- (let ((default-directory (counsel-locate-git-root)))
- (split-string
- (shell-command-to-string counsel-git-cmd)
- "\n"
- t)))
-
-;;;###autoload
-(defun counsel-git (&optional initial-input)
- "Find file in the current Git repository.
-INITIAL-INPUT can be given as the initial minibuffer input."
- (interactive)
- (counsel-require-program counsel-git-cmd)
- (let ((default-directory (counsel-locate-git-root)))
- (ivy-read "Find file: " (counsel-git-cands)
- :initial-input initial-input
- :action #'counsel-git-action
- :caller 'counsel-git)))
-
-(ivy-configure 'counsel-git
- :occur #'counsel-git-occur)
-
-(defun counsel-git-action (x)
- "Find file X in current Git repository."
- (with-ivy-window
- (let ((default-directory (ivy-state-directory ivy-last)))
- (find-file x))))
-
-(defun counsel-git-occur (&optional _cands)
- "Occur function for `counsel-git' using `counsel-cmd-to-dired'."
- (cd (ivy-state-directory ivy-last))
- (counsel-cmd-to-dired
- (counsel--expand-ls
- (format "%s | %s | xargs ls"
- counsel-git-cmd
- (counsel--file-name-filter)))))
-
-(defvar counsel-dired-listing-switches "-alh"
- "Switches passed to `ls' for `counsel-cmd-to-dired'.")
-
-(defun counsel-cmd-to-dired (full-cmd &optional filter)
- "Adapted from `find-dired'."
- (let ((inhibit-read-only t))
- (erase-buffer)
- (dired-mode default-directory counsel-dired-listing-switches)
- (insert " " default-directory ":\n")
- (let ((point (point)))
- (insert " " full-cmd "\n")
- (dired-insert-set-properties point (point)))
- (setq-local dired-sort-inhibit t)
- (setq-local revert-buffer-function
- (lambda (_1 _2) (counsel-cmd-to-dired full-cmd)))
- (setq-local dired-subdir-alist
- (list (cons default-directory (point-min-marker))))
- (let ((proc (start-process-shell-command
- "counsel-cmd" (current-buffer) full-cmd)))
- (set-process-filter proc filter)
- (set-process-sentinel
- proc
- (lambda (process _msg)
- (when (and (eq (process-status process) 'exit)
- (zerop (process-exit-status process)))
- (goto-char (point-min))
- (forward-line 2)
- (dired-move-to-filename)))))))
-
-;;** `counsel-git-grep'
-(defvar counsel-git-grep-map
- (let ((map (make-sparse-keymap)))
- (define-key map (kbd "C-l") 'ivy-call-and-recenter)
- (define-key map (kbd "M-q") 'counsel-git-grep-query-replace)
- (define-key map (kbd "C-c C-m") 'counsel-git-grep-switch-cmd)
- (define-key map (kbd "C-x C-d") 'counsel-cd)
- map))
-
-(defvar counsel-git-grep-cmd-default "git --no-pager grep --full-name -n
--no-color -i -I -e \"%s\""
- "Initial command for `counsel-git-grep'.")
-
-(defvar counsel-git-grep-cmd nil
- "Store the command for `counsel-git-grep'.")
-
-(defvar counsel-git-grep-history nil
- "History for `counsel-git-grep'.")
-
-(defvar counsel-git-grep-cmd-history
- (list counsel-git-grep-cmd-default)
- "History for `counsel-git-grep' shell commands.")
-
-(defcustom counsel-grep-post-action-hook nil
- "Hook that runs after the point moves to the next candidate.
-Typical value: '(recenter)."
- :type 'hook)
-
-(defcustom counsel-git-grep-cmd-function
#'counsel-git-grep-cmd-function-default
- "How a git-grep shell call is built from the input."
- :type '(radio
- (function-item counsel-git-grep-cmd-function-default)
- (function-item counsel-git-grep-cmd-function-ignore-order)
- (function :tag "Other")))
-
-(defun counsel-git-grep-cmd-function-default (str)
- (format counsel-git-grep-cmd
- (setq ivy--old-re
- (if (eq ivy--regex-function #'ivy--regex-fuzzy)
- (replace-regexp-in-string
- "\n" "" (ivy--regex-fuzzy str))
- (ivy--regex str t)))))
-
-(defun counsel-git-grep-cmd-function-ignore-order (str)
- (setq ivy--old-re (ivy--regex str t))
- (let ((parts (split-string str " " t)))
- (concat
- "git --no-pager grep --full-name -n --no-color -i -e "
- (mapconcat #'shell-quote-argument parts " --and -e "))))
-
-(defun counsel-git-grep-function (string)
- "Grep in the current Git repository for STRING."
- (or
- (ivy-more-chars)
- (progn
- (counsel--async-command
- (funcall counsel-git-grep-cmd-function string))
- nil)))
-
-(defun counsel-git-grep-action (x)
- "Go to occurrence X in current Git repository."
- (when (string-match "\\`\\(.*?\\):\\([0-9]+\\):\\(.*\\)\\'" x)
- (let ((file-name (match-string-no-properties 1 x))
- (line-number (match-string-no-properties 2 x)))
- (find-file (expand-file-name
- file-name
- (ivy-state-directory ivy-last)))
- (goto-char (point-min))
- (forward-line (1- (string-to-number line-number)))
- (when (re-search-forward (ivy--regex ivy-text t) (line-end-position) t)
- (when swiper-goto-start-of-match
- (goto-char (match-beginning 0))))
- (swiper--ensure-visible)
- (run-hooks 'counsel-grep-post-action-hook)
- (unless (eq ivy-exit 'done)
- (swiper--cleanup)
- (swiper--add-overlays (ivy--regex ivy-text))))))
-
-(defun counsel-git-grep-transformer (str)
- "Higlight file and line number in STR."
- (when (string-match "\\`\\([^:]+\\):\\([^:]+\\):" str)
- (ivy-add-face-text-property (match-beginning 1) (match-end 1)
- 'ivy-grep-info
- str)
- (ivy-add-face-text-property (match-beginning 2) (match-end 2)
- 'ivy-grep-line-number
- str))
- str)
-
-(defvar counsel-git-grep-projects-alist nil
- "An alist of project directory to \"git-grep\" command.
-Allows to automatically use a custom \"git-grep\" command for all
-files in a project.")
-
-(defun counsel--git-grep-cmd-and-proj (cmd)
- (let ((dd (expand-file-name default-directory))
- proj)
- (cond
- ((stringp cmd))
- (current-prefix-arg
- (if (setq proj
- (cl-find-if
- (lambda (x)
- (string-match (car x) dd))
- counsel-git-grep-projects-alist))
- (setq cmd (cdr proj))
- (setq cmd
- (ivy-read "cmd: " counsel-git-grep-cmd-history
- :history 'counsel-git-grep-cmd-history
- :re-builder #'ivy--regex))
- (setq counsel-git-grep-cmd-history
- (delete-dups counsel-git-grep-cmd-history))))
- (t
- (setq cmd counsel-git-grep-cmd-default)))
- (cons proj cmd)))
-
-(defun counsel--call (command &optional result-fn)
- "Synchronously call COMMAND and return its output as a string.
-COMMAND comprises the program name followed by its arguments, as
-in `make-process'. Signal `file-error' and emit a warning if
-COMMAND fails. Obey file handlers based on `default-directory'.
-On success, RESULT-FN is called in output buffer with no arguments."
- (let ((stderr (make-temp-file "counsel-call-stderr-"))
- status)
- (unwind-protect
- (with-temp-buffer
- (setq status (apply #'process-file (car command) nil
- (list t stderr) nil (cdr command)))
- (if (eq status 0)
- (if result-fn
- (funcall result-fn)
- ;; Return all output except trailing newline.
- (buffer-substring (point-min)
- (- (point)
- (if (eq (bobp) (bolp))
- 0
- 1))))
- ;; Convert process status into error list.
- (setq status (list 'file-error
- (mapconcat #'identity `(,@command "failed") "
")
- status))
- ;; Print stderr contents, if any, to *Warnings* buffer.
- (let ((msg (condition-case err
- (unless (zerop (cadr (insert-file-contents
- stderr nil nil nil t)))
- (buffer-string))
- (error (error-message-string err)))))
- (lwarn 'ivy :warning "%s" (apply #'concat
- (error-message-string status)
- (and msg (list "\n" msg)))))
- ;; Signal `file-error' with process status.
- (signal (car status) (cdr status))))
- (delete-file stderr))))
-
-(defun counsel--command (&rest command)
- "Forward COMMAND to `counsel--call'."
- (counsel--call command))
-
-(defun counsel--grep-unwind ()
- (counsel-delete-process)
- (swiper--cleanup))
-
-;;;###autoload
-(defun counsel-git-grep (&optional initial-input initial-directory cmd)
- "Grep for a string in the current Git repository.
-INITIAL-INPUT can be given as the initial minibuffer input.
-INITIAL-DIRECTORY, if non-nil, is used as the root directory for search.
-When CMD is a string, use it as a \"git grep\" command.
-When CMD is non-nil, prompt for a specific \"git grep\" command."
- (interactive)
- (let ((proj-and-cmd (counsel--git-grep-cmd-and-proj cmd))
- proj)
- (setq proj (car proj-and-cmd))
- (setq counsel-git-grep-cmd (cdr proj-and-cmd))
- (counsel-require-program counsel-git-grep-cmd)
- (let ((collection-function
- (if proj
- #'counsel-git-grep-proj-function
- #'counsel-git-grep-function))
- (default-directory (or initial-directory
- (if proj
- (car proj)
- (counsel-locate-git-root)))))
- (ivy-read "git grep: " collection-function
- :initial-input initial-input
- :dynamic-collection t
- :keymap counsel-git-grep-map
- :action #'counsel-git-grep-action
- :history 'counsel-git-grep-history
- :caller 'counsel-git-grep))))
-
-(ivy-configure 'counsel-git-grep
- :occur #'counsel-git-grep-occur
- :unwind-fn #'counsel--grep-unwind
- :index-fn #'ivy-recompute-index-swiper-async
- :display-transformer-fn #'counsel-git-grep-transformer
- :grep-p t
- :exit-codes '(1 "No matches found"))
-
-(defun counsel-git-grep-proj-function (str)
- "Grep for STR in the current Git repository."
- (or
- (ivy-more-chars)
- (let ((regex (setq ivy--old-re
- (ivy--regex str t))))
- (counsel--async-command (format counsel-git-grep-cmd regex))
- nil)))
-
-(defun counsel-git-grep-switch-cmd ()
- "Set `counsel-git-grep-cmd' to a different value."
- (interactive)
- (setq counsel-git-grep-cmd
- (ivy-read "cmd: " counsel-git-grep-cmd-history
- :history 'counsel-git-grep-cmd-history))
- (setq counsel-git-grep-cmd-history
- (delete-dups counsel-git-grep-cmd-history))
- (unless (ivy-state-dynamic-collection ivy-last)
- (setq ivy--all-candidates
- (all-completions "" 'counsel-git-grep-function))))
-
-(defun counsel--normalize-grep-match (str)
- ;; Prepend ./ if necessary:
- (unless (ivy--starts-with-dotslash str)
- (setq str (concat "./" str)))
- ;; Remove column info if any:
- (save-match-data
- (when (string-match
- "[^\n:]+?[^\n/:]:[\t ]*[1-9][0-9]*[\t ]*:\\([1-9][0-9]*:\\)"
- str)
- (setq str (replace-match "" t t str 1))))
- str)
-
-(defun counsel--git-grep-occur-cmd (input)
- (let* ((regex (funcall ivy--regex-function input))
- (regex (if (eq ivy--regex-function #'ivy--regex-fuzzy)
- (replace-regexp-in-string "\n" "" regex)
- regex))
- (positive-pattern (replace-regexp-in-string
- ;; git-grep can't handle .*?
- "\\.\\*\\?" ".*"
- (ivy-re-to-str regex)))
- (negative-patterns
- (if (stringp regex) ""
- (mapconcat (lambda (x)
- (and (null (cdr x))
- (format "| grep -v %s" (car x))))
- regex
- " "))))
- (concat (format counsel-git-grep-cmd positive-pattern) negative-patterns)))
-
-(defun counsel-git-grep-occur (&optional _cands)
- "Generate a custom occur buffer for `counsel-git-grep'."
- (counsel-grep-like-occur #'counsel--git-grep-occur-cmd))
-
-(defun counsel-git-grep-query-replace ()
- "Start `query-replace' with string to replace from last search string."
- (interactive)
- (unless (window-minibuffer-p)
- (user-error
- "Should only be called in the minibuffer through `counsel-git-grep-map'"))
- (let* ((enable-recursive-minibuffers t)
- (from (ivy--regex ivy-text))
- (to (query-replace-read-to from "Query replace" t)))
- (ivy-exit-with-action
- (lambda (_)
- (let (done-buffers)
- (dolist (cand ivy--old-cands)
- (when (string-match "\\`\\(.*?\\):\\([0-9]+\\):\\(.*\\)\\'" cand)
- (with-ivy-window
- (let ((file-name (match-string-no-properties 1 cand)))
- (setq file-name (expand-file-name
- file-name
- (ivy-state-directory ivy-last)))
- (unless (member file-name done-buffers)
- (push file-name done-buffers)
- (find-file file-name)
- (goto-char (point-min)))
- (perform-replace from to t t nil))))))))))
-
-;;** `counsel-git-stash'
-(defun counsel-git-stash-kill-action (x)
- "Add git stash command to kill ring.
-The git command applies the stash entry where candidate X was found in."
- (when (string-match "\\([^:]+\\):" x)
- (kill-new (message (format "git stash apply %s" (match-string 1 x))))))
-
-;;;###autoload
-(defun counsel-git-stash ()
- "Search through all available git stashes."
- (interactive)
- (let* ((default-directory (counsel-locate-git-root))
- (cands (split-string (shell-command-to-string
- "IFS=$'\n'
-for i in `git stash list --format=\"%gd\"`; do
- git stash show -p $i | grep -H --label=\"$i\" \"$1\"
-done") "\n" t)))
- (ivy-read "git stash: " cands
- :action #'counsel-git-stash-kill-action
- :caller 'counsel-git-stash)))
-
-;;** `counsel-git-log'
-(defvar counsel-git-log-cmd "GIT_PAGER=cat git log --grep '%s'"
- "Command used for \"git log\".")
-
-(defun counsel-git-log-function (str)
- "Search for STR in git log."
- (or
- (ivy-more-chars)
- (progn
- ;; `counsel--yank-pop-format-function' uses this
- (setq ivy--old-re (funcall ivy--regex-function str))
- (counsel--async-command
- ;; "git log --grep" likes to have groups quoted e.g. \(foo\).
- ;; But it doesn't like the non-greedy ".*?".
- (format counsel-git-log-cmd
- (replace-regexp-in-string "\\.\\*\\?" ".*"
- (ivy-re-to-str ivy--old-re))))
- nil)))
-
-(defun counsel-git-log-action (x)
- "Add candidate X to kill ring."
- (message "%S" (kill-new x)))
-
-(declare-function magit-show-commit "ext:magit-diff")
-
-(defun counsel-git-log-show-commit-action (log-entry)
- "Visit the commit corresponding to LOG-ENTRY."
- (require 'magit-diff)
- (let ((commit (substring-no-properties log-entry 0 (string-match-p "\\W"
log-entry))))
- (magit-show-commit commit)))
-
-(ivy-set-actions
- 'counsel-git-log
- '(("v" counsel-git-log-show-commit-action "visit commit")))
-
-;;** `counsel-git-change-worktree'
-(defun counsel-git-change-worktree-action (git-root-dir tree)
- "Find the corresponding file in the worktree located at tree.
-The current buffer is assumed to be in a subdirectory of GIT-ROOT-DIR.
-TREE is the selected candidate."
- (let* ((new-root-dir (counsel-git-worktree-parse-root tree))
- (tree-filename (file-relative-name buffer-file-name git-root-dir))
- (file-name (expand-file-name tree-filename new-root-dir)))
- (find-file file-name)))
-
-(defun counsel-git-worktree-list ()
- "List worktrees in the Git repository containing the current buffer."
- (let ((default-directory (counsel-locate-git-root)))
- (split-string (shell-command-to-string "git worktree list") "\n" t)))
-
-(defun counsel-git-worktree-parse-root (tree)
- "Return worktree from candidate TREE."
- (substring tree 0 (string-match-p " " tree)))
-
-(defun counsel-git-close-worktree-files-action (root-dir)
- "Close all buffers from the worktree located at ROOT-DIR."
- (setq root-dir (counsel-git-worktree-parse-root root-dir))
- (save-excursion
- (dolist (buf (buffer-list))
- (set-buffer buf)
- (and buffer-file-name
- (string= "." (file-relative-name root-dir
(counsel-locate-git-root)))
- (kill-buffer buf)))))
-
-(ivy-set-actions
- 'counsel-git-change-worktree
- '(("k" counsel-git-close-worktree-files-action "kill all")))
-
-;;;###autoload
-(defun counsel-git-change-worktree ()
- "Find the file corresponding to the current buffer on a different worktree."
- (interactive)
- (let ((default-directory (counsel-locate-git-root)))
- (ivy-read "Select worktree: "
- (or (cl-delete default-directory (counsel-git-worktree-list)
- :key #'counsel-git-worktree-parse-root :test
#'string=)
- (error "No other worktrees!"))
- :action (lambda (tree)
- (counsel-git-change-worktree-action
- (ivy-state-directory ivy-last) tree))
- :require-match t
- :caller 'counsel-git-change-worktree)))
-
-;;** `counsel-git-checkout'
-(defun counsel-git-checkout-action (branch)
- "Switch branch by invoking git-checkout(1).
-The command is passed a single argument comprising all characters
-in BRANCH up to, but not including, the first space
-character (#x20), or the string's end if it lacks a space."
- (shell-command
- (format "git checkout %s"
- (shell-quote-argument
- (substring branch 0 (string-match-p " " branch))))))
-
-(defun counsel-git-branch-list ()
- "Return list of branches in the current Git repository.
-Value comprises all local and remote branches bar the one
-currently checked out."
- (cl-mapcan (lambda (line)
- (and (string-match "\\`[[:blank:]]+" line)
- (list (substring line (match-end 0)))))
- (let ((default-directory (counsel-locate-git-root)))
- (split-string (shell-command-to-string "git branch -vv --all")
- "\n" t))))
-
-;;;###autoload
-(defun counsel-git-checkout ()
- "Call the \"git checkout\" command."
- (interactive)
- (ivy-read "Checkout branch: " (counsel-git-branch-list)
- :action #'counsel-git-checkout-action
- :caller 'counsel-git-checkout))
-
-(defvar counsel-yank-pop-truncate-radius)
-
-(defun counsel--git-log-format-function (str)
- (let ((counsel-yank-pop-truncate-radius 5))
- (counsel--yank-pop-format-function str)))
-
-;;;###autoload
-(defun counsel-git-log ()
- "Call the \"git log --grep\" shell command."
- (interactive)
- (ivy-read "Grep log: " #'counsel-git-log-function
- :dynamic-collection t
- :action #'counsel-git-log-action
- :caller 'counsel-git-log))
-
-(ivy-configure 'counsel-git-log
- :height 4
- :unwind-fn #'counsel-delete-process
- :format-fn #'counsel--git-log-format-function)
-
-(add-to-list 'counsel-async-split-string-re-alist '(counsel-git-log . "^commit
"))
-(add-to-list 'counsel-async-ignore-re-alist '(counsel-git-log . "^[ \n]*$"))
-
-;;* File
-;;** `counsel-find-file'
-(defvar counsel-find-file-map
- (let ((map (make-sparse-keymap)))
- (define-key map (kbd "C-DEL") 'counsel-up-directory)
- (define-key map (kbd "C-<backspace>") 'counsel-up-directory)
- (define-key map (kbd "`") (ivy-make-magic-action 'counsel-find-file "b"))
- map))
-
-(when (executable-find "git")
- (add-to-list 'ivy-ffap-url-functions 'counsel-github-url-p)
- (add-to-list 'ivy-ffap-url-functions 'counsel-emacs-url-p))
-(add-to-list 'ivy-ffap-url-functions 'counsel-url-expand)
-(defun counsel-find-file-cd-bookmark-action (_)
- "Reset `counsel-find-file' from selected directory."
- (ivy-read "cd: "
- (progn
- (ivy--virtual-buffers)
- (delete-dups
- (mapcar (lambda (x) (file-name-directory (cdr x)))
- ivy--virtual-buffers)))
- :action (lambda (x)
- (let ((default-directory (file-name-directory x)))
- (counsel-find-file)))))
-
-(defcustom counsel-root-command "sudo"
- "Command to gain root privileges."
- :type 'string)
-
-(defun counsel-find-file-as-root (x)
- "Find file X with root privileges."
- (counsel-require-program counsel-root-command)
- (let* ((host (file-remote-p x 'host))
- (file-name (format "/%s:%s:%s"
- counsel-root-command
- (or host "")
- (expand-file-name
- (if host
- (file-remote-p x 'localname)
- x)))))
- ;; If the current buffer visits the same file we are about to open,
- ;; replace the current buffer with the new one.
- (if (eq (current-buffer) (get-file-buffer x))
- (find-alternate-file file-name)
- (find-file file-name))))
-
-(defun counsel--yes-or-no-p (fmt &rest args)
- "Ask user a yes or no question created using FMT and ARGS.
-If Emacs 26 user option `read-answer-short' is bound, use it to
-choose between `yes-or-no-p' and `y-or-n-p'; otherwise default to
-`yes-or-no-p'."
- (funcall (if (and (boundp 'read-answer-short)
- (cond ((eq read-answer-short t))
- ((eq read-answer-short 'auto)
- (eq (symbol-function 'yes-or-no-p) 'y-or-n-p))))
- #'y-or-n-p
- #'yes-or-no-p)
- (apply #'format fmt args)))
-
-(defun counsel-find-file-copy (x)
- "Copy file X."
- (require 'dired-aux)
- (counsel--find-file-1 "Copy file to: "
- ivy--directory
- (lambda (new-name)
- (dired-copy-file x new-name 1))
- 'counsel-find-file-copy))
-
-(defun counsel-find-file-delete (x)
- "Delete file X."
- (when (or delete-by-moving-to-trash
- ;; `dired-delete-file', which see, already prompts for directories
- (eq t (car (file-attributes x)))
- (counsel--yes-or-no-p "Delete %s? " x))
- (dired-delete-file x dired-recursive-deletes delete-by-moving-to-trash)
- (dired-clean-up-after-deletion x)
- (let ((win (and (not (eq ivy-exit 'done))
- (active-minibuffer-window))))
- (when win (with-selected-window win (ivy--cd ivy--directory))))))
-
-(defun counsel-find-file-move (x)
- "Move or rename file X."
- (require 'dired-aux)
- (counsel--find-file-1 "Rename file to: "
- ivy--directory
- (lambda (new-name)
- (dired-rename-file x new-name 1))
- 'counsel-find-file-move))
-
-(defun counsel-find-file-mkdir-action (_x)
- "Create a directory and any nonexistent parent dirs from `ivy-text'."
- (let ((dir (file-name-as-directory
- (expand-file-name ivy-text ivy--directory)))
- (win (and (not (eq ivy-exit 'done))
- (active-minibuffer-window))))
- (make-directory dir t)
- (when win (with-selected-window win (ivy--cd dir)))))
-
-(ivy-set-actions
- 'counsel-find-file
- '(("j" find-file-other-window "other window")
- ("f" find-file-other-frame "other frame")
- ("b" counsel-find-file-cd-bookmark-action "cd bookmark")
- ("x" counsel-find-file-extern "open externally")
- ("r" counsel-find-file-as-root "open as root")
- ("R" find-file-read-only "read only")
- ("k" counsel-find-file-delete "delete")
- ("c" counsel-find-file-copy "copy file")
- ("m" counsel-find-file-move "move or rename")
- ("d" counsel-find-file-mkdir-action "mkdir")))
-
-(defcustom counsel-find-file-at-point nil
- "When non-nil, add file-at-point to the list of candidates."
- :type 'boolean)
-
-(defcustom counsel-preselect-current-file nil
- "When non-nil, preselect current file in list of candidates."
- :type 'boolean)
-
-(defcustom counsel-find-file-ignore-regexp nil
- "A regexp of files to ignore while in `counsel-find-file'.
-These files are un-ignored if `ivy-text' matches them. The
-common way to show all files is to start `ivy-text' with a dot.
-
-Example value: \"\\(?:\\`[#.]\\)\\|\\(?:[#~]\\'\\)\". This will hide
-temporary and lock files.
-\\<ivy-minibuffer-map>
-Choosing the dotfiles option, \"\\`\\.\", might be convenient,
-since you can still access the dotfiles if your input starts with
-a dot. The generic way to toggle ignored files is \\[ivy-toggle-ignore],
-but the leading dot is a lot faster."
- :type `(choice
- (const :tag "None" nil)
- (const :tag "Dotfiles and Lockfiles"
"\\(?:\\`\\|[/\\]\\)\\(?:[#.]\\)")
- (const :tag "Ignored Extensions"
- ,(regexp-opt completion-ignored-extensions))
- (regexp :tag "Regex")))
-
-(defvar counsel--find-file-predicate nil
- "When non-nil, `counsel--find-file-matcher' will use this predicate.")
-
-(defun counsel--find-file-matcher (regexp candidates)
- "Return REGEXP matching CANDIDATES.
-Skip some dotfiles unless `ivy-text' requires them."
- (let ((res
- (ivy--re-filter
- regexp candidates
- (lambda (re-str)
- (lambda (x)
- (string-match re-str (directory-file-name x)))))))
- (when counsel--find-file-predicate
- (let ((default-directory ivy--directory))
- (setq res (cl-remove-if-not counsel--find-file-predicate res))))
- (if (or (null ivy-use-ignore)
- (null counsel-find-file-ignore-regexp)
- (string-match-p "\\`\\." ivy-text))
- res
- (or (cl-remove-if
- (lambda (x)
- (and
- (string-match-p counsel-find-file-ignore-regexp x)
- (not (member x ivy-extra-directories))))
- res)
- res))))
-
-(declare-function ffap-guesser "ffap")
-
-(defvar counsel-find-file-speedup-remote t
- "Speed up opening remote files by disabling `find-file-hook' for them.")
-
-(defcustom counsel-find-file-extern-extensions '("mp4" "mkv" "xlsx")
- "List of extensions that make `counsel-find-file' use
`counsel-find-file-extern'."
- :type '(repeat string))
-
-(defun counsel-find-file-action (x)
- "Find file X."
- (with-ivy-window
- (cond ((and counsel-find-file-speedup-remote
- (file-remote-p ivy--directory))
- (let ((find-file-hook nil))
- (find-file (expand-file-name x ivy--directory))))
- ((member (file-name-extension x) counsel-find-file-extern-extensions)
- (counsel-find-file-extern x))
- (t
- (find-file (expand-file-name x ivy--directory))))))
-
-(defun counsel--preselect-file ()
- "Return candidate to preselect during filename completion.
-The preselect behavior can be customized via user options
-`counsel-find-file-at-point' and
-`counsel-preselect-current-file', which see."
- (or
- (when counsel-find-file-at-point
- (require 'ffap)
- (let ((f (ffap-guesser)))
- (when f (expand-file-name f))))
- (and counsel-preselect-current-file
- buffer-file-name
- (file-name-nondirectory buffer-file-name))))
-
-(defun counsel--find-file-1 (prompt initial-input action caller)
- (let ((default-directory
- (if (eq major-mode 'dired-mode)
- (dired-current-directory)
- default-directory)))
- (ivy-read prompt #'read-file-name-internal
- :matcher #'counsel--find-file-matcher
- :initial-input initial-input
- :action action
- :preselect (counsel--preselect-file)
- :require-match 'confirm-after-completion
- :history 'file-name-history
- :keymap counsel-find-file-map
- :caller caller)))
-
-;;;###autoload
-(defun counsel-find-file (&optional initial-input)
- "Forward to `find-file'.
-When INITIAL-INPUT is non-nil, use it in the minibuffer during completion."
- (interactive)
- (counsel--find-file-1
- "Find file: " initial-input
- #'counsel-find-file-action
- 'counsel-find-file))
-
-(ivy-configure 'counsel-find-file
- :occur #'counsel-find-file-occur
- :display-transformer-fn #'ivy-read-file-transformer)
-
-(defvar counsel-find-file-occur-cmd "ls -a | %s | xargs -d '\\n' ls -d
--group-directories-first"
- "Format string for `counsel-find-file-occur'.")
-
-(defvar counsel-find-file-occur-use-find (not (eq system-type 'gnu/linux))
- "When non-nil, `counsel-find-file-occur' will use \"find\" as the base cmd.")
-
-(defun counsel--expand-ls (cmd)
- "Expand CMD that ends in \"ls\" with switches."
- (concat cmd " " counsel-dired-listing-switches " | sed -e \"s/^/ /\""))
-
-(defvar counsel-file-name-filter-alist
- '(("ag -i '%s'" . t)
- ("ack -i '%s'" . t)
- ("perl -ne '/(%s.*)/i && print \"$1\\n\";'" . t)
- ("grep -i -E '%s'"))
- "Alist of file name filtering commands.
-The car is a shell command and the cdr is t when the shell
-command supports look-arounds. The executable for the commands
-will be checked for existence via `executable-find'. The first
-one that exists will be used.")
-
-(defun counsel--file-name-filter (&optional use-ignore)
- "Return a command that filters a file list to match ivy candidates.
-If USE-IGNORE is non-nil, try to generate a command that respects
-`counsel-find-file-ignore-regexp'."
- (let ((regex ivy--old-re))
- (if (= 0 (length regex))
- "cat"
- (let ((filter-cmd (cl-find-if
- (lambda (x)
- (executable-find
- (car (split-string (car x)))))
- counsel-file-name-filter-alist))
- cmd)
- (when (and use-ignore ivy-use-ignore
- counsel-find-file-ignore-regexp
- (cdr filter-cmd)
- (not (string-match-p "\\`\\." ivy-text))
- (not (string-match-p counsel-find-file-ignore-regexp
- (or (car ivy--old-cands) ""))))
- (let ((ignore-re (list (counsel--elisp-to-pcre
- counsel-find-file-ignore-regexp))))
- (setq regex (if (stringp regex)
- (list ignore-re (cons regex t))
- (cons ignore-re regex)))))
- (setq cmd (format (car filter-cmd)
- (counsel--elisp-to-pcre regex (cdr filter-cmd))))
- (if (string-match-p "csh\\'" shell-file-name)
- (replace-regexp-in-string "\\?!" "?\\\\!" cmd)
- cmd)))))
-
-(defun counsel--occur-cmd-find ()
- (let ((cmd (format
- "find . -maxdepth 1 | %s | xargs -I {} find {} -maxdepth 0 -ls"
- (counsel--file-name-filter t))))
- (concat
- (counsel--cmd-to-dired-by-type "d" cmd)
- " && "
- (counsel--cmd-to-dired-by-type "f" cmd))))
-
-(defun counsel--cmd-to-dired-by-type (type cmd)
- (let ((exclude-dots
- (if (string-match "^\\." ivy-text)
- ""
- " | grep -v '/\\\\.'")))
- (replace-regexp-in-string
- " | grep"
- (concat " -type " type exclude-dots " | grep") cmd)))
-
-(defun counsel-find-file-occur (&optional _cands)
- (require 'find-dired)
- (cd ivy--directory)
- (if counsel-find-file-occur-use-find
- (counsel-cmd-to-dired
- (counsel--occur-cmd-find)
- 'find-dired-filter)
- (counsel-cmd-to-dired
- (counsel--expand-ls
- (format counsel-find-file-occur-cmd
- (if (string-match-p "grep" counsel-find-file-occur-cmd)
- ;; for backwards compatibility
- (counsel--elisp-to-pcre ivy--old-re)
- (counsel--file-name-filter t)))))))
-
-(defvar counsel-up-directory-level t
- "Control whether `counsel-up-directory' goes up a level or always a
directory.
-
-If non-nil, then `counsel-up-directory' will remove the final level of the
path.
-For example: /a/long/path/file.jpg => /a/long/path/
- /a/long/path/ => /a/long/
-
-If nil, then `counsel-up-directory' will go up a directory.
-For example: /a/long/path/file.jpg => /a/long/
- /a/long/path/ => /a/long/")
-
-(defun counsel-up-directory ()
- "Go to the parent directory preselecting the current one.
-
-If the current directory is remote and it's not possible to go up any
-further, make the remote prefix editable.
-
-See variable `counsel-up-directory-level'."
- (interactive)
- (let* ((cur-dir (directory-file-name (expand-file-name ivy--directory)))
- (up-dir (file-name-directory cur-dir)))
- (if (and (file-remote-p cur-dir) (string-equal cur-dir up-dir))
- (progn
- ;; make the remote prefix editable
- (setq ivy--old-cands nil)
- (setq ivy--old-re nil)
- (ivy-set-index 0)
- (setq ivy--directory "")
- (setq ivy--all-candidates nil)
- (setq ivy-text "")
- (delete-minibuffer-contents)
- (insert up-dir))
- (if (and counsel-up-directory-level (not (string= ivy-text "")))
- (delete-region (line-beginning-position) (line-end-position))
- (ivy--cd up-dir)
- (setf (ivy-state-preselect ivy-last)
- (file-name-as-directory (file-name-nondirectory cur-dir)))))))
-
-(defun counsel-down-directory ()
- "Descend into the current directory."
- (interactive)
- (ivy--directory-enter))
-
-(defun counsel-at-git-issue-p ()
- "When point is at an issue in a Git-versioned file, return the issue string."
- (and (looking-at "#[0-9]+")
- (or (eq (vc-backend buffer-file-name) 'Git)
- (memq major-mode '(magit-commit-mode vc-git-log-view-mode))
- (bound-and-true-p magit-commit-mode))
- (match-string-no-properties 0)))
-
-(defun counsel-github-url-p ()
- "Return a Github issue URL at point."
- (counsel-require-program "git")
- (let ((url (counsel-at-git-issue-p)))
- (when url
- (let ((origin (shell-command-to-string
- "git remote get-url origin"))
- user repo)
- (cond ((string-match "\\`git@github.com:\\([^/]+\\)/\\(.*\\)\\.git$"
- origin)
- (setq user (match-string 1 origin))
- (setq repo (match-string 2 origin)))
- ((string-match "\\`https://github.com/\\([^/]+\\)/\\(.*\\)$"
- origin)
- (setq user (match-string 1 origin))
- (setq repo (match-string 2 origin))))
- (when user
- (setq url (format "https://github.com/%s/%s/issues/%s"
- user repo (substring url 1))))))))
-
-(defun counsel-emacs-url-p ()
- "Return a Debbugs issue URL at point."
- (counsel-require-program "git")
- (let ((url (counsel-at-git-issue-p)))
- (when url
- (let ((origin (shell-command-to-string
- "git remote get-url origin")))
- (when (string-match "git.sv.gnu.org:/srv/git/emacs.git" origin)
- (format "https://debbugs.gnu.org/cgi/bugreport.cgi?bug=%s"
- (substring url 1)))))))
-
-(defvar counsel-url-expansions-alist nil
- "Map of regular expressions to expansions.
-
-This variable should take the form of a list of (REGEXP . FORMAT)
-pairs.
-
-`counsel-url-expand' will expand the word at point according to
-FORMAT for the first matching REGEXP. FORMAT can be either a
-string or a function. If it is a string, it will be used as the
-format string for the `format' function, with the word at point
-as the next argument. If it is a function, it will be called
-with the word at point as the sole argument.
-
-For example, a pair of the form:
- '(\"\\`BSERV-[[:digit:]]+\\'\" . \"https://jira.atlassian.com/browse/%s\")
-will expand to URL `https://jira.atlassian.com/browse/BSERV-100'
-when the word at point is BSERV-100.
-
-If the format element is a function, more powerful
-transformations are possible. As an example,
- '(\"\\`issue\\([[:digit:]]+\\)\\'\" .
- (lambda (word)
- (concat \"https://debbugs.gnu.org/cgi/bugreport.cgi?bug=\"
- (match-string 1 word))))
-trims the \"issue\" prefix from the word at point before creating the URL.")
-
-(defun counsel-url-expand ()
- "Expand word at point using `counsel-url-expansions-alist'.
-The first pair in the list whose regexp matches the word at point
-will be expanded according to its format. This function is
-intended to be used in `ivy-ffap-url-functions' to browse the
-result as a URL."
- (let ((word-at-point (current-word)))
- (when word-at-point
- (cl-some
- (lambda (pair)
- (let ((regexp (car pair))
- (formatter (cdr pair)))
- (when (string-match regexp word-at-point)
- (if (functionp formatter)
- (funcall formatter word-at-point)
- (format formatter word-at-point)))))
- counsel-url-expansions-alist))))
-
-;;** `counsel-dired'
-(declare-function dired "dired")
-
-;;;###autoload
-(defun counsel-dired (&optional initial-input)
- "Forward to `dired'.
-When INITIAL-INPUT is non-nil, use it in the minibuffer during completion."
- (interactive)
- (let ((counsel--find-file-predicate #'file-directory-p))
- (counsel--find-file-1
- "Dired (directory): " initial-input
- (lambda (d) (dired (expand-file-name d)))
- 'counsel-dired)))
-
-(ivy-configure 'counsel-dired
- :display-transformer-fn #'ivy-read-file-transformer)
-
-;;** `counsel-recentf'
-(defvar recentf-list)
-(declare-function recentf-mode "recentf")
-
-;;;###autoload
-(defun counsel-recentf ()
- "Find a file on `recentf-list'."
- (interactive)
- (require 'recentf)
- (recentf-mode)
- (ivy-read "Recentf: " (mapcar #'substring-no-properties recentf-list)
- :action (lambda (f)
- (with-ivy-window
- (find-file f)))
- :require-match t
- :caller 'counsel-recentf))
-(ivy-set-actions
- 'counsel-recentf
- '(("j" find-file-other-window "other window")
- ("f" find-file-other-frame "other frame")
- ("x" counsel-find-file-extern "open externally")))
-
-(defun counsel-buffer-or-recentf-candidates ()
- "Return candidates for `counsel-buffer-or-recentf'."
- (require 'recentf)
- (recentf-mode)
- (let ((buffers
- (delq nil
- (mapcar (lambda (b)
- (when (buffer-file-name b)
- (buffer-file-name b)))
- (buffer-list)))))
- (append
- buffers
- (cl-remove-if (lambda (f) (member f buffers))
- (mapcar #'substring-no-properties recentf-list)))))
-
-;;;###autoload
-(defun counsel-buffer-or-recentf ()
- "Find a buffer visiting a file or file on `recentf-list'."
- (interactive)
- (ivy-read "Buffer File or Recentf: " (counsel-buffer-or-recentf-candidates)
- :action (lambda (s)
- (with-ivy-window
- (if (bufferp s)
- (switch-to-buffer s)
- (find-file s))))
- :require-match t
- :caller 'counsel-buffer-or-recentf))
-
-(ivy-configure 'counsel-buffer-or-recentf
- :display-transformer-fn #'counsel-buffer-or-recentf-transformer)
-
-(ivy-set-actions
- 'counsel-buffer-or-recentf
- '(("j" find-file-other-window "other window")
- ("f" find-file-other-frame "other frame")
- ("x" counsel-find-file-extern "open externally")))
-
-(defun counsel-buffer-or-recentf-transformer (var)
- "Propertize VAR if it's a buffer visiting a file."
- (if (member var (mapcar #'buffer-file-name (buffer-list)))
- (ivy-append-face var 'ivy-highlight-face)
- var))
-
-;;** `counsel-bookmark'
-(defcustom counsel-bookmark-avoid-dired nil
- "If non-nil, open directory bookmarks with `counsel-find-file'.
-By default `counsel-bookmark' opens a dired buffer for directories."
- :type 'boolean)
-
-(defvar bookmark-alist)
-(declare-function bookmark-location "bookmark")
-(declare-function bookmark-all-names "bookmark")
-(declare-function bookmark-get-filename "bookmark")
-(declare-function bookmark-maybe-load-default-file "bookmark")
-
-;;;###autoload
-(defun counsel-bookmark ()
- "Forward to `bookmark-jump' or `bookmark-set' if bookmark doesn't exist."
- (interactive)
- (require 'bookmark)
- (ivy-read "Create or jump to bookmark: "
- (bookmark-all-names)
- :history 'bookmark-history
- :action (lambda (x)
- (cond ((and counsel-bookmark-avoid-dired
- (member x (bookmark-all-names))
- (file-directory-p (bookmark-location x)))
- (with-ivy-window
- (let ((default-directory (bookmark-location x)))
- (counsel-find-file))))
- ((member x (bookmark-all-names))
- (with-ivy-window
- (bookmark-jump x)))
- (t
- (bookmark-set x))))
- :caller 'counsel-bookmark))
-
-(defun counsel--apply-bookmark-fn (fn)
- "Return a function applying FN to a bookmark's location."
- (lambda (bookmark)
- (funcall fn (bookmark-location bookmark))))
-
-(ivy-set-actions
- 'counsel-bookmark
- `(("d" bookmark-delete "delete")
- ("e" bookmark-rename "edit")
- ("x" ,(counsel--apply-bookmark-fn #'counsel-find-file-extern)
- "open externally")
- ("r" ,(counsel--apply-bookmark-fn #'counsel-find-file-as-root)
- "open as root")))
-
-;;** `counsel-bookmarked-directory'
-(defun counsel-bookmarked-directory--candidates ()
- "Get a list of bookmarked directories sorted by file path."
- (bookmark-maybe-load-default-file)
- (sort (cl-remove-if-not
- #'ivy--dirname-p
- (delq nil (mapcar #'bookmark-get-filename bookmark-alist)))
- #'string<))
-
-;;;###autoload
-(defun counsel-bookmarked-directory ()
- "Ivy interface for bookmarked directories.
-
-With a prefix argument, this command creates a new bookmark which points to the
-current value of `default-directory'."
- (interactive)
- (require 'bookmark)
- (ivy-read "Bookmarked directory: "
- (counsel-bookmarked-directory--candidates)
- :caller 'counsel-bookmarked-directory
- :action #'dired))
-
-(ivy-set-actions 'counsel-bookmarked-directory
- '(("j" dired-other-window "other window")
- ("x" counsel-find-file-extern "open externally")
- ("r" counsel-find-file-as-root "open as root")
- ("f" (lambda (dir)
- (let ((default-directory dir))
- (call-interactively #'find-file)))
- "find-file")))
-
-;;** `counsel-file-register'
-;;;###autoload
-(defun counsel-file-register ()
- "Search file in register.
-
-You cannot use Emacs' normal register commands to create file
-registers. Instead you must use the `set-register' function like
-so: `(set-register ?i \"/home/eric/.emacs.d/init.el\")'. Now you
-can use `C-x r j i' to open that file."
- (interactive)
- (ivy-read "File Register: "
- ;; Use the `register-alist' variable to filter out file
- ;; registers. Each entry for a file register will have the
- ;; following layout:
- ;;
- ;; (NUMBER 'file . "string/path/to/file")
- ;;
- ;; So we go through each entry and see if the `cadr' is
- ;; `eq' to the symbol `file'. If so then add the filename
- ;; (`cddr') which `ivy-read' will use for its choices.
- (mapcar (lambda (register-alist-entry)
- (if (eq 'file (cadr register-alist-entry))
- (cddr register-alist-entry)))
- register-alist)
- :require-match t
- :history 'counsel-file-register
- :caller 'counsel-file-register
- :action (lambda (register-file)
- (with-ivy-window (find-file register-file)))))
-
-(ivy-configure 'counsel-file-register
- :sort-fn #'ivy-string<)
-
-(ivy-set-actions
- 'counsel-file-register
- '(("j" find-file-other-window "other window")))
-
-;;** `counsel-locate'
-(defcustom counsel-locate-cmd (cond ((memq system-type '(darwin berkeley-unix))
- 'counsel-locate-cmd-noregex)
- ((and (eq system-type 'windows-nt)
- (executable-find "es.exe"))
- 'counsel-locate-cmd-es)
- (t
- 'counsel-locate-cmd-default))
- "The function for producing a locate command string from the input.
-
-The function takes a string - the current input, and returns a
-string - the full shell command to run."
- :type '(choice
- (const :tag "Default" counsel-locate-cmd-default)
- (const :tag "No regex" counsel-locate-cmd-noregex)
- (const :tag "mdfind" counsel-locate-cmd-mdfind)
- (const :tag "everything" counsel-locate-cmd-es)))
-
-(ivy-set-actions
- 'counsel-locate
- '(("x" counsel-locate-action-extern "xdg-open")
- ("r" counsel-find-file-as-root "open as root")
- ("d" counsel-locate-action-dired "dired")))
-
-(defvar counsel-locate-history nil
- "History for `counsel-locate'.")
-
-;;;###autoload
-(defun counsel-locate-action-extern (x)
- "Pass X to `xdg-open' or equivalent command via the shell."
- (interactive "FFile: ")
- (if (and (eq system-type 'windows-nt)
- (fboundp 'w32-shell-execute))
- (w32-shell-execute "open" x)
- (call-process-shell-command (format "%s %s"
- (cl-case system-type
- (darwin "open")
- (cygwin "cygstart")
- (t "xdg-open"))
- (shell-quote-argument x))
- nil 0)))
-
-(defalias 'counsel-find-file-extern #'counsel-locate-action-extern)
-
-(declare-function dired-jump "dired-x")
-
-(defun counsel-locate-action-dired (x)
- "Use `dired-jump' on X."
- (dired-jump nil x))
-
-(defun counsel-locate-cmd-default (input)
- "Return a shell command based on INPUT."
- (counsel-require-program "locate")
- (format "locate -i --regex '%s'"
- (counsel--elisp-to-pcre
- (ivy--regex input))))
-
-(defun counsel-locate-cmd-noregex (input)
- "Return a shell command based on INPUT."
- (counsel-require-program "locate")
- (format "locate -i '%s'" input))
-
-(defun counsel-locate-cmd-mdfind (input)
- "Return a shell command based on INPUT."
- (counsel-require-program "mdfind")
- (format "mdfind -name '%s'" input))
-
-(defvar w32-ansi-code-page)
-
-(defun counsel-locate-cmd-es (input)
- "Return a shell command based on INPUT."
- (counsel-require-program "es.exe")
- (let ((raw-string (format "es.exe -i -r -p %s"
- (counsel--elisp-to-pcre
- (ivy--regex input t)))))
- ;; W32 don't use Unicode by default, so we encode search command
- ;; to local codepage to support searching filename contains non-ASCII
- ;; characters.
- (if (and (eq system-type 'windows-nt)
- (boundp 'w32-ansi-code-page))
- (encode-coding-string raw-string
- (intern (format "cp%d" w32-ansi-code-page)))
- raw-string)))
-
-(defun counsel-locate-function (input)
- "Call the \"locate\" shell command with INPUT."
- (or
- (ivy-more-chars)
- (progn
- (counsel--async-command
- (funcall counsel-locate-cmd input))
- '("" "working..."))))
-
-(defcustom counsel-locate-db-path "~/.local/mlocate.db"
- "Location where to put the locatedb in case your home folder is encrypted."
- :type 'file)
-
-(defun counsel-file-stale-p (fname seconds)
- "Return non-nil if FNAME was modified more than SECONDS ago."
- (> (time-to-seconds
- (time-subtract
- (current-time)
- (nth 5 (file-attributes fname))))
- seconds))
-
-(defun counsel--locate-updatedb ()
- (when (file-exists-p "~/.Private")
- (let ((db-fname (expand-file-name counsel-locate-db-path)))
- (setenv "LOCATE_PATH" db-fname)
- (when (or (not (file-exists-p db-fname))
- (counsel-file-stale-p db-fname 60))
- (message "Updating %s..." db-fname)
- (counsel--command
- "updatedb" "-l" "0" "-o" db-fname "-U" (expand-file-name "~"))))))
-
-;;;###autoload
-(defun counsel-locate (&optional initial-input)
- "Call the \"locate\" shell command.
-INITIAL-INPUT can be given as the initial minibuffer input."
- (interactive)
- (counsel--locate-updatedb)
- (ivy-read "Locate: " #'counsel-locate-function
- :initial-input initial-input
- :dynamic-collection t
- :history 'counsel-locate-history
- :action (lambda (file)
- (when file
- (with-ivy-window
- (find-file
- (concat (file-remote-p default-directory) file)))))
- :caller 'counsel-locate))
-
-(ivy-configure 'counsel-locate
- :unwind-fn #'counsel-delete-process
- :exit-codes '(1 "Nothing found"))
-
-;;** `counsel-fzf'
-(defvar counsel-fzf-cmd "fzf -f \"%s\""
- "Command for `counsel-fzf'.")
-
-(defvar counsel--fzf-dir nil
- "Store the base fzf directory.")
-
-(defvar counsel-fzf-dir-function 'counsel-fzf-dir-function-projectile
- "Function that returns a directory for fzf to use.")
-
-(defun counsel-fzf-dir-function-projectile ()
- (if (and
- (fboundp 'projectile-project-p)
- (fboundp 'projectile-project-root)
- (projectile-project-p))
- (projectile-project-root)
- default-directory))
-
-(defun counsel-fzf-function (str)
- (let ((default-directory counsel--fzf-dir))
- (setq ivy--old-re (ivy--regex-fuzzy str))
- (counsel--async-command
- (format counsel-fzf-cmd str)))
- nil)
-
-;;;###autoload
-(defun counsel-fzf (&optional initial-input initial-directory fzf-prompt)
- "Open a file using the fzf shell command.
-INITIAL-INPUT can be given as the initial minibuffer input.
-INITIAL-DIRECTORY, if non-nil, is used as the root directory for search.
-FZF-PROMPT, if non-nil, is passed as `ivy-read' prompt argument."
- (interactive
- (let ((fzf-basename (car (split-string counsel-fzf-cmd))))
- (list nil
- (when current-prefix-arg
- (counsel-read-directory-name (concat
- fzf-basename
- " in directory: "))))))
- (counsel-require-program counsel-fzf-cmd)
- (setq counsel--fzf-dir
- (or initial-directory
- (funcall counsel-fzf-dir-function)))
- (ivy-read (or fzf-prompt "fzf: ")
- #'counsel-fzf-function
- :initial-input initial-input
- :re-builder #'ivy--regex-fuzzy
- :dynamic-collection t
- :action #'counsel-fzf-action
- :caller 'counsel-fzf))
-
-(ivy-configure 'counsel-fzf
- :occur #'counsel-fzf-occur
- :unwind-fn #'counsel-delete-process
- :exit-codes '(1 "Nothing found"))
-
-(defun counsel-fzf-action (x)
- "Find file X in current fzf directory."
- (with-ivy-window
- (let ((default-directory counsel--fzf-dir))
- (find-file x))))
-
-(defun counsel-fzf-occur (&optional _cands)
- "Occur function for `counsel-fzf' using `counsel-cmd-to-dired'."
- (cd counsel--fzf-dir)
- (counsel-cmd-to-dired
- (counsel--expand-ls
- (format
- "%s --print0 | xargs -0 ls"
- (format counsel-fzf-cmd ivy-text)))))
-
-(ivy-set-actions
- 'counsel-fzf
- '(("x" counsel-locate-action-extern "xdg-open")
- ("d" counsel-locate-action-dired "dired")))
-
-;;** `counsel-dpkg'
-;;;###autoload
-(defun counsel-dpkg ()
- "Call the \"dpkg\" shell command."
- (interactive)
- (counsel-require-program "dpkg")
- (let ((cands (mapcar
- (lambda (x)
- (let ((y (split-string x " +")))
- (cons (format "%-40s %s"
- (ivy--truncate-string
- (nth 1 y) 40)
- (nth 4 y))
- (mapconcat #'identity y " "))))
- (split-string
- (shell-command-to-string "dpkg -l | tail -n+6") "\n" t))))
- (ivy-read "dpkg: " cands
- :action (lambda (x)
- (message (cdr x)))
- :caller 'counsel-dpkg)))
-
-;;** `counsel-rpm'
-;;;###autoload
-(defun counsel-rpm ()
- "Call the \"rpm\" shell command."
- (interactive)
- (counsel-require-program "rpm")
- (let ((cands (mapcar
- (lambda (x)
- (let ((y (split-string x "|")))
- (cons (format "%-40s %s"
- (ivy--truncate-string
- (nth 0 y) 40)
- (nth 1 y))
- (mapconcat #'identity y " "))))
- (split-string
- (shell-command-to-string "rpm -qa --qf
\"%{NAME}|%{SUMMARY}\\n\"") "\n" t))))
- (ivy-read "rpm: " cands
- :action (lambda (x)
- (message (cdr x)))
- :caller 'counsel-rpm)))
-
-(defun counsel--find-return-list (args)
- (unless (listp args)
- (user-error "`counsel-file-jump-args' is a list now, please customize
accordingly."))
- (counsel--call
- (cons find-program args)
- (lambda ()
- (let (files)
- (goto-char (point-min))
- (while (< (point) (point-max))
- (when (looking-at "\\./")
- (goto-char (match-end 0)))
- (push (buffer-substring (point) (line-end-position)) files)
- (beginning-of-line 2))
- (nreverse files)))))
-
-(defcustom counsel-file-jump-args (split-string ". -name .git -prune -o -type
f -print")
- "Arguments for the `find-command' when using `counsel-file-jump'."
- :type '(repeat string))
-
-;;** `counsel-file-jump'
-;;;###autoload
-(defun counsel-file-jump (&optional initial-input initial-directory)
- "Jump to a file below the current directory.
-List all files within the current directory or any of its sub-directories.
-INITIAL-INPUT can be given as the initial minibuffer input.
-INITIAL-DIRECTORY, if non-nil, is used as the root directory for search."
- (interactive
- (list nil
- (when current-prefix-arg
- (counsel-read-directory-name "From directory: "))))
- (counsel-require-program find-program)
- (let ((default-directory (or initial-directory default-directory)))
- (ivy-read "Find file: "
- (counsel--find-return-list counsel-file-jump-args)
- :matcher #'counsel--find-file-matcher
- :initial-input initial-input
- :action #'find-file
- :preselect (counsel--preselect-file)
- :require-match 'confirm-after-completion
- :history 'file-name-history
- :keymap counsel-find-file-map
- :caller 'counsel-file-jump)))
-
-(ivy-set-actions
- 'counsel-file-jump
- `(("d" ,(lambda (x)
- (dired (or (file-name-directory x) default-directory)))
- "open in dired")))
-
-(defcustom counsel-dired-jump-args (split-string ". -name .git -prune -o -type
d -print")
- "Arguments for the `find-command' when using `counsel-dired-jump'."
- :type '(repeat string))
-
-;;** `counsel-dired-jump'
-;;;###autoload
-(defun counsel-dired-jump (&optional initial-input initial-directory)
- "Jump to a directory (see `dired-jump') below the current directory.
-List all sub-directories within the current directory.
-INITIAL-INPUT can be given as the initial minibuffer input.
-INITIAL-DIRECTORY, if non-nil, is used as the root directory for search."
- (interactive
- (list nil
- (when current-prefix-arg
- (counsel-read-directory-name "From directory: "))))
- (counsel-require-program find-program)
- (let ((default-directory (or initial-directory default-directory)))
- (ivy-read "Find directory: "
- (cdr
- (counsel--find-return-list counsel-dired-jump-args))
- :matcher #'counsel--find-file-matcher
- :initial-input initial-input
- :action (lambda (d) (dired-jump nil (expand-file-name d)))
- :history 'file-name-history
- :keymap counsel-find-file-map
- :caller 'counsel-dired-jump)))
-
-;;* Grep
-(defun counsel--grep-mode-occur (git-grep-dir-is-file)
- "Generate a custom occur buffer for grep like commands.
-If GIT-GREP-DIR-IS-FILE is t, then `ivy-state-directory' is treated as a full
-path to a file rather than a directory (e.g. for `counsel-grep-occur').
-
-This function expects that the candidates have already been filtered.
-It applies no filtering to ivy--all-candidates."
- (unless (eq major-mode 'ivy-occur-grep-mode)
- (ivy-occur-grep-mode))
- (let ((directory
- (if git-grep-dir-is-file
- (file-name-directory (ivy-state-directory ivy-last))
- (ivy-state-directory ivy-last))))
- (setq default-directory directory)
- ;; Need precise number of header lines for `wgrep' to work.
- (insert (format "-*- mode:grep; default-directory: %S -*-\n\n\n"
default-directory))
- (insert (format "%d candidates:\n" (length ivy--all-candidates)))
- (ivy--occur-insert-lines
- (mapcar #'counsel--normalize-grep-match ivy--all-candidates))))
-
-;;** `counsel-ag'
-(defvar counsel-ag-map
- (let ((map (make-sparse-keymap)))
- (define-key map (kbd "C-l") 'ivy-call-and-recenter)
- (define-key map (kbd "M-q") 'counsel-git-grep-query-replace)
- (define-key map (kbd "C-'") 'swiper-avy)
- (define-key map (kbd "C-x C-d") 'counsel-cd)
- map))
-
-(defcustom counsel-ag-base-command
- (if (memq system-type '(ms-dos windows-nt))
- "ag --vimgrep %s"
- "ag --nocolor --nogroup %s")
- "Format string to use in `counsel-ag-function' to construct the command.
-The %s will be replaced by optional extra ag arguments followed by the
-regex string."
- :type 'string)
-
-(defvar counsel-ag-command nil)
-
-(defvar counsel--grep-tool-look-around t)
-
-(defvar counsel--regex-look-around nil)
-
-(defconst counsel--command-args-separator "-- ")
-
-(defun counsel--split-command-args (arguments)
- "Split ARGUMENTS into its switches and search-term parts.
-Return pair of corresponding strings (SWITCHES . SEARCH-TERM)."
- (let ((switches "")
- (search-term arguments))
- (when (string-prefix-p "-" arguments)
- (let ((index (string-match counsel--command-args-separator arguments)))
- (when index
- (setq search-term
- (substring arguments (+ (length
counsel--command-args-separator) index)))
- (setq switches (substring arguments 0 index)))))
- (cons switches search-term)))
-
-(defun counsel--format-ag-command (extra-args needle)
- "Construct a complete `counsel-ag-command' as a string.
-EXTRA-ARGS is a string of the additional arguments.
-NEEDLE is the search string."
- (format counsel-ag-command
- (if (string-match " \\(--\\) " extra-args)
- (replace-match needle t t extra-args 1)
- (concat extra-args " " needle))))
-
-(defun counsel--grep-regex (str)
- (counsel--elisp-to-pcre
- (setq ivy--old-re
- (funcall ivy--regex-function str))
- counsel--regex-look-around))
-
-(defun counsel--ag-extra-switches (regex)
- "Get additional switches needed for look-arounds."
- (and (stringp counsel--regex-look-around)
- ;; using look-arounds
- (string-match-p "\\`\\^(\\?[=!]" regex)
- (concat " " counsel--regex-look-around " ")))
-
-(defun counsel-ag-function (string)
- "Grep in the current directory for STRING."
- (let* ((command-args (counsel--split-command-args string))
- (search-term (cdr command-args)))
- (or
- (let ((ivy-text search-term))
- (ivy-more-chars))
- (let* ((default-directory (ivy-state-directory ivy-last))
- (regex (counsel--grep-regex search-term))
- (switches (concat (car command-args)
- (counsel--ag-extra-switches regex)
- (and (ivy--case-fold-p string) " -i "))))
- (counsel--async-command (counsel--format-ag-command
- switches
- (shell-quote-argument regex)))
- nil))))
-
-;;;###autoload
-(cl-defun counsel-ag (&optional initial-input initial-directory extra-ag-args
ag-prompt
- &key caller)
- "Grep for a string in the current directory using ag.
-INITIAL-INPUT can be given as the initial minibuffer input.
-INITIAL-DIRECTORY, if non-nil, is used as the root directory for search.
-EXTRA-AG-ARGS string, if non-nil, is appended to `counsel-ag-base-command'.
-AG-PROMPT, if non-nil, is passed as `ivy-read' prompt argument.
-CALLER is passed to `ivy-read'."
- (interactive)
- (setq counsel-ag-command counsel-ag-base-command)
- (setq counsel--regex-look-around counsel--grep-tool-look-around)
- (counsel-require-program counsel-ag-command)
- (when current-prefix-arg
- (setq initial-directory
- (or initial-directory
- (counsel-read-directory-name (concat
- (car (split-string
counsel-ag-command))
- " in directory: "))))
- (setq extra-ag-args
- (or extra-ag-args
- (read-from-minibuffer (format
- "%s args: "
- (car (split-string
counsel-ag-command)))))))
- (setq counsel-ag-command (counsel--format-ag-command (or extra-ag-args "")
"%s"))
- (let ((default-directory (or initial-directory
- (counsel--git-root)
- default-directory)))
- (ivy-read (or ag-prompt
- (concat (car (split-string counsel-ag-command)) ": "))
- #'counsel-ag-function
- :initial-input initial-input
- :dynamic-collection t
- :keymap counsel-ag-map
- :history 'counsel-git-grep-history
- :action #'counsel-git-grep-action
- :caller (or caller 'counsel-ag))))
-
-(ivy-configure 'counsel-ag
- :occur #'counsel-ag-occur
- :unwind-fn #'counsel--grep-unwind
- :display-transformer-fn #'counsel-git-grep-transformer
- :grep-p t
- :exit-codes '(1 "No matches found"))
-
-(defun counsel-read-directory-name (prompt)
- "Read a directory name from user, a (partial) replacement of
`read-directory-name'."
- (let ((counsel--find-file-predicate #'file-directory-p))
- (ivy-read prompt
- #'read-file-name-internal
- :matcher #'counsel--find-file-matcher
- :history 'file-name-history
- :keymap counsel-find-file-map
- :caller 'counsel-read-directory-name)))
-
-(ivy-configure 'counsel-read-directory-name
- :display-transformer-fn #'ivy-read-file-transformer)
-
-(defun counsel-cd ()
- "Change the directory for the currently running Ivy grep-like command.
-Works for `counsel-git-grep', `counsel-ag', etc."
- (interactive)
- (let ((input ivy-text)
- (new-dir (counsel-read-directory-name "cd: ")))
- (ivy-quit-and-run
- (funcall (ivy-state-caller ivy-last) input new-dir))))
-
-(defun counsel-grep-like-occur (cmd-template)
- (unless (eq major-mode 'ivy-occur-grep-mode)
- (ivy-occur-grep-mode)
- (setq default-directory (ivy-state-directory ivy-last)))
- (setq ivy-text
- (and (string-match "\"\\(.*\\)\"" (buffer-name))
- (match-string 1 (buffer-name))))
- (let* ((cmd
- (if (functionp cmd-template)
- (funcall cmd-template ivy-text)
- (let* ((command-args (counsel--split-command-args ivy-text))
- (regex (counsel--grep-regex (cdr command-args)))
- (switches (concat (car command-args)
- (counsel--ag-extra-switches regex))))
- (format cmd-template
- (concat
- switches
- (shell-quote-argument regex))))))
- (cands (counsel--split-string (shell-command-to-string cmd))))
- (swiper--occur-insert-lines (mapcar #'counsel--normalize-grep-match
cands))))
-
-(defun counsel-ag-occur (&optional _cands)
- "Generate a custom occur buffer for `counsel-ag'."
- (counsel-grep-like-occur
- counsel-ag-command))
-
-;;** `counsel-pt'
-(defcustom counsel-pt-base-command "pt --nocolor --nogroup -e %s"
- "Alternative to `counsel-ag-base-command' using pt."
- :type 'string)
-
-;;;###autoload
-(defun counsel-pt (&optional initial-input)
- "Grep for a string in the current directory using pt.
-INITIAL-INPUT can be given as the initial minibuffer input.
-This uses `counsel-ag' with `counsel-pt-base-command' instead of
-`counsel-ag-base-command'."
- (interactive)
- (let ((counsel-ag-base-command counsel-pt-base-command)
- (counsel--grep-tool-look-around nil))
- (counsel-ag initial-input :caller 'counsel-pt)))
-
-(ivy-configure 'counsel-pt
- :unwind-fn #'counsel--grep-unwind
- :display-transformer-fn #'counsel-git-grep-transformer
- :grep-p t)
-
-;;** `counsel-ack'
-(defcustom counsel-ack-base-command
- (concat
- (file-name-nondirectory
- (or (executable-find "ack-grep") "ack"))
- " --nocolor --nogroup %s")
- "Alternative to `counsel-ag-base-command' using ack."
- :type 'string)
-
-;;;###autoload
-(defun counsel-ack (&optional initial-input)
- "Grep for a string in the current directory using ack.
-INITIAL-INPUT can be given as the initial minibuffer input.
-This uses `counsel-ag' with `counsel-ack-base-command' replacing
-`counsel-ag-base-command'."
- (interactive)
- (let ((counsel-ag-base-command counsel-ack-base-command)
- (counsel--grep-tool-look-around t))
- (counsel-ag initial-input :caller 'counsel-ack)))
-
-
-;;** `counsel-rg'
-(defcustom counsel-rg-base-command
- (if (memq system-type '(ms-dos windows-nt))
- "rg --with-filename --no-heading --line-number --path-separator /
--color never %s ."
- "rg --with-filename --no-heading --line-number --color never %s")
- "Alternative to `counsel-ag-base-command' using ripgrep.
-
-Note: don't use single quotes for the regex."
- :type 'string)
-
-(defun counsel--rg-targets ()
- "Return a list of files to operate on, based on `dired-mode' marks."
- (if (eq major-mode 'dired-mode)
- (let ((files
- (dired-get-marked-files 'no-dir nil nil t)))
- (if (and (null (cdr files))
- (not (when (string-match-p "\\*ivy-occur" (buffer-name))
- (dired-toggle-marks)
- (setq files (dired-get-marked-files 'no-dir))
- (dired-toggle-marks)
- t)))
- ""
- (concat
- " "
- (mapconcat #'shell-quote-argument (delq t files) " "))))
- ""))
-
-;;;###autoload
-(defun counsel-rg (&optional initial-input initial-directory extra-rg-args
rg-prompt)
- "Grep for a string in the current directory using rg.
-INITIAL-INPUT can be given as the initial minibuffer input.
-INITIAL-DIRECTORY, if non-nil, is used as the root directory for search.
-EXTRA-RG-ARGS string, if non-nil, is appended to `counsel-rg-base-command'.
-RG-PROMPT, if non-nil, is passed as `ivy-read' prompt argument.
-
-Example input with inclusion and exclusion file patterns:
- -g*.py -g!*test* -- ..."
- (interactive)
- (let ((counsel-ag-base-command
- (concat counsel-rg-base-command (counsel--rg-targets)))
- (counsel--grep-tool-look-around
- (let ((rg (car (split-string counsel-rg-base-command)))
- (switch "--pcre2"))
- (and (eq 0 (call-process rg nil nil nil switch "--version"))
- switch))))
- (counsel-ag initial-input initial-directory extra-rg-args rg-prompt
- :caller 'counsel-rg)))
-
-(ivy-configure 'counsel-rg
- :occur #'counsel-ag-occur
- :unwind-fn #'counsel--grep-unwind
- :display-transformer-fn #'counsel-git-grep-transformer
- :grep-p t
- :exit-codes '(1 "No matches found"))
-
-;;** `counsel-grep'
-(defvar counsel-grep-map
- (let ((map (make-sparse-keymap)))
- (define-key map (kbd "C-l") 'ivy-call-and-recenter)
- (define-key map (kbd "M-q") 'swiper-query-replace)
- (define-key map (kbd "C-'") 'swiper-avy)
- map))
-
-(defcustom counsel-grep-base-command "grep -E -n -e %s %s"
- "Format string used by `counsel-grep' to build a shell command.
-It should contain two %-sequences (see function `format') to be
-substituted by the search regexp and file, respectively. Neither
-%-sequence should be contained in single quotes."
- :type 'string)
-
-(defvar counsel-grep-command nil)
-
-(defun counsel-grep-function (string)
- "Grep in the current directory for STRING."
- (or
- (ivy-more-chars)
- (let ((regex (counsel--elisp-to-pcre
- (setq ivy--old-re
- (ivy--regex string)))))
- (counsel--async-command
- (format counsel-grep-command (shell-quote-argument regex)))
- nil)))
-
-(defvar counsel--grep-last-pos nil
- "Store the last point and line that `counsel-grep-action' scrolled to.
-This speeds up scrolling: instead of going to `point-min' and
-`forward-line' with a huge arg (e.g. to scroll 50K lines), scroll
-relative to the last position stored here.")
-
-(defun counsel-grep-action (x)
- "Go to candidate X."
- (with-ivy-window
- (swiper--cleanup)
- (let ((default-directory
- (file-name-directory
- (ivy-state-directory ivy-last)))
- file-name line-number)
- (when (cond ((string-match "\\`\\([0-9]+\\):\\(.*\\)\\'" x)
- (setq file-name (buffer-file-name (ivy-state-buffer
ivy-last)))
- (setq line-number (match-string-no-properties 1 x)))
- ((string-match "\\`\\([^:]+\\):\\([0-9]+\\):\\(.*\\)\\'" x)
- (setq file-name (match-string-no-properties 1 x))
- (setq line-number (match-string-no-properties 2 x))))
- ;; If the file buffer is already open, just get it. Prevent doing
- ;; `find-file', as that file could have already been opened using
- ;; `find-file-literally'.
- (with-current-buffer (or (get-file-buffer file-name)
- (find-file file-name))
- (setq line-number (string-to-number line-number))
- (if (and counsel--grep-last-pos (= (point) (car
counsel--grep-last-pos)))
- (forward-line (- line-number (cdr counsel--grep-last-pos)))
- (goto-char (point-min))
- (forward-line (1- line-number)))
- (setq counsel--grep-last-pos (cons (point) line-number))
- (when (re-search-forward (ivy--regex ivy-text t) (line-end-position)
t)
- (when swiper-goto-start-of-match
- (goto-char (match-beginning 0))))
- (run-hooks 'counsel-grep-post-action-hook)
- (if (eq ivy-exit 'done)
- (swiper--ensure-visible)
- (isearch-range-invisible (line-beginning-position)
- (line-end-position))
- (swiper--add-overlays (ivy--regex ivy-text))))))))
-
-(defun counsel-grep-occur (&optional _cands)
- "Generate a custom occur buffer for `counsel-grep'."
- (counsel-grep-like-occur
- (format
- "grep -niE %%s %s /dev/null"
- (shell-quote-argument
- (file-name-nondirectory
- (buffer-file-name
- (ivy-state-buffer ivy-last)))))))
-
-(defvar counsel-grep-history nil
- "History for `counsel-grep'.")
-
-;;;###autoload
-(defun counsel-grep (&optional initial-input)
- "Grep for a string in the file visited by the current buffer.
-When non-nil, INITIAL-INPUT is the initial search pattern."
- (interactive)
- (unless buffer-file-name
- (user-error "Current buffer is not visiting a file"))
- (counsel-require-program counsel-grep-base-command)
- (setq counsel-grep-command
- (format counsel-grep-base-command
- "%s" (shell-quote-argument
- (file-name-nondirectory
- buffer-file-name))))
- (let ((default-directory (file-name-directory buffer-file-name))
- (init-point (point))
- res)
- (unwind-protect
- (setq res (ivy-read "grep: " #'counsel-grep-function
- :initial-input initial-input
- :dynamic-collection t
- :require-match t
- :preselect
- (when (< (- (line-end-position)
(line-beginning-position)) 300)
- (format "%d:%s"
- (line-number-at-pos)
- (regexp-quote
- (buffer-substring-no-properties
- (line-beginning-position)
- (line-end-position)))))
- :keymap counsel-grep-map
- :history 'counsel-grep-history
- :re-builder #'ivy--regex
- :action #'counsel-grep-action
- :caller 'counsel-grep))
- (unless res
- (goto-char init-point)))))
-
-(ivy-configure 'counsel-grep
- :update-fn 'auto
- :unwind-fn #'counsel--grep-unwind
- :index-fn #'ivy-recompute-index-swiper-async
- :occur #'counsel-grep-occur
- :more-chars 2
- :grep-p t
- :exit-codes '(1 ""))
-
-;;;###autoload
-(defun counsel-grep-backward (&optional initial-input)
- "Grep for a string in the file visited by the current buffer going
-backward similar to `swiper-backward'. When non-nil, INITIAL-INPUT is
-the initial search pattern."
- (interactive)
- (let ((ivy-index-functions-alist
- '((counsel-grep . ivy-recompute-index-swiper-async-backward))))
- (counsel-grep initial-input)))
-
-;;** `counsel-grep-or-swiper'
-(defcustom counsel-grep-swiper-limit 300000
- "Buffer size threshold for `counsel-grep-or-swiper'.
-When the number of characters in a buffer exceeds this threshold,
-`counsel-grep' will be used instead of `swiper'."
- :type 'integer)
-
-(defcustom counsel-grep-use-swiper-p #'counsel-grep-use-swiper-p-default
- "When this function returns non-nil, call `swiper', else `counsel-grep'."
- :type '(choice
- (const :tag "Rely on `counsel-grep-swiper-limit'."
- counsel-grep-use-swiper-p-default)
- (const :tag "Always use `counsel-grep'." ignore)
- (function :tag "Custom")))
-
-(defun counsel-grep-use-swiper-p-default ()
- (<= (buffer-size)
- (/ counsel-grep-swiper-limit
- (if (eq major-mode 'org-mode) 4 1))))
-
-;;;###autoload
-(defun counsel-grep-or-swiper (&optional initial-input)
- "Call `swiper' for small buffers and `counsel-grep' for large ones.
-When non-nil, INITIAL-INPUT is the initial search pattern."
- (interactive)
- (if (or (not buffer-file-name)
- (buffer-narrowed-p)
- (ignore-errors
- (file-remote-p buffer-file-name))
- (jka-compr-get-compression-info buffer-file-name)
- (funcall counsel-grep-use-swiper-p))
- (swiper initial-input)
- (when (file-writable-p buffer-file-name)
- (save-buffer))
- (counsel-grep initial-input)))
-
-;;** `counsel-grep-or-swiper-backward'
-;;;###autoload
-(defun counsel-grep-or-swiper-backward (&optional initial-input)
- "Call `swiper-backward' for small buffers and `counsel-grep-backward' for
-large ones. When non-nil, INITIAL-INPUT is the initial search pattern."
- (interactive)
- (let ((ivy-index-functions-alist
- '((swiper . ivy-recompute-index-swiper-backward)
- (counsel-grep . ivy-recompute-index-swiper-async-backward))))
- (counsel-grep-or-swiper initial-input)))
-
-;;** `counsel-recoll'
-(defun counsel-recoll-function (str)
- "Run recoll for STR."
- (or
- (ivy-more-chars)
- (progn
- (counsel--async-command
- (format "recoll -t -b %s"
- (shell-quote-argument str)))
- nil)))
-
-;; This command uses the recollq command line tool that comes together
-;; with the recoll (the document indexing database) source:
-;; https://www.lesbonscomptes.com/recoll/download.html
-;; You need to build it yourself (together with recoll):
-;; cd ./query && make && sudo cp recollq /usr/local/bin
-;; You can try the GUI version of recoll with:
-;; sudo apt-get install recoll
-;; Unfortunately, that does not install recollq.
-;;;###autoload
-(defun counsel-recoll (&optional initial-input)
- "Search for a string in the recoll database.
-You'll be given a list of files that match.
-Selecting a file will launch `swiper' for that file.
-INITIAL-INPUT can be given as the initial minibuffer input."
- (interactive)
- (counsel-require-program "recoll")
- (ivy-read "recoll: " 'counsel-recoll-function
- :initial-input initial-input
- :dynamic-collection t
- :history 'counsel-git-grep-history
- :action (lambda (x)
- (when (string-match "file://\\(.*\\)\\'" x)
- (let ((file-name (match-string 1 x)))
- (find-file file-name)
- (unless (string-match "pdf$" x)
- (swiper ivy-text)))))
- :caller 'counsel-recoll))
-
-(ivy-configure 'counsel-recoll
- :unwind-fn #'counsel-delete-process)
-
-;;* Org
-;;** `counsel-org-tag'
-(defvar counsel-org-tags nil
- "Store the current list of tags.")
-
-(defvar org-outline-regexp)
-(defvar org-indent-mode)
-(defvar org-indent-indentation-per-level)
-(defvar org-tags-column)
-(declare-function org-get-tags-string "org")
-(declare-function org-get-tags "org")
-(declare-function org-make-tag-string "org")
-(declare-function org-move-to-column "org-compat")
-
-(defun counsel--org-make-tag-string ()
- (if (fboundp #'org-make-tag-string)
- ;; >= Org 9.2
- (org-make-tag-string (counsel--org-get-tags))
- (with-no-warnings
- (org-get-tags-string))))
-
-(defun counsel-org-change-tags (tags)
- "Change tags of current org headline to TAGS."
- (let ((current (counsel--org-make-tag-string))
- (col (current-column))
- level)
- ;; Insert new tags at the correct column
- (beginning-of-line 1)
- (setq level (or (and (looking-at org-outline-regexp)
- (- (match-end 0) (point) 1))
- 1))
- (cond
- ((and (equal current "") (equal tags "")))
- ((re-search-forward
- (concat "\\([ \t]*" (regexp-quote current) "\\)[ \t]*$")
- (line-end-position) t)
- (if (equal tags "")
- (delete-region
- (match-beginning 0)
- (match-end 0))
- (goto-char (match-beginning 0))
- (let* ((c0 (current-column))
- ;; compute offset for the case of org-indent-mode active
- (di (if (bound-and-true-p org-indent-mode)
- (* (1- org-indent-indentation-per-level) (1- level))
- 0))
- (p0 (if (equal (char-before) ?*) (1+ (point)) (point)))
- (tc (+ org-tags-column (if (> org-tags-column 0) (- di) di)))
- (c1 (max (1+ c0) (if (> tc 0) tc (- (- tc) (string-width
tags)))))
- (rpl (concat (make-string (max 0 (- c1 c0)) ?\ ) tags)))
- (replace-match rpl t t)
- (and c0 indent-tabs-mode (tabify p0 (point)))
- tags)))
- (t (error "Tags alignment failed")))
- (org-move-to-column col)))
-
-(defun counsel-org--set-tags ()
- "Set tags of current org headline to `counsel-org-tags'."
- (counsel-org-change-tags
- (if counsel-org-tags
- (format ":%s:"
- (mapconcat #'identity counsel-org-tags ":"))
- "")))
-
-(defvar org-agenda-bulk-marked-entries)
-
-(declare-function org-get-at-bol "org")
-(declare-function org-agenda-error "org-agenda")
-
-(defun counsel-org-tag-action (x)
- "Add tag X to `counsel-org-tags'.
-If X is already part of the list, remove it instead. Quit the selection if
-X is selected by either `ivy-done', `ivy-alt-done' or `ivy-immediate-done',
-otherwise continue prompting for tags."
- (if (member x counsel-org-tags)
- (progn
- (setq counsel-org-tags (delete x counsel-org-tags)))
- (unless (equal x "")
- (setq counsel-org-tags (append counsel-org-tags (list x)))
- (unless (member x ivy--all-candidates)
- (setq ivy--all-candidates (append ivy--all-candidates (list x))))))
- (let ((prompt (counsel-org-tag-prompt)))
- (setf (ivy-state-prompt ivy-last) prompt)
- (setq ivy--prompt (concat "%-4d " prompt)))
- (cond ((memq this-command '(ivy-done
- ivy-alt-done
- ivy-immediate-done))
- (if (eq major-mode 'org-agenda-mode)
- (if (null org-agenda-bulk-marked-entries)
- (let ((hdmarker (or (org-get-at-bol 'org-hd-marker)
- (org-agenda-error))))
- (with-current-buffer (marker-buffer hdmarker)
- (goto-char hdmarker)
- (counsel-org--set-tags)))
- (let ((add-tags (copy-sequence counsel-org-tags)))
- (dolist (m org-agenda-bulk-marked-entries)
- (with-current-buffer (marker-buffer m)
- (save-excursion
- (goto-char m)
- (setq counsel-org-tags
- (delete-dups
- (append (counsel--org-get-tags) add-tags)))
- (counsel-org--set-tags))))))
- (counsel-org--set-tags)))
- ((eq this-command 'ivy-call)
- (with-selected-window (active-minibuffer-window)
- (delete-minibuffer-contents)))))
-
-(defun counsel-org-tag-prompt ()
- "Return prompt for `counsel-org-tag'."
- (format "Tags (%s): "
- (mapconcat #'identity counsel-org-tags ", ")))
-
-(defvar org-setting-tags)
-(defvar org-last-tags-completion-table)
-(defvar org-tag-persistent-alist)
-(defvar org-tag-alist)
-(defvar org-complete-tags-always-offer-all-agenda-tags)
-
-(declare-function org-at-heading-p "org")
-(declare-function org-back-to-heading "org")
-(declare-function org-get-buffer-tags "org")
-(declare-function org-global-tags-completion-table "org")
-(declare-function org-agenda-files "org")
-(declare-function org-agenda-set-tags "org-agenda")
-(declare-function org-tags-completion-function "org")
-
-;;;###autoload
-(defun counsel--org-get-tags ()
- (delete "" (condition-case nil
- (org-get-tags nil t)
- (error (org-get-tags)))))
-
-;;;###autoload
-(defun counsel-org-tag ()
- "Add or remove tags in `org-mode'."
- (interactive)
- (save-excursion
- (if (eq major-mode 'org-agenda-mode)
- (if org-agenda-bulk-marked-entries
- (setq counsel-org-tags nil)
- (let ((hdmarker (or (org-get-at-bol 'org-hd-marker)
- (org-agenda-error))))
- (with-current-buffer (marker-buffer hdmarker)
- (goto-char hdmarker)
- (setq counsel-org-tags (counsel--org-get-tags)))))
- (unless (org-at-heading-p)
- (org-back-to-heading t))
- (setq counsel-org-tags (counsel--org-get-tags)))
- (let ((org-last-tags-completion-table
- (append (and (or org-complete-tags-always-offer-all-agenda-tags
- (eq major-mode 'org-agenda-mode))
- (org-global-tags-completion-table
- (org-agenda-files)))
- (unless (boundp 'org-current-tag-alist)
- org-tag-persistent-alist)
- (or (if (boundp 'org-current-tag-alist)
- org-current-tag-alist
- org-tag-alist)
- (org-get-buffer-tags)))))
- (ivy-read (counsel-org-tag-prompt)
- (lambda (str _pred _action)
- (delete-dups
- (all-completions str #'org-tags-completion-function)))
- :history 'org-tags-history
- :action #'counsel-org-tag-action
- :caller 'counsel-org-tag))))
-
-(defvar org-version)
-
-;;;###autoload
-(defun counsel-org-tag-agenda ()
- "Set tags for the current agenda item."
- (interactive)
- (cl-letf (((symbol-function (if (version< org-version "9.2")
- 'org-set-tags
- 'org-set-tags-command))
- #'counsel-org-tag))
- (org-agenda-set-tags)))
-
-(defcustom counsel-org-headline-display-tags nil
- "If non-nil, display tags in matched `org-mode' headlines."
- :type 'boolean)
-
-(defcustom counsel-org-headline-display-todo nil
- "If non-nil, display todo keywords in matched `org-mode' headlines."
- :type 'boolean)
-
-(defcustom counsel-org-headline-display-priority nil
- "If non-nil, display priorities in matched `org-mode' headlines."
- :type 'boolean)
-
-(declare-function org-get-heading "org")
-(declare-function org-goto-marker-or-bmk "org")
-(declare-function outline-next-heading "outline")
-
-;;;###autoload
-(defalias 'counsel-org-goto #'counsel-outline)
-
-(defcustom counsel-org-goto-all-outline-path-prefix nil
- "Prefix for outline candidates in `counsel-org-goto-all'."
- :type '(choice
- (const :tag "None" nil)
- (const :tag "File name" file-name)
- (const :tag "File name (nondirectory part)" file-name-nondirectory)
- (const :tag "Buffer name" buffer-name)))
-
-(defun counsel-org-goto-all--outline-path-prefix ()
- (cl-case counsel-org-goto-all-outline-path-prefix
- (file-name buffer-file-name)
- (file-name-nondirectory (file-name-nondirectory buffer-file-name))
- (buffer-name (buffer-name))))
-
-(defvar counsel-outline-settings
- '((emacs-lisp-mode
- :outline-regexp ";;[;*]+[\s\t]+"
- :outline-level counsel-outline-level-emacs-lisp)
- (org-mode
- :outline-title counsel-outline-title-org
- :action counsel-org-goto-action
- :history counsel-org-goto-history
- :caller counsel-org-goto)
- ;; markdown-mode package
- (markdown-mode
- :outline-title counsel-outline-title-markdown)
- ;; Built-in mode or AUCTeX package
- (latex-mode
- :outline-title counsel-outline-title-latex))
- "Alist mapping major modes to their `counsel-outline' settings.
-
-Each entry is a pair (MAJOR-MODE . PLIST). `counsel-outline'
-checks whether an entry exists for the current buffer's
-MAJOR-MODE and, if so, loads the settings specified by PLIST
-instead of the default settings. The following settings are
-recognized:
-
-- `:outline-regexp' is a regexp to match the beginning of an
- outline heading. It is only checked at the start of a line and
- so need not start with \"^\".
- Defaults to the value of the variable `outline-regexp'.
-
-- `:outline-level' is a function of no arguments which computes
- the level of an outline heading. It is called with point at
- the beginning of `outline-regexp' and with the match data
- corresponding to `outline-regexp'.
- Defaults to the value of the variable `outline-level'.
-
-- `:outline-title' is a function of no arguments which returns
- the title of an outline heading. It is called with point at
- the end of `outline-regexp' and with the match data
- corresponding to `outline-regexp'.
- Defaults to the function `counsel-outline-title'.
-
-- `:action' is a function of one argument, the selected outline
- heading to jump to. This setting corresponds directly to its
- eponymous `ivy-read' keyword, as used by `counsel-outline', so
- the type of the function's argument depends on the value
- returned by `counsel-outline-candidates'.
- Defaults to the function `counsel-outline-action'.
-
-- `:history' is a history list, usually a symbol representing a
- history list variable. It corresponds directly to its
- eponymous `ivy-read' keyword, as used by `counsel-outline'.
- Defaults to the symbol `counsel-outline-history'.
-
-- `:caller' is a symbol to uniquely identify the caller to
- `ivy-read'. It corresponds directly to its eponymous
- `ivy-read' keyword, as used by `counsel-outline'.
- Defaults to the symbol `counsel-outline'.
-
-- `:display-style' overrides the variable
- `counsel-outline-display-style'.
-
-- `:path-separator' overrides the variable
- `counsel-outline-path-separator'.
-
-- `:face-style' overrides the variable
- `counsel-outline-face-style'.
-
-- `:custom-faces' overrides the variable
- `counsel-outline-custom-faces'.")
-
-;;;###autoload
-(defun counsel-org-goto-all ()
- "Go to a different location in any org file."
- (interactive)
- (let (entries)
- (dolist (b (buffer-list))
- (with-current-buffer b
- (when (derived-mode-p 'org-mode)
- (setq entries
- (nconc entries
- (counsel-outline-candidates
- (cdr (assq 'org-mode counsel-outline-settings))
- (counsel-org-goto-all--outline-path-prefix)))))))
- (ivy-read "Goto: " entries
- :history 'counsel-org-goto-history
- :action #'counsel-org-goto-action
- :caller 'counsel-org-goto-all)))
-
-(defun counsel-org-goto-action (x)
- "Go to headline in candidate X."
- (org-goto-marker-or-bmk (cdr x)))
-
-(defun counsel--org-get-heading-args ()
- "Return list of arguments for `org-get-heading'.
-Try to return the right number of arguments for the current Org
-version. Argument values are based on the
-`counsel-org-headline-display-*' user options."
- (nbutlast (mapcar #'not (list counsel-org-headline-display-tags
- counsel-org-headline-display-todo
- counsel-org-headline-display-priority))
- (if (if (fboundp 'func-arity)
- (< (cdr (func-arity #'org-get-heading)) 3)
- (version< org-version "9.1.1"))
- 1 0)))
-
-;;** `counsel-org-file'
-(declare-function org-attach-dir "org-attach")
-(declare-function org-attach-file-list "org-attach")
-(defvar org-attach-directory)
-
-(defun counsel-org-files ()
- "Return list of all files under current Org attachment directories.
-Filenames returned are relative to `default-directory'. For each
-attachment directory associated with the current buffer, all
-contained files are listed, so the return value could conceivably
-include attachments of other Org buffers."
- (require 'org-attach)
- (let (dirs)
- (save-excursion
- (goto-char (point-min))
- (while (re-search-forward "^:\\(ATTACH_DIR\\|ID\\):[\t ]+\\(.*\\)$" nil
t)
- (let ((dir (org-attach-dir)))
- (when dir
- (push dir dirs)))))
- (cl-mapcan
- (lambda (dir)
- (mapcar (lambda (file)
- (file-relative-name (expand-file-name file dir)))
- (org-attach-file-list dir)))
- (nreverse dirs))))
-
-;;;###autoload
-(defun counsel-org-file ()
- "Browse all attachments for current Org file."
- (interactive)
- (ivy-read "file: " (counsel-org-files)
- :action #'counsel-locate-action-dired
- :caller 'counsel-org-file))
-
-;;** `counsel-org-entity'
-(defvar org-entities)
-(defvar org-entities-user)
-
-;;;###autoload
-(defun counsel-org-entity ()
- "Complete Org entities using Ivy."
- (interactive)
- (require 'org)
- (ivy-read "Entity: " (cl-loop for element in (append org-entities
org-entities-user)
- unless (stringp element)
- collect (cons
- (format "%20s | %20s | %20s | %s"
- (cl-first element) ; name
- (cl-second element) ; latex
- (cl-fourth element) ; html
- (cl-seventh element)) ; utf-8
- element))
- :require-match t
- :action '(1
- ("u" (lambda (candidate)
- (insert (cl-seventh (cdr candidate)))) "utf-8")
- ("o" (lambda (candidate)
- (insert "\\" (cl-first (cdr candidate))))
"org-entity")
- ("l" (lambda (candidate)
- (insert (cl-second (cdr candidate)))) "latex")
- ("h" (lambda (candidate)
- (insert (cl-fourth (cdr candidate)))) "html")
- ("a" (lambda (candidate)
- (insert (cl-fifth (cdr candidate)))) "ascii")
- ("L" (lambda (candidate)
- (insert (cl-sixth (cdr candidate))) "Latin-1")))))
-
-;;** `counsel-org-capture'
-(defvar org-capture-templates)
-(defvar org-capture-templates-contexts)
-(declare-function org-contextualize-keys "org")
-(declare-function org-capture-goto-last-stored "org-capture")
-(declare-function org-capture-goto-target "org-capture")
-(declare-function org-capture-upgrade-templates "org-capture")
-
-;;;###autoload
-(defun counsel-org-capture ()
- "Capture something."
- (interactive)
- (require 'org-capture)
- (ivy-read "Capture template: "
- (delq nil
- (mapcar
- (lambda (x)
- (when (> (length x) 2)
- (format "%-5s %s" (nth 0 x) (nth 1 x))))
- ;; We build the list of capture templates as in
- ;; `org-capture-select-template':
- (or (org-contextualize-keys
- (org-capture-upgrade-templates org-capture-templates)
- org-capture-templates-contexts)
- '(("t" "Task" entry (file+headline "" "Tasks")
- "* TODO %?\n %u\n %a")))))
- :require-match t
- :action (lambda (x)
- (org-capture nil (car (split-string x))))
- :caller 'counsel-org-capture))
-
-(ivy-configure 'counsel-org-capture
- :initial-input "^")
-
-(ivy-set-actions
- 'counsel-org-capture
- `(("t" ,(lambda (x)
- (org-capture-goto-target (car (split-string x))))
- "go to target")
- ("l" ,(lambda (_x)
- (org-capture-goto-last-stored))
- "go to last stored")
- ("p" ,(lambda (x)
- (org-capture 0 (car (split-string x))))
- "insert template at point")
- ("c" ,(lambda (_x)
- (customize-variable 'org-capture-templates))
- "customize org-capture-templates")))
-
-;;** `counsel-org-agenda-headlines'
-(defvar org-odd-levels-only)
-(declare-function org-set-startup-visibility "org")
-(declare-function org-show-entry "org")
-(declare-function org-map-entries "org")
-(declare-function org-heading-components "org")
-
-(defun counsel-org-agenda-headlines-action-goto (headline)
- "Go to the `org-mode' agenda HEADLINE."
- (find-file (nth 1 headline))
- (org-set-startup-visibility)
- (goto-char (nth 2 headline))
- (org-show-entry))
-
-(ivy-set-actions
- 'counsel-org-agenda-headlines
- '(("g" counsel-org-agenda-headlines-action-goto "goto headline")))
-
-(defvar counsel-org-agenda-headlines-history nil
- "History for `counsel-org-agenda-headlines'.")
-
-(defcustom counsel-outline-display-style 'path
- "The style used when displaying matched outline headings.
-
-If `headline', the title is displayed with leading stars
-indicating the outline level.
-
-If `path', the path hierarchy is displayed. For each entry the
-title is shown. Entries are separated with
-`counsel-outline-path-separator'.
-
-If `title' or any other value, only the title of the heading is
-displayed.
-
-For displaying tags and TODO keywords in `org-mode' buffers, see
-`counsel-org-headline-display-tags' and
-`counsel-org-headline-display-todo', respectively."
- :type '(choice
- (const :tag "Title only" title)
- (const :tag "Headline" headline)
- (const :tag "Path" path)))
-
-(defcustom counsel-outline-path-separator "/"
- "String separating path entries in matched outline headings.
-This variable has no effect unless
-`counsel-outline-display-style' is set to `path'."
- :type 'string)
-
-(declare-function org-get-outline-path "org")
-
-(defun counsel-org-agenda-headlines--candidates ()
- "Return a list of completion candidates for `counsel-org-agenda-headlines'."
- (org-map-entries
- (lambda ()
- (let* ((components (org-heading-components))
- (level (and (eq counsel-outline-display-style 'headline)
- (make-string
- (if org-odd-levels-only
- (nth 1 components)
- (nth 0 components))
- ?*)))
- (todo (and counsel-org-headline-display-todo
- (nth 2 components)))
- (path (and (eq counsel-outline-display-style 'path)
- (org-get-outline-path)))
- (priority (and counsel-org-headline-display-priority
- (nth 3 components)))
- (text (nth 4 components))
- (tags (and counsel-org-headline-display-tags
- (nth 5 components))))
- (list
- (mapconcat
- 'identity
- (cl-remove-if 'null
- (list
- level
- todo
- (and priority (format "[#%c]" priority))
- (mapconcat 'identity
- (append path (list text))
- counsel-outline-path-separator)
- tags))
- " ")
- buffer-file-name
- (point))))
- nil
- 'agenda))
-
-;;;###autoload
-(defun counsel-org-agenda-headlines ()
- "Choose from headers of `org-mode' files in the agenda."
- (interactive)
- (require 'org)
- (let ((minibuffer-allow-text-properties t))
- (ivy-read "Org headline: "
- (counsel-org-agenda-headlines--candidates)
- :action #'counsel-org-agenda-headlines-action-goto
- :history 'counsel-org-agenda-headlines-history
- :caller 'counsel-org-agenda-headlines)))
-
-;;* Misc. Emacs
-;;** `counsel-mark-ring'
-(defface counsel--mark-ring-highlight
- '((t (:inherit highlight)))
- "Face for current `counsel-mark-ring' line."
- :group 'ivy-faces)
-
-(defvar counsel--mark-ring-overlay nil
- "Internal overlay to highlight line by candidate of `counsel-mark-ring'.")
-
-(defun counsel--mark-ring-add-highlight ()
- "Add highlight to current line."
- (setq counsel--mark-ring-overlay
- (make-overlay (line-beginning-position) (1+ (line-end-position))))
- (with-ivy-window
- (overlay-put counsel--mark-ring-overlay 'face
- 'counsel--mark-ring-highlight)))
-
-(defun counsel--mark-ring-delete-highlight ()
- "If `counsel-mark-ring' have highlight, delete highlight."
- (if counsel--mark-ring-overlay (delete-overlay counsel--mark-ring-overlay)))
-
-(defvar counsel--mark-ring-calling-point 0
- "Internal variable to remember calling position.")
-
-(defun counsel--mark-ring-unwind ()
- "Return back to calling position of `counsel-mark-ring'."
- (goto-char counsel--mark-ring-calling-point)
- (counsel--mark-ring-delete-highlight))
-
-(defun counsel--mark-ring-update-fn ()
- "Show preview by candidate."
- (let ((pos (get-text-property 0 'point (ivy-state-current ivy-last))))
- (counsel--mark-ring-delete-highlight)
- (with-ivy-window
- (goto-char pos)
- (counsel--mark-ring-add-highlight))))
-
-;;;###autoload
-(defun counsel-mark-ring ()
- "Browse `mark-ring' interactively.
-Obeys `widen-automatically', which see."
- (interactive)
- (let* ((counsel--mark-ring-calling-point (point))
- (width (length (number-to-string (line-number-at-pos (point-max)))))
- (fmt (format "%%%dd %%s" width))
- (make-candidate
- (lambda (mark)
- (goto-char (marker-position mark))
- (let ((linum (line-number-at-pos))
- (line (buffer-substring
- (line-beginning-position) (line-end-position))))
- (propertize (format fmt linum line) 'point (point)))))
- (marks (copy-sequence mark-ring))
- (marks (delete-dups marks))
- (marks
- ;; mark-marker is empty?
- (if (equal (mark-marker) (make-marker))
- marks
- (cons (copy-marker (mark-marker)) marks)))
- (cands
- ;; Widen, both to save `line-number-at-pos' the trouble
- ;; and for `buffer-substring' to work.
- (save-excursion
- (save-restriction
- (widen)
- (mapcar make-candidate marks)))))
- (if cands
- (ivy-read "Mark: " cands
- :require-match t
- :action (lambda (cand)
- (let ((pos (get-text-property 0 'point cand)))
- (when pos
- (unless (<= (point-min) pos (point-max))
- (if widen-automatically
- (widen)
- (error "\
-Position of selected mark outside accessible part of buffer")))
- (goto-char pos))))
- :caller 'counsel-mark-ring)
- (message "Mark ring is empty"))))
-
-(ivy-configure 'counsel-mark-ring
- :update-fn #'counsel--mark-ring-update-fn
- :unwind-fn #'counsel--mark-ring-unwind
- :sort-fn #'ivy-string<)
-
-;;** `counsel-package'
-(defvar package--initialized)
-(defvar package-alist)
-(defvar package-archive-contents)
-(defvar package-archives)
-(defvar package-user-dir)
-(declare-function package-installed-p "package")
-(declare-function package-delete "package")
-(declare-function package-desc-extras "package")
-
-(defvar counsel-package-history nil
- "History for `counsel-package'.")
-
-(defun counsel--package-candidates ()
- "Return completion alist for `counsel-package'."
- (unless package--initialized
- (package-initialize t))
- (if (or (not package-archive-contents)
- (cl-find-if (lambda (package-archive)
- (let ((fname
- (format
- "%s/archives/%s/archive-contents"
- package-user-dir (car package-archive))))
- (or (not (file-exists-p fname))
- (counsel-file-stale-p fname (* 4 60 60)))))
- package-archives))
- (package-refresh-contents))
- (sort (mapcar (lambda (entry)
- (cons (let ((pkg (car entry)))
- (concat (if (package-installed-p pkg) "-" "+")
- (symbol-name pkg)))
- entry))
- package-archive-contents)
- #'counsel--package-sort))
-
-;;;###autoload
-(defun counsel-package ()
- "Install or delete packages.
-
-Packages not currently installed are prefixed with \"+\", and
-selecting one of these will try to install it.
-Packages currently installed are prefixed with \"-\", and
-selecting one of these will try to delete it.
-
-Additional actions:\\<ivy-minibuffer-map>
-
- \\[ivy-dispatching-done] d: Describe package
- \\[ivy-dispatching-done] h: Visit package's homepage"
- (interactive)
- (require 'package)
- (ivy-read "Packages (install +pkg or delete -pkg): "
- (counsel--package-candidates)
- :action #'counsel-package-action
- :require-match t
- :history 'counsel-package-history
- :caller 'counsel-package))
-
-(cl-pushnew '(counsel-package . "^+") ivy-initial-inputs-alist :key #'car)
-
-(defun counsel-package-action (package)
- "Delete or install PACKAGE."
- (setq package (cadr package))
- (if (package-installed-p package)
- (package-delete (cadr (assq package package-alist)))
- (package-install package)))
-
-(defun counsel-package-action-describe (package)
- "Call `describe-package' on PACKAGE."
- (describe-package (cadr package)))
-
-(defun counsel-package-action-homepage (package)
- "Open homepage for PACKAGE in a WWW browser."
- (let ((url (cdr (assq :url (package-desc-extras (nth 2 package))))))
- (if url
- (browse-url url)
- (message "No homepage specified for package `%s'" (nth 1 package)))))
-
-(defun counsel--package-sort (a b)
- "Sort function for `counsel-package' candidates."
- (let* ((a (car a))
- (b (car b))
- (a-inst (= (string-to-char a) ?+))
- (b-inst (= (string-to-char b) ?+)))
- (or (and a-inst (not b-inst))
- (and (eq a-inst b-inst) (string-lessp a b)))))
-
-(ivy-set-actions
- 'counsel-package
- '(("d" counsel-package-action-describe "describe package")
- ("h" counsel-package-action-homepage "open package homepage")))
-
-;;** `counsel-tmm'
-(defvar tmm-km-list nil)
-(declare-function tmm-get-keymap "tmm")
-(declare-function tmm--completion-table "tmm")
-(declare-function tmm-get-keybind "tmm")
-
-(defun counsel-tmm-prompt (menu)
- "Select and call an item from the MENU keymap."
- (let (out
- choice
- chosen-string)
- (setq tmm-km-list nil)
- (map-keymap (lambda (k v) (tmm-get-keymap (cons k v))) menu)
- (setq tmm-km-list (nreverse tmm-km-list))
- (setq out (ivy-read "Menu bar: " (tmm--completion-table tmm-km-list)
- :require-match t))
- (setq choice (cdr (assoc out tmm-km-list)))
- (setq chosen-string (car choice))
- (setq choice (cdr choice))
- (cond ((keymapp choice)
- (counsel-tmm-prompt choice))
- ((and choice chosen-string)
- (setq last-command-event chosen-string)
- (call-interactively choice)))))
-
-(defvar tmm-table-undef)
-
-;;;###autoload
-(defun counsel-tmm ()
- "Text-mode emulation of looking and choosing from a menu bar."
- (interactive)
- (require 'tmm)
- (run-hooks 'menu-bar-update-hook)
- (setq tmm-table-undef nil)
- (counsel-tmm-prompt (tmm-get-keybind [menu-bar])))
-
-;;** `counsel-yank-pop'
-(defcustom counsel-yank-pop-truncate-radius 2
- "Number of context lines around `counsel-yank-pop' candidates."
- :type 'integer)
-
-(defun counsel--yank-pop-truncate (str)
- "Truncate STR for use in `counsel-yank-pop'."
- (condition-case nil
- (let* ((lines (split-string str "\n" t))
- (n (length lines))
- (re (ivy-re-to-str ivy--old-re))
- (first-match (cl-position-if
- (lambda (s) (string-match re s))
- lines))
- (beg (max 0 (- first-match
- counsel-yank-pop-truncate-radius)))
- (end (min n (+ first-match
- counsel-yank-pop-truncate-radius
- 1)))
- (seq (cl-subseq lines beg end)))
- (if (null first-match)
- (error "Could not match %s" str)
- (when (> beg 0)
- (setcar seq (concat "[...] " (car seq))))
- (when (< end n)
- (setcar (last seq)
- (concat (car (last seq)) " [...]")))
- (mapconcat #'identity seq "\n")))
- (error str)))
-
-(defcustom counsel-yank-pop-separator "\n"
- "Separator for the kill ring strings in `counsel-yank-pop'."
- :type '(choice
- (const :tag "Plain" "\n")
- (const :tag "Dashes" "\n----\n")
- string))
-
-(defun counsel--yank-pop-format-function (cand-pairs)
- "Transform CAND-PAIRS into a string for `counsel-yank-pop'."
- (ivy--format-function-generic
- (lambda (str)
- (mapconcat
- (lambda (s)
- (ivy--add-face s 'ivy-current-match))
- (split-string
- (counsel--yank-pop-truncate str) "\n" t)
- "\n"))
- (lambda (str)
- (counsel--yank-pop-truncate str))
- cand-pairs
- (propertize counsel-yank-pop-separator 'face 'ivy-separator)))
-
-(defun counsel--yank-pop-position (s)
- "Return position of S in `kill-ring' relative to last yank."
- (or (cl-position s kill-ring-yank-pointer :test #'equal-including-properties)
- (cl-position s kill-ring-yank-pointer :test #'equal)
- (+ (or (cl-position s kill-ring :test #'equal-including-properties)
- (cl-position s kill-ring :test #'equal))
- (- (length kill-ring-yank-pointer)
- (length kill-ring)))))
-
-(defun counsel-string-non-blank-p (s)
- "Return non-nil if S includes non-blank characters.
-Newlines and carriage returns are considered blank."
- (not (string-match-p "\\`[\n\r[:blank:]]*\\'" s)))
-
-(defcustom counsel-yank-pop-filter #'counsel-string-non-blank-p
- "Unary filter function applied to `counsel-yank-pop' candidates.
-All elements of `kill-ring' for which this function returns nil
-will be destructively removed from `kill-ring' before completion.
-All blank strings are deleted from `kill-ring' by default."
- :type '(radio
- (function-item counsel-string-non-blank-p)
- (function-item identity)
- (function :tag "Other")))
-
-(defun counsel--yank-pop-kills ()
- "Return filtered `kill-ring' for `counsel-yank-pop' completion.
-Both `kill-ring' and `kill-ring-yank-pointer' may be
-destructively modified to eliminate duplicates under
-`equal-including-properties', satisfy `counsel-yank-pop-filter',
-and incorporate `interprogram-paste-function'."
- ;; Protect against `kill-ring' and result of
- ;; `interprogram-paste-function' both being nil
- (ignore-errors (current-kill 0))
- ;; Keep things consistent with the rest of Emacs
- (dolist (sym '(kill-ring kill-ring-yank-pointer))
- (set sym (cl-delete-duplicates
- (cl-delete-if-not counsel-yank-pop-filter (symbol-value sym))
- :test #'equal-including-properties :from-end t)))
- kill-ring)
-
-(defcustom counsel-yank-pop-after-point nil
- "Whether `counsel-yank-pop' yanks after point.
-Nil means `counsel-yank-pop' puts point at the end of the yanked
-text and mark at its beginning, as per the default \\[yank].
-Non-nil means `counsel-yank-pop' swaps the resulting point and
-mark, as per \\[universal-argument] \\[yank]."
- :type 'boolean)
-
-(defun counsel-yank-pop-action (s)
- "Like `yank-pop', but insert the kill corresponding to S.
-Signal a `buffer-read-only' error if called from a read-only
-buffer position."
- (with-ivy-window
- (barf-if-buffer-read-only)
- (setq last-command 'yank)
- (setq yank-window-start (window-start))
- (condition-case nil
- ;; Avoid unexpected additions to `kill-ring'
- (let (interprogram-paste-function)
- (yank-pop (counsel--yank-pop-position s)))
- (error
- (insert s)))
- (when (funcall (if counsel-yank-pop-after-point #'> #'<)
- (point) (mark t))
- (exchange-point-and-mark t))))
-
-(defun counsel-yank-pop-action-remove (s)
- "Remove all occurrences of S from the kill ring."
- (dolist (sym '(kill-ring kill-ring-yank-pointer))
- (set sym (cl-delete s (symbol-value sym)
- :test #'equal-including-properties)))
- ;; Update collection and preselect for next `ivy-call'
- (setf (ivy-state-collection ivy-last) kill-ring)
- (setf (ivy-state-preselect ivy-last)
- (nth (min ivy--index (1- (length kill-ring)))
- kill-ring))
- (ivy--reset-state ivy-last))
-
-(defun counsel-yank-pop-action-rotate (s)
- "Rotate the yanking point to S in the kill ring.
-See `current-kill' for how this interacts with the window system
-selection."
- (let ((i (counsel--yank-pop-position s)))
- ;; Avoid unexpected additions to `kill-ring'
- (let (interprogram-paste-function)
- (setf (ivy-state-preselect ivy-last) (current-kill i)))
- ;; Manually change window system selection because `current-kill' won't
- (when (and (zerop i)
- yank-pop-change-selection
- interprogram-cut-function)
- (funcall interprogram-cut-function (car kill-ring-yank-pointer))))
- (ivy--reset-state ivy-last))
-
-(defcustom counsel-yank-pop-preselect-last nil
- "Whether `counsel-yank-pop' preselects the last kill by default.
-
-The command `counsel-yank-pop' always preselects the same kill
-that `yank-pop' would have inserted, given the same prefix
-argument.
-
-When `counsel-yank-pop-preselect-last' is nil (the default), the
-prefix argument of `counsel-yank-pop' defaults to 1 (as per
-`yank-pop'), which causes the next-to-last kill to be
-preselected. Otherwise, the prefix argument defaults to 0, which
-results in the most recent kill being preselected."
- :type 'boolean)
-
-(autoload 'xor "array")
-
-;;;###autoload
-(defun counsel-yank-pop (&optional arg)
- "Ivy replacement for `yank-pop'.
-With a plain prefix argument (\\[universal-argument]),
-temporarily toggle the value of `counsel-yank-pop-after-point'.
-Any other value of ARG has the same meaning as in `yank-pop', but
-`counsel-yank-pop-preselect-last' determines its default value.
-See also `counsel-yank-pop-filter' for how to filter candidates.
-
-Note: Duplicate elements of `kill-ring' are always deleted."
- ;; Do not specify `*' to allow browsing `kill-ring' in read-only buffers
- (interactive "P")
- (let ((kills (or (counsel--yank-pop-kills)
- (error "Kill ring is empty or blank")))
- (preselect (let (interprogram-paste-function)
- (current-kill (cond ((nlistp arg)
- (prefix-numeric-value arg))
- (counsel-yank-pop-preselect-last 0)
- (t 1))
- t)))
- (counsel-yank-pop-after-point
- (xor (consp arg) counsel-yank-pop-after-point)))
- (unless (eq last-command 'yank)
- (push-mark))
- (ivy-read "kill-ring: " kills
- :require-match t
- :preselect preselect
- :action #'counsel-yank-pop-action
- :caller 'counsel-yank-pop)))
-
-(ivy-configure 'counsel-yank-pop
- :height 5
- :format-fn #'counsel--yank-pop-format-function)
-
-(ivy-set-actions
- 'counsel-yank-pop
- '(("d" counsel-yank-pop-action-remove "delete")
- ("r" counsel-yank-pop-action-rotate "rotate")))
-
-;;** `counsel-register'
-(defvar counsel-register-actions
- '(("\\`buffer position" . jump-to-register)
- ("\\`text" . insert-register)
- ("\\`rectangle" . insert-register)
- ("\\`window configuration" . jump-to-register)
- ("\\`frame configuration" . jump-to-register)
- ("\\`[-+]?[0-9]+\\(?:\\.[0-9]\\)?\\'" . insert-register)
- ("\\`the file" . jump-to-register)
- ("\\`keyboard macro" . jump-to-register)
- ("\\`file-query" . jump-to-register))
- "Alist of (REGEXP . FUNCTION) pairs for `counsel-register'.
-Selecting a register whose description matches REGEXP specifies
-FUNCTION as the action to take on the register.")
-
-(defvar counsel-register-history nil
- "History for `counsel-register'.")
-
-(defun counsel-register-action (register)
- "Default action for `counsel-register'.
-
-Call a function on REGISTER. The function is determined by
-matching the register's value description against a regexp in
-`counsel-register-actions'."
- (let* ((val (get-text-property 0 'register register))
- (desc (register-describe-oneline val))
- (action (cdr (cl-assoc-if (lambda (re) (string-match-p re desc))
- counsel-register-actions))))
- (if action
- (funcall action val)
- (error "No action was found for register %s"
- (single-key-description val)))))
-
-;;;###autoload
-(defun counsel-register ()
- "Interactively choose a register."
- (interactive)
- (ivy-read "Register: "
- (cl-mapcan
- (lambda (reg)
- (let ((s (funcall register-preview-function reg)))
- (setq s (substring s 0 (string-match-p "[ \t\n\r]+\\'" s)))
- (unless (string= s "")
- (put-text-property 0 1 'register (car reg) s)
- (list s))))
- register-alist)
- :require-match t
- :history 'counsel-register-history
- :action #'counsel-register-action
- :caller 'counsel-register))
-
-(ivy-configure 'counsel-register
- :sort-fn #'ivy-string<)
-
-;;** `counsel-evil-registers'
-;;;###autoload
-(defun counsel-evil-registers ()
- "Ivy replacement for `evil-show-registers'."
- (interactive)
- (if (fboundp 'evil-register-list)
- (ivy-read "evil-registers: "
- (cl-loop for (key . val) in (evil-register-list)
- collect (format "[%c]: %s" key (if (stringp val) val "")))
- :require-match t
- :action #'counsel-evil-registers-action
- :caller 'counsel-evil-registers)
- (user-error "Required feature `evil' not installed.")))
-(ivy-configure 'counsel-evil-registers
- :height 5
- :format-fn #'counsel--yank-pop-format-function)
-
-(defun counsel-evil-registers-action (s)
- "Paste contents of S, trimming the register part.
-
-S will be of the form \"[register]: content\"."
- (with-ivy-window
- (insert
- (replace-regexp-in-string "\\`\\[.*?\\]: " "" s))))
-
-;;** `counsel-imenu'
-(defvar imenu-auto-rescan)
-(defvar imenu-auto-rescan-maxout)
-(declare-function imenu--subalist-p "imenu")
-(declare-function imenu--make-index-alist "imenu")
-
-(defun counsel--imenu-candidates ()
- (unless (featurep 'imenu)
- (require 'imenu nil t))
- (let* ((imenu-auto-rescan t)
- (imenu-auto-rescan-maxout (if current-prefix-arg
- (buffer-size)
- imenu-auto-rescan-maxout))
- (items (imenu--make-index-alist t))
- (items (delete (assoc "*Rescan*" items) items))
- (items (counsel-imenu-categorize-functions items)))
- (counsel-imenu-get-candidates-from items)))
-
-(defun counsel-imenu-get-candidates-from (alist &optional prefix)
- "Create a list of (key . value) from ALIST.
-PREFIX is used to create the key."
- (cl-mapcan
- (lambda (elm)
- (if (imenu--subalist-p elm)
- (counsel-imenu-get-candidates-from
- (cl-loop for (e . v) in (cdr elm) collect
- (cons e (if (integerp v) (copy-marker v) v)))
- ;; pass the prefix to next recursive call
- (concat prefix (if prefix ".") (car elm)))
- (let ((key (concat
- (when prefix
- (concat
- (propertize prefix 'face 'ivy-grep-info)
- ": "))
- (car elm))))
- (list (cons key
- (cons key (if (overlayp (cdr elm))
- (overlay-start (cdr elm))
- (cdr elm))))))))
- alist))
-
-(defvar counsel-imenu-map
- (let ((map (make-sparse-keymap)))
- (define-key map (kbd "C-l") 'ivy-call-and-recenter)
- map))
-
-(defun counsel-imenu-categorize-functions (items)
- "Categorize all the functions of imenu."
- (let ((fns (cl-remove-if #'listp items :key #'cdr)))
- (if fns
- (nconc (cl-remove-if #'nlistp items :key #'cdr)
- `(("Functions" ,@fns)))
- items)))
-
-(defun counsel-imenu-action (x)
- (with-ivy-window
- (imenu (cdr x))))
-
-;;;###autoload
-(defun counsel-imenu ()
- "Jump to a buffer position indexed by imenu."
- (interactive)
- (ivy-read "imenu items: " (counsel--imenu-candidates)
- :preselect (thing-at-point 'symbol)
- :require-match t
- :action #'counsel-imenu-action
- :keymap counsel-imenu-map
- :caller 'counsel-imenu))
-
-;;** `counsel-list-processes'
-(defun counsel-list-processes-action-delete (x)
- "Delete process X."
- (delete-process x)
- (setf (ivy-state-collection ivy-last)
- (setq ivy--all-candidates
- (delete x ivy--all-candidates))))
-
-(defun counsel-list-processes-action-switch (x)
- "Switch to buffer of process X."
- (let* ((proc (get-process x))
- (buf (and proc (process-buffer proc))))
- (if buf
- (switch-to-buffer buf)
- (message "Process %s doesn't have a buffer" x))))
-
-;;;###autoload
-(defun counsel-list-processes ()
- "Offer completion for `process-list'.
-The default action deletes the selected process.
-An extra action allows to switch to the process buffer."
- (interactive)
- (with-temp-buffer
- (list-processes--refresh))
- (ivy-read "Process: " (mapcar #'process-name (process-list))
- :require-match t
- :action
- '(1
- ("o" counsel-list-processes-action-delete "kill")
- ("s" counsel-list-processes-action-switch "switch"))
- :caller 'counsel-list-processes))
-
-;;** `counsel-ace-link'
-(defun counsel-ace-link ()
- "Use Ivy completion for `ace-link'."
- (interactive)
- (let (collection action)
- (cond ((eq major-mode 'Info-mode)
- (setq collection 'ace-link--info-collect)
- (setq action 'ace-link--info-action))
- ((eq major-mode 'help-mode)
- (setq collection 'ace-link--help-collect)
- (setq action 'ace-link--help-action))
- ((eq major-mode 'woman-mode)
- (setq collection 'ace-link--woman-collect)
- (setq action 'ace-link--woman-action))
- ((eq major-mode 'eww-mode)
- (setq collection 'ace-link--eww-collect)
- (setq action 'ace-link--eww-action))
- ((eq major-mode 'compilation-mode)
- (setq collection 'ace-link--eww-collect)
- (setq action 'ace-link--compilation-action))
- ((eq major-mode 'org-mode)
- (setq collection 'ace-link--org-collect)
- (setq action 'ace-link--org-action)))
- (if (null collection)
- (error "%S is not supported" major-mode)
- (ivy-read "Ace-Link: " (funcall collection)
- :action (lambda (x) (funcall action (cdr x)))
- :require-match t
- :caller 'counsel-ace-link))))
-
-;;** `counsel-minibuffer-history'
-;;;###autoload
-(defun counsel-minibuffer-history ()
- "Browse minibuffer history."
- (interactive)
- (let ((enable-recursive-minibuffers t))
- (ivy-read "History: " (ivy-history-contents minibuffer-history-variable)
- :keymap ivy-reverse-i-search-map
- :action #'insert
- :caller 'counsel-minibuffer-history)))
-
-;;** `counsel-esh-history'
-(defun counsel--browse-history (ring)
- "Use Ivy to navigate through RING."
- (setq ivy-completion-beg (point))
- (setq ivy-completion-end (point))
- (ivy-read "History: " (ivy-history-contents ring)
- :keymap ivy-reverse-i-search-map
- :action #'ivy-completion-in-region-action
- :caller 'counsel-shell-history))
-
-(defvar eshell-history-ring)
-
-;;;###autoload
-(defun counsel-esh-history ()
- "Browse Eshell history."
- (interactive)
- (require 'em-hist)
- (counsel--browse-history eshell-history-ring))
-
-(defvar comint-input-ring)
-
-;;;###autoload
-(defun counsel-shell-history ()
- "Browse shell history."
- (interactive)
- (require 'comint)
- (counsel--browse-history comint-input-ring))
-
-(defvar slime-repl-input-history)
-
-;;;###autoload
-(defun counsel-slime-repl-history ()
- "Browse Slime REPL history."
- (interactive)
- (require 'slime-repl)
- (counsel--browse-history slime-repl-input-history))
-
-;;** `counsel-hydra-heads'
-(defvar hydra-curr-body-fn)
-(declare-function hydra-keyboard-quit "ext:hydra")
-
-;;;###autoload
-(defun counsel-hydra-heads ()
- "Call a head of the current/last hydra."
- (interactive)
- (let* ((base (substring
- (prin1-to-string hydra-curr-body-fn)
- 0 -4))
- (heads (eval (intern (concat base "heads"))))
- (keymap (eval (intern (concat base "keymap"))))
- (head-names
- (mapcar (lambda (x)
- (cons
- (if (nth 2 x)
- (format "[%s] %S (%s)" (nth 0 x) (nth 1 x) (nth 2 x))
- (format "[%s] %S" (nth 0 x) (nth 1 x)))
- (lookup-key keymap (kbd (nth 0 x)))))
- heads)))
- (ivy-read "head: " head-names
- :action (lambda (x) (call-interactively (cdr x))))
- (hydra-keyboard-quit)))
-;;** `counsel-semantic'
-(declare-function semantic-tag-start "semantic/tag")
-(declare-function semantic-tag-class "semantic/tag")
-(declare-function semantic-tag-name "semantic/tag")
-(declare-function semantic-tag-put-attribute "semantic/tag")
-(declare-function semantic-tag-get-attribute "semantic/tag")
-(declare-function semantic-fetch-tags "semantic")
-(declare-function semantic-format-tag-summarize "semantic/format")
-(declare-function semantic-active-p "semantic/fw")
-
-(defun counsel-semantic-action (x)
- "Got to semantic TAG."
- (goto-char (semantic-tag-start (cdr x))))
-
-(defvar counsel-semantic-history nil
- "History for `counsel-semantic'.")
-
-(defun counsel-semantic-format-tag (tag)
- "Return a pretty string representation of TAG."
- (let ((depth (or (semantic-tag-get-attribute tag :depth) 0))
- (parent (semantic-tag-get-attribute tag :parent)))
- (concat (make-string (* depth 2) ?\ )
- (if parent
- (concat "(" parent ") ")
- "")
- (semantic-format-tag-summarize tag nil t))))
-
-(defun counsel-flatten-forest (func treep forest)
- "Use FUNC and TREEP to flatten FOREST.
-FUNC is applied to each node.
-TREEP is used to expand internal nodes."
- (cl-labels ((reducer (forest out depth)
- (dolist (tree forest)
- (let ((this (cons (funcall func tree depth) out))
- (leafs (funcall treep tree)))
- (setq out
- (if leafs
- (reducer leafs this (1+ depth))
- this))))
- out))
- (nreverse (reducer forest nil 0))))
-
-(defun counsel-semantic-tags ()
- "Fetch semantic tags."
- (counsel-flatten-forest
- (lambda (tree depth)
- (semantic-tag-put-attribute tree :depth depth))
- (lambda (tag)
- (when (eq (semantic-tag-class tag) 'type)
- (let ((name (semantic-tag-name tag)))
- (mapcar
- (lambda (x) (semantic-tag-put-attribute x :parent name))
- (semantic-tag-get-attribute tag :members)))))
- (semantic-fetch-tags)))
-
-;;;###autoload
-(defun counsel-semantic ()
- "Jump to a semantic tag in the current buffer."
- (interactive)
- (let ((tags (mapcar
- (lambda (x)
- (cons
- (counsel-semantic-format-tag x)
- x))
- (counsel-semantic-tags))))
- (ivy-read "tag: " tags
- :action #'counsel-semantic-action
- :history 'counsel-semantic-history
- :caller 'counsel-semantic)))
-
-;;;###autoload
-(defun counsel-semantic-or-imenu ()
- (interactive)
- (require 'semantic/fw)
- (if (semantic-active-p)
- (counsel-semantic)
- (counsel-imenu)))
-
-;;** `counsel-outline'
-(defcustom counsel-outline-face-style nil
- "Determines how to style outline headings during completion.
-
-If `org', the faces `counsel-outline-1' through
-`counsel-outline-8' are applied in a similar way to Org.
-Note that no cycling is performed, so headings on levels 9 and
-higher are not styled.
-
-If `verbatim', the faces used in the buffer are applied. For
-simple headlines in `org-mode' buffers, this is usually the same
-as the `org' setting, except that it depends on how much of the
-buffer has been completely fontified. If your buffer exceeds a
-certain size, headlines are styled lazily depending on which
-parts of the tree are visible. Headlines which are not yet
-styled in the buffer will appear unstyled in the minibuffer as
-well. If your headlines contain parts which are fontified
-differently than the headline itself (e.g. TODO keywords, tags,
-links) and you want these parts to be styled properly, verbatim
-is the way to go; otherwise you are probably better off using the
-`org' setting instead.
-
-If `custom', the faces defined in `counsel-outline-custom-faces'
-are applied. Note that no cycling is performed, so if there is
-no face defined for a certain level, headlines on that level will
-not be styled.
-
-If `nil', all headlines are highlighted using
-`counsel-outline-default'.
-
-For displaying tags and TODO keywords in `org-mode' buffers, see
-`counsel-org-headline-display-tags' and
-`counsel-org-headline-display-todo', respectively."
- :type '(choice
- (const :tag "Same as org-mode" org)
- (const :tag "Verbatim" verbatim)
- (const :tag "Custom" custom)
- (const :tag "No style" nil)))
-
-(defcustom counsel-outline-custom-faces nil
- "List of faces for custom display of outline headings.
-
-Headlines on level N are fontified with the Nth entry of this
-list, starting with N = 1. Headline levels with no corresponding
-entry in this list will not be styled.
-
-This variable has no effect unless `counsel-outline-face-style'
-is set to `custom'."
- :type '(repeat face))
-
-(defun counsel-outline-title ()
- "Return title of current outline heading.
-Intended as a value for the `:outline-title' setting in
-`counsel-outline-settings', which see."
- (buffer-substring (point) (line-end-position)))
-
-(defun counsel-outline-title-org ()
- "Return title of current outline heading.
-Like `counsel-outline-title' (which see), but for `org-mode'
-buffers."
- (apply #'org-get-heading (counsel--org-get-heading-args)))
-
-(defun counsel-outline-title-markdown ()
- "Return title of current outline heading.
-Like `counsel-outline-title' (which see), but for
-`markdown-mode' (from the eponymous package) buffers."
- ;; `outline-regexp' is set by `markdown-mode' to match both setext
- ;; (underline) and atx (hash) headings (see
- ;; `markdown-regex-header').
- (or (match-string 1) ; setext heading title
- (match-string 5))) ; atx heading title
-
-(defun counsel-outline-title-latex ()
- "Return title of current outline heading.
-Like `counsel-outline-title' (which see), but for `latex-mode'
-buffers."
- ;; `outline-regexp' is set by `latex-mode' (see variable
- ;; `latex-section-alist' for the built-in mode or function
- ;; `LaTeX-outline-regexp' for the AUCTeX package) to match section
- ;; macros, in which case we get the section name, as well as
- ;; `\appendix', `\documentclass', `\begin{document}', and
- ;; `\end{document}', in which case we simply return that.
- (if (and (assoc (match-string 1) ; Macro name
- (or (bound-and-true-p LaTeX-section-list) ; AUCTeX
- (bound-and-true-p latex-section-alist))) ; Built-in
- (progn
- ;; Point is at end of macro name, skip stars and optional args
- (skip-chars-forward "*")
- (while (looking-at-p "\\[")
- (forward-list))
- ;; First mandatory arg should be section title
- (looking-at-p "{")))
- (buffer-substring (1+ (point)) (1- (progn (forward-list) (point))))
- (buffer-substring (line-beginning-position) (point))))
-
-(defun counsel-outline-level-emacs-lisp ()
- "Return level of current outline heading.
-Like `lisp-outline-level', but adapted for the `:outline-level'
-setting in `counsel-outline-settings', which see."
- (if (looking-at ";;\\([;*]+\\)")
- (- (match-end 1) (match-beginning 1))
- (funcall outline-level)))
-
-(defvar counsel-outline--preselect 0
- "Index of the preselected candidate in `counsel-outline'.")
-
-(defun counsel-outline-candidates (&optional settings prefix)
- "Return an alist of outline heading completion candidates.
-Each element is a pair (HEADING . MARKER), where the string
-HEADING is located at the position of MARKER. SETTINGS is a
-plist entry from `counsel-outline-settings', which see.
-PREFIX is a string prepended to all candidates."
- (let* ((bol-regex (concat "^\\(?:"
- (or (plist-get settings :outline-regexp)
- outline-regexp)
- "\\)"))
- (outline-title-fn (or (plist-get settings :outline-title)
- #'counsel-outline-title))
- (outline-level-fn (or (plist-get settings :outline-level)
- outline-level))
- (display-style (or (plist-get settings :display-style)
- counsel-outline-display-style))
- (path-separator (or (plist-get settings :path-separator)
- counsel-outline-path-separator))
- (face-style (or (plist-get settings :face-style)
- counsel-outline-face-style))
- (custom-faces (or (plist-get settings :custom-faces)
- counsel-outline-custom-faces))
- (stack-level 0)
- (orig-point (point))
- (stack (and prefix (list (counsel-outline--add-face
- prefix 0 face-style custom-faces))))
- cands name level marker)
- (save-excursion
- (setq counsel-outline--preselect 0)
- (goto-char (point-min))
- (while (re-search-forward bol-regex nil t)
- (save-excursion
- (setq name (or (save-match-data
- (funcall outline-title-fn))
- ""))
- (goto-char (match-beginning 0))
- (setq marker (point-marker))
- (setq level (funcall outline-level-fn))
- (cond ((eq display-style 'path)
- ;; Update stack. The empty entry guards against incorrect
- ;; headline hierarchies, e.g. a level 3 headline
- ;; immediately following a level 1 entry.
- (while (<= level stack-level)
- (pop stack)
- (cl-decf stack-level))
- (while (> level stack-level)
- (push "" stack)
- (cl-incf stack-level))
- (setf (car stack)
- (counsel-outline--add-face
- name level face-style custom-faces))
- (setq name (mapconcat #'identity
- (reverse stack)
- path-separator)))
- (t
- (when (eq display-style 'headline)
- (setq name (concat (make-string level ?*) " " name)))
- (setq name (counsel-outline--add-face
- name level face-style custom-faces))))
- (push (cons name marker) cands))
- (unless (or (string= name "")
- (< orig-point marker))
- (cl-incf counsel-outline--preselect))))
- (nreverse cands)))
-
-(defun counsel-outline--add-face (name level &optional face-style custom-faces)
- "Set the `face' property on headline NAME according to LEVEL.
-FACE-STYLE and CUSTOM-FACES override `counsel-outline-face-style'
-and `counsel-outline-custom-faces', respectively, which determine
-the face to apply."
- (let ((face (cl-case (or face-style counsel-outline-face-style)
- (verbatim)
- (custom (nth (1- level)
- (or custom-faces counsel-outline-custom-faces)))
- (org (format "counsel-outline-%d" level))
- (t 'counsel-outline-default))))
- (when face
- (put-text-property 0 (length name) 'face face name)))
- name)
-
-(defun counsel-outline-action (x)
- "Go to outline X."
- (goto-char (cdr x)))
-
-;;;###autoload
-(defun counsel-outline ()
- "Jump to an outline heading with completion."
- (interactive)
- (let ((settings (cdr (assq major-mode counsel-outline-settings))))
- (ivy-read "Outline: " (counsel-outline-candidates settings)
- :action (or (plist-get settings :action)
- #'counsel-outline-action)
- :history (or (plist-get settings :history)
- 'counsel-outline-history)
- :preselect (max (1- counsel-outline--preselect) 0)
- :caller (or (plist-get settings :caller)
- 'counsel-outline))))
-
-;;** `counsel-ibuffer'
-(defvar counsel-ibuffer--buffer-name nil
- "Name of the buffer to use for `counsel-ibuffer'.")
-
-;;;###autoload
-(defun counsel-ibuffer (&optional name)
- "Use ibuffer to switch to another buffer.
-NAME specifies the name of the buffer (defaults to \"*Ibuffer*\")."
- (interactive)
- (setq counsel-ibuffer--buffer-name (or name "*Ibuffer*"))
- (ivy-read "Switch to buffer: " (counsel-ibuffer--get-buffers)
- :history 'counsel-ibuffer-history
- :action #'counsel-ibuffer-visit-buffer
- :caller 'counsel-ibuffer))
-
-(declare-function ibuffer-update "ibuffer")
-(declare-function ibuffer-current-buffer "ibuffer")
-(declare-function ibuffer-forward-line "ibuffer")
-(defvar ibuffer-movement-cycle)
-
-(defun counsel-ibuffer--get-buffers ()
- "Return list of buffer-related lines in Ibuffer as strings."
- (let ((oldbuf (get-buffer counsel-ibuffer--buffer-name)))
- (unless oldbuf
- ;; Avoid messing with the user's precious window/frame configuration.
- (save-window-excursion
- (let ((display-buffer-overriding-action
- '(display-buffer-same-window (inhibit-same-window . nil))))
- (ibuffer nil counsel-ibuffer--buffer-name nil t))))
- (with-current-buffer counsel-ibuffer--buffer-name
- (when oldbuf
- ;; Forcibly update possibly stale existing buffer.
- (ibuffer-update nil t))
- (goto-char (point-min))
- (let ((ibuffer-movement-cycle nil)
- entries)
- (while (not (eobp))
- (ibuffer-forward-line 1 t)
- (let ((buf (ibuffer-current-buffer)))
- ;; We are only interested in buffers we can actually visit.
- ;; This filters out headings and other unusable entries.
- (when (buffer-live-p buf)
- (push (cons (buffer-substring-no-properties
- (line-beginning-position)
- (line-end-position))
- buf)
- entries))))
- (nreverse entries)))))
-
-(defun counsel-ibuffer-visit-buffer (x)
- "Switch to buffer of candidate X."
- (switch-to-buffer (cdr x)))
-
-(defun counsel-ibuffer-visit-buffer-other-window (x)
- "Switch to buffer of candidate X in another window."
- (switch-to-buffer-other-window (cdr x)))
-
-(defun counsel-ibuffer-visit-ibuffer (_)
- "Switch to Ibuffer buffer."
- (switch-to-buffer counsel-ibuffer--buffer-name))
-
-(ivy-set-actions
- 'counsel-ibuffer
- '(("j" counsel-ibuffer-visit-buffer-other-window "other window")
- ("v" counsel-ibuffer-visit-ibuffer "switch to Ibuffer")))
-
-;;** `counsel-switch-to-shell-buffer'
-(defun counsel--buffers-with-mode (mode)
- "Return names of buffers with MODE as their `major-mode'."
- (let (bufs)
- (dolist (buf (buffer-list))
- (when (eq (buffer-local-value 'major-mode buf) mode)
- (push (buffer-name buf) bufs)))
- (nreverse bufs)))
-
-(declare-function shell-mode "shell")
-
-;;;###autoload
-(defun counsel-switch-to-shell-buffer ()
- "Switch to a shell buffer, or create one."
- (interactive)
- (ivy-read "Shell buffer: " (counsel--buffers-with-mode #'shell-mode)
- :action #'counsel--switch-to-shell
- :caller 'counsel-switch-to-shell-buffer))
-
-(defun counsel--switch-to-shell (name)
- "Display shell buffer with NAME and select its window.
-Reuse any existing window already displaying the named buffer.
-If there is no such buffer, start a new `shell' with NAME."
- (if (get-buffer name)
- (pop-to-buffer name '((display-buffer-reuse-window
- display-buffer-same-window)
- (inhibit-same-window . nil)
- (reusable-frames . visible)))
- (shell name)))
-
-;;** `counsel-unicode-char'
-(defvar counsel-unicode-char-history nil
- "History for `counsel-unicode-char'.")
-
-(defun counsel--unicode-names ()
- "Return formatted and sorted list of `ucs-names'.
-The result of `ucs-names' is mostly, but not completely, sorted,
-so this function ensures lexicographic order."
- (let* (cands
- (table (ucs-names)) ; Either hash map or alist
- (fmt (lambda (name code) ; Common format function
- (let ((cand (format "%06X %-58s %c" code name code)))
- (put-text-property 0 1 'code code cand)
- (push cand cands)))))
- (if (not (hash-table-p table))
- ;; Support `ucs-names' returning an alist in Emacs < 26.
- ;; The result of `ucs-names' comes pre-reversed so no need to repeat.
- (dolist (entry table)
- (funcall fmt (car entry) (cdr entry)))
- (maphash fmt table)
- ;; Reverse to speed up sorting
- (setq cands (nreverse cands)))
- (sort cands #'string-lessp)))
-
-(defvar counsel--unicode-table
- (lazy-completion-table counsel--unicode-table counsel--unicode-names)
- "Lazy completion table for `counsel-unicode-char'.
-Candidates comprise `counsel--unicode-names', which see.")
-
-;;;###autoload
-(defun counsel-unicode-char (&optional count)
- "Insert COUNT copies of a Unicode character at point.
-COUNT defaults to 1."
- (interactive "p")
- (setq ivy-completion-beg (point))
- (setq ivy-completion-end (point))
- (ivy-read "Unicode name: " counsel--unicode-table
- :history 'counsel-unicode-char-history
- :action (lambda (name)
- (with-ivy-window
- (delete-region ivy-completion-beg ivy-completion-end)
- (setq ivy-completion-beg (point))
- (insert-char (get-text-property 0 'code name) count)
- (setq ivy-completion-end (point))))
- :caller 'counsel-unicode-char))
-
-(ivy-configure 'counsel-unicode-char
- :sort-fn #'ivy-string<)
-
-(defun counsel-unicode-copy (name)
- "Ivy action to copy the unicode from NAME to the kill ring."
- (kill-new (char-to-string (get-text-property 0 'code name))))
-
-(ivy-set-actions
- 'counsel-unicode-char
- '(("w" counsel-unicode-copy "copy")))
-
-;;** `counsel-colors'
-(defun counsel-colors-action-insert-hex (color)
- "Insert the hexadecimal RGB value of COLOR."
- (insert (get-text-property 0 'hex color)))
-
-(defun counsel-colors-action-kill-hex (color)
- "Kill the hexadecimal RGB value of COLOR."
- (kill-new (get-text-property 0 'hex color)))
-
-;;** `counsel-colors-emacs'
-(defvar counsel-colors-emacs-history ()
- "History for `counsel-colors-emacs'.")
-
-(defun counsel-colors--name-to-hex (name)
- "Return hexadecimal RGB value of color with NAME.
-
-Return nil if NAME does not designate a valid color."
- (let ((rgb (color-name-to-rgb name)))
- (when rgb
- (apply #'color-rgb-to-hex rgb))))
-
-(defvar shr-color-visible-luminance-min)
-(declare-function shr-color-visible "shr-color")
-(defvar counsel--colors-format "%-20s %s %s%s")
-
-(defun counsel--colors-emacs-format-function (colors)
- "Format function for `counsel-colors-emacs'."
- (require 'shr-color)
- (let* ((blank (make-string 10 ?\s))
- (formatter
- (lambda (color)
- (let ((fg (list :foreground color)))
- (format counsel--colors-format color
- (propertize (get-text-property 0 'hex color) 'face fg)
- (propertize blank 'face (list :background color))
- (propertize (mapconcat (lambda (dup)
- (concat " " dup))
- (get-text-property 0 'dups color)
- ",")
- 'face fg))))))
- (ivy--format-function-generic
- (lambda (color)
- (let* ((hex (get-text-property 0 'hex color))
- (shr-color-visible-luminance-min 100)
- (fg (cadr (shr-color-visible hex "black" t))))
- (propertize (funcall formatter color)
- 'face (list :foreground fg :background hex))))
- formatter colors "\n")))
-
-(defun counsel--colors-web-format-function (colors)
- "Format function for `counsel-colors-web'."
- (require 'shr-color)
- (let* ((blank (make-string 10 ?\s))
- (formatter (lambda (color)
- (let ((hex (get-text-property 0 'hex color)))
- (format counsel--colors-format color
- (propertize hex 'face (list :foreground hex))
- (propertize blank 'face (list :background
hex)))))))
- (ivy--format-function-generic
- (lambda (color)
- (let* ((hex (get-text-property 0 'hex color))
- (shr-color-visible-luminance-min 100)
- (fg (cadr (shr-color-visible hex "black" t))))
- (propertize (funcall formatter color)
- 'face (list :foreground fg :background hex))))
- formatter colors "\n")))
-
-;;;###autoload
-(defun counsel-colors-emacs ()
- "Show a list of all supported colors for a particular frame.
-
-You can insert or kill the name or hexadecimal RGB value of the
-selected color."
- (interactive)
- (let* ((colors
- (delete nil
- (mapcar (lambda (cell)
- (let* ((name (car cell))
- (dups (cdr cell))
- (hex (counsel-colors--name-to-hex name)))
- (when hex
- (propertize name 'hex hex 'dups dups))))
- (list-colors-duplicates))))
- (counsel--colors-format
- (format "%%-%ds %%s %%s%%s"
- (apply #'max 0 (mapcar #'string-width colors)))))
- (ivy-read "Emacs color: " colors
- :require-match t
- :history 'counsel-colors-emacs-history
- :action #'insert
- :caller 'counsel-colors-emacs)))
-(ivy-configure 'counsel-colors-emacs
- :format-fn #'counsel--colors-emacs-format-function)
-
-(ivy-set-actions
- 'counsel-colors-emacs
- '(("h" counsel-colors-action-insert-hex "insert hexadecimal value")
- ("H" counsel-colors-action-kill-hex "kill hexadecimal value")))
-
-;;** `counsel-colors-web'
-(defvar shr-color-html-colors-alist)
-
-(defun counsel-colors--web-alist ()
- "Return list of CSS colors for `counsel-colors-web'."
- (require 'shr-color)
- (let* ((alist (copy-alist shr-color-html-colors-alist))
- (mp (assoc "MediumPurple" alist))
- (pvr (assoc "PaleVioletRed" alist))
- (rp (assoc "RebeccaPurple" alist)))
- ;; Backport GNU Emacs bug#30377
- (when mp (setcdr mp "#9370db"))
- (when pvr (setcdr pvr "#db7093"))
- (unless rp (push (cons "rebeccapurple" "#663399") alist))
- (sort (mapcar (lambda (cell)
- (propertize (downcase (car cell))
- 'hex (downcase (cdr cell))))
- alist)
- #'string-lessp)))
-
-(defvar counsel-colors-web-history ()
- "History for `counsel-colors-web'.")
-
-;;;###autoload
-(defun counsel-colors-web ()
- "Show a list of all W3C web colors for use in CSS.
-
-You can insert or kill the name or hexadecimal RGB value of the
-selected color."
- (interactive)
- (let* ((colors (counsel-colors--web-alist))
- (counsel--colors-format
- (format "%%-%ds %%s %%s"
- (apply #'max 0 (mapcar #'string-width colors)))))
- (ivy-read "Web color: " colors
- :require-match t
- :history 'counsel-colors-web-history
- :action #'insert
- :caller 'counsel-colors-web)))
-
-(ivy-configure 'counsel-colors-web
- :sort-fn #'ivy-string<
- :format-fn #'counsel--colors-web-format-function)
-
-(ivy-set-actions
- 'counsel-colors-web
- '(("h" counsel-colors-action-insert-hex "insert hexadecimal value")
- ("H" counsel-colors-action-kill-hex "kill hexadecimal value")))
-
-;;** `counsel-fonts'
-(defvar counsel-fonts-history ()
- "History for `counsel-fonts'.")
-
-;;;###autoload
-(defun counsel-fonts ()
- "Show a list of all supported font families for a particular frame.
-
-You can insert or kill the name of the selected font."
- (interactive)
- (ivy-read "Font: " (delete-dups (font-family-list))
- :require-match t
- :history 'counsel-fonts-history
- :action #'insert
- :caller 'counsel-fonts))
-
-;;* Misc. OS
-;;** `counsel-rhythmbox'
-(declare-function dbus-call-method "dbus")
-(declare-function dbus-get-property "dbus")
-
-(defun counsel--run (&rest program-and-args)
- (let ((name (mapconcat #'identity program-and-args " ")))
- (apply #'start-process name nil program-and-args)
- name))
-
-(defun counsel--sl (cmd)
- "Shell command to list."
- (split-string (shell-command-to-string cmd) "\n" t))
-
-(defun counsel-rhythmbox-play-song (song)
- "Let Rhythmbox play SONG."
- (let ((first (string= (shell-command-to-string "pidof rhythmbox") ""))
- (service "org.gnome.Rhythmbox3")
- (path "/org/mpris/MediaPlayer2")
- (interface "org.mpris.MediaPlayer2.Player"))
- (when first
- (counsel--run "nohup" "rhythmbox")
- (sit-for 1.5))
- (dbus-call-method :session service path interface
- "OpenUri" (cdr song))
- (let ((id (and first
- (cdr (counsel--wmctrl-parse
- (shell-command-to-string
- "wmctrl -l -p | grep $(pidof rhythmbox)"))))))
- (when id
- (sit-for 0.2)
- (counsel--run "wmctrl" "-ic" id)))))
-
-(defun counsel-rhythmbox-enqueue-song (song)
- "Let Rhythmbox enqueue SONG."
- (let ((service "org.gnome.Rhythmbox3")
- (path "/org/gnome/Rhythmbox3/PlayQueue")
- (interface "org.gnome.Rhythmbox3.PlayQueue"))
- (dbus-call-method :session service path interface
- "AddToQueue" (cdr song))))
-
-(defun counsel-rhythmbox-toggle-shuffle (_song)
- "Toggle Rhythmbox shuffle setting."
- (let* ((old-order (counsel--command "dconf" "read"
"/org/gnome/rhythmbox/player/play-order"))
- (new-order (if (string= old-order "'shuffle'")
- "'linear'"
- "'shuffle'")))
- (counsel--command
- "dconf"
- "write"
- "/org/gnome/rhythmbox/player/play-order"
- new-order)
- (message (if (string= new-order "'shuffle'")
- "shuffle on"
- "shuffle off"))))
-
-(defvar counsel-rhythmbox-history nil
- "History for `counsel-rhythmbox'.")
-
-(defvar counsel-rhythmbox-songs nil)
-
-(defun counsel-rhythmbox-current-song ()
- "Return the currently playing song title."
- (ignore-errors
- (let* ((entry (dbus-get-property
- :session
- "org.mpris.MediaPlayer2.rhythmbox"
- "/org/mpris/MediaPlayer2"
- "org.mpris.MediaPlayer2.Player"
- "Metadata"))
- (artist (caar (cadr (assoc "xesam:artist" entry))))
- (album (cl-caadr (assoc "xesam:album" entry)))
- (title (cl-caadr (assoc "xesam:title" entry))))
- (format "%s - %s - %s" artist album title))))
-
-;;;###autoload
-(defun counsel-rhythmbox (&optional arg)
- "Choose a song from the Rhythmbox library to play or enqueue."
- (interactive "P")
- (require 'dbus)
- (when (or arg (null counsel-rhythmbox-songs))
- (let* ((service "org.gnome.Rhythmbox3")
- (path "/org/gnome/UPnP/MediaServer2/Library/all")
- (interface "org.gnome.UPnP.MediaContainer2")
- (nb-songs (dbus-get-property
- :session service path interface "ChildCount")))
- (if (not nb-songs)
- (error "Couldn't connect to Rhythmbox")
- (setq counsel-rhythmbox-songs
- (mapcar (lambda (x)
- (cons
- (format
- "%s - %s - %s"
- (cl-caadr (assoc "Artist" x))
- (cl-caadr (assoc "Album" x))
- (cl-caadr (assoc "DisplayName" x)))
- (cl-caaadr (assoc "URLs" x))))
- (dbus-call-method
- :session service path interface "ListChildren"
- 0 nb-songs '("*")))))))
- (ivy-read "Rhythmbox: " counsel-rhythmbox-songs
- :require-match t
- :history 'counsel-rhythmbox-history
- :preselect (counsel-rhythmbox-current-song)
- :action
- '(1
- ("p" counsel-rhythmbox-play-song "Play song")
- ("e" counsel-rhythmbox-enqueue-song "Enqueue song")
- ("s" counsel-rhythmbox-toggle-shuffle "Shuffle on/off"))
- :caller 'counsel-rhythmbox))
-
-;;** `counsel-linux-app'
-(require 'xdg nil t)
-
-(defalias 'counsel--xdg-data-home
- (if (fboundp 'xdg-data-home)
- #'xdg-data-home
- (lambda ()
- (let ((directory (getenv "XDG_DATA_HOME")))
- (if (or (null directory) (string= directory ""))
- "~/.local/share"
- directory))))
- "Compatibility shim for `xdg-data-home'.")
-
-(defalias 'counsel--xdg-data-dirs
- (if (fboundp 'xdg-data-dirs)
- #'xdg-data-dirs
- (lambda ()
- (let ((path (getenv "XDG_DATA_DIRS")))
- (if (or (null path) (string= path ""))
- '("/usr/local/share" "/usr/share")
- (parse-colon-path path)))))
- "Compatibility shim for `xdg-data-dirs'.")
-
-(defcustom counsel-linux-apps-directories
- (mapcar (lambda (dir) (expand-file-name "applications" dir))
- (cons (counsel--xdg-data-home)
- (counsel--xdg-data-dirs)))
- "Directories in which to search for applications (.desktop files)."
- :type '(repeat directory))
-
-(defcustom counsel-linux-app-format-function
#'counsel-linux-app-format-function-default
- "Function to format Linux application names the `counsel-linux-app' menu.
-The format function will be passed the application's name, comment, and command
-as arguments."
- :type '(choice
- (const :tag "Command : Name - Comment"
counsel-linux-app-format-function-default)
- (const :tag "Name - Comment (Command)"
counsel-linux-app-format-function-name-first)
- (const :tag "Name - Comment"
counsel-linux-app-format-function-name-only)
- (const :tag "Command" counsel-linux-app-format-function-command-only)
- (function :tag "Custom")))
-
-(defface counsel-application-name
- '((t :inherit font-lock-builtin-face))
- "Face for displaying executable names."
- :group 'ivy-faces)
-
-(defface counsel-outline-1
- '((t :inherit org-level-1))
- "Face for displaying level 1 headings."
- :group 'ivy-faces)
-
-(defface counsel-outline-2
- '((t :inherit org-level-2))
- "Face for displaying level 2 headings."
- :group 'ivy-faces)
-
-(defface counsel-outline-3
- '((t :inherit org-level-3))
- "Face for displaying level 3 headings."
- :group 'ivy-faces)
-
-(defface counsel-outline-4
- '((t :inherit org-level-4))
- "Face for displaying level 4 headings."
- :group 'ivy-faces)
-
-(defface counsel-outline-5
- '((t :inherit org-level-5))
- "Face for displaying level 5 headings."
- :group 'ivy-faces)
-
-(defface counsel-outline-6
- '((t :inherit org-level-6))
- "Face for displaying level 6 headings."
- :group 'ivy-faces)
-
-(defface counsel-outline-7
- '((t :inherit org-level-7))
- "Face for displaying level 7 headings."
- :group 'ivy-faces)
-
-(defface counsel-outline-8
- '((t :inherit org-level-8))
- "Face for displaying level 8 headings."
- :group 'ivy-faces)
-
-(defface counsel-outline-default
- '((t :inherit minibuffer-prompt))
- "Face for displaying headings."
- :group 'ivy-faces)
-
-(defvar counsel-linux-apps-faulty nil
- "List of faulty desktop files.")
-
-(defvar counsel--linux-apps-cache nil
- "Cache of desktop files data.")
-
-(defvar counsel--linux-apps-cached-files nil
- "List of cached desktop files.")
-
-(defvar counsel--linux-apps-cache-timestamp nil
- "Time when we last updated the cached application list.")
-
-(defvar counsel--linux-apps-cache-format-function nil
- "The function used to format the cached Linux application menu.")
-
-(defun counsel-linux-app-format-function-default (name comment exec)
- "Default Linux application name formatter.
-NAME is the name of the application, COMMENT its comment and EXEC
-the command to launch it."
- (format "% -45s: %s%s"
- (propertize
- (ivy--truncate-string exec 45)
- 'face 'counsel-application-name)
- name
- (if comment
- (concat " - " comment)
- "")))
-
-(defun counsel-linux-app-format-function-name-first (name comment exec)
- "Format Linux application names with the NAME (and COMMENT) first.
-EXEC is the command to launch the application."
- (format "%s%s (%s)"
- name
- (if comment
- (concat " - " comment)
- "")
- (propertize exec 'face 'counsel-application-name)))
-
-(defun counsel-linux-app-format-function-name-only (name comment _exec)
- "Format Linux application names with the NAME (and COMMENT) only."
- (format "%s%s"
- name
- (if comment
- (concat " - " comment)
- "")))
-
-(defun counsel-linux-app-format-function-command-only (_name _comment exec)
- "Display only the command EXEC when formatting Linux application names."
- exec)
-
-(defun counsel-linux-apps-list-desktop-files ()
- "Return an alist of all Linux applications.
-Each list entry is a pair of (desktop-name . desktop-file).
-This function always returns its elements in a stable order."
- (let ((hash (make-hash-table :test #'equal))
- result)
- (dolist (dir counsel-linux-apps-directories)
- (when (file-exists-p dir)
- (let ((dir (file-name-as-directory dir)))
- (dolist (file (directory-files-recursively dir ".*\\.desktop$"))
- (let ((id (subst-char-in-string ?/ ?- (file-relative-name file
dir))))
- (when (and (not (gethash id hash)) (file-readable-p file))
- (push (cons id file) result)
- (puthash id file hash)))))))
- result))
-
-(defun counsel-linux-app--parse-file (file)
- (with-temp-buffer
- (insert-file-contents file)
- (goto-char (point-min))
- (let ((start (re-search-forward "^\\[Desktop Entry\\] *$" nil t))
- (end (re-search-forward "^\\[" nil t))
- (visible t)
- name comment exec)
- (catch 'break
- (unless start
- (push file counsel-linux-apps-faulty)
- (message "Warning: File %s has no [Desktop Entry] group" file)
- (throw 'break nil))
-
- (goto-char start)
- (when (re-search-forward "^\\(Hidden\\|NoDisplay\\) *= *\\(1\\|true\\)
*$" end t)
- (setq visible nil))
- (setq name (match-string 1))
-
- (goto-char start)
- (unless (re-search-forward "^Type *= *Application *$" end t)
- (throw 'break nil))
- (setq name (match-string 1))
-
- (goto-char start)
- (unless (re-search-forward "^Name *= *\\(.+\\)$" end t)
- (push file counsel-linux-apps-faulty)
- (message "Warning: File %s has no Name" file)
- (throw 'break nil))
- (setq name (match-string 1))
-
- (goto-char start)
- (when (re-search-forward "^Comment *= *\\(.+\\)$" end t)
- (setq comment (match-string 1)))
-
- (goto-char start)
- (unless (re-search-forward "^Exec *= *\\(.+\\)$" end t)
- ;; Don't warn because this can technically be a valid desktop file.
- (throw 'break nil))
- (setq exec (match-string 1))
-
- (goto-char start)
- (when (re-search-forward "^TryExec *= *\\(.+\\)$" end t)
- (let ((try-exec (match-string 1)))
- (unless (locate-file try-exec exec-path nil #'file-executable-p)
- (throw 'break nil))))
- (propertize
- (funcall counsel-linux-app-format-function name comment exec)
- 'visible visible)))))
-
-(defun counsel-linux-apps-parse (desktop-entries-alist)
- "Parse the given alist of Linux desktop entries.
-Each entry in DESKTOP-ENTRIES-ALIST is a pair of ((id . file-name)).
-Any desktop entries that fail to parse are recorded in
-`counsel-linux-apps-faulty'."
- (let (result)
- (setq counsel-linux-apps-faulty nil)
- (dolist (entry desktop-entries-alist result)
- (let* ((id (car entry))
- (file (cdr entry))
- (r (counsel-linux-app--parse-file file)))
- (when r
- (push (cons r id) result))))))
-
-(defun counsel-linux-apps-list ()
- "Return list of all Linux desktop applications."
- (let* ((new-desktop-alist (counsel-linux-apps-list-desktop-files))
- (new-files (mapcar 'cdr new-desktop-alist)))
- (unless (and
- (eq counsel-linux-app-format-function
- counsel--linux-apps-cache-format-function)
- (equal new-files counsel--linux-apps-cached-files)
- (null (cl-find-if
- (lambda (file)
- (time-less-p
- counsel--linux-apps-cache-timestamp
- (nth 5 (file-attributes file))))
- new-files)))
- (setq counsel--linux-apps-cache (counsel-linux-apps-parse
new-desktop-alist))
- (setq counsel--linux-apps-cache-format-function
counsel-linux-app-format-function)
- (setq counsel--linux-apps-cache-timestamp (current-time))
- (setq counsel--linux-apps-cached-files new-files)))
- counsel--linux-apps-cache)
-
-
-(defun counsel-linux-app-action-default (desktop-shortcut)
- "Launch DESKTOP-SHORTCUT."
- (call-process "gtk-launch" nil 0 nil (cdr desktop-shortcut)))
-
-(defun counsel-linux-app-action-file (desktop-shortcut)
- "Launch DESKTOP-SHORTCUT with a selected file."
- (call-process "gtk-launch" nil 0 nil
- (cdr desktop-shortcut)
- (read-file-name "File: ")))
-
-(defun counsel-linux-app-action-open-desktop (desktop-shortcut)
- "Open DESKTOP-SHORTCUT."
- (let* ((app (cdr desktop-shortcut))
- (file (cdr (assoc app (counsel-linux-apps-list-desktop-files)))))
- (if file
- (find-file file)
- (error "Could not find location of file %s" app))))
-
-(ivy-set-actions
- 'counsel-linux-app
- '(("f" counsel-linux-app-action-file "run on a file")
- ("d" counsel-linux-app-action-open-desktop "open desktop file")))
-
-;;;###autoload
-(defun counsel-linux-app (&optional arg)
- "Launch a Linux desktop application, similar to Alt-<F2>.
-When ARG is non-nil, ignore NoDisplay property in *.desktop files."
- (interactive "P")
- (ivy-read "Run a command: " (counsel-linux-apps-list)
- :predicate (unless arg (lambda (x) (get-text-property 0 'visible
(car x))))
- :action #'counsel-linux-app-action-default
- :caller 'counsel-linux-app))
-
-;;** `counsel-wmctrl'
-(defun counsel-wmctrl-action (x)
- "Select the desktop window that corresponds to X."
- (counsel--run "wmctrl" "-i" "-a" (cdr x)))
-
-(defvar counsel-wmctrl-ignore '("XdndCollectionWindowImp"
- "unity-launcher" "unity-panel" "unity-dash"
- "Hud" "Desktop")
- "List of window titles to ignore for `counsel-wmctrl'.")
-
-(defun counsel--wmctrl-parse (s)
- (when (string-match "\\`\\([0-9a-fx]+\\) +\\([-0-9]+\\) +\\(?:[0-9]+\\)
+\\([^ ]+\\) \\(.+\\)$" s)
- (let ((title (match-string 4 s))
- (id (match-string 1 s)))
- (unless (member title counsel-wmctrl-ignore)
- (cons title id)))))
-
-;;;###autoload
-(defun counsel-wmctrl ()
- "Select a desktop window using wmctrl."
- (interactive)
- (let* ((cands1 (counsel--sl "wmctrl -l -p"))
- (cands2 (delq nil (mapcar #'counsel--wmctrl-parse cands1))))
- (ivy-read "window: " cands2
- :action #'counsel-wmctrl-action
- :caller 'counsel-wmctrl)))
-
-(defvar counsel--switch-buffer-temporary-buffers nil
- "Internal.")
-
-(defvar counsel--switch-buffer-previous-buffers nil
- "Internal.")
-
-(defun counsel--switch-buffer-unwind ()
- "Clear temporary file buffers and restore `buffer-list'.
-The buffers are those opened during a session of `counsel-switch-buffer'."
- (mapc #'kill-buffer counsel--switch-buffer-temporary-buffers)
- (mapc #'bury-buffer (cl-remove-if-not
- #'buffer-live-p
- counsel--switch-buffer-previous-buffers))
- (setq counsel--switch-buffer-temporary-buffers nil
- counsel--switch-buffer-previous-buffers nil))
-
-(defun counsel--switch-buffer-update-fn ()
- (unless counsel--switch-buffer-previous-buffers
- (setq counsel--switch-buffer-previous-buffers (buffer-list)))
- (let* ((current (ivy-state-current ivy-last))
- (virtual (assoc current ivy--virtual-buffers)))
- (cond
- ((get-buffer current)
- (ivy-call))
- ((and virtual (file-exists-p (cdr virtual)))
- (let ((buf (ignore-errors
- ;; may not open due to `large-file-warning-threshold' etc.
- (find-file-noselect (cdr virtual)))))
- (if buf
- (progn
- (push buf counsel--switch-buffer-temporary-buffers)
- (ivy-call))
- ;; clean up the minibuffer so that there's no delay before
- ;; the Ivy candidates are displayed once again
- (message ""))))
- (t
- (with-ivy-window
- (switch-to-buffer (ivy-state-buffer ivy-last)))))))
-
-;;;###autoload
-(defun counsel-switch-buffer ()
- "Switch to another buffer.
-Display a preview of the selected ivy completion candidate buffer
-in the current window."
- (interactive)
- (let ((ivy-update-fns-alist
- '((ivy-switch-buffer . counsel--switch-buffer-update-fn)))
- (ivy-unwind-fns-alist
- '((ivy-switch-buffer . counsel--switch-buffer-unwind))))
- (ivy-switch-buffer)))
-
-;;;###autoload
-(defun counsel-switch-buffer-other-window ()
- "Switch to another buffer in another window.
-Display a preview of the selected ivy completion candidate buffer
-in the current window."
- (interactive)
- (let ((ivy-update-fns-alist
- '((ivy-switch-buffer-other-window .
counsel--switch-buffer-update-fn)))
- (ivy-unwind-fns-alist
- '((ivy-switch-buffer-other-window . counsel--switch-buffer-unwind))))
- (ivy-switch-buffer-other-window)))
-
-(defun counsel-open-buffer-file-externally (buffer)
- "Open the file associated with BUFFER with an external program."
- (when (zerop (length buffer))
- (user-error "Can't open that"))
- (let* ((virtual (assoc buffer ivy--virtual-buffers))
- (filename (if virtual
- (cdr virtual)
- (buffer-file-name (get-buffer buffer)))))
- (unless filename
- (user-error "Can't open `%s' externally" buffer))
- (counsel-locate-action-extern (expand-file-name filename))))
-
-(ivy-add-actions
- 'ivy-switch-buffer
- '(("x" counsel-open-buffer-file-externally "open externally")))
-
-(ivy-set-actions
- 'counsel-switch-buffer
- '(("x" counsel-open-buffer-file-externally "open externally")
- ("j" ivy--switch-buffer-other-window-action "other window")))
-
-;;** `counsel-compile'
-(defvar counsel-compile-history nil
- "History for `counsel-compile'.
-
-This is a list of strings with additional properties which allow
-the history to be filtered depending on the context of the call.
-The properties include:
-
-`srcdir'
- the root directory of the source code
-`blddir'
- the root directory of the build (in or outside the `srcdir')
-`bldenv'
- the build environment as passed to `compilation-environment'
-`recursive'
- the completion should be run again in `blddir' of this result
-`cmd'
- if set, pass only the substring with this property to `compile'
-
-This variable is suitable for addition to
-`savehist-additional-variables'.")
-
-(defvar counsel-compile-root-functions
- '(counsel--project-current
- counsel--configure-root
- counsel--git-root
- counsel--dir-locals-root)
- "Special hook to find the project root for compile commands.
-Each function on this hook is called in turn with no arguments
-and should return either a directory, or nil if no root was
-found.")
-
-(defun counsel--compile-root ()
- "Return root of current project or signal an error on failure.
-The root is determined by `counsel-compile-root-functions'."
- (or (run-hook-with-args-until-success 'counsel-compile-root-functions)
- (error "Couldn't find project root")))
-
-(defun counsel--project-current ()
- "Return root of current project or nil on failure.
-Use `project-current' to determine the root."
- (and (fboundp 'project-current)
- (cdr (project-current))))
-
-(defun counsel--configure-root ()
- "Return root of current project or nil on failure.
-Use the presence of a \"configure\" file to determine the root."
- (counsel--dominating-file "configure"))
-
-(defun counsel--git-root ()
- "Return root of current project or nil on failure.
-Use the presence of a \".git\" file to determine the root."
- (counsel--dominating-file ".git"))
-
-(defun counsel--dir-locals-root ()
- "Return root of current project or nil on failure.
-Use the presence of a `dir-locals-file' to determine the root."
- (counsel--dominating-file dir-locals-file))
-
-(defvar counsel-compile-local-builds
- '(counsel-compile-get-filtered-history
- counsel-compile-get-build-directories
- counsel-compile-get-make-invocation)
- "Additional compile invocations to feed into `counsel-compile'.
-
-This can either be a list of compile invocation strings or
-functions that will provide such a list. You should customize
-this if you want to provide specific non-standard build types to
-`counsel-compile'. The default helpers are set up to handle
-common build environments.")
-
-(defcustom counsel-compile-make-args "-k"
- "Additional arguments for make.
-You may, for example, want to add \"-jN\" for the number of cores
-N in your system."
- :type 'string)
-
-(defcustom counsel-compile-env nil
- "List of environment variables for compilation to inherit.
-Each element should be a string of the form ENVVARNAME=VALUE. This
-list is passed to `compilation-environment'."
- :type '(repeat (string :tag "ENVVARNAME=VALUE")))
-
-(defvar counsel-compile-env-history nil
- "History for `counsel-compile-env'.")
-
-(defvar counsel-compile-env-pattern
- "[_[:digit:][:upper:]]+=[/[:alnum:]]*"
- "Pattern to match valid environment variables.")
-
-(defcustom counsel-compile-make-pattern "\\`\\(?:GNUm\\|[Mm]\\)akefile\\'"
- "Regexp for matching the names of Makefiles."
- :type 'regexp)
-
-(defcustom counsel-compile-build-directories
- '("build" "builds" "bld" ".build")
- "List of potential build subdirectory names to check for."
- :type '(repeat directory))
-
-(defvar counsel-compile-phony-pattern "^\\.PHONY:[\t ]+\\(.+\\)$"
- "Regexp for extracting phony targets from Makefiles.")
-
-;; This is loosely based on the Bash Make completion code
-(defun counsel-compile--probe-make-targets (dir)
- "Return a list of Make targets for DIR.
-
-Return an empty list is Make exits with an error. This might
-happen because some sort of configuration needs to be done first
-or the source tree is pristine and being used for multiple build
-trees."
- (let ((default-directory dir)
- (targets nil))
- (with-temp-buffer
- ;; 0 = no-rebuild, -q & 1 needs rebuild, 2 error (for GNUMake at
- ;; least)
- (when (< (call-process "make" nil t nil "-nqp") 2)
- (goto-char (point-min))
- (while (re-search-forward counsel-compile-phony-pattern nil t)
- (setq targets
- (nconc targets (split-string
- (match-string-no-properties 1)))))))
- (sort targets #'string-lessp)))
-
-(defun counsel-compile--pretty-propertize (leader text face)
- "Return a pretty string of the form \" LEADER TEXT\".
-LEADER is propertized with a warning face and the remaining
-text with FACE."
- (concat (propertize (concat " " leader " ")
- 'face
- 'font-lock-warning-face)
- (propertize text 'face face)))
-
-(defun counsel--compile-get-make-targets (srcdir &optional blddir)
- "Return a list of Make targets for a given SRCDIR/BLDDIR combination.
-
-We search the Makefile for a list of phony targets which are
-generally the top level targets a Make system provides.
-The resulting strings are tagged with properties that
-`counsel-compile-history' can use for filtering results."
- (let ((fmt (format (propertize "make %s %%s" 'cmd t)
- counsel-compile-make-args))
- (suffix (and blddir
- (counsel-compile--pretty-propertize "in" blddir
- 'dired-directory)))
- (build-env (and counsel-compile-env
- (counsel-compile--pretty-propertize
- "with"
- (mapconcat #'identity counsel-compile-env " ")
- 'font-lock-variable-name-face)))
- (props `(srcdir ,srcdir blddir ,blddir bldenv ,counsel-compile-env)))
- (mapcar (lambda (target)
- (setq target (concat (format fmt target) suffix build-env))
- (add-text-properties 0 (length target) props target)
- target)
- (counsel-compile--probe-make-targets (or blddir srcdir)))))
-
-(defun counsel-compile-get-make-invocation (&optional blddir)
- "Have a look in the root directory for any build control files.
-
-The optional BLDDIR is useful for other helpers that have found
-sub-directories that builds may be invoked in."
- (let ((srcdir (counsel--compile-root)))
- (when (directory-files (or blddir srcdir) nil
- counsel-compile-make-pattern t)
- (counsel--compile-get-make-targets srcdir blddir))))
-
-(defun counsel--find-build-subdir (srcdir)
- "Return builds subdirectory of SRCDIR, if one exists."
- (cl-some (lambda (dir)
- (setq dir (expand-file-name dir srcdir))
- (and (file-directory-p dir) dir))
- counsel-compile-build-directories))
-
-(defun counsel--get-build-subdirs (blddir)
- "Return all subdirs under BLDDIR sorted by modification time.
-If there are non-directory files in BLDDIR, include BLDDIR in the
-list as it may also be a build directory."
- (let* ((files (directory-files-and-attributes
- blddir t directory-files-no-dot-files-regexp t))
- (dirs (cl-remove-if-not #'cl-second files)))
- ;; Any non-dir files?
- (when (< (length dirs)
- (length files))
- (push (cons blddir (file-attributes blddir)) dirs))
- (mapcar #'car (sort dirs (lambda (x y)
- (time-less-p (nth 6 y) (nth 6 x)))))))
-
-(defun counsel-compile-get-build-directories (&optional dir)
- "Return a list of potential build directories."
- (let* ((srcdir (or dir (counsel--compile-root)))
- (blddir (counsel--find-build-subdir srcdir))
- (props `(srcdir ,srcdir recursive t))
- (fmt (concat (propertize "Select build in "
- 'face 'font-lock-warning-face)
- (propertize "%s" 'face 'dired-directory))))
- (mapcar (lambda (subdir)
- (let ((s (format fmt subdir)))
- (add-text-properties 0 (length s) `(blddir ,subdir ,@props) s)
- s))
- (and blddir (counsel--get-build-subdirs blddir)))))
-
-;; This is a workaround for the fact there is no concept of "project"
-;; local variables (as opposed to for example buffer-local). So we
-;; store all our history in a global list filter out the results we
-;; don't want.
-(defun counsel-compile-get-filtered-history (&optional dir)
- "Return a compile history relevant to current project."
- (let ((root (or dir (counsel--compile-root)))
- history)
- (dolist (item counsel-compile-history)
- (let ((srcdir (get-text-property 0 'srcdir item))
- (blddir (get-text-property 0 'blddir item)))
- (when (or (and srcdir (file-in-directory-p srcdir root))
- (and blddir (file-in-directory-p blddir root)))
- (push item history))))
- (nreverse history)))
-
-(defun counsel--get-compile-candidates (&optional dir)
- "Return the list of compile commands.
-This is determined by `counsel-compile-local-builds', which see."
- (let (cands)
- (dolist (cmds counsel-compile-local-builds)
- (when (functionp cmds)
- (setq cmds (funcall cmds dir)))
- (when cmds
- (push (if (listp cmds) cmds (list cmds)) cands)))
- (apply #'append (nreverse cands))))
-
-;; This is a workaround to ensure we tag all the relevant metadata in
-;; our compile history. This also allows M-x compile to do fancy
-;; things like infer `default-directory' from 'cd's in the string.
-(defun counsel-compile--update-history (_proc)
- "Update `counsel-compile-history' from the compilation state."
- (let* ((srcdir (counsel--compile-root))
- (blddir default-directory)
- (bldenv compilation-environment)
- (cmd (concat
- (propertize (car compilation-arguments) 'cmd t)
- (unless (file-equal-p blddir srcdir)
- (counsel-compile--pretty-propertize "in" blddir
- 'dired-directory))
- (when bldenv
- (counsel-compile--pretty-propertize "with"
- (mapconcat #'identity
bldenv " ")
-
'font-lock-variable-name-face)))))
- (add-text-properties 0 (length cmd)
- `(srcdir ,srcdir blddir ,blddir bldenv ,bldenv) cmd)
- (add-to-history 'counsel-compile-history cmd)))
-
-(defvar counsel-compile--current-build-dir nil
- "Tracks the last directory `counsel-compile' was called with.
-
-This state allows us to set it correctly if the user has manually
-edited the command, thus losing our embedded state.")
-
-(defun counsel-compile--action (cmd)
- "Process CMD to call `compile'.
-
-If CMD has the `recursive' property set we call `counsel-compile'
-again to further refine the compile options in the directory
-specified by the `blddir' property."
- (let ((blddir (get-text-property 0 'blddir cmd))
- (bldenv (get-text-property 0 'bldenv cmd)))
- (if (get-text-property 0 'recursive cmd)
- (counsel-compile blddir)
- (when (get-char-property 0 'cmd cmd)
- (setq cmd (substring-no-properties
- cmd 0 (next-single-property-change 0 'cmd cmd))))
- (let ((default-directory (or blddir
- counsel-compile--current-build-dir
- default-directory))
- (compilation-environment bldenv))
- ;; No need to specify `:history' because of this hook.
- (add-hook 'compilation-start-hook #'counsel-compile--update-history)
- (unwind-protect
- (compile cmd)
- (remove-hook 'compilation-start-hook
#'counsel-compile--update-history))))))
-
-;;;###autoload
-(defun counsel-compile (&optional dir)
- "Call `compile' completing with smart suggestions, optionally for DIR."
- (interactive)
- (setq counsel-compile--current-build-dir (or dir
- (counsel--compile-root)
- default-directory))
- (ivy-read "Compile command: "
- (delete-dups (counsel--get-compile-candidates dir))
- :action #'counsel-compile--action
- :caller 'counsel-compile))
-
-
-(defun counsel-compile-env--format-hint (cands)
- "Return a formatter for compile-env CANDS."
- (let ((rmstr
- (propertize "remove" 'face 'font-lock-warning-face))
- (addstr
- (propertize "add" 'face 'font-lock-variable-name-face)))
- (ivy--format-function-generic
- (lambda (selected)
- (format "%s %s"
- (if (member selected counsel-compile-env) rmstr addstr)
- selected))
- #'identity
- cands
- "\n")))
-
-(defun counsel-compile-env--update (var)
- "Update `counsel-compile-env' either adding or removing VAR."
- (cond ((member var counsel-compile-env)
- (setq counsel-compile-env (delete var counsel-compile-env)))
- ((string-match-p counsel-compile-env-pattern var)
- (push var counsel-compile-env))
- (t (user-error "Ignoring malformed variable: '%s'" var))))
-
-;;;###autoload
-(defun counsel-compile-env ()
- "Update `counsel-compile-env' interactively."
- (interactive)
- (ivy-read "Compile environment variable: "
- (delete-dups (append
- counsel-compile-env counsel-compile-env-history))
- :action #'counsel-compile-env--update
- :predicate (lambda (cand)
- (string-match-p counsel-compile-env-pattern
- cand))
- :history 'counsel-compile-env-history
- :caller 'counsel-compile-env))
-
-(ivy-configure 'counsel-compile-env
- :format-fn #'counsel-compile-env--format-hint)
-
-;;** `counsel-minor'
-(defvar counsel-minor-history nil
- "History for `counsel-minor'.")
-
-(defun counsel--minor-candidates ()
- "Return completion alist for `counsel-minor'.
-
-The alist element is cons of minor mode string with its lighter
-and minor mode symbol."
- (delq nil
- (mapcar
- (lambda (mode)
- (when (and (boundp mode) (commandp mode))
- (let ((lighter (alist-get mode minor-mode-alist)))
- (cons (concat
- (if (symbol-value mode) "-" "+")
- (symbol-name mode)
- (propertize
- (if lighter
- (format " \"%s\""
- (format-mode-line (cons t lighter)))
- "")
- 'face font-lock-string-face))
- mode))))
- minor-mode-list)))
-
-;;;###autoload
-(defun counsel-minor ()
- "Enable or disable minor mode.
-
-Disabled minor modes are prefixed with \"+\", and
-selecting one of these will enable it.
-Enabled minor modes are prefixed with \"-\", and
-selecting one of these will enable it.
-
-Additional actions:\\<ivy-minibuffer-map>
-
- \\[ivy-dispatching-done] d: Go to minor mode definition
- \\[ivy-dispatching-done] h: Describe minor mode"
-
- (interactive)
- (ivy-read "Minor modes (enable +mode or disable -mode): "
- (counsel--minor-candidates)
- :require-match t
- :history 'counsel-minor-history
- :action (lambda (x)
- (call-interactively (cdr x)))))
-
-(ivy-configure 'counsel-minor
- :initial-input "^+"
- :sort-fn #'ivy-string<)
-
-(ivy-set-actions
- 'counsel-minor
- `(("d" ,(lambda (x) (find-function (cdr x))) "definition")
- ("h" ,(lambda (x) (describe-function (cdr x))) "help")))
-
-;;;###autoload
-(defun counsel-major ()
- (interactive)
- (ivy-read "Major modes: " obarray
- :predicate (lambda (f)
- (and (commandp f) (string-match "-mode$" (symbol-name
f))
- (or (and (autoloadp (symbol-function f))
- (let ((doc-split (help-split-fundoc
(documentation f) f)))
- ;; major mode starters have no
arguments
- (and doc-split (null (cdr (read (car
doc-split)))))))
- (null (help-function-arglist f)))))
- :action #'counsel-M-x-action
- :caller 'counsel-major))
-
-;;* `counsel-google'
-(declare-function request "ext:request")
-(defun counsel-google-function (input)
- "Create a request to Google with INPUT.
-Return 0 tells `ivy--exhibit' not to update the minibuffer.
-We update it in the callback with `ivy-update-candidates'."
- (or
- (ivy-more-chars)
- (progn
- (require 'request)
- (require 'json)
- (request
- "http://suggestqueries.google.com/complete/search"
- :type "GET"
- :params (list
- (cons "client" "firefox")
- (cons "q" input))
- :parser 'json-read
- :success (cl-function
- (lambda (&key data &allow-other-keys)
- (ivy-update-candidates
- (mapcar #'identity (aref data 1))))))
- 0)))
-
-(defun counsel-google ()
- "Ivy interface for Google."
- (interactive)
- (ivy-read "search: " #'counsel-google-function
- :action (lambda (x)
- (browse-url (concat "https://www.google.com/search?q="
x)))
- :dynamic-collection t
- :caller 'counsel-google))
-
-;;* `counsel-mode'
-(defvar counsel-mode-map
- (let ((map (make-sparse-keymap)))
- (dolist (binding
- '((execute-extended-command . counsel-M-x)
- (describe-bindings . counsel-descbinds)
- (describe-function . counsel-describe-function)
- (describe-variable . counsel-describe-variable)
- (apropos-command . counsel-apropos)
- (describe-face . counsel-describe-face)
- (list-faces-display . counsel-faces)
- (find-file . counsel-find-file)
- (find-library . counsel-find-library)
- (imenu . counsel-imenu)
- (load-library . counsel-load-library)
- (load-theme . counsel-load-theme)
- (yank-pop . counsel-yank-pop)
- (info-lookup-symbol . counsel-info-lookup-symbol)
- (pop-to-mark-command . counsel-mark-ring)
- (bookmark-jump . counsel-bookmark)))
- (define-key map (vector 'remap (car binding)) (cdr binding)))
- map)
- "Map for `counsel-mode'.
-Remaps built-in functions to counsel replacements.")
-
-(defcustom counsel-mode-override-describe-bindings nil
- "Whether to override `describe-bindings' when `counsel-mode' is active."
- :type 'boolean)
-
-;;;###autoload
-(define-minor-mode counsel-mode
- "Toggle Counsel mode on or off.
-Turn Counsel mode on if ARG is positive, off otherwise. Counsel
-mode remaps built-in emacs functions that have counsel
-replacements.
-
-Local bindings (`counsel-mode-map'):
-\\{counsel-mode-map}"
- :global t
- :keymap counsel-mode-map
- :lighter " counsel"
- (if counsel-mode
- (progn
- (when (and (fboundp 'advice-add)
- counsel-mode-override-describe-bindings)
- (advice-add #'describe-bindings :override #'counsel-descbinds))
- (define-key minibuffer-local-map (kbd "C-r")
- 'counsel-minibuffer-history))
- (when (fboundp 'advice-remove)
- (advice-remove #'describe-bindings #'counsel-descbinds))))
-
-(provide 'counsel)
-
-;;; counsel.el ends here
diff --git a/packages/ivy/colir.el b/packages/ivy/colir.el
deleted file mode 100644
index 9e61273..0000000
--- a/packages/ivy/colir.el
+++ /dev/null
@@ -1,124 +0,0 @@
-;;; colir.el --- Color blending library -*- lexical-binding: t -*-
-
-;; Copyright (C) 2015-2019 Free Software Foundation, Inc.
-
-;; Author: Oleh Krehel <ohwoeowho@gmail.com>
-
-;; This file is part of GNU Emacs.
-
-;; This file 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, 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
-;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-;; GNU General Public License for more details.
-
-;; For a full copy of the GNU General Public License
-;; see <https://www.gnu.org/licenses/>.
-
-;;; Commentary:
-
-;; This package solves the problem of adding a face with a background
-;; to text which may already have a background. In all conflicting
-;; areas, instead of choosing either the original or the new
-;; background face, their blended sum is used.
-;;
-;; The blend mode functions are taken from URL
-;; `https://en.wikipedia.org/wiki/Blend_modes'.
-
-;;; Code:
-
-(require 'cl-lib)
-(require 'color)
-
-(defcustom colir-compose-method #'colir-compose-alpha
- "Select a method to compose two color channels."
- :group 'ivy
- :type '(radio
- (function-item colir-compose-alpha)
- (function-item colir-compose-overlay)
- (function-item colir-compose-soft-light)))
-
-(defun colir-compose-soft-light (a b)
- "Compose A and B channels."
- (if (< b 0.5)
- (+ (* 2 a b) (* a a (- 1 b b)))
- (+ (* 2 a (- 1 b)) (* (sqrt a) (- (* 2 b) 1)))))
-
-(defun colir-compose-overlay (a b)
- "Compose A and B channels."
- (if (< a 0.5)
- (* 2 a b)
- (- 1 (* 2 (- 1 a) (- 1 b)))))
-
-(defun colir-compose-alpha (a b &optional alpha gamma)
- "Compose A and B channels.
-Optional argument ALPHA is a number between 0.0 and 1.0 which corresponds
-to the influence of A on the result. Default value is 0.5.
-Optional argument GAMMA is used for gamma correction. Default value is 2.2."
- (setq alpha (or alpha 0.5))
- (setq gamma (or gamma 2.2))
- (+ (* (expt a gamma) alpha) (* (expt b gamma) (- 1 alpha))))
-
-(defun colir-blend (c1 c2)
- "Blend the two colors C1 and C2 using `colir-compose-method'.
-C1 and C2 are triples of floats in [0.0 1.0] range."
- (apply #'color-rgb-to-hex
- (cl-mapcar
- (if (eq (frame-parameter nil 'background-mode) 'dark)
- ;; this method works nicely for dark themes
- 'colir-compose-soft-light
- colir-compose-method)
- c1 c2)))
-
-(defun colir-color-parse (color)
- "Convert string COLOR to triple of floats in [0.0 1.0]."
- (if (string-match
"#\\([[:xdigit:]]\\{2\\}\\)\\([[:xdigit:]]\\{2\\}\\)\\([[:xdigit:]]\\{2\\}\\)"
color)
- (mapcar (lambda (v) (/ (string-to-number v 16) 255.0))
- (list (match-string 1 color) (match-string 2 color)
(match-string 3 color)))
- ;; does not work properly in terminal (maps color to nearest color
- ;; from available color palette).
- (color-name-to-rgb color)))
-
-(defun colir--blend-background (start next prevn face object)
- (let ((background-prev (face-background prevn)))
- (progn
- (put-text-property
- start next 'face
- (if background-prev
- (cons `(background-color
- . ,(colir-blend
- (colir-color-parse background-prev)
- (colir-color-parse (face-background face nil t))))
- prevn)
- (list face prevn))
- object))))
-
-(defun colir-blend-face-background (start end face &optional object)
- "Append to the face property of the text from START to END the face FACE.
-When the text already has a face with a non-plain background,
-blend it with the background of FACE.
-Optional argument OBJECT is the string or buffer containing the text.
-See also `font-lock-append-text-property'."
- (let (next prev prevn)
- (while (/= start end)
- (setq next (next-single-property-change start 'face object end))
- (setq prev (get-text-property start 'face object))
- (setq prevn (if (listp prev)
- (cl-find-if #'atom prev)
- prev))
- (cond
- ((or (keywordp (car-safe prev)) (consp (car-safe prev)))
- (put-text-property start next 'face (cons face prev) object))
- ((facep prevn)
- (colir--blend-background start next prevn face object))
- (t
- (put-text-property start next 'face face object)))
- (setq start next))))
-
-(provide 'colir)
-
-;;; colir.el ends here
diff --git a/packages/ivy/dir b/packages/ivy/dir
deleted file mode 100644
index b68b083..0000000
--- a/packages/ivy/dir
+++ /dev/null
@@ -1,18 +0,0 @@
-This is the file .../info/dir, which contains the
-topmost node of the Info hierarchy, called (dir)Top.
-The first time you invoke Info you start off looking at this node.
-
-File: dir, Node: Top This is the top of the INFO tree
-
- This (the Directory node) gives a menu of major topics.
- Typing "q" exits, "H" lists all Info commands, "d" returns here,
- "h" gives a primer for first-timers,
- "mEmacs<Return>" visits the Emacs manual, etc.
-
- In Emacs, you can click mouse button 2 on a menu item or cross reference
- to select it.
-
-* Menu:
-
-Emacs
-* Ivy: (ivy). Using Ivy for completion.
diff --git a/packages/ivy/ivy-hydra.el b/packages/ivy/ivy-hydra.el
deleted file mode 100644
index ce31f2b..0000000
--- a/packages/ivy/ivy-hydra.el
+++ /dev/null
@@ -1,133 +0,0 @@
-;;; ivy-hydra.el --- Additional key bindings for Ivy -*- lexical-binding: t
-*-
-
-;; Copyright (C) 2015-2019 Free Software Foundation, Inc.
-
-;; Author: Oleh Krehel <ohwoeowho@gmail.com>
-;; URL: https://github.com/abo-abo/swiper
-;; Version: 0.13.0
-;; Package-Requires: ((emacs "24.5") (ivy "0.13.0") (hydra "0.15.0"))
-;; Keywords: convenience
-
-;; This file is part of GNU Emacs.
-
-;; This file 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, 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
-;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-;; GNU General Public License for more details.
-
-;; For a full copy of the GNU General Public License
-;; see <https://www.gnu.org/licenses/>.
-
-;;; Commentary:
-
-;; This package provides the `hydra-ivy/body' command, which is a
-;; quasi-prefix map, with many useful bindings. These bindings are
-;; shorter than usual, using mostly unprefixed keys.
-
-;;; Code:
-
-(require 'ivy)
-(require 'hydra)
-
-(defun ivy--matcher-desc ()
- "Return description of `ivy--regex-function'."
- (let ((cell (assq ivy--regex-function ivy-preferred-re-builders)))
- (if cell
- (cdr cell)
- "other")))
-
-(defhydra hydra-ivy (:hint nil
- :color pink)
- "
-^ ^ ^ ^ ^ ^ | ^Call^ ^ ^ | ^Cancel^ | ^Options^ | Action _w_/_s_/_a_:
%-14s(ivy-action-name)
-^-^-^-^-^-^-+-^-^---------^-^--+-^-^------+-^-^-------+-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^---------------------------
-^ ^ _k_ ^ ^ | _f_ollow occ_U_r | _i_nsert | _c_: calling %-5s(if ivy-calling
\"on\" \"off\") _C_ase-fold: %-10`ivy-case-fold-search
-_h_ ^+^ _l_ | _d_one ^ ^ | _o_ops | _M_: matcher
%-5s(ivy--matcher-desc)^^^^^^^^^^^^ _T_runcate: %-11`truncate-lines
-^ ^ _j_ ^ ^ | _g_o ^ ^ | ^ ^ | _<_/_>_:
shrink/grow^^^^^^^^^^^^^^^^^^^^^^^^^^^^ _D_efinition of this menu
-"
- ;; arrows
- ("h" ivy-beginning-of-buffer)
- ("j" ivy-next-line)
- ("k" ivy-previous-line)
- ("l" ivy-end-of-buffer)
- ;; mark
- ("m" ivy-mark)
- ("u" ivy-unmark)
- ("DEL" ivy-unmark-backward)
- ("t" ivy-toggle-marks)
- ;; actions
- ("o" keyboard-escape-quit :exit t)
- ("r" ivy-dispatching-done-hydra :exit t)
- ("C-g" keyboard-escape-quit :exit t)
- ("i" nil)
- ("C-o" nil)
- ("f" ivy-alt-done :exit nil)
- ("C-j" ivy-alt-done :exit nil)
- ("d" ivy-done :exit t)
- ("g" ivy-call)
- ("C-m" ivy-done :exit t)
- ("c" ivy-toggle-calling)
- ("M" ivy-rotate-preferred-builders)
- (">" ivy-minibuffer-grow)
- ("<" ivy-minibuffer-shrink)
- ("w" ivy-prev-action)
- ("s" ivy-next-action)
- ("a" (let ((ivy-read-action-function #'ivy-read-action-by-key))
- (ivy-read-action)))
- ("T" (setq truncate-lines (not truncate-lines)))
- ("C" ivy-toggle-case-fold)
- ("U" ivy-occur :exit t)
- ("D" (ivy-exit-with-action
- (lambda (_) (find-function 'hydra-ivy/body)))
- :exit t))
-
-(defvar ivy-dispatching-done-columns 2
- "Number of columns to use if the hint does not fit on one line.")
-
-(defvar ivy-dispatching-done-idle nil
- "When non-nil, the hint will be delayed by this many seconds.")
-
-(defvar ivy-dispatching-done-hydra-exit-keys '(("M-o" nil "back")
- ("C-g" nil))
- "Keys that can be used to exit `ivy-dispatching-done-hydra'.")
-
-(defun ivy-dispatching-done-hydra ()
- "Select one of the available actions and call `ivy-done'."
- (interactive)
- (let* ((actions (ivy-state-action ivy-last))
- (extra-actions ivy-dispatching-done-hydra-exit-keys)
- (doc (concat "action: "
- (mapconcat
- (lambda (x) (format "[%s] %s" (nth 0 x) (nth 2 x)))
- (append (cdr actions)
- extra-actions) ", ")))
- (estimated-len (length doc))
- (n-columns (if (> estimated-len (window-width))
- ivy-dispatching-done-columns
- nil))
- (i 0))
- (if (null (ivy--actionp actions))
- (ivy-done)
- (funcall
- (eval
- `(defhydra ivy-read-action (:color teal :columns ,n-columns :idle
,ivy-dispatching-done-idle)
- "action"
- ,@(mapcar (lambda (x)
- (list (nth 0 x)
- `(progn
- (setcar (ivy-state-action ivy-last) ,(cl-incf
i))
- (ivy-done))
- (nth 2 x)))
- (cdr actions))
- ,@extra-actions))))))
-
-(setq ivy-read-action-function (lambda (_) (ivy-dispatching-done-hydra)))
-
-(provide 'ivy-hydra)
-
-;;; ivy-hydra.el ends here
diff --git a/packages/ivy/ivy-overlay.el b/packages/ivy/ivy-overlay.el
deleted file mode 100644
index 7a77bcf..0000000
--- a/packages/ivy/ivy-overlay.el
+++ /dev/null
@@ -1,154 +0,0 @@
-;;; ivy-overlay.el --- Overlay display functions for Ivy -*- lexical-binding:
t -*-
-
-;; Copyright (C) 2016-2019 Free Software Foundation, Inc.
-
-;; Author: Oleh Krehel <ohwoeowho@gmail.com>
-;; Keywords: convenience
-
-;; 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
-;; 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 <https://www.gnu.org/licenses/>.
-
-;;; Commentary:
-
-;; This package allows to setup Ivy's completion at point to actually
-;; show the candidates and the input at point, instead of in the
-;; minibuffer.
-
-;;; Code:
-
-(defface ivy-cursor
- '((((class color) (background light))
- :background "black" :foreground "white")
- (((class color) (background dark))
- :background "white" :foreground "black"))
- "Cursor face for inline completion."
- :group 'ivy-faces)
-
-(defvar ivy--old-cursor-type t)
-
-(defvar ivy-overlay-at nil
- "Overlay variable for `ivy-display-function-overlay'.")
-
-(declare-function ivy--truncate-string "ivy")
-
-(defun ivy-left-pad (str width)
- "Return STR, but with each line indented by WIDTH spaces.
-Lines are truncated to the window width."
- (let ((padding (make-string width ?\s)))
- (mapconcat (lambda (x)
- (ivy--truncate-string (concat padding x)
- (1- (+ (window-width)
- (window-hscroll)))))
- (split-string str "\n")
- "\n")))
-
-(defun ivy-overlay-cleanup ()
- "Clean up after `ivy-display-function-overlay'."
- (when (overlayp ivy-overlay-at)
- (delete-overlay ivy-overlay-at)
- (setq ivy-overlay-at nil))
- (unless cursor-type
- (setq cursor-type ivy--old-cursor-type))
- (when (fboundp 'company-abort)
- (company-abort)))
-
-(defvar ivy-height)
-
-(defun ivy-overlay-show-after (str)
- "Display STR in an overlay at point.
-
-First, fill each line of STR with spaces to the current column.
-Then attach the overlay to the character before point."
- (if ivy-overlay-at
- (progn
- (move-overlay ivy-overlay-at (1- (point)) (line-end-position))
- (overlay-put ivy-overlay-at 'invisible nil))
- (let ((available-height (count-lines (point) (window-end nil t))))
- (unless (>= available-height ivy-height)
- (recenter (- (window-height) ivy-height 2))))
- (setq ivy-overlay-at (make-overlay (1- (point)) (line-end-position)))
- ;; Specify face to avoid clashing with other overlays.
- (overlay-put ivy-overlay-at 'face 'default)
- (overlay-put ivy-overlay-at 'priority 9999))
- (overlay-put ivy-overlay-at 'display str)
- (overlay-put ivy-overlay-at 'after-string ""))
-
-(declare-function org-current-level "org")
-(declare-function org-at-heading-p "org")
-(defvar org-indent-indentation-per-level)
-(defvar ivy-height)
-(defvar ivy-last)
-(defvar ivy-text)
-(defvar ivy-completion-beg)
-(declare-function ivy-add-face-text-property "ivy")
-(declare-function ivy--get-window "ivy")
-(declare-function ivy-state-current "ivy")
-(declare-function ivy-state-window "ivy")
-(declare-function ivy--remove-prefix "ivy")
-
-(defun ivy-overlay-impossible-p (_str)
- (or
- (and (eq major-mode 'org-mode)
- (plist-get (text-properties-at (point)) 'src-block))
- (<= (window-height) (+ ivy-height 2))
- (= (point) (point-min))
- (< (- (+ (window-width) (window-hscroll)) (current-column))
- 30)))
-
-(defun ivy-display-function-overlay (str)
- "Called from the minibuffer, display STR in an overlay in Ivy window.
-Hide the minibuffer contents and cursor."
- (if (save-selected-window
- (select-window (ivy-state-window ivy-last))
- (ivy-overlay-impossible-p str))
- (let ((buffer-undo-list t))
- (save-excursion
- (forward-line 1)
- (insert str)))
- (ivy-add-face-text-property (minibuffer-prompt-end) (point-max)
- '(:foreground "white"))
- (setq cursor-type nil)
- (with-selected-window (ivy--get-window ivy-last)
- (when cursor-type
- (setq ivy--old-cursor-type cursor-type))
- (setq cursor-type nil)
- (let ((overlay-str
- (apply
- #'concat
- (buffer-substring (max (point-min) (1- (point))) (point))
- ivy-text
- (and (eolp) " ")
- (buffer-substring (point) (line-end-position))
- (and (> (length str) 0)
- (list "\n"
- (ivy-left-pad
- (ivy--remove-prefix "\n" str)
- (+
- (if (and (eq major-mode 'org-mode)
- (bound-and-true-p org-indent-mode))
- (if (org-at-heading-p)
- (1- (org-current-level))
- (* org-indent-indentation-per-level
(org-current-level)))
- 0)
- (save-excursion
- (when ivy-completion-beg
- (goto-char ivy-completion-beg))
- (current-column)))))))))
- (let ((cursor-offset (1+ (length ivy-text))))
- (ivy-add-face-text-property cursor-offset (1+ cursor-offset)
- 'ivy-cursor overlay-str t))
- (ivy-overlay-show-after overlay-str)))))
-
-(provide 'ivy-overlay)
-
-;;; ivy-overlay.el ends here
diff --git a/packages/ivy/ivy.el b/packages/ivy/ivy.el
deleted file mode 100644
index 04ef620..0000000
--- a/packages/ivy/ivy.el
+++ /dev/null
@@ -1,5056 +0,0 @@
-;;; ivy.el --- Incremental Vertical completYon -*- lexical-binding: t -*-
-
-;; Copyright (C) 2015-2019 Free Software Foundation, Inc.
-
-;; Author: Oleh Krehel <ohwoeowho@gmail.com>
-;; URL: https://github.com/abo-abo/swiper
-;; Version: 0.13.1
-;; Package-Requires: ((emacs "24.5"))
-;; Keywords: matching
-
-;; This file is part of GNU Emacs.
-
-;; This file 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, 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
-;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-;; GNU General Public License for more details.
-
-;; For a full copy of the GNU General Public License
-;; see <https://www.gnu.org/licenses/>.
-
-;;; Commentary:
-
-;; This package provides `ivy-read' as an alternative to
-;; `completing-read' and similar functions.
-;;
-;; There's no intricate code to determine the best candidate.
-;; Instead, the user can navigate to it with `ivy-next-line' and
-;; `ivy-previous-line'.
-;;
-;; The matching is done by splitting the input text by spaces and
-;; re-building it into a regex.
-;; So "for example" is transformed into "\\(for\\).*\\(example\\)".
-
-;;; Code:
-
-(require 'cl-lib)
-(require 'ivy-overlay)
-(require 'colir)
-(require 'ring)
-
-;;* Customization
-(defgroup ivy nil
- "Incremental vertical completion."
- :group 'convenience)
-
-(defgroup ivy-faces nil
- "Font-lock faces for `ivy'."
- :group 'ivy
- :group 'faces)
-
-(defface ivy-current-match
- '((((class color) (background light))
- :background "#1a4b77" :foreground "white")
- (((class color) (background dark))
- :background "#65a7e2" :foreground "black"))
- "Face used by Ivy for highlighting the current match.")
-
-(defface ivy-minibuffer-match-highlight
- '((t :inherit highlight))
- "Face used by Ivy for highlighting the match under the cursor.")
-
-(defface ivy-minibuffer-match-face-1
- '((((class color) (background light))
- :background "#d3d3d3")
- (((class color) (background dark))
- :background "#555555"))
- "The background face for `ivy' minibuffer matches.")
-
-(defface ivy-minibuffer-match-face-2
- '((((class color) (background light))
- :background "#e99ce8" :weight bold)
- (((class color) (background dark))
- :background "#777777" :weight bold))
- "Face for `ivy' minibuffer matches numbered 1 modulo 3.")
-
-(defface ivy-minibuffer-match-face-3
- '((((class color) (background light))
- :background "#bbbbff" :weight bold)
- (((class color) (background dark))
- :background "#7777ff" :weight bold))
- "Face for `ivy' minibuffer matches numbered 2 modulo 3.")
-
-(defface ivy-minibuffer-match-face-4
- '((((class color) (background light))
- :background "#ffbbff" :weight bold)
- (((class color) (background dark))
- :background "#8a498a" :weight bold))
- "Face for `ivy' minibuffer matches numbered 3 modulo 3.")
-
-(defface ivy-confirm-face
- '((t :foreground "ForestGreen" :inherit minibuffer-prompt))
- "Face used by Ivy for a confirmation prompt.")
-
-(defface ivy-match-required-face
- '((t :foreground "red" :inherit minibuffer-prompt))
- "Face used by Ivy for a match required prompt.")
-
-(defface ivy-subdir
- '((t :inherit dired-directory))
- "Face used by Ivy for highlighting subdirs in the alternatives.")
-
-(defface ivy-org
- '((t :inherit org-level-4))
- "Face used by Ivy for highlighting Org buffers in the alternatives.")
-
-(defface ivy-modified-buffer
- '((t :inherit default))
- "Face used by Ivy for highlighting modified file visiting buffers.")
-
-(defface ivy-modified-outside-buffer
- '((t :inherit default))
- "Face used by Ivy for highlighting file visiting buffers modified outside
Emacs.")
-
-(defface ivy-remote
- '((((class color) (background light))
- :foreground "#110099")
- (((class color) (background dark))
- :foreground "#7B6BFF"))
- "Face used by Ivy for highlighting remotes in the alternatives.")
-
-(defface ivy-virtual
- '((t :inherit font-lock-builtin-face))
- "Face used by Ivy for matching virtual buffer names.")
-
-(defface ivy-action
- '((t :inherit font-lock-builtin-face))
- "Face used by Ivy for displaying keys in `ivy-read-action'.")
-
-(defface ivy-highlight-face
- '((t :inherit highlight))
- "Face used by Ivy to highlight certain candidates.")
-
-(defface ivy-prompt-match
- '((t :inherit ivy-current-match))
- "Face used by Ivy for highlighting the selected prompt line.")
-
-(defface ivy-separator
- '((t :inherit font-lock-doc-face))
- "Face for multiline source separator.")
-
-(defface ivy-grep-info
- '((t :inherit compilation-info))
- "Face for highlighting grep information such as file names.")
-
-(defface ivy-grep-line-number
- '((t :inherit compilation-line-number))
- "Face for displaying line numbers in grep messages.")
-
-(defface ivy-completions-annotations
- '((t :inherit completions-annotations))
- "Face for displaying completion annotations.")
-
-(defface ivy-yanked-word
- '((t :inherit highlight))
- "Face used to highlight yanked word.")
-
-;; Set default customization `:group' to `ivy' for the rest of the file.
-(setcdr (assoc load-file-name custom-current-group-alist) 'ivy)
-
-(defcustom ivy-height 10
- "Number of lines for the minibuffer window.
-
-See also `ivy-height-alist'."
- :type 'integer)
-
-(defcustom ivy-count-format "%-4d "
- "The style to use for displaying the current candidate count for `ivy-read'.
-Set this to \"\" to suppress the count visibility.
-Set this to \"(%d/%d) \" to display both the index and the count."
- :type '(choice
- (const :tag "Count disabled" "")
- (const :tag "Count matches" "%-4d ")
- (const :tag "Count matches and show current match" "(%d/%d) ")
- string))
-
-(defcustom ivy-pre-prompt-function nil
- "When non-nil, add strings before the `ivy-read' prompt."
- :type '(choice
- (const :tag "Do nothing" nil)
- (function :tag "Custom function")))
-
-(defcustom ivy-add-newline-after-prompt nil
- "When non-nil, add a newline after the `ivy-read' prompt."
- :type 'boolean)
-
-(defcustom ivy-wrap nil
- "When non-nil, wrap around after the first and the last candidate."
- :type 'boolean)
-
-(defcustom ivy-display-style (and (fboundp 'add-face-text-property) 'fancy)
- "The style for formatting the minibuffer.
-
-By default, the matched strings are copied as is.
-
-The fancy display style highlights matching parts of the regexp,
-a behavior similar to `swiper'.
-
-This setting depends on `add-face-text-property' - a C function
-available since Emacs 24.4. Fancy style will render poorly in
-earlier versions of Emacs."
- :type '(choice
- (const :tag "Plain" nil)
- (const :tag "Fancy" fancy)))
-
-(defcustom ivy-on-del-error-function #'abort-recursive-edit
- "Function to call when deletion fails during completion.
-The usual reason for `ivy-backward-delete-char' to fail is when
-there is no text left to delete, i.e., when it is called at the
-beginning of the minibuffer.
-The default setting provides a quick exit from completion."
- :type '(choice
- (const :tag "Exit completion" abort-recursive-edit)
- (const :tag "Do nothing" ignore)
- (function :tag "Custom function")))
-
-(defcustom ivy-extra-directories '("../" "./")
- "Add this to the front of the list when completing file names.
-Only \"./\" and \"../\" apply here. They appear in reverse order."
- :type '(repeat :tag "Dirs"
- (choice
- (const :tag "Parent Directory" "../")
- (const :tag "Current Directory" "./"))))
-
-(defcustom ivy-use-virtual-buffers nil
- "When non-nil, add recent files and/or bookmarks to `ivy-switch-buffer'.
-The value `recentf' includes only recent files to the virtual
-buffers list, whereas the value `bookmarks' does the same for
-bookmarks. Any other non-nil value includes both."
- :type '(choice
- (const :tag "Don't use virtual buffers" nil)
- (const :tag "Recent files" recentf)
- (const :tag "Bookmarks" bookmarks)
- (const :tag "All virtual buffers" t)))
-
-(defvar ivy--display-function nil
- "The display-function is used in current.")
-
-(defvar ivy-display-functions-props
- '((ivy-display-function-overlay :cleanup ivy-overlay-cleanup))
- "Map Ivy display functions to their property lists.
-Examples of properties include associated `:cleanup' functions.")
-
-(defcustom ivy-display-functions-alist
- '((ivy-completion-in-region . ivy-display-function-overlay)
- (t . nil))
- "An alist for customizing where to display the candidates.
-
-Each key is a caller symbol. When the value is nil (the default),
-the candidates are shown in the minibuffer. Otherwise, the value
-is a function which takes a string argument comprising the
-current matching candidates and displays it somewhere.
-
-See also `https://github.com/abo-abo/swiper/wiki/ivy-display-function'."
- :type '(alist
- :key-type symbol
- :value-type (choice
- (const :tag "Minibuffer" nil)
- (const :tag "LV" ivy-display-function-lv)
- (const :tag "Popup" ivy-display-function-popup)
- (const :tag "Overlay" ivy-display-function-overlay)
- (function :tag "Custom function"))))
-
-(defvar ivy-completing-read-dynamic-collection nil
- "Run `ivy-completing-read' with `:dynamic-collection t`.")
-
-(defcustom ivy-completing-read-handlers-alist
- '((tmm-menubar . completing-read-default)
- (tmm-shortcut . completing-read-default)
- (bbdb-create . ivy-completing-read-with-empty-string-def)
- (auto-insert . ivy-completing-read-with-empty-string-def)
- (Info-on-current-buffer . ivy-completing-read-with-empty-string-def)
- (Info-follow-reference . ivy-completing-read-with-empty-string-def)
- (Info-menu . ivy-completing-read-with-empty-string-def)
- (Info-index . ivy-completing-read-with-empty-string-def)
- (Info-virtual-index . ivy-completing-read-with-empty-string-def)
- (info-display-manual . ivy-completing-read-with-empty-string-def))
- "An alist of handlers to replace `completing-read' in `ivy-mode'."
- :type '(alist :key-type symbol :value-type function))
-
-(defcustom ivy-height-alist nil
- "An alist to customize `ivy-height'.
-
-It is a list of (CALLER . HEIGHT). CALLER is a caller of
-`ivy-read' and HEIGHT is the number of lines displayed.
-HEIGHT can also be a function that returns the number of lines."
- :type '(alist
- :key-type function
- :value-type (choice integer function)))
-
-(defvar ivy-completing-read-ignore-handlers-depth -1
- "Used to avoid infinite recursion.
-
-If `(minibuffer-depth)' equals this, `ivy-completing-read' will
-act as if `ivy-completing-read-handlers-alist' is empty.")
-
-(defvar ivy-highlight-grep-commands nil
- "List of grep-like commands.")
-
-(defvar ivy--actions-list nil
- "A list of extra actions per command.")
-
-(defun ivy-set-actions (cmd actions)
- "Set CMD extra exit points to ACTIONS."
- (setq ivy--actions-list
- (plist-put ivy--actions-list cmd actions)))
-
-(defun ivy-add-actions (cmd actions)
- "Add extra exit points ACTIONS to CMD.
-Existing exit points of CMD are overwritten by those in
-ACTIONS that have the same key."
- (setq ivy--actions-list
- (plist-put ivy--actions-list cmd
- (cl-delete-duplicates
- (append (plist-get ivy--actions-list cmd) actions)
- :key #'car :test #'equal))))
-
-(defun ivy--compute-extra-actions (action caller)
- "Add extra actions to ACTION based on CALLER."
- (let ((extra-actions (cl-delete-duplicates
- (append (plist-get ivy--actions-list t)
- (plist-get ivy--actions-list this-command)
- (plist-get ivy--actions-list caller))
- :key #'car :test #'equal)))
- (if extra-actions
- (cond ((functionp action)
- `(1
- ("o" ,action "default")
- ,@extra-actions))
- ((null action)
- `(1
- ("o" identity "default")
- ,@extra-actions))
- (t
- (delete-dups (append action extra-actions))))
- action)))
-
-(defvar ivy--prompts-list nil)
-
-(defun ivy-set-prompt (caller prompt-fn)
- "Associate CALLER with PROMPT-FN.
-PROMPT-FN is a function of no arguments that returns a prompt string."
- (setq ivy--prompts-list
- (plist-put ivy--prompts-list caller prompt-fn)))
-
-(defvar ivy--display-transformers-list nil
- "A list of str->str transformers per command.")
-
-(defun ivy-set-display-transformer (cmd transformer)
- "Set CMD a displayed candidate TRANSFORMER.
-
-It's a lambda that takes a string one of the candidates in the
-collection and returns a string for display, the same candidate
-plus some extra information.
-
-This lambda is called only on the `ivy-height' candidates that
-are about to be displayed, not on the whole collection."
- (setq ivy--display-transformers-list
- (plist-put ivy--display-transformers-list cmd transformer)))
-
-(defvar ivy--sources-list nil
- "A list of extra sources per command.")
-
-(defun ivy-set-sources (cmd sources)
- "Attach to CMD a list of extra SOURCES.
-
-Each static source is a function that takes no argument and
-returns a list of strings.
-
-The (original-source) determines the position of the original
-dynamic source.
-
-Extra dynamic sources aren't supported yet.
-
-Example:
-
- (defun small-recentf ()
- (cl-subseq recentf-list 0 20))
-
- (ivy-set-sources
- 'counsel-locate
- '((small-recentf)
- (original-source)))"
- (setq ivy--sources-list
- (plist-put ivy--sources-list cmd sources)))
-
-(defun ivy--compute-extra-candidates (caller)
- (let ((extra-sources (or (plist-get ivy--sources-list caller)
- '((original-source))))
- (result nil))
- (dolist (source extra-sources)
- (cond ((equal source '(original-source))
- (push source result))
- ((null (cdr source))
- (push (list (car source) (funcall (car source))) result))))
- result))
-
-(defvar ivy-current-prefix-arg nil
- "Prefix arg to pass to actions.
-This is a global variable that is set by ivy functions for use in
-action functions.")
-
-;;* Keymap
-(require 'delsel)
-(defvar ivy-minibuffer-map
- (let ((map (make-sparse-keymap)))
- (define-key map (kbd "C-m") 'ivy-done)
- (define-key map [down-mouse-1] 'ignore)
- (define-key map [mouse-1] 'ivy-mouse-done)
- (define-key map [mouse-3] 'ivy-mouse-dispatching-done)
- (define-key map (kbd "C-M-m") 'ivy-call)
- (define-key map (kbd "C-j") 'ivy-alt-done)
- (define-key map (kbd "C-M-j") 'ivy-immediate-done)
- (define-key map (kbd "TAB") 'ivy-partial-or-done)
- (define-key map [remap next-line] 'ivy-next-line)
- (define-key map [remap previous-line] 'ivy-previous-line)
- (define-key map (kbd "C-s") 'ivy-next-line-or-history)
- (define-key map (kbd "C-r") 'ivy-reverse-i-search)
- (define-key map (kbd "SPC") 'self-insert-command)
- (define-key map [remap delete-backward-char] 'ivy-backward-delete-char)
- (define-key map [remap backward-delete-char-untabify]
'ivy-backward-delete-char)
- (define-key map [remap backward-kill-word] 'ivy-backward-kill-word)
- (define-key map [remap delete-char] 'ivy-delete-char)
- (define-key map [remap forward-char] 'ivy-forward-char)
- (define-key map (kbd "<right>") 'ivy-forward-char)
- (define-key map [remap kill-word] 'ivy-kill-word)
- (define-key map [remap beginning-of-buffer] 'ivy-beginning-of-buffer)
- (define-key map [remap end-of-buffer] 'ivy-end-of-buffer)
- (define-key map (kbd "M-n") 'ivy-next-history-element)
- (define-key map (kbd "M-p") 'ivy-previous-history-element)
- (define-key map (kbd "C-g") 'minibuffer-keyboard-quit)
- (define-key map [remap scroll-up-command] 'ivy-scroll-up-command)
- (define-key map [remap scroll-down-command] 'ivy-scroll-down-command)
- (define-key map (kbd "<next>") 'ivy-scroll-up-command)
- (define-key map (kbd "<prior>") 'ivy-scroll-down-command)
- (define-key map (kbd "C-v") 'ivy-scroll-up-command)
- (define-key map (kbd "M-v") 'ivy-scroll-down-command)
- (define-key map (kbd "C-M-n") 'ivy-next-line-and-call)
- (define-key map (kbd "C-M-p") 'ivy-previous-line-and-call)
- (define-key map (kbd "M-r") 'ivy-toggle-regexp-quote)
- (define-key map (kbd "M-j") 'ivy-yank-word)
- (define-key map (kbd "M-i") 'ivy-insert-current)
- (define-key map (kbd "C-M-y") 'ivy-insert-current-full)
- (define-key map (kbd "C-o") 'hydra-ivy/body)
- (define-key map (kbd "M-o") 'ivy-dispatching-done)
- (define-key map (kbd "C-M-o") 'ivy-dispatching-call)
- (define-key map [remap kill-line] 'ivy-kill-line)
- (define-key map [remap kill-whole-line] 'ivy-kill-whole-line)
- (define-key map (kbd "S-SPC") 'ivy-restrict-to-matches)
- (define-key map [remap kill-ring-save] 'ivy-kill-ring-save)
- (define-key map (kbd "C-'") 'ivy-avy)
- (define-key map (kbd "C-M-a") 'ivy-read-action)
- (define-key map (kbd "C-c C-o") 'ivy-occur)
- (define-key map (kbd "C-c C-a") 'ivy-toggle-ignore)
- (define-key map (kbd "C-c C-s") 'ivy-rotate-sort)
- (define-key map [remap describe-mode] 'ivy-help)
- (define-key map "$" 'ivy-magic-read-file-env)
- map)
- "Keymap used in the minibuffer.")
-(autoload 'hydra-ivy/body "ivy-hydra" "" t)
-
-(defvar ivy-mode-map
- (let ((map (make-sparse-keymap)))
- (define-key map [remap switch-to-buffer]
- 'ivy-switch-buffer)
- (define-key map [remap switch-to-buffer-other-window]
- 'ivy-switch-buffer-other-window)
- map)
- "Keymap for `ivy-mode'.")
-
-;;* Globals
-(cl-defstruct ivy-state
- prompt collection
- predicate require-match initial-input
- history preselect keymap update-fn sort
- ;; The frame in which `ivy-read' was called
- frame
- ;; The window in which `ivy-read' was called
- window
- ;; The buffer in which `ivy-read' was called
- buffer
- ;; The value of `ivy-text' to be used by `ivy-occur'
- text
- action
- unwind
- re-builder
- matcher
- ;; When this is non-nil, call it for each input change to get new candidates
- dynamic-collection
- ;; A lambda that transforms candidates only for display
- display-transformer-fn
- directory
- caller
- current
- def
- ignore
- multi-action
- extra-props)
-
-(defvar ivy-last (make-ivy-state)
- "The last parameters passed to `ivy-read'.
-
-This should eventually become a stack so that you could use
-`ivy-read' recursively.")
-
-(defvar ivy-recursive-last nil)
-
-(defvar ivy-recursive-restore t
- "When non-nil, restore the above state when exiting the minibuffer.
-This variable is let-bound to nil by functions that take care of
-the restoring themselves.")
-
-(defsubst ivy-set-action (action)
- "Set the current `ivy-last' field to ACTION."
- (setf (ivy-state-action ivy-last) action))
-
-(defvar inhibit-message)
-
-(defun ivy-thing-at-point ()
- "Return a string that corresponds to the current thing at point."
- (substring-no-properties
- (cond
- ((use-region-p)
- (let* ((beg (region-beginning))
- (end (region-end))
- (eol (save-excursion (goto-char beg) (line-end-position))))
- (buffer-substring-no-properties beg (min end eol))))
- ((thing-at-point 'url))
- ((and (eq (ivy-state-collection ivy-last) #'read-file-name-internal)
- (let ((inhibit-message t))
- (run-hook-with-args-until-success
'file-name-at-point-functions))))
- ((let ((s (thing-at-point 'symbol)))
- (and (stringp s)
- (if (string-match "\\`[`']?\\(.*?\\)'?\\'" s)
- (match-string 1 s)
- s))))
- ((looking-at "(+\\(\\(?:\\sw\\|\\s_\\)+\\)\\_>")
- (match-string-no-properties 1))
- (t
- ""))))
-
-(defvar ivy-history nil
- "History list of candidates entered in the minibuffer.
-
-Maximum length of the history list is determined by the value
-of `history-length'.")
-
-(defvar ivy--directory nil
- "Current directory when completing file names.")
-
-(defvar ivy--length 0
- "Store the amount of viable candidates.")
-
-(defvar ivy-text ""
- "Store the user's string as it is typed in.")
-
-(defvar ivy--index 0
- "Store the index of the current candidate.")
-
-(defvar ivy--window-index 0
- "Store the index of the current candidate in the minibuffer window.
-
-This means it's between 0 and `ivy-height'.")
-
-(defvar ivy-exit nil
- "Store `done' if the completion was successfully selected.
-Otherwise, store nil.")
-
-(defvar ivy--all-candidates nil
- "Store the candidates passed to `ivy-read'.")
-
-(defvar ivy--extra-candidates '((original-source))
- "Store candidates added by the extra sources.
-
-This is an internal-use alist. Each key is a function name, or
-original-source (which represents where the current dynamic
-candidates should go).
-
-Each value is an evaluation of the function, in case of static
-sources. These values will subsequently be filtered on `ivy-text'.
-
-This variable is set by `ivy-read' and used by `ivy--set-candidates'.")
-
-(defcustom ivy-use-ignore-default t
- "The default policy for user-configured candidate filtering."
- :type '(choice
- (const :tag "Ignore ignored always" always)
- (const :tag "Ignore ignored when others exist" t)
- (const :tag "Don't ignore" nil)))
-
-(defvar ivy-use-ignore t
- "Store policy for user-configured candidate filtering.
-This may be changed dynamically by `ivy-toggle-ignore'.
-Use `ivy-use-ignore-default' for a permanent configuration.")
-
-(defvar ivy--default nil
- "Default initial input.")
-
-(defvar ivy--prompt nil
- "Store the format-style prompt.
-When non-nil, it should contain at least one %d.")
-
-(defvar ivy--prompt-extra ""
- "Temporary modifications to the prompt.")
-
-(defvar ivy--old-re nil
- "Store the old regexp.
-Either a string or a list for `ivy-re-match'.")
-
-(defvar ivy--old-cands nil
- "Store the candidates matched by `ivy--old-re'.")
-
-(defvar ivy--regex-function 'ivy--regex
- "Current function for building a regex.")
-
-(defvar ivy--highlight-function 'ivy--highlight-default
- "Current function for formatting the candidates.")
-
-(defvar ivy--subexps 0
- "Number of groups in the current `ivy--regex'.")
-
-(defvar ivy--full-length nil
- "The total amount of candidates when :dynamic-collection is non-nil.")
-
-(defvar ivy--old-text ""
- "Store old `ivy-text' for dynamic completion.")
-
-(defvar ivy--trying-to-resume-dynamic-collection nil
- "Non-nil if resuming from a dynamic collection.
-When non-nil, ivy will wait until the first chunk of asynchronous
-candidates has been received before selecting the last
-preselected candidate.")
-
-(defun ivy--set-index-dynamic-collection ()
- (when ivy--trying-to-resume-dynamic-collection
- (let ((preselect-index
- (ivy--preselect-index (ivy-state-preselect ivy-last)
ivy--all-candidates)))
- (when preselect-index
- (ivy-set-index preselect-index)))
- (setq ivy--trying-to-resume-dynamic-collection nil)))
-
-(defcustom ivy-case-fold-search-default
- (if search-upper-case
- 'auto
- case-fold-search)
- "The default value for `case-fold-search' in Ivy operations.
-The special value `auto' means case folding is performed so long
-as the entire input string comprises lower-case characters. This
-corresponds to the default behaviour of most Emacs search
-functionality, e.g. as seen in `isearch'."
- :link '(info-link "(emacs)Lax Search")
- :type '(choice
- (const :tag "Auto" auto)
- (const :tag "Always" t)
- (const :tag "Never" nil)))
-
-(defvar ivy-case-fold-search ivy-case-fold-search-default
- "Store the current overriding `case-fold-search'.")
-
-(defvar ivy-more-chars-alist
- '((t . 3))
- "Map commands to their minimum required input length.
-That is the number of characters prompted for before fetching
-candidates. The special key t is used as a fallback.")
-
-(defun ivy-more-chars ()
- "Return two fake candidates prompting for at least N input.
-N is obtained from `ivy-more-chars-alist'."
- (let ((diff (- (ivy-alist-setting ivy-more-chars-alist)
- (length ivy-text))))
- (when (> diff 0)
- (list "" (format "%d chars more" diff)))))
-
-(defun ivy--case-fold-p (string)
- "Return nil if STRING should be matched case-sensitively."
- (if (eq ivy-case-fold-search 'auto)
- (string= string (downcase string))
- ivy-case-fold-search))
-
-(defun ivy--case-fold-string= (s1 s2)
- "Like `string=', but obeys `case-fold-search'."
- (eq t (compare-strings s1 nil nil s2 nil nil case-fold-search)))
-
-(eval-and-compile
- (unless (fboundp 'defvar-local)
- (defmacro defvar-local (var val &optional docstring)
- "Define VAR as a buffer-local variable with default value VAL."
- (declare (debug defvar) (doc-string 3))
- (list 'progn (list 'defvar var val docstring)
- (list 'make-variable-buffer-local (list 'quote var)))))
- (unless (fboundp 'setq-local)
- (defmacro setq-local (var val)
- "Set variable VAR to value VAL in current buffer."
- (list 'set (list 'make-local-variable (list 'quote var)) val))))
-
-(defmacro ivy-quit-and-run (&rest body)
- "Quit the minibuffer and run BODY afterwards."
- (declare (indent 0))
- `(progn
- (put 'quit 'error-message "")
- (run-at-time nil nil
- (lambda ()
- (put 'quit 'error-message "Quit")
- (with-demoted-errors "Error: %S"
- ,@body)))
- (abort-recursive-edit)))
-
-(defun ivy-exit-with-action (action)
- "Quit the minibuffer and call ACTION afterwards."
- (ivy-set-action
- `(lambda (x)
- (funcall ',action x)
- (ivy-set-action ',(ivy-state-action ivy-last))))
- (setq ivy-exit 'done)
- (exit-minibuffer))
-
-(defmacro with-ivy-window (&rest body)
- "Execute BODY in the window from which `ivy-read' was called."
- (declare (indent 0)
- (debug t))
- `(with-selected-window (ivy--get-window ivy-last)
- ,@body))
-
-(defun ivy--done (text)
- "Insert TEXT and exit minibuffer."
- (if (member (ivy-state-prompt ivy-last) '("Create directory: " "Make
directory: "))
- (ivy-immediate-done)
- (if (stringp text)
- (insert
- (setf (ivy-state-current ivy-last)
- (if (and ivy--directory
- (not (eq (ivy-state-history ivy-last)
'grep-files-history)))
- (expand-file-name text ivy--directory)
- text))))
- (setq ivy-exit 'done)
- (exit-minibuffer)))
-
-(defcustom ivy-use-selectable-prompt nil
- "When non-nil, make the prompt line selectable like a candidate.
-
-The prompt line can be selected by calling `ivy-previous-line' when the first
-regular candidate is selected. Both actions `ivy-done' and `ivy-alt-done',
-when called on a selected prompt, are forwarded to `ivy-immediate-done', which
-results to the same as calling `ivy-immediate-done' explicitly when a regular
-candidate is selected.
-
-Note that if `ivy-wrap' is set to t, calling `ivy-previous-line' when the
-prompt is selected wraps around to the last candidate, while calling
-`ivy-next-line' on the last candidate wraps around to the first
-candidate, not the prompt."
- :type 'boolean)
-
-(defvar ivy--use-selectable-prompt nil
- "Store the effective `ivy-use-selectable-prompt' for current session.")
-
-(defun ivy--prompt-selectable-p ()
- "Return t if the prompt line is selectable."
- (and ivy-use-selectable-prompt
- (or (memq (ivy-state-require-match ivy-last)
- '(nil confirm confirm-after-completion))
- ;; :require-match is t, but "" is in the collection
- (let ((coll (ivy-state-collection ivy-last)))
- (and (listp coll)
- (if (consp (car coll))
- (member '("") coll)
- (member "" coll)))))))
-
-(defun ivy--prompt-selected-p ()
- "Return t if the prompt line is selected."
- (and ivy--use-selectable-prompt
- (= ivy--index -1)))
-
-;;* Commands
-(defun ivy-done ()
- "Exit the minibuffer with the selected candidate."
- (interactive)
- (if (ivy--prompt-selected-p)
- (ivy-immediate-done)
- (setq ivy-current-prefix-arg current-prefix-arg)
- (delete-minibuffer-contents)
- (cond ((or (> ivy--length 0)
- ;; the action from `ivy-dispatching-done' may not need a
- ;; candidate at all
- (eq this-command 'ivy-dispatching-done))
- (ivy--done (ivy-state-current ivy-last)))
- ((memq (ivy-state-collection ivy-last)
- '(read-file-name-internal internal-complete-buffer))
- (if (or (not (eq confirm-nonexistent-file-or-buffer t))
- (equal " (confirm)" ivy--prompt-extra))
- (ivy--done ivy-text)
- (setq ivy--prompt-extra " (confirm)")
- (insert ivy-text)
- (ivy--exhibit)))
- ((memq (ivy-state-require-match ivy-last)
- '(nil confirm confirm-after-completion))
- (ivy--done ivy-text))
- (t
- (setq ivy--prompt-extra " (match required)")
- (insert ivy-text)
- (ivy--exhibit)))))
-
-(defvar ivy-mouse-1-tooltip
- "Exit the minibuffer with the selected candidate."
- "The doc visible in the tooltip for mouse-1 binding in the minibuffer")
-(defvar ivy-mouse-3-tooltip
- "Display alternative actions."
- "The doc visible in the tooltip for mouse-3 binding in the minibuffer")
-
-(defun ivy-mouse-offset (event)
- "Compute the offset between the candidate at point and the selected one."
- (if event
- (let* ((line-number-at-point
- (max 2
- (line-number-at-pos (posn-point (event-start event)))))
-
- (line-number-candidate ;; convert to 0 based index
- (- line-number-at-point 2))
- (offset
- (- line-number-candidate
- ivy--window-index)))
- offset)
- nil))
-
-(defun ivy-mouse-done (event)
- (interactive "@e")
- (let ((offset (ivy-mouse-offset event)))
- (when offset
- (ivy-next-line offset)
- (ivy--exhibit)
- (ivy-alt-done))))
-
-(defun ivy-mouse-dispatching-done (event)
- (interactive "@e")
- (let ((offset (ivy-mouse-offset event)))
- (when offset
- (ivy-next-line offset)
- (ivy--exhibit)
- (ivy-dispatching-done))))
-
-(defvar ivy-read-action-format-function 'ivy-read-action-format-default
- "Function used to transform the actions list into a docstring.")
-
-(defun ivy-read-action-format-default (actions)
- "Create a docstring from ACTIONS.
-
-ACTIONS is a list. Each list item is a list of 3 items:
-key (a string), cmd and doc (a string)."
- (format "%s\n%s\n"
- (if (eq this-command 'ivy-read-action)
- "Select action: "
- (ivy-state-current ivy-last))
- (mapconcat
- (lambda (x)
- (format "%s: %s"
- (propertize
- (car x)
- 'face 'ivy-action)
- (nth 2 x)))
- actions
- "\n")))
-
-(defcustom ivy-read-action-function #'ivy-read-action-by-key
- "Function used to read an action."
- :type '(radio
- (function-item ivy-read-action-by-key)
- (function-item ivy-read-action-ivy)
- (function-item ivy-read-action-hydra)))
-
-(defun ivy-read-action ()
- "Change the action to one of the available ones.
-
-Return nil for `minibuffer-keyboard-quit' or wrong key during the
-selection, non-nil otherwise."
- (interactive)
- (let ((actions (ivy-state-action ivy-last)))
- (if (not (ivy--actionp actions))
- t
- (funcall ivy-read-action-function actions))))
-
-(defun ivy-read-action-by-key (actions)
- (let* ((hint (funcall ivy-read-action-format-function (cdr actions)))
- (resize-mini-windows t)
- (key "")
- action-idx)
- (while (and (setq action-idx (cl-position-if
- (lambda (x)
- (string-prefix-p key (car x)))
- (cdr actions)))
- (not (string= key (car (nth action-idx (cdr actions))))))
- (setq key (concat key (string (read-key hint)))))
- (ivy-shrink-after-dispatching)
- (cond ((member key '("" ""))
- nil)
- ((null action-idx)
- (message "%s is not bound" key)
- nil)
- (t
- (message "")
- (setcar actions (1+ action-idx))
- (ivy-set-action actions)))))
-
-(defun ivy-read-action-ivy (actions)
- "Select an action from ACTIONS using Ivy."
- (let ((enable-recursive-minibuffers t))
- (if (and (> (minibuffer-depth) 1)
- (eq (ivy-state-caller ivy-last) 'ivy-read-action-ivy))
- (minibuffer-keyboard-quit)
- (ivy-read (format "action (%s): " (ivy-state-current ivy-last))
- (cl-mapcar
- (lambda (a i) (cons (format "[%s] %s" (nth 0 a) (nth 2 a)) i))
- (cdr actions) (number-sequence 1 (length (cdr actions))))
- :action (lambda (a)
- (setcar actions (cdr a))
- (ivy-set-action actions))
- :caller 'ivy-read-action-ivy))))
-
-(defun ivy-shrink-after-dispatching ()
- "Shrink the window after dispatching when action list is too large."
- (window-resize nil (- ivy-height (window-height))))
-
-(defun ivy-dispatching-done ()
- "Select one of the available actions and call `ivy-done'."
- (interactive)
- (when (ivy-read-action)
- (ivy-done))
- (ivy-shrink-after-dispatching))
-
-(defun ivy-dispatching-call ()
- "Select one of the available actions and call `ivy-call'."
- (interactive)
- (setq ivy-current-prefix-arg current-prefix-arg)
- (let ((actions (copy-sequence (ivy-state-action ivy-last))))
- (unwind-protect
- (when (ivy-read-action)
- (ivy-call))
- (ivy-set-action actions)))
- (ivy-shrink-after-dispatching))
-
-(defun ivy-build-tramp-name (x)
- "Reconstruct X into a path.
-Is is a cons cell, related to `tramp-get-completion-function'."
- (let ((user (car x))
- (domain (cadr x)))
- (if user
- (concat user "@" domain)
- domain)))
-
-(declare-function Info-find-node "info")
-(declare-function Info-read-node-name-1 "info")
-(declare-function tramp-get-completion-function "tramp")
-
-(defun ivy-alt-done (&optional arg)
- "Exit the minibuffer with the selected candidate.
-When ARG is t, exit with current text, ignoring the candidates.
-When the current candidate during file name completion is a
-directory, continue completion from within that directory instead
-of exiting. This function is otherwise like `ivy-done'."
- (interactive "P")
- (setq ivy-current-prefix-arg current-prefix-arg)
- (cond ((or arg
- (ivy--prompt-selected-p))
- (ivy-immediate-done))
- (ivy--directory
- (ivy--directory-done))
- ((eq (ivy-state-collection ivy-last) #'Info-read-node-name-1)
- (if (member (ivy-state-current ivy-last) '("(./)" "(../)"))
- (ivy-quit-and-run
- (ivy-read "Go to file: " #'read-file-name-internal
- :action (lambda (x)
- (Info-find-node
- (expand-file-name x ivy--directory)
- "Top"))))
- (ivy-done)))
- (t
- (ivy-done))))
-
-(defvar ivy-auto-select-single-candidate nil
- "When non-nil, auto-select the candidate if it is the only one.
-When t, it is the same as if the user were prompted and selected the candidate
-by calling the default action. This variable has no use unless the collection
-contains a single candidate.")
-
-(defun ivy--directory-enter ()
- (let (dir)
- (when (and
- (> ivy--length 0)
- (not (string= (ivy-state-current ivy-last) "./"))
- (setq dir (ivy-expand-file-if-directory (ivy-state-current
ivy-last))))
- (ivy--cd dir)
- (ivy--exhibit))))
-
-(defun ivy--handle-directory (input)
- "Detect the next directory based on special values of INPUT."
- (cond ((string= input "/")
- "/")
- ((string= input "/sudo::")
- (concat input ivy--directory))))
-
-(defun ivy--directory-done ()
- "Handle exit from the minibuffer when completing file names."
- (let ((dir (ivy--handle-directory ivy-text)))
- (cond
- (dir
- (let ((inhibit-message t))
- (ivy--cd dir)))
- ((ivy--directory-enter))
- ((unless (string= ivy-text "")
- (let ((file (expand-file-name
- (if (> ivy--length 0) (ivy-state-current ivy-last)
ivy-text)
- ivy--directory)))
- (when (ignore-errors (file-exists-p file))
- (if (file-directory-p file)
- (ivy--cd (file-name-as-directory file))
- (ivy-done))
- ivy-text))))
- ((or (and (equal ivy--directory "/")
- (string-match-p "\\`[^/]+:.*:.*\\'" ivy-text))
- (string-match-p "\\`/[^/]+:.*:.*\\'" ivy-text))
- (ivy-done))
- ((or (and (equal ivy--directory "/")
- (cond ((string-match
- "\\`\\([^/]+?\\):\\(?:\\(.*\\)@\\)?\\(.*\\)\\'"
- ivy-text)
- (setq ivy-text (ivy-state-current ivy-last)))
- ((string-match
- "\\`\\([^/]+?\\):\\(?:\\(.*\\)@\\)?\\(.*\\)\\'"
- (ivy-state-current ivy-last))
- (setq ivy-text (ivy-state-current ivy-last)))))
- (string-match
- "\\`/\\([^/]+?\\):\\(?:\\(.*\\)@\\)?\\(.*\\)\\'"
- ivy-text))
- (let ((method (match-string 1 ivy-text))
- (user (match-string 2 ivy-text))
- (rest (match-string 3 ivy-text))
- res)
- (dolist (x (tramp-get-completion-function method))
- (setq res (append res (funcall (car x) (cadr x)))))
- (setq res (delq nil res))
- (when user
- (dolist (x res)
- (setcar x user)))
- (setq res (delete-dups res))
- (let* ((old-ivy-last ivy-last)
- (enable-recursive-minibuffers t)
- (host (let ((ivy-auto-select-single-candidate nil))
- (ivy-read "user@host: "
- (mapcar #'ivy-build-tramp-name res)
- :initial-input rest))))
- (setq ivy-last old-ivy-last)
- (when host
- (setq ivy--directory "/")
- (ivy--cd (concat "/" method ":" host ":"))))))
- (t
- (ivy-done)))))
-
-(defun ivy-expand-file-if-directory (file-name)
- "Expand FILE-NAME as directory.
-When this directory doesn't exist, return nil."
- (when (stringp file-name)
- (let ((full-name
- ;; Ignore host name must not match method "ssh"
- (ignore-errors
- (file-name-as-directory
- (expand-file-name file-name ivy--directory)))))
- (when (and full-name (file-directory-p full-name))
- full-name))))
-
-(defcustom ivy-tab-space nil
- "When non-nil, `ivy-partial-or-done' should insert a space."
- :type 'boolean)
-
-(defun ivy-partial-or-done ()
- "Complete the minibuffer text as much as possible.
-If the text hasn't changed as a result, forward to `ivy-alt-done'."
- (interactive)
- (cond
- ((and completion-cycle-threshold (< (length ivy--all-candidates)
completion-cycle-threshold))
- (let ((ivy-wrap t))
- (ivy-next-line)))
- ((and (eq (ivy-state-collection ivy-last) #'read-file-name-internal)
- (or (and (equal ivy--directory "/")
- (string-match-p "\\`[^/]+:.*\\'" ivy-text))
- (= (string-to-char ivy-text) ?/)))
- (let ((default-directory ivy--directory)
- dir)
- (minibuffer-complete)
- (setq ivy-text (ivy--input))
- (when (setq dir (ivy-expand-file-if-directory ivy-text))
- (ivy--cd dir))))
- (t
- (or (ivy-partial)
- (when (or (eq this-command last-command)
- (eq ivy--length 1))
- (ivy-alt-done))))))
-
-(defun ivy--remove-prefix (prefix string)
- "Compatibility shim for `string-remove-prefix'."
- (if (string-prefix-p prefix string)
- (substring string (length prefix))
- string))
-
-(defun ivy--partial-cd-for-single-directory ()
- (when (and
- (eq (ivy-state-collection ivy-last) #'read-file-name-internal)
- (= 1 (length
- (ivy--re-filter
- (funcall ivy--regex-function ivy-text) ivy--all-candidates)))
- (let ((default-directory ivy--directory))
- (file-directory-p (ivy-state-current ivy-last))))
- (ivy--directory-done)))
-
-(defun ivy-partial ()
- "Complete the minibuffer text as much as possible."
- (interactive)
- (let* ((parts (or (ivy--split-spaces ivy-text) (list "")))
- (tail (last parts))
- (postfix (car tail))
- (case-fold-search (ivy--case-fold-p ivy-text))
- (completion-ignore-case case-fold-search)
- (new (try-completion (ivy--remove-prefix "^" postfix)
- (if (ivy-state-dynamic-collection ivy-last)
- ivy--all-candidates
- (mapcar (lambda (str)
- (let ((i (string-match-p postfix
str)))
- (and i (substring str i))))
- ivy--old-cands)))))
- (cond ((eq new t) nil)
- ((string= new ivy-text) nil)
- ((string= (car tail) (car (ivy--split-spaces new))) nil)
- (new
- (delete-region (minibuffer-prompt-end) (point-max))
- (setcar tail
- (if (= (string-to-char postfix) ?^)
- (concat "^" new)
- new))
- (insert
- (setq ivy-text
- (concat
- (mapconcat #'identity parts " ")
- (and ivy-tab-space (not (= (length ivy--old-cands) 1)) "
"))))
- (ivy--partial-cd-for-single-directory)
- t))))
-
-(defvar ivy-completion-beg nil
- "Completion bounds start.")
-
-(defvar ivy-completion-end nil
- "Completion bounds end.")
-
-(defun ivy-immediate-done ()
- "Exit the minibuffer with current input instead of current candidate."
- (interactive)
- (delete-minibuffer-contents)
- (setf (ivy-state-current ivy-last)
- (cond ((or (not ivy--directory)
- (eq (ivy-state-history ivy-last) 'grep-files-history))
- ivy-text)
- ((and (string= ivy-text "")
- (eq (ivy-state-collection ivy-last)
- #'read-file-name-internal))
- (if (ivy-state-def ivy-last)
- (if (and
- (file-exists-p (ivy-state-def ivy-last))
- (/= (length ivy--directory)
- (1+ (length (expand-file-name (ivy-state-def
ivy-last))))))
- ivy--directory
- (copy-sequence (ivy-state-def ivy-last)))
- ivy--directory))
- (t
- (expand-file-name ivy-text ivy--directory))))
- (insert (ivy-state-current ivy-last))
- (setq ivy-completion-beg ivy-completion-end)
- (setq ivy-exit 'done)
- (exit-minibuffer))
-
-;;;###autoload
-(defun ivy-resume ()
- "Resume the last completion session."
- (interactive)
- (if (null (ivy-state-action ivy-last))
- (user-error "The last session isn't compatible with `ivy-resume'")
- (when (memq (ivy-state-caller ivy-last)
- '(swiper swiper-isearch swiper-backward
swiper-isearch-backward))
- (switch-to-buffer (ivy-state-buffer ivy-last)))
- (with-current-buffer (ivy-state-buffer ivy-last)
- (let ((default-directory (ivy-state-directory ivy-last))
- (ivy-use-ignore-default (ivy-state-ignore ivy-last)))
- (ivy-read
- (ivy-state-prompt ivy-last)
- (ivy-state-collection ivy-last)
- :predicate (ivy-state-predicate ivy-last)
- :require-match (ivy-state-require-match ivy-last)
- :initial-input ivy-text
- :history (ivy-state-history ivy-last)
- :preselect (ivy-state-current ivy-last)
- :keymap (ivy-state-keymap ivy-last)
- :update-fn (ivy-state-update-fn ivy-last)
- :sort (ivy-state-sort ivy-last)
- :action (ivy-state-action ivy-last)
- :unwind (ivy-state-unwind ivy-last)
- :re-builder (ivy-state-re-builder ivy-last)
- :matcher (ivy-state-matcher ivy-last)
- :dynamic-collection (ivy-state-dynamic-collection ivy-last)
- :extra-props (ivy-state-extra-props ivy-last)
- :caller (ivy-state-caller ivy-last))))))
-
-(defvar-local ivy-calling nil
- "When non-nil, call the current action when `ivy--index' changes.")
-
-(defun ivy-set-index (index)
- "Set `ivy--index' to INDEX."
- (setq ivy--index index)
- (when ivy-calling
- (ivy--exhibit)
- (ivy-call)))
-
-(defun ivy-beginning-of-buffer ()
- "Select the first completion candidate."
- (interactive)
- (ivy-set-index 0))
-
-(defun ivy-end-of-buffer ()
- "Select the last completion candidate."
- (interactive)
- (ivy-set-index (1- ivy--length)))
-
-(defun ivy-scroll-up-command ()
- "Scroll the candidates upward by the minibuffer height."
- (interactive)
- (ivy-set-index (min (1- (+ ivy--index ivy-height))
- (1- ivy--length))))
-
-(defun ivy-scroll-down-command ()
- "Scroll the candidates downward by the minibuffer height."
- (interactive)
- (ivy-set-index (max (1+ (- ivy--index ivy-height))
- 0)))
-
-(defun ivy-minibuffer-grow ()
- "Grow the minibuffer window by 1 line."
- (interactive)
- (setq-local max-mini-window-height
- (cl-incf ivy-height)))
-
-(defun ivy-minibuffer-shrink ()
- "Shrink the minibuffer window by 1 line."
- (interactive)
- (when (> ivy-height 2)
- (setq-local max-mini-window-height
- (cl-decf ivy-height))
- (window-resize nil -1)))
-
-(defun ivy-next-line (&optional arg)
- "Move cursor vertically down ARG candidates."
- (interactive "p")
- (setq arg (or arg 1))
- (let ((index (+ ivy--index arg)))
- (if (> index (1- ivy--length))
- (if ivy-wrap
- (ivy-beginning-of-buffer)
- (ivy-set-index (1- ivy--length)))
- (ivy-set-index index))))
-
-(defun ivy-next-line-or-history (&optional arg)
- "Move cursor vertically down ARG candidates.
-If the input is empty, select the previous history element instead."
- (interactive "p")
- (if (string= ivy-text "")
- (ivy-previous-history-element 1)
- (ivy-next-line arg)))
-
-(defun ivy-previous-line (&optional arg)
- "Move cursor vertically up ARG candidates."
- (interactive "p")
- (setq arg (or arg 1))
- (let ((index (- ivy--index arg))
- (min-index (if ivy--use-selectable-prompt -1 0)))
- (if (< index min-index)
- (if ivy-wrap
- (ivy-end-of-buffer)
- (ivy-set-index min-index))
- (ivy-set-index index))))
-
-(defun ivy-previous-line-or-history (arg)
- "Move cursor vertically up ARG candidates.
-If the input is empty, select the previous history element instead."
- (interactive "p")
- (when (string= ivy-text "")
- (ivy-previous-history-element 1))
- (ivy-previous-line arg))
-
-(defun ivy-toggle-calling ()
- "Flip `ivy-calling'."
- (interactive)
- (when (setq ivy-calling (not ivy-calling))
- (ivy-call)))
-
-(defun ivy-toggle-ignore ()
- "Toggle user-configured candidate filtering."
- (interactive)
- (setq ivy-use-ignore
- (if ivy-use-ignore
- nil
- (or ivy-use-ignore-default t)))
- (setf (ivy-state-ignore ivy-last) ivy-use-ignore)
- ;; invalidate cache
- (setq ivy--old-cands nil))
-
-(defun ivy--get-action (state)
- "Get the action function from STATE."
- (let ((action (ivy-state-action state)))
- (when action
- (if (functionp action)
- action
- (cadr (nth (car action) action))))))
-
-(defun ivy--get-window (state)
- "Get the window from STATE."
- (if (ivy-state-p state)
- (let ((window (ivy-state-window state)))
- (if (window-live-p window)
- window
- (next-window)))
- (selected-window)))
-
-(defun ivy--actionp (x)
- "Return non-nil when X is a list of actions."
- (and (consp x) (not (memq (car x) '(closure lambda)))))
-
-(defcustom ivy-action-wrap nil
- "When non-nil, `ivy-next-action' and `ivy-prev-action' wrap."
- :type 'boolean)
-
-(defun ivy-next-action ()
- "When the current action is a list, scroll it forwards."
- (interactive)
- (let ((action (ivy-state-action ivy-last)))
- (when (ivy--actionp action)
- (let ((len (1- (length action)))
- (idx (car action)))
- (if (>= idx len)
- (when ivy-action-wrap
- (setf (car action) 1))
- (cl-incf (car action)))))))
-
-(defun ivy-prev-action ()
- "When the current action is a list, scroll it backwards."
- (interactive)
- (let ((action (ivy-state-action ivy-last)))
- (when (ivy--actionp action)
- (if (<= (car action) 1)
- (when ivy-action-wrap
- (setf (car action) (1- (length action))))
- (cl-decf (car action))))))
-
-(defun ivy-action-name ()
- "Return the name associated with the current action."
- (let ((action (ivy-state-action ivy-last)))
- (if (ivy--actionp action)
- (format "[%d/%d] %s"
- (car action)
- (1- (length action))
- (nth 2 (nth (car action) action)))
- "[1/1] default")))
-
-(defvar ivy-inhibit-action nil
- "When non-nil, `ivy-call' does nothing.
-
-Example use:
-
- (let* ((ivy-inhibit-action t)
- (str (ivy-switch-buffer)))
- ;; do whatever with str - the corresponding buffer will not be opened
- )")
-
-(defun ivy-recursive-restore ()
- "Restore the above state when exiting the minibuffer.
-See variable `ivy-recursive-restore' for further information."
- (when (and ivy-recursive-last
- ivy-recursive-restore
- (not (eq ivy-last ivy-recursive-last)))
- (ivy--reset-state (setq ivy-last ivy-recursive-last))))
-
-(defvar ivy-marked-candidates nil
- "List of marked candidates.
-Use `ivy-mark' to populate this.
-
-When this list is non-nil at the end of the session, the action
-will be called for each element of this list.")
-
-(defvar ivy-mark-prefix ">"
- "Prefix used by `ivy-mark'.")
-
-(defun ivy-call ()
- "Call the current action without exiting completion."
- (interactive)
- ;; Testing with `ivy-with' seems to call `ivy-call' again,
- ;; in which case `this-command' is nil; so check for this.
- (unless (memq this-command '(nil
- ivy-done
- ivy-alt-done
- ivy-dispatching-done))
- (setq ivy-current-prefix-arg current-prefix-arg))
- (let ((action
- (if (functionp ivy-inhibit-action)
- ivy-inhibit-action
- (and (not ivy-inhibit-action)
- (ivy--get-action ivy-last)))))
- (when action
- (let* ((collection (ivy-state-collection ivy-last))
- (current (ivy-state-current ivy-last))
- (x (cond
- ;; Alist type.
- ((and (consp (car-safe collection))
- ;; Previously, the cdr of the selected
- ;; candidate would be returned. Now, the
- ;; whole candidate is returned.
- (let ((idx (get-text-property 0 'idx current)))
- (if idx
- (nth idx collection)
- (assoc current collection)))))
- (ivy--directory
- (expand-file-name current ivy--directory))
- ((equal current "")
- ivy-text)
- (t
- current))))
- (if (eq action #'identity)
- (prog1 x
- (ivy-recursive-restore))
- (select-window (ivy--get-window ivy-last))
- (set-buffer (ivy-state-buffer ivy-last))
- (prog1 (unwind-protect
- (if ivy-marked-candidates
- (let ((prefix-len (length ivy-mark-prefix)))
- (setq ivy-marked-candidates
- (mapcar (lambda (s) (substring s prefix-len))
- ivy-marked-candidates))
- (if (ivy-state-multi-action ivy-last)
- (funcall
- (ivy-state-multi-action ivy-last)
- ivy-marked-candidates)
- (dolist (c ivy-marked-candidates)
- (let ((default-directory (ivy-state-directory
ivy-last)))
- (funcall action c)))))
- (funcall action x))
- (ivy-recursive-restore))
- (unless (or (eq ivy-exit 'done)
- (minibuffer-window-active-p (selected-window))
- (null (active-minibuffer-window)))
- (select-window (active-minibuffer-window)))))))))
-
-(defun ivy-call-and-recenter ()
- "Call action and recenter window according to the selected candidate."
- (interactive)
- (ivy-call)
- (with-ivy-window
- (recenter-top-bottom)))
-
-(defun ivy-next-line-and-call (&optional arg)
- "Move cursor vertically down ARG candidates.
-Call the permanent action if possible."
- (interactive "p")
- (ivy-next-line arg)
- (ivy--exhibit)
- (ivy-call))
-
-(defun ivy-previous-line-and-call (&optional arg)
- "Move cursor vertically up ARG candidates.
-Call the permanent action if possible."
- (interactive "p")
- (ivy-previous-line arg)
- (ivy--exhibit)
- (ivy-call))
-
-(defun ivy-previous-history-element (arg)
- "Forward to `previous-history-element' with ARG."
- (interactive "p")
- (previous-history-element arg)
- (ivy--cd-maybe)
- (move-end-of-line 1)
- (ivy--maybe-scroll-history))
-
-(defun ivy--insert-symbol-boundaries ()
- (undo-boundary)
- (beginning-of-line)
- (insert "\\_<")
- (end-of-line)
- (insert "\\_>"))
-
-(defun ivy-next-history-element (arg)
- "Forward to `next-history-element' with ARG."
- (interactive "p")
- (if (and (= minibuffer-history-position 0)
- (equal ivy-text ""))
- (progn
- (when minibuffer-default
- (setq ivy--default (car minibuffer-default)))
- (insert ivy--default)
- (when (and (with-ivy-window (derived-mode-p 'prog-mode))
- (eq (ivy-state-caller ivy-last) 'swiper)
- (not (file-exists-p ivy--default))
- (not (ivy-ffap-url-p ivy--default))
- (not (ivy-state-dynamic-collection ivy-last))
- (> (point) (minibuffer-prompt-end)))
- (ivy--insert-symbol-boundaries)))
- (next-history-element arg))
- (ivy--cd-maybe)
- (move-end-of-line 1)
- (ivy--maybe-scroll-history))
-
-(defvar ivy-ffap-url-functions nil
- "List of functions that check if the point is on a URL.")
-
-(defun ivy--cd-maybe ()
- "Check if the current input points to a different directory.
-If so, move to that directory, while keeping only the file name."
- (when ivy--directory
- (let ((input (ivy--input))
- url)
- (if (setq url (or (ivy-ffap-url-p input)
- (with-ivy-window
- (cl-reduce
- (lambda (a b)
- (or a (funcall b)))
- ivy-ffap-url-functions
- :initial-value nil))))
- (ivy-exit-with-action
- (lambda (_)
- (ivy-ffap-url-fetcher url)))
- (setq input (expand-file-name input))
- (let ((file (file-name-nondirectory input))
- (dir (expand-file-name (file-name-directory input))))
- (if (string= dir ivy--directory)
- (progn
- (delete-minibuffer-contents)
- (insert file))
- (ivy--cd dir)
- (insert file)))))))
-
-(defun ivy--maybe-scroll-history ()
- "If the selected history element has an index, scroll there."
- (let ((idx (ignore-errors
- (get-text-property
- (minibuffer-prompt-end)
- 'ivy-index))))
- (when idx
- (ivy--exhibit)
- (ivy-set-index idx))))
-
-(declare-function tramp-get-completion-methods "tramp")
-
-(defun ivy--cd (dir)
- "When completing file names, move to directory DIR."
- (if (null ivy--directory)
- (error "Unexpected")
- (setq ivy--old-cands nil)
- (setq ivy--old-re nil)
- (ivy-set-index 0)
- (setq ivy--all-candidates
- (append
- (ivy--sorted-files (setq ivy--directory dir))
- (when (and (string= dir "/") (featurep 'tramp))
- (sort
- (mapcar
- (lambda (s) (substring s 1))
- (tramp-get-completion-methods ""))
- #'string<))))
- (setq ivy-text "")
- (setf (ivy-state-directory ivy-last) dir)
- (delete-minibuffer-contents)))
-
-(defun ivy--parent-dir (filename)
- "Return parent directory of absolute FILENAME."
- (file-name-directory (directory-file-name filename)))
-
-(defun ivy-backward-delete-char ()
- "Forward to `delete-backward-char'.
-Call `ivy-on-del-error-function' if an error occurs, usually when
-there is no more text to delete at the beginning of the
-minibuffer."
- (interactive)
- (if (and ivy--directory (= (minibuffer-prompt-end) (point)))
- (progn
- (ivy--cd (ivy--parent-dir (expand-file-name ivy--directory)))
- (ivy--exhibit))
- (setq prefix-arg current-prefix-arg)
- (condition-case nil
- (call-interactively #'delete-backward-char)
- (error
- (when ivy-on-del-error-function
- (funcall ivy-on-del-error-function))))))
-
-(defun ivy-delete-char (arg)
- "Forward to `delete-char' ARG."
- (interactive "p")
- (unless (eolp)
- (delete-char arg)))
-
-(defun ivy-forward-char (arg)
- "Forward to `forward-char' ARG."
- (interactive "p")
- (unless (eolp)
- (forward-char arg)))
-
-(defun ivy-kill-word (arg)
- "Forward to `kill-word' ARG."
- (interactive "p")
- (unless (eolp)
- (kill-word arg)))
-
-(defun ivy-kill-line ()
- "Forward to `kill-line'."
- (interactive)
- (if (eolp)
- (kill-region (minibuffer-prompt-end) (point))
- (kill-line)))
-
-(defun ivy-kill-whole-line ()
- "Forward to `kill-whole-line'."
- (interactive)
- (kill-region (minibuffer-prompt-end) (line-end-position)))
-
-(defun ivy-backward-kill-word ()
- "Forward to `backward-kill-word'."
- (interactive)
- (if (and ivy--directory (= (minibuffer-prompt-end) (point)))
- (progn
- (ivy--cd (ivy--parent-dir (expand-file-name ivy--directory)))
- (ivy--exhibit))
- (ignore-errors
- (let ((pt (point)))
- (forward-word -1)
- (delete-region (point) pt)))))
-
-(defvar ivy--regexp-quote #'regexp-quote
- "Store the regexp quoting state.")
-
-(defun ivy-toggle-regexp-quote ()
- "Toggle the regexp quoting."
- (interactive)
- (setq ivy--old-re nil)
- (cl-rotatef ivy--regex-function ivy--regexp-quote))
-
-(defvar avy-all-windows)
-(defvar avy-action)
-(defvar avy-keys)
-(defvar avy-keys-alist)
-(defvar avy-style)
-(defvar avy-styles-alist)
-(declare-function avy-process "ext:avy")
-(declare-function avy--style-fn "ext:avy")
-
-(defcustom ivy-format-functions-alist
- '((t . ivy-format-function-default))
- "An alist of functions that transform the list of candidates into a string.
-This string is inserted into the minibuffer."
- :type '(alist
- :key-type symbol
- :value-type
- (choice
- (const :tag "Default" ivy-format-function-default)
- (const :tag "Arrow prefix" ivy-format-function-arrow)
- (const :tag "Full line" ivy-format-function-line)
- (function :tag "Custom function"))))
-
-(eval-after-load 'avy
- '(add-to-list 'avy-styles-alist '(ivy-avy . pre)))
-
-(defun ivy--avy-candidates ()
- (let (candidates)
- (save-excursion
- (save-restriction
- (narrow-to-region
- (window-start)
- (window-end))
- (goto-char (point-min))
- (forward-line)
- (while (< (point) (point-max))
- (push
- (cons (point)
- (selected-window))
- candidates)
- (forward-line))))
- (nreverse candidates)))
-
-(defun ivy--avy-action (pt)
- (when (number-or-marker-p pt)
- (let ((bnd (ivy--minibuffer-index-bounds
- ivy--index ivy--length ivy-height)))
- (ivy--done
- (substring-no-properties
- (nth (+ (car bnd) (- (line-number-at-pos pt) 2)) ivy--old-cands))))))
-
-(defun ivy--avy-handler-function (char)
- (let (cmd)
- (cond ((memq char '(27 ?\C-g))
- ;; exit silently
- (throw 'done 'abort))
- ((memq (setq cmd (lookup-key ivy-minibuffer-map (vector char)))
- '(ivy-scroll-up-command
- ivy-scroll-down-command))
- (funcall cmd)
- (ivy--exhibit)
- (throw 'done 'exit))
- ;; ignore wrong key
- (t
- (throw 'done 'restart)))))
-
-(defvar avy-handler-function)
-
-(defun ivy-avy ()
- "Jump to one of the current ivy candidates."
- (interactive)
- (unless (require 'avy nil 'noerror)
- (error "Package avy isn't installed"))
- (let* ((avy-all-windows nil)
- (avy-keys (or (cdr (assq 'ivy-avy avy-keys-alist))
- avy-keys))
- (avy-style (or (cdr (assq 'ivy-avy avy-styles-alist))
- avy-style))
- (avy-action #'identity)
- (avy-handler-function #'ivy--avy-handler-function)
- res)
- (while (eq (setq res (avy-process (ivy--avy-candidates))) t))
- (when res
- (ivy--avy-action res))))
-
-(defun ivy-sort-file-function-default (x y)
- "Compare two files X and Y.
-Prioritize directories."
- (if (get-text-property 0 'dirp x)
- (if (get-text-property 0 'dirp y)
- (string< (directory-file-name x) (directory-file-name y))
- t)
- (if (get-text-property 0 'dirp y)
- nil
- (string< x y))))
-
-(defun ivy-string< (x y)
- "Like `string<', but operate on CARs when given cons cells."
- (string< (if (consp x) (car x) x)
- (if (consp y) (car y) y)))
-
-(define-obsolete-function-alias 'ivy-sort-file-function-using-ido
- 'ido-file-extension-lessp "<2019-10-12 Sat>")
-
-(defcustom ivy-sort-functions-alist
- '((t . ivy-string<))
- "An alist of sorting functions for each collection function.
-Interactive functions that call completion fit in here as well.
-
-Nil means no sorting, which is useful to turn off the sorting for
-functions that have candidates in the natural buffer order, like
-`org-refile' or `Man-goto-section'.
-
-A list can be used to associate multiple sorting functions with a
-collection. The car of the list is the current sort
-function. This list can be rotated with `ivy-rotate-sort'.
-
-The entry associated with t is used for all fall-through cases.
-
-See also `ivy-sort-max-size'."
- :type
- '(alist
- :key-type (choice
- (const :tag "Fall-through" t)
- (symbol :tag "Collection"))
- :value-type (choice
- (const :tag "Plain sort" string-lessp)
- (const :tag "File sort" ivy-sort-file-function-default)
- (const :tag "File sort using Ido" ido-file-extension-lessp)
- (const :tag "No sort" nil)
- (function :tag "Custom function")
- (repeat (function :tag "Custom function")))))
-
-(defun ivy--sort-function (collection)
- "Retrieve sort function for COLLECTION from `ivy-sort-functions-alist'."
- (let ((entry (cdr (or (assq collection ivy-sort-functions-alist)
- (assq (ivy-state-caller ivy-last)
ivy-sort-functions-alist)
- (assq t ivy-sort-functions-alist)))))
- (and (or (functionp entry)
- (functionp (setq entry (car-safe entry))))
- entry)))
-
-(defun ivy-rotate-sort ()
- "Rotate through sorting functions available for current collection.
-This only has an effect if multiple sorting functions are
-specified for the current collection in
-`ivy-sort-functions-alist'."
- (interactive)
- (let ((cell (or (assq (ivy-state-collection ivy-last)
ivy-sort-functions-alist)
- (assq (ivy-state-caller ivy-last)
ivy-sort-functions-alist))))
- (when (consp (cdr cell))
- (setcdr cell (nconc (cddr cell) (list (cadr cell))))
- (ivy--reset-state ivy-last))))
-
-(defvar ivy-index-functions-alist
- '((t . ivy-recompute-index-zero))
- "An alist of index recomputing functions for each collection function.
-When the input changes, the appropriate function returns an
-integer - the index of the matched candidate that should be
-selected.")
-
-(defvar ivy-re-builders-alist
- '((t . ivy--regex-plus))
- "An alist of regex building functions for each collection function.
-
-Each key is (in order of priority):
-1. The actual collection function, e.g. `read-file-name-internal'.
-2. The symbol passed by :caller into `ivy-read'.
-3. `this-command'.
-4. t.
-
-Each value is a function that should take a string and return a
-valid regex or a regex sequence (see below).
-
-Possible choices: `ivy--regex', `regexp-quote',
-`ivy--regex-plus', `ivy--regex-fuzzy', `ivy--regex-ignore-order'.
-
-If a function returns a list, it should format like this:
-'((\"matching-regexp\" . t) (\"non-matching-regexp\") ...).
-
-The matches will be filtered in a sequence, you can mix the
-regexps that should match and that should not match as you
-like.")
-
-(defvar ivy-highlight-functions-alist
- '((ivy--regex-ignore-order . ivy--highlight-ignore-order)
- (ivy--regex-fuzzy . ivy--highlight-fuzzy)
- (ivy--regex-plus . ivy--highlight-default))
- "An alist of highlighting functions for each regex builder function.")
-
-(defcustom ivy-initial-inputs-alist
- '((org-refile . "^")
- (org-agenda-refile . "^")
- (org-capture-refile . "^")
- (Man-completion-table . "^")
- (woman . "^"))
- "An alist associating commands with their initial input.
-
-Each cdr is either a string or a function called in the context
-of a call to `ivy-read'."
- :type '(alist
- :key-type (symbol)
- :value-type (choice (string) (function))))
-
-(defcustom ivy-hooks-alist nil
- "An alist associating commands to setup functions.
-Examples: `toggle-input-method', (lambda () (insert \"^\")), etc.
-May supersede `ivy-initial-inputs-alist'."
- :type '(alist :key-type symbol :value-type function))
-
-(defvar ivy--occurs-list nil
- "A list of custom occur generators per command.")
-
-(defun ivy-set-occur (cmd occur)
- "Assign CMD a custom OCCUR function."
- (setq ivy--occurs-list
- (plist-put ivy--occurs-list cmd occur)))
-
-(defcustom ivy-update-fns-alist nil
- "An alist associating commands to their :update-fn values."
- :type '(alist
- :key-type symbol
- :value-type
- (radio
- (const :tag "Off" nil)
- (const :tag "Call action on change" auto))))
-
-(defvar ivy-unwind-fns-alist nil
- "An alist associating commands to their :unwind values.")
-
-(defun ivy--alist-set (alist-sym key val)
- (let ((cell (assoc key (symbol-value alist-sym))))
- (if cell
- (setcdr cell val)
- (set alist-sym (cons (cons key val)
- (symbol-value alist-sym))))))
-
-(declare-function counsel-set-async-exit-code "counsel")
-
-(cl-defun ivy-configure (caller
- &key
- initial-input
- height
- occur
- update-fn
- unwind-fn
- index-fn
- sort-fn
- format-fn
- display-transformer-fn
- more-chars
- grep-p
- exit-codes)
- "Configure `ivy-read' params for CALLER."
- (declare (indent 1))
- (when initial-input
- (ivy--alist-set 'ivy-initial-inputs-alist caller initial-input))
- (when height
- (ivy--alist-set 'ivy-height-alist caller height))
- (when occur
- (ivy-set-occur caller occur))
- (when update-fn
- (ivy--alist-set 'ivy-update-fns-alist caller update-fn))
- (when unwind-fn
- (ivy--alist-set 'ivy-unwind-fns-alist caller unwind-fn))
- (when index-fn
- (ivy--alist-set 'ivy-index-functions-alist caller index-fn))
- (when sort-fn
- (ivy--alist-set 'ivy-sort-functions-alist caller sort-fn))
- (when format-fn
- (ivy--alist-set 'ivy-format-functions-alist caller format-fn))
- (when display-transformer-fn
- (ivy-set-display-transformer caller display-transformer-fn))
- (when more-chars
- (ivy--alist-set 'ivy-more-chars-alist caller more-chars))
- (when grep-p
- (cl-pushnew caller ivy-highlight-grep-commands))
- (when exit-codes
- (let (code msg)
- (while (and (setq code (pop exit-codes))
- (setq msg (pop exit-codes)))
- (counsel-set-async-exit-code caller code msg)))))
-
-(defcustom ivy-sort-max-size 30000
- "Sorting won't be done for collections larger than this."
- :type 'integer)
-
-(defalias 'ivy--dirname-p
- (if (fboundp 'directory-name-p)
- #'directory-name-p
- (lambda (name)
- "Return non-nil if NAME ends with a directory separator."
- (string-match-p "/\\'" name))))
-
-(defun ivy--sorted-files (dir)
- "Return the list of files in DIR.
-Directories come first."
- (let* ((default-directory dir)
- (seq (condition-case nil
- (mapcar (lambda (s) (replace-regexp-in-string "\\$\\$" "$"
s))
- (all-completions "" #'read-file-name-internal
- (ivy-state-predicate ivy-last)))
- (error
- (directory-files dir))))
- sort-fn)
- (setq seq (delete "./" (delete "../" seq)))
- (when (eq (setq sort-fn (ivy--sort-function #'read-file-name-internal))
- #'ivy-sort-file-function-default)
- (setq seq (mapcar (lambda (x)
- (propertize x 'dirp (ivy--dirname-p x)))
- seq)))
- (when sort-fn
- (setq seq (sort seq sort-fn)))
- (dolist (dir ivy-extra-directories)
- (push dir seq))
- (if (string= dir "/")
- (cl-remove-if (lambda (s) (string-match ":$" s)) (delete "../" seq))
- seq)))
-
-(defun ivy-alist-setting (alist &optional key)
- "Return the value associated with KEY in ALIST, using `assq'.
-KEY defaults to the last caller of `ivy-read'; if no entry is
-found, it falls back to the key t."
- (cdr (or (let ((caller (or key (ivy-state-caller ivy-last))))
- (and caller (assq caller alist)))
- (assq t alist))))
-
-(defun ivy--height (caller)
- (let ((v (or (ivy-alist-setting ivy-height-alist caller)
- ivy-height)))
- (if (integerp v)
- v
- (if (functionp v)
- (funcall v caller)
- (error "Unexpected value: %S" v)))))
-
-(defun ivy--remove-props (str &rest props)
- "Return STR with text PROPS destructively removed."
- (ignore-errors
- (remove-list-of-text-properties 0 (length str) props str))
- str)
-
-;;** Entry Point
-;;;###autoload
-(cl-defun ivy-read (prompt collection
- &key
- predicate require-match initial-input
- history preselect def keymap update-fn sort
- action multi-action
- unwind re-builder matcher
- dynamic-collection
- extra-props
- caller)
- "Read a string in the minibuffer, with completion.
-
-PROMPT is a string, normally ending in a colon and a space.
-`ivy-count-format' is prepended to PROMPT during completion.
-
-COLLECTION is either a list of strings, a function, an alist, or
-a hash table, supplied for `minibuffer-completion-table'.
-
-PREDICATE is applied to filter out the COLLECTION immediately.
-This argument is for compatibility with `completing-read'.
-
-When REQUIRE-MATCH is non-nil, only members of COLLECTION can be
-selected.
-
-If INITIAL-INPUT is non-nil, then insert that input in the
-minibuffer initially.
-
-HISTORY is a name of a variable to hold the completion session
-history.
-
-KEYMAP is composed with `ivy-minibuffer-map'.
-
-PRESELECT, when non-nil, determines which one of the candidates
-matching INITIAL-INPUT to select initially. An integer stands
-for the position of the desired candidate in the collection,
-counting from zero. Otherwise, use the first occurrence of
-PRESELECT in the collection. Comparison is first done with
-`equal'. If that fails, and when applicable, match PRESELECT as
-a regular expression.
-
-DEF is for compatibility with `completing-read'.
-
-UPDATE-FN is called each time the candidate list is re-displayed.
-
-When SORT is non-nil, `ivy-sort-functions-alist' determines how
-to sort candidates before displaying them.
-
-ACTION is a function to call after selecting a candidate.
-It takes one argument, the selected candidate. If COLLECTION is
-an alist, the argument is a cons cell, otherwise it's a string.
-
-MULTI-ACTION, when non-nil, is called instead of ACTION when
-there are marked candidates. It takes the list of candidates as
-its only argument. When it's nil, ACTION is called on each marked
-candidate.
-
-UNWIND is a function of no arguments to call before exiting.
-
-RE-BUILDER is a function transforming input text into a regex
-pattern.
-
-MATCHER is a function which can override how candidates are
-filtered based on user input. It takes a regex pattern and a
-list of candidates, and returns the list of matching candidates.
-
-DYNAMIC-COLLECTION is a boolean specifying whether the list of
-candidates is updated after each input by calling COLLECTION.
-
-EXTRA-PROPS can be used to store collection-specific
-session-specific data.
-
-CALLER is a symbol to uniquely identify the caller to `ivy-read'.
-It is used, along with COLLECTION, to determine which
-customizations apply to the current completion session."
- ;; get un-stuck from an existing `read-key' overriding minibuffer keys
- (when (equal overriding-local-map '(keymap))
- (keyboard-quit))
- (setq caller (or caller this-command))
- (let* ((ivy-recursive-last (and (active-minibuffer-window) ivy-last))
- (ivy--display-function
- (when (or ivy-recursive-last
- (not (window-minibuffer-p)))
- (ivy-alist-setting ivy-display-functions-alist caller)))
- result)
- (setq update-fn (or update-fn (ivy-alist-setting ivy-update-fns-alist
caller)))
- (setq unwind (or unwind (ivy-alist-setting ivy-unwind-fns-alist caller)))
- (setq ivy-last
- (make-ivy-state
- :prompt prompt
- :collection collection
- :predicate predicate
- :require-match require-match
- :initial-input initial-input
- :history history
- :preselect preselect
- :keymap keymap
- :update-fn (if (eq update-fn 'auto)
- (lambda ()
- (with-ivy-window
- (funcall
- (ivy--get-action ivy-last)
- (if (consp (car-safe (ivy-state-collection
ivy-last)))
- (assoc (ivy-state-current ivy-last)
- (ivy-state-collection ivy-last))
- (ivy-state-current ivy-last)))))
- update-fn)
- :sort sort
- :action (ivy--compute-extra-actions action caller)
- :multi-action multi-action
- :frame (selected-frame)
- :window (selected-window)
- :buffer (current-buffer)
- :unwind unwind
- :re-builder re-builder
- :matcher matcher
- :dynamic-collection dynamic-collection
- :display-transformer-fn (plist-get ivy--display-transformers-list
caller)
- :directory default-directory
- :extra-props extra-props
- :caller caller
- :def def))
- (ivy--reset-state ivy-last)
- (unwind-protect
- (minibuffer-with-setup-hook
- #'ivy--minibuffer-setup
- (let* ((hist (or history 'ivy-history))
- (minibuffer-completion-table collection)
- (minibuffer-completion-predicate predicate)
- (ivy-height (ivy--height caller))
- (resize-mini-windows (unless (display-graphic-p)
- 'grow-only)))
- (if (and ivy-auto-select-single-candidate
- ivy--all-candidates
- (null (cdr ivy--all-candidates)))
- (progn
- (setf (ivy-state-current ivy-last)
- (car ivy--all-candidates))
- (setq ivy-exit 'done))
- (read-from-minibuffer
- prompt
- (ivy-state-initial-input ivy-last)
- (make-composed-keymap keymap ivy-minibuffer-map)
- nil
- hist))
- (when (eq ivy-exit 'done)
- (let ((item (if ivy--directory
- (ivy-state-current ivy-last)
- ivy-text)))
- (unless (equal item "")
- (set hist (cons (propertize item 'ivy-index ivy--index)
- (delete item
- (cdr (symbol-value hist))))))))
- (setq result (ivy-state-current ivy-last))))
- (ivy--cleanup))
- (ivy-call)
- (ivy--remove-props (ivy-state-current ivy-last) 'idx)
- result))
-
-(defun ivy--cleanup ()
- ;; Fixes a bug in ESS, #1660
- (put 'post-command-hook 'permanent-local nil)
- (remove-hook 'post-command-hook #'ivy--queue-exhibit)
- (let ((cleanup (ivy--display-function-prop :cleanup))
- (unwind (ivy-state-unwind ivy-last)))
- (when (functionp cleanup)
- (funcall cleanup))
- (when unwind
- (funcall unwind)))
- (ivy--pulse-cleanup)
- (unless (eq ivy-exit 'done)
- (ivy-recursive-restore)))
-
-(defun ivy--display-function-prop (prop)
- "Return PROP associated with current `ivy--display-function'."
- (plist-get (cdr (assq ivy--display-function
- ivy-display-functions-props))
- prop))
-
-(defvar Info-complete-menu-buffer)
-
-(defun ivy--reset-state (state)
- "Reset the ivy to STATE.
-This is useful for recursive `ivy-read'."
- (setq ivy-marked-candidates nil)
- (unless (equal (selected-frame) (ivy-state-frame state))
- (select-window (active-minibuffer-window)))
- (let* ((prompt (or (ivy-state-prompt state) ""))
- (collection (ivy-state-collection state))
- (predicate (ivy-state-predicate state))
- (history (ivy-state-history state))
- (preselect (ivy-state-preselect state))
- (re-builder (ivy-state-re-builder state))
- (dynamic-collection (ivy-state-dynamic-collection state))
- (require-match (ivy-state-require-match state))
- (caller (or (ivy-state-caller state) this-command))
- (sort (or (ivy-state-sort state) (assoc caller
ivy-sort-functions-alist)))
- (initial-input
- (or (ivy-state-initial-input state)
- (let ((init (cdr (assq caller ivy-initial-inputs-alist))))
- (cond ((functionp init)
- (funcall init))
- (t
- init)))))
- (def (ivy-state-def state)))
- (setq ivy--extra-candidates (ivy--compute-extra-candidates caller))
- (setq ivy--directory nil)
- (setq ivy-case-fold-search ivy-case-fold-search-default)
- (setq ivy--regex-function
- (or re-builder
- (and (functionp collection)
- (cdr (assq collection ivy-re-builders-alist)))
- (ivy-alist-setting ivy-re-builders-alist)
- #'ivy--regex))
- (setq ivy--subexps 0)
- (setq ivy--regexp-quote #'regexp-quote)
- (setq ivy--old-text "")
- (setq ivy--full-length nil)
- (setq ivy-text "")
- (setq ivy--index 0)
- (setq ivy-calling nil)
- (setq ivy-use-ignore ivy-use-ignore-default)
- (setf (ivy-state-ignore state) ivy-use-ignore)
- (setq ivy--highlight-function
- (or (cdr (assq ivy--regex-function ivy-highlight-functions-alist))
- #'ivy--highlight-default))
- (let (coll sort-fn)
- (cond ((eq collection #'Info-read-node-name-1)
- (setq coll
- (if (equal (bound-and-true-p Info-current-file) "dir")
- (mapcar (lambda (x) (format "(%s)" x))
- (delete-dups
- (all-completions "(" collection predicate)))
- (all-completions "" collection predicate))))
- ((eq collection #'read-file-name-internal)
- (require 'tramp)
- (when (and (equal def initial-input)
- (member "./" ivy-extra-directories))
- (setq def nil))
- (setq ivy--directory default-directory)
- (when (and initial-input
- (not (equal initial-input "")))
- (cond ((file-directory-p initial-input)
- (when (equal (file-name-nondirectory initial-input) "")
- (setf (ivy-state-preselect state) (setq preselect nil))
- (setq def nil))
- (setq ivy--directory (file-name-as-directory
initial-input))
- (setq initial-input nil)
- (when preselect
- (let ((preselect-directory
- (file-name-directory preselect)))
- (when (and preselect-directory
- (not (equal
- (expand-file-name
- preselect-directory)
- (expand-file-name ivy--directory))))
- (setf (ivy-state-preselect state)
- (setq preselect nil))))))
- ((ignore-errors
- (file-exists-p (file-name-directory initial-input)))
- (setq ivy--directory (file-name-directory initial-input))
- (setf (ivy-state-preselect state)
- (file-name-nondirectory initial-input)))))
- (require 'dired)
- (when preselect
- (let ((preselect-directory (ivy--parent-dir preselect)))
- (when (and preselect-directory
- (not (string= preselect-directory
- default-directory)))
- (setq ivy--directory preselect-directory))
- (setq preselect (file-relative-name preselect
- preselect-directory))
- (setf (ivy-state-preselect state) preselect)))
- (setq sort nil)
- (setq coll (ivy--sorted-files ivy--directory))
- (when initial-input
- (unless (or require-match
- (equal initial-input default-directory)
- (equal initial-input ""))
- (setq coll (cons initial-input coll)))
- (when (or (not (ivy-state-action ivy-last))
- (equal (ivy--get-action ivy-last) 'identity))
- (setq initial-input nil))))
- ((eq collection #'internal-complete-buffer)
- (setq prompt
- (replace-regexp-in-string "RET to end" "C-M-j to end"
prompt))
- (setq coll (ivy--buffer-list
- ""
- (and ivy-use-virtual-buffers
- (member caller '(ivy-switch-buffer
- ivy-switch-buffer-other-window
- counsel-switch-buffer)))
- predicate)))
- (dynamic-collection
- (setq coll (funcall collection (or initial-input ""))))
- ((consp (car-safe collection))
- (setq collection (cl-remove-if-not predicate collection))
- (when (and sort (setq sort-fn (ivy--sort-function caller)))
- (setq collection (sort (copy-sequence collection) sort-fn))
- (setq sort nil))
- (setf (ivy-state-collection ivy-last) collection)
- (setq coll (let ((i -1))
- (mapcar (lambda (x)
- (propertize x 'idx (cl-incf i)))
- (all-completions "" collection)))))
- ((or (functionp collection)
- (byte-code-function-p collection)
- (vectorp collection)
- (hash-table-p collection)
- (and (listp collection) (symbolp (car collection))))
- (let ((Info-complete-menu-buffer
- ;; FIXME: This is a temporary workaround for issue #1803.
- (or (bound-and-true-p Info-complete-menu-buffer)
- (ivy-state-buffer state))))
- (setq coll (all-completions "" collection predicate))))
- (t
- (setq coll (all-completions "" collection predicate))))
- (unless (ivy-state-dynamic-collection ivy-last)
- (setq coll (delete "" coll)))
- (when def
- (cond ((stringp (car-safe def))
- (setq coll (cl-union def coll :test #'equal)))
- ((and (stringp def) (not (member def coll)))
- (push def coll))))
- (when (and sort
- (or (functionp collection)
- (not (eq history 'org-refile-history)))
- (setq sort-fn (ivy--sort-function
- (if (functionp collection) collection caller)))
- (null (nthcdr ivy-sort-max-size coll)))
- (setq coll (sort (copy-sequence coll) sort-fn)))
- (setq coll (ivy--set-candidates coll))
- (setq ivy--old-re nil)
- (setq ivy--old-cands nil)
- (when initial-input
- ;; Needed for anchor to work
- (setq ivy--old-cands coll)
- (setq ivy--old-cands (ivy--filter initial-input coll)))
- (unless (setq ivy--trying-to-resume-dynamic-collection
- (and preselect dynamic-collection))
- (when (integerp preselect)
- (setq ivy--old-re "")
- (ivy-set-index preselect)))
- (setq ivy--all-candidates coll)
- (unless (integerp preselect)
- (ivy-set-index (or
- (and dynamic-collection
- ivy--index)
- (and preselect
- (ivy--preselect-index
- preselect
- (if initial-input
- ivy--old-cands
- coll)))
- 0))))
- (setq ivy-exit nil)
- (setq ivy--default
- (if (region-active-p)
- (buffer-substring (region-beginning) (region-end))
- (ivy-thing-at-point)))
- (setq ivy--prompt (ivy-add-prompt-count (ivy--quote-format-string prompt)))
- (setq ivy--use-selectable-prompt (ivy--prompt-selectable-p))
- (setf (ivy-state-initial-input ivy-last) initial-input)))
-
-(defun ivy-add-prompt-count (prompt)
- "Add count information to PROMPT."
- (cond ((null ivy-count-format)
- (error
- "`ivy-count-format' can't be nil. Set it to \"\" instead"))
- ((string-match "%d.*\\(%d\\)" ivy-count-format)
- (let* ((w (1+ (floor (log (max 1 (length ivy--all-candidates)) 10))))
- (s (replace-match (format "%%-%dd" w) t t ivy-count-format 1)))
- (string-match "%d" s)
- (concat (replace-match (format "%%%dd" w) t t s)
- prompt)))
- ((string-match-p "%.*d" ivy-count-format)
- (concat ivy-count-format prompt))
- (ivy--directory
- prompt)
- (t
- prompt)))
-
-(defun ivy--quote-format-string (str)
- "Make STR suitable for `format' with no extra arguments."
- (replace-regexp-in-string "%" "%%" str t t))
-
-;;;###autoload
-(defun ivy-completing-read (prompt collection
- &optional predicate require-match initial-input
- history def inherit-input-method)
- "Read a string in the minibuffer, with completion.
-
-This interface conforms to `completing-read' and can be used for
-`completing-read-function'.
-
-PROMPT is a string that normally ends in a colon and a space.
-COLLECTION is either a list of strings, an alist, an obarray, or a hash table.
-PREDICATE limits completion to a subset of COLLECTION.
-REQUIRE-MATCH is a boolean value. See `completing-read'.
-INITIAL-INPUT is a string inserted into the minibuffer initially.
-HISTORY is a list of previously selected inputs.
-DEF is the default value.
-INHERIT-INPUT-METHOD is currently ignored."
- (let ((handler
- (and (< ivy-completing-read-ignore-handlers-depth (minibuffer-depth))
- (assq this-command ivy-completing-read-handlers-alist))))
- (if handler
- (let ((completion-in-region-function #'completion--in-region)
- (ivy-completing-read-ignore-handlers-depth (1+
(minibuffer-depth))))
- (funcall (cdr handler)
- prompt collection
- predicate require-match
- initial-input history
- def inherit-input-method))
- ;; See the doc of `completing-read'.
- (when (consp history)
- (when (numberp (cdr history))
- (setq initial-input (nth (1- (cdr history))
- (symbol-value (car history)))))
- (setq history (car history)))
- (when (consp def)
- (setq def (car def)))
- (let ((str (ivy-read
- prompt collection
- :predicate predicate
- :require-match (and collection require-match)
- :initial-input (cond ((consp initial-input)
- (car initial-input))
- ((and (stringp initial-input)
- (not (eq collection
#'read-file-name-internal))
- (string-match-p "\\+"
initial-input))
- (replace-regexp-in-string
- "\\+" "\\\\+" initial-input))
- (t
- initial-input))
- :preselect def
- :def def
- :history history
- :keymap nil
- :dynamic-collection ivy-completing-read-dynamic-collection
- :caller (if (and collection (symbolp collection))
- collection
- this-command))))
- (if (string= str "")
- ;; For `completing-read' compat, return the first element of
- ;; DEFAULT, if it is a list; "", if DEFAULT is nil; or DEFAULT.
- (or def "")
- str)))))
-
-(defun ivy-completing-read-with-empty-string-def
- (prompt collection
- &optional predicate require-match initial-input
- history def inherit-input-method)
- "Same as `ivy-completing-read' but with different handling of DEF.
-
-Specifically, if DEF is nil, it is treated the same as if DEF was
-the empty string. This mimics the behavior of
-`completing-read-default'. This function can therefore be used in
-place of `ivy-completing-read' for commands that rely on this
-behavior."
- (ivy-completing-read
- prompt collection predicate require-match initial-input
- history (or def "") inherit-input-method))
-
-(declare-function mc/all-fake-cursors "ext:multiple-cursors-core")
-
-(defun ivy-completion-in-region-action (str)
- "Insert STR, erasing the previous one.
-The previous string is between `ivy-completion-beg' and `ivy-completion-end'."
- (when (consp str)
- (setq str (cdr str)))
- (when (stringp str)
- (let ((fake-cursors (and (require 'multiple-cursors-core nil t)
- (mc/all-fake-cursors)))
- (pt (point))
- (beg ivy-completion-beg)
- (end ivy-completion-end))
- (when beg
- (delete-region beg end))
- (setq ivy-completion-beg (point))
- (insert (substring-no-properties str))
- (completion--done str 'exact)
- (setq ivy-completion-end (point))
- (save-excursion
- (dolist (cursor fake-cursors)
- (goto-char (overlay-start cursor))
- (delete-region (+ (point) (- beg pt))
- (+ (point) (- end pt)))
- (insert (substring-no-properties str))
- ;; manually move the fake cursor
- (move-overlay cursor (point) (1+ (point)))
- (set-marker (overlay-get cursor 'point) (point))
- (set-marker (overlay-get cursor 'mark) (point)))))))
-
-(defun ivy-completion-common-length (str)
- "Return the amount of characters that match in STR.
-
-`completion-all-completions' computes this and returns the result
-via text properties.
-
-The first non-matching part is propertized:
-- either with: (face (completions-first-difference))
-- or: (font-lock-face completions-first-difference)."
- (let ((char-property-alias-alist '((face font-lock-face)))
- (i (1- (length str))))
- (catch 'done
- (while (>= i 0)
- (when (equal (get-text-property i 'face str)
- '(completions-first-difference))
- (throw 'done i))
- (cl-decf i))
- (throw 'done (length str)))))
-
-(defun ivy-completion-in-region (start end collection &optional predicate)
- "An Ivy function suitable for `completion-in-region-function'.
-The function completes the text between START and END using COLLECTION.
-PREDICATE (a function called with no arguments) says when to exit.
-See `completion-in-region' for further information."
- (let* ((enable-recursive-minibuffers t)
- (str (buffer-substring-no-properties start end))
- (completion-ignore-case (ivy--case-fold-p str))
- (comps
- (completion-all-completions str collection predicate (- end start))))
- (cond ((null comps)
- (message "No matches"))
- ((progn
- (nconc comps nil)
- (and (null (cdr comps))
- (string= str (car comps))))
- (message "Sole match"))
- (t
- (when (eq collection 'crm--collection-fn)
- (setq comps (delete-dups comps)))
- (let* ((len (ivy-completion-common-length (car comps)))
- (initial (cond ((= len 0)
- "")
- ((let ((str-len (length str)))
- (when (> len str-len)
- (setq len str-len)
- str)))
- (t
- (substring str (- len))))))
- (setq ivy--old-re nil)
- (unless (ivy--filter initial comps)
- (setq initial nil))
- (delete-region (- end len) end)
- (setq ivy-completion-beg (- end len))
- (setq ivy-completion-end ivy-completion-beg)
- (if (null (cdr comps))
- (progn
- (unless (minibuffer-window-active-p (selected-window))
- (setf (ivy-state-window ivy-last) (selected-window)))
- (ivy-completion-in-region-action
- (substring-no-properties (car comps))))
- (dolist (s comps)
- ;; Remove face `completions-first-difference'.
- (ivy--remove-props s 'face))
- (ivy-read (format "(%s): " str) comps
- ;; Predicate was already applied by
- ;; `completion-all-completions'.
- :predicate nil
- :initial-input initial
- :action #'ivy-completion-in-region-action
- :unwind (lambda ()
- (unless (eq ivy-exit 'done)
- (goto-char ivy-completion-beg)
- (when initial
- (insert initial))))
- :caller 'ivy-completion-in-region)
- t))))))
-
-(defun ivy-completion-in-region-prompt ()
- "Prompt function for `ivy-completion-in-region'.
-See `ivy-set-prompt'."
- (and (window-minibuffer-p (ivy-state-window ivy-last))
- (ivy-add-prompt-count (ivy-state-prompt ivy-last))))
-
-(ivy-set-prompt #'ivy-completion-in-region #'ivy-completion-in-region-prompt)
-
-(defcustom ivy-do-completion-in-region t
- "When non-nil `ivy-mode' will set `completion-in-region-function'."
- :type 'boolean)
-
-;;;###autoload
-(define-minor-mode ivy-mode
- "Toggle Ivy mode on or off.
-Turn Ivy mode on if ARG is positive, off otherwise.
-Turning on Ivy mode sets `completing-read-function' to
-`ivy-completing-read'.
-
-Global bindings:
-\\{ivy-mode-map}
-
-Minibuffer bindings:
-\\{ivy-minibuffer-map}"
- :group 'ivy
- :global t
- :keymap ivy-mode-map
- :lighter " ivy"
- (if ivy-mode
- (progn
- (setq completing-read-function 'ivy-completing-read)
- (when ivy-do-completion-in-region
- (setq completion-in-region-function 'ivy-completion-in-region)))
- (setq completing-read-function 'completing-read-default)
- (setq completion-in-region-function 'completion--in-region)))
-
-(defun ivy--preselect-index (preselect candidates)
- "Return the index of PRESELECT in CANDIDATES."
- (cond ((integerp preselect)
- (if (integerp (car candidates))
- (cl-position preselect candidates)
- preselect))
- ((cl-position preselect candidates :test #'equal))
- ((ivy--regex-p preselect)
- (cl-position preselect candidates :test #'string-match-p))))
-
-;;* Implementation
-;;** Regex
-(defun ivy-re-match (re-seq str)
- "Return non-nil if RE-SEQ is matched by STR.
-
-RE-SEQ is a list of (RE . MATCH-P).
-
-RE is a regular expression.
-
-MATCH-P is t when RE should match STR and nil when RE should not
-match STR.
-
-Each element of RE-SEQ must match for the function to return true.
-
-This concept is used to generalize regular expressions for
-`ivy--regex-plus' and `ivy--regex-ignore-order'."
- (let ((res t)
- re)
- (while (and res (setq re (pop re-seq)))
- (setq res
- (if (cdr re)
- (string-match-p (car re) str)
- (not (string-match-p (car re) str)))))
- res))
-
-(defvar ivy--regex-hash
- (make-hash-table :test #'equal)
- "Store pre-computed regex.")
-
-(defun ivy--split (str)
- "Split STR into list of substrings bounded by spaces.
-Single spaces act as splitting points. Consecutive spaces
-\"quote\" their preceding spaces, i.e., guard them from being
-split. This allows the literal interpretation of N spaces by
-inputting N+1 spaces. Any substring not constituting a valid
-regexp is passed to `regexp-quote'."
- (let ((len (length str))
- start0
- (start1 0)
- res s
- match-len)
- (while (and (string-match " +" str start1)
- (< start1 len))
- (if (and (> (match-beginning 0) 2)
- (string= "[^" (substring
- str
- (- (match-beginning 0) 2)
- (match-beginning 0))))
- (progn
- (setq start0 start1)
- (setq start1 (match-end 0)))
- (setq match-len (- (match-end 0) (match-beginning 0)))
- (if (= match-len 1)
- (progn
- (when start0
- (setq start1 start0)
- (setq start0 nil))
- (push (substring str start1 (match-beginning 0)) res)
- (setq start1 (match-end 0)))
- (setq str (replace-match
- (make-string (1- match-len) ?\ )
- nil nil str))
- (setq start0 (or start0 start1))
- (setq start1 (1- (match-end 0))))))
- (if start0
- (push (substring str start0) res)
- (setq s (substring str start1))
- (unless (= (length s) 0)
- (push s res)))
- (mapcar #'ivy--regex-or-literal (nreverse res))))
-
-(defun ivy--trim-trailing-re (regex)
- "Trim incomplete REGEX.
-If REGEX ends with \\|, trim it, since then it matches an empty string."
- (if (string-match "\\`\\(.*\\)[\\]|\\'" regex)
- (match-string 1 regex)
- regex))
-
-(defun ivy--regex (str &optional greedy)
- "Re-build regex pattern from STR in case it has a space.
-When GREEDY is non-nil, join words in a greedy way."
- (let ((hashed (unless greedy
- (gethash str ivy--regex-hash))))
- (if hashed
- (progn
- (setq ivy--subexps (car hashed))
- (cdr hashed))
- (when (string-match-p "\\(?:[^\\]\\|^\\)\\\\\\'" str)
- (setq str (substring str 0 -1)))
- (setq str (ivy--trim-trailing-re str))
- (cdr (puthash str
- (let ((subs (ivy--split str)))
- (if (= (length subs) 1)
- (cons
- (setq ivy--subexps 0)
- (if (string-match-p "\\`\\.[^.]" (car subs))
- (concat "\\." (substring (car subs) 1))
- (car subs)))
- (cons
- (setq ivy--subexps (length subs))
- (mapconcat
- (lambda (x)
- (if (string-match-p "\\`\\\\([^?].*\\\\)\\'" x)
- x
- (format "\\(%s\\)" x)))
- subs
- (if greedy ".*" ".*?")))))
- ivy--regex-hash)))))
-
-(defun ivy--regex-p (object)
- "Return OBJECT if it is a valid regular expression, else nil."
- (ignore-errors (string-match-p object "") object))
-
-(defun ivy--regex-or-literal (str)
- "If STR isn't a legal regexp, escape it."
- (or (ivy--regex-p str) (regexp-quote str)))
-
-(defun ivy--split-negation (str)
- "Split STR into text before and after ! delimiter.
-Do not split if the delimiter is escaped as \\!.
-
-Assumes there is at most one un-escaped delimiter and discards
-text after delimiter if it is empty. Modifies match data."
- (unless (string= str "")
- (let ((delim "\\(?:\\`\\|[^\\]\\)\\(!\\)"))
- (mapcar (lambda (split)
- ;; Store "\!" as "!".
- (replace-regexp-in-string "\\\\!" "!" split t t))
- (if (string-match delim str)
- ;; Ignore everything past first un-escaped ! rather than
- ;; crashing. We can't warn or error because the minibuffer
is
- ;; already active.
- (let* ((i (match-beginning 1))
- (j (and (string-match delim str (1+ i))
- (match-beginning 1)))
- (neg (substring str (1+ i) j)))
- (cons (substring str 0 i)
- (and (not (string= neg ""))
- (list neg))))
- (list str))))))
-
-(defun ivy--split-spaces (str)
- "Split STR on spaces, unless they're preceded by \\.
-No un-escaped spaces are left in the output. Any substring not
-constituting a valid regexp is passed to `regexp-quote'."
- (when str
- (let ((i 0) ; End of last search.
- (j 0) ; End of last delimiter.
- parts)
- (while (string-match "\\(\\\\ \\)\\| +" str i)
- (setq i (match-end 0))
- (if (not (match-beginning 1))
- ;; Un-escaped space(s).
- (let ((delim (match-beginning 0)))
- (when (< j delim)
- (push (substring str j delim) parts))
- (setq j i))
- ;; Store "\ " as " ".
- (setq str (replace-match " " t t str 1))
- (setq i (1- i))))
- (when (< j (length str))
- (push (substring str j) parts))
- (mapcar #'ivy--regex-or-literal (nreverse parts)))))
-
-(defun ivy--regex-ignore-order (str)
- "Re-build regex from STR by splitting at spaces and using ! for negation.
-
-Examples:
-foo -> matches \"foo\"
-foo bar -> matches if both \"foo\" and \"bar\" match (any order)
-foo !bar -> matches if \"foo\" matches and \"bar\" does not match
-foo !bar baz -> matches if \"foo\" matches and neither \"bar\" nor \"baz\"
match
-foo[a-z] -> matches \"foo[a-z]\"
-
-Escaping examples:
-foo\\!bar -> matches \"foo!bar\"
-foo\\ bar -> matches \"foo bar\"
-
-Returns a list suitable for `ivy-re-match'."
- (setq str (ivy--trim-trailing-re str))
- (let* (regex-parts
- (raw-parts (ivy--split-negation str)))
- (dolist (part (ivy--split-spaces (car raw-parts)))
- (push (cons part t) regex-parts))
- (when (cdr raw-parts)
- (dolist (part (ivy--split-spaces (cadr raw-parts)))
- (push (cons part nil) regex-parts)))
- (if regex-parts (nreverse regex-parts)
- "")))
-
-(defun ivy--regex-plus (str)
- "Build a regex sequence from STR.
-Spaces are wild card characters, everything before \"!\" should
-match. Everything after \"!\" should not match."
- (let ((parts (ivy--split-negation str)))
- (cl-case (length parts)
- (0
- "")
- (1
- (if (= (aref str 0) ?!)
- (list (cons "" t)
- (list (ivy--regex (car parts))))
- (ivy--regex (car parts))))
- (2
- (cons
- (cons (ivy--regex (car parts)) t)
- (mapcar #'list (split-string (cadr parts) " " t))))
- (t (error "Unexpected: use only one !")))))
-
-(defun ivy--regex-fuzzy (str)
- "Build a regex sequence from STR.
-Insert .* between each char."
- (setq str (ivy--trim-trailing-re str))
- (if (string-match "\\`\\(\\^?\\)\\(.*?\\)\\(\\$?\\)\\'" str)
- (prog1
- (concat (match-string 1 str)
- (let ((lst (string-to-list (match-string 2 str))))
- (apply #'concat
- (cl-mapcar
- #'concat
- (cons "" (cdr (mapcar (lambda (c) (format
"[^%c\n]*" c))
- lst)))
- (mapcar (lambda (x) (format "\\(%s\\)"
(regexp-quote (char-to-string x))))
- lst))))
- (match-string 3 str))
- (setq ivy--subexps (length (match-string 2 str))))
- str))
-
-(defcustom ivy-fixed-height-minibuffer nil
- "When non nil, fix the height of the minibuffer during ivy completion.
-This effectively sets the minimum height at this level to `ivy-height' and
-tries to ensure that it does not change depending on the number of candidates."
- :type 'boolean)
-
-;;** Rest
-(defcustom ivy-truncate-lines t
- "Minibuffer setting for `truncate-lines'."
- :type 'boolean)
-
-(defun ivy--minibuffer-setup ()
- "Setup ivy completion in the minibuffer."
- (setq-local mwheel-scroll-up-function 'ivy-next-line)
- (setq-local mwheel-scroll-down-function 'ivy-previous-line)
- (setq-local completion-show-inline-help nil)
- (setq-local line-spacing nil)
- (setq-local minibuffer-default-add-function
- (lambda ()
- (list ivy--default)))
- (setq-local inhibit-field-text-motion nil)
- (setq truncate-lines ivy-truncate-lines)
- (setq-local max-mini-window-height ivy-height)
- (let ((height (cond ((and ivy-fixed-height-minibuffer
- (not (eq (ivy-state-caller ivy-last)
- #'ivy-completion-in-region)))
- (+ ivy-height (if ivy-add-newline-after-prompt 1 0)))
- (ivy-add-newline-after-prompt 2))))
- (when height
- (set-window-text-height nil height)))
- (add-hook 'post-command-hook #'ivy--queue-exhibit nil t)
- (let ((hook (ivy-alist-setting ivy-hooks-alist)))
- (when (functionp hook)
- (funcall hook))))
-
-(defun ivy--input ()
- "Return the current minibuffer input."
- ;; assume one-line minibuffer input
- (save-excursion
- (goto-char (minibuffer-prompt-end))
- (let ((inhibit-field-text-motion t))
- (buffer-substring-no-properties
- (point)
- (line-end-position)))))
-
-(defun ivy--minibuffer-cleanup ()
- "Delete the displayed completion candidates."
- (save-excursion
- (goto-char (minibuffer-prompt-end))
- (delete-region (line-end-position) (point-max))))
-
-(defun ivy-cleanup-string (str)
- "Destructively remove unwanted text properties from STR."
- (ivy--remove-props str 'field))
-
-(defvar ivy-set-prompt-text-properties-function
- #'ivy-set-prompt-text-properties-default
- "Function to set the text properties of the default ivy prompt.
-Called with two arguments, PROMPT and PROPS, where PROMPT is the
-string to be propertized and PROPS is a plist of default text
-properties that may be applied to PROMPT. The function should
-return the propertized PROMPT, which may be modified in-place.")
-
-(defun ivy-set-prompt-text-properties-default (prompt props)
- "Propertize (confirm) and (match required) parts of PROMPT.
-PROPS is a plist of default text properties to apply to these
-parts beyond their respective faces `ivy-confirm-face' and
-`ivy-match-required-face'."
- (dolist (pair '(("confirm" . ivy-confirm-face)
- ("match required" . ivy-match-required-face)))
- (let ((i (string-match-p (car pair) prompt)))
- (when i
- (add-text-properties i (+ i (length (car pair)))
- `(face ,(cdr pair) ,@props)
- prompt))))
- prompt)
-
-(defun ivy-prompt ()
- "Return the current prompt."
- (let* ((caller (ivy-state-caller ivy-last))
- (fn (plist-get ivy--prompts-list caller)))
- (if fn
- (condition-case err
- (funcall fn)
- (wrong-number-of-arguments
- (lwarn 'ivy :error "%s
- Prompt function set via `ivy-set-prompt' for caller `%s'
- should take no arguments."
- (error-message-string err)
- caller)
- ;; Old behavior.
- (funcall fn (ivy-state-prompt ivy-last))))
- ivy--prompt)))
-
-(defun ivy--insert-prompt ()
- "Update the prompt according to `ivy--prompt'."
- (when (setq ivy--prompt (ivy-prompt))
- (unless (memq this-command '(ivy-done ivy-alt-done ivy-partial-or-done
- counsel-find-symbol))
- (setq ivy--prompt-extra ""))
- (let (head tail)
- (if (string-match "\\(.*?\\)\\(:? ?\\)\\'" ivy--prompt)
- (progn
- (setq head (match-string 1 ivy--prompt))
- (setq tail (match-string 2 ivy--prompt)))
- (setq head ivy--prompt)
- (setq tail ""))
- (let ((inhibit-read-only t)
- (std-props '(front-sticky t rear-nonsticky t field t read-only t))
- (n-str
- (concat
- (if (and (bound-and-true-p minibuffer-depth-indicate-mode)
- (> (minibuffer-depth) 1))
- (format "[%d] " (minibuffer-depth))
- "")
- (concat
- (if (string-match "%d.*%d" ivy-count-format)
- (format head
- (1+ ivy--index)
- (or (and (ivy-state-dynamic-collection ivy-last)
- ivy--full-length)
- ivy--length))
- (format head
- (or (and (ivy-state-dynamic-collection ivy-last)
- ivy--full-length)
- ivy--length)))
- ivy--prompt-extra
- tail)))
- (d-str (if ivy--directory
- (abbreviate-file-name ivy--directory)
- "")))
- (save-excursion
- (goto-char (point-min))
- (delete-region (point-min) (minibuffer-prompt-end))
- (let ((len-n (length n-str))
- (len-d (length d-str))
- (ww (window-width)))
- (setq n-str
- (cond ((> (+ len-n len-d) ww)
- (concat n-str "\n" d-str "\n"))
- ((> (+ len-n len-d (length ivy-text)) ww)
- (concat n-str d-str "\n"))
- (t
- (concat n-str d-str)))))
- (when ivy-pre-prompt-function
- (setq n-str (concat (funcall ivy-pre-prompt-function) n-str)))
- (when ivy-add-newline-after-prompt
- (setq n-str (concat n-str "\n")))
- (let ((regex (format "\\([^\n]\\{%d\\}\\)[^\n]" (window-width))))
- (while (string-match regex n-str)
- (setq n-str (replace-match
- (concat (match-string 1 n-str) "\n")
- nil t n-str 1))))
- (set-text-properties 0 (length n-str)
- `(face minibuffer-prompt ,@std-props)
- n-str)
- (setq n-str (funcall ivy-set-prompt-text-properties-function
- n-str std-props))
- (insert n-str))
- ;; Mark prompt as selected if the user moves there or it is the only
- ;; option left. Since the user input stays put, we have to manually
- ;; remove the face as well.
- (when ivy--use-selectable-prompt
- (if (= ivy--index -1)
- (ivy-add-face-text-property
- (minibuffer-prompt-end) (line-end-position) 'ivy-prompt-match)
- (remove-list-of-text-properties
- (minibuffer-prompt-end) (line-end-position) '(face))))
- ;; get out of the prompt area
- (constrain-to-field nil (point-max))))))
-
-(defun ivy--sort-maybe (collection)
- "Sort COLLECTION if needed."
- (let ((sort (ivy-state-sort ivy-last)))
- (if (and sort
- (or (functionp sort)
- (functionp (setq sort (ivy--sort-function
- (ivy-state-collection ivy-last))))))
- (sort (copy-sequence collection) sort)
- collection)))
-
-(defcustom ivy-magic-slash-non-match-action
'ivy-magic-slash-non-match-cd-selected
- "Action to take when a slash is added to the end of a non existing directory.
-Possible choices are 'ivy-magic-slash-non-match-cd-selected,
-'ivy-magic-slash-non-match-create, or nil"
- :type '(choice
- (const :tag "Use currently selected directory"
- ivy-magic-slash-non-match-cd-selected)
- (const :tag "Create and use new directory"
- ivy-magic-slash-non-match-create)
- (const :tag "Do nothing"
- nil)))
-
-(defun ivy--create-and-cd (dir)
- "When completing file names, create directory DIR and move there."
- (make-directory dir)
- (ivy--cd dir))
-
-(defun ivy--magic-file-doubleslash-directory ()
- "Return an appropriate directory for when two slashes are entered."
- (let (remote)
- (cond
- ;; Windows
- ((string-match "\\`[[:alpha:]]:/" ivy--directory)
- (match-string 0 ivy--directory))
- ;; Remote root if on remote
- ((setq remote (file-remote-p ivy--directory))
- (concat remote "/"))
- ;; Local root
- (t
- "/"))))
-
-(defun ivy--magic-file-slash ()
- "Handle slash when completing file names."
- (when (or (and (eq this-command #'self-insert-command)
- (eolp))
- (eq this-command #'ivy-partial-or-done))
- (let ((canonical (expand-file-name ivy-text ivy--directory))
- (magic (not (string= ivy-text "/"))))
- (cond ((member ivy-text ivy--all-candidates)
- (ivy--cd canonical))
- ((string-match-p "//\\'" ivy-text)
- (ivy--cd
- (ivy--magic-file-doubleslash-directory)))
- ((string-match-p "\\`/ssh:" ivy-text)
- (ivy--cd (file-name-directory ivy-text)))
- ((string-match "[[:alpha:]]:/\\'" ivy-text)
- (let ((drive-root (match-string 0 ivy-text)))
- (when (file-exists-p drive-root)
- (ivy--cd drive-root))))
- ((and magic (file-directory-p canonical))
- (ivy--cd canonical))
- ((let ((default-directory ivy--directory))
- (and (or (> ivy--index 0)
- (= ivy--length 1)
- magic)
- (not (ivy--prompt-selected-p))
- (not (equal (ivy-state-current ivy-last) ""))
- (file-directory-p (ivy-state-current ivy-last))
- (or (eq ivy-magic-slash-non-match-action
- 'ivy-magic-slash-non-match-cd-selected)
- (eq this-command #'ivy-partial-or-done))))
- (ivy--cd
- (expand-file-name (ivy-state-current ivy-last) ivy--directory)))
- ((and (eq ivy-magic-slash-non-match-action
- 'ivy-magic-slash-non-match-create)
- magic)
- (ivy--create-and-cd canonical))))))
-
-(defun ivy-magic-read-file-env ()
- "If reading filename, jump to environment variable location."
- (interactive)
- (if (and ivy--directory
- (equal ivy-text ""))
- (let* ((cands (cl-loop for pair in process-environment
- for (var val) = (split-string pair "=" t)
- if (and val (not (equal "" val)))
- if (file-exists-p
- (if (file-name-absolute-p val)
- val
- (setq val
- (expand-file-name val ivy--directory))))
- collect (cons var val)))
- (enable-recursive-minibuffers t)
- (x (ivy-read "Env: " cands))
- (path (cdr (assoc x cands))))
- (insert (if (file-accessible-directory-p path)
- (file-name-as-directory path)
- path))
- (ivy--cd-maybe))
- (insert last-input-event)))
-
-(defun ivy-make-magic-action (caller key)
- "Return a command that does the equivalent of `ivy-read-action' and KEY.
-This happens only when the input is empty.
-The intention is to bind the result to keys that are typically
-bound to `self-insert-command'."
- (let* ((alist (assoc key
- (plist-get
- ivy--actions-list
- caller)))
- (doc (format "%s (`%S')"
- (nth 2 alist)
- (nth 1 alist))))
- `(lambda (&optional arg)
- ,doc
- (interactive "p")
- (if (string= "" ivy-text)
- (execute-kbd-macro
- (kbd ,(concat "M-o " key)))
- (self-insert-command arg)))))
-
-(defcustom ivy-magic-tilde t
- "When non-nil, ~ will move home when selecting files.
-Otherwise, ~/ will move home."
- :type 'boolean)
-
-(defcustom ivy-dynamic-exhibit-delay-ms 0
- "Delay in ms before dynamic collections are refreshed"
- :type 'integer)
-
-(defvar ivy--exhibit-timer nil)
-
-(defun ivy--queue-exhibit ()
- "Insert Ivy completions display, possibly after a timeout for
-dynamic collections.
-Should be run via minibuffer `post-command-hook'."
- (if (and (> ivy-dynamic-exhibit-delay-ms 0)
- (ivy-state-dynamic-collection ivy-last))
- (progn
- (when ivy--exhibit-timer (cancel-timer ivy--exhibit-timer))
- (setq ivy--exhibit-timer
- (run-with-timer
- (/ ivy-dynamic-exhibit-delay-ms 1000.0)
- nil
- 'ivy--exhibit)))
- (ivy--exhibit)))
-
-(defun ivy--magic-tilde-directory (dir)
- "Return an appropriate home for DIR for when ~ or ~/ are entered."
- (expand-file-name
- (let (remote)
- (if (and (setq remote (file-remote-p dir))
- (let ((local (file-local-name dir)))
- (not (or (string= "/root/" local)
- (string-match-p "/home/\\([^/]+\\)/\\'" local)))))
- (concat remote "~/")
- "~/"))))
-
-(defun ivy-update-candidates (cands)
- (ivy--insert-minibuffer
- (ivy--format
- (setq ivy--all-candidates cands))))
-
-(defun ivy--exhibit ()
- "Insert Ivy completions display.
-Should be run via minibuffer `post-command-hook'."
- (when (memq 'ivy--queue-exhibit post-command-hook)
- (let ((inhibit-field-text-motion nil))
- (constrain-to-field nil (point-max)))
- (setq ivy-text (ivy--input))
- (if (ivy-state-dynamic-collection ivy-last)
- ;; while-no-input would cause annoying
- ;; "Waiting for process to die...done" message interruptions
- (let ((inhibit-message t)
- coll in-progress)
- (unless (equal ivy--old-text ivy-text)
- (while-no-input
- (setq coll (funcall (ivy-state-collection ivy-last) ivy-text))
- (when (eq coll 0)
- (setq coll nil)
- (setq ivy--old-re nil)
- (setq in-progress t))
- (setq ivy--all-candidates (ivy--sort-maybe coll))
- (setq ivy--old-text ivy-text)))
- (when (eq ivy--all-candidates 0)
- (setq ivy--all-candidates nil)
- (setq ivy--old-re nil)
- (setq in-progress t))
- (when (or ivy--all-candidates
- (and (not (get-process " *counsel*"))
- (not in-progress)))
- (ivy--set-index-dynamic-collection)
- (ivy--insert-minibuffer
- (ivy--format ivy--all-candidates))))
- (cond (ivy--directory
- (cond ((or (string= "~/" ivy-text)
- (and (string= "~" ivy-text)
- ivy-magic-tilde))
- (ivy--cd (ivy--magic-tilde-directory ivy--directory)))
- ((string-match "/\\'" ivy-text)
- (ivy--magic-file-slash))))
- ((eq (ivy-state-collection ivy-last) #'internal-complete-buffer)
- (when (or (and (string-match "\\` " ivy-text)
- (not (string-match "\\` " ivy--old-text)))
- (and (string-match "\\` " ivy--old-text)
- (not (string-match "\\` " ivy-text))))
- (setq ivy--all-candidates
- (if (= (string-to-char ivy-text) ?\s)
- (ivy--buffer-list " ")
- (ivy--buffer-list "" ivy-use-virtual-buffers)))
- (setq ivy--old-re nil))))
- (ivy--insert-minibuffer
- (with-current-buffer (ivy-state-buffer ivy-last)
- (ivy--format
- (ivy--filter ivy-text ivy--all-candidates))))
- (setq ivy--old-text ivy-text))))
-
-(defun ivy-display-function-fallback (str)
- (let ((buffer-undo-list t))
- (save-excursion
- (forward-line 1)
- (insert str))))
-
-(defun ivy--insert-minibuffer (text)
- "Insert TEXT into minibuffer with appropriate cleanup."
- (let ((resize-mini-windows nil)
- (update-fn (ivy-state-update-fn ivy-last))
- (old-mark (marker-position (mark-marker)))
- (win (active-minibuffer-window))
- deactivate-mark)
- (when win
- (with-selected-window win
- (ivy--minibuffer-cleanup)
- (when update-fn
- (funcall update-fn))
- (ivy--insert-prompt)
- ;; Do nothing if while-no-input was aborted.
- (when (stringp text)
- (if ivy--display-function
- (funcall ivy--display-function text)
- (ivy-display-function-fallback text)))
- (ivy--resize-minibuffer-to-fit)
- ;; prevent region growing due to text remove/add
- (when (region-active-p)
- (set-mark old-mark))))))
-
-(defun ivy--resize-minibuffer-to-fit ()
- "Resize the minibuffer window size to fit the text in the minibuffer."
- (unless (frame-root-window-p (minibuffer-window))
- (with-selected-window (minibuffer-window)
- (if (fboundp 'window-text-pixel-size)
- (let ((text-height (cdr (window-text-pixel-size)))
- (body-height (window-body-height nil t)))
- (when (> text-height body-height)
- ;; Note: the size increment needs to be at least
- ;; frame-char-height, otherwise resizing won't do
- ;; anything.
- (let ((delta (max (- text-height body-height)
- (frame-char-height))))
- (window-resize nil delta nil t t))))
- (let ((text-height (count-screen-lines))
- (body-height (window-body-height)))
- (when (> text-height body-height)
- (window-resize nil (- text-height body-height) nil t)))))))
-
-(defun ivy--add-face (str face)
- "Propertize STR with FACE."
- (let ((len (length str)))
- (condition-case nil
- (progn
- (colir-blend-face-background 0 len face str)
- (let ((foreground (face-foreground face)))
- (when foreground
- (ivy-add-face-text-property
- 0 len (list :foreground foreground) str))))
- (error
- (ignore-errors
- (font-lock-append-text-property 0 len 'face face str)))))
- str)
-
-(declare-function flx-make-string-cache "ext:flx")
-(declare-function flx-score "ext:flx")
-
-(defvar ivy--flx-cache nil)
-
-(eval-after-load 'flx
- '(setq ivy--flx-cache (flx-make-string-cache)))
-
-(defun ivy-toggle-case-fold ()
- "Toggle `case-fold-search' for Ivy operations.
-
-Instead of modifying `case-fold-search' directly, this command
-toggles `ivy-case-fold-search', which can take on more values
-than the former, between nil and either `auto' or t. See
-`ivy-case-fold-search-default' for the meaning of these values.
-
-In any Ivy completion session, the case folding starts with
-`ivy-case-fold-search-default'."
- (interactive)
- (setq ivy-case-fold-search
- (and (not ivy-case-fold-search)
- (or ivy-case-fold-search-default 'auto)))
- ;; Reset cache so that the candidate list updates.
- (setq ivy--old-re nil))
-
-(defun ivy--re-filter (re candidates &optional mkpred)
- "Return all RE matching CANDIDATES.
-RE is a list of cons cells, with a regexp car and a boolean cdr.
-When the cdr is t, the car must match.
-Otherwise, the car must not match."
- (if (equal re "")
- candidates
- (ignore-errors
- (dolist (re (if (stringp re) (list (cons re t)) re))
- (let* ((re-str (car re))
- (pred
- (if mkpred
- (funcall mkpred re-str)
- (lambda (x) (string-match-p re-str x)))))
- (setq candidates
- (cl-remove nil candidates
- (if (cdr re) :if-not :if)
- pred))))
- candidates)))
-
-(defun ivy--filter (name candidates)
- "Return all items that match NAME in CANDIDATES.
-CANDIDATES are assumed to be static."
- (let ((re (funcall ivy--regex-function name)))
- (if (and
- ivy--old-re
- ivy--old-cands
- (equal re ivy--old-re))
- ;; quick caching for "C-n", "C-p" etc.
- ivy--old-cands
- (let* ((re-str (ivy-re-to-str re))
- (matcher (ivy-state-matcher ivy-last))
- (case-fold-search (ivy--case-fold-p name))
- (cands (cond
- ((and ivy--old-re
- (stringp re)
- (stringp ivy--old-re)
- (not (string-match-p "\\\\" ivy--old-re))
- (not (equal ivy--old-re ""))
- (memq (cl-search
- (if (string-match-p "\\\\)\\'" ivy--old-re)
- (substring ivy--old-re 0 -2)
- ivy--old-re)
- re)
- '(0 2))
- ivy--old-cands
- (ivy--re-filter re ivy--old-cands)))
- (matcher
- (funcall matcher re candidates))
- (t
- (ivy--re-filter re candidates)))))
- (if (memq (cdr (assq (ivy-state-caller ivy-last)
- ivy-index-functions-alist))
- '(ivy-recompute-index-swiper
- ivy-recompute-index-swiper-async
- ivy-recompute-index-swiper-async-backward
- ivy-recompute-index-swiper-backward))
- (progn
- (ivy--recompute-index name re-str cands)
- (setq ivy--old-cands (ivy--sort name cands)))
- (setq ivy--old-cands (ivy--sort name cands))
- (ivy--recompute-index name re-str ivy--old-cands))
- (setq ivy--old-re re)
- ivy--old-cands))))
-
-(defun ivy--set-candidates (x)
- "Update `ivy--all-candidates' with X."
- (let (res)
- (dolist (source ivy--extra-candidates)
- (if (equal source '(original-source))
- (if (null res)
- (setq res x)
- (setq res (append x res)))
- (setq ivy--old-re nil)
- (setq res (append
- (ivy--filter ivy-text (cadr source))
- res))))
- (setq ivy--all-candidates res)))
-
-(defun ivy--shorter-matches-first (_name cands)
- "Sort CANDS according to their length."
- (if (< (length cands) ivy-sort-max-size)
- (cl-sort
- (copy-sequence cands)
- (lambda (s1 s2)
- (< (length s1) (length s2))))
- cands))
-
-(defcustom ivy-sort-matches-functions-alist
- '((t . nil)
- (ivy-completion-in-region . ivy--shorter-matches-first)
- (ivy-switch-buffer . ivy-sort-function-buffer))
- "An alist of functions for sorting matching candidates.
-
-Unlike `ivy-sort-functions-alist', which is used to sort the
-whole collection only once, this alist of functions are used to
-sort only matching candidates after each change in input.
-
-The alist KEY is either a collection function or t to match
-previously unmatched collection functions.
-
-The alist VAL is a sorting function with the signature of
-`ivy--prefix-sort'."
- :type '(alist
- :key-type (choice
- (const :tag "Fall-through" t)
- (symbol :tag "Collection"))
- :value-type
- (choice
- (const :tag "Don't sort" nil)
- (const :tag "Put prefix matches ahead" ivy--prefix-sort)
- (function :tag "Custom sort function"))))
-
-(defun ivy--sort-files-by-date (_name candidates)
- "Re-sort CANDIDATES according to file modification date."
- (let ((default-directory ivy--directory))
- (sort (copy-sequence candidates) #'file-newer-than-file-p)))
-
-(defvar ivy--flx-featurep (require 'flx nil 'noerror))
-
-(defun ivy--sort (name candidates)
- "Re-sort candidates by NAME.
-All CANDIDATES are assumed to match NAME."
- (let (fun)
- (cond ((setq fun (ivy-alist-setting ivy-sort-matches-functions-alist))
- (funcall fun name candidates))
- ((and ivy--flx-featurep
- (eq ivy--regex-function 'ivy--regex-fuzzy))
- (ivy--flx-sort name candidates))
- (t
- candidates))))
-
-(defun ivy--prefix-sort (name candidates)
- "Re-sort candidates by NAME.
-All CANDIDATES are assumed to match NAME.
-Prefix matches to NAME are put ahead of the list."
- (if (or (string= name "")
- (= (aref name 0) ?^))
- candidates
- (let ((re-prefix (concat "\\`" (funcall ivy--regex-function name)))
- res-prefix
- res-noprefix)
- (dolist (s candidates)
- (if (string-match-p re-prefix s)
- (push s res-prefix)
- (push s res-noprefix)))
- (nconc
- (nreverse res-prefix)
- (nreverse res-noprefix)))))
-
-(defvar ivy--virtual-buffers nil
- "Store the virtual buffers alist.")
-
-(defun ivy-re-to-str (re)
- "Transform RE to a string.
-
-Functions like `ivy--regex-ignore-order' return a cons list.
-This function extracts a string from the cons list."
- (if (consp re) (caar re) re))
-
-(defun ivy-sort-function-buffer (name candidates)
- "Re-sort candidates by NAME.
-CANDIDATES is a list of buffer names each containing NAME.
-Sort open buffers before virtual buffers, and prefix matches
-before substring matches."
- (if (or (string= name "")
- (= (aref name 0) ?^))
- candidates
- (let* ((base-re (ivy-re-to-str (funcall ivy--regex-function name)))
- (re-star-prefix (concat "\\`\\*" base-re))
- (re-prefix (concat "\\`" base-re))
- res-prefix
- res-noprefix
- res-virtual-prefix
- res-virtual-noprefix)
- (dolist (s candidates)
- (cond
- ((and (assoc s ivy--virtual-buffers)
- (or (string-match-p re-star-prefix s)
- (string-match-p re-prefix s)))
- (push s res-virtual-prefix))
- ((assoc s ivy--virtual-buffers)
- (push s res-virtual-noprefix))
- ((or (string-match-p re-star-prefix s)
- (string-match-p re-prefix s))
- (push s res-prefix))
- (t
- (push s res-noprefix))))
- (nconc
- (nreverse res-prefix)
- (nreverse res-noprefix)
- (nreverse res-virtual-prefix)
- (nreverse res-virtual-noprefix)))))
-
-(defvar ivy-flx-limit 200
- "Used to conditionally turn off flx sorting.
-
-When the amount of matching candidates exceeds this limit, then
-no sorting is done.")
-
-(defvar ivy--recompute-index-inhibit nil
- "When non-nil, `ivy--recompute-index' is a no-op.")
-
-(defun ivy--recompute-index (name re-str cands)
- "Recompute index of selected candidate matching NAME.
-RE-STR is the regexp, CANDS are the current candidates."
- (let ((caller (ivy-state-caller ivy-last))
- (func (or (ivy-alist-setting ivy-index-functions-alist)
- #'ivy-recompute-index-zero))
- (case-fold-search (ivy--case-fold-p name))
- (preselect (ivy-state-preselect ivy-last))
- (current (ivy-state-current ivy-last))
- (empty (string= name "")))
- (unless (or (memq this-command '(ivy-resume ivy-partial-or-done))
- ivy--recompute-index-inhibit)
- (ivy-set-index
- (if (or (string= name "")
- (and (> (length cands) 10000) (eq func
#'ivy-recompute-index-zero)))
- 0
- (or
- (cl-position (ivy--remove-prefix "^" name)
- cands
- :test #'ivy--case-fold-string=)
- (and ivy--directory
- (cl-position (concat re-str "/")
- cands
- :test #'ivy--case-fold-string=))
- (and (eq caller 'ivy-switch-buffer)
- (not empty)
- 0)
- (and (not empty)
- (not (eq caller 'swiper))
- (not (and ivy--flx-featurep
- (eq ivy--regex-function 'ivy--regex-fuzzy)
- ;; Limit to configured number of candidates
- (null (nthcdr ivy-flx-limit cands))))
- ;; If there was a preselected candidate, don't try to
- ;; keep it selected even if the regexp still matches it.
- ;; See issue #1563. See also `ivy--preselect-index',
- ;; which this logic roughly mirrors.
- (not (or
- (and (integerp preselect)
- (= ivy--index preselect))
- (equal current preselect)
- (and (ivy--regex-p preselect)
- (stringp current)
- (string-match-p preselect current))))
- ivy--old-cands
- (cl-position current cands :test #'equal))
- (funcall func re-str cands)))))
- (when (or empty (string= name "^"))
- (ivy-set-index
- (or (ivy--preselect-index preselect cands)
- ivy--index)))))
-
-(defun ivy-recompute-index-swiper (_re-str cands)
- "Recompute index of selected candidate when using `swiper'.
-CANDS are the current candidates."
- (condition-case nil
- (let ((tail (nthcdr ivy--index ivy--old-cands))
- idx)
- (if (and tail ivy--old-cands (not (equal "^" ivy--old-re)))
- (progn
- (while (and tail (null idx))
- ;; Compare with eq to handle equal duplicates in cands
- (setq idx (cl-position (pop tail) cands)))
- (or
- idx
- (1- (length cands))))
- (if ivy--old-cands
- ivy--index
- ;; already in ivy-state-buffer
- (let ((n (line-number-at-pos))
- (res 0)
- (i 0))
- (dolist (c cands)
- (when (eq n (get-text-property 0 'swiper-line-number c))
- (setq res i))
- (cl-incf i))
- res))))
- (error 0)))
-
-(defun ivy-recompute-index-swiper-backward (re-str cands)
- "Recompute index of selected candidate when using `swiper-backward'.
-CANDS are the current candidates."
- (let ((idx (ivy-recompute-index-swiper re-str cands)))
- (if (or (= idx -1)
- (<= (get-text-property 0 'swiper-line-number (nth idx cands))
- (line-number-at-pos)))
- idx
- (- idx 1))))
-
-(defun ivy-recompute-index-swiper-async (_re-str cands)
- "Recompute index of selected candidate when using `swiper' asynchronously.
-CANDS are the current candidates."
- (if (null ivy--old-cands)
- (let ((ln (with-ivy-window
- (line-number-at-pos))))
- (or
- ;; closest to current line going forwards
- (cl-position-if (lambda (x)
- (>= (string-to-number x) ln))
- cands)
- ;; closest to current line going backwards
- (1- (length cands))))
- (let ((tail (nthcdr ivy--index ivy--old-cands))
- idx)
- (if (and tail ivy--old-cands (not (equal "^" ivy--old-re)))
- (progn
- (while (and tail (null idx))
- ;; Compare with `equal', since the collection is re-created
- ;; each time with `split-string'
- (setq idx (cl-position (pop tail) cands :test #'equal)))
- (or idx 0))
- ivy--index))))
-
-(defun ivy-recompute-index-swiper-async-backward (re-str cands)
- "Recompute index of selected candidate when using `swiper-backward'
-asynchronously. CANDS are the current candidates."
- (if (= (length cands) 0)
- 0
- (let ((idx (ivy-recompute-index-swiper-async re-str cands)))
- (if
- (<= (string-to-number (nth idx cands))
- (with-ivy-window (line-number-at-pos)))
- idx
- (- idx 1)))))
-
-(defun ivy-recompute-index-zero (_re-str _cands)
- "Recompute index of selected candidate.
-This function serves as a fallback when nothing else is available."
- 0)
-
-(defcustom ivy-minibuffer-faces
- '(ivy-minibuffer-match-face-1
- ivy-minibuffer-match-face-2
- ivy-minibuffer-match-face-3
- ivy-minibuffer-match-face-4)
- "List of `ivy' faces for minibuffer group matches."
- :type '(repeat :tag "Faces"
- (choice
- (const ivy-minibuffer-match-face-1)
- (const ivy-minibuffer-match-face-2)
- (const ivy-minibuffer-match-face-3)
- (const ivy-minibuffer-match-face-4)
- (face :tag "Other face"))))
-
-(defun ivy--minibuffer-face (n)
- "Return Nth face from `ivy-minibuffer-faces'.
-N wraps around, but skips the first element of the list."
- (let ((tail (cdr ivy-minibuffer-faces)))
- (nth (mod (+ n 2) (length tail)) tail)))
-
-(defun ivy--flx-propertize (x)
- "X is (cons (flx-score STR ...) STR)."
- (let ((str (copy-sequence (cdr x)))
- (i 0)
- (last-j -2))
- (dolist (j (cdar x))
- (unless (eq j (1+ last-j))
- (cl-incf i))
- (setq last-j j)
- (ivy-add-face-text-property j (1+ j) (ivy--minibuffer-face i) str))
- str))
-
-(defun ivy--flx-sort (name cands)
- "Sort according to closeness to string NAME the string list CANDS."
- (condition-case nil
- (let* ((bolp (= (string-to-char name) ?^))
- ;; An optimized regex for fuzzy matching
- ;; "abc" → "^[^a]*a[^b]*b[^c]*c"
- (fuzzy-regex (concat "\\`"
- (and bolp (regexp-quote (substring name 1
2)))
- (mapconcat
- (lambda (x)
- (setq x (char-to-string x))
- (concat "[^" x "]*" (regexp-quote x)))
- (if bolp (substring name 2) name)
- "")))
- ;; Strip off the leading "^" for flx matching
- (flx-name (if bolp (substring name 1) name))
- cands-left
- cands-to-sort)
-
- ;; Filter out non-matching candidates
- (dolist (cand cands)
- (when (string-match-p fuzzy-regex cand)
- (push cand cands-left)))
-
- ;; pre-sort the candidates by length before partitioning
- (setq cands-left (cl-sort cands-left #'< :key #'length))
-
- ;; partition the candidates into sorted and unsorted groups
- (dotimes (_ (min (length cands-left) ivy-flx-limit))
- (push (pop cands-left) cands-to-sort))
-
- (nconc
- ;; Compute all of the flx scores in one pass and sort
- (mapcar #'car
- (sort (mapcar
- (lambda (cand)
- (cons cand
- (car (flx-score cand flx-name
ivy--flx-cache))))
- cands-to-sort)
- (lambda (c1 c2)
- ;; Break ties by length
- (if (/= (cdr c1) (cdr c2))
- (> (cdr c1)
- (cdr c2))
- (< (length (car c1))
- (length (car c2)))))))
-
- ;; Add the unsorted candidates
- cands-left))
- (error cands)))
-
-(defun ivy--truncate-string (str width)
- "Truncate STR to WIDTH."
- (truncate-string-to-width str width nil nil t))
-
-(defun ivy--format-function-generic (selected-fn other-fn cands separator)
- "Transform candidates into a string for minibuffer.
-SELECTED-FN is called for the selected candidate, OTHER-FN for the others.
-Both functions take one string argument each. CANDS is a list of candidates
-and SEPARATOR is used to join them."
- (let ((i -1))
- (mapconcat
- (lambda (str)
- (let ((curr (eq (cl-incf i) ivy--window-index)))
- (if curr
- (funcall selected-fn str)
- (funcall other-fn str))))
- cands
- separator)))
-
-(defun ivy-format-function-default (cands)
- "Transform CANDS into a string for minibuffer."
- (ivy--format-function-generic
- (lambda (str)
- (ivy--add-face str 'ivy-current-match))
- #'identity
- cands
- "\n"))
-
-(defun ivy-format-function-arrow (cands)
- "Transform CANDS into a string for minibuffer."
- (ivy--format-function-generic
- (lambda (str)
- (concat "> " (ivy--add-face str 'ivy-current-match)))
- (lambda (str)
- (concat " " str))
- cands
- "\n"))
-
-(defun ivy-format-function-line (cands)
- "Transform CANDS into a string for minibuffer."
- (ivy--format-function-generic
- (lambda (str)
- (ivy--add-face (concat str "\n") 'ivy-current-match))
- (lambda (str)
- (concat str "\n"))
- cands
- ""))
-
-(defalias 'ivy-add-face-text-property
- (if (fboundp 'add-face-text-property)
- (lambda (start end face &optional object append)
- (add-face-text-property start end face append object))
- (lambda (start end face &optional object append)
- (funcall (if append
- #'font-lock-append-text-property
- #'font-lock-prepend-text-property)
- start end 'face face object)))
- "Compatibility shim for `add-face-text-property'.
-Fall back on `font-lock-prepend-text-property' in Emacs versions
-prior to 24.4 (`font-lock-append-text-property' when APPEND is
-non-nil).
-Note: The usual last two arguments are flipped for convenience.")
-
-(defun ivy--highlight-ignore-order (str)
- "Highlight STR, using the ignore-order method."
- (when (consp ivy--old-re)
- (let ((i 1))
- (dolist (re ivy--old-re)
- (when (string-match (car re) str)
- (ivy-add-face-text-property
- (match-beginning 0) (match-end 0)
- (ivy--minibuffer-face i)
- str))
- (cl-incf i))))
- str)
-
-(defun ivy--highlight-fuzzy (str)
- "Highlight STR, using the fuzzy method."
- (if (and ivy--flx-featurep
- (eq (ivy-alist-setting ivy-re-builders-alist) 'ivy--regex-fuzzy))
- (let ((flx-name (ivy--remove-prefix "^" ivy-text)))
- (ivy--flx-propertize
- (cons (flx-score str flx-name ivy--flx-cache) str)))
- (ivy--highlight-default str)))
-
-(defun ivy--highlight-default (str)
- "Highlight STR, using the default method."
- (unless ivy--old-re
- (setq ivy--old-re (funcall ivy--regex-function ivy-text)))
- (let ((regexps
- (if (listp ivy--old-re)
- (mapcar #'car (cl-remove-if-not #'cdr ivy--old-re))
- (list ivy--old-re)))
- start)
- (dolist (re regexps)
- (ignore-errors
- (while (and (string-match re str start)
- (> (- (match-end 0) (match-beginning 0)) 0))
- (setq start (match-end 0))
- (let ((i 0)
- (n 0)
- prev)
- (while (<= i ivy--subexps)
- (let ((beg (match-beginning i))
- (end (match-end i)))
- (when (and beg end)
- (unless (and prev (= prev beg))
- (cl-incf n))
- (let ((face
- (cond ((zerop ivy--subexps)
- (cadr ivy-minibuffer-faces))
- ((zerop i)
- (car ivy-minibuffer-faces))
- (t
- (ivy--minibuffer-face n)))))
- (ivy-add-face-text-property beg end face str))
- (unless (zerop i)
- (setq prev end))))
- (cl-incf i)))))))
- str)
-
-(defun ivy--format-minibuffer-line (str)
- "Format line STR for use in minibuffer."
- (let* ((str (ivy-cleanup-string (copy-sequence str)))
- (str (if (eq ivy-display-style 'fancy)
- (if (memq (ivy-state-caller ivy-last)
- ivy-highlight-grep-commands)
- (let* ((start (if (string-match
"\\`[^:]+:\\(?:[^:]+:\\)?" str)
- (match-end 0) 0))
- (file (substring str 0 start))
- (match (substring str start)))
- (concat file (funcall ivy--highlight-function match)))
- (funcall ivy--highlight-function str))
- str))
- (olen (length str))
- (annot (plist-get completion-extra-properties :annotation-function)))
- (add-text-properties
- 0 olen
- '(mouse-face
- ivy-minibuffer-match-highlight
- help-echo
- (format
- (if tooltip-mode
- "mouse-1: %s\nmouse-3: %s"
- "mouse-1: %s mouse-3: %s")
- ivy-mouse-1-tooltip ivy-mouse-3-tooltip))
- str)
- (when annot
- (setq str (concat str (funcall annot str)))
- (ivy-add-face-text-property
- olen (length str) 'ivy-completions-annotations str))
- str))
-
-(defun ivy-read-file-transformer (str)
- "Transform candidate STR when reading files."
- (if (ivy--dirname-p str)
- (propertize str 'face 'ivy-subdir)
- str))
-
-(defun ivy--minibuffer-index-bounds (idx len wnd-len)
- (let* ((half-height (/ wnd-len 2))
- (start (max 0
- (min (- idx half-height)
- (- len (1- wnd-len)))))
- (end (min (+ start (1- wnd-len)) len)))
- (list start end (- idx start))))
-
-(defun ivy--format (cands)
- "Return a string for CANDS suitable for display in the minibuffer.
-CANDS is a list of candidates that :display-transformer can turn into strings."
- (setq ivy--length (length cands))
- (when (>= ivy--index ivy--length)
- (ivy-set-index (max (1- ivy--length) 0)))
- (if (null cands)
- (setf (ivy-state-current ivy-last) "")
- (let ((cur (nth ivy--index cands)))
- (setf (ivy-state-current ivy-last) (if (stringp cur)
- (copy-sequence cur)
- cur)))
- (let* ((bnd (ivy--minibuffer-index-bounds
- ivy--index ivy--length ivy-height))
- (wnd-cands (cl-subseq cands (car bnd) (cadr bnd)))
- (case-fold-search (ivy--case-fold-p ivy-text))
- transformer-fn)
- (setq ivy--window-index (nth 2 bnd))
- (when (setq transformer-fn (ivy-state-display-transformer-fn ivy-last))
- (with-ivy-window
- (with-current-buffer (ivy-state-buffer ivy-last)
- (setq wnd-cands (mapcar transformer-fn wnd-cands)))))
- (ivy--wnd-cands-to-str wnd-cands))))
-
-(defun ivy--wnd-cands-to-str (wnd-cands)
- (let ((str (concat "\n"
- (funcall (ivy-alist-setting ivy-format-functions-alist)
- (condition-case nil
- (mapcar
- #'ivy--format-minibuffer-line
- wnd-cands)
- (error wnd-cands))))))
- (put-text-property 0 (length str) 'read-only nil str)
- str))
-
-(defvar recentf-list)
-(defvar bookmark-alist)
-
-(defcustom ivy-virtual-abbreviate 'name
- "The mode of abbreviation for virtual buffer names."
- :type '(choice
- (const :tag "Only name" name)
- (const :tag "Abbreviated path" abbreviate)
- (const :tag "Full path" full)
- ;; eventually, uniquify
- ))
-(declare-function bookmark-maybe-load-default-file "bookmark")
-(declare-function bookmark-get-filename "bookmark")
-
-(defun ivy--virtual-buffers ()
- "Adapted from `ido-add-virtual-buffers-to-list'."
- (require 'bookmark)
- (unless recentf-mode
- (recentf-mode 1))
- (bookmark-maybe-load-default-file)
- (let* ((vb-bkm (delete " - no file -"
- (delq nil (mapcar #'bookmark-get-filename
- bookmark-alist))))
- (vb-list (cond ((eq ivy-use-virtual-buffers 'recentf)
- recentf-list)
- ((eq ivy-use-virtual-buffers 'bookmarks)
- vb-bkm)
- (ivy-use-virtual-buffers
- (append recentf-list vb-bkm))
- (t nil)))
- virtual-buffers)
- (dolist (head vb-list)
- (let* ((file-name (if (stringp head)
- head
- (cdr head)))
- (name (cond ((eq ivy-virtual-abbreviate 'name)
- (file-name-nondirectory file-name))
- ((eq ivy-virtual-abbreviate 'abbreviate)
- (abbreviate-file-name file-name))
- (t
- (expand-file-name file-name)))))
- (when (equal name "")
- (setq name
- (if (consp head)
- (car head)
- (file-name-nondirectory (directory-file-name file-name)))))
- (unless (or (equal name "")
- (get-file-buffer file-name)
- (assoc name virtual-buffers))
- (push (cons (copy-sequence name) file-name) virtual-buffers))))
- (when virtual-buffers
- (dolist (comp virtual-buffers)
- (put-text-property 0 (length (car comp))
- 'face 'ivy-virtual
- (car comp)))
- (setq ivy--virtual-buffers (nreverse virtual-buffers))
- (mapcar #'car ivy--virtual-buffers))))
-
-(defcustom ivy-ignore-buffers '("\\` ")
- "List of regexps or functions matching buffer names to ignore."
- :type '(repeat (choice regexp function)))
-
-(defvar ivy-switch-buffer-faces-alist '((dired-mode . ivy-subdir)
- (org-mode . ivy-org))
- "Store face customizations for `ivy-switch-buffer'.
-Each KEY is `major-mode', each VALUE is a face name.")
-
-(defun ivy--buffer-list (str &optional virtual predicate)
- "Return the buffers that match STR.
-If VIRTUAL is non-nil, add virtual buffers.
-If optional argument PREDICATE is non-nil, use it to test each
-possible match. See `all-completions' for further information."
- (delete-dups
- (nconc
- (mapcar
- (lambda (x)
- (let* ((buf (get-buffer x))
- (dir (buffer-local-value 'default-directory buf))
- (face (if (and dir
- (ignore-errors
- (file-remote-p (abbreviate-file-name dir))))
- 'ivy-remote
- (cdr (assq (buffer-local-value 'major-mode buf)
- ivy-switch-buffer-faces-alist)))))
- (if face
- (propertize x 'face face)
- x)))
- (all-completions str #'internal-complete-buffer predicate))
- (and virtual
- (ivy--virtual-buffers)))))
-
-(defvar ivy-views (and nil
- `(("ivy + *scratch* {}"
- (vert
- (file ,(expand-file-name "ivy.el"))
- (buffer "*scratch*")))
- ("swiper + *scratch* {}"
- (horz
- (file ,(expand-file-name "swiper.el"))
- (buffer "*scratch*")))))
- "Store window configurations selectable by `ivy-switch-buffer'.
-
-The default value is given as an example.
-
-Each element is a list of (NAME TREE). NAME is a string, it's
-recommended to end it with a distinctive snippet e.g. \"{}\" so
-that it's easy to distinguish the window configurations.
-
-TREE is a nested list with the following valid cars:
-- vert: split the window vertically
-- horz: split the window horizontally
-- file: open the specified file
-- buffer: open the specified buffer
-
-TREE can be nested multiple times to have multiple window splits.")
-
-(defun ivy-default-view-name ()
- "Return default name for new view."
- (let* ((default-view-name
- (concat "{} "
- (mapconcat #'identity
- (sort
- (mapcar (lambda (w)
- (let* ((b (window-buffer w))
- (f (buffer-file-name b)))
- (if f
- (file-name-nondirectory f)
- (buffer-name b))))
- (window-list))
- #'string-lessp)
- " ")))
- (view-name-re (concat "\\`"
- (regexp-quote default-view-name)
- " \\([0-9]+\\)"))
- old-view)
- (cond ((setq old-view
- (cl-find-if
- (lambda (x)
- (string-match view-name-re (car x)))
- ivy-views))
- (format "%s %d"
- default-view-name
- (1+ (string-to-number
- (match-string 1 (car old-view))))))
- ((assoc default-view-name ivy-views)
- (concat default-view-name " 1"))
- (t
- default-view-name))))
-
-(defun ivy-push-view (&optional arg)
- "Push the current window tree on `ivy-views'.
-
-When ARG is non-nil, replace a selected item on `ivy-views'.
-
-Currently, the split configuration (i.e. horizontal or vertical)
-and point positions are saved, but the split positions aren't.
-Use `ivy-pop-view' to delete any item from `ivy-views'."
- (interactive "P")
- (let* ((view (cl-labels
- ((ft (tr)
- (if (consp tr)
- (if (eq (car tr) t)
- (cons 'vert
- (mapcar #'ft (cddr tr)))
- (cons 'horz
- (mapcar #'ft (cddr tr))))
- (with-current-buffer (window-buffer tr)
- (cond (buffer-file-name
- (list 'file buffer-file-name (point)))
- ((eq major-mode 'dired-mode)
- (list 'file default-directory (point)))
- (t
- (list 'buffer (buffer-name) (point))))))))
- (ft (car (window-tree)))))
- (view-name
- (if arg
- (ivy-read "Update view: " ivy-views)
- (ivy-read "Name view: " nil
- :initial-input (ivy-default-view-name)))))
- (when view-name
- (let ((x (assoc view-name ivy-views)))
- (if x
- (setcdr x (list view))
- (push (list view-name view) ivy-views))))))
-
-(defun ivy-pop-view-action (view)
- "Delete VIEW from `ivy-views'."
- (setq ivy-views (delete view ivy-views))
- (setq ivy--all-candidates
- (delete (car view) ivy--all-candidates))
- (setq ivy--old-cands nil))
-
-(defun ivy-pop-view ()
- "Delete a view to delete from `ivy-views'."
- (interactive)
- (ivy-read "Pop view: " ivy-views
- :preselect (caar ivy-views)
- :action #'ivy-pop-view-action
- :caller 'ivy-pop-view))
-
-(defun ivy-source-views ()
- "Return the name of the views saved in `ivy-views'."
- (mapcar #'car ivy-views))
-
-(ivy-set-sources
- 'ivy-switch-buffer
- '((original-source)
- (ivy-source-views)))
-
-(defun ivy-set-view-recur (view)
- "Set VIEW recursively."
- (cond ((eq (car view) 'vert)
- (let* ((wnd1 (selected-window))
- (wnd2 (split-window-vertically))
- (views (cdr view))
- (v (pop views))
- (temp-wnd))
- (with-selected-window wnd1
- (ivy-set-view-recur v))
- (while (setq v (pop views))
- (with-selected-window wnd2
- (when views
- (setq temp-wnd (split-window-vertically)))
- (ivy-set-view-recur v)
- (when views
- (setq wnd2 temp-wnd))))))
- ((eq (car view) 'horz)
- (let* ((wnd1 (selected-window))
- (wnd2 (split-window-horizontally))
- (views (cdr view))
- (v (pop views))
- (temp-wnd))
- (with-selected-window wnd1
- (ivy-set-view-recur v))
- (while (setq v (pop views))
- (with-selected-window wnd2
- (when views
- (setq temp-wnd (split-window-horizontally)))
- (ivy-set-view-recur v)
- (when views
- (setq wnd2 temp-wnd))))))
- ((eq (car view) 'file)
- (let* ((name (nth 1 view))
- (virtual (assoc name ivy--virtual-buffers))
- buffer)
- (cond ((setq buffer (get-buffer name))
- (switch-to-buffer buffer nil 'force-same-window))
- (virtual
- (find-file (cdr virtual)))
- ((file-exists-p name)
- (find-file name))))
- (when (and (> (length view) 2)
- (numberp (nth 2 view)))
- (goto-char (nth 2 view))))
- ((eq (car view) 'buffer)
- (switch-to-buffer (nth 1 view))
- (when (and (> (length view) 2)
- (numberp (nth 2 view)))
- (goto-char (nth 2 view))))
- ((eq (car view) 'sexp)
- (eval (nth 1 view)))))
-
-(defun ivy--switch-buffer-action (buffer)
- "Switch to BUFFER.
-BUFFER may be a string or nil."
- (if (zerop (length buffer))
- (switch-to-buffer
- ivy-text nil 'force-same-window)
- (let ((virtual (assoc buffer ivy--virtual-buffers))
- (view (assoc buffer ivy-views)))
- (cond ((and virtual
- (not (get-buffer buffer)))
- (find-file (cdr virtual)))
- (view
- (delete-other-windows)
- (let (
- ;; silence "Directory has changed on disk"
- (inhibit-message t))
- (ivy-set-view-recur (cadr view))))
- (t
- (switch-to-buffer
- buffer nil 'force-same-window))))))
-
-(defun ivy--switch-buffer-other-window-action (buffer)
- "Switch to BUFFER in other window.
-BUFFER may be a string or nil."
- (if (zerop (length buffer))
- (switch-to-buffer-other-window ivy-text)
- (let ((virtual (assoc buffer ivy--virtual-buffers)))
- (if (and virtual
- (not (get-buffer buffer)))
- (find-file-other-window (cdr virtual))
- (switch-to-buffer-other-window buffer)))))
-
-(defun ivy--rename-buffer-action (buffer)
- "Rename BUFFER."
- (let ((new-name (read-string "Rename buffer (to new name): ")))
- (with-current-buffer buffer
- (rename-buffer new-name))))
-
-(defun ivy--find-file-action (buffer)
- "Find file from BUFFER's directory."
- (let* ((virtual (assoc buffer ivy--virtual-buffers))
- (default-directory (if virtual
- (file-name-directory (cdr virtual))
- (buffer-local-value 'default-directory
- (or (get-buffer buffer)
- (current-buffer))))))
- (call-interactively (if (functionp 'counsel-find-file)
- #'counsel-find-file
- #'find-file))))
-
-(defun ivy--kill-buffer-or-virtual (buffer)
- (if (get-buffer buffer)
- (kill-buffer buffer)
- (setq recentf-list (delete
- (cdr (assoc buffer ivy--virtual-buffers))
- recentf-list))))
-
-(defun ivy--kill-current-candidate ()
- (setf (ivy-state-preselect ivy-last) ivy--index)
- (setq ivy--old-re nil)
- (setq ivy--all-candidates (delete (ivy-state-current ivy-last)
ivy--all-candidates))
- (let ((ivy--recompute-index-inhibit t))
- (ivy--exhibit)))
-
-(defun ivy--kill-buffer-action (buffer)
- "Kill BUFFER."
- (ivy--kill-buffer-or-virtual buffer)
- (unless (buffer-live-p (ivy-state-buffer ivy-last))
- (setf (ivy-state-buffer ivy-last)
- (with-ivy-window (current-buffer))))
- (ivy--kill-current-candidate))
-
-(defvar ivy-switch-buffer-map
- (let ((map (make-sparse-keymap)))
- (define-key map (kbd "C-k") 'ivy-switch-buffer-kill)
- map))
-
-(defun ivy-switch-buffer-kill ()
- "When at end-of-line, kill the current buffer in `ivy-switch-buffer'.
-Otherwise, forward to `ivy-kill-line'."
- (interactive)
- (if (not (eolp))
- (ivy-kill-line)
- (ivy--kill-buffer-action
- (ivy-state-current ivy-last))))
-
-(ivy-set-actions
- 'ivy-switch-buffer
- '(("f"
- ivy--find-file-action
- "find file")
- ("j"
- ivy--switch-buffer-other-window-action
- "other window")
- ("k"
- ivy--kill-buffer-action
- "kill")
- ("r"
- ivy--rename-buffer-action
- "rename")))
-
-(ivy-set-actions
- t
- `(("i" ,(lambda (x) (insert (if (stringp x) x (car x)))) "insert")
- ("w" ,(lambda (x) (kill-new (if (stringp x) x (car x)))) "copy")))
-
-(defun ivy--switch-buffer-matcher (regexp candidates)
- "Return REGEXP matching CANDIDATES.
-Skip buffers that match `ivy-ignore-buffers'."
- (let ((res (ivy--re-filter regexp candidates)))
- (if (or (null ivy-use-ignore)
- (null ivy-ignore-buffers))
- res
- (or (cl-remove-if
- (lambda (buf)
- (cl-find-if
- (lambda (f-or-r)
- (if (functionp f-or-r)
- (funcall f-or-r buf)
- (string-match-p f-or-r buf)))
- ivy-ignore-buffers))
- res)
- (and (eq ivy-use-ignore t)
- res)))))
-
-(defun ivy-append-face (str face)
- "Append to STR the property FACE."
- (setq str (copy-sequence str))
- (ivy-add-face-text-property 0 (length str) face str t)
- str)
-
-(defun ivy-switch-buffer-transformer (str)
- "Transform candidate STR when switching buffers."
- (let ((b (get-buffer str)))
- (if (and b (buffer-file-name b))
- (cond
- ((and (not (ignore-errors (file-remote-p (buffer-file-name b))))
- (not (verify-visited-file-modtime b)))
- (ivy-append-face str 'ivy-modified-outside-buffer))
- ((buffer-modified-p b)
- (ivy-append-face str 'ivy-modified-buffer))
- (t str))
- str)))
-
-(defun ivy-switch-buffer-occur (cands)
- "Occur function for `ivy-switch-buffer' using `ibuffer'.
-CANDS are the candidates to be displayed."
- (unless cands
- (setq cands (all-completions ivy-text #'internal-complete-buffer)))
- (ibuffer
- nil (buffer-name)
- `((or ,@(cl-mapcan
- (lambda (cand)
- (unless (eq (get-text-property 0 'face cand) 'ivy-virtual)
- `((name . ,(format "\\_<%s\\_>" (regexp-quote cand))))))
- cands)))))
-
-;;;###autoload
-(defun ivy-switch-buffer ()
- "Switch to another buffer."
- (interactive)
- (ivy-read "Switch to buffer: " #'internal-complete-buffer
- :keymap ivy-switch-buffer-map
- :preselect (buffer-name (other-buffer (current-buffer)))
- :action #'ivy--switch-buffer-action
- :matcher #'ivy--switch-buffer-matcher
- :caller 'ivy-switch-buffer))
-
-(ivy-configure 'ivy-switch-buffer
- :occur #'ivy-switch-buffer-occur
- :display-transformer-fn #'ivy-switch-buffer-transformer)
-
-;;;###autoload
-(defun ivy-switch-view ()
- "Switch to one of the window views stored by `ivy-push-view'."
- (interactive)
- (let ((ivy-initial-inputs-alist
- '((ivy-switch-buffer . "{}"))))
- (ivy-switch-buffer)))
-
-;;;###autoload
-(defun ivy-switch-buffer-other-window ()
- "Switch to another buffer in another window."
- (interactive)
- (ivy-read "Switch to buffer in other window: " #'internal-complete-buffer
- :matcher #'ivy--switch-buffer-matcher
- :preselect (buffer-name (other-buffer (current-buffer)))
- :action #'ivy--switch-buffer-other-window-action
- :keymap ivy-switch-buffer-map
- :caller 'ivy-switch-buffer-other-window))
-
-(ivy-configure 'ivy-switch-buffer-other-window
- :occur #'ivy-switch-buffer-occur)
-
-(defun ivy--yank-handle-case-fold (text)
- (if (and (> (length ivy-text) 0)
- (string= (downcase ivy-text) ivy-text))
- (downcase text)
- text))
-
-(defun ivy--yank-by (fn &rest args)
- "Pull buffer text from current line into search string.
-The region to extract is determined by the respective values of
-point before and after applying FN to ARGS."
- (let (text)
- (with-ivy-window
- (let ((beg (point))
- (bol (line-beginning-position))
- (eol (line-end-position))
- end)
- (unwind-protect
- (progn (apply fn args)
- (setq end (goto-char (max bol (min (point) eol))))
- (setq text (buffer-substring-no-properties beg end))
- (ivy--pulse-region beg end))
- (unless text
- (goto-char beg)))))
- (when text
- (insert (replace-regexp-in-string
- " +" " "
- (ivy--yank-handle-case-fold text)
- t t)))))
-
-(defun ivy-yank-word (&optional arg)
- "Pull next word from buffer into search string.
-If optional ARG is non-nil, pull in the next ARG
-words (previous if ARG is negative)."
- (interactive "p")
- (ivy--yank-by #'forward-word arg))
-
-(defun ivy-yank-symbol (&optional arg)
- "Pull next symbol from buffer into search string.
-If optional ARG is non-nil, pull in the next ARG
-symbols (previous if ARG is negative)."
- (interactive "p")
- ;; Emacs < 24.4 compatibility
- (unless (fboundp 'forward-symbol)
- (require 'thingatpt))
- (ivy--yank-by #'forward-symbol (or arg 1)))
-
-(defun ivy-yank-char (&optional arg)
- "Pull next character from buffer into search string.
-If optional ARG is non-nil, pull in the next ARG
-characters (previous if ARG is negative)."
- (interactive "p")
- (ivy--yank-by #'forward-char arg))
-
-(defvar ivy--pulse-overlay nil
- "Overlay used to highlight yanked word.")
-
-(defvar ivy--pulse-timer nil
- "Timer used to dispose of `ivy--pulse-overlay'.")
-
-(defcustom ivy-pulse-delay 0.5
- "Number of seconds to display `ivy-yanked-word' highlight.
-When nil, disable highlighting."
- :type '(choice
- (number :tag "Delay in seconds")
- (const :tag "Disable" nil)))
-
-(defun ivy--pulse-region (start end)
- "Temporarily highlight text between START and END.
-The \"pulse\" duration is determined by `ivy-pulse-delay'."
- (when ivy-pulse-delay
- (if ivy--pulse-overlay
- (let ((ostart (overlay-start ivy--pulse-overlay))
- (oend (overlay-end ivy--pulse-overlay)))
- (when (< end start)
- (cl-rotatef start end))
- ;; Extend the existing overlay's region to include START..END,
- ;; but only if the two regions are contiguous.
- (move-overlay ivy--pulse-overlay
- (if (= start oend) ostart start)
- (if (= end ostart) oend end)))
- (setq ivy--pulse-overlay (make-overlay start end))
- (overlay-put ivy--pulse-overlay 'face 'ivy-yanked-word))
- (when ivy--pulse-timer
- (cancel-timer ivy--pulse-timer))
- (setq ivy--pulse-timer
- (run-at-time ivy-pulse-delay nil #'ivy--pulse-cleanup))))
-
-(defun ivy--pulse-cleanup ()
- "Cancel `ivy--pulse-timer' and delete `ivy--pulse-overlay'."
- (when ivy--pulse-timer
- (cancel-timer ivy--pulse-timer)
- (setq ivy--pulse-timer nil))
- (when ivy--pulse-overlay
- (delete-overlay ivy--pulse-overlay)
- (setq ivy--pulse-overlay nil)))
-
-(defun ivy-kill-ring-save ()
- "Store the current candidates into the kill ring.
-If the region is active, forward to `kill-ring-save' instead."
- (interactive)
- (if (region-active-p)
- (call-interactively 'kill-ring-save)
- (kill-new
- (mapconcat
- #'identity
- ivy--old-cands
- "\n"))))
-
-(defun ivy-insert-current ()
- "Make the current candidate into current input.
-Don't finish completion."
- (interactive)
- (delete-minibuffer-contents)
- (let ((end (and ivy--directory
- (ivy--dirname-p (ivy-state-current ivy-last))
- -1)))
- (insert (substring-no-properties
- (ivy-state-current ivy-last) 0 end))))
-
-(defun ivy-insert-current-full ()
- "Insert the full Yank the current directory into the minibuffer."
- (interactive)
- (insert ivy--directory))
-
-(defcustom ivy-preferred-re-builders
- '((ivy--regex-plus . "ivy")
- (ivy--regex-ignore-order . "order")
- (ivy--regex-fuzzy . "fuzzy"))
- "Alist of preferred re-builders with display names.
-This list can be rotated with `ivy-rotate-preferred-builders'."
- :type '(alist :key-type function :value-type string))
-
-(defun ivy-rotate-preferred-builders ()
- "Switch to the next re builder in `ivy-preferred-re-builders'."
- (interactive)
- (when ivy-preferred-re-builders
- (setq ivy--old-re nil)
- (setq ivy--regex-function
- (let ((cell (assq ivy--regex-function ivy-preferred-re-builders)))
- (car (or (cadr (memq cell ivy-preferred-re-builders))
- (car ivy-preferred-re-builders)))))))
-
-(defun ivy-toggle-fuzzy ()
- "Toggle the re builder between `ivy--regex-fuzzy' and `ivy--regex-plus'."
- (interactive)
- (setq ivy--old-re nil)
- (if (eq ivy--regex-function 'ivy--regex-fuzzy)
- (setq ivy--regex-function 'ivy--regex-plus)
- (setq ivy--regex-function 'ivy--regex-fuzzy)))
-
-(defvar ivy--reverse-i-search-symbol nil
- "Store the history symbol.")
-
-(defun ivy-reverse-i-search-kill ()
- "Remove the current item from history"
- (interactive)
- (if (not (eolp))
- (ivy-kill-line)
- (let ((current (ivy-state-current ivy-last)))
- (if (symbolp ivy--reverse-i-search-symbol)
- (set
- ivy--reverse-i-search-symbol
- (delete current (symbol-value ivy--reverse-i-search-symbol)))
- (ring-remove
- ivy--reverse-i-search-symbol
- (ring-member ivy--reverse-i-search-symbol (ivy-state-current
ivy-last)))))
- (ivy--kill-current-candidate)))
-
-(defvar ivy-reverse-i-search-map
- (let ((map (make-sparse-keymap)))
- (define-key map (kbd "C-k") 'ivy-reverse-i-search-kill)
- map))
-
-(defun ivy-history-contents (history)
- "Copy contents of HISTORY.
-A copy is necessary so that we don't clobber any string attributes.
-Also set `ivy--reverse-i-search-symbol' to HISTORY."
- (setq ivy--reverse-i-search-symbol history)
- (cond ((symbolp history)
- (delete-dups
- (copy-sequence (symbol-value history))))
- ((ring-p history)
- (delete-dups
- (when (> (ring-size history) 0)
- (ring-elements history))))
- ((sequencep history)
- (delete-dups
- (copy-sequence history)))
- (t
- (error "Expected a symbol, ring, or sequence: %S" history))))
-
-(defun ivy-reverse-i-search ()
- "Enter a recursive `ivy-read' session using the current history.
-The selected history element will be inserted into the minibuffer.
-\\<ivy-reverse-i-search-map>
-You can also delete an element from history with
\\[ivy-reverse-i-search-kill]."
- (interactive)
- (cond
- ((= (minibuffer-depth) 0)
- (user-error
- "This command is intended to be called with \"C-r\" from `ivy-read'."))
- ;; don't recur
- ((and (> (minibuffer-depth) 1)
- (eq (ivy-state-caller ivy-last) 'ivy-reverse-i-search)))
- (t
- (let ((enable-recursive-minibuffers t)
- (old-last ivy-last))
- (ivy-read "Reverse-i-search: "
- (ivy-history-contents (ivy-state-history ivy-last))
- :keymap ivy-reverse-i-search-map
- :action (lambda (x)
- (ivy--reset-state
- (setq ivy-last old-last))
- (delete-minibuffer-contents)
- (insert (substring-no-properties x))
- (ivy--cd-maybe))
- :caller 'ivy-reverse-i-search)))))
-
-(defun ivy-restrict-to-matches ()
- "Restrict candidates to current input and erase input."
- (interactive)
- (delete-minibuffer-contents)
- (if (ivy-state-dynamic-collection ivy-last)
- (progn
- (setf (ivy-state-dynamic-collection ivy-last) nil)
- (setf (ivy-state-collection ivy-last)
- (setq ivy--all-candidates ivy--old-cands)))
- (setq ivy--all-candidates
- (ivy--filter ivy-text ivy--all-candidates))))
-
-;;* Occur
-(defvar-local ivy-occur-last nil
- "Buffer-local value of `ivy-last'.
-Can't re-use `ivy-last' because using e.g. `swiper' in the same
-buffer would modify `ivy-last'.")
-
-(defvar ivy-occur-mode-map
- (let ((map (make-sparse-keymap)))
- (define-key map [mouse-1] 'ivy-occur-click)
- (define-key map (kbd "RET") 'ivy-occur-press-and-switch)
- (define-key map (kbd "j") 'ivy-occur-next-line)
- (define-key map (kbd "k") 'ivy-occur-previous-line)
- (define-key map (kbd "h") 'backward-char)
- (define-key map (kbd "l") 'forward-char)
- (define-key map (kbd "f") 'ivy-occur-press)
- (define-key map (kbd "g") 'ivy-occur-revert-buffer)
- (define-key map (kbd "a") 'ivy-occur-read-action)
- (define-key map (kbd "o") 'ivy-occur-dispatch)
- (define-key map (kbd "c") 'ivy-occur-toggle-calling)
- (define-key map (kbd "q") 'quit-window)
- (define-key map (kbd "R") 'read-only-mode)
- (define-key map (kbd "C-d") 'ivy-occur-delete-candidate)
- map)
- "Keymap for Ivy Occur mode.")
-
-(defun ivy-occur-toggle-calling ()
- "Toggle `ivy-calling'."
- (interactive)
- (if (setq ivy-calling (not ivy-calling))
- (progn
- (setq mode-name "Ivy-Occur [calling]")
- (ivy-occur-press))
- (setq mode-name "Ivy-Occur"))
- (force-mode-line-update))
-
-(defun ivy--find-occur-buffer ()
- (let ((cb (current-buffer)))
- (cl-find-if
- (lambda (b)
- (with-current-buffer b
- (and (eq major-mode 'ivy-occur-grep-mode)
- (equal cb (ivy-state-buffer ivy-occur-last)))))
- (buffer-list))))
-
-(defun ivy--select-occur-buffer ()
- (let* ((ob (ivy--find-occur-buffer))
- (ow (cl-find-if (lambda (w) (equal ob (window-buffer w)))
- (window-list))))
- (if ow
- (select-window ow)
- (pop-to-buffer ob))))
-
-(defun ivy-occur-next-line (&optional arg)
- "Move the cursor down ARG lines.
-When `ivy-calling' isn't nil, call `ivy-occur-press'."
- (interactive "p")
- (let ((offset (cond ((derived-mode-p 'ivy-occur-grep-mode) 5)
- ((derived-mode-p 'ivy-occur-mode) 2))))
- (if offset
- (progn
- (if (< (line-number-at-pos) offset)
- (progn
- (goto-char (point-min))
- (forward-line (1- offset)))
- (forward-line arg)
- (when (eolp)
- (forward-line -1)))
- (when ivy-calling
- (ivy-occur-press)))
- (ivy--select-occur-buffer)
- (ivy-occur-next-line arg)
- (ivy-occur-press-and-switch))))
-
-(defun ivy-occur-previous-line (&optional arg)
- "Move the cursor up ARG lines.
-When `ivy-calling' isn't nil, call `ivy-occur-press'."
- (interactive "p")
- (let ((offset (cond ((derived-mode-p 'ivy-occur-grep-mode) 5)
- ((derived-mode-p 'ivy-occur-mode) 2))))
- (if offset
- (progn
- (forward-line (- arg))
- (when (< (line-number-at-pos) offset)
- (goto-char (point-min))
- (forward-line (1- offset)))
- (when ivy-calling
- (ivy-occur-press)))
- (ivy--select-occur-buffer)
- (ivy-occur-previous-line arg)
- (ivy-occur-press-and-switch))))
-
-(defun ivy-occur-next-error (n &optional reset)
- "A `next-error-function' for `ivy-occur-mode'."
- (interactive "p")
- (when reset
- (goto-char (point-min)))
- (setq n (or n 1))
- (let ((ivy-calling t))
- (cond ((< n 0) (ivy-occur-previous-line (- n)))
- (t (ivy-occur-next-line n)))))
-
-(define-derived-mode ivy-occur-mode fundamental-mode "Ivy-Occur"
- "Major mode for output from \\[ivy-occur].
-
-\\{ivy-occur-mode-map}"
- (setq-local view-read-only nil))
-
-(defvar ivy-occur-grep-mode-map
- (let ((map (copy-keymap ivy-occur-mode-map)))
- (define-key map (kbd "C-x C-q") 'ivy-wgrep-change-to-wgrep-mode)
- (define-key map "w" 'ivy-wgrep-change-to-wgrep-mode)
- map)
- "Keymap for Ivy Occur Grep mode.")
-
-(defun ivy-occur-delete-candidate ()
- (interactive)
- (let ((inhibit-read-only t))
- (delete-region (line-beginning-position)
- (1+ (line-end-position)))))
-
-(define-derived-mode ivy-occur-grep-mode grep-mode "Ivy-Occur"
- "Major mode for output from \\[ivy-occur].
-
-\\{ivy-occur-grep-mode-map}"
- (setq-local view-read-only nil)
- (when (fboundp 'wgrep-setup)
- (wgrep-setup)))
-
-(defun ivy--starts-with-dotslash (str)
- (string-match-p "\\`\\.[/\\]" str))
-
-(defun ivy--occur-insert-lines (cands)
- "Insert CANDS into `ivy-occur' buffer."
- (font-lock-mode -1)
- (dolist (cand cands)
- (setq cand
- (if (string-match "\\`\\(.*:[0-9]+:\\)\\(.*\\)\\'" cand)
- (let ((file-and-line (match-string 1 cand))
- (grep-line (match-string 2 cand)))
- (concat
- (propertize file-and-line 'face 'ivy-grep-info)
- (ivy--highlight-fuzzy grep-line)))
- (ivy--highlight-fuzzy (copy-sequence cand))))
- (add-text-properties
- 0 (length cand)
- '(mouse-face
- highlight
- help-echo "mouse-1: call ivy-action")
- cand)
- (insert (if (string-match-p "\\`.[/\\]" cand) "" " ")
- cand ?\n)))
-
-(defun ivy--occur-default (cands)
- "Insert CANDS into the current occur buffer."
- (unless cands
- (let ((coll (ivy-state-collection ivy-last)))
- (when (arrayp coll)
- (setq coll (all-completions "" coll (ivy-state-predicate ivy-last))))
- (setq cands (ivy--filter (ivy-state-text ivy-last) coll))))
- (ivy-occur-mode)
- (insert (format "%d candidates:\n" (length cands)))
- (ivy--occur-insert-lines cands)
- (read-only-mode))
-
-(defun ivy-occur ()
- "Stop completion and put the current candidates into a new buffer.
-
-The new buffer remembers current action(s).
-
-While in the *ivy-occur* buffer, selecting a candidate with RET or
-a mouse click will call the appropriate action for that candidate.
-
-There is no limit on the number of *ivy-occur* buffers."
- (interactive)
- (if (not (window-minibuffer-p))
- (user-error "No completion session is active")
- (let* ((caller (ivy-state-caller ivy-last))
- (occur-fn (or (plist-get ivy--occurs-list caller)
- #'ivy--occur-default))
- (buffer
- (generate-new-buffer
- (format "*ivy-occur%s \"%s\"*"
- (if caller
- (concat " " (prin1-to-string caller))
- "")
- ivy-text))))
- (with-current-buffer buffer
- (funcall occur-fn ivy--old-cands)
- (setf (ivy-state-text ivy-last) ivy-text)
- (setq ivy-occur-last ivy-last))
- (ivy-exit-with-action
- (lambda (_)
- (pop-to-buffer buffer)
- (setq next-error-last-buffer buffer)
- (setq-local next-error-function #'ivy-occur-next-error))))))
-
-(defun ivy-occur-revert-buffer ()
- "Refresh the buffer making it up-to date with the collection.
-
-Currently only works for `swiper'. In that specific case, the
-*ivy-occur* buffer becomes nearly useless as the original buffer
-is updated, since the line numbers no longer match.
-
-Calling this function is as if you called `ivy-occur' on the
-updated original buffer."
- (interactive)
- (let ((caller (ivy-state-caller ivy-occur-last))
- (ivy-last ivy-occur-last))
- (let ((inhibit-read-only t)
- (line (line-number-at-pos)))
- (erase-buffer)
- (funcall (or (plist-get ivy--occurs-list caller)
- #'ivy--occur-default) nil)
- (goto-char (point-min))
- (forward-line (1- line)))
- (setq ivy-occur-last ivy-last)))
-
-(declare-function wgrep-change-to-wgrep-mode "ext:wgrep")
-
-(defun ivy-wgrep-change-to-wgrep-mode ()
- "Forward to `wgrep-change-to-wgrep-mode'."
- (interactive)
- (if (require 'wgrep nil 'noerror)
- (wgrep-change-to-wgrep-mode)
- (error "Package wgrep isn't installed")))
-
-(defun ivy-occur-read-action ()
- "Select one of the available actions as the current one."
- (interactive)
- (let ((ivy-last ivy-occur-last))
- (ivy-read-action)))
-
-(defun ivy-occur-dispatch ()
- "Call one of the available actions on the current item."
- (interactive)
- (let* ((state-action (ivy-state-action ivy-occur-last))
- (actions (if (symbolp state-action)
- state-action
- (copy-sequence state-action))))
- (unwind-protect
- (progn
- (ivy-occur-read-action)
- (ivy-occur-press))
- (setf (ivy-state-action ivy-occur-last) actions))))
-
-(defun ivy-occur-click (event)
- "Execute action for the current candidate.
-EVENT gives the mouse position."
- (interactive "e")
- (let ((window (posn-window (event-end event)))
- (pos (posn-point (event-end event))))
- (with-current-buffer (window-buffer window)
- (goto-char pos)
- (ivy-occur-press))))
-
-(declare-function swiper--cleanup "swiper")
-(declare-function swiper--add-overlays "swiper")
-(defvar ivy-occur-timer nil)
-
-(defun ivy--occur-press-update-window ()
- (cond
- ((memq (ivy-state-caller ivy-occur-last)
- (append '(swiper swiper-isearch) ivy-highlight-grep-commands))
- (let ((window (ivy-state-window ivy-occur-last))
- (buffer (ivy-state-buffer ivy-occur-last)))
- (when (buffer-live-p buffer)
- (cond ((or (not (window-live-p window))
- (equal window (selected-window)))
- (save-selected-window
- (setf (ivy-state-window ivy-occur-last)
- (display-buffer buffer))))
- ((not (equal (window-buffer window) buffer))
- (with-selected-window window
- (switch-to-buffer buffer)))))))
-
- ((memq (ivy-state-caller ivy-occur-last)
- '(counsel-describe-function counsel-describe-variable))
- (setf (ivy-state-window ivy-occur-last)
- (selected-window))
- (selected-window))))
-
-(defun ivy--occur-press-buffer ()
- (let ((buffer (ivy-state-buffer ivy-last)))
- (if (buffer-live-p buffer)
- buffer
- (current-buffer))))
-
-(defun ivy-occur-press ()
- "Execute action for the current candidate."
- (interactive)
- (ivy--occur-press-update-window)
- (when (save-excursion
- (beginning-of-line)
- (looking-at "\\(?:./\\| \\)\\(.*\\)$"))
- (let* ((ivy-last ivy-occur-last)
- (ivy-text (ivy-state-text ivy-last))
- (str (buffer-substring
- (match-beginning 1)
- (match-end 1)))
- (offset (or (get-text-property 0 'offset str) 0))
- (coll (ivy-state-collection ivy-last))
- (action (ivy--get-action ivy-last))
- (ivy-exit 'done))
- (with-ivy-window
- (with-current-buffer (ivy--occur-press-buffer)
- (save-restriction
- (widen)
- (funcall action
- (if (and (consp coll)
- (consp (car coll)))
- (assoc str coll)
- (substring str offset)))))
- (if (memq (ivy-state-caller ivy-last)
- (append '(swiper swiper-isearch)
ivy-highlight-grep-commands))
- (with-current-buffer (window-buffer (selected-window))
- (swiper--cleanup)
- (swiper--add-overlays
- (ivy--regex ivy-text)
- (line-beginning-position)
- (line-end-position)
- (selected-window))
- (when (timerp ivy-occur-timer)
- (cancel-timer ivy-occur-timer))
- (setq ivy-occur-timer
- (run-at-time 1.0 nil 'swiper--cleanup))))))))
-
-(defun ivy-occur-press-and-switch ()
- "Execute action for the current candidate and switch window."
- (interactive)
- (ivy-occur-press)
- (select-window (ivy--get-window ivy-occur-last)))
-
-(defun ivy--marked-p ()
- (member (ivy-state-current ivy-last) ivy-marked-candidates))
-
-(defun ivy--unmark (cand)
- (setcar (member cand ivy--all-candidates)
- (setcar (member cand ivy--old-cands)
- (substring cand (length ivy-mark-prefix))))
- (setq ivy-marked-candidates
- (delete cand ivy-marked-candidates)))
-
-(defun ivy--mark (cand)
- (let ((marked-cand (concat ivy-mark-prefix cand)))
- (setcar (member cand ivy--all-candidates)
- (setcar (member cand ivy--old-cands) marked-cand))
- (setq ivy-marked-candidates
- (append ivy-marked-candidates (list marked-cand)))))
-
-(defun ivy-mark ()
- "Mark the selected candidate and move to the next one.
-
-In `ivy-call', :action will be called in turn for all marked
-candidates.
-
-However, if :multi-action was supplied to `ivy-read', then it
-will be called with `ivy-marked-candidates'. This way, it can
-make decisions based on the whole marked list."
- (interactive)
- (unless (ivy--marked-p)
- (ivy--mark (ivy-state-current ivy-last)))
- (ivy-next-line))
-
-(defun ivy-unmark ()
- "Unmark the selected candidate and move to the next one."
- (interactive)
- (when (ivy--marked-p)
- (ivy--unmark (ivy-state-current ivy-last)))
- (ivy-next-line))
-
-(defun ivy-unmark-backward ()
- "Move to the previous candidate and unmark it."
- (interactive)
- (ivy-previous-line)
- (ivy--exhibit)
- (when (ivy--marked-p)
- (ivy--unmark (ivy-state-current ivy-last))))
-
-(defun ivy-toggle-marks ()
- "Toggle mark for all narrowed candidates."
- (interactive)
- (dolist (cand ivy--old-cands)
- (if (member cand ivy-marked-candidates)
- (ivy--unmark cand)
- (ivy--mark cand))))
-
-(defconst ivy-help-file (let ((default-directory
- (if load-file-name
- (file-name-directory load-file-name)
- default-directory)))
- (if (file-exists-p "ivy-help.org")
- (expand-file-name "ivy-help.org")
- (if (file-exists-p "doc/ivy-help.org")
- (expand-file-name "doc/ivy-help.org"))))
- "The file for `ivy-help'.")
-
-(defvar org-hide-emphasis-markers)
-
-(defun ivy-help ()
- "Help for `ivy'."
- (interactive)
- (let ((buf (get-buffer "*Ivy Help*")))
- (unless buf
- (setq buf (get-buffer-create "*Ivy Help*"))
- (with-current-buffer buf
- (insert-file-contents ivy-help-file)
- (org-mode)
- (setq-local org-hide-emphasis-markers t)
- (view-mode)
- (goto-char (point-min))
- (let ((inhibit-message t))
- (org-cycle '(64)))))
- (if (eq this-command 'ivy-help)
- (switch-to-buffer buf)
- (with-ivy-window
- (pop-to-buffer buf)))
- (view-mode)
- (goto-char (point-min))))
-
-(declare-function ffap-url-p "ffap")
-(defvar ffap-url-fetcher)
-
-(defun ivy-ffap-url-p (string)
- "Forward to `ffap-url-p'."
- (require 'ffap)
- (ffap-url-p string))
-
-(defun ivy-ffap-url-fetcher (url)
- "Calls `ffap-url-fetcher'."
- (require 'ffap)
- (funcall ffap-url-fetcher url))
-
-(ivy-configure 'read-file-name-internal
- :sort-fn #'ivy-sort-file-function-default
- :display-transformer-fn #'ivy-read-file-transformer)
-
-(ivy-configure 'internal-complete-buffer
- :display-transformer-fn #'ivy-switch-buffer-transformer)
-
-(provide 'ivy)
-
-;;; ivy.el ends here
diff --git a/packages/ivy/ivy.info b/packages/ivy/ivy.info
deleted file mode 100644
index caa0fd6..0000000
--- a/packages/ivy/ivy.info
+++ /dev/null
@@ -1,1954 +0,0 @@
-This is ivy.info, produced by makeinfo version 6.5 from ivy.texi.
-
-Ivy manual, version 0.13.0
-
- Ivy is an interactive interface for completion in Emacs. Emacs uses
-completion mechanism in a variety of contexts: code, menus, commands,
-variables, functions, etc. Completion entails listing, sorting,
-filtering, previewing, and applying actions on selected items. When
-active, ‘ivy-mode’ completes the selection process by narrowing
-available choices while previewing in the minibuffer. Selecting the
-final candidate is either through simple keyboard character inputs or
-through powerful regular expressions.
-
- Copyright (C) 2015-2019 Free Software Foundation, Inc.
-
- Permission is granted to copy, distribute and/or modify this
- document under the terms of the GNU Free Documentation License,
- Version 1.3 or any later version published by the Free Software
- Foundation; with no Invariant Sections, no Front-Cover Texts, and
- no Back-Cover Texts. A copy of the license is included in the
- section entitled "GNU Free Documentation License".
-INFO-DIR-SECTION Emacs
-START-INFO-DIR-ENTRY
-* Ivy: (ivy). Using Ivy for completion.
-END-INFO-DIR-ENTRY
-
-
-File: ivy.info, Node: Top, Next: Introduction, Up: (dir)
-
-Ivy User Manual
-***************
-
-* Menu:
-
-* Introduction::
-* Installation::
-* Getting started::
-* Key bindings::
-* Completion Styles::
-* Customization::
-* Commands::
-* API::
-* Variable Index::
-* Keystroke Index::
-
-— The Detailed Node Listing —
-
-Installation
-
-* Installing from Emacs Package Manager::
-* Installing from the Git repository::
-
-Getting started
-
-* Basic customization::
-
-Key bindings
-
-* Global key bindings::
-* Minibuffer key bindings::
-
-Minibuffer key bindings
-
-* Key bindings for navigation::
-* Key bindings for single selection, action, then exit minibuffer: Key
bindings for single selection action then exit minibuffer.
-* Key bindings for multiple selections and actions, keep minibuffer open: Key
bindings for multiple selections and actions keep minibuffer open.
-* Key bindings that alter the minibuffer input::
-* Other key bindings::
-* Hydra in the minibuffer::
-* Saving the current completion session to a buffer::
-
-Completion Styles
-
-* ivy--regex-plus::
-* ivy--regex-ignore-order::
-* ivy--regex-fuzzy::
-
-Customization
-
-* Faces::
-* Defcustoms::
-* Actions::
-* Packages::
-
-Actions
-
-* What are actions?::
-* How can different actions be called?::
-* How to modify the actions list?::
-* Example - add two actions to each command::
-* Example - define a new command with several actions::
-
-Example - add two actions to each command
-
-* How to undo adding the two actions::
-* How to add actions to a specific command::
-
-Example - define a new command with several actions
-
-* Test the above function with ivy-occur::
-
-Commands
-
-* File Name Completion::
-* Buffer Name Completion::
-* Counsel commands::
-
-File Name Completion
-
-* Using TRAMP::
-
-API
-
-* Required arguments for ivy-read::
-* Optional arguments for ivy-read::
-* Example - counsel-describe-function::
-* Example - counsel-locate::
-* Example - ivy-read-with-extra-properties::
-
-
-
-File: ivy.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top
-
-1 Introduction
-**************
-
-Ivy is for quick and easy selection from a list. When Emacs prompts for
-a string from a list of several possible choices, Ivy springs into
-action to assist in narrowing and picking the right string from a vast
-number of choices.
-
- Ivy strives for minimalism, simplicity, customizability and
-discoverability.
-
-Minimalism
-..........
-
- Uncluttered minibuffer is minimalism. Ivy shows the completion
- defaults, the number of matches, and 10 candidate matches below the
- input line. Customize ‘ivy-height’ to adjust the number of
- candidate matches displayed in the minibuffer.
-
-Simplicity
-..........
-
- Simplicity is about Ivy’s behavior in the minibuffer. It is also
- about the code interface to extend Ivy’s functionality. The
- minibuffer area behaves as close to ‘fundamental-mode’ as possible.
- ‘SPC’ inserts a space, for example, instead of being bound to the
- more complex ‘minibuffer-complete-word’. Ivy’s code uses
- easy-to-examine global variables; avoids needless complications
- with branch-introducing custom macros.
-
-Customizability
-...............
-
- Customizability is about being able to use different methods and
- interfaces of completion to tailor the selection process. For
- example, adding a custom display function that points to a selected
- candidate with ‘>’, instead of highlighting the selected candidate
- with the ‘ivy-current-match’ face (see
- ‘ivy-format-functions-alist’). Or take the customization of
- actions, say after the candidate function is selected. ‘RET’ uses
- ‘counsel-describe-function’ to describe the function, whereas ‘M-o
- d’ jumps to that function’s definition in the code. The ‘M-o’
- prefix can be uniformly used with characters like ‘d’ to group
- similar actions.
-
-Discoverability
-...............
-
- Ivy displays easily discoverable commands through the hydra
- facility. ‘C-o’ in the minibuffer displays a hydra menu. It opens
- up within an expanded minibuffer area. Each menu item comes with
- short documentation strings and highlighted one-key completions.
- So discovering even seldom used keys is simply a matter of ‘C-o’ in
- the minibuffer while in the midst of the Ivy interaction. This
- discoverability minimizes exiting Ivy interface for documentation
- look-ups.
-
-
-File: ivy.info, Node: Installation, Next: Getting started, Prev:
Introduction, Up: Top
-
-2 Installation
-**************
-
-Install Ivy automatically through Emacs’s package manager, or manually
-from Ivy’s development repository.
-
- Emacs 24.3 is the oldest version to run Ivy. Emacs 24.4 is the
-oldest version that runs Ivy with fancy faces display.
-
-* Menu:
-
-* Installing from Emacs Package Manager::
-* Installing from the Git repository::
-
-
-File: ivy.info, Node: Installing from Emacs Package Manager, Next:
Installing from the Git repository, Up: Installation
-
-2.1 Installing from Emacs Package Manager
-=========================================
-
-‘M-x’ ‘package-install’ ‘RET’ ‘ivy’ ‘RET’
-
- Ivy is installed as part of ‘ivy’ package, which is available from
-two different package archives, GNU ELPA and MELPA. For the latest
-stable version, use the GNU ELPA archives using the above M-x command.
-
- For current hourly builds, use the MELPA archives. In MELPA, Ivy is
-split into three packages: ‘ivy’, ‘swiper’ and ‘counsel’; you can simply
-install ‘counsel’ which will bring in the other two as dependencies.
-See the code below for adding MELPA to the list of package archives:
-
- (require 'package)
- (add-to-list 'package-archives
- '("melpa" . "https://melpa.org/packages/"))
-
- After this do ‘M-x’ ‘package-refresh-contents’ ‘RET’, followed by
-‘M-x’ ‘package-install’ ‘RET’ ‘counsel’ ‘RET’.
-
- For package manager details, see *note (emacs)Packages::.
-
-
-File: ivy.info, Node: Installing from the Git repository, Prev: Installing
from Emacs Package Manager, Up: Installation
-
-2.2 Installing from the Git repository
-======================================
-
-Why install from Git?
-.....................
-
- • No need to wait for MELPA’s hourly builds
- • Easy to revert to previous versions
- • Contribute to Ivy’s development; send patches; pull requests
-
-Configuration steps
-...................
-
- First clone the Swiper repository with:
-
- cd ~/git && git clone https://github.com/abo-abo/swiper
- cd swiper && make compile
-
- Second, add these lines to the Emacs init file:
-
- (add-to-list 'load-path "~/git/swiper/")
- (require 'ivy)
-
- Then, update the code with:
-
- git pull
- make
-
-
-File: ivy.info, Node: Getting started, Next: Key bindings, Prev:
Installation, Up: Top
-
-3 Getting started
-*****************
-
-First enable Ivy completion everywhere:
-
- (ivy-mode 1)
-
- Note: ‘ivy-mode’ can be toggled on and off with ‘M-x’ ‘ivy-mode’.
-
-* Menu:
-
-* Basic customization::
-
-
-File: ivy.info, Node: Basic customization, Up: Getting started
-
-3.1 Basic customization
-=======================
-
-Here are some basic settings particularly useful for new Ivy users:
-
- (setq ivy-use-virtual-buffers t)
- (setq ivy-count-format "(%d/%d) ")
-
- If you want, you can go without any customizations at all. The above
-settings are the most bang for the buck in terms of customization. So
-users that typically don’t like customize a lot are advised to look at
-these settings first.
-
- For more advanced customizations, refer to ‘M-x describe-variable’
-documentation.
-
-
-File: ivy.info, Node: Key bindings, Next: Completion Styles, Prev: Getting
started, Up: Top
-
-4 Key bindings
-**************
-
-* Menu:
-
-* Global key bindings::
-* Minibuffer key bindings::
-
-
-File: ivy.info, Node: Global key bindings, Next: Minibuffer key bindings,
Up: Key bindings
-
-4.1 Global key bindings
-=======================
-
-Here is a list of commands that are useful to be bound globally, along
-with some sample bindings:
-
-Ivy-based interface to standard commands
-........................................
-
- (global-set-key (kbd "C-s") 'swiper-isearch)
- (global-set-key (kbd "M-x") 'counsel-M-x)
- (global-set-key (kbd "C-x C-f") 'counsel-find-file)
- (global-set-key (kbd "M-y") 'counsel-yank-pop)
- (global-set-key (kbd "<f1> f") 'counsel-describe-function)
- (global-set-key (kbd "<f1> v") 'counsel-describe-variable)
- (global-set-key (kbd "<f1> l") 'counsel-find-library)
- (global-set-key (kbd "<f2> i") 'counsel-info-lookup-symbol)
- (global-set-key (kbd "<f2> u") 'counsel-unicode-char)
- (global-set-key (kbd "<f2> j") 'counsel-set-variable)
- (global-set-key (kbd "C-x b") 'ivy-switch-buffer)
- (global-set-key (kbd "C-c v") 'ivy-push-view)
- (global-set-key (kbd "C-c V") 'ivy-pop-view)
-
-Ivy-based interface to shell and system tools
-.............................................
-
- (global-set-key (kbd "C-c c") 'counsel-compile)
- (global-set-key (kbd "C-c g") 'counsel-git)
- (global-set-key (kbd "C-c j") 'counsel-git-grep)
- (global-set-key (kbd "C-c L") 'counsel-git-log)
- (global-set-key (kbd "C-c k") 'counsel-rg)
- (global-set-key (kbd "C-c m") 'counsel-linux-app)
- (global-set-key (kbd "C-c n") 'counsel-fzf)
- (global-set-key (kbd "C-x l") 'counsel-locate)
- (global-set-key (kbd "C-c J") 'counsel-file-jump)
- (global-set-key (kbd "C-S-o") 'counsel-rhythmbox)
- (global-set-key (kbd "C-c w") 'counsel-wmctrl)
-
-Ivy-resume and other commands
-.............................
-
- ‘ivy-resume’ resumes the last Ivy-based completion.
-
- (global-set-key (kbd "C-c C-r") 'ivy-resume)
- (global-set-key (kbd "C-c b") 'counsel-bookmark)
- (global-set-key (kbd "C-c d") 'counsel-descbinds)
- (global-set-key (kbd "C-c g") 'counsel-git)
- (global-set-key (kbd "C-c o") 'counsel-outline)
- (global-set-key (kbd "C-c t") 'counsel-load-theme)
- (global-set-key (kbd "C-c F") 'counsel-org-file)
-
- You can also enable ‘counsel-mode’ to make some global key binding
-remapping for you.
-
-
-File: ivy.info, Node: Minibuffer key bindings, Prev: Global key bindings,
Up: Key bindings
-
-4.2 Minibuffer key bindings
-===========================
-
-Ivy includes several minibuffer bindings, which are defined in the
-‘ivy-minibuffer-map’ keymap variable. The most frequently used ones are
-described here.
-
- ‘swiper’ or ‘counsel-M-x’ add more key bindings through the ‘keymap’
-argument to ‘ivy-read’. These keys, also active in the minibuffer, are
-described under their respective commands.
-
- A key feature of ‘ivy-minibuffer-map’ is its full editing capability
-where the familiar ‘C-a’, ‘C-f’, ‘M-d’, ‘M-DEL’, ‘M-b’, ‘M-w’, ‘C-k’,
-‘C-y’ key bindings work the same as in ‘fundamental-mode’.
-
-* Menu:
-
-* Key bindings for navigation::
-* Key bindings for single selection, action, then exit minibuffer: Key
bindings for single selection action then exit minibuffer.
-* Key bindings for multiple selections and actions, keep minibuffer open: Key
bindings for multiple selections and actions keep minibuffer open.
-* Key bindings that alter the minibuffer input::
-* Other key bindings::
-* Hydra in the minibuffer::
-* Saving the current completion session to a buffer::
-
-
-File: ivy.info, Node: Key bindings for navigation, Next: Key bindings for
single selection action then exit minibuffer, Up: Minibuffer key bindings
-
-4.2.1 Key bindings for navigation
----------------------------------
-
- • ‘C-n’ (‘ivy-next-line’) selects the next candidate
- • ‘C-p’ (‘ivy-previous-line’) selects the previous candidate
- • ‘M-<’ (‘ivy-beginning-of-buffer’) selects the first candidate
- • ‘M->’ (‘ivy-end-of-buffer’) selects the last candidate
- • ‘C-v’ (‘ivy-scroll-up-command’) scrolls up by ‘ivy-height’ lines
- • ‘M-v’ (‘ivy-scroll-down-command’) scrolls down by ‘ivy-height’
- lines
-
- -- User Option: ivy-wrap
- Specifies the wrap-around behavior for ‘C-n’ and ‘C-p’. When
- ‘ivy-wrap’ is set to ‘t’, ‘ivy-next-line’ and ‘ivy-previous-line’
- will cycle past the last and the first candidates respectively.
-
- Wrap-around behavior is off by default.
-
- -- User Option: ivy-height
- Use this option to adjust the minibuffer height, which also affects
- scroll size when using ‘C-v’ and ‘M-v’ key bindings.
-
- ‘ivy-height’ is 10 lines by default.
-
-
-File: ivy.info, Node: Key bindings for single selection action then exit
minibuffer, Next: Key bindings for multiple selections and actions keep
minibuffer open, Prev: Key bindings for navigation, Up: Minibuffer key
bindings
-
-4.2.2 Key bindings for single selection, action, then exit minibuffer
----------------------------------------------------------------------
-
-Ivy can offer several actions from which to choose which action to run.
-This "calling an action" operates on the selected candidate. For
-example, when viewing a list of files, one action could open it for
-editing, one to view it, another to invoke a special function, and so
-on. Custom actions can be added to this interface. The precise action
-to call on the selected candidate can be delayed until after the
-narrowing is completed. No need to exit the interface if unsure which
-action to run. This delayed flexibility and customization of actions
-extends usability of lists in Emacs.
-
-‘C-m’ or ‘RET’ (‘ivy-done’)
-...........................
-
- Calls the default action and then exits the minibuffer.
-
-‘M-o’ (‘ivy-dispatching-done’)
-..............................
-
- Presents valid actions from which to choose. When only one action
- is available, there is no difference between ‘M-o’ and ‘C-m’.
-
-‘C-j’ (‘ivy-alt-done’)
-......................
-
- When completing file names, selects the current directory candidate
- and starts a new completion session there. Otherwise, it is the
- same as ‘ivy-done’.
-
-‘TAB’ (‘ivy-partial-or-done’)
-.............................
-
- Attempts partial completion, extending current input as much as
- possible. ‘TAB TAB’ is the same as ‘C-j’ (‘ivy-alt-done’).
-
- Example ERT test:
-
- (should
- (equal (ivy-with
- '(progn
- (ivy-read "Test: " '("can do" "can't, sorry" "other"))
- ivy-text)
- "c <tab>")
- "can"))
-
-‘C-M-j’ (‘ivy-immediate-done’)
-..............................
-
- Exits with _the current input_ instead of _the current candidate_
- (like other commands).
-
- This is useful e.g. when you call ‘find-file’ to create a new
- file, but the desired name matches an existing file. In that case,
- using ‘C-j’ would select that existing file, which isn’t what you
- want - use this command instead.
-
-‘C-'’ (‘ivy-avy’)
-.................
-
- Uses avy to select one of the candidates on the current candidate
- page. This can often be faster than multiple ‘C-n’ or ‘C-p’
- keystrokes followed by ‘C-m’.
-
-
-File: ivy.info, Node: Key bindings for multiple selections and actions keep
minibuffer open, Next: Key bindings that alter the minibuffer input, Prev:
Key bindings for single selection action then exit minibuffer, Up: Minibuffer
key bindings
-
-4.2.3 Key bindings for multiple selections and actions, keep minibuffer open
-----------------------------------------------------------------------------
-
-For repeatedly applying multiple actions or acting on multiple
-candidates, Ivy does not close the minibuffer between commands. It
-keeps the minibuffer open for applying subsequent actions.
-
- Adding an extra meta key to the normal key chord invokes the special
-version of the regular commands that enables applying multiple actions.
-
-‘C-M-m’ (‘ivy-call’)
-....................
-
- Is the non-exiting version of ‘C-m’ (‘ivy-done’).
-
- Instead of closing the minibuffer, ‘C-M-m’ allows selecting another
- candidate or another action. For example, ‘C-M-m’ on functions
- list invokes ‘describe-function’. When combined with ‘C-n’,
- function descriptions can be invoked quickly in succession.
-
-‘C-M-o’ (‘ivy-dispatching-call’)
-................................
-
- Is the non-exiting version of ‘M-o’ (‘ivy-dispatching-done’).
-
- For example, during the ‘counsel-rhythmbox’ completion, press
- ‘C-M-o e’ to en-queue the selected candidate, followed by ‘C-n C-m’
- to play the next candidate - the current action reverts to the
- default one after ‘C-M-o’.
-
-‘C-M-n’ (‘ivy-next-line-and-call’)
-..................................
-
- Combines ‘C-n’ and ‘C-M-m’. Moves to next line and applies an
- action.
-
- Comes in handy when opening multiple files from
- ‘counsel-find-file’, ‘counsel-git-grep’, ‘counsel-ag’,
- ‘counsel-rg’, or ‘counsel-locate’ lists. Just hold ‘C-M-n’ for
- rapid-fire default action on each successive element of the list.
-
-‘C-M-p’ (‘ivy-previous-line-and-call’)
-......................................
-
- Combines ‘C-p’ and ‘C-M-m’.
-
- Similar to the above except it moves through the list in the other
- direction.
-
-‘ivy-resume’
-............
-
- Recalls the state of the completion session just before its last
- exit.
-
- Useful after an accidental ‘C-m’ (‘ivy-done’).
-
-
-File: ivy.info, Node: Key bindings that alter the minibuffer input, Next:
Other key bindings, Prev: Key bindings for multiple selections and actions
keep minibuffer open, Up: Minibuffer key bindings
-
-4.2.4 Key bindings that alter the minibuffer input
---------------------------------------------------
-
-‘M-n’ (‘ivy-next-history-element’)
-..................................
-
- Cycles forward through the Ivy command history.
-
- Ivy updates an internal history list after each action. When this
- history list is empty, ‘M-n’ inserts symbol (or URL) at point into
- the minibuffer.
-
-‘M-p’ (‘ivy-previous-history-element’)
-......................................
-
- Cycles forward through the Ivy command history.
-
-‘M-i’ (‘ivy-insert-current’)
-............................
-
- Inserts the current candidate into the minibuffer.
-
- Useful for copying and renaming files, for example: ‘M-i’ to insert
- the original file name string, edit it, and then ‘C-m’ to complete
- the renaming.
-
-‘M-j’ (‘ivy-yank-word’)
-.......................
-
- Inserts the sub-word at point into the minibuffer.
-
- This is similar to ‘C-s C-w’ with ‘isearch’. Ivy reserves ‘C-w’
- for ‘kill-region’. See also ‘ivy-yank-symbol’ and ‘ivy-yank-char’.
-
-‘S-SPC’ (‘ivy-restrict-to-matches’)
-...................................
-
- Deletes the current input, and resets the candidates list to the
- currently restricted matches.
-
- This is how Ivy provides narrowing in successive tiers.
-
-‘C-r’ (‘ivy-reverse-i-search’)
-..............................
-
- Starts a recursive completion session through the command’s
- history.
-
- This works just like ‘C-r’ at the bash command prompt, where the
- completion candidates are the history items. Upon completion, the
- selected candidate string is inserted into the minibuffer.
-
-
-File: ivy.info, Node: Other key bindings, Next: Hydra in the minibuffer,
Prev: Key bindings that alter the minibuffer input, Up: Minibuffer key bindings
-
-4.2.5 Other key bindings
-------------------------
-
-‘M-w’ (‘ivy-kill-ring-save’)
-............................
-
- Copies selected candidates to the kill ring.
-
- Copies the region if the region is active.
-
-
-File: ivy.info, Node: Hydra in the minibuffer, Next: Saving the current
completion session to a buffer, Prev: Other key bindings, Up: Minibuffer key
bindings
-
-4.2.6 Hydra in the minibuffer
------------------------------
-
-‘C-o’ (‘hydra-ivy/body’)
-........................
-
- Invokes the hydra menu with short key bindings.
-
- When Hydra is active, minibuffer editing is disabled and menus
-display short aliases:
-
-Short Normal Command name
-------------------------------------------------
-‘o’ ‘C-g’ ‘keyboard-escape-quit’
-‘j’ ‘C-n’ ‘ivy-next-line’
-‘k’ ‘C-p’ ‘ivy-previous-line’
-‘h’ ‘M-<’ ‘ivy-beginning-of-buffer’
-‘l’ ‘M->’ ‘ivy-end-of-buffer’
-‘d’ ‘C-m’ ‘ivy-done’
-‘f’ ‘C-j’ ‘ivy-alt-done’
-‘g’ ‘C-M-m’ ‘ivy-call’
-‘u’ ‘C-c C-o’ ‘ivy-occur’
-
- Hydra reduces key strokes, for example: ‘C-n C-n C-n C-n’ is ‘C-o
-jjjj’ in Hydra.
-
- Hydra menu offers these additional bindings:
-
-‘c’ (‘ivy-toggle-calling’)
-..........................
-
- Toggle calling the action after each candidate change. It modifies
- ‘j’ to ‘jg’, ‘k’ to ‘kg’ etc.
-
-‘m’ (‘ivy-rotate-preferred-builders’)
-.....................................
-
- Rotate the current regexp matcher.
-
-‘>’ (‘ivy-minibuffer-grow’)
-...........................
-
- Increase ‘ivy-height’ for the current minibuffer.
-
-‘<’ (‘ivy-minibuffer-shrink’)
-.............................
-
- Decrease ‘ivy-height’ for the current minibuffer.
-
-‘w’ (‘ivy-prev-action’)
-.......................
-
- Select the previous action.
-
-‘s’ (‘ivy-next-action’)
-.......................
-
- Select the next action.
-
-‘a’ (‘ivy-read-action’)
-.......................
-
- Use a menu to select an action.
-
-‘C’ (‘ivy-toggle-case-fold’)
-............................
-
- Toggle case folding (match both upper and lower case characters for
- lower case input).
-
- Hydra menu also offers bindings for marking multiple candidates:
-
-Key Command name
---------------------------------
-‘m’ ‘ivy-mark’
-‘u’ ‘ivy-unmark’
-‘DEL’ ‘ivy-unmark-backward’
-‘t’ ‘ivy-toggle-marks’
-
- The action is called on each marked candidate one by one.
-
-
-File: ivy.info, Node: Saving the current completion session to a buffer,
Prev: Hydra in the minibuffer, Up: Minibuffer key bindings
-
-4.2.7 Saving the current completion session to a buffer
--------------------------------------------------------
-
-‘C-c C-o’ (‘ivy-occur’)
-.......................
-
- Saves the current candidates to a new buffer and exits completion.
-
- The new buffer is read-only and has a few useful bindings defined.
-
-‘RET’ or ‘f’ (‘ivy-occur-press’)
-................................
-
- Call the current action on the selected candidate.
-
-‘mouse-1’ (‘ivy-occur-click’)
-.............................
-
- Call the current action on the selected candidate.
-
-‘j’ (‘next-line’)
-.................
-
- Move to next line.
-
-‘k’ (‘previous-line’)
-.....................
-
- Move to previous line.
-
-‘a’ (‘ivy-occur-read-action’)
-.............................
-
- Read an action and make it current for this buffer.
-
-‘o’ (‘ivy-occur-dispatch’)
-..........................
-
- Read an action and call it on the selected candidate.
-
-‘q’ (‘quit-window’)
-...................
-
- Bury the current buffer.
-
- Ivy has no limit on the number of active buffers like these.
-
- Ivy takes care of naming buffers uniquely by constructing descriptive
-names. For example: ‘*ivy-occur counsel-describe-variable "function$*’.
-
-
-File: ivy.info, Node: Completion Styles, Next: Customization, Prev: Key
bindings, Up: Top
-
-5 Completion Styles
-*******************
-
-Ivy’s completion functions rely on a regex builder - a function that
-transforms a string input to a string regex. All current candidates
-simply have to match this regex. Each collection can be assigned its
-own regex builder by customizing ‘ivy-re-builders-alist’.
-
- The keys of this alist are collection names, and the values are one
-of the following:
- • ‘ivy--regex’
- • ‘ivy--regex-plus’
- • ‘ivy--regex-ignore-order’
- • ‘ivy--regex-fuzzy’
- • ‘regexp-quote’
-
- A catch-all key, ‘t’, applies to all collections that don’t have
-their own key.
-
- The default is:
-
- (setq ivy-re-builders-alist
- '((t . ivy--regex-plus)))
-
- This example shows a custom regex builder assigned to file name
-completion:
-
- (setq ivy-re-builders-alist
- '((read-file-name-internal . ivy--regex-fuzzy)
- (t . ivy--regex-plus)))
-
- Here, ‘read-file-name-internal’ is a function that is passed as the
-second argument to ‘completing-read’ for file name completion.
-
- The regex builder resolves as follows (in order of priority):
- 1. ‘re-builder’ argument passed to ‘ivy-read’.
- 2. ‘collection’ argument passed to ‘ivy-read’ is a function and has an
- entry on ‘ivy-re-builders-alist’.
- 3. ‘caller’ argument passed to ‘ivy-read’ has an entry on
- ‘ivy-re-builders-alist’.
- 4. ‘this-command’ has an entry on ‘ivy-re-builders-alist’.
- 5. ‘t’ has an entry on ‘ivy-re-builders-alist’.
- 6. ‘ivy--regex’.
-
-* Menu:
-
-* ivy--regex-plus::
-* ivy--regex-ignore-order::
-* ivy--regex-fuzzy::
-
-
-File: ivy.info, Node: ivy--regex-plus, Next: ivy--regex-ignore-order, Up:
Completion Styles
-
-5.1 ivy–regex-plus
-==================
-
-‘ivy--regex-plus’ is Ivy’s default completion method.
-
- ‘ivy--regex-plus’ matches by splitting the input by spaces and
-rebuilding it into a regex.
-
- As the search string is typed in Ivy’s minibuffer, it is transformed
-into valid regex syntax. If the string is ‘"for example"’, it is
-transformed into
-
- "\\(for\\).*\\(example\\)"
-
- which in regex terminology matches ‘"for"’ followed by a wild card
-and then ‘"example"’. Note how Ivy uses the space character to build
-wild cards. To match a literal white space, use an extra space. So to
-match one space type two spaces, to match two spaces type three spaces,
-and so on.
-
- As Ivy transforms typed characters into regex strings, it provides an
-intuitive feedback through font highlights.
-
- Ivy supports regexp negation with ‘"!"’. For example, ‘"define key !
-ivy quit"’ first selects everything matching ‘"define.*key"’, then
-removes everything matching ‘"ivy"’, and finally removes everything
-matching ‘"quit"’. What remains is the final result set of the negation
-regexp.
-
- Since Ivy treats minibuffer input as a regexp, the standard regexp
-identifiers work: ‘"^"’, ‘"$"’, ‘"\b"’ or ‘"[a-z]"’. The exceptions are
-spaces, which translate to ‘".*"’, and ‘"!"’ that signal the beginning
-of a negation group.
-
-
-File: ivy.info, Node: ivy--regex-ignore-order, Next: ivy--regex-fuzzy,
Prev: ivy--regex-plus, Up: Completion Styles
-
-5.2 ivy–regex-ignore-order
-==========================
-
-‘ivy--regex-ignore-order’ ignores the order of regexp tokens when
-searching for matching candidates. For instance, the input ‘"for
-example"’ will match ‘"example test for"’.
-
-
-File: ivy.info, Node: ivy--regex-fuzzy, Prev: ivy--regex-ignore-order, Up:
Completion Styles
-
-5.3 ivy–regex-fuzzy
-===================
-
-‘ivy--regex-fuzzy’ splits each character with a wild card. Searching
-for ‘"for"’ returns all ‘"f.*o.*r"’ matches, resulting in a large number
-of hits. Yet some searches need these extra hits. Ivy sorts such large
-lists using ‘flx’ package’s scoring mechanism, if it’s installed.
-
- ‘C-o m’ toggles the current regexp builder.
-
-
-File: ivy.info, Node: Customization, Next: Commands, Prev: Completion
Styles, Up: Top
-
-6 Customization
-***************
-
-* Menu:
-
-* Faces::
-* Defcustoms::
-* Actions::
-* Packages::
-
-
-File: ivy.info, Node: Faces, Next: Defcustoms, Up: Customization
-
-6.1 Faces
-=========
-
-‘ivy-current-match’
-...................
-
- Highlights the currently selected candidate.
-
-‘ivy-minibuffer-match-face-1’
-.............................
-
- Highlights the background of the match.
-
-‘ivy-minibuffer-match-face-2’
-.............................
-
- Highlights the first (modulo 3) matched group.
-
-‘ivy-minibuffer-match-face-3’
-.............................
-
- Highlights the second (modulo 3) matched group.
-
-‘ivy-minibuffer-match-face-4’
-.............................
-
- Highlights the third (modulo 3) matched group.
-
-‘ivy-confirm-face’
-..................
-
- Highlights the "(confirm)" part of the prompt.
-
- When ‘confirm-nonexistent-file-or-buffer’ set to ‘t’, then
- confirming non-existent files in ‘ivy-mode’ requires an additional
- ‘RET’.
-
- The confirmation prompt will use this face.
-
- For example:
-
- (setq confirm-nonexistent-file-or-buffer t)
-
- Then call ‘find-file’, enter "eldorado" and press ‘RET’ - the
- prompt will be appended with "(confirm)". Press ‘RET’ once more to
- confirm, or any key to continue the completion.
-
-‘ivy-match-required-face’
-.........................
-
- Highlights the "(match required)" part of the prompt.
-
- When completions have to match available candidates and cannot take
- random input, the "(match required)" prompt signals this
- constraint.
-
- For example, call ‘describe-variable’, enter "waldo" and press
- ‘RET’ - "(match required)" is prompted. Press any key for the
- prompt to disappear.
-
-‘ivy-subdir’
-............
-
- Highlights directories when completing file names.
-
-‘ivy-remote’
-............
-
- Highlights remote files when completing file names.
-
-‘ivy-virtual’
-.............
-
- Highlights virtual buffers when completing buffer names.
-
- Virtual buffers correspond to bookmarks and recent files list,
- ‘recentf’.
-
- Enable virtual buffers with:
-
- (setq ivy-use-virtual-buffers t)
-
-‘ivy-modified-buffer’
-.....................
-
- Highlights modified buffers when switching buffer.
-
-‘ivy-modified-outside-buffer’
-.............................
-
- Highlights buffers modified outside Emacs when switching buffer.
-
- This takes precedence over ‘ivy-modified-buffer’.
-
-
-File: ivy.info, Node: Defcustoms, Next: Actions, Prev: Faces, Up:
Customization
-
-6.2 Defcustoms
-==============
-
- -- User Option: ivy-count-format
- A string that specifies display of number of candidates and current
- candidate, if one exists.
-
- The number of matching candidates by default is shown as a right-
- padded integer value.
-
- To disable showing the number of candidates:
-
- (setq ivy-count-format "")
-
- To also display the current candidate:
-
- (setq ivy-count-format "(%d/%d) ")
-
- The ‘format’-style switches this variable uses are described in the
- ‘format’ documentation.
-
- -- User Option: ivy-display-style
- Specifies highlighting candidates in the minibuffer.
-
- The default setting is ‘'fancy’ in Emacs versions 24.4 or newer.
-
- Set ‘ivy-display-style’ to ‘nil’ for a plain minibuffer.
-
- -- User Option: ivy-on-del-error-function
- Specifies what to do when ‘DEL’ (‘ivy-backward-delete-char’) fails.
-
- This is usually the case when there is no text left to delete,
- i.e., when ‘DEL’ is typed at the beginning of the minibuffer.
-
- The default behavior is to quit the completion after ‘DEL’ – a
- handy key to invoke after mistakenly triggering a completion.
-
-
-File: ivy.info, Node: Actions, Next: Packages, Prev: Defcustoms, Up:
Customization
-
-6.3 Actions
-===========
-
-* Menu:
-
-* What are actions?::
-* How can different actions be called?::
-* How to modify the actions list?::
-* Example - add two actions to each command::
-* Example - define a new command with several actions::
-
-
-File: ivy.info, Node: What are actions?, Next: How can different actions be
called?, Up: Actions
-
-6.3.1 What are actions?
------------------------
-
-An action is a function that is called after you select a candidate
-during completion. This function takes a single string argument, which
-is the selected candidate.
-
-Window context when calling an action
-.....................................
-
- Currently, the action is executed in the minibuffer window context.
- This means e.g. that if you call ‘insert’ the text will be
- inserted into the minibuffer.
-
- If you want to execute the action in the initial window from which
- the completion started, use the ‘with-ivy-window’ wrapper macro.
-
- (defun ivy-insert-action (x)
- (with-ivy-window
- (insert x)))
-
-
-File: ivy.info, Node: How can different actions be called?, Next: How to
modify the actions list?, Prev: What are actions?, Up: Actions
-
-6.3.2 How can different actions be called?
-------------------------------------------
-
- • ‘C-m’ (‘ivy-done’) calls the current action.
- • ‘M-o’ (‘ivy-dispatching-done’) presents available actions for
- selection, calls it after selection, and then exits.
- • ‘C-M-o’ (‘ivy-dispatching-call’) presents available actions for
- selection, calls it after selection, and then does not exit.
-
-
-File: ivy.info, Node: How to modify the actions list?, Next: Example - add
two actions to each command, Prev: How can different actions be called?, Up:
Actions
-
-6.3.3 How to modify the actions list?
--------------------------------------
-
-Currently, you can append any amount of your own actions to the default
-list of actions. This can be done either for a specific command, or for
-all commands at once.
-
- Usually, the command has only one default action. The convention is
-to use single letters when selecting a command, and the letter ‘o’ is
-designated for the default command. This way, ‘M-o o’ should be always
-equivalent to ‘C-m’.
-
-
-File: ivy.info, Node: Example - add two actions to each command, Next:
Example - define a new command with several actions, Prev: How to modify the
actions list?, Up: Actions
-
-6.3.4 Example - add two actions to each command
------------------------------------------------
-
-The first action inserts the current candidate into the Ivy window - the
-window from which ‘ivy-read’ was called.
-
- The second action copies the current candidate to the kill ring.
-
- (defun ivy-yank-action (x)
- (kill-new x))
-
- (defun ivy-copy-to-buffer-action (x)
- (with-ivy-window
- (insert x)))
-
- (ivy-set-actions
- t
- '(("i" ivy-copy-to-buffer-action "insert")
- ("y" ivy-yank-action "yank")))
-
- Then in any completion session, ‘M-o y’ invokes ‘ivy-yank-action’,
-and ‘M-o i’ invokes ‘ivy-copy-to-buffer-action’.
-
-* Menu:
-
-* How to undo adding the two actions::
-* How to add actions to a specific command::
-
-
-File: ivy.info, Node: How to undo adding the two actions, Next: How to add
actions to a specific command, Up: Example - add two actions to each command
-
-6.3.4.1 How to undo adding the two actions
-..........................................
-
-Since ‘ivy-set-actions’ modifies the internal dictionary with new data,
-set the extra actions list to ‘nil’ by assigning ‘nil’ value to the ‘t’
-key as follows:
-
- (ivy-set-actions t nil)
-
-
-File: ivy.info, Node: How to add actions to a specific command, Prev: How to
undo adding the two actions, Up: Example - add two actions to each command
-
-6.3.4.2 How to add actions to a specific command
-................................................
-
-Use the command name as the key:
-
- (ivy-set-actions
- 'swiper
- '(("i" ivy-copy-to-buffer-action "insert")
- ("y" ivy-yank-action "yank")))
-
-
-File: ivy.info, Node: Example - define a new command with several actions,
Prev: Example - add two actions to each command, Up: Actions
-
-6.3.5 Example - define a new command with several actions
----------------------------------------------------------
-
- (defun my-action-1 (x)
- (message "action-1: %s" x))
-
- (defun my-action-2 (x)
- (message "action-2: %s" x))
-
- (defun my-action-3 (x)
- (message "action-3: %s" x))
-
- (defun my-command-with-3-actions ()
- (interactive)
- (ivy-read "test: " '("foo" "bar" "baz")
- :action '(1
- ("o" my-action-1 "action 1")
- ("j" my-action-2 "action 2")
- ("k" my-action-3 "action 3"))))
-
- The number 1 above is the index of the default action. Each action
-has its own string description for easy selection.
-
-* Menu:
-
-* Test the above function with ivy-occur::
-
-
-File: ivy.info, Node: Test the above function with ivy-occur, Up: Example -
define a new command with several actions
-
-6.3.5.1 Test the above function with ‘ivy-occur’
-................................................
-
-To examine each action with each candidate in a key-efficient way, try:
-
- • Call ‘my-command-with-3-actions’
- • Press ‘C-c C-o’ to close the completion window and move to an
- ivy-occur buffer
- • Press ‘kkk’ to move to the first candidate, since the point is most
- likely at the end of the buffer
- • Press ‘oo’ to call the first action
- • Press ‘oj’ and ‘ok’ to call the second and the third actions
- • Press ‘j’ to move to the next candidate
- • Press ‘oo’, ‘oj’, ‘ok’
- • Press ‘j’ to move to the next candidate
- • and so on...
-
-
-File: ivy.info, Node: Packages, Prev: Actions, Up: Customization
-
-6.4 Packages
-============
-
-‘org-mode’
-..........
-
- ‘org-mode’ versions 8.3.3 or later obey ‘completing-read-function’
- (which ‘ivy-mode’ sets). Try refiling headings with similar names
- to appreciate ‘ivy-mode’.
-
-‘magit’
-.......
-
- Uses ivy by default if Ivy is installed.
-
-‘find-file-in-project’
-......................
-
- Uses ivy by default if Ivy is installed.
-
-‘projectile’
-............
-
- Projectile requires this setting for ivy completion:
-
- (setq projectile-completion-system 'ivy)
-
-‘helm-make’
-...........
-
- Helm-make requires this setting for ivy completion.
-
- (setq helm-make-completion-method 'ivy)
-
-automatically integrated packages
-.................................
-
- Ivy re-uses the following packages if they are installed: ‘avy’,
- ‘amx’ or ‘smex’, ‘flx’, and ‘wgrep’.
-
-
-File: ivy.info, Node: Commands, Next: API, Prev: Customization, Up: Top
-
-7 Commands
-**********
-
-* Menu:
-
-* File Name Completion::
-* Buffer Name Completion::
-* Counsel commands::
-
-
-File: ivy.info, Node: File Name Completion, Next: Buffer Name Completion,
Up: Commands
-
-7.1 File Name Completion
-========================
-
-Since file name completion is ubiquitous, Ivy provides extra bindings
-that work here:
-
-‘C-j’ (‘ivy-alt-done’)
-......................
-
- On a directory, restarts completion from that directory.
-
- On a file or ‘./’, exit completion with the selected candidate.
-
-‘DEL’ (‘ivy-backward-delete-char’)
-..................................
-
- Restart the completion in the parent directory if current input is
- empty.
-
-‘//’ (‘self-insert-command’)
-............................
-
- Switch to the root directory.
-
-‘~’ (‘self-insert-command’)
-...........................
-
- Switch to the home directory.
-
-‘/’ (‘self-insert-command’)
-...........................
-
- If the current input matches an existing directory name exactly,
- switch the completion to that directory.
-
-‘M-r’ (‘ivy-toggle-regexp-quote’)
-.................................
-
- Toggle between input as regexp or not.
-
- Switch to matching literally since file names include ‘.’, which is
- for matching any char in regexp mode.
- -- User Option: ivy-extra-directories
- Decide if you want to see ‘../’ and ‘./’ during file name
- completion.
-
- Reason to remove: ‘../’ is the same as ‘DEL’.
-
- Reason not to remove: navigate anywhere with only ‘C-n’, ‘C-p’ and
- ‘C-j’.
-
- Likewise, ‘./’ can be removed.
-
-History
-.......
-
- File history works the same with ‘M-p’, ‘M-n’, and ‘C-r’, but uses
- a custom code for file name completion that cycles through files
- previously opened. It also works with TRAMP files.
-
-* Menu:
-
-* Using TRAMP::
-
-
-File: ivy.info, Node: Using TRAMP, Up: File Name Completion
-
-7.1.1 Using TRAMP
------------------
-
-‘~’ (tilde)
-...........
-
- Move to the home directory. Either the local or the remote one,
- depending on the current directory. The boolean option
- ‘ivy-magic-tilde’ decides whether the binding to do this is ‘~’ or
- ‘~/’.
-
-‘//’ (double slash)
-...................
-
- Move to the root directory. Either the local or the remote one,
- depending on the current directory. Here, you can also select a
- TRAMP connection method, such as ‘ssh’ or ‘scpx’.
-
-‘/ C-j’
-.......
-
- Move the the local root directory.
-
-‘~~’
-....
-
- Move to the local home directory.
-
- From any directory, with the empty input, inputting ‘/ssh:’ and
-pressing ‘C-j’ (or ‘RET’, which is the same thing) completes for host
-and user names.
-
- For ‘/ssh:user@’ input, completes the domain name.
-
- ‘C-i’ works in a similar way to the default completion.
-
- You can also get sudo access for the current directory by inputting
-‘/sudo::’ ‘RET’. Using ‘/sudo:’ (i.e. single colon instead of double)
-will result in a completion session for the desired user.
-
- Multi-hopping is possible, although a bit complex.
-
-Example : connect to a remote host ‘cloud’ and open a file with ‘sudo’ there
-............................................................................
-
- • ‘C-x C-f’ ‘/ssh:cloud|sudo:root:/’.
-
-
-File: ivy.info, Node: Buffer Name Completion, Next: Counsel commands, Prev:
File Name Completion, Up: Commands
-
-7.2 Buffer Name Completion
-==========================
-
- -- User Option: ivy-use-virtual-buffers
- When non-nil, add ‘recentf-mode’ and bookmarks to
- ‘ivy-switch-buffer’ completion candidates.
-
- Adding this to Emacs init file:
-
- (setq ivy-use-virtual-buffers t)
- will add additional virtual buffers to the buffers list for recent
- files. Selecting such virtual buffers, which are highlighted with
- ‘ivy-virtual’ face, will open the corresponding file.
-
-
-File: ivy.info, Node: Counsel commands, Prev: Buffer Name Completion, Up:
Commands
-
-7.3 Counsel commands
-====================
-
-The main advantages of ‘counsel-’ functions over their basic equivalents
-in ‘ivy-mode’ are:
-
- 1. Multi-actions and non-exiting actions work.
- 2. ‘ivy-resume’ can resume the last completion session.
- 3. Customize ‘ivy-set-actions’, ‘ivy-re-builders-alist’.
- 4. Customize individual keymaps, such as ‘counsel-describe-map’,
- ‘counsel-git-grep-map’, or ‘counsel-find-file-map’, instead of
- customizing ‘ivy-minibuffer-map’ that applies to all completion
- sessions.
-
-
-File: ivy.info, Node: API, Next: Variable Index, Prev: Commands, Up: Top
-
-8 API
-*****
-
-The main (and only) entry point is the ‘ivy-read’ function. It takes
-two required arguments and many optional arguments that can be passed by
-a key. The optional ‘:action’ argument is highly recommended for
-features such as multi-actions, non-exiting actions, ‘ivy-occur’ and
-‘ivy-resume’.
-
-* Menu:
-
-* Required arguments for ivy-read::
-* Optional arguments for ivy-read::
-* Example - counsel-describe-function::
-* Example - counsel-locate::
-* Example - ivy-read-with-extra-properties::
-
-
-File: ivy.info, Node: Required arguments for ivy-read, Next: Optional
arguments for ivy-read, Up: API
-
-8.1 Required arguments for ‘ivy-read’
-=====================================
-
-‘prompt’
-........
-
- A prompt string normally ending in a colon and a space.
- ‘ivy-count-format’ is prepended to it during completion.
-
-‘collection’
-............
-
- Either a list of strings, a function, an alist or a hash table.
-
- If a function, then it has to be compatible with ‘all-completions’.
-
-
-File: ivy.info, Node: Optional arguments for ivy-read, Next: Example -
counsel-describe-function, Prev: Required arguments for ivy-read, Up: API
-
-8.2 Optional arguments for ‘ivy-read’
-=====================================
-
-‘predicate’
-...........
-
- Is a function to filter the initial collection. It has to be
- compatible with ‘all-completions’. Tip: most of the time, it’s
- simpler to just apply this filter to the ‘collection’ argument
- itself, e.g. ‘(cl-remove-if-not predicate collection)’.
-
-‘require-match’
-...............
-
- When set to a non-nil value, input must match one of the
- candidates. Custom input is not accepted.
-
-‘initial-input’
-...............
-
- This string argument is included for compatibility with
- ‘completing-read’, which inserts it into the minibuffer.
-
- It’s recommended to use the ‘preselect’ argument instead of this.
-
-‘history’
-.........
-
- Name of the symbol to store history. See ‘completing-read’.
-
-‘preselect’
-...........
-
- Determines which one of the candidates to initially select.
-
- When set to an integer value, select the candidate with that index
- value.
-
- When set to any other non-nil value, select the first candidate
- matching this value. Comparison is first done with ‘equal’. If
- this fails, and when applicable, match ‘preselect’ as a regular
- expression.
-
- Every time the input becomes empty, the item corresponding to
- ‘preselect’ is selected.
-
-‘keymap’
-........
-
- A keymap to be composed with ‘ivy-minibuffer-map’. This keymap has
- priority over ‘ivy-minibuffer-map’ and can be modified at any later
- stage.
-
-‘update-fn’
-...........
-
- Is the function called each time the current candidate changes.
- This function takes no arguments and is called in the minibuffer’s
- ‘post-command-hook’. See ‘swiper’ for an example usage.
-
-‘sort’
-......
-
- When non-nil, use ‘ivy-sort-functions-alist’ to sort the collection
- as long as the collection is not larger than ‘ivy-sort-max-size’.
-
-‘action’
-........
-
- Is the function to call after selection. It takes a string
- argument.
-
-‘unwind’
-........
-
- Is the function to call before exiting completion. It takes no
- arguments. This function is called even if the completion is
- interrupted with ‘C-g’. See ‘swiper’ for an example usage.
-
-‘re-builder’
-............
-
- Is a function that takes a string and returns a valid regex. See
- ‘Completion Styles’ for details.
-
-‘matcher’
-.........
-
- Is a function that takes a regex string and a list of strings and
- returns a list of strings matching the regex. Any ordinary Emacs
- matching function will suffice, yet finely tuned matching functions
- can be used. See ‘counsel-find-file’ for an example usage.
-
-‘dynamic-collection’
-....................
-
- When non-nil, ‘collection’ will be used to dynamically generate the
- candidates each time the input changes, instead of being used once
- statically with ‘all-completions’ to generate a list of strings.
- See ‘counsel-locate’ for an example usage.
-
-‘caller’
-........
-
- Is a symbol that uniquely identifies the function that called
- ‘ivy-read’, which may be useful for further customizations.
-
-
-File: ivy.info, Node: Example - counsel-describe-function, Next: Example -
counsel-locate, Prev: Optional arguments for ivy-read, Up: API
-
-8.3 Example - ‘counsel-describe-function’
-=========================================
-
-This is a typical example of a function with a non-async collection,
-which is a collection where all the strings in the collection are known
-prior to any input from the user.
-
- Only the first two arguments (along with ‘action’) are essential -
-the rest of the arguments are for fine-tuning, and could be omitted.
-
- The ‘action’ argument could also be omitted - but then ‘ivy-read’
-would do nothing except returning the string result, which you could
-later use yourself. However, it’s recommended that you use the ‘action’
-argument.
-
- (defun counsel-describe-function ()
- "Forward to `describe-function'."
- (interactive)
- (ivy-read "Describe function: "
- (let (cands)
- (mapatoms
- (lambda (x)
- (when (fboundp x)
- (push (symbol-name x) cands))))
- cands)
- :keymap counsel-describe-map
- :preselect (ivy-thing-at-point)
- :history 'counsel-describe-symbol-history
- :require-match t
- :action (lambda (x)
- (describe-function
- (intern x)))
- :caller 'counsel-describe-function))
-
- Here are the interesting features of the above function, in the order
-that they appear:
-
- • The ‘prompt’ argument is a simple string ending in ": ".
- • The ‘collection’ argument evaluates to a (large) list of strings.
- • The ‘keymap’ argument is for a custom keymap to supplement
- ‘ivy-minibuffer-map’.
- • The ‘preselect’ is provided by ‘ivy-thing-at-point’, which returns
- a symbol near the point. Ivy then selects the first candidate from
- the collection that matches this symbol. To select this
- pre-selected candidate, a ‘RET’ will suffice. No further user
- input is necessary.
- • The ‘history’ argument is for keeping the history of this command
- separate from the common history in ‘ivy-history’.
- • The ‘require-match’ is set to ‘t’ since it doesn’t make sense to
- call ‘describe-function’ on an un-interned symbol.
- • The ‘action’ argument calls ‘describe-function’ on the interned
- selected candidate.
- • The ‘caller’ argument identifies this completion session. This is
- important, since with the collection being a list of strings and
- not a function name, the only other way for ‘ivy-read’ to identify
- "who’s calling" and to apply the appropriate customizations is to
- examine ‘this-command’. But ‘this-command’ would be modified if
- another command called ‘counsel-describe-function’.
-
-
-File: ivy.info, Node: Example - counsel-locate, Next: Example -
ivy-read-with-extra-properties, Prev: Example - counsel-describe-function,
Up: API
-
-8.4 Example - ‘counsel-locate’
-==============================
-
-This is a typical example of a function with an async collection. Since
-the collection function cannot pre-compute all the locatable files in
-memory within reasonable limits (time or memory), it relies on user
-input to filter the universe of possible candidates to a manageable size
-while also continuing to search asynchronously for possible candidates.
-Both the filtering and searching continues with each character change of
-the input with rapid updates to the collection presented without idle
-waiting times. This live update will continue as long as there are
-likely candidates. Eventually updates to the minibuffer will stop after
-user input, filtering, and searching have exhausted looking for possible
-candidates.
-
- Async collections suit long-running shell commands, such as ‘locate’.
-With each new input, a new process starts while the old process is
-killed. The collection is refreshed anew with each new process.
-Meanwhile the user can provide more input characters (for further
-narrowing) or select a candidate from the visible collection.
-
- (defun counsel-locate-function (str)
- (or
- (ivy-more-chars)
- (progn
- (counsel--async-command
- (format "locate %s '%s'"
- (mapconcat #'identity counsel-locate-options " ")
- (counsel--elisp-to-pcre
- (ivy--regex str))))
- '("" "working..."))))
-
- ;;;###autoload
- (defun counsel-locate (&optional initial-input)
- "Call the \"locate\" shell command.
- INITIAL-INPUT can be given as the initial minibuffer input."
- (interactive)
- (ivy-read "Locate: " #'counsel-locate-function
- :initial-input initial-input
- :dynamic-collection t
- :history 'counsel-locate-history
- :action (lambda (file)
- (with-ivy-window
- (when file
- (find-file file))))
- :unwind #'counsel-delete-process
- :caller 'counsel-locate))
-
- Here are the interesting features of the above functions, in the
-order that they appear:
-
- • ‘counsel-locate-function’ takes a string argument and returns a
- list of strings. Note that it’s not compatible with
- ‘all-completions’, but since we’re not using that here, might as
- well use one argument instead of three.
- • ‘ivy-more-chars’ is a simple function that returns e.g. ‘'("2
- chars more")’ asking the user for more input.
- • ‘counsel--async-command’ is a very easy API simplification that
- takes a single string argument suitable for
- ‘shell-command-to-string’. So you could prototype your function as
- non-async using ‘shell-command-to-string’ and ‘split-string’ to
- produce a collection, then decide that you want async and simply
- swap in ‘counsel--async-command’.
- • ‘counsel-locate’ is an interactive function with an optional
- ‘initial-input’.
- • ‘#'counsel-locate-function’ is passed as the ‘collection’ argument.
- • ‘dynamic-collection’ is set to t, since this is an async
- collection.
- • ‘action’ argument uses ‘with-ivy-window’ wrapper, since we want to
- open the selected file in the same window from which
- ‘counsel-locate’ was called.
- • ‘unwind’ argument is set to ‘#'counsel-delete-process’: when we
- press ‘C-g’ we want to kill the running process created by
- ‘counsel--async-command’.
- • ‘caller’ argument identifies this command for easier customization.
-
-
-File: ivy.info, Node: Example - ivy-read-with-extra-properties, Prev:
Example - counsel-locate, Up: API
-
-8.5 Example - ‘ivy-read-with-extra-properties’
-==============================================
-
-This is another example to show how to associate additional values to
-each displayed strings.
-
- (defun find-candidates-function (str pred _)
- (let ((props '(1 2))
- (strs '("foo" "foo2")))
- (cl-mapcar (lambda (s p) (propertize s 'property p))
- strs
- props)))
-
- (defun find-candidates ()
- (interactive)
- (ivy-read "Find symbols: "
- #'find-candidates-function
- :action (lambda (x)
- (message "Value: %s" (get-text-property 0 'property x)
- ))))
-
- Here are the interesting features of the above function:
-
- • ‘find-candidates-function’ builds up a list of strings and
- associates "foo" with the value 1 and "foo2" with 2.
- • ‘find-candidates’ is an interactive function.
- • ‘#'find-candidates’ is passed as the ‘collection’ argument.
- • ‘action’ gets passed the selected string with the associated value.
- It then retrieves that value and displays it.
-
-
-File: ivy.info, Node: Variable Index, Next: Keystroke Index, Prev: API,
Up: Top
-
-Variable Index
-**************
-
- [index ]
-* Menu:
-
-* ivy-alt-done: Key bindings for single selection
action then exit minibuffer.
- (line 30)
-* ivy-alt-done <1>: File Name Completion. (line 12)
-* ivy-avy: Key bindings for single selection
action then exit minibuffer.
- (line 64)
-* ivy-backward-delete-char: File Name Completion. (line 19)
-* ivy-call: Key bindings for multiple selections
and actions keep minibuffer open.
- (line 16)
-* ivy-confirm-face: Faces. (line 34)
-* ivy-count-format: Defcustoms. (line 6)
-* ivy-current-match: Faces. (line 9)
-* ivy-dispatching-call: Key bindings for multiple selections
and actions keep minibuffer open.
- (line 26)
-* ivy-dispatching-done: Key bindings for single selection
action then exit minibuffer.
- (line 24)
-* ivy-display-style: Defcustoms. (line 24)
-* ivy-done: Key bindings for single selection
action then exit minibuffer.
- (line 19)
-* ivy-extra-directories: File Name Completion. (line 45)
-* ivy-height: Key bindings for navigation.
- (line 21)
-* ivy-immediate-done: Key bindings for single selection
action then exit minibuffer.
- (line 53)
-* ivy-insert-current: Key bindings that alter the
minibuffer input.
- (line 23)
-* ivy-kill-ring-save: Other key bindings. (line 9)
-* ivy-match-required-face: Faces. (line 53)
-* ivy-minibuffer-grow: Hydra in the minibuffer.
- (line 45)
-* ivy-minibuffer-map: Minibuffer key bindings.
- (line 6)
-* ivy-minibuffer-match-face-1: Faces. (line 14)
-* ivy-minibuffer-match-face-2: Faces. (line 19)
-* ivy-minibuffer-match-face-3: Faces. (line 24)
-* ivy-minibuffer-match-face-4: Faces. (line 29)
-* ivy-minibuffer-shrink: Hydra in the minibuffer.
- (line 50)
-* ivy-modified-buffer: Faces. (line 88)
-* ivy-modified-outside-buffer: Faces. (line 93)
-* ivy-next-action: Hydra in the minibuffer.
- (line 60)
-* ivy-next-history-element: Key bindings that alter the
minibuffer input.
- (line 9)
-* ivy-next-line-and-call: Key bindings for multiple selections
and actions keep minibuffer open.
- (line 36)
-* ivy-occur: Saving the current completion session
to a buffer.
- (line 9)
-* ivy-occur-click: Saving the current completion session
to a buffer.
- (line 21)
-* ivy-occur-dispatch: Saving the current completion session
to a buffer.
- (line 41)
-* ivy-occur-press: Saving the current completion session
to a buffer.
- (line 16)
-* ivy-occur-read-action: Saving the current completion session
to a buffer.
- (line 36)
-* ivy-on-del-error-function: Defcustoms. (line 31)
-* ivy-partial-or-done: Key bindings for single selection
action then exit minibuffer.
- (line 37)
-* ivy-prev-action: Hydra in the minibuffer.
- (line 55)
-* ivy-previous-history-element: Key bindings that alter the
minibuffer input.
- (line 18)
-* ivy-previous-line-and-call: Key bindings for multiple selections
and actions keep minibuffer open.
- (line 47)
-* ivy-read-action: Hydra in the minibuffer.
- (line 65)
-* ivy-remote: Faces. (line 71)
-* ivy-restrict-to-matches: Key bindings that alter the
minibuffer input.
- (line 40)
-* ivy-resume: Key bindings for multiple selections
and actions keep minibuffer open.
- (line 55)
-* ivy-reverse-i-search: Key bindings that alter the
minibuffer input.
- (line 48)
-* ivy-rotate-preferred-builders: Hydra in the minibuffer.
- (line 40)
-* ivy-subdir: Faces. (line 66)
-* ivy-toggle-calling: Hydra in the minibuffer.
- (line 34)
-* ivy-toggle-case-fold: Hydra in the minibuffer.
- (line 70)
-* ivy-toggle-regexp-quote: File Name Completion. (line 41)
-* ivy-use-virtual-buffers: Buffer Name Completion.
- (line 6)
-* ivy-virtual: Faces. (line 76)
-* ivy-wrap: Key bindings for navigation.
- (line 14)
-* ivy-yank-word: Key bindings that alter the
minibuffer input.
- (line 32)
-
-
-File: ivy.info, Node: Keystroke Index, Prev: Variable Index, Up: Top
-
-Keystroke Index
-***************
-
- [index ]
-* Menu:
-
-* /: File Name Completion. (line 35)
-* / C-j: Using TRAMP. (line 24)
-* //: File Name Completion. (line 25)
-* // <1>: Using TRAMP. (line 17)
-* <: Hydra in the minibuffer.
- (line 50)
-* >: Hydra in the minibuffer.
- (line 45)
-* ~: File Name Completion. (line 30)
-* ~ <1>: Using TRAMP. (line 9)
-* ~~: Using TRAMP. (line 29)
-* a: Hydra in the minibuffer.
- (line 65)
-* a <1>: Saving the current completion session
to a buffer.
- (line 36)
-* c: Hydra in the minibuffer.
- (line 34)
-* C: Hydra in the minibuffer.
- (line 70)
-* C-': Key bindings for single selection
action then exit minibuffer.
- (line 64)
-* C-c C-o: Saving the current completion session
to a buffer.
- (line 9)
-* C-j: Key bindings for single selection
action then exit minibuffer.
- (line 30)
-* C-j <1>: File Name Completion. (line 12)
-* C-m: Key bindings for single selection
action then exit minibuffer.
- (line 19)
-* C-M-j: Key bindings for single selection
action then exit minibuffer.
- (line 53)
-* C-M-m: Key bindings for multiple selections
and actions keep minibuffer open.
- (line 16)
-* C-M-n: Key bindings for multiple selections
and actions keep minibuffer open.
- (line 36)
-* C-M-o: Key bindings for multiple selections
and actions keep minibuffer open.
- (line 26)
-* C-M-p: Key bindings for multiple selections
and actions keep minibuffer open.
- (line 47)
-* C-o: Hydra in the minibuffer.
- (line 9)
-* C-r: Key bindings that alter the
minibuffer input.
- (line 48)
-* DEL: File Name Completion. (line 19)
-* f: Saving the current completion session
to a buffer.
- (line 16)
-* j: Saving the current completion session
to a buffer.
- (line 26)
-* k: Saving the current completion session
to a buffer.
- (line 31)
-* m: Hydra in the minibuffer.
- (line 40)
-* M-i: Key bindings that alter the
minibuffer input.
- (line 23)
-* M-j: Key bindings that alter the
minibuffer input.
- (line 32)
-* M-n: Key bindings that alter the
minibuffer input.
- (line 9)
-* M-o: Key bindings for single selection
action then exit minibuffer.
- (line 24)
-* M-p: Key bindings that alter the
minibuffer input.
- (line 18)
-* M-r: File Name Completion. (line 41)
-* M-w: Other key bindings. (line 9)
-* mouse-1: Saving the current completion session
to a buffer.
- (line 21)
-* o: Saving the current completion session
to a buffer.
- (line 41)
-* q: Saving the current completion session
to a buffer.
- (line 46)
-* RET: Key bindings for single selection
action then exit minibuffer.
- (line 19)
-* RET <1>: Saving the current completion session
to a buffer.
- (line 16)
-* s: Hydra in the minibuffer.
- (line 60)
-* S-SPC: Key bindings that alter the
minibuffer input.
- (line 40)
-* TAB: Key bindings for single selection
action then exit minibuffer.
- (line 37)
-* w: Hydra in the minibuffer.
- (line 55)
-
-
-
-Tag Table:
-Node: Top1189
-Node: Introduction3100
-Node: Installation5623
-Node: Installing from Emacs Package Manager6073
-Node: Installing from the Git repository7187
-Node: Getting started8007
-Node: Basic customization8314
-Node: Key bindings8909
-Node: Global key bindings9101
-Node: Minibuffer key bindings11575
-Node: Key bindings for navigation12807
-Node: Key bindings for single selection action then exit minibuffer14014
-Node: Key bindings for multiple selections and actions keep minibuffer
open16661
-Node: Key bindings that alter the minibuffer input19053
-Node: Other key bindings20998
-Node: Hydra in the minibuffer21376
-Node: Saving the current completion session to a buffer23794
-Node: Completion Styles25206
-Node: ivy--regex-plus26957
-Node: ivy--regex-ignore-order28443
-Node: ivy--regex-fuzzy28811
-Node: Customization29308
-Node: Faces29494
-Node: Defcustoms31923
-Node: Actions33217
-Node: What are actions?33543
-Node: How can different actions be called?34361
-Node: How to modify the actions list?34932
-Node: Example - add two actions to each command35592
-Node: How to undo adding the two actions36551
-Node: How to add actions to a specific command37003
-Node: Example - define a new command with several actions37419
-Node: Test the above function with ivy-occur38307
-Node: Packages39149
-Node: Commands40114
-Node: File Name Completion40299
-Node: Using TRAMP42095
-Node: Buffer Name Completion43597
-Node: Counsel commands44212
-Node: API44859
-Node: Required arguments for ivy-read45457
-Node: Optional arguments for ivy-read45976
-Node: Example - counsel-describe-function49402
-Node: Example - counsel-locate52260
-Node: Example - ivy-read-with-extra-properties56010
-Node: Variable Index57218
-Node: Keystroke Index64265
-
-End Tag Table
-
-
-Local Variables:
-coding: utf-8
-End:
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [elpa] master 9f15c4b: externals-list (ivy, counsel): Convert to :external,
Stefan Monnier <=