@weezy20/zv 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog 
+
+## 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>
@@ -158,7 +172,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:
 
@@ -209,6 +228,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.4.0"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -896,5 +896,5 @@
     }
   },
   "requires": true,
-  "version": "0.3.1"
+  "version": "0.4.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.4.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.4.0",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"