@weezy20/zv 0.3.1 → 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog 
+
+## v0.4.0 → v0.5.0
+## ✨ Features
+- **`zv install`**: Install without setting a zig version as active.
+- Uses same flags as `zv use` i.e. `-f` to force using ziglang.org as a download source.
+- Shorthand: **`zv i <version>`** installs the specified version without setting it as active.
+- Can also install multiple versions which are comma separated list: `zv i 0.11,master,stable,latest`
+- De-duplication for zigversions is handled internally so if you specify `zv i latest,stable` then it only installs one version, provided cached index stable == remote index stable which is true for 99.99% of the time.
+
+## v0.3.1 → v0.4.0
+
+## ✨ Features
+
+- **`zv init`**: Added `build.zig.zon` generation via `-p/--package/--zon` flag (#17)
+- **`zv init`**: Generate `.zigversion` file to specify minimum Zig version for builds
+- **Self-update**: Refactored using `self-replace` dependency with SHA256 verification for downloaded github assets (#21). This also removes a ton of dependencies.
+- **Self-update**: Added `upgrade` as alias for `update` command
+- **Self-update**: Added `--rc` flag to include pre-release versions when checking for updates
+
+## Bug Fixes
+
+- Fixed phantom active Zig display when no version was set (zv)
+- Fixed toolchain manager fallback for mismatches between version scan and `active.json`
+- Improved auto-switching logic when cleaning/removing installations
+- Fixed ZIP extraction path issues in update mechanism
+
+## Others
+
+- Deduplicated shim generation logic, Added quiet flag to supress output during automatic shim regeneration
+- Target triple detection now at compile time
+- Better async handling (replaced blocking calls with `await`)
+- Updated documentation and Homebrew tap configuration
+
+---

package/README.md

@@ -34,15 +34,29 @@ Windows (PowerShell):
 ```powershell
 irm https://github.com/weezy20/zv/releases/latest/download/zv-installer.ps1 | iex
 ```
+If you encounter an execution policy error, you can temporarily allow script execution by running:
+```powershell
+powershell -ExecutionPolicy Bypass -Command "irm https://github.com/weezy20/zv/releases/latest/download/zv-installer.ps1 | iex"
+```
+
+>The following methods use different package managers hence, after running `zv setup` we uninstall the package manager version of `zv` to avoid confusion. Since `zv` can self update for popular OS/Arch combinations, you don't need to rely on package managers for updates.
 
 **HomeBrew:**
 ```sh
 brew install weezy20/tap/zv
+# Run zv setup to self-install
+zv setup
+# Remove brew installation
+brew uninstall zv
 ```
 
 **NPM:**
 ```sh
 npm install -g @weezy20/zv
+# Run zv setup to self-install
+zv setup
+# Remove npm installation
+npm uninstall -g @weezy20/zv
 ```
 
 <details>
@@ -114,7 +128,7 @@ From now on, use the `zv` installed in `ZV_DIR/bin`.
 
 **Simple update (Recommended):**
 ```sh
-zv update
+zv update # Installs latest stable release on supported targets*.
 ```
 
 This command checks for new releases on GitHub and updates `zv` in place. It works whether you're running from `ZV_DIR/bin/zv` or from an external location (like cargo install). 
@@ -122,6 +136,8 @@ This command checks for new releases on GitHub and updates `zv` in place. It wor
 **Options:**
 ```sh
 zv update --force  # Force reinstall even if already on the latest version
+zv upgrade         # Alias for update
+zv update --rc     # Update to latest pre-release (release candidate) version
 ```
 
 
@@ -158,7 +174,12 @@ You can customize this by setting the `ZV_DIR` environment variable.
 zv init [project_name]                 # Create a new Zig project with a name
 zv init                                # Create a new Zig project in the current working directory
 zv init --zig | -z                     # Create a new Zig project using the standard template provided by `zig init`
+# Create a zig project with build.zig.zon:
+zv init -p | --zon | --package  <?name>      # Create a zig project in current directory with build.zig.zon or with name if provided
+# Note: this requires an active zig version >= 0.12.0 where build.zig.zon support was introduced
+
 ```
+>Note: `zv init` will use the `build.zig` that's present in [templates/build.zig](templates/lean_build.zig) which is checked to work against minimum zig version specified in [templates/.zigversion](templates/.zigversion). If you want to use a different zig version, set it as active zig and use `zv init -z` or `zig init` directly.
 
 ## Use `zv` as your Zig compiler toolchain manager:
 
@@ -171,6 +192,8 @@ zv use 0.14 -f                              # Use a version (auto-completes to 0
 zv use master                               # Use master branch build (queries network to find the latest master build)
 zv use stable                               # Use latest stable release (refers to cached index)
 zv use latest                               # Use latest stable release (queries network to fetch the latest stable)
+zv install <version,*> [-f ]                # Install one or more Zig versions without switching to it. Use -f to download from ziglang.org instead of community mirrors.
+zv i 0.15.1,0.14.0,master                   # Install multiple versions at once using a comma-separated list
 
 # Per-project Zig config
 zig +<version> [...zig args]            # Run Zig using a specific <version> (fetches and downloads version if not present locally)
@@ -187,7 +210,7 @@ zv rm master                           # Clean up the `master` branch toolchain.
 zv rm master --outdated                # Clean up any older master versions in the master folder that don't match latest `master`
 zv setup                               # Set up shell environment for zv with interactive prompts (use --no-interactive for automation)
 zv sync                                # Resync community mirrors list from [ziglang.org/download/community-mirrors.txt]; also force resync of index to fetch latest nightly builds. Replaces `ZV_DIR/bin/zv` if outdated against current invocation.
-zv update                              # Update zv to the latest release only if present in GH Releases: https://github.com/weezy20/zv/releases
+zv upgrade | update                    # Update zv to the latest release only if present in GH Releases: https://github.com/weezy20/zv/releases
 zv help                                # Detailed instructions for zv. Use `--help` for long help or `-h` for short help with a subcommand.
 ```
 
@@ -209,6 +232,7 @@ I hope you enjoy using it! ♥
 | **`ZV_DIR`**              | Defines the home directory for `zv`.                                                                                       | Default `$HOME/.zv` for linux/macos or unix. For windows it usually will be `%USERPROFILE%/.zv`                                      |
 | **`ZV_INDEX_TTL_DAYS`**   | Number of days between automatic [index](https://ziglang.org/download/index.json) syncs.                                   | **21 days** — Using `master` or `latest` in inline mode use a shorter cache duration of just 1 day unlike `use` which will always fetch `master` & `latest` from network, so practically, you never have to worry about setting this variable yourself. |
 | **`ZV_MIRRORS_TTL_DAYS`** | Number of days before refreshing the mirrors list. Broken mirrors degrade automatically. Use `zv sync` to force refresh. | **21 days** — mirrors and index can be resynced immediately with `zv sync`. `master` relies on latest builds & so does `latest` and some community mirrors may not have it available; `zv` will retry other mirrors in that case.      |
+| **`ZV_MAX_RETRIES`**      | Maximum number of retry attempts for downloads when a download fails.                                                      | **3 retries** — If a download fails, `zv` will retry up to this many times before giving up.                                                   |
 | **`NO_COLOR`**            | If set, disables color output in all zv commands.                                                                          | No color output; useful for non-TTY environments or scripts.                    |
 |**`ZV_FETCH_TIMEOUT_SECS`**   | Request timeout to use for network operations requiring fetching index/mirrors list from `ziglang.org`.                | Default 15 seconds for most operations.
 

package/npm-shrinkwrap.json

@@ -23,7 +23,7 @@
       "hasInstallScript": true,
       "license": "MIT",
       "name": "@weezy20/zv",
-      "version": "0.3.1"
+      "version": "0.5.0"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -896,5 +896,5 @@
     }
   },
   "requires": true,
-  "version": "0.3.1"
+  "version": "0.5.0"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/weezy20/zv/releases/download/v0.3.1",
+  "artifactDownloadUrl": "https://github.com/weezy20/zv/releases/download/v0.5.0",
   "author": "Abhishek Shah <abhishekshah3@gmail.com>",
   "bin": {
     "zv": "run-zv.js"
@@ -105,7 +105,7 @@
       "zipExt": ".tar.gz"
     }
   },
-  "version": "0.3.1",
+  "version": "0.5.0",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"