mason/lua/mason-core/installer, branch stable

fix(nuget): also support .cmd shims on Windows (#2102)

2026-05-30T13:58:21Z

refactor(fs): use fs.ls in readdir implementation, prefer fs_stat over fs_fstat (#2101)

2026-05-30T13:57:13Z

refactor(fs): implement mkdirp natively via libuv (#2100)

2026-05-30T13:52:15Z

fix(fs): implement rmrf natively via libuv (#2098)

2026-05-30T13:34:55Z

feat: add support for socket.dev firewall client (#2088)

2026-05-22T18:14:45Z

feat: add the infrastructure to support "system" packages (#2085)

2026-05-14T15:21:42Z

This enables `mason.nvim` to start managing certain packages that: 1) are not suitable for the core registry 2) should not surface in existing APIs and UIs

fix(pypi): add python 3.13 and 3.14 to list of fallbacks (#2081)

2026-05-07T17:31:01Z

fix(powershell): conform to single quotes (#1740)

2026-04-21T14:30:49Z

Co-authored-by: William Boman

feat(npm): add `install_args` setting (#1581)

2026-04-21T13:26:46Z

Co-authored-by: William Boman

fix: actually emit the receipt in uninstall event payloads (#2071)

2026-04-06T18:08:26Z

feat: add support for removal of packages from a registry (#2052)

2026-01-07T14:46:58Z

This adds support for removal of packages from any given registry. Currently mason.nvim doesn't support this at all and throws an error when trying to interact with the registry in any way while having a removed package installed locally. This ensures that removed packages are available both in the `:Mason` UI as well as the public Lua APIs. These "synthesized" packages only supports uninstallation, and metadata such as licenses, categories, homepage, etc is not available.

fix(installer): update cwd after uv_fs_rename() was successful (#2033)

2025-11-14T03:20:19Z

Also moves to fs.sync calls over fs.async to avoid unnecessary async coroutine overhead.

fix(installer): attempt to recover from known fs error while finalizing installation on some file systems (#1933)

2025-11-14T02:50:44Z

Co-authored-by: William Boman

feat(compiler): make `supported_platforms` a universal source field (#2002)

2025-08-07T04:52:03Z

Previously this field had to be handled separately in each source type. This backwards-compatible change makes `supported_platforms` a universal top-level field on the `source:` object, meaning it'll be parsed for each source type.

fix(process): close check handles (#1995)

2025-07-28T15:27:36Z

fix(pypi): pass --no-user flag (#1958)

2025-05-19T04:08:48Z

Fixes #1937.

feat: associate package instances with registry source and record it in receipt

2025-05-06T00:57:26Z

refactor(command): use callback in Package:install() when running :MasonInstall in headless mode

2025-03-03T17:19:20Z

fix(uninstaller): only unlink if recipt is found

2025-03-03T15:10:28Z

refactor(registry): refactor registry initialization

2025-03-03T01:17:02Z

style: fix stylua and selene errors

2025-02-20T22:50:27Z

feat(context): add ctx:await()

2025-02-19T11:15:49Z

refactor: turn StdioSink into a proper class

2025-02-19T11:15:49Z

feat(context): add ctx:fetch()

2025-02-19T11:15:49Z

fix(expr): also interpolate table keys

2025-02-19T11:15:49Z

refactor!: change Package API

2025-02-19T11:15:48Z

This changes the following public APIs: **(_breaking_) Events on the `Package` class** The `uninstall:success` event on the `Package` class now receives an `InstallReceipt` as argument, instead of an `InstallHandle`. This receipt is an in-memory representation of what was uninstalled. There's also a new `uninstall:failed` event for situations where uninstallation for some reason fails. Note: this also applies to the registry events (i.e. `package:uninstall:success` and `package:uninstall:failed`). --- **(_breaking_) `Package:uninstall()` is now asynchronous and receives two new arguments, similarly to `Package:install()`** While package uninstallations remain synchronous under the hood, the public API has been changed from synchronous -> asynchronous. Users of this method are recommended to provide a callback in situations where code needs to execute after uninstallation fully completes. --- **(_breaking_) `Package:get_install_path()` has been removed. --- **`Package:install()` now takes an optional callback** This callback allows consumers to be informed whether installation was successful or not without having to go through a different, low-level, API. See below for a comparison between the old and new APIs: ```lua -- before local handle = pkg:install() handle:once("closed", function () -- ... end) -- after pkg:install({}, function (success, result) -- ... end) ```

fix(pypi): remove -U flag and fix log message

2025-02-19T08:23:19Z

refactor: standardize constructors and improve inheritance construction

2025-02-19T08:23:19Z

fix(location): use correct registry path

2025-02-19T08:23:19Z

feat(linker): use relative targets for symlinks (#1525)

2025-02-19T08:23:19Z

Closes #1156.

refactor(path): use InstallLocation to produce paths, remove static path methods

2025-02-19T08:23:19Z

refactor(installer): move initializations to InstallContext constructor

2025-02-19T08:23:19Z

refactor: add InstallLocation.global()

2025-02-19T08:23:19Z

chore: remove todo comment

2025-02-19T08:23:19Z

Using sync is actually preferable here (and likely in many other places) to avoid async context & continuation overhead.

chore(compilers): remove default environment from github build compiler

2025-02-19T08:23:19Z

refactor!: refactor installer internals and add new Package class methods (#1523)

2025-02-19T08:22:40Z

This contains the following changes: 1) `Package:install()` now accepts a second, optional, callback argument which is called when installation finishes (successfully or not). 2) Adds a `Package:is_installing()` method. This contains the following breaking changes: 1) `Package:install()` will now error when called while an installation is already ongoing. Use the new `Package:is_installing()` method to check whether an installation is already running. This also refactors large portions of the tests by removing test globals, removing async_test, and adding the `mason-test` Lua module instead. Test helpers via globals are problematic to work with due to not being detected through tools like the Lua language server without additional configuration. This has been replaced with a Lua module `mason-test`. `async_test` has also been removed in favour of explicitly making use of the `mason-core.async` API. These changes stands for a significant portion of the diff.

refactor(receipt): change receipt structure and remove old builder APIs (#1521)

2025-02-16T08:49:17Z

fix(installer): schedule back to main loop before executing installer functions (#1516)

2025-02-16T08:49:01Z

refactor!: consolidate Lua registry sources and the Package API (#1498)

2025-02-16T08:48:59Z

**This removes the following APIs:** - `Package:check_new_version()`. Instead use the new `Package:get_latest_version()`. **This has a breaking change in the following APIs:** - `Package:get_installed_version()` now no longer takes a callback but instead returns the installed version or `nil` if not installed.

To handle these breaking changes in plugins, leverage the `mason.version` module, for example:

```lua local mason_version = require("mason.version") local registry = require("mason-registry") local pkg = registry.get_package("rust-analyzer") if mason_version.MAJOR_VERSION < 2 then -- before pkg:check_new_version(function (success, new_version) -- … end) pkg:get_installed_version(function (success, installed_version) -- … end) else -- after local new_version = pkg:get_latest_version() local installed_version = pkg:get_installed_version() fi ```

---

This change also introduces breaking changes for Lua registry sources, by consolidating the package schema with the registry.

The following is an example of a package defined in a Lua registry, following the new schema: ```lua local Pkg = require("mason-core.package") return Pkg.new { schema = "registry+v1", name = "ripgrep", description = "ripgrep recursively searches directories for a regex pattern while respecting your gitignore.", homepage = "https://github.com/BurntSushi/ripgrep", licenses = { Pkg.License.MIT }, languages = {}, categories = {}, source = { id = "pkg:mason/ripgrep@13.0.0", ---@param ctx InstallContext ---@param purl Purl install = function(ctx, purl) -- Arbitrary installation code. end, }, bin = { rg = "./bin/rg", }, } ```

refactor!: remove old managers (#1497)

2025-02-16T08:32:29Z

fix(pypi): prefer stock python3 if it satisfies version requirement (#1736)

2024-07-09T12:46:42Z

fix(pypi): allow access to system site packages by default (#1584)

2024-07-07T21:47:14Z

Co-authored-by: William Boman

feat(pypi): improve resolving suitable python version (#1725)

2024-06-01T15:17:27Z

fix(pypi): exclude python3.12 from candidate list (#1722)

2024-05-31T05:37:09Z

Support for python3.12 among pypi packages is pretty poor, this limits the upper bound to python3.11 instead.

fix: fix usage of deprecated Neovim APIs (#1703)

2024-05-11T19:22:49Z

fix(pypi): fix variable shadowing (#1610)

2024-01-29T06:28:15Z

feat(pypi): attempt more python3 candidates (#1608)

2024-01-25T21:02:00Z

fix(golang): fix fetching package versions for packages containing subpath specifier (#1607)

2024-01-22T08:09:45Z

feat: don't use vim.g.python3_host_prog as a candidate for python (#1606)

2024-01-21T17:47:59Z

This is inconsistent with how other system dependencies are resolved and is not documented anywhere.

feat: add support for openvsx sources (#1589)

2024-01-06T08:02:01Z

fix(cargo): don't attempt to fetch versions when version targets commit SHA (#1585)

2023-12-29T06:46:43Z

fix(pypi): support MSYS2 virtual environments on Windows (#1547)

2023-11-08T16:43:06Z

chore: decrease log level (#1467)

2023-08-25T21:57:57Z

fix(std): use gtar if available (#1433)

2023-08-19T06:48:10Z

Closes #1415.

feat(cargo): support fetching versions for git crates hosted on github (#1459)

2023-08-19T06:31:07Z

chore(logging): fix log string (#1444)

2023-08-09T07:14:41Z

fix(installer): retain unmapped source fields (#1399)

2023-07-21T16:13:49Z

Fixes #1398.

fix(linker): ensure exec wrapper target is executable (#1380)

2023-06-28T20:00:41Z

Fixes #1368.

feat(installer): write more installation output to stdout (#1376)

2023-06-28T17:26:23Z

This should give better insights into the installation progress.

chore(ci): upgrade linter versions (#1377)

2023-06-28T17:21:28Z

fix(installer): timeout schema download after 5s (#1374)

2023-06-28T16:36:42Z

Closes #1361.

refactor(installer): hoist version validation to the compiled installation entrypoint (#1357)

2023-06-17T13:40:51Z

feat(command): improve completion for :MasonInstall (#1353)

2023-06-13T13:58:05Z

Now also supports completing versions if completion is triggered when specifying a version, e.g. "rust-analyzer@".

feat(installer): lock package installation (#1290)

2023-05-18T15:06:38Z

fix(pypi): also provide install_extra_args to pypi.install (#1263)

2023-04-26T17:50:11Z

Closes #1224.

fix(context): don't write exec wrapper file if it already exists (#1261)

2023-04-26T16:23:34Z

feat(linker): add ruby exec wrapper delegate (#1260)

2023-04-26T15:58:27Z

refactor(linker): copy_file instead of rename on Windows (#1254)

2023-04-23T20:43:56Z

Renaming the file will move it from its original installation directory. While reaching into package installation directories is unsupported and not recommended, it seems to be done pretty broadly. In order to avoid unnecessarily breaking people's configs we copy the file instead, for now. (tip: use the stable locations inside $MASON/share $MASON/opt $MASON/bin, if a package is missing a link please open an issue/PR). This will be reversed back to use uv_fs_rename() in 1.x.x.

fix(linker): don't symlink on Windows (#1253)

2023-04-23T20:25:51Z

1) FAT (FAT32, exFAT, etc.) file systems doesn't support symlinks. 2) You need administrator access in order to create symlinks. This was working for me locally because I'm running a NTFS fs with "Developer Mode" enabled in Windows 10, which bypasses administrator requirement for mklink. Instead we uv_fs_rename() links. This should effectively be the same, but will require special handling down the road if/when for example multiple package versions can be installed at the same time. When unlinking a package the renamed files should me moved back into the package installation directory, instead of simply being unlinked (i.e. removed). Closes #1251.

fix(expr): fix strip_{prefix,suffix} (#1249)

2023-04-22T21:28:10Z

refactor(schemas): don't vendor schemas in mason.nvim (#1248)

2023-04-22T20:35:14Z

Instead, schemas are now defined in the package registry and downloaded during installation. See https://github.com/mason-org/mason-registry/pull/1319.

feat(installer): add generic build provider (#1228)

2023-04-18T08:36:25Z

refactor(expr): remove redundant core filters and always stringify reduced value (#1227)

2023-04-17T23:16:39Z

The removed filters are not used by mason-registry and are too Lua-specific in nature.

refactor: refactor github provider to smaller modules (#1223)

2023-04-16T21:07:56Z

feat(github): add $MASON_VERSION to build context (#1218)

2023-04-16T01:22:37Z

fix(std): manually call zstd on Windows (#1212)

2023-04-14T15:30:04Z

Closes #1207.

fix(github): use evaluated out_file as asset file value (#1208)

2023-04-12T17:32:43Z

This makes it so that after parsing the source, the `{{source.asset.file}}` context value points to the downloaded file, rather than the raw value. This is helpful for source definitions such as: ```yaml source: id: pkg:github/mrjosh/helm-ls@v0.0.3 asset: - target: win_x64 file: helm_ls_windows_amd64:helm_ls_windows_amd64.exe # … bin: # This now evaluates to "helm_ls_windows_amd64.exe" rather than "helm_ls_windows_amd64:helm_ls_windows_amd64.exe". helm_ls: "{{source.asset.file}}" ```

refactor(std): quiet git checkout (#1186)

2023-04-06T18:10:30Z

fix(npm): set install-strategy on npm >= 9 (#1179)

2023-04-04T20:02:55Z

Closes #1175.

refactor: only schedule in a.scheduler() when in fast event (#1170)

2023-04-02T22:33:48Z

Explicitly schedule via `a.wait(vim.schedule)` instead.

chore: log entire opts table (#1149)

2023-03-29T08:40:16Z

feat: add registry.refresh() method (#1096)

2023-03-14T03:48:03Z

style: enforce import order (#1092)

2023-03-12T08:26:02Z

* chore(workflows): update dependencies * style: enforce import order

feat: add github registry source capabilities (#1091)

2023-03-12T07:21:15Z

fix: fix writing pyvenv module wrapper (#1073)

2023-03-06T16:53:57Z

Closes #1071.

refactor(expr): better handling of nil values (#1056)

2023-03-05T01:45:00Z

feat(InstallContext): add strict_mode flag (#1055)

2023-03-05T01:33:57Z

Also add some more ctx.fs methods.

refactor: simplify linker & receipt writing (#1033)

2023-02-26T06:57:42Z

feat(installer): add share links (#965)

2023-02-17T19:08:45Z

* feat(installer): add share links Adds the ability to symlink share files to ~/.local/share/nvim/mason/share (default location). This is currently not used by any packages but will be soon (e.g. linking .jar files to a canonical location on the fs). This also includes the following changes: - fix(windows): correctly unlink executables Prior to this change, executables on Windows would not be removed when uninstalling a package. - refactor(installer): use Result interfaces The motivation behind this is to move away from exceptions and pcalls to leverage the Result interface. This allows for better error messaging during installation, as well as improved composability of actions that may or may not fail. - refactor(bin): use absolute paths in exec wrapper scripts While relative paths are preferred and will end up returning in the future, they i) cannot be guaranteed for all packages, and ii) is somewhat complicated to produce due to lack of std APIs. Moving the entire Mason installation directory was never officially supported anyway. - feat(installer): add "force" flag When this flag is true, any existing executables or share files will be overridden if they exist (i.e. mangle another package installation). * refactor(result): always return Result objects in Result.try The rationale here used to be that exceptions in Result.try() blocks were treated truly as exceptions that should interrupt code execution per Lua's traditional error handling semantics. However, Lua code is somewhat prone to raise exceptions when you don't expect it to (especially when interacting with loosely documented external APIs). Combine this with the fact that code that invokes Result.try() blocks generally doesn't `pcall` and only relies on the Result API to handle errors, you end up with code that only gracefully handles one class of errors (the well-known ones). * test(terminator): sleep in tests to avoid race condition I've no idea why this doesn't pass in CI, works just fine locally.

refactor(expr): rename to interpolate (#836)

2023-01-02T05:52:45Z

refactor(installer): write debug log file after installation finishes (#806)

2022-12-26T16:24:39Z

feat(expr): add tbl_interpolate() (#805)

2022-12-26T16:04:53Z

feat(functional): add strip_{prefix,suffix} (#803)

2022-12-26T15:50:40Z

refactor(installer): introduce PackageInstallOpts class (#802)

2022-12-26T15:35:10Z

feat(registry): add smithy-language-server (#795)

2022-12-24T01:57:53Z

feat(expr): use same context for value & filter evaluation (#778)

2022-12-20T07:44:19Z

feat: add expr module (#775)

2022-12-19T23:02:41Z

This is (soon) to be used when installing package definitions from https://github.com/mason-org/mason-registry/. See for example: https://github.com/mason-org/mason-registry/blob/7df69dd2a73efc3a08520552ca64597d1db5f4fb/packages/go-debug-adapter/package.yaml#L16

refactor(installer): rename run_installer to exec_in_context (#744)

2022-12-08T01:20:42Z

feat(installer): write mason-debug.log in debug mode (#577)

2022-10-19T12:56:02Z

feat(api/command): add --debug flag to :MasonInstall (#576)

2022-10-19T12:41:42Z