A structured BASIC interpreter written in Python.
usage: pybasic.py [-h] [-a] [-s AST_PATH] [program_name]
Execute pybasic programs, or start an REPL session.
positional arguments:
program_name The path of the source program to execute. If not
specified, an REPL session will be started.
optional arguments:
-h, --help show this help message and exit
-a, --ast Execute a binary abstract syntax tree file rather than
a source program. This will be ignored in REPL mode.
-s AST_PATH, --save AST_PATH
Save the binary abstract syntax tree of the source
program to the given path. The source program will not
be executed. This will be ignored in REPL mode.
Supported expressions:
<expression>
: Math expressions. Support operators: +
, -
, *
, /
, \
(exact division), MOD
, ^
(exponent)<rel_expression>
: Logic expressions. Support operators: AND
,
OR
, NOT
, =
(equals to), <>
Please note that =
in <rel_expression>
is different from =
in assignment statement.
Literal values and function calls are also treated as <expression>
. For example:
123 ' 123
123.5 ' 123.5
"123!" ' "123!"
{1, 2, 3} ' [1, 2, 3]
SQR(5) ' 2.23606797749979
Use LET <id> = <expression>
or simply <id> = <expression>
.
Declarations are not required, for a variable are defined immediately before it is assigned for the first time. However, you can still use DIM
to create an array filled with initial values. For example:
DIM A(5) AS INTEGER
PRINT A ' [0, 0, 0, 0, 0]
Supported logic control structures:
IF <rel_expression> THEN ... END IF
SELECT [CASE] <expression> ... CASE ... CASE ELSE ... END SELECT
SELECT CASE is simply syntactic sugar for IF. There is no fallthrough in SELECT CASE, so you don't need to BREAK explicitly at the end of a CASE.
Supported loop control structures:
WHILE <rel_expression> ... END WHILE / WEND
DO ... LOOP
DO ... LOOP WHILE / UNTIL <rel_expression>
FOR <id> = <expression> TO <expression> [STEP <expression>] ... NEXT [<id>] / END FOR
Please note that GOTO
is not supported.
Supported data types:
INTEGER
(mapped to Python type int
)DECIMAL
(mapped to Python type float
)STRING
(mapped to Python type str
)Please notice that pybasic does not actually store data types, which means the type of variables can be modified at runtime.
Use AS
operator to do type conversions. For example:
2.5 AS INTEGER ' 2
2.5 AS STRING ' "2.5"
Some functions are integrated, like SQR()
and etc.
Single-line functions can be defined with DEFUN
. For example:
DEFUN F(x) = x * x
PRINT F(5) ' 25
Multi-line functions can be defined with SUB ... END SUB
or FUNCTION ... END FUNCTION
.
Functions can be called directly by using the function name as an order. For example:
DEFUN PRTYES(s) = PRINT("yes! " + s)
SUB PRTYEAH(s)
PRINT "yeah! " + s
END SUB
PRTYES "pybasic" ' "yes! pybasic"
PRTYEAH "pybasic" ' "yeah! pybasic"
Pybasic provides STRUCT()
function to create a C-like structure. Once created, you may add members to a structure or access members using the "dot" grammar. For example:
FUNCTION PERSON(NAME, AGE)
THIS = STRUCT()
THIS.NAME = NAME
THIS.AGE = AGE
RETURN THIS
END FUNCTION
JOHN = PERSON("John Smith", 30)
PRINT JOHN.NAME ' "John Smith"
PRINT JOHN.AGE ' 30
Unlike most BASIC dialects, pybasic provides PRINT()
and INPUT()
functions instead of statements. WRITE()
is also provided to print without breaking the line. For example:
A = INPUT() AS INTEGER ' input 17
PRINT "My age is " + A ' "My age is 17"
Other than functions above, pybasic also provides file I/O functions OPEN()
, CLOSE()
, FPRINT()
, FINPUT()
, and FWRITE()
. For example:
' test.in: world
IFILE = OPEN("test.in")
OFILE = OPEN("test.out")
LINE = FINPUT(IFILE)
FPRINT OFILE, "hello, " + LINE
CLOSE IFILE
CLOSE OFILE
' test.out: hello, world
Use USE
to import a Python module or another pybasic program. Pybasic will try finding a file ended with .bas
or .py
following the module's name in the current working directory. If no such file is finded, an error will be raised. For example:
' HELLO.bas
FUNCTION PRTHELLO(A)
PRINT "Hello, " + A
END FUNCTION
# MORNING.py
from pybasic import global_table
@global_table.reflect('PRTMORN')
def print_morning(a):
print('Good morning, %s' % a)
' MAIN.bas
USE HELLO
USE MORNING
PRTHELLO "Jack" ' Hello, Jack
PRTMORN "Mary" ' Good morning, Mary
Any code in the module will be executed. If the module is python-based, it will be executed at runtime; if it is pybasic-based, it will be compiled into the main program before being executed.
There are some modules defined in ./basic_lib
. Pybasic will search in ./basic_lib
first when importing a module. However, it is not recommended to save your own modules in ./basic_lib
if you want others to run your program. Save in the working directory instead.