Soar Tools
Package for Soar development in Sublime Text
Details
Installs
- Total 213
- Win 115
- Mac 59
- Linux 39
Aug 27 | Aug 26 | Aug 25 | Aug 24 | Aug 23 | Aug 22 | Aug 21 | Aug 20 | Aug 19 | Aug 18 | Aug 17 | Aug 16 | Aug 15 | Aug 14 | Aug 13 | Aug 12 | Aug 11 | Aug 10 | Aug 9 | Aug 8 | Aug 7 | Aug 6 | Aug 5 | Aug 4 | Aug 3 | Aug 2 | Aug 1 | Jul 31 | Jul 30 | Jul 29 | Jul 28 | Jul 27 | Jul 26 | Jul 25 | Jul 24 | Jul 23 | Jul 22 | Jul 21 | Jul 20 | Jul 19 | Jul 18 | Jul 17 | Jul 16 | Jul 15 | Jul 14 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Mac | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Linux | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
Sublime Text Soar Tools
Sublime Text package for Soar development. Currently only tested for Sublime Text 3.
Getting Started
- After installing Package Control, use the Command Palette (
Ctrl+Shift+P
) to selectInstall Package
and then search forSoar Tools
.
Current Functionality
Syntax Highlighting
Soar syntax highlighting is applied to files with the .soar, .soarunit, or .dm extensions. Code folding is also provided but is irregular at the moment.
Snippets
Several snippets are currently provided for various types of Soar productions, SoarDoc, and SoarUnit setup/test blocks. SoarDoc snippets are triggered by ##!
and production snippets are triggered by sp
. Provided snippets are:
- SoarDoc, triggered by
##!
, for:- documenting a file
- documenting an operator
- documenting a production
- Soar productions, triggered by
sp
, for:- propose/compare/apply operator
- elaborate state
- elaborate substate
- SoarUnit blocks:
- setup block
- test block
SoarUnit
If you have JSoar/SoarUnit on your computer, you can run it with a build command (ctrl+b or command+b) when you have a SoarUnit file open. You will, however, need to specify the location of SoarUnit if it is not in your PATH. You may also wish to test using C Soar. To specify these settings, go to Preferences –> Package Settings –> Soar Tools –> Settings - User. These are your available settings:
{
// 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"
}
You can either run SoarUnit on the current file, or for the whole project, but the project option is currently slow and buggy, and therefore not recommended.
SublimeREPL Integration
You can run the Soar CLI from SublimeText if you have the SublimeREPL package installed, but setup might be tricky:
If your Soar directory is not in your system path, you will need to add it to SublimeREPL's path:
- Preferences -> Package Settings -> SublimeREPL -> Settings - User
{ “default_extend_env”: {“PATH”: “C:/path/to/Soar/bin:{PATH}”} }
TODO
- Highlighting for script blocks
- Solicit feedback from Soar users