Neovim.Context.Internal

To shorten function and data type names, import this qualfied as Internal.

Documentation

newtype Neovim env a

This is the environment in which all plugins are initially started.

Functions have to run in this transformer stack to communicate with neovim. If parts of your own functions dont need to communicate with neovim, it is good practice to factor them out. This allows you to write tests and spot errors easier. Essentially, you should treat this similar to IO in general haskell programs.

Constructors

Neovim

Fields

• unNeovim :: ResourceT (ReaderT (Config env) IO) a

Instances

MonadReader env (Neovim env)

User facing instance declaration for the reader state.

Methods

ask :: Neovim env env

local :: (env -> env) -> Neovim env a -> Neovim env a

reader :: (env -> a) -> Neovim env a

Monad (Neovim env)

Methods

(>>=) :: Neovim env a -> (a -> Neovim env b) -> Neovim env b

(>>) :: Neovim env a -> Neovim env b -> Neovim env b

return :: a -> Neovim env a

fail :: String -> Neovim env a

Functor (Neovim env)

Methods

fmap :: (a -> b) -> Neovim env a -> Neovim env b

(<$) :: a -> Neovim env b -> Neovim env a

Applicative (Neovim env)

Methods

pure :: a -> Neovim env a

(<*>) :: Neovim env (a -> b) -> Neovim env a -> Neovim env b

liftA2 :: (a -> b -> c) -> Neovim env a -> Neovim env b -> Neovim env c

(*>) :: Neovim env a -> Neovim env b -> Neovim env b

(<*) :: Neovim env a -> Neovim env b -> Neovim env a

MonadIO (Neovim env)

Methods

liftIO :: IO a -> Neovim env a

MonadUnliftIO (Neovim env)

Methods

askUnliftIO :: Neovim env (UnliftIO (Neovim env))

withRunInIO :: ((forall a. Neovim env a -> IO a) -> IO b) -> Neovim env b

MonadResource (Neovim env)

Methods

liftResourceT :: ResourceT IO a -> Neovim env a

MonadThrow (Neovim env)

Methods

throwM :: Exception e => e -> Neovim env a

ask' :: Neovim env (Config env)

Same as ask for the InternalConfig.

asks' :: (Config env -> a) -> Neovim env a

Same as asks for the InternalConfig.

exceptionHandlers :: [Handler IO (Either (Doc ann) a)]

runNeovim :: NFData a => Config env -> Neovim env a -> IO (Either (Doc AnsiStyle) a)

Initialize a Neovim context by supplying an InternalEnvironment.

runNeovimInternal :: (a -> IO a) -> Config env -> Neovim env a -> IO (Either (Doc AnsiStyle) a)

newUniqueFunctionName :: Neovim env FunctionName

Create a new unique function name. To prevent possible name clashes, digits are stripped from the given suffix.

newtype FunctionType

This data type is used to dispatch a remote function call to the appopriate recipient.

Constructors

Stateful (TQueue SomeMessage)

Stateful functions are handled within a special thread, the TQueue is the communication endpoint for the arguments we have to pass.

Instances

Pretty FunctionType

Methods

pretty :: FunctionType -> Doc ann

prettyList :: [FunctionType] -> Doc ann

type FunctionMapEntry = (FunctionalityDescription, FunctionType)

Type of the values stored in the function map.

type FunctionMap = Map FunctionName FunctionMapEntry

A function map is a map containing the names of functions as keys and some context dependent value which contains all the necessary information to execute that function in the intended way.

This type is only used internally and handles two distinct cases. One case is a direct function call, wich is simply a function that accepts a list of Object values and returns a result in the Neovim context. The second case is calling a function that has a persistent state. This is mediated to a thread that reads from a TQueue. (NB: persistent currently means, that state is stored for as long as the plugin provider is running and not restarted.)

mkFunctionMap :: [FunctionMapEntry] -> FunctionMap

Create a new function map from the given list of FunctionMapEntry values.

data Config env

A wrapper for a reader value that contains extra fields required to communicate with the messagepack-rpc components and provide necessary data to provide other globally available operations.

Note that you most probably do not want to change the fields prefixed with an underscore.

Constructors

Config

Fields

• eventQueue :: TQueue SomeMessage

  A queue of messages that the event handler will propagate to appropriate threads and handlers.

• transitionTo :: MVar StateTransition

  The main thread will wait for this MVar to be filled with a value and then perform an action appropriate for the value of type StateTransition.

• providerName :: TMVar (Either String Int)

  Since nvim-hs must have its Neovim.RPC.SocketReader and Neovim.RPC.EventHandler running to determine the actual channel id (i.e. the Int value here) this field can only be set properly later. Hence, the value of this field is put in an TMVar. Name that is used to identify this provider. Assigning such a name is done in the neovim config (e.g. ~/.nvim/nvimrc).

• uniqueCounter :: TVar Integer

  This TVar is used to generate uniqe function names on the side of nvim-hs. This is useful if you don't want to overwrite existing functions or if you create autocmd functions.

• globalFunctionMap :: TMVar FunctionMap

  This map is used to dispatch received messagepack function calls to it's appropriate targets.

• pluginSettings :: Maybe (PluginSettings env)

  In a registered functionality this field contains a function (and possibly some context dependent values) to register new functionality.

• customConfig :: env

  Plugin author supplyable custom configuration. Queried on the user-facing side with ask or asks.

retypeConfig :: env -> Config anotherEnv -> Config env

Convenient helper to create a new config for the given state and read-only config.

Sets the pluginSettings field to Nothing.

data PluginSettings env where

This GADT is used to share information between stateless and stateful plugin threads since they work fundamentally in the same way. They both contain a function to register some functionality in the plugin provider as well as some values which are specific to the one or the other context.

Constructors

StatefulSettings :: (FunctionalityDescription -> ([Object] -> Neovim env Object) -> TQueue SomeMessage -> TVar (Map FunctionName ([Object] -> Neovim env Object)) -> Neovim env (Maybe FunctionMapEntry)) -> TQueue SomeMessage -> TVar (Map FunctionName ([Object] -> Neovim env Object)) -> PluginSettings env

newConfig :: IO (Maybe String) -> IO env -> IO (Config env)

Create a new InternalConfig object by providing the minimal amount of necessary information.

This function should only be called once per nvim-hs session since the arguments are shared across processes.

data StateTransition

The state that the plugin provider wants to transition to.

Constructors

Quit

Quit the plugin provider.

Restart

Restart the plugin provider.

Failure (Doc AnsiStyle)

The plugin provider failed to start or some other error occured.

InitSuccess

The plugin provider started successfully.

Instances

Show StateTransition

Methods

showsPrec :: Int -> StateTransition -> ShowS

show :: StateTransition -> String

showList :: [StateTransition] -> ShowS