• fs: implement rmrf natively via libuv (#2098) (8838e7a)
• nuget: also support .cmd shims on Windows (#2102) (16ba83b)

• add support for socket.dev firewall client (#2088) (24e77d5)
• add the infrastructure to support "system" packages (#2085) (8e921c2)
• npm: add install_args setting (#1581) (8fdc4b0)
• registry: add registry_cache setting for controlling cache behaviour (#2089) (cbf8d28)

• actually emit the receipt in uninstall event payloads (#2071) (b03fb0f)
• powershell: conform to single quotes (#1740) (12ddd18)
• pypi: add python 3.13 and 3.14 to list of fallbacks (#2081) (e54f5bf)
• spawn: handle cases where PATH env on Windows is not set (#2080) (cb8445f)

• registry: exclude synthesized registry when updating/installing registries (#2054) (3fce8bd)

• add support for removal of packages from a registry (#2052) (69862d6)

• installer: attempt to recover from known fs error while finalizing installation on some file systems (#1933) (198f075)
• installer: update cwd after uv_fs_rename() was successful (#2033) (57e5a8a)

• compiler: make supported_platforms a universal source field (#2002) (7dc4fac)

• process: close check handles (#1995) (a1fbecc)
• pypi: add support for "compatible release" (~=) PEP440 expressions (#2000) (9e25c98)
• spawn: always expand executable path on Windows (#2021) (a83eabd)
• ui: only set border to none if 'winborder' doesn't exist (#1984) (3671ab0)

• fetch: add busybox wget support (#1829) (8024d64)
• pypi: pass --no-user flag (#1958) (1aceba8)
• registry: ensure there's no duplicate registry entries (#1957) (3501b0f)
• spawn: fix calling vim.fn when inside fast event loop on Windows (#1950) (888d6ee)
• spawn: fix locating exepath on Windows systems using a Unix 'shell' (#1991) (edd8f7b)

This release has been an ongoing effort for quite some time now and is now ready for release. Most users should not experience any breaking changes. If you use any of the Lua APIs that Mason provides you'll find an outline of the changes below, breaking changes are marked with Breaking Change.

The repository has been transferred to the mason-org organization. The new URL is https://github.com/mason-org/mason.nvim. The previous URL will continue to function as a redirect to the new URL but users are recommended to update to the new location.

• @mehalter
• @Conarius
• @chrisgrieser

• Symlinks now uses relative paths instead of absolute paths.
• Uninstalled packages now display their available version in the :Mason UI.
• Packages in the :Mason UI now display the source purl.
• Official support for custom registries.
• Make registry installations run concurrently.
• Add support for 'winborder'.
• Display current mason.nvim version in the :Mason UI header.

• Only attempt unlinking package if the receipt is found.
• Expand executable paths on Windows before passing to uv_spawn.
• Fix initializing UI state when using multiple registries.
• Fix the display of outdated packages in the Mason UI under certain conditions.

• Breaking Change Minimum Neovim requirement changed from 0.7.0 to 0.10.0.
• Breaking Change APIs related to custom packages written in Lua has been removed.
  • All require("mason-core.installer.managers") modules have been removed.
  • The package structure of Lua packages has changed, refer to custom registries for information on how to continue using custom packages in Lua.

• Breaking Change install:success now provides the receipt as payload argument.
• Breaking Change install:failed now provides the error as payload argument.
• Breaking Change uninstall:success now provides the receipt of the uninstalled package as payload argument.
• uninstall:failed is now emitted when package uninstallation fails.

• Breaking Change package:install:success now provides the receipt as payload argument.
• Breaking Change package:install:failed now provides the error as payload argument.
• Breaking Change package:uninstall:success now provides the receipt of the uninstalled package as payload argument.
• package:uninstall:failed is now emitted when package uninstallation fails.
• Breaking Change update is no longer emitted when registry is updated. It's replaced by the following events:
  • update:start when the registry starts updating
  • update:success when the registry is successfully updated
  • update:failed when the registry failed to update
  • update:progress is emitted when the registry update process makes progress when multiple registries are used

Breaking Change

This method has been removed to prepare for future changes.

If you're using this method to access an executable, please consider simply using the canonical name of the executable as Mason adds these to your PATH by default. If you're using the method to access other files inside the package, please consider accessing the $MASON/share directory instead.

Example:

Clarification: The $MASON environment variable has been available since v1.0.0.

-- 1a. There's no need to reach into the package directory via Package:get_install_path() to access the executable
print(vim.fn.exepath("kotlin-debug-adapter"))
-- /Users/william/.local/share/nvim/mason/bin/kotlin-debug-adapter

-- 1b. Alternatively if you've configured Mason to not modify PATH
print(vim.fn.expand("$MASON/bin/kotlin-debug-adapter"))
-- /Users/william/.local/share/nvim/mason/bin/kotlin-debug-adapter

-- 2. To access other files inside the package directory, consider accessing them via the share/ directory
vim.print(vim.fn.globpath("$MASON/share/java-debug-adapter", "*.jar", true, true))
-- { "/Users/william/.local/share/nvim/mason/share/java-debug-adapter/com.microsoft.java.debug.plugin-0.53.1.jar", "/Users/william/.local/share/nvim/mason/share/java-debug-adapter/com.microsoft.java.debug.plugin.jar" }

-- 3. If you absolutely need to access the package directory (please consider raising an issue/PR in the registry if possible)
print(vim.fn.expand("$MASON/packages/kotlin-debug-adapter/adapter/bin/kotlin-debug-adapter"))
-- /Users/william/.local/share/nvim/mason/packages/kotlin-debug-adapter/adapter/bin/kotlin-debug-adapter

Breaking Change

This method now provides an asynchronous interface and accepts two new optional arguments opts and callback. opts currently doesn't have any valid values other than an empty Lua table {}. callback is called when the package is uninstalled, successfully or not. While the uninstall mechanism under the hood remains synchronous for the time being it is not a guarantee going forward and users are recommended to always use the asynchronous version.

Example:

local registry = require("mason-registry")
local pkg = registry.get_package("lua-language-server")

pkg:uninstall({}, function (success, result)
    if success then
        -- Do something on success.
    else
        -- Do something on error.
    end
end)

Breaking Change

Package:check_new_version() is replaced by Package:get_latest_version(). Package:get_latest_version() is a synchronous API.

Example:

local registry = require("mason-registry")
local pkg = registry.get_package("lua-language-server")
local latest_version = pkg:get_latest_version()

Breaking Change

This function no longer accepts a callback.

Example:

local registry = require("mason-registry")
local pkg = registry.get_package("lua-language-server")
if pkg:is_installed() then
    local installed_version = pkg:get_installed_version()
end

Breaking Change

Use the new Package:is_installing() method to check whether an installation is already running.

Breaking Change

Use the new Package:is_installed() method to check whether the package is installed.

This optional callback is called by Mason when package installation finishes, successfully or not.

Example:

local registry = require("mason-registry")
local pkg = registry.get_package("lua-language-server")

pkg:install({}, function (success, result)
    if success then
        -- Do something on success.
    else
        -- Do something on error.
    end
end)

v2.0.0 introduces official support for custom registries. Currently supported registry protocols are github:, file:, and lua:. Lua-based registries have been reworked, please see https://github.com/mason-org/registry-examples for examples.

Thanks to all sponsors who continue to help finance monthly costs and all 181 contributors of mason.nvim and 246 contributors of the core registry!

• pypi: improve resolving suitable python version (#1725) (0950b15)
• ui: add backdrop (#1759) (0a3a85f)

• avoid calling vim.fn in fast event (#1878) (3a444cb)
• avoid calling vim.fn.has inside fast event (#1705) (1b3d604)
• fix usage of deprecated Neovim APIs (#1703) (0f1cb65)
• fs: fall back to fs_stat if entry type is not returned by fs_readdir (#1783) (1114b23)
• health: support multidigit luarocks version numbers (#1648) (751b1fc)
• pypi: allow access to system site packages by default (#1584) (2be2600)
• pypi: exclude python3.12 from candidate list (#1722) (f8ce876)
• pypi: prefer stock python3 if it satisfies version requirement (#1736) (f96a318)
• registry: exhaust streaming parser when loading "file:" registries (#1708) (49ff59a)
• replace deprecated calls to vim.validate (#1876) (5664dd5)
• ui: fix rendering JSON schemas (#1757) (e2f7f90)
• ui: reposition window if border is different than "none" (#1859) (f9f3b46)

• registry: significantly improve the "file:" protocol performance (#1702) (098a56c)

• don't use vim.g.python3_host_prog as a candidate for python (#1606) (bce96d2)
• pypi: attempt more python3 candidates (#1608) (dcd0ea3)

• golang: fix fetching package versions for packages containing subpath specifier (#1607) (9c94168)
• pypi: fix variable shadowing (#1610) (aa550fb)
• ui: don't indent empty lines (#1597) (c7e6705)

• add support for openvsx sources (#1589) (6c68547)

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

• pypi: support MSYS2 virtual environments on Windows (#1547) (3e2432a)

• registry: fix parsing registry identifiers that contain ":" (#1542) (87eb3ac)

• health: schedule vim.fn call (#1514) (3ba3b79)

• ui: add setting to toggle help view (#1468) (e1602c8)

• registry: reset registries state when setting registries (#1474) (c811fbf)
• registry: schedule vim.fn calls in FileRegistrySource (#1471) (1c77412)

• cargo: support fetching versions for git crates hosted on github (#1459) (e9eb004)
• registry: add file: source protocol (#1457) (8544039)

• std: use gtar if available (#1433) (a51c2d0)
• ui: properly reset new package version state (#1454) (68e6a15)

• ui: don't disable search mode if empty pattern and last-pattern is set (#1445) (be6f680)

• installer: retain unmapped source fields (#1399) (0579574)

• ui: display package deprecation message (#1391) (b728115)
• ui: don't use diagnostic messages for displaying deprecated, uninstalled, packages (#1393) (c290d0e)

• linker: ensure exec wrapper target is executable (#1380) (10da1a3)
• purl: percent-encoding is case insensitive (#1382) (b68d3be)

• command: add completion for option flags for :MasonInstall (#1379) (e507af7)
• installer: write more installation output to stdout (#1376) (758ac5b)

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

• fetch: add explicit default timeout to requests (#1364) (82cae55)
• fetch: include mason.nvim version in User-Agent (#1362) (e706d30)

• health: add advice for Debian/Ubuntu regarding python3 venv (#1358) (6f3853e)

• providers: fix some client providers and add some more (#1354) (6f44955)

• command: improve completion for :MasonInstall (#1353) (13e26c8)

• async: always check channel state (#1351) (f503346)
• command: run :MasonUpdate synchronously in headless mode (#1347) (0276793)
• functional: strip_prefix and strip_suffix should not use patterns (#1352) (f99b702)

• ui: improve search mode UI and remove redundant whitespaces (#1332) (a18c031)

• installer: lock package installation (#1290) (227f8a9)
• ui: add keymap setting for toggling package installation log (#1268) (48bb1cc)
• ui: add search mode (#1306) (3b59f25)
• ui: display "update all" hint (#1296) (e634134)

• sources: don't skip installation if fixed version is not currently installed (#1297) (9c5edf1)
• ui: use vim.cmd("") for nvim-0.7.0 compatibility (#1307) (e60b855)

• pypi: also provide install_extra_args to pypi.install (#1263) (646ef07)