GdPy command list

=================

GdPy is a small scripting language on top of Python.

Main feature update:

- Expressions now work inside SET, for example: SET total = a + b

- You can import installed Python modules: IMPORT math, IMPORT random AS rnd

- The language now supports IF/ELSE/ENDIF, WHILE, FOR, files, JSON, strings and collections

- Added script-style commands: IMPORT python, IMPORT rights, IMPORT error, ERROR(on/off), RIGHTS(give), ENTER, CLOSE, END()

- Added more system-style commands: CLEAR console, CLEAR = vars, ERROR(custom/clear), desktop imports, KILLPID, DOGFUNNY, SCREENSHOT, SAVE, chained actions with AND

Run:

python gdpy.py example.gdpy

Important notes

---------------

1. Files must use the .gdpy extension.

2. Lines starting with # are comments.

3. Variables can be inserted in text as {name} or $name.

4. Expressions use Python-like syntax: + - * / % ** comparisons, lists, dicts, function calls.

5. IMPORT works with Python modules already installed in your environment.

Command families and aliases

----------------------------

SAY:

SAY, PRINT, ECHO, WRITE, OUT, TELL, SHOW, DISPLAY, SPEAK

Syntax: SAY "text" | SAY a + b

SET:

SET, LET, VAR, MAKE, STORE, PUT, ASSIGN, VALUE

Syntax: SET name = expression

DEL:

DEL, UNSET, DROP, ERASE, CLEARVAR, REMOVEVAR

Syntax: DEL name

COPY:

COPY, CLONE, DUP, DUPLICATE, MIRROR

Syntax: COPY target = expression

SWAP:

SWAP, EXCHANGE, FLIP, ROTATEPAIR

Syntax: SWAP left right

TYPEOF:

TYPE, TYPEOF, KIND, WHATIS, VARTYPE

Syntax: TYPEOF target = expression

Math update:

ADD, PLUS, INCREASE, INC, SUMUP, BOOST

SUB, MINUS, DECREASE, DEC, REDUCE, LOWERBY

MUL, TIMES, MULTIPLY, SCALE, GROWBY

DIV, DIVIDE, SPLITBY, SHAREBY

MOD, REM, REMAINDER

POW, POWER, EXPONENT

Syntax examples:

ADD total 5

SUB total other

MUL total 2

DIV total 4

MOD total 3

POW total 2

Length:

LEN, LENGTH, SIZE, COUNT, COUNTAS

Syntax: LEN target = expression

Collections:

APPEND, PUSH, ADDITEM, PUTLAST

EXTEND, MERGE, CONCATLIST, JOINLIST

INSERT, PUTAT, ADDAT

REMOVE, TAKEOUT, DELITEM, DISCARD

POP, PULL, TAKEPOP, LASTOUT

CLEAR, EMPTY, WIPE, RESETLIST

SORT, ORDER, ARRANGE

REVERSE, FLIPLIST, BACKWARD

UNIQUE, DEDUP, DISTINCT

String tools:

SPLIT, TOKENS, CHOP, WORDSPLIT

JOIN, GLUE, CONCAT, STITCH

REPLACE, SWAPTEXT, CHANGE

UPPER, CAPS, BIGTEXT

LOWER, SMALL, LOWTEXT

STRIP, TRIM, CLEAN

Files:

READFILE, LOADFILE, OPENFILE, GETFILE

WRITEFILE, SAVEFILE, CREATEFILE, PUTFILE

APPENDFILE, ADDFILE, EXTENDFILE

EXISTS, FILEEXISTS, PATHHAS

MKDIR, CREATEDIR, NEWDIR

LISTDIR, DIRFILES, SHOWDIR, SCANDIR

READJSON, LOADJSON, OPENJSON

WRITEJSON, SAVEJSON, STOREJSON

Libraries and calls:

IMPORT, USE, MODULE, LOADLIB, REQUIRE

CALL, INVOKE, APPLY, RUNFUNC, EXECFUNC

Special imports:

IMPORT python enables direct Python lines in the script

IMPORT rights enables rights variable workflow

IMPORT error enables error variable workflow

IMPORT file placeholder, planned feature for system file browsing with rights

