Projectile can be integrated
with Helm via
helm-source-projectile-projects
,
helm-source-projectile-files-list
,
helm-source-projectile-buffers-list
and
helm-source-projectile-recentf-list
sources (available in
helm-projectile.el
). There is also an example function for calling
Helm with the Projectile file source. You can call it like this:
M-x helm-projectile
or even better - invoke the key binding h in Projectile's
keymap. Assuming you've opted for one of the recommended keymap prefixes (C-c p
or s-p
), that would mean C-c p h or s-p h.
See Projectile's installation docs for more details.
The recommended way to install helm-projectile is via package.el
.
You can install a snapshot version of helm-projectile from the MELPA repository. The version of Projectile there will always be up-to-date, but it might be unstable (albeit rarely).
You can install the last stable version of helm-projectile from the MELPA Stable repository.
helm-projectile is also available for installation from the el-get package manager.
helm-projectile is naturally part of the Emacs Prelude. If you're a Prelude user - helm-projectile is already properly configured and ready for action.
Users of Debian 9 or later or Ubuntu 16.04 or later may apt install elpa-helm-projectile
.
For those who prefer helm to ido/ivy, the command helm-projectile-switch-project
can be used to replace projectile-switch-project
to switch project. Please
note that this is different from simply setting projectile-completion-system
to helm
, which just enables projectile to use the Helm completion to complete
a project name. The benefit of using helm-projectile-switch-project
is that on
any selected project we can fire many actions, not limited to just the "switch
to project" action, as in the case of using helm completion by setting
projectile-completion-system
to helm
. Currently, there are five actions:
"Switch to project", "Open Dired in project's directory", "Open project root in
vc-dir or magit", "Switch to Eshell" and "Grep project files". We will add more
and more actions in the future.
helm-projectile
is capable of opening multiple files by marking the files with
C-SPC or mark all files with M-a. Then, press RET,
all the selected files will be opened.
Note that the helm grep is different from projectile-grep
because the helm
grep is incremental. To use it, select your projects (select multiple projects
by pressing C-SPC), press "C-s" (or "C-u C-s" for recursive grep), and type your
regexp. As you type the regexp in the mini buffer, the live grep results are
displayed incrementally.
helm-projectile
also provides Helm versions of common Projectile commands. Currently,
these are the supported commands:
helm-projectile-switch-project
helm-projectile-find-file
helm-projectile-find-file-in-known-projects
helm-projectile-find-file-dwim
helm-projectile-find-dir
helm-projectile-recentf
helm-projectile-switch-to-buffer
helm-projectile-grep
(can be used for both grep or ack)helm-projectile-ag
helm-projectile-rg
projectile-commander
Why should you use these commands compared with the normal Projectile
commands, even if the normal commands use helm
as
projectile-completion-system
? The answer is, Helm specific commands
give more useful features. For example,
helm-projectile-switch-project
allows opening a project in Dired,
Magit or Eshell. helm-projectile-find-file
reuses actions in
helm-find-files
(which is plenty) and able to open multiple
files. Another reason is that in a large source tree, helm-projectile
could be slow because it has to open all available sources.
If you want to use these commands, you have to activate it to replace the normal Projectile commands:
;; (setq helm-projectile-fuzzy-match nil)
(require 'helm-projectile)
(helm-projectile-on)
If you already activate helm-projectile key bindings and you don't
like it, you can turn it off and use the normal Projectile bindings
with command helm-projectile-off
. Similarly, if you want to disable
fuzzy matching in Helm Projectile (it is enabled by default), you must
set helm-projectile-fuzzy-match
to nil before loading
helm-projectile
.
To fully learn Helm Projectile and see what it is capable of, you should refer to this guide: Exploring large projects with Projectile and Helm Projectile.
Obviously you need to have Helm installed for this to work. :-)
The project is currently looking for more maintainers. I (Bozhidar) don't use Helm myself and don't have much time for the project, so I would definitely appreciate some help with it.
Contact me via e-mail or twitter if you'd like to become a co-maintainer.
Check out the project's issue list a list of unresolved issues. By the way - feel free to fix any of them and sent me a pull request. :-)
Here's a list of all the people who have contributed to the development of Projectile.
A fairly extensive changelog is available here.
Note: We started keeping track of changes there after version 1.0.
Copyright © 2011-2020 Bozhidar Batsov and contributors.
Distributed under the GNU General Public License, version 3