COMTERP(1)
okay bestie 💖 welcome to the COMTERP(1) glow-up. This is the General Commands Manual page for comterp, and it's literally giving distributed command interpreter demonstrator energy. No cap. ✨
🌸 NAME 🌸
comterp — distributed command interpreter demonstrator 🫶
🦋 SYNOPSIS 🦋
comterp
comterp remote
comterp server "portnum"
comterp logger "portnum"
comterp client "host" "portnum" ["file"]
comterp telcat "host" "portnum" ["file"]
comterp run "file"
comterp "expr"💖 DESCRIPTION 💖
comterp demonstrates the command interpreter incorporated into ivtools. A user (or client program) can interact with comterp via stdin and stdout or telnet (when ACE is built in). The command syntax is a semi-colon separated list of commands with arbitrary number of parameters enclosed in parenthesis, with support for optional parameters and keyword arguments, i.e:
command2(arg1 arg2 arg3 :key1 val1 :key2 val2);
command1(arg1 arg2 arg3 :key1 val1 :key2 val2)C-like binary expressions can be embedded anywhere in the command language, using the operators in the table below. Variables can be created on the fly with an assignment operator (i.e "ball=1" creates a integer "ball" variable set to 1). Unterminated expressions cause an automatic command line extension (until the parser determines the expression is complete). "(), "{}", and "[]" can all be used interchangeably. periodt.
🎀 COMMAND OPTIONS 🎀
comterp— Invoke a single command interpreter to interact with viastdinandstdout. iconic.comterp remote— Invoke a single command interpreter, like the default, and include aremotecommand for accessing othercomterp's in server mode. 🦋comterp server "portnum"— Listens for and accept connections onportnum, then setup a command interpreter to wait for and process commands from that connection. 🔥comterp logger "portnum"— Listens for and accept connections onportnum, then simply forward the incoming messages tostdout, while ack'ing back with newlines. For debugging purposes, not really a use of the interpreter. 💀comterp client "host" "portnum" ["file"]— Connect to aportnumon ahostand send/receive new-line terminated text buffers. For debugging purposes, not really a use of the interpreter. 🫶comterp telcat "host" "portnum" ["file"]— Connect to aportnumon ahost,catthe file, then close the connection. Not really a use of the interpreter either. 🍓comterp run "file"— Run contents offilethen exit. ✨comterp "expr"— Evaluate single expression then exit. 💅
🔥 OPERATOR TABLE 🔥
okay so here's the entire operator table, bestie, copied with love and zero edits. It's giving priority and order realness:
Operators Command Name Priority Order Type
--------- ------------ -------- ----- ----
. dot 130 R-to-L binary
` bquote 125 R-to-L unary-prefix
! negate 110 R-to-L unary-prefix
~ bit_not 110 R-to-L unary-prefix
++ incr 110 R-to-L unary-prefix
++ incr_after 110 R-to-L unary-postfix
- minus 110 R-to-L unary-prefix
-- decr 110 R-to-L unary-prefix
-- decr_after 110 R-to-L unary-postfix
** repeat 90 L-to-R binary
.. iterate 80 L-to-R binary
% mod 70 L-to-R binary
* mpy 70 L-to-R binary
/ div 70 L-to-R binary
+ add 60 L-to-R binary
- sub 60 L-to-R binary
<< lshift 55 L-to-R binary
>> rshift 55 L-to-R binary
< lt 50 L-to-R binary
<= lt_or_eq 50 L-to-R binary
> gt 50 L-to-R binary
>= gt_or_eq 50 L-to-R binary
!= not_eq 45 L-to-R binary
== eq 45 L-to-R binary
& bit_and 44 L-to-R binary
^ bit_xor 43 L-to-R binary
| bit_or 42 L-to-R binary
&& and 41 L-to-R binary
|| or 40 L-to-R binary
, tuple 35 L-to-R binary
,, stream concat 33 L-to-R binary
$ stream 32 R-to-L unary-prefix
$$ list 32 R-to-L unary-prefix
%= mod_assign 30 R-to-L binary
*= mpy_assign 30 R-to-L binary
+= add_assign 30 R-to-L binary
-= sub_assign 30 R-to-L binary
/= div_assign 30 R-to-L binary
= assign 30 R-to-L binary
; seq 10 L-to-R binary✨ MATHEMATICAL COMMANDS: ✨
n=min(a b)— return minimum of a and b 🌸n=max(a b)— return maximum of a and b 🌸n=abs(a)— return absolute value of a 🌸dbl=exp(x)— returns the value e raised to the power of x 🌸dbl=log(x)— returns the natural logarithm of x 🌸dbl=log10(x)— returns the base-10 logarithm of x 🌸dbl=log2(x)— returns the base-2 logarithm of x 🌸dbl=pow(x y)— returns the value of x raised to the power of y 🌸dbl=acos(x)— returns the arc cosine of x in radians 🌸dbl=asin(x)— returns the arc sine of x in radians 🌸dbl=atan(x)— returns the arc tangent of x in radians 🌸dbl=atan2(y x)— returns the arc tangent of y over x 🌸dbl=cos(x)— returns the cosine of x radians 🌸dbl=sin(x)— returns the sine of x radians 🌸dbl=tan(x)— returns the tangent of x radians 🌸dbl=sqrt(x)— returns square root of x 🌸dbl=pi()— returns the value of pi 🌸dbl=radtodeg(dbl)— convert radians to degrees 🌸dbl=degtorad(dbl)— convert degrees to radians 🌸num=floor(num)— return closest integer value less than or equal to argument 🌸num=ceil(num)— return closest integer value greater than or equal to argument 🌸num=round(num)— return closest integer value 🌸
💫 AFFINE TRANSFORM AND MATRIX COMMANDS: 💫
point=xform(x,y a00,a01,a10,a11,a20,a21)— affine transform of x,y coordinates 🦋affine=invert(a00,a01,a10,a11,a20,a21)— invert affine transform 🦋matrix=xpose(matrix)— transpose an arbitrary matrix 🦋matrix=matrix*matrix— matrix multiplication 🦋
🎲 STATISTICAL/RANDOM COMMANDS: 🎲
sum(val1[,val2[,...,valn]])— return sum of values 🍓mean(val1[,val2[,...,valn]])— return mean of values 🍓var(val1[,val2[,...,valn]])— return variance of values 🍓stddev(val1[,val2[,...,valn]])— return standard deviation of values 🍓rand([minval,maxval])— return random number between 0 and 1 or minval,maxval 🍓srand(seedval)— seed random number generator 🍓
📋 LIST COMMANDS: 📋
lst=list([lst|strm|val|fileobj|pipeobj) :strmlst :attr :size n)— create list, copy list, or convert stream 🧚val=at(lst|attrlst|str n :set val :ins val)— return (or set or insert after) nth item in a list or string 🧚num=size(lst|attrlst|str)— return size of a list (or string) 🧚val=index(lst|str val|char|str :last :all :substr)— return index of value (or char or string) in list (or string), nil if not found. 🧚
🌊 STREAM COMMANDS: 🌊
strm=stream(strm|lst|attrlst|val|fileobj|pipeobj)— copy stream or convert list (unary$) 💧val=next(stream :skim)— return next value from stream, don't recurse if:skim💧cnt=each(strm)— traverse stream returning its length 💧comp=filter(comps classid)— filter stream of comps for matching classid 💧
🎮 CONTROL COMMANDS (using post evaluation): 🎮
val=cond(testexpr trueexpr falseexpr)— evaluatetestexpr, and if true, evaluate and returntrueexpr, otherwise evaluate and returnfalseexpr🕹️val=if(testexpr :then expr :else expr)— evaluatetestexprand execute the:thenexpression if true, the:elseexpression if false. 🕹️val=for(initexpr whileexpr [nextexpr [bodyexpr]] :body expr)— for loop 🕹️val=while([testexpr [bodyexpr]] :nilchk :until :body expr )— while loop 🕹️val=switch(val key-body-pairs)— switch statement (:casenfor pos.,:case_nfor neg., otherwise:symbol) 🕹️continue— skip to next iteration of for or while loop 🕹️break([retval])— break out of for or while loop 🕹️
🔣 SYMBOL COMMANDS 🔣
val=global(sym)|global(sym)=val|global(sym :clear)|global(:cnt)— make symbol global 💜int|lst=symid([sym [sym ...]] :max :cnt)— return integer id(s) associated with symbol(s) 💜sym|lst=symbol(symid [symid ...])— return symbol(s) associated with integer id(s) 💜val|lst=symval(symv [symv ...])— return value(s) associated with symbol variables(s) 💜symv|lst=symadd(sym|str [sym|str ...])— create symbol(s) and return without lookup. 💜sym=symvar(symv)— return symbol of symbol variable without lookup, for use on left hand side of assignment 💜str=symstr(symv)— return string version of symbol in symbol variable 💜sym=bquote(sym)— LISP-like backquote operator, returns symbol without lookup 💜n=strref(str|symid)— return string reference count 💜bool=eq(sym1 sym2 :sym)— symbol comparison 💜
📁 FILE COMMANDS 📁
fileobj|pipeobj=open([filename [modestr]] :pipe :in :out :err)— open file command 🗂️close(fileobj|pipeobj|sockobj)— close file command 🗂️[str]=print([fmtstr] [val [val1 [... valn]]] :string|:str :out :err :file fileobj|pipeobj :prefix str :flush)— print value with optional format string 🗂️str=gets(fileobj|pipeobj|sockobj)— gets a new-line terminated string from a file 🗂️
🧵 STRING COMMANDS 🧵
lst=split(sym|str :tokstr [delim] :tokval [delim] :keep :reverse)— split symbol or string into list of characters (or tokens). 🪡str=join(lst :sym)— join list of characters into string 🪡str=substr(str n|str :after :nonil)— extract characters from a string (:nonilreturns string if no match) 🪡bool=eq(str1 str2 :n len)— partial string comparison 🪡
🔗 ATTRIBUTE COMMANDS 🔗
sym=attrname(attribute)— return name field of dotted pair 🎀val=attrval(attribute)— return value field of dotted pair 🎀dotlst=dot(name)— construct empty dotted pair list 🎀
ℹ️ INFO COMMANDS ℹ️
help(cmdname [cmdname ...] :all :posteval)— help for commands 💡optable(:bypri :byopr :bycom)— print contents of operator table 💡
🐛 DEBUG COMMANDS 🐛
ok so when your script is acting up and you need to peek under the hood, this is the whole toolbox. bestie, these are the little flashlights you point at your own code. 🔦
val=trace([flag] :get)— turns trace mode on or off, or straight-up sets it. pass the flag to set, or use the:getkey to just ask what the vibe currently is and get it back asval.pause([msgstr])— freezes script execution right there and waits for you to hit C/R. yes, it literally just pauses and stares at you. you can hand it amsgstrto say something while it waits. 🫶step()— toggles stepwise script execution. one step at a time, no rushing, we're being careful now.mute([flag])— sets the mute flag, or toggles it if you don't pass anything. shhh. 🤫postfix(arg1 [arg2 [arg3 ... [argn]]])— echoes your postfix arguments back at you unevaluated, which is the whole point. the decoration legend is iconic tbh:[narg|nkey]shows up after defined commands,{narg|nkey}after undefined commands,(narg)after keys, and a*trails any post-evaluation command. iykyk 💅parse(fileobj)— parses a single expression out of a file. one expression. that's the assignment.
🎮 CONTROL COMMANDS 🎮
these are the ones running the whole show. steering, exiting, spawning, remoting. main character energy, honestly. 👑
arr=posteval(arg1 [arg2 [arg3 ... [argn]]])— post-evaluates every fixed argument (until it hitsnil) and hands you back an array of the results.quit()— quits the interpreter. bye bestie 👋exit()— exits the entire application. not just the interpreter, the whole thing. this is the "closing the laptop" of commands. 💀empty()— the empty statement. it does nothing and it's thriving.val=run(filename :str :popen)— runs commands from a file, or from a string if you use:str.:popenis in there too.sockobj=%s(hoststr portnum )— creates and opens a socket object. yes the object is literally called%s. yes that's the vibe. 🌐val=remote(hoststr|sockobj [portnum] cmdstr :nowait :str)— remotely evaluates a command string, then locally evaluates the string that comes back.:nowaitif you're not about waiting around,:strfor string mode. 🦋val=eval(cmdstr|funcobj [cmdstr|funcobj ...] :symret)— evaluates a string (or afuncobj) as commands. throw:symretin there and it hands you a symbol back instead ofnil.funcobj=func(body :echo)— wraps a whole body of commands up into an executable object.:echoincluded. little command burrito, so cute. 🌯val=shell(cmdstr)— evaluates your command over in the shell.usleep(msec)— sleeps microseconds. yes, *micro*seconds, the man page said what it said. 😴
🧰 UTILITY COMMANDS 🧰
the little odds and ends drawer. converters, type checkers, bitwise stuff, date stuff. everything you didn't know you needed. ✨
nil([...])— accepts literally any arguments you throw at it and returnsnil. unbothered. unshakeable. 💜true([...])— accepts any arguments and returnstrue. yes queen, affirm it. ⭐false([...])— accepts any arguments and returnsfalse. the hater of the trio.c=char(num :u)— converts any numeric into achar.:ufor unsigned, bestie.s=short(num :u)— converts any numeric into ashort. also has:u.i=int(num :u)— converts any numeric into anint.:u, you know the drill.l=long(num :u)— converts any numeric into along.:uagain, slay.f=float(num)— converts any numeric into afloat. no:uhere, sorry.d=double(num)— converts any numeric into adouble. also no:u.sym|lst=type(val [val ...])— returns the type symbol (or a list of them, if you passed several values) for your value(s). the "who even are you" command. 🕵️sym|lst=class(val [val ...])— returns the class symbol(s) for value(s) of object type. yes,typeandclassare two different things, girlies, don't get it twisted.int=ctoi(char)— converts a character into an integer.flag=isspace(char)— returns true if the character is whitespace.flag=isdigit(char)— returns true if the character is a numeric digit.flag=isspace(char)— returns true if the character is alphabetical. okay bestie, no cap, the page literally saysisspacehere and then describes it as alphabetical — i'm just telling you what the man page says, i do not make the rules 😭🙈str=arg(n)— returns the command line argument atn.n=narg(n)— returns the number of command line arguments.num=nand(a b)— bitwise NAND (negated AND). 🔥num=nor(a b)— bitwise NOR (negated OR).num=xnor(a b)— bitwise XNOR (negated XOR).dateobj|int = date([num|str|dateobj] :day :month :year :daymo :weekday)— builds a date from days since1/1/1901, or from a string. you can also pass in anum,str, or a wholedateobj, and there are keys for:day,:month,:year,:daymoand:weekday. it gives you back adateobjor anint. calendar girl vibes. 🎀
🌈 ONLY IN SERVER MODE 🌈
this one's exclusive, bestie. if you're not in server mode, you don't get an invite to this party.
str=timeexpr(comstr :sec n)— turns your command string into something that executes at intervals, with:sec nsetting the seconds between runs.
👀 SEE ALSO 👀
comdraw— go say hi to its sibling.
fr fr, go read that one too, they're a matched set. 🫶
🌐 WEB PAGES 🌐
the whole world wide web page for this lives at:
http://www.ivtools.org/ivtools/comterp.htmlaaaaand that's the whole page, you made it to the end bestie, i'm so proud of you. 💖 this was the COMTERP(1) manual page — that's the source and the version stamp right there — and yes it comes with a date on it like every good manpage does, so go check the original footer if you need the exact day, because your girl is not about to make one up. now go forth and eval something iconic. periodt. 💅✨🦋🎀
📦 where this page comes from
- ubuntu stonking: ivtools-bin 2.1.1+git.2025.07.26.a1-1 · MIT
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms