neovim

package module
v0.0.0-...-f91850c Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 12, 2015 License: MIT Imports: 10 Imported by: 1

README

neovim

Build Status

Go package for writing Neovim plugins

go get github.com/myitcv/neovim

This package is very much in alpha. Therefore, expect changes to this API. Stuff will break.

Writing plugins

See:

  • the Example plugin for a brief README on how to implement your own Go plugin
  • neogo, a proof of concept Neovim plugin written against the neovim Go package to support Go development in Neovim. This uses a go/parser AST generated from the current buffer to highlight code using matchaddpos (as opposed to Neovim's default regex-based syntax definitions)

As explained in the TODO, many of the steps required to create a plugin are not currently automated, but very much on the roadmap.

Supported platforms

At the time of writing this package has only been written for/tested against Linux.

Support welcomed on other platforms

Tests

go test ./...

Credit

Todo list

See the wiki

Documentation

Overview

Package neovim implements support for writing Neovim plugins in Go. Communication with Neovim is via MSGPACK:

https://github.com/msgpack/msgpack/blob/master/spec.md

All Neovim API methods are supported. In addition there is support for handling synchronous method calls or asynchronous notifications from Neovim by registering handlers in your plugin. See the MSGPACK RPC spec for further details on these two types of callback:

https://github.com/msgpack-rpc/msgpack-rpc/blob/master/spec.md

Via a plugin manifest (details to follow) your plugin can bind these handlers to either Autocmds, Functions or Commands in Neovim.

Status

This project is still in alpha.

Example Plugin

For a complete example, see the example.Example plugin http://godoc.org/github.com/myitcv/neovim/example

Writing plugins

Plugins implement the Plugin interface. Plugins are initialised with a Client that is passed to a plugin via the Init method they implement. The Client is used to communicate with a Neovim instance.

Concurrency

A single Client may safely be used by multiple goroutines. Calls to API methods are blocking by design.

Compatibility

There are currently no checks to verify a connected Neovim instance exposes the same API against which the neovim package was generated. This is future work (and probably needs some work on the Neovim side).

See also

The tool for generating the API The Neovim Go plugin manager The code generator used by plugin writers

Errors

Errors returned by this package are created using errors at http://godoc.org/github.com/juju/errors. Hence errors may be inspected using functions like errors.Details for example: 

_, err := client.GetCurrentBuffer()
if err != nil {
	log.Fatalf("Could not get current buffer: %v", errors.Details(err))
}

Index

Examples

Constants

This section is empty.

Variables

This section is empty.

Functions

func NullInitMethod 

func NullInitMethod() error

Types

type AsyncDecoder 

type AsyncDecoder interface {
	CallArgs
	AsyncRunner
}

type AsyncRunner 

type AsyncRunner interface {
	Run() error
}

type Buffer 

type Buffer struct {
	ID uint8
	// contains filtered or unexported fields
}

Buffer represents a Neovim Buffer

Multiple goroutines may invoke methods on a Buffer simultaneously

func (*Buffer) DelLine 

func (b *Buffer) DelLine(index int) error

DelLine waiting for documentation from Neovim

func (*Buffer) ExtensionType 

func (b *Buffer) ExtensionType() int8

func (*Buffer) GetLine 

func (b *Buffer) GetLine(index int) (string, error)

GetLine waiting for documentation from Neovim

func (*Buffer) GetLineSlice 

func (b *Buffer) GetLineSlice(start int, end int, includeStart bool, includeEnd bool) ([]string, error)

GetLineSlice waiting for documentation from Neovim

func (*Buffer) GetMark 

func (b *Buffer) GetMark(name string) ([]int, error)

GetMark waiting for documentation from Neovim

func (*Buffer) GetName 

func (b *Buffer) GetName() (string, error)

GetName waiting for documentation from Neovim

func (*Buffer) GetNumber 

func (b *Buffer) GetNumber() (int, error)

GetNumber waiting for documentation from Neovim

func (*Buffer) GetOption 

func (b *Buffer) GetOption(name string) (interface{}, error)

GetOption waiting for documentation from Neovim

func (*Buffer) GetVar 

func (b *Buffer) GetVar(name string) (interface{}, error)

GetVar waiting for documentation from Neovim

func (*Buffer) Insert 

func (b *Buffer) Insert(lnum int, lines []string) error

Insert waiting for documentation from Neovim

func (*Buffer) IsValid 

func (b *Buffer) IsValid() (bool, error)

IsValid waiting for documentation from Neovim

func (*Buffer) Len 

func (b *Buffer) Len() int

func (*Buffer) LineCount 

func (b *Buffer) LineCount() (int, error)

LineCount waiting for documentation from Neovim

func (*Buffer) MarshalBinaryTo 

func (b *Buffer) MarshalBinaryTo(buf []byte) error

func (*Buffer) SetLine 

func (b *Buffer) SetLine(index int, line string) error

SetLine waiting for documentation from Neovim

func (*Buffer) SetLineSlice 

func (b *Buffer) SetLineSlice(start int, end int, includeStart bool, includeEnd bool, replacement []string) error

SetLineSlice waiting for documentation from Neovim

func (*Buffer) SetName 

func (b *Buffer) SetName(name string) error

SetName waiting for documentation from Neovim

func (*Buffer) SetOption 

func (b *Buffer) SetOption(name string, value interface{}) error

SetOption waiting for documentation from Neovim

func (*Buffer) SetVar 

func (b *Buffer) SetVar(name string, value interface{}) (interface{}, error)

SetVar waiting for documentation from Neovim

func (*Buffer) UnmarshalBinary 

func (b *Buffer) UnmarshalBinary(buf []byte) error

type CallArgs 

type CallArgs interface {
	Eval() msgp.Decodable
	Params() *MethodOptionParams
	Args() msgp.Decodable
}

type ChannelID 

type ChannelID uint8

type Client 

type Client struct {

	// PanicOnError can be set to have the Client panic when an error would
	// otherwise have been returned via an API method. Note: any attempt to
	// change this option during concurrent use of the Client will be racey.
	// This is useful for debugging.
	PanicOnError bool
	KillChannel  chan struct{}

	// TODO remove this
	HostName string
	// contains filtered or unexported fields
}

A Client represents a connection to a single Neovim instance

func NewClient 

func NewClient(im InitMethod, c io.ReadWriteCloser, log Logger) (*Client, error)

NewClient creates a new Client

func NewCmdClient 

func NewCmdClient(im InitMethod, c *exec.Cmd, log Logger) (*Client, error)

NewCmdClient creates a new Client that is linked via stdin/stdout to the supplied exec.Cmd, which is assumed to launch Neovim. The Neovim flag --embed is added if it is missing, and the exec.Cmd is started as part of creating the client. Calling Close() will close stdin on the embedded Neovim instance, thereby ending the process

func NewUnixClient 

func NewUnixClient(im InitMethod, _net string, laddr, raddr *net.UnixAddr, log Logger) (*Client, error)

NewUnixClient is a convenience method for creating a new *Client. Method signature matches that of net.DialUnix

func (*Client) CallFunction 

func (c *Client) CallFunction(fname string, args []interface{}) (interface{}, error)

CallFunction waiting for documentation from Neovim

func (*Client) ChangeDirectory 

func (c *Client) ChangeDirectory(dir string) error

ChangeDirectory waiting for documentation from Neovim

func (*Client) Close 

func (c *Client) Close() error

Close cleanly kills the client connection to Neovim

func (*Client) Command 

func (c *Client) Command(str string) error

Command waiting for documentation from Neovim

func (*Client) CommandOutput 

func (c *Client) CommandOutput(str string) (string, error)

CommandOutput waiting for documentation from Neovim

func (*Client) DelCurrentLine 

func (c *Client) DelCurrentLine() error

DelCurrentLine waiting for documentation from Neovim

func (*Client) ErrWrite 

func (c *Client) ErrWrite(str string) error

ErrWrite waiting for documentation from Neovim

func (*Client) Eval 

func (c *Client) Eval(str string) (interface{}, error)

Eval waiting for documentation from Neovim

func (*Client) Feedkeys 

func (c *Client) Feedkeys(keys string, mode string, escapeCsi bool) error

Feedkeys waiting for documentation from Neovim

func (*Client) GetAPIInfo 

func (c *Client) GetAPIInfo() (ChannelID, *apidef.API, error)

func (*Client) GetApiInfo 

func (c *Client) GetApiInfo() ([]interface{}, error)

GetApiInfo waiting for documentation from Neovim

func (*Client) GetBuffers 

func (c *Client) GetBuffers() ([]Buffer, error)

GetBuffers waiting for documentation from Neovim

func (*Client) GetColorMap 

func (c *Client) GetColorMap() (map[string]interface{}, error)

GetColorMap waiting for documentation from Neovim

func (*Client) GetCurrentBuffer 

func (c *Client) GetCurrentBuffer() (Buffer, error)

GetCurrentBuffer waiting for documentation from Neovim

Example 
package main

import (
	"fmt"
	"log"
	"os"
	"os/exec"

	"github.com/juju/errors"
	"github.com/myitcv/neovim"
)

func main() {
	cmd := exec.Command(os.Getenv("NEOVIM_BIN"), "-u", "/dev/null")
	cmd.Dir = "/tmp"

	client, err := neovim.NewCmdClient(neovim.NullInitMethod, cmd, nil)
	if err != nil {
		log.Fatalf("Could not create new client: %v", errors.Details(err))
	}
	client.Run()

	b, err := client.GetCurrentBuffer()
	if err != nil {
		log.Fatalf("Could not get current buffer: %v", errors.Details(err))
	}
	n, err := b.GetName()
	if err != nil {
		log.Fatalf("Could not get name for buffer %v: %v", b, errors.Details(err))
	}
	fmt.Printf("Current buffer is: %v %v\n", b.ID, n)

	err = client.Close()
	if err != nil {
		log.Fatalf("Could not close client: %v\n", err)
	}

}

Output:

Current buffer is: 2

func (*Client) GetCurrentLine 

func (c *Client) GetCurrentLine() (string, error)

GetCurrentLine waiting for documentation from Neovim

func (*Client) GetCurrentTabpage 

func (c *Client) GetCurrentTabpage() (Tabpage, error)

GetCurrentTabpage waiting for documentation from Neovim

func (*Client) GetCurrentWindow 

func (c *Client) GetCurrentWindow() (Window, error)

GetCurrentWindow waiting for documentation from Neovim

func (*Client) GetOption 

func (c *Client) GetOption(name string) (interface{}, error)

GetOption waiting for documentation from Neovim

func (*Client) GetTabpages 

func (c *Client) GetTabpages() ([]Tabpage, error)

GetTabpages waiting for documentation from Neovim

func (*Client) GetVar 

func (c *Client) GetVar(name string) (interface{}, error)

GetVar waiting for documentation from Neovim

func (*Client) GetVvar 

func (c *Client) GetVvar(name string) (interface{}, error)

GetVvar waiting for documentation from Neovim

func (*Client) GetWindows 

func (c *Client) GetWindows() ([]Window, error)

GetWindows waiting for documentation from Neovim

func (*Client) Input 

func (c *Client) Input(keys string) (int, error)

Input waiting for documentation from Neovim

func (*Client) ListRuntimePaths 

func (c *Client) ListRuntimePaths() ([]string, error)

ListRuntimePaths waiting for documentation from Neovim

func (*Client) NameToColor 

func (c *Client) NameToColor(name string) (int, error)

NameToColor waiting for documentation from Neovim

func (*Client) OutWrite 

func (c *Client) OutWrite(str string) error

OutWrite waiting for documentation from Neovim

func (*Client) RegisterAsyncFunction 

func (c *Client) RegisterAsyncFunction(m string, d NewAsyncDecoder, rangeBased bool, eval bool) error

func (*Client) RegisterAsyncRequestHandler 

func (c *Client) RegisterAsyncRequestHandler(m string, d NewAsyncDecoder, o *MethodOptions) error

func (*Client) RegisterSyncFunction 

func (c *Client) RegisterSyncFunction(m string, d NewSyncDecoder, rangeBased bool, eval bool) error

func (*Client) RegisterSyncRequestHandler 

func (c *Client) RegisterSyncRequestHandler(m string, d NewSyncDecoder, o *MethodOptions) error

func (*Client) ReplaceTermcodes 

func (c *Client) ReplaceTermcodes(str string, fromPart bool, doLt bool, special bool) (string, error)

ReplaceTermcodes waiting for documentation from Neovim

func (*Client) ReportError 

func (c *Client) ReportError(str string) error

ReportError waiting for documentation from Neovim

func (*Client) Run 

func (c *Client) Run()

func (*Client) SetCurrentBuffer 

func (c *Client) SetCurrentBuffer(buffer Buffer) error

SetCurrentBuffer waiting for documentation from Neovim

func (*Client) SetCurrentLine 

func (c *Client) SetCurrentLine(line string) error

SetCurrentLine waiting for documentation from Neovim

func (*Client) SetCurrentTabpage 

func (c *Client) SetCurrentTabpage(tabpage Tabpage) error

SetCurrentTabpage waiting for documentation from Neovim

func (*Client) SetCurrentWindow 

func (c *Client) SetCurrentWindow(window Window) error

SetCurrentWindow waiting for documentation from Neovim

func (*Client) SetOption 

func (c *Client) SetOption(name string, value interface{}) error

SetOption waiting for documentation from Neovim

func (*Client) SetVar 

func (c *Client) SetVar(name string, value interface{}) (interface{}, error)

SetVar waiting for documentation from Neovim

func (*Client) Strwidth 

func (c *Client) Strwidth(str string) (int, error)

Strwidth waiting for documentation from Neovim

func (*Client) Subscribe 

func (c *Client) Subscribe(event string) error

Subscribe waiting for documentation from Neovim

func (*Client) Unsubscribe 

func (c *Client) Unsubscribe(event string) error

Unsubscribe waiting for documentation from Neovim

type Decoder 

type Decoder interface {
	DecodeMsg(*msgp.Reader) error
}

Use for async notifications Here the error would simply be reported to the log (because there is nothing to return)

type Encoder 

type Encoder interface {
	EncodeMsg(*msgp.Writer) error
}

type InitMethod 

type InitMethod func() error

type InitMethodArgs 

type InitMethodArgs struct {
	// contains filtered or unexported fields
}

func (*InitMethodArgs) DecodeMsg 

func (z *InitMethodArgs) DecodeMsg(dc *msgp.Reader) (err error)

type InitMethodRetVals 

type InitMethodRetVals struct {
	InitMethod
}

func (*InitMethodRetVals) EncodeMsg 

func (z *InitMethodRetVals) EncodeMsg(en *msgp.Writer) (err error)

type InitMethodWrapper 

type InitMethodWrapper struct {
	*Client
	InitMethod
	// contains filtered or unexported fields
}

func (*InitMethodWrapper) Args 

func (i *InitMethodWrapper) Args() msgp.Decodable

func (*InitMethodWrapper) Eval 

func (i *InitMethodWrapper) Eval() msgp.Decodable

func (*InitMethodWrapper) Params 

func (i *InitMethodWrapper) Params() *MethodOptionParams

func (*InitMethodWrapper) Results 

func (i *InitMethodWrapper) Results() msgp.Encodable

func (*InitMethodWrapper) Run 

func (i *InitMethodWrapper) Run() (error, error)

type Logger 

type Logger interface {
	Fatal(v ...interface{})
	Fatalf(format string, v ...interface{})
	Fatalln(v ...interface{})
	Flags() int
	Output(calldepth int, s string) error
	Panic(v ...interface{})
	Panicf(format string, v ...interface{})
	Panicln(v ...interface{})
	Prefix() string
	Print(v ...interface{})
	Printf(format string, v ...interface{})
	Println(v ...interface{})
	SetFlags(flag int)
	SetPrefix(prefix string)
}

Logger is a local definition of the inteface effectively exposed by http://godoc.org/log

type MethodOptionParams 

type MethodOptionParams struct {
	Range *Range
}

func (*MethodOptionParams) DecodeParams 

func (m *MethodOptionParams) DecodeParams(o *MethodOptions, reader *msgp.Reader) error

type MethodOptions 

type MethodOptions struct {
	Type  MethodType
	Range bool
	Eval  bool
}

func (*MethodOptions) ArgsLength 

func (m *MethodOptions) ArgsLength() (res uint32)

type MethodType 

type MethodType uint
const (
	FUNCTION MethodType = iota
	COMMAND
	AUTOCOMMAND
)

type NewAsyncDecoder 

type NewAsyncDecoder func() AsyncDecoder

type NewAsyncDecoderOptions 

type NewAsyncDecoderOptions struct {
	NewAsyncDecoder
	*MethodOptions
}

type NewSyncDecoder 

type NewSyncDecoder func() SyncDecoder

type NewSyncDecoderOptions 

type NewSyncDecoderOptions struct {
	NewSyncDecoder
	*MethodOptions
}

type NilDeocdable 

type NilDeocdable struct{}

func (*NilDeocdable) DecodeMsg 

func (n *NilDeocdable) DecodeMsg(r *msgp.Reader) error

type Plugin 

type Plugin interface {
	Init(*Client, Logger) error
	Shutdown() error
}

Plugin is the interface implemented by writers of Neovim plugins using the neovim package

type Range 

type Range struct {
	StartLine, EndLine int
}

func (*Range) DecodeMsg 

func (z *Range) DecodeMsg(dc *msgp.Reader) (err error)

DecodeMsg implements msgp.Decodable

func (Range) EncodeMsg 

func (z Range) EncodeMsg(en *msgp.Writer) (err error)

EncodeMsg implements msgp.Encodable

func (Range) MarshalMsg 

func (z Range) MarshalMsg(b []byte) (o []byte, err error)

MarshalMsg implements msgp.Marshaler

func (Range) Msgsize 

func (z Range) Msgsize() (s int)

func (*Range) UnmarshalMsg 

func (z *Range) UnmarshalMsg(bts []byte) (o []byte, err error)

UnmarshalMsg implements msgp.Unmarshaler

type RequestHandler 

type RequestHandler func([]interface{}) ([]interface{}, error)

RequestHandler is the type signature of callback handlers used in RegisterRequestHandler

type StdWrapper 

type StdWrapper struct {
	Stdin  io.WriteCloser
	Stdout io.ReadCloser
}

StdWrapper is a wrapper around two io.WriterCloser and io.ReadCloser instances that exposes itself as an io.ReadWriteCloser. Typically used with os.Stdin and os.Stdout or their pipe equivalents

func (*StdWrapper) Close 

func (s *StdWrapper) Close() error

func (*StdWrapper) Read 

func (s *StdWrapper) Read(p []byte) (n int, err error)

func (*StdWrapper) Write 

func (s *StdWrapper) Write(p []byte) (n int, err error)

type SyncDecoder 

type SyncDecoder interface {
	CallArgs
	SyncRunner
	Results() msgp.Encodable
}

type SyncRunner 

type SyncRunner interface {
	Run() (error, error)
}

type Tabpage 

type Tabpage struct {
	ID uint8
	// contains filtered or unexported fields
}

Tabpage represents a Neovim Tabpage

Multiple goroutines may invoke methods on a Tabpage simultaneously

func (*Tabpage) ExtensionType 

func (b *Tabpage) ExtensionType() int8

func (*Tabpage) GetVar 

func (t *Tabpage) GetVar(name string) (interface{}, error)

GetVar waiting for documentation from Neovim

func (*Tabpage) GetWindow 

func (t *Tabpage) GetWindow() (Window, error)

GetWindow waiting for documentation from Neovim

func (*Tabpage) GetWindows 

func (t *Tabpage) GetWindows() ([]Window, error)

GetWindows waiting for documentation from Neovim

func (*Tabpage) IsValid 

func (t *Tabpage) IsValid() (bool, error)

IsValid waiting for documentation from Neovim

func (*Tabpage) Len 

func (b *Tabpage) Len() int

func (*Tabpage) MarshalBinaryTo 

func (b *Tabpage) MarshalBinaryTo(buf []byte) error

func (*Tabpage) SetVar 

func (t *Tabpage) SetVar(name string, value interface{}) (interface{}, error)

SetVar waiting for documentation from Neovim

func (*Tabpage) UnmarshalBinary 

func (b *Tabpage) UnmarshalBinary(buf []byte) error

type Window 

type Window struct {
	ID uint8
	// contains filtered or unexported fields
}

Window represents a Neovim Window

Multiple goroutines may invoke methods on a Window simultaneously

func (*Window) ExtensionType 

func (b *Window) ExtensionType() int8

func (*Window) GetBuffer 

func (w *Window) GetBuffer() (Buffer, error)

GetBuffer waiting for documentation from Neovim

func (*Window) GetCursor 

func (w *Window) GetCursor() ([]int, error)

GetCursor waiting for documentation from Neovim

func (*Window) GetHeight 

func (w *Window) GetHeight() (int, error)

GetHeight waiting for documentation from Neovim

func (*Window) GetOption 

func (w *Window) GetOption(name string) (interface{}, error)

GetOption waiting for documentation from Neovim

func (*Window) GetPosition 

func (w *Window) GetPosition() ([]int, error)

GetPosition waiting for documentation from Neovim

func (*Window) GetTabpage 

func (w *Window) GetTabpage() (Tabpage, error)

GetTabpage waiting for documentation from Neovim

func (*Window) GetVar 

func (w *Window) GetVar(name string) (interface{}, error)

GetVar waiting for documentation from Neovim

func (*Window) GetWidth 

func (w *Window) GetWidth() (int, error)

GetWidth waiting for documentation from Neovim

func (*Window) IsValid 

func (w *Window) IsValid() (bool, error)

IsValid waiting for documentation from Neovim

func (*Window) Len 

func (b *Window) Len() int

func (*Window) MarshalBinaryTo 

func (b *Window) MarshalBinaryTo(buf []byte) error

func (*Window) SetCursor 

func (w *Window) SetCursor(pos []int) error

SetCursor waiting for documentation from Neovim

func (*Window) SetHeight 

func (w *Window) SetHeight(height int) error

SetHeight waiting for documentation from Neovim

func (*Window) SetOption 

func (w *Window) SetOption(name string, value interface{}) error

SetOption waiting for documentation from Neovim

func (*Window) SetVar 

func (w *Window) SetVar(name string, value interface{}) (interface{}, error)

SetVar waiting for documentation from Neovim

func (*Window) SetWidth 

func (w *Window) SetWidth(width int) error

SetWidth waiting for documentation from Neovim

func (*Window) UnmarshalBinary 

func (b *Window) UnmarshalBinary(buf []byte) error

Source Files

View all Source files

Directories

Path Synopsis
cmd
gen_neovim_api
neovim-go-plugin-manager
template
syncmap

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.