nushell/crates/nu_plugin_example/README.md
Andy Gayton b27cd70fd1
remove the deprecated register command (#13297)
# Description

This PR removes the `register` command which has been
[deprecated](https://www.nushell.sh/blog/2024-04-30-nushell_0_93_0.html#register-toc)
in favor of [`plugin
add`](https://www.nushell.sh/blog/2024-04-30-nushell_0_93_0.html#redesigned-plugin-management-commands-toc)

# User-Facing Changes

`register` is no longer available
2024-07-05 07:16:50 -05:00

36 lines
742 B
Markdown

# Plugin Example
Crate with a simple example of the Plugin trait that needs to be implemented
in order to create a binary that can be registered into nushell declaration list
## `example config`
This subcommand demonstrates sending configuration from the nushell `$env.config` to a plugin.
To make use of the plugin after building `nushell` run:
```nushell
plugin add target/debug/nu_plugin_example
# or then either restart your current nushell session or run:
plugin use target/debug/nu_plugin_example
```
The configuration for the plugin lives in `$env.config.plugins.example`:
```nushell
$env.config = {
plugins: {
example: [
some
values
]
}
}
```
To list plugin values run:
```nushell
example config
```