Sublime Text Soar 工具

Sublime Text 中用于 Soar 开发的软件包。目前仅在 Sublime Text 3 上进行了测试。

入门

• 安装 软件包控制 后，使用 命令面板（《Ctrl+Shift+P》）选择 安装软件包 并搜索 Soar Tools。

当前功能

语法高亮

Soar 语法高亮应用于 .soar、.soarunit 或 .dm 扩展名的文件。还提供了代码折叠功能，但当前是不规则的。

代码片段

目前提供了多种 Soar 生成类型、SoarDoc 和 SoarUnit 设置/测试块的代码片段。SoarDoc 代码片段通过 ##! 触发，生成代码片段通过 sp 触发。提供的代码片段包括

• SoarDoc，通过 ##! 触发，用于
  • 文档化文件
  • 文档化操作符
  • 文档化生成器
• Soar 生产，通过 sp 触发，用于
  • 提议/比较/应用操作符
  • 阐述状态
  • 阐述子状态
• SoarUnit 块
  • 设置块
  • 测试块

SoarUnit

如果您在计算机上安装了 JSoar/SoarUnit，您可以在打开 SoarUnit 文件时使用构建命令（Ctrl+b 或 Command+b）运行它。但是，如果 JSoar/SoarUnit 不在您的 PATH 中，则需要指定其位置。您还可能希望使用 C Soar 进行测试。为了指定这些设置，请转到“首选项” -> “软件包设置” -> “Soar Tools” -> “设置 - 用户”。以下是您的可用设置

{
    // If added to your system path, "soarunit" is fine; otherwise,
    // you'll need to set this to "C:/jsoar-0.14.0/bin/soarunit", etc.
    "soarunit_path": "soarunit",

    // set to true if you want to use C Soar, not JSoar
    "c_soar": false,

    // If using C Soar, set this to the Soar distribution directory, or set
    // the SOAR_HOME environment variable
    // "SOAR_HOME": "C:/path/to/soar-9.x.x",

    // set to true if you want a pretty popup window instead of console
    // output
    "ui": false,

    // indicate the size of thread pool to run tests in;
    // either a number indicating the fixed size of a thread pool,
    // "cpus" for number of cpus, or "cached" for cached
    "threads": "cpus"
}

您可以选择在当前文件上运行SoarUnit，也可以运行整个项目，但项目选项目前速度较慢并且存在bug，因此不建议使用。

SublimeREPL集成

如果您已经安装了SublimeREPL插件包，您可以从SublimeText运行Soar CLI，但设置可能会有些棘手。

• 如果您的Soar目录不在系统路径中，您需要将其添加到SublimeREPL的路径中

  • 首选项 -> 扩展包设置 -> SublimeREPL -> 设置 - 用户

  { “default_extend_env”: {“PATH”: “C:/path/to/Soar/bin:{PATH}”} }

待办事项

• 脚本块的突出显示
• 征求Soar用户的反馈