IMPORT desktop enables desktop/system info workflow

IMPORT desktop-time writes current desktop time into desktop-time and desktop_time

IMPORT desktop-data writes current desktop date into desktop-data and desktop_data

IMPORT killpid enables KILLPID capability, requires rights == yes

IMPORT dogfunny enables DOGFUNNY

IMPORT screenshot enables SCREENSHOT capability, requires rights == yes

Flow control:

LABEL, MARK, TAG, SIGNPOST

GOTO, JUMP, GO, MARKTO

IF, WHEN

ELIF

ELSE, OTHERWISE

ENDIF, FI, ENDWHEN

WHILE, LOOPWHILE

ENDWHILE, WEND, LOOPEND

FOR, EACH, FOREACH

ENDFOR, NEXT, ENDEACH

BREAK, STOPLOOP, LEAVELOOP

CONTINUE, NEXTLOOP, SKIPLOOP

Validation and utility:

ASSERT, ENSURE, VERIFY, CHECK

WAIT, SLEEP, PAUSE, DELAY

ASK, INPUT, READ, PROMPT, QUESTION

HELP, COMMANDS, MANUAL, DOCS

DUMP, VARS, STATE, CONTEXT

NOW, NOWTIME, TIMENOW

TODAY, DATE, DATEONLY

ERROR, ERRORMODE, ERRORS

RIGHTS, ADMIN, ELEVATE

ENTER, PAUSEENTER

NOP, PASS, REM, COMMENT, DO, SKIP, NOSTOP

END, STOP, EXIT, QUIT, HALT, FINISH, CLOSE

SAVE

SCREENSHOT

KILLPID

DOGFUNNY

Core syntax examples

--------------------

Variables and expressions:

SET a = 10

SET b = 20

SET total = a + b

SET data = {"name": "GdPy", "level": 2}

SET items = [1, 2, 3]

Conditions:

IF total > 10 THEN SAY "big"

IF total > 10

SAY "big"

ELSE

SAY "small"

ENDIF

Python-like style with colon:

IF total > 10:

SAY "big"

ELIF total == 10:

SAY "equal"

ELSE:

SAY "small"

ENDIF

Loops:

SET count = 3

WHILE count > 0

SAY count

SUB count 1

ENDWHILE

FOR item IN ["a", "b", "c"]

SAY item

ENDFOR

Libraries:

IMPORT math

SET root = math.sqrt(81)

SAY root

Direct Python mode:

IMPORT python

numbers = [x * 2 for x in range(5)]

print(numbers)

Error mode:

IMPORT error

ERROR(off)

SET a = 10

DIV a 0

SAY "script still works"

ERROR(on)

Custom error flag:

IMPORT error

ERROR(custom)

ERROR(off)

SET a = 10 / 0

IF error == yes:

SAY "error happened"

ENDIF

ERROR(clear)

Clear console and variables:

CLEAR

CLEAR = error, a, b

Desktop info:

IMPORT desktop-time

IMPORT desktop-data

SAY "{desktop-time}"

SAY "{desktop-data}"

Funny command:

IMPORT dogfunny

DOGFUNNY

Chained actions:

CLEAR and a = "Dog" and SAY a

Rights mode:

IMPORT rights

RIGHTS(give)

IF rights == no:

SAY "Admin rights were denied"

ELSE rights == yes:

SAY "Admin rights were accepted"

ELIF:

SAY rights

ENDIF

Files:

WRITEFILE "note.txt" WITH "hello"

READFILE text = "note.txt"

SAY text

JSON:

SET user = {"name": "GdPy", "score": 10}

WRITEJSON "user.json" WITH user

READJSON loaded = "user.json"

SAY loaded["name"]

Strings:

SET text = " hello,world "

STRIP clean = text

SPLIT parts = clean BY ","

JOIN line = parts BY " | "

SAY line

Example scripts in this project

-------------------------------

example.gdpy

examples/arithmetic.gdpy

examples/libraries.gdpy

examples/collections.gdpy

examples/control_flow.gdpy

examples/files_json.gdpy

examples/strings.gdpy

examples/rights_error.gdpy

examples/system_fun.gdpy