list: show fallback recipes when fallback is enabled

[veeceey]

When set fallback is active, just --list now walks up the directory tree and also displays recipes from parent justfiles. Each parent's recipes appear under a clearly labeled heading:

Available recipes:
    child-recipe # A child recipe

# Fallback recipes from /path/to/parent
Available recipes:
    build         # Another one
    parent-recipe # A parent recipe

It keeps walking as long as each parent also has set fallback enabled, and respects the same search config constraints as the run fallback logic (only works with directory-based search, not --justfile).

Changes:

• Search now derives Clone so we can iterate parent directories
• list() takes loader and search parameters to compile parent justfiles
• Added integration test

Manual test results:

$ cd /tmp/just-test/sub && just --list
Available recipes:
    child-recipe # A child recipe

# Fallback recipes from /private/tmp/just-test
Available recipes:
    build         # Another one
    parent-recipe # A parent recipe

All existing fallback (14) and list (45) tests pass.

Fixes #1500

[veeceey]

just a gentle nudge on this when you have a moment!

[casey]

Thanks for the PR!

The fallback logic is complex enough that I don't want to duplicate it. It should be shared between list and run.

Also, not all recipes in parent justfiles are runnable.In particular, if you have a recipe foo in the justfile in the current directory, and a recipe foo in a fallback justfile in the parent directory, the parent foo is not runnable, since just foo will run foo in the current directory, so it should be filtered.

[cbrown1234]

I've had a stab at implementing the shared logic, covering casey's suggestions and the other features noted in #1500

You can see the diff here: cbrown1234#1

I don't seem to be able to raise PR's to the project, even though the contributing section of the README seems to indicate I should, maybe things have changed and that's not been updated yet?

[casey]

@cbrown1234 Sorry about that! PRs are currently closed. See #3227. I just added a note to the top of the contributing section of the readme in #3289.