nushell-plugins/README.md

# Nushell plugins for Provisioning

A [Nushell](https://nushell.sh/) plugins collection for [Provisioning project](https://rlung.librecloud.online/jesus/provisioning)

>[!WARNING]
> This repo contains sub-repos, use git clone --recurse-submodules

```bash 
git clone --recurse-submodules [URL-to-clone-nushell-plugin]
```

> [!CAUTION]
> **nu_plugin_*** have dependencies to nushell source via local path in Cargo.toml
> Nushell and plugins require to be **sync** with same version 

## FILES (content layout)

<pre>
.
├── collect-install.sh      Script to collect all nu_plugin_* and install in /usr/local/bin
├── env                     Main value settings
├── distribution
│   ├── collect-install.sh          Script to build and collect nu_plugin_* 
│   ├── install_nu_plugins.nu  Nushell script to install nu_plugin_* 
│   ├── LICENSE
│   └── README.txt
├── generate                Template to generate plugins. Used with make_plugin.sh
│   └── nu_plugin_template
├── LICENSE
├── make_plugin.sh          To generate Nushell plugins. Used with generate path
├── nushell                 Nushell repo to be used as path for all nu_plugin_*
├── nu_plugin_clipboard
├── nu_plugin_desktop_notifications
├── nu_plugin_hashes
├── nu_plugin_highlight
├── nu_plugin_image
├── nu_plugin_port_extension
├── nu_plugin_qr_maker
├── nu_plugin_kcl           Repo for nu_plugin_kcl (repo sub-module)
├── nu_plugin_tera          Repo for nu_plugin_tera (repo sub-module)
├── api_nu_plugin_kcl       A try to use API KCL, nu_plugin_kcl is recommended option
└── README.md
</pre>

Main values can be changed in [env](env)
```bash
export TARGET_PATH=${TARGET_PATH:-distribution}
export INSTALL_FILE=${INSTALL_FILE:-install_nu_plugins.nu}
export INSTALL_BIN_PATH=${INSTALL_BIN_PATH:-/usr/local/bin}
```

## Build and Install

- Run [build-all.sh](build-all.sh)
```bash 
./build-all.sh
```
- Collect all target/release with [collect-install.sh](collect-install.sh), this will:
   - Run [distribution/collect-install.sh](distribution/collect-install.sh) to copy release binaries into [distribution](distribution) directory
   - Install [distribution](distribution) directory **nu_plugin_** into $INSTALL_BIN_PATH (**/usr/local/bin**)
   - Generatel [distribution](distribution) **nu_plugin_** install script in [install_nu_plugin.nu](distribution/install_nu_plugin.nu)
```bash 
./collect-install.sh
```
## Nushell install

Plugins have to be added from [Nushell](https://nushell.sh/) 

Use [install_nu_plugin.nu](distribution/install_nu_plugin.nu)
```
distribution/install_nu_plugin.nu
```

### TODO

- [ ] Use settings for **platforms-architectures targets**