Context switch plugin for xplr

Saves and loads 10 contexts, incl. focused node, sorters & filters.
Presents to the user a vertically split layout with a file system on the top and a panel with contexts list. Not initialized contexts have '?' as their path. Current context is marked by '->'.
Please note, this is a context switch and not a bookmarking plugin, hence every time you open this mode, the stored information for the current context will be changed (current working directory, focused node, sorters & filters).
Upon quitting xplr the contexts will be cleared.

Keybindings

Installation

• Add the following line in ~/.config/xplr/init.lua

  local home = os.getenv("HOME")
  package.path = home
  .. "/.config/xplr/plugins/?/init.lua;"
  .. home
  .. "/.config/xplr/plugins/?.lua;"
  .. package.path

• Clone the plugin

  mkdir -p ~/.config/xplr/plugins
  
  git clone https://github.com/igorepst/context-switch.xplr ~/.config/xplr/plugins/context-switch

• Require the module in ~/.config/xplr/init.lua

  require("context-switch").setup()

Arguments

The plugin supports passing multiple arguments to setup function

• mode: xplr mode ('default' if absent)
• key: keybinding to switch to context mode ('ctrl-s' if absent)
• layout_height: the height in percents of the context switch window (a number between 1-99, default - 32)
• layout: custom layout to show as a table (empty or csw.builtin_layouts.default; csw.builtin_layouts.without_help; any other that may include csw.default_custom_content in it - see the source code)

Features

• Save current focus, sort & filter

• Get current context number (use get_current_context_num())
  Example:

    local csw = require('context-switch')
    csw.setup()
    xplr.fn.custom.render_context_num = function(ctx)
      return {
        CustomParagraph = {
          ui = {
            title = { format = 'Ctx' } 
          },
          body = '  ' .. tostring(csw.get_current_context_num())
        }
      }
    end
    -- and then somewhere in your layout use
    {
      Dynamic = 'custom.render_context_num'
    }

• Get raw context info (use get_contexts)
  Example:

    local csw = require('context-switch')
    csw.setup()
    -- Shows a box of the numbers of active contexts in numerical order
    xplr.fn.custom.render_active_context_nums = function(ctx)
      local res = ''
      local contexts = csw.get_contexts()
      for i = 1, 10 do
        local index = i   1
        -- Context 0 will be shown as '10'
        if i == 10 then
          index = 1
        end
        -- If context is not empty, append its number to result with a space
        if next(contexts[index]) ~= nil then
          res = res .. tostring(i) .. ' '
        end
      end
      return {
        CustomParagraph = {
          ui = {
            title = { format = 'Contexts' }
          },
          body = res
        }
      }
    end
    -- and then somewhere in your layout use
    {
      Dynamic = 'custom.render_active_context_nums'
    }