imba shell

英巴壳牌

Imba 的交互式调试器和 REPL。

安装

节点管理：

npm i -g imba-shell

纱：

yarn global add imba-shell

用法

要开始使用imba-shell ，请运行以下命令：

imba-shell

要启用 TypeScript，您可以传递--ts标志：

imba-shell --ts

请注意，您还可以使用imbas代替imba-shell 。

多线

要使用多行模式，请使用 .editor 命令：

>>> .editor

这将打开一个多行编辑器。

缩进

使用多行模式时，可以使用Shift+Tab组合键来缩进当前行。

要删除选项卡，请使用Backspace键。

清除

要清除imba-shell ，请使用clear helper：

>>> clear !

您还可以使用.clear命令。

出口

要退出imba-shell ，请使用exit助手：

>>> exit !

您还可以使用.exit命令。

Imba 运行时

您可以使用imba-shell作为运行时：

imbar file.imba

imbar别名： imba-r 、 imba-runtime 、 ir 。

将参数传递给您的脚本：

imbar craftsman.imba mail:send --help

持续构建并观察项目（开发目的）：

imbar --watch server.imba

标志： --watch

别名： -w

创建自执行脚本：

hello

 #!/usr/bin/env imbar

const name = process . argv . slice ( 2 )[ 0 ] ?? 'stranger'

console . log "Hello {name}"

如果您使用的是Linux 、 FreeBSD或MacOS ，您可以使脚本可执行：

chmod u+x hello

注意：当创建不以".imba"结尾的脚本时，Imba 运行时会将您的脚本克隆到以.imba结尾的隐藏文件中，并执行它而不是原始脚本。执行完成后，隐藏文件将被删除。

运行脚本：

./hello Donald    # Hello Donald
./hello           # Hello stranger 

应用程序编程接口

imba-shell也可以用作模块。这是一个例子：

因巴：

 import { ImbaRepl } from 'imba-shell'

# you can also pass "typescript" instead of "imba"
const repl = new ImbaRepl 'imba' , 'imba> '

repl . run !

JavaScript：

 const { ImbaRepl } = require ( 'imba-shell' ) ;

/** you can also pass "typescript" instead of "imba" */
const repl = new ImbaRepl ( 'imba' , 'imba> ' ) ;

repl . run ( ) ;

请注意，您可以在run函数中传递 Node.js repl 选项的对象。

历史

以下是如何启用历史记录功能的示例：

因巴：

 import { ImbaRepl } from 'imba-shell'
import os from 'os'
import path from 'path'

const repl = new ImbaRepl 'imba' , 'imba> ' , path . join ( os . homedir !, '.my_repl_history' )

repl . run !

JavaScript：

 const { ImbaRepl } = require ( 'imba-shell' ) ;
const os = require ( 'os' ) ;
const path = require ( 'path' ) ;

const repl = new ImbaRepl ( 'imba' , 'imba> ' , path . join ( os . homedir ( ) , '.my_repl_history' ) ) ;

repl . run ( ) ;

您可以将任何有效路径设置为历史文件。

命令

您可以使用registerCommand函数注册命令：

因巴：

 repl . registerCommand 'goodbye' , do
	console . log 'Goodbye!'
	this . close !

JavaScript：

 repl . registerCommand ( 'goodbye' , () = > {
	console . log ( 'Goodbye!' );
	this . close ();
});

语境

您可以使用registerCallback函数注册 REPL 中可用的函数和属性：

因巴：

 const repl = new ImbaRepl

repl . registerCallback do ( ctx )
	ctx . foo = 'bar'

JavaScript：

 const repl = new ImbaRepl ( ) ;

repl . registerCallback ( ( ctx ) => {
	ctx . foo = 'bar'
} )

当在 REPL 中调用foo时，它将返回bar 。

托多

• 语言支持。
  • 因巴。
  • 打字稿。
• 代码完成。
  • 因巴。
  • 打字稿。
• 多行编辑器。
  • 因巴。
  • 打字稿。
• 异步/等待。
  • 因巴。
  • 打字稿。
• 可扩展的API。
• 语法突出显示。
  • 因巴。
  • 打字稿。
• 编译错误。
  • 因巴。
  • 打字稿。

发展

安装

安装依赖项：

$ npm i

建造

从源代码构建：

$ npm run build

测试

测试Imba-Shell ：

$ npm run test 

安全

如果您发现任何与安全相关的问题，请发送电子邮件至 [email protected]，而不是使用问题跟踪器。

执照

麻省理工学院许可证 (MIT)。请参阅许可证文件以获取更多信息。