From: Spencer Baugh <sbaugh@janestreet.com>
Date: Thu, 5 Sep 2024 13:56:50 +0000 (-0400)
Subject: * etc/NEWS: Mention it.
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=e6c4ca04f39c7aa4846749887150ebed3c5bb6ca;p=emacs.git

* etc/NEWS: Mention it.

Add project-find-file-in-root (bug#73044)

Several users have asked me for a command which is just
find-file, but starting from the project root.  In large
projects, where project-files is expensive, this will have
substantially better performance than project-find-file.

Also, it allows opening files which aren't included in
project-files without paying the further cost of running
project--files-in-directory (which is what happens when passing
INCLUDE-ALL=t to project-find-file).

Also, it may help with user confusion about why
project-find-file doesn't behave like find-file (which I've
encountered a few times).

This command is equivalent to C-x p o C-x C-f, but it's nice to
be able to bind it to a specific key.

Overall, this is easy enough to provide, so let's just do that.

* lisp/progmodes/project.el (project-find-file-in-root): Add.

* etc/NEWS: Mention it.

(cherry picked from commit d879c40f68c078bdba15122e4e886a2052fbddf4)
---

diff --git a/etc/NEWS b/etc/NEWS
index 23608073270..4726ee54674 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -81,6 +81,11 @@ latter throws an error when the argument FRAME cannot be deleted.
 *** New abnormal hook 'tab-bar-auto-width-functions'.
 This hook allows you to control which tab-bar tabs are auto-resized.
 
+** Project
+
+New command `project-find-file-in-root` which is equivalent to running
+‘project-any-command’ with ‘find-file’.
+
 
 * Editing Changes in Emacs 31.1
 
diff --git a/lisp/progmodes/project.el b/lisp/progmodes/project.el
index b567b8afc2d..9c87b1872bf 100644
--- a/lisp/progmodes/project.el
+++ b/lisp/progmodes/project.el
@@ -1072,6 +1072,19 @@ using a command like `project-find-file'."
               (file-relative-name filename (project-root filename-proj)))
     filename))
 
+;;;###autoload
+(defun project-find-file-in-root ()
+  "Call `find-file' in the current project root.
+
+Unlike `project-find-file', this doesn't provide completion over the
+entire file tree.
+
+This is equivalent to running `project-any-command' with `find-file'."
+  (interactive)
+  (let* ((pr (project-current t))
+         (default-directory (project-root pr)))
+    (call-interactively #'find-file)))
+
 ;;;###autoload
 (defun project-find-file (&optional include-all)
   "Visit a file (with completion) in the current project.