pub fn select_streams(catalog: &Value, target: &str) -> StreamSelectionsource-rest and source-singer only.Expand description
Mark target — and any parent streams inferable from the catalog — as
selected, returning the rewritten catalog.
Most database / Meltano-SDK taps sync nothing unless a stream is
explicitly selected in the catalog, so a passed-through unselected catalog is
a silent no-op. Parent-keyed taps (e.g. tap-github’s issues needs
repositories) additionally require the parent stream selected even though
faucet only emits the configured child stream.
Parent relationships are inferred, best-effort, from a parent_stream /
parent field on the stream object or its stream-level (breadcrumb: [])
metadata — the places taps that expose the relationship put it. When no such
hint exists but the catalog has other streams, a warning is emitted so the
user knows a parent may need manual selection.