mason/lua/mason-core/package/init.lua, branch main

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

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.

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

2025-05-06T00:57:26Z

style: fix stylua and selene errors

2025-02-20T22:50:27Z

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) ```

chore: hoist single file modules

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

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", }, } ```

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

2025-02-15T20:00:35Z

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

2025-02-15T15:44:40Z

Co-authored-by: William Boman

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

2023-07-04T10:08:12Z

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(registry): add ability to register package aliases (#1146)

2023-04-05T19:42:17Z

fix(package): schedule callback that can only run in main loop (#1172)

2023-04-02T22:36:08Z

fix(sources): also set .desc property when updating spec (#1095)

2023-03-13T23:59:56Z

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(package): emit registry event on abnormal failures (#1061)

2023-03-05T02:21:54Z

Also display a more helpful error message in the UI, as well as terminating the handle if it's not yet terminated.

refactor(package): lazy-require modules (#1060)

2023-03-05T02:21:03Z

The mason-core.package module is loaded whenever there's anything interfacing with Mason packages (i.e. pretty often). Some of the modules imported at the top-level is used pretty infrequently, so we lazily require these instead.

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.

fix(package): emit package:uninstall:success registry event (#849)

2023-01-04T08:47:06Z

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

2022-12-26T15:35:10Z

fix(package): don't call vim API functions inside fast event (#730)

2022-12-05T16:48:34Z

feat: show warning message when exiting neovim with active installations (#725)

2022-12-04T18:59:43Z

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

2022-10-19T12:41:42Z

chore: bump stylua to 0.14.3 (#395)

2022-09-08T13:19:11Z

refactor: introduce selene, harden type defs, and use proper EmmyLua syntax (#296)

2022-08-15T19:03:06Z

chore: change emmylua annotation syntax from @ to : for comments (#73)

2022-07-14T15:27:12Z

tests: add some mason-core.package tests (#69)

2022-07-13T15:19:08Z

feat(api): run :MasonInstall in blocking fashion if no UIs are attached (#52)

2022-07-11T15:08:05Z

Also make sure to exit neovim with an error exit code should one or more installations fail.

refactor: add mason-schemas and mason-core modules (#29)

2022-07-08T16:34:38Z

* refactor: add mason-schemas and move generated filetype map to mason-lspconfig * refactor: add mason-core module