Put document

Description
This command allows you to modify data at a given selector.
It generally works in the same way as put, but allows you to write entire documents with a single command.
Note that put document will completely overwrite any existing data at the given selector.
Usage
dasel put document -f <file> -d <document-parser> <selector> <document>
Flag
Description
<document>
The document you want to put, as a marshaled/encoded string.
This is required.
-d, <document-parser>
Specify the parser to use when reading the document value.
If no value is provided, the read parser is used.
See supported file types.
-f, --file
Specify the file to query. This is required unless you are piping in data.
If piping in data you can optionally pass -f stdin/-f -.
-o, --out
Specify the output file. If present, results will be written to the given file. If not present, results will be written to the input file (or stdout if none given).
To force output to be written to stdout, pass -o stdoutor-o -.
-r, --read
Specify the parser to use when reading the input data.
This is required if you are piping in data, otherwise dasel will use the given file extension to guess which parser to use.
See supported file types.
-w, --write
Specify the parser to use when writing the output data.
If not provided dasel will attempt to use the --out and --read flags to determine which parser to use.
See supported file types.
-p, --parser
Shorthand for -r <value> -w <value>
-m, --multiple
Tells dasel to put multiple items.
See multiple.
-s, --selector, <selector>
Specify the selector to use. See selectors for more information.
If no selector flag is given, dasel assumes the first argument given is the selector.
This is required.
-c, --compact
This tells dasel to output compact data where possible. E.g. not pretty printing JSON.
--merge-input-documents
See merge input documents.
Example
Put YAML document into JSON
echo '{"people":[]}' | dasel put document -p json -d yaml '.people.[]' 'name: Tom
colours:
- red
- green
- blue'
{
  "people": [
    {
      "colours": [
        "red",
        "green",
        "blue"
      ],
      "name": "Tom"
    }
  ]
}

Usage - Previous

Put object

Next - Usage

Flags

Last updated 3 months ago

Flag	Description
`<document>`	The document you want to put, as a marshaled/encoded string. This is required.
`-d`, `<document-parser>`	Specify the parser to use when reading the document value. If no value is provided, the read parser is used. See supported file types.
`-f`, `--file`	Specify the file to query. This is required unless you are piping in data. If piping in data you can optionally pass `-f stdin`/`-f -`.
`-o`, `--out`	Specify the output file. If present, results will be written to the given file. If not present, results will be written to the input file (or stdout if none given). To force output to be written to stdout, pass `-o stdout`or`-o -`.
`-r`, `--read`	Specify the parser to use when reading the input data. This is required if you are piping in data, otherwise dasel will use the given file extension to guess which parser to use. See supported file types.
`-w`, `--write`	Specify the parser to use when writing the output data. If not provided dasel will attempt to use the `--out` and `--read` flags to determine which parser to use. See supported file types.
`-p`, `--parser`	Shorthand for `-r <value> -w <value>`
`-m`, `--multiple`	Tells dasel to put multiple items. See multiple.
`-s`, `--selector`, `<selector>`	Specify the selector to use. See selectors for more information. If no selector flag is given, dasel assumes the first argument given is the selector. This is required.
`-c`, `--compact`	This tells dasel to output compact data where possible. E.g. not pretty printing JSON.
`--merge-input-documents`	See merge input documents.