mason/lua/mason-core, branch main

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(spawn): handle cases where PATH env on Windows is not set (#2080)

2026-04-27T04:28:19Z

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

fix(spawn): always expand executable path on Windows (#2021)

2025-09-30T18:02:22Z

This fixes some issues with the logic for expanding paths on Windows. If a process is spawned with a custom `PATH` (either via the `env` or `env_raw` arg) we still expand the path manually but with a temporarily modified `vim.env.PATH`. Fixes #2009.

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(pypi): add support for "compatible release" (~=) PEP440 expressions (#2000)

2025-08-01T22:19:10Z

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

2025-07-28T15:27:36Z

fix(spawn): fix locating exepath on Windows systems using a Unix `'shell'` (#1991)

2025-07-25T07:54:47Z

Fixes #1961.

fix(fetch): add busybox wget support (#1829)

2025-05-24T19:06:53Z

Co-authored-by: William Boman

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

2025-05-19T04:08:48Z

Fixes #1937.

fix(spawn): fix calling vim.fn when inside fast event loop on Windows (#1950)

2025-05-15T16:34:17Z

docs: update references to mason-org/mason.nvim (#1925)

2025-05-06T21:30:27Z

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

2025-05-06T00:57:26Z

feat(ui): display purl information

2025-04-22T14:23:55Z

First step towards surfacing more package source information.

feat(ui): support 'winborder'

2025-04-21T21:39:00Z

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

fix(spawn): expand executable paths on Windows before passing to uv_spawn (#1885)

2025-02-22T00:26:53Z

This fixes issues on Windows where uv_spawn fails to locate certain types of executables in PATH.

style: fix stylua and selene errors

2025-02-20T22:50:27Z

feat(context): add ctx:await()

2025-02-19T11:15:49Z

chore: remove unnecessary vim.schedule and nvim_err_writeln

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

fix(async): also check async context termination immediately after suspending

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.

feat(path): add relative(from, to)

2025-02-19T08:23:19Z

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: hoist single file modules

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(package): support older receipt structures (#1520)

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

feat(ui): add backdrop (#1759)

2025-02-15T22:12:31Z

Adds a backdrop for the Mason window. Can be disabled by setting the `ui.backdrop` option: ```lua require("mason").setup { ui = { backdrop = 100 } } ``` The backdrop is not displayed if `'termguicolors'` is not enabled or if Neovim is transparent. Co-authored-by: William Boman

fix(fs): fall back to `fs_stat` if entry type is not returned by `fs_readdir` (#1783)

2025-02-15T20:19:11Z

Co-authored-by: William Boman

fix: avoid calling vim.fn in fast event (#1878)

2025-02-15T20:00:35Z

fix(ui): reposition window if border is different than "none" (#1859)

2025-02-15T17:34:17Z

Co-authored-by: William Boman

fix: replace deprecated calls to vim.validate (#1876)

2025-02-15T15:44:40Z

Co-authored-by: William Boman

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: avoid calling vim.fn.has inside fast event (#1705)

2024-05-12T11:35:18Z

When this module is lazily required inside functional/init.lua we may be inside a fast event, causing the module to fail to load due to the top-level call to vim.fn.has.

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.

fix(ui): don't indent empty lines (#1597)

2024-01-21T17:26:29Z

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(async): add Channel (#1456)

2023-08-17T17:34:23Z

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.

feat(ui): display package deprecation message (#1391)

2023-07-04T10:08:12Z

fix(purl): percent-encoding is case insensitive (#1382)

2023-06-28T22:33:13Z

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.

feat(fetch): add explicit default timeout to requests (#1364)

2023-06-21T22:03:07Z

feat(fetch): include mason.nvim version in User-Agent (#1362)

2023-06-21T16:42:34Z

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@".

fix(functional): strip_prefix and strip_suffix should not use patterns (#1352)

2023-06-13T13:45:34Z

fix(async): always check channel state (#1351)

2023-06-13T13:45:07Z

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

2023-05-18T15:06:38Z

feat(ui): add search mode (#1306)

2023-05-17T14:56:25Z

chore(Optional): add :and_then() (#1270)

2023-04-28T10:46:31Z

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.