Neovim.Plugin

Documentation

startPluginThreads :: Config StartupConfig () -> [Neovim StartupConfig () NeovimPlugin] -> IO (Either Doc ([FunctionMapEntry], [ThreadId]))

type StartupConfig = StartupConfig NeovimConfig

wrapPlugin :: Applicative m => Plugin r st -> m NeovimPlugin

Wrap a Plugin in some nice blankets, so that we can put them in a simple list.

data NeovimPlugin

Plugin values are wraped inside this data type via wrapPlugin so that we can put plugins in an ordinary list.

data Plugin r st

This data type contains meta information for the plugin manager.

Constructors

Plugin

Fields

• exports :: [ExportedFunctionality () ()]
• statefulExports :: [StatefulFunctionality r st]

data Synchronous

This option detemines how neovim should behave when calling some functionality on a remote host.

Constructors

Async

Call the functionality entirely for its side effects and do not wait for it to finish. Calling a functionality with this flag set is completely asynchronous and nothing is really expected to happen. This is why a call like this is called notification on the neovim side of things.

Sync

Call the function and wait for its result. This is only synchronous on the neovim side. This means that the GUI will (probably) not allow any user input until a reult is received.

Instances

Enum Synchronous

Methods

succ :: Synchronous -> Synchronous

pred :: Synchronous -> Synchronous

toEnum :: Int -> Synchronous

fromEnum :: Synchronous -> Int

enumFrom :: Synchronous -> [Synchronous]

enumFromThen :: Synchronous -> Synchronous -> [Synchronous]

enumFromTo :: Synchronous -> Synchronous -> [Synchronous]

enumFromThenTo :: Synchronous -> Synchronous -> Synchronous -> [Synchronous]

Eq Synchronous

Methods

(==) :: Synchronous -> Synchronous -> Bool

(/=) :: Synchronous -> Synchronous -> Bool

Ord Synchronous

Methods

compare :: Synchronous -> Synchronous -> Ordering

(<) :: Synchronous -> Synchronous -> Bool

(<=) :: Synchronous -> Synchronous -> Bool

(>) :: Synchronous -> Synchronous -> Bool

(>=) :: Synchronous -> Synchronous -> Bool

max :: Synchronous -> Synchronous -> Synchronous

min :: Synchronous -> Synchronous -> Synchronous

Read Synchronous

Methods

readsPrec :: Int -> ReadS Synchronous

readList :: ReadS [Synchronous]

readPrec :: ReadPrec Synchronous

readListPrec :: ReadPrec [Synchronous]

Show Synchronous

Methods

showsPrec :: Int -> Synchronous -> ShowS

show :: Synchronous -> String

showList :: [Synchronous] -> ShowS

IsString Synchronous

Methods

fromString :: String -> Synchronous

Generic Synchronous

Associated Types

type Rep Synchronous :: * -> *

Methods

from :: Synchronous -> Rep Synchronous x

to :: Rep Synchronous x -> Synchronous

Pretty Synchronous

Methods

pretty :: Synchronous -> Doc

prettyList :: [Synchronous] -> Doc

NFData Synchronous

Methods

rnf :: Synchronous -> ()

NvimObject Synchronous

Methods

toObject :: Synchronous -> Object

fromObjectUnsafe :: Object -> Synchronous

fromObject :: Object -> Either Doc Synchronous

fromObject' :: MonadBase IO io => Object -> io Synchronous

type Rep Synchronous

type Rep Synchronous = D1 (MetaData "Synchronous" "Neovim.Plugin.Classes" "nvim-hs-0.2.4-G9jmJ1QHzABI03r78HiAhv" False) ((:+:) (C1 (MetaCons "Async" PrefixI False) U1) (C1 (MetaCons "Sync" PrefixI False) U1))

data CommandOption

Options for commands.

Some command can also be described by using the OverloadedString extensions. This means that you can write a literal String inside your source file in place for a CommandOption value. See the documentation for each value on how these strings should look like (Both versions are compile time checked.)

Constructors

CmdSync Synchronous

Stringliteral "sync" or "async"

CmdRegister

Register passed to the command.

Stringliteral: "\""

CmdNargs String

Command takes a specific amount of arguments

Automatically set via template haskell functions. You really shouldn't use this option yourself unless you have to.

