A blazing-fast Neovim code runner plugin for executing code snippets directly from your editor.

• Multi-language support: C++, JavaScript, Python
• Smart selection: Runs the code block you heroically selected, or just bulldozes through the whole buffer if you forgot to select anything. Because who needs precision anyway?
• Beautiful UI: Output floating window with mesmerizing markdown rendering
• Asynchronous execution: Non-blocking code execution
• Clean: Just forget about temp file storage, you're sorted!

The interpreters/executables must be available on your path.

• Neovim >= 0.8.0
• Node.js (for JavaScript)
• Python (for Python)

• Cling - C++ interpreter for REPL-like experience

> Installation methods may vary by platform. For the most accurate and up-to-date instructions, please refer to the official sources:
> https://root.cern/install/

{
  'jignesh119/FlashRunner.nvim',
  config = function()
    require('FlashRunner').setup()
  end
}

use {
  'jignesh119/FlashRunner.nvim',
  config = function()
    require('FlashRunner').setup()
  end
}

Plug 'jignesh119/FlashRunner.nvim'

Then add to your init.lua:

require('FlashRunner').setup()

require('FlashRunner').setup({
  keymap = "<leader>Fr", -- Default keymap for visual mode execution
})

1. Select code in visual mode (v, V, or Ctrl+v)
2. Press the keymap (default: <leader>Fr)
3. View results in the floating window
4. Press q to close the output window

:FlashRunnerShow

1. Clone the repository:

   git clone https://github.com/jignesh119/FlashRunner.nvim.git
   cd FlashRunner.nvim

2. Make the shell script executable:

   chmod +x lua/FlashRunner/cling-runner.sh

3. Install development dependencies:

   # Install required interpreters
   sudo apt-get install nodejs python3 cling  # Ubuntu/Debian
   # OR
   brew install node python cling             # macOS

4. Link/Register plugin for development: you can load the plugin from a local directory using your plugin manager.

   Using lazy.nvim

return {
    dir = "/absolute/path/to/FlashRunner.nvim",
    config = function()
        require("FlashRunner").setup()
    end,
}

then sync to install/ register the plugin in neovim

:Lazy sync

then upon each update you may want to reload plugin

:Lazy reload FlashRunner

Follow this Blog post to understand how to build your neovim own plugin Dev.to step-by-step guide

1. "No valid executor for this language"

   • We currently support C++, JavaScript, Python
   • Ensure the file has the correct filetype (:set filetype?)
   • Verify language support in selection.lua

2. C++ execution fails

   • Install Cling interpreter
   • Check if cling-runner.sh is executable
   • Verify the script path in configuration

3. JavaScript/Python execution fails

   • Ensure Node.js/Python is installed and in PATH
   • Test with node --version or python --version

4. Floating window doesn't appear

   • Check for errors with :messages
   • Ensure Neovim version >= 0.8.0

• RPC Integration: Handle interpretation in different programming languages
• TypeScript Support: Add ts-node executor
• More Languages: Rust, Go, Lua, PHP support
• Configuration UI: Interactive setup and language configuration
• Execution History: Save and replay previous executions
• Custom Executors: User-defined execution commands
• Integration: LSP integration for better error reporting

• Heavily inspired by none other than teej (nvim gawd)

P.S AI assited in writing this readme