jesus/nushell-plugins
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
nushell-plugins/UPDATE.md
Jesús Pérez be62c8701a feat: Add ARGUMENTS documentation and interactive update mode 
- Add `show-arguments` recipe documenting all version update commands
- Add `complete-update-interactive` recipe for manual confirmations
- Maintain `complete-update` as automatic mode (no prompts)
- Update `update-help` to reference new recipes and modes
- Document 7-step workflow and step-by-step differences

Changes:
- complete-update: Automatic mode (recommended for CI/CD)
- complete-update-interactive: Interactive mode (with confirmations)
- show-arguments: Complete documentation of all commands and modes
- Both modes share same 7-step workflow with different behavior in Step 4
2025-10-19 00:05:16 +01:00

2.9 KiB
Raw Blame History

Nushell 0.108.0 Update - Complete Guide

Quick Start (Recommended)

Run the update in 7 simple steps:

# Step 1: Download Nushell source
./scripts/download_nushell.nu 0.108.0

# Step 2: Build Nushell with all features
cd nushell
cargo build --release --workspace --features "mcp,plugin,sqlite,trash-support,system-clipboard,rustls-tls"
cd ..

# Step 3: Update plugin versions
./scripts/update_all_plugins.nu 0.108.0

# Step 4: Build all plugins
just build

# Step 5: Create distributions
./scripts/create_full_distribution.nu

# Step 6: Validate everything
./scripts/update_all_plugins.nu check
just validate-code

# Step 7: Commit changes
git add -A
git commit -m "chore: update to Nushell 0.108.0"

Using Justfile Commands (Individual Steps)

If you prefer using justfile for individual operations:

# Download source
just download-source 0.108.0

# Analyze available features
just analyze-features

# Build Nushell
just build-nu

# Update plugins
just update-plugins 0.108.0

# Build plugins
just build

# Create distributions
just create-distribution

# Check versions
just check-versions

# Status
just update-status

Full Command Reference

Download & Build

  • just download-source 0.108.0 - Download from GitHub
  • just download-latest - Download latest version
  • just build-nu - Build Nushell binary

Plugin Management

  • just update-plugins 0.108.0 - Update plugin versions
  • just sync-plugins - Auto-sync to submodule
  • just check-versions - Check consistency

Distribution

  • just create-distribution - Create packages (current platform)
  • just create-distribution-all - Create all platform packages
  • just create-bin-archives - Create plugin-only archives
  • just rebuild-all - Rebuild everything fresh

Analysis & Validation

  • just analyze-features - Analyze Nushell features
  • just audit-versions - Check dependency versions
  • just detect-breaking - Find breaking changes
  • just validate-code - Validate against binary

Help

  • just update-help - Quick reference
  • just update-docs - Documentation paths

Documentation

  • Quick Start: guides/QUICK_START.md
  • Complete Guide: guides/COMPLETE_VERSION_UPDATE_GUIDE.md
  • Version Info: updates/108/NUSHELL_0.108_UPDATE_SUMMARY.md
  • Migration Guide: updates/108/MIGRATION_0.108.0.md
  • Automation Details: updates/108/NUSHELL_UPDATE_AUTOMATION.md

Status

✅ All automation scripts created and tested ✅ Justfile integration complete (28 recipes) ✅ Nushell 0.108.0 successfully built ✅ Documentation comprehensive ✅ Ready for production use

Notes

  • Nushell 0.108.0 includes MCP (Model Context Protocol) support
  • All system plugins built: formats, inc, gstat, query, polars, custom_values, example, stress_internals
  • Build time: ~3 minutes on recent hardware
  • Updates are resource-intensive; run steps individually for best stability