🐜 denops_std
Standard module for denops.vim.
This module is assumed to be used for developing denops plugins. The code is assumed to be called in a dedicated worker thread.
By using this module, developers can write Vim/Neovim denops plugins like:
import type { Denops } from "https://deno.land/x/denops_std@v6.4.1/mod.ts";
import * as batch from "https://deno.land/x/denops_std@v6.4.1/batch/mod.ts";
import * as fn from "https://deno.land/x/denops_std@v6.4.1/function/mod.ts";
import * as vars from "https://deno.land/x/denops_std@v6.4.1/variable/mod.ts";
import * as helper from "https://deno.land/x/denops_std@v6.4.1/helper/mod.ts";
import { assert, is } from "https://deno.land/x/unknownutil@v3.14.1/mod.ts";
export function main(denops: Denops): void {
denops.dispatcher = {
async init() {
// This is just an example. Developers usually should define commands directly in Vim script.
await batch.batch(denops, async (denops) => {
await denops.cmd(
`command! HelloWorld call denops#notify("${denops.name}", "say", ["World"])`,
);
await denops.cmd(
`command! HelloDenops call denops#notify("${denops.name}", "say", ["Denops"])`,
);
});
},
async say(where) {
assert(where, is.String);
const [name, progname] = await batch.collect(denops, (denops) => [
fn.input(denops, "Your name: "),
vars.v.get(denops, "progname"),
]);
const messages = [
`Hello ${where}.`,
`Your name is ${name}.`,
`This is ${progname}.`,
];
await helper.echo(denops, messages.join("\n"));
},
};
}
Note that developers should avoid calling initialization code within the
main
function. If necessary, add an init
API or a similar approach like
above and call it from plugin/<your_plugin>.vim
.
See Denops Documentation or denops-helloworld.vim for more details.
License
The code follows MIT license written in LICENSE. Contributors need to agree that any modifications sent in this repository follow the license.