Connect Outputs → Inputs
You can add a connection between metaframes where the outputs of the source metaframe will be sent to the inputs of the target metaframe. By default, all outputs will be sent to the inputs, but you can also
- filter the outputs using glob patterns
- change the filename or directory the file will appear in the target
There are two parts to the connection definition, both are optional:
- The output name or filter (defaults to
**which means “everything”) - The target file or folder (if empty, then the input name and relative path is the same as the output name)
Filtering Outputs
Use names or globs to filter and collect outputs:
| Output name | Output filter | Passed downstream? |
|---|---|---|
| any output | (empty string) | ✅ |
| any output | ** | ✅ |
foo.bar | *.bar | ✅ |
dir1/foo.bar | *.bar | ❌ |
dir1/foo.bar | **/*.bar | ✅ |
dir1/foo.bar | */foo | ✅ |
The table above illustrates the neccesary output filter for passing certain files. ** or (empty string) will pass all files. *.bar will pass any files with names ending with .bar not nested inside a folder. If you want to pass a file that is in located in a directory, like dir1/foo.bar, the filter *.bar will not work. For this you need to either specify the directory or precede the glob with **/ to capture files inside folders.
Mapping To Inputs
The input part of the connection can be either a name, directory, or empty
| empty | If empty then the filtered outputs are passed as inputs, without modification to the path or name |
|---|---|
a directory name (ends with /) | The directory name will be prepended to the full path of the input(s) |
a (file) name (does not end with /) | Upstream output(s) are renamed as the input file name. If multiple outputs match, then only one will be the input. |
Examples:
- foo.txt —> (empty string)
- This will send /outputs/foo.txt in the source metaframe to /inputs/foo.txt in the target metaframe
- _foo.txt —> bar/ (_Specify path)
- Sends /outputs/foo.txt in source to /inputs/bar/foo.txt in target
- foo.txt —> bar.txt (Simple rename)
- Sends /outputs/foo.txt in source to /inputs/bar.txt in target
- foo.txt —> foobar/bar.txt (Change name and path)
- Sends /outputs/foo.txt in source to /inputs/foobar/bar.txt in target