mason/tests/mason-core/package/package_spec.lua, branch stable

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

2026-04-06T18:08:26Z

refactor(registry): change lua registries to not instantiate Package themselves

2025-05-02T01:57:07Z

Instead of having Lua registries instantiate package instances themselves we now do it in the installer of Lua registry sources. This aligns the behaviour of the Lua registry protocol with the other registry protocols.

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

refactor: standardize constructors and improve inheritance construction

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!: 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

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): don't call vim API functions inside fast event (#730)

2022-12-05T16:48:34Z

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

2022-08-15T19:03:06Z

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

2022-07-13T15:19:08Z