Begin conversion to OO-centered programming
parent
f2bc648405
commit
41564fa9f3
@ -0,0 +1,313 @@
|
||||
--[[
|
||||
/*
|
||||
* IMPORTS
|
||||
*/
|
||||
--]]
|
||||
|
||||
local globals = require('libmodal/src/globals')
|
||||
local utils = require('libmodal/src/utils')
|
||||
local Vars = require('libmodal/src/Vars')
|
||||
|
||||
local api = utils.api
|
||||
|
||||
--[[
|
||||
/*
|
||||
* MODULE
|
||||
*/
|
||||
--]]
|
||||
|
||||
-- Public interface for this module.
|
||||
local Mode = {}
|
||||
|
||||
-- Private class.
|
||||
local _modeMetaTable = {}
|
||||
|
||||
_modeMetaTable.ParseTable = require('libmodal/src/mode/ParseTable')
|
||||
|
||||
local _HELP = '?'
|
||||
local _TIMEOUT = {
|
||||
CHAR = 'ø',
|
||||
NR = string.byte(_TIMEOUT.CHAR),
|
||||
LEN = api.nvim_get_option('timeoutlen'),
|
||||
SEND = function(__self)
|
||||
api.nvim_feedkeys(__self.CHAR, '', false)
|
||||
end
|
||||
}
|
||||
|
||||
--[[
|
||||
/*
|
||||
* META `_modeMetaTable`
|
||||
*/
|
||||
--]]
|
||||
|
||||
----------------------------------------
|
||||
--[[ SUMMARY:
|
||||
* Reset libmodal's internal counter of user input to default.
|
||||
]]
|
||||
----------------------------------------
|
||||
function _modeMetaTable:clearInputBytes()
|
||||
self._inputBytes = {}
|
||||
end
|
||||
|
||||
-----------------------------------------------
|
||||
--[[ SUMMARY:
|
||||
* Update the floating window with the latest user input.
|
||||
]]
|
||||
--[[ PARAMS:
|
||||
* `modeName` => the name of the mode.
|
||||
]]
|
||||
-----------------------------------------------
|
||||
function _modeMetaTable:_updateFloatingWindow()
|
||||
local inputChars = {}
|
||||
for _, byte in ipairs(self._inputBytes) do
|
||||
inputChars[#inputChars + 1] = string.char(byte)
|
||||
end
|
||||
api.nvim_buf_set_lines(
|
||||
self._popupBuffer,
|
||||
0, 1, true, {table.concat(inputChars)}
|
||||
)
|
||||
end
|
||||
|
||||
--------------------------------------
|
||||
--[[ SUMMARY:
|
||||
* Parse the `comboDict` and see if there is any command to execute.
|
||||
]]
|
||||
--[[ PARAMS:
|
||||
* `modeName` => the name of the mode that is currently active.
|
||||
]]
|
||||
--------------------------------------
|
||||
function _modeMetaTable:_comboSelect()
|
||||
-- Stop any running timers
|
||||
if self._flushInputTimer then
|
||||
self._flushInputTimer:stop()
|
||||
end
|
||||
|
||||
-- Append the latest input to the locally stored input history.
|
||||
self._inputBytes[#self._inputBytes + 1] = Vars.nvim_get(
|
||||
self._inputBytes, self._modeName
|
||||
)
|
||||
|
||||
-- Get the command based on the users input.
|
||||
local cmd = self._keybindings:get(self._inputBytes)
|
||||
|
||||
-- Get the type of the command.
|
||||
local commandType = type(cmd)
|
||||
local clearInputBytes = false
|
||||
|
||||
-- if there was no matching command
|
||||
if cmd == false then
|
||||
if #self._inputBytes < 2 and self._inputBytes[1] == string.byte(_HELP) then
|
||||
self._help:show()
|
||||
end
|
||||
clearInputBytes = true
|
||||
-- The command was a table, meaning that it MIGHT match.
|
||||
elseif commandType == globals.TYPE_TBL
|
||||
and globals.isTrue(self._timeoutsEnabled)
|
||||
then
|
||||
-- Create a new timer
|
||||
|
||||
-- start the timer
|
||||
self._flushInputTimer:start(
|
||||
_TIMEOUT.LEN, 0, vim.schedule_wrap(function()
|
||||
-- Send input to interrupt a blocking `getchar`
|
||||
_TIMEOUT:SEND()
|
||||
-- if there is a command, execute it.
|
||||
if cmd[self.ParseTable.CR] then
|
||||
api.nvim_command(cmd[self.ParseTable.CR])
|
||||
end
|
||||
-- clear input
|
||||
_clearInputBytes(modeName)
|
||||
_updateFloatingWindow(modeName)
|
||||
end)
|
||||
)
|
||||
-- The command was an actual vim command.
|
||||
else
|
||||
api.nvim_command(cmd)
|
||||
clearInputBytes = true
|
||||
end
|
||||
|
||||
if clearInputBytes then
|
||||
self:_clearInputBytes()
|
||||
end
|
||||
self:_updateFloatingWindow()
|
||||
end
|
||||
|
||||
------------------------------------------------
|
||||
--[[ SUMMARY:
|
||||
* Set the initial values used for parsing user input as combos.
|
||||
]]
|
||||
--[[ PARAMS:
|
||||
* `modeName` => the name of the mode being initialized.
|
||||
* `comboTable` => the table of combos being initialized.
|
||||
]]
|
||||
------------------------------------------------
|
||||
-- TODO
|
||||
local function _initCombos(modeName, comboTable)
|
||||
-- Placeholder for timeout value.
|
||||
local timeoutsEnabled = nil
|
||||
|
||||
-- Read the correct timeout variable.
|
||||
if api.nvim_exists('g', vars.timeouts:name(modeName)) then timeoutsEnabled =
|
||||
vars.nvim_get(vars.timeouts, modeName)
|
||||
else timeoutsEnabled =
|
||||
vars.libmodalTimeouts
|
||||
end
|
||||
|
||||
-- Assign the timeout variable according to `timeoutsEnabled`
|
||||
self._timeoutsEnabled = timeoutsEnabled
|
||||
|
||||
-- create a floating window
|
||||
local buf = api.nvim_create_buf(false, true)
|
||||
vars.buffers.instances[modeName] = buf
|
||||
self._popupWindow = api.nvim_call_function('libmodal#_winOpen', {buf})
|
||||
|
||||
-- Determine if a default `Help` should be created.
|
||||
if not comboTable[_HELP] then
|
||||
vars.help.instances[modeName] = utils.Help.new(comboTable, 'KEY MAP')
|
||||
end
|
||||
|
||||
-- Build the parse tree.
|
||||
vars.combos.instances[modeName] = mode.ParseTable.new(comboTable)
|
||||
|
||||
-- Create a timer
|
||||
self._flushInputTimer = vim.loop.new_timer()
|
||||
|
||||
-- Initialize the input history variable.
|
||||
_clearInputBytes(modeName)
|
||||
end
|
||||
|
||||
-----------------------------------------------------
|
||||
--[[ SUMMARY:
|
||||
* Remove variables used for a mode.
|
||||
]]
|
||||
--[[ PARAMS:
|
||||
* `modeName` => the name of the mode.
|
||||
* `self._winState` => the window state prior to mode activation.
|
||||
]]
|
||||
-----------------------------------------------------
|
||||
function _modeMetaTable:_deconstruct()
|
||||
if self._flushInputTimer:info()['repeat'] ~= 0 then
|
||||
self._flushInputTimer:stop()
|
||||
end
|
||||
|
||||
if self._popupWindow then
|
||||
api.nvim_win_close(self._popupWindow, false)
|
||||
end
|
||||
|
||||
self._winState:restore()
|
||||
|
||||
for k, _ in pairs(self) do
|
||||
self[k] = nil
|
||||
end
|
||||
|
||||
api.nvim_command("mode | echo '' | call garbagecollect()")
|
||||
end
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
--[[ SUMMARY:
|
||||
* Loop an initialized `mode`.
|
||||
]]
|
||||
--[[ PARAMS:
|
||||
* `handleExitEvents` => whether or not to automatically exit on `<Esc>` press.
|
||||
* `indicator` => the indicator for the mode.
|
||||
* `modeInstruction` => the instructions for the mode.
|
||||
* `modeName` => the name of the `mode`.
|
||||
]]
|
||||
--[[ RETURNS:
|
||||
* `boolean` => whether or not the mode should continue
|
||||
]]
|
||||
--------------------------------------------------------------------------------
|
||||
-- TODO
|
||||
local function _modeLoop(handleExitEvents, indicator, modeInstruction, modeName)
|
||||
-- If the mode is not handling exit events automatically and the global exit var is true.
|
||||
if not handleExitEvents and globals.isTrue(
|
||||
vars.nvim_get(vars.exit, modeName)
|
||||
) then return false end
|
||||
|
||||
-- Echo the indicator.
|
||||
api.nvim_lecho(indicator)
|
||||
|
||||
-- Capture input.
|
||||
local userInput = api.nvim_input()
|
||||
|
||||
-- Return if there was a timeout event.
|
||||
if userInput == _TIMEOUT.NR then
|
||||
return true
|
||||
end
|
||||
|
||||
-- Set the global input variable to the new input.
|
||||
vars.nvim_set(vars.input, modeName, userInput)
|
||||
|
||||
-- Make sure that the user doesn't want to exit.
|
||||
if handleExitEvents and userInput == globals.ESC_NR then
|
||||
return false
|
||||
-- If the second argument was a dict, parse it.
|
||||
elseif type(modeInstruction) == globals.TYPE_TBL then
|
||||
_comboSelect(modeName)
|
||||
-- If the second argument was a function, execute it.
|
||||
else modeInstruction() end
|
||||
|
||||
return true
|
||||
end
|
||||
|
||||
------------------------
|
||||
--[[ SUMMARY:
|
||||
* Enter a mode.
|
||||
]]
|
||||
--[[ PARAMS:
|
||||
* `args[1]` => the mode name.
|
||||
* `args[2]` => the mode callback, or mode combo table.
|
||||
* `args[3]` => optional exit supresion flag.
|
||||
]]
|
||||
------------------------
|
||||
-- TODO
|
||||
function _modeMetaTable:enter(...)
|
||||
local args = {...}
|
||||
|
||||
--[[ SETUP. ]]
|
||||
|
||||
-- Create the indicator for the mode.
|
||||
local indicator = utils.Indicator.mode(args[1])
|
||||
|
||||
-- Grab the state of the window.
|
||||
self._winState = utils.WindowState.new()
|
||||
|
||||
-- Convert the name into one that can be used for variables.
|
||||
local modeName = string.lower(args[1])
|
||||
|
||||
-- Determine whether or not this function should handle exiting automatically.
|
||||
local handleExitEvents = true
|
||||
if #args > 2 then
|
||||
handleExitEvents = globals.isFalse(args[3])
|
||||
end
|
||||
|
||||
-- Determine whether a callback was specified, or a combo table.
|
||||
if type(args[2]) == globals.TYPE_TBL then
|
||||
_initCombos(modeName, args[2])
|
||||
end
|
||||
|
||||
--[[ MODE LOOP. ]]
|
||||
local continueMode = true
|
||||
while continueMode == true do
|
||||
-- Try (using pcall) to use the mode.
|
||||
local noErrors = true
|
||||
noErrors, continueMode = pcall(_modeLoop,
|
||||
handleExitEvents, indicator, args[2], modeName
|
||||
)
|
||||
|
||||
-- If there were errors, handle them.
|
||||
if noErrors == false then
|
||||
utils.showError(continueMode)
|
||||
continueMode = false
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
|
||||
--[[
|
||||
/*
|
||||
* PUBLICIZE MODULE
|
||||
*/
|
||||
--]]
|
||||
|
||||
return Mode
|
@ -0,0 +1,81 @@
|
||||
--[[
|
||||
/*
|
||||
* IMPORTS
|
||||
*/
|
||||
--]]
|
||||
|
||||
local globals = require('libmodal/src/globals')
|
||||
local api = vim.api
|
||||
|
||||
--[[
|
||||
/*
|
||||
* MODULE
|
||||
*/
|
||||
--]]
|
||||
|
||||
local Vars = {}
|
||||
|
||||
Vars.libmodalTimeouts = api.nvim_get_var('libmodalTimeouts')
|
||||
|
||||
--[[
|
||||
/*
|
||||
* HELPERS
|
||||
*/
|
||||
--]]
|
||||
|
||||
---------------------------
|
||||
--[[ SUMMARY:
|
||||
* Create a new entry in `Vars`
|
||||
]]
|
||||
--[[ PARAMS:
|
||||
* `keyName` => the name of the key used to refer to this variable in `Vars`.
|
||||
* `varName` => the name of the variable as it is stored in vim.
|
||||
]]
|
||||
---------------------------
|
||||
local function new(keyName)
|
||||
self = {}
|
||||
|
||||
-- Instances of variables pertaining to a certain mode.
|
||||
local varName = 'Mode' .. string.upper(
|
||||
string.sub(keyName, 0, 1)
|
||||
) .. string.sub(keyName, 2)
|
||||
|
||||
-------------------------
|
||||
--[[ SUMMARY:
|
||||
* Get the name of `modeName`s global setting.
|
||||
]]
|
||||
--[[ PARAMS:
|
||||
* `modeName` => the name of the mode.
|
||||
]]
|
||||
-------------------------
|
||||
name = function(modeName)
|
||||
return string.lower(modeName) .. self._varName
|
||||
end
|
||||
|
||||
return self
|
||||
end
|
||||
|
||||
------------------------------------
|
||||
--[[ SUMMARY:
|
||||
* Retrieve a variable value.
|
||||
]]
|
||||
--[[ PARAMS:
|
||||
* `var` => the `Vars.*` table to retrieve the value of.
|
||||
* `modeName` => the mode name this value is being retrieved for.
|
||||
]]
|
||||
------------------------------------
|
||||
function Vars.nvimGet(var, modeName)
|
||||
return api.nvim_get_var(var.name(modeName))
|
||||
end
|
||||
|
||||
function Vars.nvimSet(var, modeName, val)
|
||||
api.nvim_set_var(var.name(modeName), val)
|
||||
end
|
||||
|
||||
--[[
|
||||
/*
|
||||
* PUBLICIZE MODULE
|
||||
*/
|
||||
--]]
|
||||
|
||||
return Vars
|
@ -1,17 +0,0 @@
|
||||
--[[
|
||||
/*
|
||||
* MODULE
|
||||
*/
|
||||
--]]
|
||||
|
||||
local base = {}
|
||||
base.globals = require('libmodal/src/base/globals')
|
||||
|
||||
--[[
|
||||
/*
|
||||
* PUBLICIZE MODULE
|
||||
*/
|
||||
--]]
|
||||
|
||||
return base
|
||||
|
Loading…
Reference in New Issue