CmdRange RangeSpecification

Determines how neovim passes the range.

Stringliterals: "%" for WholeFile, "," for line and ",123" for 123 lines.

CmdCount Word

Command handles a count. The argument defines the default count.

Stringliteral: string of numbers (e.g. "132")

CmdBang

Command handles a bang

Stringliteral: "!"

Instances

Eq CommandOption

Methods

(==) :: CommandOption -> CommandOption -> Bool

(/=) :: CommandOption -> CommandOption -> Bool

Ord CommandOption

Methods

compare :: CommandOption -> CommandOption -> Ordering

(<) :: CommandOption -> CommandOption -> Bool

(<=) :: CommandOption -> CommandOption -> Bool

(>) :: CommandOption -> CommandOption -> Bool

(>=) :: CommandOption -> CommandOption -> Bool

max :: CommandOption -> CommandOption -> CommandOption

min :: CommandOption -> CommandOption -> CommandOption

Read CommandOption

Methods

readsPrec :: Int -> ReadS CommandOption

readList :: ReadS [CommandOption]

readPrec :: ReadPrec CommandOption

readListPrec :: ReadPrec [CommandOption]

Show CommandOption

Methods

showsPrec :: Int -> CommandOption -> ShowS

show :: CommandOption -> String

showList :: [CommandOption] -> ShowS

IsString CommandOption

Methods

fromString :: String -> CommandOption

Generic CommandOption

Associated Types

type Rep CommandOption :: * -> *

Methods

from :: CommandOption -> Rep CommandOption x

to :: Rep CommandOption x -> CommandOption

Pretty CommandOption

Methods

pretty :: CommandOption -> Doc

prettyList :: [CommandOption] -> Doc

NFData CommandOption

Methods

rnf :: CommandOption -> ()

type Rep CommandOption

type Rep CommandOption = D1 (MetaData "CommandOption" "Neovim.Plugin.Classes" "nvim-hs-0.2.4-G9jmJ1QHzABI03r78HiAhv" False) ((:+:) ((:+:) (C1 (MetaCons "CmdSync" PrefixI False) (S1 (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 Synchronous))) ((:+:) (C1 (MetaCons "CmdRegister" PrefixI False) U1) (C1 (MetaCons "CmdNargs" PrefixI False) (S1 (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 String))))) ((:+:) (C1 (MetaCons "CmdRange" PrefixI False) (S1 (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 RangeSpecification))) ((:+:) (C1 (MetaCons "CmdCount" PrefixI False) (S1 (MetaSel (Nothing Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 Word))) (C1 (MetaCons "CmdBang" PrefixI False) U1))))

addAutocmd

Arguments

:: ByteString

The event to register to (e.g. BufWritePost)

-> AutocmdOptions

-> Neovim r st ()

Fully applied function to register

-> Neovim r st (Maybe (Either (Neovim anyR anySt ()) ReleaseKey))

A ReleaseKey if the registration worked

Register an autocmd in the current context. This means that, if you are currently in a stateful plugin, the function will be called in the current thread and has access to the configuration and state of this thread. If you need that information, but do not want to block the other functions in this thread, you have to manually fork a thread and make the state you need available there. If you don't care abou the state (or your function has been appield to all the necessary state (e.g. a TVar to share the rusult), then you can also call addAutocmd' which will register a stateless function that only interacts with other threads by means of concurrency abstractions.

Note that the function you pass must be fully applied.

Note beside: This function is equivalent to addAutocmd' if called from a stateless plugin thread.

addAutocmd' :: ByteString -> AutocmdOptions -> Neovim' () -> Neovim r st (Maybe ReleaseKey)

Add a stateless autocmd.

See addAutocmd for more details.

registerInStatelessContext :: (FunctionMapEntry -> Neovim r st ()) -> FunctionalityDescription -> ([Object] -> Neovim' Object) -> Neovim r st (Maybe FunctionMapEntry)

Register a functoinality in a stateless context.

registerInStatefulContext :: (FunctionMapEntry -> Neovim r st ()) -> FunctionalityDescription -> ([Object] -> Neovim r st Object) -> TQueue SomeMessage -> TVar (Map FunctionName ([Object] -> Neovim r st Object)) -> Neovim r st (Maybe FunctionMapEntry)