tempcommand: yet another mini programming language

example script

chan(105,110);
base(90); ubase(0,1: 90);
reg(00 : ff);
ureg(0,1: 00 : ff);
# TEMP(25);
base(D2); ubase(0,1: D2);
    reg(41:00); for(reg:42:02,B0,A9,8A,A7,A8,B1){}
    ureg(0,1:41:00); for(ureg:0,1:42:02,B0,A9,8A,A7,A8,B1){}
    # ureg(1:41:00); for(ureg:1:42:02,B0,A9,8A,A7,A8,B1){}
    reg(47:01);
    ureg(0,1:47:01);
for(TEMP:  -40,0,100 )
{
    dely(1);
    # sample();
    for(reg: 00: 00,02,04)
    {
        # sample();
    }
    for(reg: 02: 0c,0e)
    {
        for(reg: 01,0A: 00,02,04)
        {

            # sample();
            # sample();
        }
    }
    suspend;
}
suspend;
EOF;
sample

example commandset

import tempcommand

def nop(arg):
    arg = arg.strip("{}();")
    arg = arg.split(":")
    print arg

def reg(arg):
    arg = arg.strip("{}();")
    arg = arg.split(":")
    print arg

def suspend(arg):
    arg = arg.strip("{}();")
    arg = arg.split(":")
    print(" SUSPEND: press return to continue ".center(80, "#"))
    raw_input()

callback = {
   "NOP":nop,
   "REG":reg,
   "UREG":reg,
   "CHAN":reg,
   "BASE":reg,
   "UBASE":reg,
   "TEMP":reg,
   "DELY":reg,
   "SAMPLE":reg,
   "SUSPEND":suspend,
}

parser = tempcommand.tempcommand()

with open("script.txt", "rb") as file:
    script = file.read()

parser.parse(script.upper())

requirement

• Python 2.7
  • later python2 with shlex is needed; 2.7 has it, 2.6 may be also
  • shlex help page(python2.7)
  • Not tested with Python3 nor legacy Python2

backgrounds

tempcommand uses shlex library built in python. The library splits the input script into minimum tokens - string, numbers, special characters, etc. Splitted tokens will be scanned until token reaches EOF token or end of file. The EOF token stops scanning script, even if more script remains. Other tokens will be concatenated until reaching:

• ; as delimiter
• { as beginning of loop structure

and stacked to queue. Thus each command needs to be terminated by ;. If read token is } then the compiler takes it as end of loop and cuts queue from last { to this }, then throws cut queue to built-in serializer function. The function, serialize_loop(), returns serialized(or loop-less) list of tokens, which will be stacked back to the queue again.

basic rule

tokens

• [A-Z][a-z][0-9]* as one word: ABCabc nor abc123 will be separated
• ~!@#$%^&*()_+-={}|[]\:";'<>?,./ as one character: ABC(def); will be ABC, (, def, ) and ;
• white spaces are always ignored

command definition (Do It Yourself)

Callback function definition

When scan finishes your command COMMAND(0:1); will be decoded by internal dictionary and callback function command() will be called. command() will get (0:1); as one string argument. Your command can use anything(but not ;,{,}) by any style.

consider loop syntax

Loop structure (or FOR command) needs at least one command and at least one, up to three groups of arguments for the command. This means number of argument for COMMAND (and command()) is limited up to three. Command and argument groups will be separated by colon : and arguments in one group is separated by comma ,.

• FOR(COMMAND : arg1[0],arg1[1],...,arg1[n]){}
  • COMMAND will get one argument by n cases
• FOR(COMMAND : arg1[0], arg1[1], ..., arg1[n] : arg2[0], arg2[1], ..., arg2[m]){}
  • COMMAND will get two arguments by n x m cases
• FOR(COMMAND : arg1[0], ..., arg1[n] : arg2[0], ..., arg2[m] : arg3[0], ..., arg3[p]){}
  • COMMAND will get three arguments by n x m x p cases

add_command()

To append your command as callable command, you first have to define callback function, then call add_command() to add "COMMAND" and command into internal dictionary. tempcommand.add_command("COMMAND", command) where "COMMAND" needs to be always uppercase, while command is not(but defined before this call).