Plugin bug

[mkerna]

I've been experimenting with creating a plugin, and I think I've found a bug. Upon execution, the editor strangely shifts each line as you move through it with the arrow keys. It I remove the "-v" (verbose) option from the copy command the problem goes away. But I do want the results of the execute.

N.B. I'm using version 2.0.14.

Also, is there a thorough reference for all of the commands. I've read the plugin page and there are things I had to figure out from other people's plugin code.

local micro = import("micro")
local config = import("micro/config")

function init()
    config.MakeCommand("test", testCommand, config.NoComplete)
end

function testCommand(bp)
    local s, err = os.execute("cp -v -a main.lua main.lua2")
    if err ~= nil then
        micro.InfoBar():Error(err)
    end
end

[dmaluka]

I've been experimenting with creating a plugin, and I think I've found a bug. Upon execution, the editor strangely shifts [...]

#3622

Also, is there a thorough reference for all of the commands. I've read the plugin page and there are things I had to figure out from other people's plugin code.

As the plugin page says:

This may seem like a small list of available functions, but some of the objects
returned by the functions have many methods. The Lua plugin may access any
public methods of an object returned by any of the functions above.
Unfortunately, it is not possible to list all the available functions on this
page. Please go to the internal documentation at
https://pkg.go.dev/github.com/zyedidia/micro/v2/internal to see the full list
of available methods. Note that only methods of types that are available to
plugins via the functions above can be called from a plugin. For an even more
detailed reference, see the source code on Github.

(As an example, bp:InsertNewline() used by the built-in autoclose plugin is documented in https://pkg.go.dev/github.com/zyedidia/micro/[email protected]/internal/action#BufPane.InsertNewline.)

This implies that you need to know a bit of Go, at least to understand the signatures of those methods. Furthermore, you'd better also know a bit about the rules of how those Go interfaces are automatically converted to Lua interfaces (so that you know how to use them from Lua code). Those rules are described in https://pkg.go.dev/layeh.com/gopher-luar#New.

Also, what this doesn't mention is that many of those interfaces in https://pkg.go.dev/github.com/zyedidia/micro/v2/internal are poorly documented, or not documented at all. So realistically, you often need to read and understand micro's source code in order to write plugins efficiently.

Another thing it doesn't mention is that those interfaces documented in https://pkg.go.dev/github.com/zyedidia/micro/v2/internal are not guaranteed to remain stable, they may suddenly change in the next release of micro.

All the above is to make your life exciting.