Add recursive parameter to inspection API

[mmarchetti]

Intent

This PR implements a recursive option to the POST /api/inspect endpoint.

Part of https://github.com/posit-dev/publisher/issues/1850

Type of Change

• • [ ] Bug Fix
• • [x] New Feature
• • [ ] Breaking Change
• • [ ] Documentation
• • [ ] Refactor
• • [ ] Tooling

Approach

Walk the tree, inspecting every directory we find. The built-in exclusions are applied to avoid excess directory traversals.

Currently, performance is not great. On my machine, running in this source repo:

• Inspecting the entire repo: 24 seconds to return 40 configurations
• Inspecting test/sample-content: 8 seconds to return 14 configurations
• Inspecting the entire repo with entrypoint=simple.py: 8 seconds to return 2 configurations
• Inspecting test/sample-content with entrypoint=simple.py: 2 seconds to return 2 configurations

Automated Tests

There are no tests for this endpoint yet; that needs to change.

Directions for Reviewers

$(just executable-path) ui -vv --listen=localhost:9001 &
curl -s -XPOST -d '{}' 'localhost:9001/api/inspect?recursive=true&dir=test/sample-content' | jq
curl -s -XPOST -d '{}' 'localhost:9001/api/inspect?recursive=true' | jq
curl -s -XPOST -d '{}' 'localhost:9001/api/inspect?recursive=true&dir=test/sample-content&entrypoint=simple.py' | jq

[sagerb]

My timings (intel Mac) are similar:

• Inspecting the entire repo: 28 seconds to return 44 configurations
• Inspecting test/sample-content: 8 seconds to return 12 configurations
• Inspecting the entire repo with entrypoint=simple.py: 10 seconds to return 2 configurations
• Inspecting test/sample-content with entrypoint=simple.py: 4 seconds to return 2 configurations

While bad, I think it would still be acceptable for now.