nushell/crates
Antoine Stevan bb30051006
add a "capture" example to str replace, before the fancy ones (#9447)
closes https://github.com/nushell/nushell/issues/9437
cc/ @Sygmei 😉 

# Description
the syntax of *captures* used in `str replace` can be confusing for
people not used to the `regex` syntax.
there is already a capture example in `help str replace`
```bash
  Find and replace with fancy-regex
  > 'a successful b' | str replace '\b([sS])uc(?:cs|s?)e(ed(?:ed|ing|s?)|ss(?:es|ful(?:ly)?|i(?:ons?|ve(?:ly)?)|ors?)?)\b' '${1}ucce$2'
  a successful b
```
but it's really not trivial to understand the *capture* syntax...

this PR adds a simpler example only focused on *captures*
🥳
```bash
  Use captures to manipulate the input text
  > "abc-def" | str replace "(.+)-(.+)" "${2}_${1}"
  def_abc
```

# User-Facing Changes
an example in `help str replace` to understand the syntax of *captures*.

# Tests + Formatting
- 🟢 `toolkit fmt`
- 🟢 `toolkit clippy`
-  `toolkit test`
-  `toolkit test stdlib`

# After Submitting
```
$nothing
```
2023-06-16 13:23:44 -05:00
..
nu_plugin_custom_values Bump to 0.81.1 as development version (#9379) 2023-06-07 15:06:42 +02:00
nu_plugin_example Bump to 0.81.1 as development version (#9379) 2023-06-07 15:06:42 +02:00
nu_plugin_formats update ini dependency (#9426) 2023-06-13 13:33:00 -05:00
nu_plugin_gstat Bump to 0.81.1 as development version (#9379) 2023-06-07 15:06:42 +02:00
nu_plugin_inc Bump to 0.81.1 as development version (#9379) 2023-06-07 15:06:42 +02:00
nu_plugin_python update nu_plugin_python due to signature changes (#8107) 2023-02-18 13:27:24 +00:00
nu_plugin_query Changes HashMap to use aHash instead, giving a performance boost. (#9391) 2023-06-10 11:41:58 -05:00
nu-cli Break up interdependencies of command crates (#9429) 2023-06-14 23:12:55 +02:00
nu-cmd-dataframe Break up interdependencies of command crates (#9429) 2023-06-14 23:12:55 +02:00
nu-cmd-extra Break up interdependencies of command crates (#9429) 2023-06-14 23:12:55 +02:00
nu-cmd-lang nu-cmd-lang readme (#9446) 2023-06-15 08:45:23 -07:00
nu-color-config Changes HashMap to use aHash instead, giving a performance boost. (#9391) 2023-06-10 11:41:58 -05:00
nu-command add a "capture" example to str replace, before the fancy ones (#9447) 2023-06-16 13:23:44 -05:00
nu-engine allow paths to have brackets (#9416) 2023-06-13 07:30:10 -05:00
nu-explore Move explore command out of nu-command deps (#9421) 2023-06-14 01:18:36 +02:00
nu-glob Bump to 0.81.1 as development version (#9379) 2023-06-07 15:06:42 +02:00
nu-json Bump to 0.81.1 as development version (#9379) 2023-06-07 15:06:42 +02:00
nu-parser allow comment in multiple line pipeline (#9436) 2023-06-15 13:11:42 +02:00
nu-path Bump to 0.81.1 as development version (#9379) 2023-06-07 15:06:42 +02:00
nu-plugin Plugin api docs (#9452) 2023-06-16 16:25:40 +02:00
nu-pretty-hex Bump to 0.81.1 as development version (#9379) 2023-06-07 15:06:42 +02:00
nu-protocol Plugin api docs (#9452) 2023-06-16 16:25:40 +02:00
nu-std Fix bug in std dirs drop; improve documentation (#9449) 2023-06-16 10:42:50 +02:00
nu-system Changes HashMap to use aHash instead, giving a performance boost. (#9391) 2023-06-10 11:41:58 -05:00
nu-table nu-table: Bump tabled to 0.12.1 (#9341) 2023-06-11 17:33:54 -05:00
nu-term-grid Bump to 0.81.1 as development version (#9379) 2023-06-07 15:06:42 +02:00
nu-test-support Bump to 0.81.1 as development version (#9379) 2023-06-07 15:06:42 +02:00
nu-utils Remove ZB and ZiB from file size type (#9427) 2023-06-14 10:53:32 -05: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.