nushell/crates
Devyn Cairns 7a888c9e9b
Change behavior of into record on lists to be more useful (#13637)
# Description

The previous behaviour of `into record` on lists was to create a new
record with each list index as the key. This was not very useful for
creating meaningful records, though, and most people would end up using
commands like `headers` or `transpose` to turn a list of keys and values
into a record.

This PR changes that instead to do what I think the most ergonomic thing
is, and instead:

- A list of records is merged into one record.
- A list of pairs (two element lists) is folded into a record with the
first element of each pair being the key, and the second being the
value.

The former is just generally more useful than having to use `reduce`
with `merge` for such a common operation, and the latter is useful
because it means that `$a | zip $b | into record` *just works* in the
way that seems most obvious.

Example:

```nushell
[[foo bar] [baz quux]] | into record # => {foo: bar, baz: quux}
[{foo: bar} {baz: quux}] | into record # => {foo: bar, baz: quux}
[foo baz] | zip [bar quux] | into record # => {foo: bar, baz: quux}
```

The support for range input has been removed, as it would no longer
reflect the treatment of an equivalent list.

The following is equivalent to the old behavior, in case that's desired:

```
0.. | zip [a b c] | into record # => {0: a, 1: b, 2: c}
```

# User-Facing Changes
- `into record` changed as described above (breaking)
- `into record` no longer supports range input (breaking)

# Tests + Formatting
Examples changed to match, everything works. Some usage in stdlib and
`nu_plugin_nu_example` had to be changed.

# After Submitting
- [ ] release notes (commands, breaking change)
2024-08-22 11:38:43 +02:00
..
nu_plugin_custom_values Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu_plugin_example Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu_plugin_formats Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu_plugin_gstat Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu_plugin_inc Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu_plugin_nu_example Change behavior of into record on lists to be more useful (#13637) 2024-08-22 11:38:43 +02:00
nu_plugin_polars Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu_plugin_python Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu_plugin_query Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu_plugin_stress_internals Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-cli Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-cmd-base Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-cmd-extra Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-cmd-lang Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-cmd-plugin Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-color-config Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-command Change behavior of into record on lists to be more useful (#13637) 2024-08-22 11:38:43 +02:00
nu-derive-value Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-engine Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-explore Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-glob Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-json Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-lsp Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-parser Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-path Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-plugin Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-plugin-core Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-plugin-engine Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-plugin-protocol Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-plugin-test-support Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-pretty-hex Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-protocol Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-std Change behavior of into record on lists to be more useful (#13637) 2024-08-22 11:38:43 +02:00
nu-system Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-table Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-term-grid Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-test-support Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nu-utils Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
nuon Bump version to 0.97.2 (#13666) 2024-08-22 11:36:32 +02:00
README.md Remove old nushell/merge engine-q 2022-02-07 14:54:06 -05:00

Nushell core libraries and plugins

These sub-crates form both the foundation for Nu and a set of plugins which extend Nu with additional functionality.

Foundational libraries are split into two kinds of crates:

  • Core crates - those crates that work together to build the Nushell language engine
  • Support crates - a set of crates that support the engine with additional features like JSON support, ANSI support, and more.

Plugins are likewise also split into two types:

  • Core plugins - plugins that provide part of the default experience of Nu, including access to the system properties, processes, and web-connectivity features.
  • Extra plugins - these plugins run a wide range of different capabilities like working with different file types, charting, viewing binary data, and more.