path join for default

Join a structured path or a list of path parts.

Signature

> path join ...rest --columns

Parameters

  • ...rest: Path to append to the input
  • --columns {table}: For a record or table input, join strings at the given columns

Notes

Optionally, append an additional path to the result. It is designed to accept the output of 'path parse' and 'path split' subcommands.

Examples

Append a filename to a path

> '/home/viking' | path join spam.txt
/home/viking/spam.txt

Append a filename to a path

> '/home/viking' | path join spams this_spam.txt
/home/viking/spams/this_spam.txt

Append a filename to a path inside a column

> ls | path join spam.txt -c [ name ]

Join a list of parts into a path

> [ '/' 'home' 'viking' 'spam.txt' ] | path join
/home/viking/spam.txt

Join a structured path into a path

> [[ parent stem extension ]; [ '/home/viking' 'spam' 'txt' ]] | path join
╭───┬───────────────────────╮
│ 0 │ /home/viking/spam.txt │
╰───┴───────────────────────╯