d9ef2f0d5b
Some checks failed
Build and Test / Validate Setup (push) Has been cancelled
Build and Test / Build (darwin-amd64) (push) Has been cancelled
Build and Test / Build (darwin-arm64) (push) Has been cancelled
Build and Test / Build (linux-amd64) (push) Has been cancelled
Build and Test / Build (windows-amd64) (push) Has been cancelled
Build and Test / Build (linux-arm64) (push) Has been cancelled
Build and Test / Security Audit (push) Has been cancelled
Build and Test / Package Results (push) Has been cancelled
Build and Test / Quality Gate (push) Has been cancelled
Nightly Build / Check for Changes (push) Has been cancelled
Nightly Build / Validate Setup (push) Has been cancelled
Nightly Build / Nightly Build (darwin-amd64) (push) Has been cancelled
Nightly Build / Nightly Build (darwin-arm64) (push) Has been cancelled
Nightly Build / Nightly Build (linux-amd64) (push) Has been cancelled
Nightly Build / Nightly Build (windows-amd64) (push) Has been cancelled
Nightly Build / Nightly Build (linux-arm64) (push) Has been cancelled
Nightly Build / Create Nightly Pre-release (push) Has been cancelled
Nightly Build / Notify Build Status (push) Has been cancelled
Nightly Build / Nightly Maintenance (push) Has been cancelled
- Bump all 18 plugins from 0.110.0 to 0.111.0
- Update rust-toolchain.toml channel to 1.93.1 (nu 0.111.0 requires ≥1.91.1)
Fixes:
- interprocess pin =2.2.x → ^2.3.1 in nu_plugin_mcp, nu_plugin_nats, nu_plugin_typedialog
(required by nu-plugin-core 0.111.0)
- nu_plugin_typedialog: BackendType::Web initializer — add open_browser: false field
- nu_plugin_auth: implement missing user_info_to_value helper referenced in tests
Scripts:
- update_all_plugins.nu: fix [package].version update on minor bumps; add [dev-dependencies]
pass; add nu-plugin-test-support to managed crates
- download_nushell.nu: rustup override unset before rm -rf on nushell dir replace;
fix unclosed ) in string interpolation
1 line
11 KiB
Markdown
1 line
11 KiB
Markdown
# Nushell + Plugins Bootstrap Installers\n\nUniversal installers for Nushell and plugins that work without any prerequisites. These scripts solve the bootstrap problem by providing one-command installation that works on fresh systems.\n\n## Quick Start\n\n### Linux/macOS (POSIX Shell)\n\n```bash\ncurl -L https://your-url/install.sh | sh\n```\n\n### Windows (PowerShell)\n\n```powershell\nInvoke-WebRequest -Uri "https://your-url/install.ps1" | Invoke-Expression\n```\n\n## Features\n\n- **Zero Prerequisites**: Works on fresh systems without Rust, Git, or other dependencies\n- **Multi-Platform**: Supports Linux, macOS, and Windows (x86_64, ARM64)\n- **Complete Distribution**: Installs Nushell + all workspace and custom plugins\n- **Automatic Configuration**: Sets up PATH, creates default config, registers plugins\n- **Installation Modes**: User (~/.local/bin) or system (/usr/local/bin) installation\n- **Build Options**: Pre-built binaries or build from source\n- **Verification**: Optional installation verification and testing\n- **Uninstallation**: Clean removal of all installed components\n\n## Installation Options\n\n### Basic Installation\n\nDefault installation to user directory with all plugins:\n\n```bash\n# Linux/macOS\ncurl -L install-url/install.sh | sh\n\n# Windows\niwr install-url/install.ps1 | iex\n```\n\n### System Installation\n\nInstall to system directories (requires admin privileges):\n\n```bash\n# Linux/macOS (requires sudo)\ncurl -L install-url/install.sh | sudo sh -s -- --system\n\n# Windows (requires admin PowerShell)\niwr install-url/install.ps1 | iex -ArgumentList "-System"\n```\n\n### Build from Source\n\nBuild Nushell and plugins from source code:\n\n```bash\n# Linux/macOS\ncurl -L install-url/install.sh | sh -s -- --build-from-source\n\n# Windows\niwr install-url/install.ps1 | iex -ArgumentList "-BuildFromSource"\n```\n\n### Minimal Installation\n\nInstall only Nushell without plugins:\n\n```bash\n# Linux/macOS\ncurl -L install-url/install.sh | sh -s -- --no-plugins\n\n# Windows\niwr install-url/install.ps1 | iex -ArgumentList "-NoPlugins"\n```\n\n## Command Line Options\n\n### Linux/macOS (install.sh)\n\n| Option | Description |\n|--------|-------------|\n| `--system` | Install to system directory (/usr/local/bin, requires sudo) |\n| `--user` | Install to user directory (~/.local/bin) [default] |\n| `--no-path` | Don't modify shell PATH configuration |\n| `--no-config` | Don't create initial nushell configuration |\n| `--no-plugins` | Install only nushell, skip plugins |\n| `--build-from-source` | Build from source instead of downloading binaries |\n| `--verify` | Verify installation after completion |\n| `--uninstall` | Remove nushell and plugins |\n| `--version VERSION` | Install specific version (default: latest) |\n| `--help` | Show help message |\n\n### Windows (install.ps1)\n\n| Parameter | Description |\n|-----------|-------------|\n| `-System` | Install to system directory (C:\Program Files\Nushell, requires admin) |\n| `-User` | Install to user directory (~\.local\bin) [default] |\n| `-NoPath` | Don't modify PATH environment variable |\n| `-NoConfig` | Don't create initial nushell configuration |\n| `-NoPlugins` | Install only nushell, skip plugins |\n| `-BuildFromSource` | Build from source instead of downloading binaries |\n| `-Verify` | Verify installation after completion |\n| `-Uninstall` | Remove nushell and plugins |\n| `-Version <version>` | Install specific version (default: latest) |\n| `-Help` | Show help message |\n\n## Installation Locations\n\n### User Installation (Default)\n\n- **Linux/macOS**: `~/.local/bin`\n- **Windows**: `%USERPROFILE%\.local\bin`\n- No admin privileges required\n- Affects only current user\n\n### System Installation\n\n- **Linux/macOS**: `/usr/local/bin`\n- **Windows**: `C:\Program Files\Nushell\bin`\n- Requires admin privileges\n- Available to all users\n\n### Configuration Directory\n\n- **Linux/macOS**: `~/.config/nushell`\n- **Windows**: `%USERPROFILE%\.config\nushell`\n\n## What Gets Installed\n\n### Core Components\n\n- **nushell binary**: Main shell executable\n- **Workspace plugins**: Built-in nushell plugins\n - `nu_plugin_custom_values`\n - `nu_plugin_example`\n - `nu_plugin_formats`\n - `nu_plugin_gstat`\n - `nu_plugin_inc`\n - `nu_plugin_polars`\n - `nu_plugin_query`\n - `nu_plugin_stress_internals`\n- **Custom plugins**: Additional community plugins\n - `nu_plugin_clipboard`\n - `nu_plugin_desktop_notifications`\n - `nu_plugin_hashes`\n - `nu_plugin_highlight`\n - `nu_plugin_image`\n - `nu_plugin_kcl`\n - `nu_plugin_tera`\n - And more...\n\n### Configuration Files\n\n- `config.nu`: Main nushell configuration\n- `env.nu`: Environment configuration\n- Scripts directory for custom commands\n- Plugins directory for plugin configurations\n\n### PATH Integration\n\nAutomatically updates shell configuration files:\n\n- **Bash**: `~/.bashrc`, `~/.bash_profile`\n- **Zsh**: `~/.zshrc`\n- **Fish**: `~/.config/fish/config.fish`\n- **Nushell**: `~/.config/nushell/env.nu`\n- **Generic**: `~/.profile`\n- **Windows**: System/User PATH environment variable\n\n## Examples\n\n### Standard Installation with Verification\n\n```bash\n# Linux/macOS\ncurl -L install-url/install.sh | sh -s -- --verify\n\n# Windows\niwr install-url/install.ps1 | iex -ArgumentList "-Verify"\n```\n\n### Corporate/Enterprise Installation\n\n```bash\n# System installation without auto-config\ncurl -L install-url/install.sh | sudo sh -s -- --system --no-config\n\n# Windows system installation\n# Run as Administrator:\niwr install-url/install.ps1 | iex -ArgumentList "-System", "-NoConfig"\n```\n\n### Development Installation\n\n```bash\n# Build from source with verification\ncurl -L install-url/install.sh | sh -s -- --build-from-source --verify\n\n# Windows development\niwr install-url/install.ps1 | iex -ArgumentList "-BuildFromSource", "-Verify"\n```\n\n### Specific Version Installation\n\n```bash\n# Install specific version\ncurl -L install-url/install.sh | sh -s -- --version v0.107.1\n\n# Windows specific version\niwr install-url/install.ps1 | iex -ArgumentList "-Version", "v0.107.1"\n```\n\n## Troubleshooting\n\n### Common Issues\n\n#### "Command not found" after installation\n\n- Restart your terminal/command prompt\n- Or reload shell configuration: `source ~/.bashrc` (Linux/macOS)\n- Check if installation directory is in PATH\n\n#### Permission denied errors\n\n- For system installation, ensure you have admin privileges\n- Use `sudo` on Linux/macOS or run PowerShell as Administrator on Windows\n- Try user installation instead: `--user` or `-User`\n\n#### Download failures\n\n- Check internet connection\n- Try building from source: `--build-from-source` or `-BuildFromSource`\n- Manual download: Save installer script and run locally\n\n#### Plugin registration failures\n\n- Verify nushell binary works: `nu --version`\n- Try manual plugin registration: `nu -c "plugin add /path/to/plugin"`\n- Check plugin binary permissions (should be executable)\n\n### Build from Source Issues\n\n#### Missing dependencies\n\nInstall required tools:\n\n**Linux (Ubuntu/Debian)**:\n\n```bash\nsudo apt update\nsudo apt install git curl build-essential\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n```\n\n**Linux (RHEL/CentOS/Fedora)**:\n\n```bash\nsudo dnf install git curl gcc\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n```\n\n**macOS**:\n\n```bash\n# Install Xcode command line tools\nxcode-select --install\n\n# Install Rust\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n```\n\n**Windows**:\n\n1. Install Git from <https://git-scm.com/>\n2. Install Rust from <https://rustup.rs/>\n3. Install Visual Studio Build Tools\n\n### Verification Steps\n\nTest your installation:\n\n```bash\n# Check nushell version\nnu --version\n\n# Test basic functionality\nnu -c "echo 'Hello from Nushell'"\n\n# List installed plugins\nnu -c "plugin list"\n\n# Check PATH\nwhich nu # Linux/macOS\nwhere nu # Windows\n```\n\n## Uninstallation\n\n### Complete Removal\n\n```bash\n# Linux/macOS\ncurl -L install-url/install.sh | sh -s -- --uninstall\n\n# Windows\niwr install-url/install.ps1 | iex -ArgumentList "-Uninstall"\n```\n\n### Manual Removal\n\n1. Remove binaries from installation directory\n2. Remove configuration directory (optional)\n3. Remove PATH entries from shell configuration files\n4. Remove environment variable modifications (Windows)\n\n## Security Considerations\n\n### Script Verification\n\nBefore running any installer, you should:\n\n1. Review the script source code\n2. Verify the download URL and SSL certificate\n3. Check script signatures if available\n4. Consider downloading and running locally instead of piping\n\n### Permissions\n\n- User installations don't require admin privileges\n- System installations require elevated privileges\n- Scripts only modify necessary files and directories\n- No automatic execution of arbitrary code from external sources\n\n### Network Security\n\n- Scripts use HTTPS for all downloads\n- Verify SSL certificates before downloading\n- Consider using corporate proxies or mirrors\n- Firewall may need to allow downloads from GitHub/your hosting\n\n## Distribution Details\n\n### Binary Packages\n\nPre-built binaries are available for:\n\n- Linux x86_64 (GNU libc)\n- Linux aarch64 (GNU libc)\n- macOS x86_64 (Intel)\n- macOS arm64 (Apple Silicon)\n- Windows x86_64\n- Windows aarch64\n\n### Package Structure\n\n```plaintext\nnushell-plugins-{platform}-{version}.tar.gz/\n├── nu(.exe) # Main nushell binary\n├── nu_plugin_*(.exe) # Plugin binaries\n├── config/ # Default configuration\n│ ├── config.nu\n│ └── env.nu\n├── scripts/ # Installation scripts\n├── docs/ # Documentation\n├── LICENSE # License file\n└── manifest.json # Package manifest\n```\n\n## Contributing\n\n### Testing Installers\n\nTest the installers on various platforms:\n\n1. Fresh VM or container\n2. Different operating system versions\n3. Various shell configurations\n4. With and without prerequisites\n\n### Reporting Issues\n\nWhen reporting problems, include:\n\n- Operating system and version\n- Shell type and version\n- Installation command used\n- Complete error messages\n- Network/firewall configuration\n\n### Improvements\n\nAreas for enhancement:\n\n- Additional platform support\n- Mirror/CDN support for faster downloads\n- Package manager integration\n- Corporate deployment features\n- Automated testing workflows\n\n## License\n\nThese bootstrap installers are part of the nushell-plugins project and are licensed under the same terms. See the main project LICENSE file for details.\n\n## Support\n\n- **Documentation**: <https://nushell.sh>\n- **Community**: <https://discord.gg/nushell>\n- **Issues**: <https://github.com/your-org/nushell-plugins/issues>\n- **Discussions**: <https://github.com/your-org/nushell-plugins/discussions>\n\n---\n\n**Happy shell scripting with Nushell! 🚀** |