kimushu / vscode-mruby

mruby support for Microsoft VSCode

mruby support for VSCode

日本語の説明はこちら / Japanese

This extension provides compiler and runtime of mruby (Lightweight implementation of Ruby Language).

https://github.com/kimushu/vscode-mruby

About mruby

See official website: https://www.mruby.org/

Features

• Provide tasks for mruby compilation (*.rb → *.mrb)

  • mruby compiler is included in this extension.
    You don't need install mruby separately.
  • Watch mode supported.
    Automatically re-compile after you changed source code. You don't need to trigger build many times.
  • Report compile errors in VSCode.
    When compile errors detected, this extension reports errors on source code and in Problems window.

• Provide executing your Ruby code with mruby in VSCode debug interface.

• (Experimental) Provide debugging your Ruby code with mruby debugger ( mrdb ) through VSCode debug interface.

Supported mruby versions

mruby	RITE binary	RITE VM	Compile support	Execute support	Debug suport
2.1.0	0006	0002	Yes	Yes	Yes (Experimental)
2.0.1	0005	0002	Yes	Yes	Yes (Experimental)
2.0.0	0005	0002	Yes	Yes	Yes (Experimental)
1.4.1	0004	0000	Yes	Yes	Yes (Experimental)
1.3.0	0004	0000	No	No	No
1.2.0	0003	0000	No	No	No
1.1.0	0003	0000	No	No	No
1.0.0	0002	0000	No	No	No

How to configure tasks.json

1. Open Ruby source (.rb) in VSCode.

2. Press F1 and type Configure Task.
   

3. Select mruby: Compile with mruby or mruby: Compile with mruby (Watch mode) as you prefer.
   

How to configure launch.json

1. Open Ruby source (.rb) in VSCode.

2. Select Debug → Add configuration... from menu bar.
   

3. Select mruby or mruby debugger.
   

Release Notes

1.0.0

Initial release with experimental debugging support.

vscode-mruby's Issues

Task fails with EPERM in directories with inaccessible sub-directory

If the workspace includes inaccessible directories (ex: System Volume Information on NTFS), task fails with EPERM.

> Executing task: c:\Users\shuta\.vscode\extensions\kimushu.mruby-1.0.0\lib\run_as_node.cmd C:\Users\shuta\AppData\Local\Programs\Microsoft VS Code\Code.exe c:\Users\shuta\.vscode\extensions\kimushu.mruby-1.0.0\out\runner\mrbcRunner.js @-R:\Temp\88457b243f65ec3804c5eeb767cf02a3\a5fb842b1c3b8e38cf1115e3befad38c.opt <

glob error [Error: EPERM: operation not permitted, scandir 'r:\System Volume Information'] {
  errno: -4048,
  code: 'EPERM',
  syscall: 'scandir',
  path: 'r:\\System Volume Information'
}
(node:8988) UnhandledPromiseRejectionWarning: Error: EPERM: operation not permitted, scandir 'r:\System Volume Information'
(node:8988) UnhandledPromiseRejectionWarning: Error: EPERM: operation not permitted, scandir 'r:\System Volume Information'
(node:8988) UnhandledPromiseRejectionWarning: Unhandled promise rejection. 
This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). (rejection id: 1)
(node:8988) UnhandledPromiseRejectionWarning: Unhandled promise rejection. 
This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). (rejection id: 1)
(node:8988) [DEP0018] DeprecationWarning: Unhandled promise rejections are 
deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.
(node:8988) [DEP0018] DeprecationWarning: Unhandled promise rejections are 
deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.