repository·master·Indexed 27 days ago
https://github.com/tomwright/daselDasel (Data-Select) is a command-line tool and library for querying, modifying, and transforming data across multiple formats, including JSON, YAML, TOML, XML, CSV, HCL, INI, and KDL, using a unified syntax. It provides a CLI for data extraction and conversion, as well as a Go library featuring the execution and model packages for programmatic data manipulation via Select(), Query(), and Modify() functions.
execution package allows you to perform data extraction by taking a model.Value, parsing a selector string into an Abstract Syntax Tree (AST), and then executing that AST against the provided value.You can install Dasel using Homebrew, Go, or by downloading prebuilt binaries.
brew install daselgo install github.com/tomwright/dasel/v3/cmd/dasel@masterPrebuilt binaries for Linux, macOS, and Windows are available on the GitHub Releases page.
brew install daselDasel supports tab-completion for Bash, Zsh, Fish, and PowerShell. Use the following commands to generate and load the completion scripts for your current session.
# Bash
source <(dasel completion bash)
# Zsh
source <(dasel completion zsh)
# Fish
dasel completion fish | source
# PowerShell
dasel completion powershell | Out-String | Invoke-ExpressionYou can update, insert, or delete values using the assignment syntax within a selector.
To output only the modified value, use the standard selection syntax. To output the entire document after modification, include the --root flag.
Dasel can transform data from one format to another. Specify the input format with -i and the desired output format with -o.
cat data.json | dasel -i json -o yamlDasel provides advanced selectors for traversing and finding data:
..): Searches all nested objects and arrays for a matching key or index.search): Finds all values matching a specific condition anywhere in the structure.# Recursive descent to find all 'bar' keys
echo '{"foo": {"bar": "baz"}}' | dasel -i json '..bar'
# Search for values where 'bar' equals 'baz'
echo '{"foo": {"bar": "baz"}}' | dasel -i json 'search(bar == "baz")'By default, Dasel evaluates the provided selector and prints the result. Use the -i flag followed by the input format (e.g., json) and the selector string.
echo '{"foo": {"bar": "baz"}}' | dasel -i json 'foo.bar'
# Output: "baz"model.Value struct is a wrapper around reflect.Value that provides additional logic to simplify working with data values within the application.default_format for operations. If no configuration file is found, Dasel defaults to using json as the format.You can generate and view the man page directly from the CLI.
dasel man | man -l -Query to execute a selector against a data structure and receive the results as a slice of *model.Value pointers. This is useful when you need to inspect the metadata or specific types of the selected values using the model package.Select to execute a selector and get the results converted into native Go types (e.g., string, int, map[string]any, []any). The function returns a slice of any containing the results and the count of items found. Note that ordering within maps is not guaranteed.