Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

introduce a fully featured version manager #230

Draft
wants to merge 29 commits into
base: master
Choose a base branch
from

Conversation

Techatrix
Copy link
Collaborator

Installing Zig or ZLS with the extension doesn't properly handle switching between different Zig project.
You have to manually figure out which version to get and install it every time your switch to a project that requires a different Zig version. Same goes for ZLS. The vscode configuration for Zig also can't handle switching between devices (see #111)
Let's stop giving developer the ability to misconfigure their editor.

  1. No initial setup for Zig
  2. initial setup for ZLS is only 'yes' or 'no'
  3. Done!

Version Manager

This is how the extension selects which version of Zig to install:

  • set the zig.version config option (can be global or per-workspace)
  • manually set the version through the 'Select and Install' popup (per-workspace)
  • set the minimum_zig_version in build.zig of your workspace
  • add a .zigversion to your workspace which stores the desired Zig version

If none of the above apply, the latest tagged release of Zig is installed.
Installs are automatically uninstalled to not fill up disk storage too much.
Installs are verified with minisign
The version of ZLS is inferred from the Zig version.

Status Bar

Hovering over the "Editor Language Status" will show whether Zig and ZLS are installed + their versions. The Status Bar Item for Zig will turn red if is not installed. Clicking on it will open the 'Select and Install' popup.

Screenshot from 2024-09-07 21-23-59

Updated 'Select and Install' popup

  • added an option to manually specify the path to Zig
  • display the exact version of nightly
  • display which versions are already installed on the host machine
  • if no network connection is available, only versions that are already installed are displayed

Screenshot from 2024-09-07 21-24-26

Remaining issues

  • The version lookup for nightly builds that are specified through the build.zig.zon is not working properly. see this TODO.
    • This is the main blocker for this PR. I still need to figure out how to solve it.
  • The zig.checkForUpdate config option and update command have been removed. It should be added back but with some adjustments.
  • add some documentation around these new features so that users know how to use them

I wanted to keep these changes as small as possible but I couldn't stop myself. 😞
Any feedback would be greatly appreciated.

These changes make ZLS an "invisible" component of the extension after the initial setup.

This also removes the `zig.zls.checkForUpdate` command. I am not sure if it even needs to be brought back. I've made sure that no error is reported if no internet connection is available. The last installed ZLS version should be reused.

closes #136 because `zig.zls.startRestart` will just enable ZLS instead of complaining
See the TODOs on what needs to be added to the VersionManager

fixes #111
This commit replaces the initial setup with the following mechanism:
1. If the workspace contains a `.zigversion`, install the given Zig version.
2. If the workspace contains a `build.zig.zon` with a `minimum_zig_version`, install the next available Zig version.
3. Check if the "Install Zig" has been previously executed in the active workspace. If so, install that version.
3. Otherwise fallback to the latest tagged release of Zig.

Some parts of this are not fully implemented.

fixes #111
The version in `minimum_zig_version` may not be available. We need to find the "closest satisfactory" Zig version that is provided by zigtools.org.

This is not yet implemented.
This also disallows overriding the `zig.path` and `zig.zls.path` in a workspace. A workspace should never contain setting that are not transferable across different machines.
Also fixes the "`zig.path` should be unset here right?" TODO.
This makes it usable without an internet connection.
This unfortunately has a large relative impact on the bundle size: 600kb -> 1.3mb
The version is still being checked if `zig.path` is set. This means that the extension is not usable with these old versions.
@Techatrix
Copy link
Collaborator Author

@Vexu Any thoughts on these changes?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant