1. Spice Spice in Dyalog V1.02

2. Oct 2008 2 Spice Utilities Spice is a cover for SALT. It uses an input area at the bottom of the screen to issue user defined commands using SALT. Spice can be initialized directly from SALT:

3. Oct 2008 3 Initializing Spice Spice can be started automatically when starting APL by setting the SALT registry key AddSPICE to ‘1’

4. Oct 2008 4 Initializing Spice Spice can also be started automatically by using the function in the SALT workspace: )LOAD SALT enableSpice

5. Oct 2008 5 Initializing Spice in V12 The configuration menu:

6. Oct 2008 6 Spice Help To get a list of all available commands you enter ‘?’ in the input area: ?

7. Oct 2008 7 Example of a custom Spice command: locate Use “locate string” to locate a regular expression string in SALT folders, e.g.: locate \babc\b>0 Will find in SALT files where syntactic abc is greater than 0

8. Oct 2008 8 Using SALT commands in Spice All the SALT commands but New can be issued here, e.g.: save myclass file1 compare file1 -ver=4 list mine settings load myfile removeversions filex -v=<9

9. Oct 2008 9 How does Spice work? -Spice commands are kept in script files, like SALT. -Spice files have a.dyalog extension. -All Spice script files are kept in folder [Dyalog]\SALT\spice

10. Oct 2008 10 How does Spice work? Each script file contains a class with a number of presumably related commands. For example a script/class could contain 1.a command to search text 2.a command to replace text

11. Oct 2008 11 How does Spice work? A script file MUST contain at least 3 public shared functions: 1.A function 2.A function 3.A function It may contain other functions.

12. Oct 2008 12 How does Spice work? The function The function is niladic. It returns a list of as many namespaces as there are commands in the script file. E.g.: if there are 2 commands in the script file it returns 2 namespaces.

13. Oct 2008 13 How does Spice work? The function Each namespace returned by contains 4 variables; each one is a string: 1.Name: the name of the command 2.Group: the group the command belongs to 3.Desc: a short description 4.Parse: the parsing rules

14. Oct 2008 14 How does Spice work? The function The 4 variables: 1.Name: a single word, e.g. locate 2.Group: a single word, e.g. files 3.Desc: a sentence, e.g. Find string in files 4.Parse: a string describing the command syntax, e.g. 2 –exclude=

15. Oct 2008 15 How does Spice work? The function (example with 2 cmds) ∇ r←List :Access Shared Public r← ⎕ NS¨2 ⍴⊂ '' r.Name←'Locate' 'Replace' r.Group← ⊂ 'Files' r.Parse←'1' '2' r[1].Desc←'Find a string in files' r[2].Desc←'Replace a string by another' ∇

16. Oct 2008 16 How does Spice work? The function The function is monadic. It takes a string naming the command to return detailed help for, e.g. locate It returns a string describing help for that command.

17. Oct 2008 17 How does Spice work? The function (example with 2 cmds) ∇ r←Help Cmd :Access Shared Public r←'' r,← ⊂ 'Arg: string; shows where the string is found' r,← ⊂ 'Arg: 2 strings; replace the first one by the other' r←r ⊃⍨ 'Locate' 'Replace' ⍳⊂ Cmd ∇

18. Oct 2008 18 How does Spice work? The function The function is monadic. It takes 2 arguments: 1.a string naming the command to deal with, e.g. locate 2.either a string or a namespace which is the argument to the command

19. Oct 2008 19 How does Spice work? The function (example with 2 cmds) ∇ r←Run(Cmd ca);ct;w :Access Shared Public r←0 0 ⍴ '' ⋄ ct← ⎕ SE.SALT.Load'Utils\fileUtils -noname' w←##.textUtils.splitOn ⍨⎕ SE.SALT.Settings'workdir' :Select Cmd :Case 1 ⊃ Fns ⋄ w ct.showExpr¨ ⊂ ca.Argument :Case 2 ⊃ Fns ⋄ w ct.replExpr¨ ⊂ ca.Argument :EndSelect ∇

20. Oct 2008 20 Example See script Spice\aSample.dyalog It contains 2 examples of Spice commands: 1.no parsing rules 2.with specific parsing rules

21. Oct 2008 21 Example The syntax is described in the help:

22. Oct 2008 22 Example If the syntax is wrong Spice will complain: No arguments!

23. Oct 2008 23 Example If the syntax is right Spice will do it:

24. Oct 2008 24 Special Spice command When Spice starts a special command is run That command is 'Setup' It is found in spice\Setup.dyalog It can be modified to suit your needs

25. Oct 2008 25 Special Spice command

26. Oct 2008 26 Final SPICE is a development tool. It can be used to store frequently used (and even less frequently used) user commands.

27. Oct 2008 27 Short Final More information can be found in the Spice document. Dyalog 2008