3
3
==============================================================================
4
4
Table of Contents *code_runner-table-of-contents*
5
5
6
- - Introduction | code_runner-introduction |
7
- - Requirements | code_runner-requirements |
8
- - Install | code_runner-install |
9
- - Features | code_runner-features |
10
- - Setup | code_runner-setup |
11
- - Commands | code_runner-commands |
12
- - Parameters | code_runner-parameters |
13
- - Hooks | code_runner-hooks |
14
- - Integration with other plugins| code_runner-integration-with-other-plugins |
15
- - Inspirations and thanks | code_runner-inspirations-and-thanks |
16
- - Screenshots | code_runner-screenshots |
17
- - Contributing | code_runner-contributing |
18
- 1. LICENCE | code_runner-licence |
19
- 2. Links | code_runner-links |
20
- Code_Runner Code Runner for Neovim written in pure lua
21
- INTRODUCTION *code_runner-introduction*
6
+ 1. code_runner.nvim | code_runner-code_runner.nvim |
7
+ - Introduction | code_runner-code_runner.nvim-introduction |
8
+ - Requirements | code_runner-code_runner.nvim-requirements |
9
+ - Install | code_runner-code_runner.nvim-install |
10
+ - Features | code_runner-code_runner.nvim-features |
11
+ - Setup | code_runner-code_runner.nvim-setup |
12
+ - Commands | code_runner-code_runner.nvim-commands |
13
+ - Parameters | code_runner-code_runner.nvim-parameters |
14
+ - Hooks | code_runner-code_runner.nvim-hooks |
15
+ - Integration with other plugins| code_runner-code_runner.nvim-integration-with-other-plugins |
16
+ - Inspirations and thanks| code_runner-code_runner.nvim-inspirations-and-thanks |
17
+ - Screenshots | code_runner-code_runner.nvim-screenshots |
18
+ - Contributing | code_runner-code_runner.nvim-contributing |
19
+ - Similar Projects | code_runner-code_runner.nvim-similar-projects |
20
+ 2. LICENCE | code_runner-licence |
21
+ 3. Links | code_runner-links |
22
+
23
+ ==============================================================================
24
+ 1. code_runner.nvim *code_runner-code_runner.nvim*
25
+
26
+ 🏃♂️ Code Runner for Neovim written in pure lua 🌙
27
+
28
+
29
+ INTRODUCTION *code_runner-code_runner.nvim-introduction*
22
30
23
31
When I was still in college it was common to try multiple programming
24
32
languages, at that time I used vscode that with a single plugin allowed me to
@@ -33,18 +41,18 @@ Currently I don’t test many languages anymore and work in the professional
33
41
environment, but this plugin is still my swiss army knife.
34
42
35
43
36
- REQUIREMENTS *code_runner-requirements*
44
+ REQUIREMENTS *code_runner-code_runner.nvim -requirements*
37
45
38
46
- Neovim (>= 0.10)
39
47
40
48
41
- INSTALL *code_runner-install*
49
+ INSTALL *code_runner-code_runner.nvim -install*
42
50
43
51
- With lazy.nvim <https://github.com/folke/lazy.nvim >
44
52
45
53
>lua
46
54
require("lazy").setup({
47
- { "CRAG666/code_runner.nvim",
55
+ { "CRAG666/code_runner.nvim",
48
56
event= "VeryLazy",
49
57
},
50
58
}
@@ -66,7 +74,7 @@ Please see my config code_runner.lua
66
74
<https://github.com/CRAG666/dotfiles/blob/main/config/nvim/lua/plugins/dev/code_runner.lua >
67
75
68
76
69
- FEATURES *code_runner-features*
77
+ FEATURES *code_runner-code_runner.nvim -features*
70
78
71
79
72
80
**Note** If you want implement a new feature open an issue to know if it is
@@ -83,11 +91,11 @@ FEATURES *code_runner-features*
83
91
- Run project commands in different modes for a per projects base
84
92
85
93
86
- SETUP *code_runner-setup*
94
+ SETUP *code_runner-code_runner.nvim -setup*
87
95
88
96
This plugin can be configured either in lua, with the `setup` function, or with
89
- json files for interopability between this plugin and the original code runner
90
- <https://github.com/formulahendry/vscode-code-runner > vscode plugin.
97
+ json files for interoperability between this plugin and the original code
98
+ runner <https://github.com/formulahendry/vscode-code-runner > vscode plugin.
91
99
92
100
93
101
MINIMAL EXAMPLE ~
150
158
<
151
159
152
160
153
- COMMANDS *code_runner-commands*
161
+ COMMANDS *code_runner-code_runner.nvim -commands*
154
162
155
163
156
164
**Note** To check what modes ore supported see | code_runner-mode-parameter | .
@@ -177,7 +185,7 @@ Recommended mappings:
177
185
<
178
186
179
187
180
- PARAMETERS *code_runner-parameters*
188
+ PARAMETERS *code_runner-code_runner.nvim -parameters*
181
189
182
190
183
191
SETUP GLOBAL ~
@@ -188,10 +196,14 @@ see the default values see: `code_runner.nvim/lua/code_runner/options`
188
196
189
197
Parameters:
190
198
191
- - `mode ` : Display Mode in which you want to run. Supported: "term", "float", "tab","better_term", "toggleterm" (type: `string ` , default: "term")
192
- - `focus` : Focus on runner window. Only works on "term" and "tab" display modes (type: `bool` , default: false)
193
- - `startinsert ` : init in insert mode. Only works on "term" and "tab" display modes (type: `bool` , default: false)
194
- - `hot_reload` : Run automatically on buffer save, only works in "term" or similar (type: `bool` , default: true)
199
+ - `mode ` : Display Mode in which you want to run. Supported: "term", "float",
200
+ "tab","better_term", "toggleterm" (type: `string ` , default: "term")
201
+ - `focus` : Focus on runner window. Only works on "term" and "tab" display modes
202
+ (type: `bool` , default: false)
203
+ - `startinsert ` : init in insert mode. Only works on "term" and "tab" display
204
+ modes (type: `bool` , default: false)
205
+ - `hot_reload` : Run automatically on buffer save, only works in "term" or similar
206
+ (type: `bool` , default: true)
195
207
- `term ` : Configurations for the integrated terminal (type: `table` )
196
208
- `position` : terminal position consult | windows | for options (type: `string ` )
197
209
- `size` : Size of the terminal window (type: `uint` | `float ` )
@@ -208,15 +220,18 @@ Parameters:
208
220
- `x ` : (type: `float ` )
209
221
- `y ` : (type: `float ` )
210
222
- `border_hl` : (type: `string ` )
211
- - `better_term` : Toggle mode replacement(Install CRAG666/betterTerm.nvim <https://github.com/CRAG666/betterTerm.nvim >)
223
+ - `better_term` : Toggle mode replacement(Install CRAG666/betterTerm.nvim
224
+ <https://github.com/CRAG666/betterTerm.nvim >)
212
225
- `clean` : Clean terminal before launch(type: `bool` )
213
226
- `number ` : Use nil for dynamic number and set init(type: `uint?` )
214
227
- `init` : Set a start number for executions, each execution will go to a different terminal(type: `uint?` )
215
228
},
216
229
- `before_run_filetype` : Execute before executing a file (type: `func ` )
217
- - `filetype ` : If you prefer to use lua instead of json files, you can add your settings by file type here (type: `table` )
230
+ - `filetype ` : If you prefer to use lua instead of json files, you can add your
231
+ settings by file type here (type: `table` )
218
232
- `filetype_path` : Absolute path to json file config (type: `absolute paths`)
219
- - `project` : If you prefer to use lua instead of json files, you can add your settings by project here (type: `table` )
233
+ - `project` : If you prefer to use lua instead of json files, you can add your
234
+ settings by project here (type: `table` )
220
235
- `project_path` : Absolute path to json file config (type: `absolute paths`)
221
236
222
237
@@ -248,7 +263,7 @@ The filetype table can take either a `string`, a `table` or a `function`.
248
263
<
249
264
250
265
If you want to add some other language or some other command follow this
251
- structure `key = commans `.
266
+ structure `key = commands `.
252
267
253
268
254
269
JSON
@@ -379,7 +394,7 @@ PARAMETERS
379
394
**Note** Don’t forget to name your projects because if you don’t do so code
380
395
runner will fail as it uses the name for the buffer name
381
396
382
- HOOKS *code_runner-hooks*
397
+ HOOKS *code_runner-code_runner.nvim -hooks*
383
398
384
399
These elements are intended to help with those commands that require more
385
400
complexity. For example, implement hot reload on markup documents.
@@ -540,7 +555,7 @@ a new vertical windows and reload on save. Read the comments for more info.
540
555
<
541
556
542
557
543
- INTEGRATION WITH OTHER PLUGINS *code_runner-integration-with-other-plugins*
558
+ INTEGRATION WITH OTHER PLUGINS*code_runner-code_runner.nvim -integration-with-other-plugins*
544
559
545
560
546
561
API ~
@@ -567,7 +582,7 @@ how to use harpoon term together with code_runner.nvim:
567
582
<
568
583
569
584
570
- INSPIRATIONS AND THANKS *code_runner-inspirations-and-thanks*
585
+ INSPIRATIONS AND THANKS *code_runner-code_runner.nvim -inspirations-and-thanks*
571
586
572
587
- The idea of this project comes from the vscode plugin code_runner <https://marketplace.visualstudio.com/items?itemName=formulahendry.code-runner > You can even copy your configuration and pass it to this plugin, as they are the same in the way of defining commands associated with filetypes <https://github.com/CRAG666/code_runner.nvim#add-support-for-more-file-types >
573
588
- jaq-nvim <https://github.com/is0n/jaq-nvim > some ideas of how to execute commands were taken from this plugin, thank you very much.
@@ -578,10 +593,10 @@ INSPIRATIONS AND THANKS *code_runner-inspirations-and-thanks*
578
593
- Thanks to all current and future collaborators, without their contributions this plugin would not be what it is today
579
594
580
595
581
- SCREENSHOTS *code_runner-screenshots*
596
+ SCREENSHOTS *code_runner-code_runner.nvim -screenshots*
582
597
583
598
584
- CONTRIBUTING *code_runner-contributing*
599
+ CONTRIBUTING *code_runner-code_runner.nvim -contributing*
585
600
586
601
587
602
**Note** If you have any ideas to improve this project, do not hesitate to make
@@ -592,14 +607,19 @@ contribute, criticize (don’t be soft) or contribute ideas. All PRs are
592
607
welcome.
593
608
594
609
610
+ SIMILAR PROJECTS *code_runner-code_runner.nvim-similar-projects*
611
+
612
+ - SnipRun <https://github.com/michaelb/sniprun >
613
+ - iron.nvim <https://github.com/Vigemus/iron.nvim >
614
+
615
+
595
616
==============================================================================
596
- 1 . LICENCE *code_runner-licence*
617
+ 2 . LICENCE *code_runner-licence*
597
618
598
- ------------------------------------------------------------------------------
599
619
MIT <https://github.com/CRAG666/code_runner.nvim/blob/main/LICENSE >
600
620
601
621
==============================================================================
602
- 2 . Links *code_runner-links*
622
+ 3 . Links *code_runner-links*
603
623
604
624
1. *preview*: https://github.com/CRAG666/dotfiles/blob/main/config/nvim/lua/plugins/dev/code_runner.lua
605
625
2. *@adalessa*:
0 commit comments