Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/michaelb/sniprun
A neovim plugin to run lines/blocs of code (independently of the rest of the file), supporting multiples languages
https://github.com/michaelb/sniprun
code code-runner compiled-language hacktoberfest interpreted-language interpreter languages lua neovim neovim-plugin partial-evaluators plugin runner rust
Last synced: about 2 months ago
JSON representation
A neovim plugin to run lines/blocs of code (independently of the rest of the file), supporting multiples languages
- Host: GitHub
- URL: https://github.com/michaelb/sniprun
- Owner: michaelb
- License: mit
- Created: 2020-08-17T20:44:45.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-03-24T16:26:14.000Z (2 months ago)
- Last Synced: 2024-03-25T17:16:05.634Z (2 months ago)
- Topics: code, code-runner, compiled-language, hacktoberfest, interpreted-language, interpreter, languages, lua, neovim, neovim-plugin, partial-evaluators, plugin, runner, rust
- Language: Rust
- Homepage:
- Size: 13.9 MB
- Stars: 1,325
- Watchers: 7
- Forks: 45
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Lists
- awesome-neovim - michaelb/sniprun - Run parts of code of any language directly from Neovim. (Code Runner / Quickfix)
- awesome-stars - michaelb/sniprun - A neovim plugin to run lines/blocs of code (independently of the rest of the file), supporting multiples languages (Rust)
- awesome-stars - michaelb/sniprun - A neovim plugin to run lines/blocs of code (independently of the rest of the file), supporting multiples languages (Rust)
- awesome-stars - michaelb/sniprun - A neovim plugin to run lines/blocs of code (independently of the rest of the file), supporting multiples languages (Rust)
- awesome-stars - michaelb/sniprun - A neovim plugin to run lines/blocs of code (independently of the rest of the file), supporting multiples languages (Rust)
- awesome-stars - sniprun
- awesome-neovim - michaelb/sniprun - Run parts of code of any language directly from Neovim. (Code Runner / Quickfix)
- awesome-stars - michaelb/sniprun - A neovim plugin to run lines/blocs of code (independently of the rest of the file), supporting multiples languages (Rust)
- awesome-neovim - michaelb/sniprun - Run parts of code of any language directly from Neovim. (Code Runner / Quickfix)
README
# Introduction
Sniprun is a code runner plugin for neovim written in Lua and Rust. It aims to provide stupidly fast partial code testing for interpreted **and compiled** [languages](https://michaelb.github.io/sniprun/sources/README.html#support-levels-and-languages). Sniprun blurs the line between standard save/run workflow, jupyter-like notebook, and REPL/interpreters.TLDR: `Plug 'michaelb/sniprun', {'do': 'sh install.sh'}`, `:SnipRun`, `:'<,'>SnipRun`, `:SnipInfo`
# Installation, configuration, ...
See [installation instructions](https://michaelb.github.io/sniprun/sources/README.html#installation), [configuration tips](https://michaelb.github.io/sniprun/sources/README.html#configuration), [usage explanations](https://michaelb.github.io/sniprun/sources/README.html#usage) and much more useful information on the [WIKI](https://michaelb.github.io/sniprun/).
## Demos
##### Send to Sniprun snippets of any language.
A very simple example (in C), play the .gif and look in the command area:![](ressources/visual_assets/demo_c.gif)
##### The result can be returned in multiple (even at the same time) ways:
[Classic](ressources/display_classic.md)| [Virtual Text](ressources/display_virtualtext.md)
:------------------------------------------:|:------------------:
![](ressources/visual_assets/classic.png) | ![](ressources/visual_assets/virtual_text.png)
[**Temporary Floating Window**](ressources/display_floating_window.md) | [**Terminal**](ressources/display_terminal.md)
![](ressources/visual_assets/floating_window.png) | ![](ressources/visual_assets/terminal.png)
[**Notification**](ressources/display_notify.md) | [**API**](API.md)
![](ressources/visual_assets/nvimnotify.png) | ![](ressources/visual_assets/api.png)##### REPL-like behavior is available for some languages
Python, Julia, Lua, JavaScript & Typescript (via deno), Clojure, R, Mathematica, Sage, coming soon for many other interpreted (and compiled) languages.
With [REPL-like behavior](https://michaelb.github.io/sniprun/sources/README.html#repl-like-behavior), you can run code dependent on previously executed code, just like in a REPL, from within your favorite editor.![](ressources/visual_assets/760091.png)
## Features
**Sniprun is** a way to quickly run small snippets of code, on the fly, and iterate very quickly and conveniently. To learn a language, to quickly experiment with new features (not yet embedded in classes or a whole project etc...), or to develop simple code pipelines (like a machine learning exercise) that fit in a unique file, sniprun is probably _the_ best plugin out there.
As a matter of proof, Sniprun :
- Officially supports [all these languages (compiled & interpreted)](https://michaelb.github.io/sniprun/sources/README.html#support-levels-and-languages), and virtually [any language](https://michaelb.github.io/sniprun/sources/interpreters/Generic.html#community-examples-for-non-officially-supported-languages)
- can create and connect to REPLs in order to present an interactive and playful interface
- can run things like GUI plots, networks requests or even Ansible playbooks
- doesn't require even one line of configuration by default (but can be customized up to the tiniest things)
- can run code from a part of a file which isn't complete / contains errors
- can automatically fetch (in some languages) the `imports` necessary for your code snippet
- can run [live](https://michaelb.github.io/sniprun/sources/README.html#live-mode) (at every keystroke)
- lends itself to easy [mappings](https://michaelb.github.io/sniprun/sources/README.html#mappings-recommandations) and Vim motions
- has an API (for running code, and displaying results)
- has many result display modes that can be enabled at the same time, and for different output status if wanted
- supports literate programming in Markdown, Orgmode and Neorg## Known limitations
Due to its nature, Sniprun may have trouble with programs that :
- Mess with standard output / stderr
- Need to read from stdin
- Access files; sniprun does not run in a virtual environment, it accesses files just like your own code do, but since it does not run the whole program, something might go wrong. **Relative paths may cause issues**, as the current working directory for sniprun will be somewhere in ~/.cache/sniprun, and relative imports may miss.
- No support for Windows
- NixOS, MacOS users have to compile sniprun locally. Sniprun has not been tested on other Unixes## Changelog
It's been quite a journey already! For history fans, see the [full changelog](CHANGELOG.md).
## Contributing
Sniprun has been made contributor-friendly (see [CONTRIBUTING.md](CONTRIBUTING.md)), so it's relatively easy to create / fix interpreters for any language. But any (constructive) issue, discussion, or doc Pull Request is a welcome form of contribution !