1 files changed, 50 insertions, 0 deletions
diff --git a/meta/3rd/luassert/library/luassert/stub.lua b/meta/3rd/luassert/library/luassert/stub.lua
new file mode 100644
index 00000000..6332d3ed
--- /dev/null
+++ b/meta/3rd/luassert/library/luassert/stub.lua
@@ -0,0 +1,50 @@
+---@meta
+
+---Function similarly to spies, except that stubs do not call the function that they replace.
+---@class luassert.stub
+local stub = {}
+
+---Creates a new stub that replaces a method in a table in place.
+---@param object table The object that the method is in
+---@param key string The key of the method in the `object` to replace
+---@param ... any A function that operates on the remaining passed in values and returns more values or just values to return
+---@return luassert.spy stub A stub object that can be used to perform assertions
+---@return any ... Values returned by a passed in function or just the values passed in
+function stub(object, key, ...) end
+
+---Creates a new stub that replaces a method in a table in place.
+---@param object table The object that the method is in
+---@param key string The key of the method in the `object` to replace
+---@param ... any A function that operates on the remaining passed in values and returns more values or just values to return
+---@return luassert.spy stub A stub object that can be used to perform assertions
+---@return any ... Values returned by a passed in function or just the values passed in
+---
+---## Example
+---```
+---describe("Stubs", function()
+---    local t = {
+---        lottery = function(...)
+---            print("Your numbers: " .. table.concat({ ... }, ","))
+---        end,
+---    }
+---
+---    it("Tests stubs", function()
+---        local myStub = stub.new(t, "lottery")
+---
+---        t.lottery(1, 2, 3) -- does not print
+---        t.lottery(4, 5, 6) -- does not print
+---
+---        assert.stub(myStub).called_with(1, 2, 3)
+---        assert.stub(myStub).called_with(4, 5, 6)
+---        assert.stub(myStub).called(2)
+---        assert.stub(myStub).called_less_than(3)
+---
+---        myStub:revert()
+---
+---        t.lottery(10, 11, 12) -- prints
+---    end)
+---end)
+---```
+function stub.new(object, key, ...) end
+
+return stub