list: show fallback recipes when fallback is enabled

When `set fallback` is active and `just --list` is run, the output now
also includes recipes from parent justfiles, displayed under a
"Fallback recipes from <path>" heading. This walks up the directory
tree, loading each parent justfile until one without fallback is found.

Fixes #1500

Author: veeceey

src/search.rs

@@ -4,7 +4,7 @@ const DEFAULT_JUSTFILE_NAME: &str = JUSTFILE_NAMES[0];
 pub(crate) const JUSTFILE_NAMES: [&str; 2] = ["justfile", ".justfile"];
 const PROJECT_ROOT_CHILDREN: &[&str] = &[".bzr", ".git", ".hg", ".svn", "_darcs"];
 
-#[derive(Debug)]
+#[derive(Debug, Clone)]
 pub(crate) struct Search {
   pub(crate) justfile: PathBuf,
   pub(crate) working_directory: PathBuf,

src/subcommand.rs

@@ -100,7 +100,7 @@ impl Subcommand {
       Dump => Self::dump(config, compilation)?,
       Format => Self::format(config, &search, compilation)?,
       Groups => Self::groups(config, justfile),
-      List { path } => Self::list(config, justfile, path)?,
+      List { path } => Self::list(config, loader, &search, justfile, path)?,
       Run { arguments } => Self::run(config, loader, search, compilation, arguments)?,
       Show { path } => Self::show(config, justfile, path)?,
       Summary => Self::summary(config, justfile),
@@ -440,7 +440,13 @@ impl Subcommand {
     Ok(())
   }
 
-  fn list(config: &Config, mut module: &Justfile, path: &ModulePath) -> RunResult<'static> {
+  fn list<'src>(
+    config: &Config,
+    loader: &'src Loader,
+    search: &Search,
+    mut module: &Justfile,
+    path: &ModulePath,
+  ) -> RunResult<'src> {
     for name in &path.path {
       module = module
         .modules
@@ -452,6 +458,56 @@ impl Subcommand {
 
     Self::list_module(config, module, 0);
 
+    // If fallback is enabled and we're at the top level, also list
+    // recipes from parent justfiles so users can see the full set of
+    // available recipes.
+    let fallback = module.settings.fallback
+      && matches!(
+        config.search_config,
+        SearchConfig::FromInvocationDirectory | SearchConfig::FromSearchDirectory { .. }
+      );
+
+    if fallback && path.path.is_empty() {
+      let mut parent_search = search.clone();
+
+      while let Ok(next) = parent_search.search_parent_directory(config.ceiling.as_deref()) {
+        parent_search = next;
+
+        let parent_path = parent_search
+          .justfile
+          .parent()
+          .unwrap_or_else(|| Path::new("."));
+
+        if let Ok(compilation) = Self::compile(config, loader, &parent_search) {
+          let parent_justfile = &compilation.justfile;
+
+          let has_recipes = !parent_justfile
+            .public_recipes(config)
+            .is_empty()
+            ;
+
+          if has_recipes {
+            println!();
+            println!(
+              "{}",
+              config.color.stdout().doc().paint(&format!(
+                "# Fallback recipes from {}",
+                parent_path.display()
+              ))
+            );
+            Self::list_module(config, parent_justfile, 0);
+          }
+
+          // Stop walking if this parent doesn't also have fallback
+          if !parent_justfile.settings.fallback {
+            break;
+          }
+        } else {
+          break;
+        }
+      }
+    }
+
     Ok(())
   }
 

tests/fallback.rs

@@ -368,3 +368,31 @@ fn works_with_modules() {
     .stdout("BAZ\n")
     .success();
 }
+
+#[test]
+fn list_shows_fallback_recipes() {
+  Test::new()
+    .justfile(
+      "
+      # A parent recipe
+      parent-recipe:
+        echo parent
+    ",
+    )
+    .write(
+      "sub/justfile",
+      unindent(
+        "
+        set fallback
+
+        # A child recipe
+        child-recipe:
+          echo child
+      ",
+      ),
+    )
+    .args(["--list"])
+    .current_dir("sub")
+    .stdout_regex("(?s).*child-recipe.*Fallback.*parent-recipe.*")
+    .success();
+}