forked from emacs-helm/helm
/
helm-lib.el
1357 lines (1208 loc) · 50.5 KB
/
helm-lib.el
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
;;; helm-lib.el --- Helm routines. -*- lexical-binding: t -*-
;; Copyright (C) 2015 ~ 2018 Thierry Volpiatto <thierry.volpiatto@gmail.com>
;; Author: Thierry Volpiatto <thierry.volpiatto@gmail.com>
;; URL: http://github.com/emacs-helm/helm
;; 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 <http://www.gnu.org/licenses/>.
;;; Commentary:
;; All helm functions that don't require specific helm code should go here.
;;; Code:
(require 'cl-lib)
(eval-when-compile (require 'wdired))
(declare-function helm-get-sources "helm.el")
(declare-function helm-marked-candidates "helm.el")
(declare-function helm-follow-mode-p "helm.el")
(declare-function helm-attr "helm.el")
(declare-function helm-attrset "helm.el")
(declare-function org-open-at-point "org.el")
(declare-function org-content "org.el")
(declare-function org-mark-ring-goto "org.el")
(declare-function org-mark-ring-push "org.el")
(defvar helm-current-position)
(defvar wdired-old-marks)
(defvar helm-persistent-action-display-window)
;;; User vars.
;;
(defcustom helm-file-globstar t
"Same as globstar bash shopt option.
When non--nil a pattern beginning with two stars will expand recursively.
Directories expansion is not supported yet."
:group 'helm
:type 'boolean)
(defcustom helm-yank-text-at-point-function nil
"The function used to forward point with `helm-yank-text-at-point'.
With a nil value, fallback to default `forward-word'.
The function should take one arg, an integer like `forward-word'.
NOTE: Using `forward-symbol' here is not very useful as it is already
provided by \\<helm-map>\\[next-history-element]."
:type 'function
:group 'helm)
(defcustom helm-scroll-amount nil
"Scroll amount when scrolling other window in a helm session.
It is used by `helm-scroll-other-window'
and `helm-scroll-other-window-down'.
If you prefer scrolling line by line, set this value to 1."
:group 'helm
:type 'integer)
(defcustom helm-help-full-frame t
"Display help window in full frame when non nil.
Even when `nil' probably the same result (full frame)
can be reach by tweaking `display-buffer-alist' but it is
much more convenient to use a simple boolean value here."
:type 'boolean
:group 'helm-help)
(defvar helm-ff--boring-regexp nil)
(defun helm-ff--setup-boring-regex (var val)
(set var val)
(setq helm-ff--boring-regexp
(cl-loop with last = (car (last val))
for r in (butlast val)
if (string-match "\\$\\'" r)
concat (concat r "\\|") into result
else concat (concat r "$\\|") into result
finally return
(concat result last
(if (string-match "\\$\\'" last) "" "$")))))
(defcustom helm-boring-file-regexp-list
(mapcar (lambda (f)
(let ((rgx (regexp-quote f)))
(if (string-match-p "[^/]$" f)
;; files: e.g .o => \\.o$
(concat rgx "$")
;; directories: e.g .git/ => \.git\\(/\\|$\\)
(concat (substring rgx 0 -1) "\\(/\\|$\\)"))))
completion-ignored-extensions)
"A list of regexps matching boring files.
This list is build by default on `completion-ignored-extensions'.
The directory names should end with \"/?\" e.g. \"\\.git/?\" and the
file names should end with \"$\" e.g. \"\\.o$\".
These regexps may be used to match the entire path, not just the file
name, so for example to ignore files with a prefix \".bak.\", use
\"\\.bak\\..*$\" as the regexp.
NOTE: When modifying this, be sure to use customize interface or the
customize functions e.g. `customize-set-variable' and NOT `setq'."
:group 'helm-files
:type '(repeat (choice regexp))
:set 'helm-ff--setup-boring-regex)
;;; Internal vars
;;
(defvar helm-yank-point nil)
(defvar helm-pattern ""
"The input pattern used to update the helm buffer.")
(defvar helm-buffer "*helm*"
"Buffer showing completions.")
(defvar helm-current-buffer nil
"Current buffer when `helm' is invoked.")
(defvar helm-suspend-update-flag nil)
(defvar helm-action-buffer "*helm action*"
"Buffer showing actions.")
;;; Compatibility
;;
(defun helm-add-face-text-properties (beg end face &optional append object)
"Add the face property to the text from START to END.
It is a compatibility function which behave exactly like
`add-face-text-property' if available otherwise like `add-text-properties'.
When only `add-text-properties' is available APPEND is ignored."
(if (fboundp 'add-face-text-property)
(add-face-text-property beg end face append object)
(add-text-properties beg end `(face ,face) object)))
;; Override `wdired-finish-edit'.
;; Fix emacs bug in `wdired-finish-edit' where
;; Wdired is not handling the case where `dired-directory' is a cons
;; cell instead of a string.
(defun helm--advice-wdired-finish-edit ()
(interactive)
(wdired-change-to-dired-mode)
(let ((changes nil)
(errors 0)
files-deleted
files-renamed
some-file-names-unchanged
file-old file-new tmp-value)
(save-excursion
(when (and wdired-allow-to-redirect-links
(fboundp 'make-symbolic-link))
(setq tmp-value (wdired-do-symlink-changes))
(setq errors (cdr tmp-value))
(setq changes (car tmp-value)))
(when (and wdired-allow-to-change-permissions
(boundp 'wdired-col-perm)) ; could have been changed
(setq tmp-value (wdired-do-perm-changes))
(setq errors (+ errors (cdr tmp-value)))
(setq changes (or changes (car tmp-value))))
(goto-char (point-max))
(while (not (bobp))
(setq file-old (wdired-get-filename nil t))
(when file-old
(setq file-new (wdired-get-filename))
(if (equal file-new file-old)
(setq some-file-names-unchanged t)
(setq changes t)
(if (not file-new) ;empty filename!
(push file-old files-deleted)
(when wdired-keep-marker-rename
(let ((mark (cond ((integerp wdired-keep-marker-rename)
wdired-keep-marker-rename)
(wdired-keep-marker-rename
(cdr (assoc file-old wdired-old-marks)))
(t nil))))
(when mark
(push (cons (substitute-in-file-name file-new) mark)
wdired-old-marks))))
(push (cons file-old (substitute-in-file-name file-new))
files-renamed))))
(forward-line -1)))
(when files-renamed
(setq errors (+ errors (wdired-do-renames files-renamed))))
(if changes
(progn
;; If we are displaying a single file (rather than the
;; contents of a directory), change dired-directory if that
;; file was renamed. (This ought to be generalized to
;; handle the multiple files case, but that's less trivial)
;; fixit [1].
(cond ((and (stringp dired-directory)
(not (file-directory-p dired-directory))
(null some-file-names-unchanged)
(= (length files-renamed) 1))
(setq dired-directory (cdr (car files-renamed))))
;; Fix [1] i.e dired buffers created with
;; (dired '(foo f1 f2 f3)).
((and (consp dired-directory)
(cdr dired-directory)
files-renamed)
(setcdr dired-directory
;; Replace in `dired-directory' files that have
;; been modified with their new name keeping
;; the ones that are unmodified at the same place.
(cl-loop with old-to-rename = (mapcar 'car files-renamed)
for f in (cdr dired-directory)
if (member f old-to-rename)
collect (assoc-default f files-renamed)
else collect f))))
;; Re-sort the buffer if all went well.
(unless (> errors 0) (revert-buffer))
(let ((inhibit-read-only t))
(dired-mark-remembered wdired-old-marks)))
(let ((inhibit-read-only t))
(remove-text-properties (point-min) (point-max)
'(old-name nil end-name nil old-link nil
end-link nil end-perm nil
old-perm nil perm-changed nil))
(message "(No changes to be performed)")))
(when files-deleted
(wdired-flag-for-deletion files-deleted))
(when (> errors 0)
(dired-log-summary (format "%d rename actions failed" errors) nil)))
(set-buffer-modified-p nil)
(setq buffer-undo-list nil))
;; Override `wdired-get-filename'.
;; Fix emacs bug in `wdired-get-filename' which returns the current
;; directory concatened with the filename i.e
;; "/home/you//home/you/foo" when filename is absolute in dired
;; buffer.
;; In consequence Wdired try to rename files even when buffer have
;; been modified and corrected, e.g delete one char and replace it so
;; that no change to file is done.
;; This also lead to ask confirmation for every files even when not
;; modified and when `wdired-use-interactive-rename' is nil.
(defun helm--advice-wdired-get-filename (&optional no-dir old)
;; FIXME: Use dired-get-filename's new properties.
(let (beg end file)
(save-excursion
(setq end (line-end-position))
(beginning-of-line)
(setq beg (next-single-property-change (point) 'old-name nil end))
(unless (eq beg end)
(if old
(setq file (get-text-property beg 'old-name))
;; In the following form changed `(1+ beg)' to `beg' so that
;; the filename end is found even when the filename is empty.
;; Fixes error and spurious newlines when marking files for
;; deletion.
(setq end (next-single-property-change beg 'end-name))
(setq file (buffer-substring-no-properties (1+ beg) end)))
;; Don't unquote the old name, it wasn't quoted in the first place
(and file (setq file (condition-case _err
;; emacs-25+
(apply #'wdired-normalize-filename
(list file (not old)))
(wrong-number-of-arguments
;; emacs-24
(wdired-normalize-filename file))))))
(if (or no-dir old (and file (file-name-absolute-p file)))
file
(and file (> (length file) 0)
(expand-file-name file (dired-current-directory)))))))
;;; Override `push-mark'
;;
;; Fix duplicates in `mark-ring' and `global-mark-ring' and update
;; buffers in `global-mark-ring' to recentest mark.
(defun helm--advice-push-mark (&optional location nomsg activate)
(unless (null (mark t))
(let ((marker (copy-marker (mark-marker))))
(setq mark-ring (cons marker (delete marker mark-ring))))
(when (> (length mark-ring) mark-ring-max)
;; Move marker to nowhere.
(set-marker (car (nthcdr mark-ring-max mark-ring)) nil)
(setcdr (nthcdr (1- mark-ring-max) mark-ring) nil)))
(set-marker (mark-marker) (or location (point)) (current-buffer))
;; Now push the mark on the global mark ring.
(setq global-mark-ring (cons (copy-marker (mark-marker))
;; Avoid having multiple entries
;; for same buffer in `global-mark-ring'.
(cl-loop with mb = (current-buffer)
for m in global-mark-ring
for nmb = (marker-buffer m)
unless (eq mb nmb)
collect m)))
(when (> (length global-mark-ring) global-mark-ring-max)
(set-marker (car (nthcdr global-mark-ring-max global-mark-ring)) nil)
(setcdr (nthcdr (1- global-mark-ring-max) global-mark-ring) nil))
(or nomsg executing-kbd-macro (> (minibuffer-depth) 0)
(message "Mark set"))
(when (or activate (not transient-mark-mode))
(set-mark (mark t)))
nil)
(defcustom helm-advice-push-mark t
"Override `push-mark' with a version avoiding duplicates when non nil."
:group 'helm
:type 'boolean
:set (lambda (var val)
(set var val)
(if val
(advice-add 'push-mark :override #'helm--advice-push-mark)
(advice-remove 'push-mark #'helm--advice-push-mark))))
;;; Macros helper.
;;
(defmacro helm-with-gensyms (symbols &rest body)
"Bind the SYMBOLS to fresh uninterned symbols and eval BODY."
(declare (indent 1))
`(let ,(mapcar (lambda (s)
;; Use cl-gensym here instead of make-symbol
;; to ensure a symbol that have a live that go
;; beyond the live of its macro have different name.
;; i.e symbols created with `with-helm-temp-hook'
;; should have random names.
`(,s (cl-gensym (symbol-name ',s))))
symbols)
,@body))
;;; Command loop helper
;;
(defun helm-this-command ()
"Returns the actual command in action.
Like `this-command' but return the real command,
and not `exit-minibuffer' or other unwanted functions."
(cl-loop with bl = '(helm-maybe-exit-minibuffer
helm-confirm-and-exit-minibuffer
helm-exit-minibuffer
exit-minibuffer)
for count from 1 to 50
for btf = (backtrace-frame count)
for fn = (cl-second btf)
if (and
;; In some case we may have in the way an
;; advice compiled resulting in byte-code,
;; ignore it (Issue #691).
(symbolp fn)
(commandp fn)
(not (memq fn bl)))
return fn
else
if (and (eq fn 'call-interactively)
(> (length btf) 2))
return (cadr (cdr btf))))
;;; Iterators
;;
(cl-defmacro helm-position (item seq &key test all)
"A simple and faster replacement of CL `position'.
Returns ITEM first occurence position found in SEQ.
When SEQ is a string, ITEM have to be specified as a char.
Argument TEST when unspecified default to `eq'.
When argument ALL is non--nil return a list of all ITEM positions
found in SEQ."
(let ((key (if (stringp seq) 'across 'in)))
`(cl-loop with deftest = 'eq
for c ,key ,seq
for index from 0
when (funcall (or ,test deftest) c ,item)
if ,all collect index into ls
else return index
finally return ls)))
(defun helm-iter-list (seq)
"Return an iterator object from SEQ."
(let ((lis seq))
(lambda ()
(let ((elm (car lis)))
(setq lis (cdr lis))
elm))))
(defun helm-iter-circular (seq)
"Infinite iteration on SEQ."
(let ((lis seq))
(lambda ()
(let ((elm (car lis)))
(setq lis (pcase lis (`(,_ . ,ll) (or ll seq))))
elm))))
(cl-defun helm-iter-sub-next-circular (seq elm &key (test 'eq))
"Infinite iteration of SEQ starting at ELM."
(let* ((pos (1+ (helm-position elm seq :test test)))
(sub (append (nthcdr pos seq) (cl-subseq seq 0 pos)))
(iterator (helm-iter-circular sub)))
(lambda ()
(helm-iter-next iterator))))
(defun helm-iter-next (iterator)
"Return next elm of ITERATOR."
(and iterator (funcall iterator)))
;;; Anaphoric macros.
;;
(defmacro helm-aif (test-form then-form &rest else-forms)
"Anaphoric version of `if'.
Like `if' but set the result of TEST-FORM in a temporary variable called `it'.
THEN-FORM and ELSE-FORMS are then excuted just like in `if'."
(declare (indent 2) (debug t))
`(let ((it ,test-form))
(if it ,then-form ,@else-forms)))
(defmacro helm-awhile (sexp &rest body)
"Anaphoric version of `while'.
Same usage as `while' except that SEXP is bound to
a temporary variable called `it' at each turn.
An implicit nil block is bound to the loop so usage
of `cl-return' is possible to exit the loop."
(declare (indent 1) (debug t))
(helm-with-gensyms (flag)
`(let ((,flag t))
(cl-block nil
(while ,flag
(helm-aif ,sexp
(progn ,@body)
(setq ,flag nil)))))))
(defmacro helm-acond (&rest clauses)
"Anaphoric version of `cond'.
In each clause of CLAUSES, the result of the car of clause
is stored in a temporary variable called `it' and usable in the cdr
of this same clause. Each `it' variable is independent of its clause.
The usage is the same as `cond'."
(declare (debug cond))
(unless (null clauses)
(helm-with-gensyms (sym)
(let ((clause1 (car clauses)))
`(let ((,sym ,(car clause1)))
(helm-aif ,sym
(if (cdr ',clause1)
(progn ,@(cdr clause1))
it)
(helm-acond ,@(cdr clauses))))))))
(defmacro helm-aand (&rest conditions)
"Anaphoric version of `and'."
(declare (debug (&rest form)))
(cond ((null conditions) t)
((null (cdr conditions)) (car conditions))
(t `(helm-aif ,(car conditions)
(helm-aand ,@(cdr conditions))))))
;;; Fuzzy matching routines
;;
(defsubst helm--mapconcat-pattern (pattern)
"Transform string PATTERN in regexp for further fuzzy matching.
e.g helm.el$
=> \"[^h]*h[^e]*e[^l]*l[^m]*m[^.]*[.][^e]*e[^l]*l$\"
^helm.el$
=> \"helm[.]el$\"."
(let ((ls (split-string-and-unquote pattern "")))
(if (string= "^" (car ls))
;; Exact match.
(mapconcat (lambda (c)
(if (and (string= c "$")
(string-match "$\\'" pattern))
c (regexp-quote c)))
(cdr ls) "")
;; Fuzzy match.
(mapconcat (lambda (c)
(if (and (string= c "$")
(string-match "$\\'" pattern))
c (format "[^%s]*%s" c (regexp-quote c))))
ls ""))))
(defsubst helm--collect-pairs-in-string (string)
(cl-loop for str on (split-string string "" t) by 'cdr
when (cdr str)
collect (list (car str) (cadr str))))
;;; Help routines.
;;
(defun helm-help-internal (bufname insert-content-fn)
"Show long message during `helm' session in BUFNAME.
INSERT-CONTENT-FN is the function that insert
text to be displayed in BUFNAME."
(let ((winconf (current-frame-configuration))
(hframe (selected-frame)))
(with-selected-frame helm-initial-frame
(select-frame-set-input-focus helm-initial-frame)
(unwind-protect
(progn
(setq helm-suspend-update-flag t)
(set-buffer (get-buffer-create bufname))
(switch-to-buffer bufname)
(when helm-help-full-frame (delete-other-windows))
(delete-region (point-min) (point-max))
(org-mode)
(org-mark-ring-push) ; Put mark at bob
(save-excursion
(funcall insert-content-fn))
(buffer-disable-undo)
(helm-help-event-loop))
(raise-frame hframe)
(setq helm-suspend-update-flag nil)
(set-frame-configuration winconf)))))
(defun helm-help-scroll-up (amount)
(condition-case _err
(scroll-up-command amount)
(beginning-of-buffer nil)
(end-of-buffer nil)))
(defun helm-help-scroll-down (amount)
(condition-case _err
(scroll-down-command amount)
(beginning-of-buffer nil)
(end-of-buffer nil)))
(defun helm-help-next-line ()
(condition-case _err
(call-interactively #'next-line)
(beginning-of-buffer nil)
(end-of-buffer nil)))
(defun helm-help-previous-line ()
(condition-case _err
(call-interactively #'previous-line)
(beginning-of-buffer nil)
(end-of-buffer nil)))
(defun helm-help-toggle-mark ()
(if (region-active-p)
(deactivate-mark)
(push-mark nil nil t)))
;; For movement of cursor in help buffer we need to call interactively
;; commands for impaired people using a synthetizer (#1347).
(defun helm-help-event-loop ()
(let ((prompt (propertize
"[SPC,C-v,next:ScrollUp b,M-v,prior:ScrollDown TAB:Cycle M-TAB:All C-s/r:Isearch q:Quit]"
'face 'helm-helper))
scroll-error-top-bottom
(iter-org-state (helm-iter-circular '(1 (16) (64)))))
(helm-awhile (read-key prompt)
(cl-case it
((?\C-v ? next) (helm-help-scroll-up helm-scroll-amount))
((?\M-v ?b prior) (helm-help-scroll-down helm-scroll-amount))
(?\C-s (isearch-forward))
(?\C-r (isearch-backward))
(?\C-a (call-interactively #'move-beginning-of-line))
(?\C-e (call-interactively #'move-end-of-line))
((?\C-f right) (call-interactively #'forward-char))
((?\C-b left) (call-interactively #'backward-char))
((?\C-n down) (helm-help-next-line))
((?\C-p up) (helm-help-previous-line))
(?\M-a (call-interactively #'backward-sentence))
(?\M-e (call-interactively #'forward-sentence))
(?\M-f (call-interactively #'forward-word))
(?\M-b (call-interactively #'backward-word))
(?\M-> (call-interactively #'end-of-buffer))
(?\M-< (call-interactively #'beginning-of-buffer))
(?\C- (helm-help-toggle-mark))
(?\t (org-cycle))
(?\C-m (ignore-errors (call-interactively #'org-open-at-point)))
(?\C-& (ignore-errors (call-interactively #'org-mark-ring-goto)))
(?\C-% (call-interactively #'org-mark-ring-push))
(?\M-\t (pcase (helm-iter-next iter-org-state)
((pred numberp) (org-content))
((and state) (org-cycle state))))
(?\M-w (copy-region-as-kill
(region-beginning) (region-end))
(deactivate-mark))
(?q (cl-return))
(t (ignore))))))
;;; Multiline transformer
;;
(defun helm-multiline-transformer (candidates _source)
(cl-loop with offset = (helm-interpret-value
(assoc-default 'multiline (helm-get-current-source)))
for i in candidates
if (numberp offset)
collect (cons (helm--multiline-get-truncated-candidate i offset) i)
else collect i))
(defun helm--multiline-get-truncated-candidate (candidate offset)
"Truncate CANDIDATE when its length is > than OFFSET."
(with-temp-buffer
(insert candidate)
(goto-char (point-min))
(if (and offset
(> (buffer-size) offset))
(let ((end-str "[...]"))
(concat
(buffer-substring
(point)
(save-excursion
(forward-char offset)
(setq end-str (if (looking-at "\n")
end-str (concat "\n" end-str)))
(point)))
end-str))
(buffer-string))))
;;; List processing
;;
(defun helm-flatten-list (seq &optional omit-nulls)
"Return a list of all single elements of sublists in SEQ."
(let (result)
(cl-labels ((flatten (seq)
(cl-loop
for elm in seq
if (and (or elm
(null omit-nulls))
(or (atom elm)
(functionp elm)
(and (consp elm)
(cdr elm)
(atom (cdr elm)))))
do (push elm result)
else do (flatten elm))))
(flatten seq))
(nreverse result)))
(defun helm-mklist (obj)
"If OBJ is a list \(but not lambda\), return itself.
Otherwise make a list with one element."
(if (and (listp obj) (not (functionp obj)))
obj
(list obj)))
(cl-defun helm-fast-remove-dups (seq &key (test 'eq))
"Remove duplicates elements in list SEQ.
This is same as `remove-duplicates' but with memoisation.
It is much faster, especially in large lists.
A test function can be provided with TEST argument key.
Default is `eq'.
NOTE: Comparison of special elisp objects (e.g. markers etc...) fails
because their printed representations which are stored in hash-table
can't be compared with with the real object in SEQ.
This is a bug in `puthash' which store the printable representation of
object instead of storing the object itself, this to provide at the
end a printable representation of hashtable itself."
(cl-loop with cont = (make-hash-table :test test)
for elm in seq
unless (gethash elm cont)
collect (puthash elm elm cont)))
(defsubst helm--string-join (strings &optional separator)
"Join all STRINGS using SEPARATOR."
(mapconcat 'identity strings separator))
(defun helm--concat-regexps (regexp-list)
"Return a regexp which matches any of the regexps in REGEXP-LIST."
(if regexp-list
(concat "\\(?:" (helm--string-join regexp-list "\\)\\|\\(?:") "\\)")
"\\<\\>")) ; Match nothing
(defun helm-skip-entries (seq black-regexp-list &optional white-regexp-list)
"Remove entries which matches one of REGEXP-LIST from SEQ."
(let ((black-regexp (helm--concat-regexps black-regexp-list))
(white-regexp (helm--concat-regexps white-regexp-list)))
(cl-loop for i in seq
unless (and (stringp i)
(string-match-p black-regexp i)
(null
(string-match-p white-regexp i)))
collect i)))
(defun helm-boring-directory-p (directory black-list)
"Check if one regexp in BLACK-LIST match DIRECTORY."
(helm-awhile (helm-basedir (directory-file-name
(expand-file-name directory)))
(when (string= it "/") (cl-return nil))
(when (cl-loop for r in black-list
thereis (string-match-p
r (directory-file-name directory)))
(cl-return t))
(setq directory it)))
(defun helm-shadow-entries (seq regexp-list)
"Put shadow property on entries in SEQ matching a regexp in REGEXP-LIST."
(let ((face 'italic))
(cl-loop for i in seq
if (cl-loop for regexp in regexp-list
thereis (and (stringp i)
(string-match regexp i)))
collect (propertize i 'face face)
else collect i)))
(defun helm-remove-if-not-match (regexp seq)
"Remove all elements of SEQ that don't match REGEXP."
(cl-loop for s in seq
for str = (cond ((symbolp s)
(symbol-name s))
((consp s)
(car s))
(t s))
when (string-match-p regexp str)
collect s))
(defun helm-remove-if-match (regexp seq)
"Remove all elements of SEQ that match REGEXP."
(cl-loop for s in seq
for str = (cond ((symbolp s)
(symbol-name s))
((consp s)
(car s))
(t s))
unless (string-match-p regexp str)
collect s))
(defun helm-transform-mapcar (function args)
"`mapcar' for candidate-transformer.
ARGS is (cand1 cand2 ...) or ((disp1 . real1) (disp2 . real2) ...)
\(helm-transform-mapcar 'upcase '(\"foo\" \"bar\"))
=> (\"FOO\" \"BAR\")
\(helm-transform-mapcar 'upcase '((\"1st\" . \"foo\") (\"2nd\" . \"bar\")))
=> ((\"1st\" . \"FOO\") (\"2nd\" . \"BAR\"))
"
(cl-loop for arg in args
if (consp arg)
collect (cons (car arg) (funcall function (cdr arg)))
else
collect (funcall function arg)))
(defun helm-append-at-nth (seq elm index)
"Append ELM at INDEX in SEQ."
(let ((len (length seq)))
(cond ((> index len) (setq index len))
((< index 0) (setq index 0)))
(if (zerop index)
(append elm seq)
(cl-loop for i in seq
for count from 1 collect i
when (= count index)
if (listp elm) append elm
else collect elm))))
(defun helm-source-by-name (name &optional sources)
"Get a Helm source in SOURCES by NAME.
Optional argument SOURCES is a list of Helm sources which default to
`helm-sources'."
(cl-loop with src-list = (if sources
(cl-loop for src in sources
collect (if (listp src)
src
(symbol-value src)))
helm-sources)
for source in src-list
thereis (and (string= name (assoc-default 'name source)) source)))
(defun helm-make-actions (&rest args)
"Build an alist with (NAME . ACTION) elements with each pairs in ARGS.
Where NAME is a string or a function returning a string or nil and ACTION
a function.
If NAME returns nil the pair is skipped.
\(fn NAME ACTION ...)"
(cl-loop for (name fn) on args by #'cddr
when (functionp name)
do (setq name (funcall name))
when name
collect (cons name fn)))
;;; Strings processing.
;;
(defun helm-stringify (elm)
"Return the representation of ELM as a string.
ELM can be a string, a number or a symbol."
(cl-typecase elm
(string elm)
(number (number-to-string elm))
(symbol (symbol-name elm))))
(defun helm-substring (str width)
"Return the substring of string STR from 0 to WIDTH.
Handle multibyte characters by moving by columns."
(with-temp-buffer
(save-excursion
(insert str))
(move-to-column width)
(buffer-substring (point-at-bol) (point))))
(defun helm-substring-by-width (str width &optional endstr)
"Truncate string STR to end at column WIDTH.
Similar to `truncate-string-to-width'.
Add ENDSTR at end of truncated STR.
Add spaces at end if needed to reach WIDTH when STR is shorter than WIDTH."
(cl-loop for ini-str = str
then (substring ini-str 0 (1- (length ini-str)))
for sw = (string-width ini-str)
when (<= sw width) return
(concat ini-str endstr (make-string (- width sw) ? ))))
(defun helm-string-multibyte-p (str)
"Check if string STR contains multibyte characters."
(cl-loop for c across str
thereis (> (char-width c) 1)))
(defun helm-get-pid-from-process-name (process-name)
"Get pid from running process PROCESS-NAME."
(cl-loop with process-list = (list-system-processes)
for pid in process-list
for process = (assoc-default 'comm (process-attributes pid))
when (and process (string-match process-name process))
return pid))
(defun helm-ff-find-printers ()
"Return a list of available printers on Unix systems."
(when (executable-find "lpstat")
(let ((printer-list (with-temp-buffer
(call-process "lpstat" nil t nil "-a")
(split-string (buffer-string) "\n"))))
(cl-loop for p in printer-list
for printer = (car (split-string p))
when printer
collect printer))))
(defun helm-region-active-p ()
(and transient-mark-mode mark-active (/= (mark) (point))))
(defun helm-quote-whitespace (candidate)
"Quote whitespace, if some, in string CANDIDATE."
(replace-regexp-in-string " " "\\\\ " candidate))
(defun helm-current-line-contents ()
"Current line string without properties."
(buffer-substring-no-properties (point-at-bol) (point-at-eol)))
(defun helm--replace-regexp-in-buffer-string (regexp rep str &optional fixedcase literal subexp start)
"Replace REGEXP by REP in string STR.
Same as `replace-regexp-in-string' but handle properly REP as
function with SUBEXP specified.
e.g
(helm--replace-regexp-in-buffer-string \"e\\\\(m\\\\)acs\" 'upcase \"emacs\" t nil 1)
=> \"eMacs\"
(replace-regexp-in-string \"e\\\\(m\\\\)acs\" 'upcase \"emacs\" t nil 1)
=> \"eEMACSacs\"
Also START argument behave as expected unlike
`replace-regexp-in-string'.
e.g
(helm--replace-regexp-in-buffer-string \"f\" \"r\" \"foofoo\" t nil nil 3)
=> \"fooroo\"
(replace-regexp-in-string \"f\" \"r\" \"foofoo\" t nil nil 3)
=> \"roo\"
Unlike `replace-regexp-in-string' this function is buffer-based
implemented i.e replacement is computed inside a temp buffer, so
REGEXP should be used differently than with
`replace-regexp-in-string'.
NOTE: This function is used internally for
`helm-ff-query-replace-on-filenames' and builded for this.
You should use `replace-regexp-in-string' instead unless the behavior
of this function is really needed."
(with-temp-buffer
(insert str)
(goto-char (or start (point-min)))
(while (re-search-forward regexp nil t)
(replace-match (cond ((and (functionp rep) subexp)
(funcall rep (match-string subexp)))
((functionp rep)
(funcall rep str))
(t rep))
fixedcase literal nil subexp))
(buffer-string)))
(defun helm-url-unhex-string (str)
"Same as `url-unhex-string' but ensure STR is completely decoded."
(setq str (or str ""))
(with-temp-buffer
(save-excursion (insert str))
(while (re-search-forward "%[A-Za-z0-9]\\{2\\}" nil t)
(replace-match (byte-to-string (string-to-number
(substring (match-string 0) 1)
16))
t t)
;; Restart from beginning until string is completely decoded.
(goto-char (point-min)))
(decode-coding-string (buffer-string) 'utf-8)))
(defun helm-read-answer (prompt answer-list)
"Prompt user for an answer.
Arg PROMPT is the prompt to present user the different possible
answers, ANSWER-LIST is a list of strings.
If user enter an answer which is one of ANSWER-LIST return this
answer, otherwise keep prompting for a valid answer.
Note that answer should be a single char, only short answer are
accepted.
Example:
(let ((answer (helm-read-answer
\"answer [y,n,!,q]: \"
'(\"y\" \"n\" \"!\" \"q\"))))
(pcase answer
(\"y\" \"yes\")
(\"n\" \"no\")
(\"!\" \"all\")
(\"q\" \"quit\")))
"
(helm-awhile (string
(read-key (propertize prompt 'face 'minibuffer-prompt)))
(if (member it answer-list)
(cl-return it)
(message "Please answer by %s" (mapconcat 'identity answer-list ", "))
(sit-for 1))))
;;; Symbols routines
;;
(defun helm-symbolify (str-or-sym)
"Get symbol of STR-OR-SYM."
(if (symbolp str-or-sym)
str-or-sym
(intern str-or-sym)))
(defun helm-symbol-name (obj)
(if (or (and (consp obj) (functionp obj))
(byte-code-function-p obj))
"Anonymous"
(symbol-name obj)))
(defun helm-describe-function (func)
"FUNC is symbol or string."
(cl-letf (((symbol-function 'message) #'ignore))
(describe-function (helm-symbolify func))))
(defun helm-describe-variable (var)
"VAR is symbol or string."
(cl-letf (((symbol-function 'message) #'ignore))
(describe-variable (helm-symbolify var))))
(defun helm-describe-face (face)
"FACE is symbol or string."
(let ((faces (helm-marked-candidates)))
(cl-letf (((symbol-function 'message) #'ignore))
(describe-face (if (cdr faces)
(mapcar 'helm-symbolify faces)
(helm-symbolify face))))))
(defun helm-elisp--persistent-help (candidate fun &optional name)
"Used to build persistent actions describing CANDIDATE with FUN.
Argument NAME is used internally to know which command to use when
symbol CANDIDATE refers at the same time to variable and a function.
See `helm-elisp-show-help'."
(let ((hbuf (get-buffer (help-buffer))))
(cond ((helm-follow-mode-p)
(if name
(funcall fun candidate name)
(funcall fun candidate)))
((or (and (helm-attr 'help-running-p)
(string= candidate (helm-attr 'help-current-symbol))))
(progn
;; When started from a help buffer,
;; Don't kill this buffer as it is helm-current-buffer.
(unless (equal hbuf helm-current-buffer)
(set-window-buffer (get-buffer-window hbuf)
helm-current-buffer)
(kill-buffer hbuf))
(helm-attrset 'help-running-p nil)))
(t
(if name
(funcall fun candidate name)
(funcall fun candidate))
(helm-attrset 'help-running-p t)))
(helm-attrset 'help-current-symbol candidate)))
(defun helm-find-function (func)
"FUNC is symbol or string."
(find-function (helm-symbolify func)))
(defun helm-find-variable (var)
"VAR is symbol or string."
(find-variable (helm-symbolify var)))
(defun helm-find-face-definition (face)
"FACE is symbol or string."
(find-face-definition (helm-symbolify face)))
(defun helm-kill-new (candidate &optional replace)
"CANDIDATE is symbol or string.
See `kill-new' for argument REPLACE."
(kill-new (helm-stringify candidate) replace))