nvim-live-runner 🚀

A simple, real-time code runner for Neovim that gives you instant feedback on your code. Write your code and see the results live, right in your editor!

This plugin is in its early stages.

✨ Features

• Live Feedback: Get instant results from your code as you type.
• Simple & Lightweight: No complex setup. Just install and go.
• Go-powered Backend: A fast and reliable backend server to execute your code.

🌍 Supported Languages

• Python (.py)
• Go (.go)
• Lua (.lua)
• JavaScript (.js)

✅ Requirements

• Go (v1.18 or higher) must be installed on your system for the backend server.
• Lua (v5.1 or higher) must be installed on your system for running Lua code.
• Node.js (v16 or higher) must be installed on your system for running JavaScript code.
• Neovim >= 0.7

📦 Installation

Install with your favorite plugin manager.

lazy.nvim

return {
    "shadowmkj/nvim-live-runner",
    build = "cd src && go build -o server", -- This compiles the binary on install
    config = function()
        require("live-runner").setup({})
    end,
}

packer.nvim

use {
    "shadowmkj/nvim-live-runner",
    run = "cd src && go build -o server",
    config = function()
        require("live-runner").setup({})
    end,
}

🚀 Usage

To start the live runner:

1. Open a Python file (.py), Go file (.go), Lua file (.lua), or JavaScript file (.js).
2. Run the command :LiveRun.
3. This will open a new split window to show the output of your code.
4. Start coding! Any changes you make will be executed automatically, and the output window will update in real-time.

To stop the live runner:

• Run the command :LiveRun stop to stop the server and close the output window.

⚙️ Configuration

You can pass a configuration table to the setup() function. Here are the default values:

require("live-runner").setup({
    port = 65432, -- The port for the server to listen on
    bin_path = nil, -- Path to the server binary. Defaults to the one built by the plugin.
})

🛣️ Roadmap

• Support for more languages (Ruby, Typescript, Perl etc.)
• More robust error handling.
• Customizable output window layout.

❤️ Contributing

Contributions, issues, and feature requests are welcome!

---

Made with ❤️ by shadowmkj