Achieved 100.00% branch coverage: +1/1 branchless code objects covered. +0/0 branches covered.
+| + 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 + 10 + 11 + 12 + 13 + 14 + 15 + 16 + 17 + 18 + 19 + 20 + 21 + 22 + 23 + 24 + 25 + 26 + 27 + 28 + 29 + 30 + 31 + 32 + 33 + 34 + 35 + 36 + 37 + 38 + 39 + 40 + 41 + 42 + 43 + 44 + 45 + 46 + 47 + 48 + 49 + 50 + 51 + 52 + 53 + 54 + 55 + 56 + 57 + 58 + 59 + 60 + 61 + 62 + 63 + 64 + 65 + 66 + 67 + 68 + 69 + 70 + 71 + 72 + 73 + 74 + 75 + 76 + 77 + 78 + 79 + 80 + 81 + 82 + 83 + 84 + 85 + 86 + 87 + 88 + | +import argparse
+from argparse import ArgumentParser, RawDescriptionHelpFormatter
+from .lexer import Lexer
+from .parser import Parser
+from .evaluator import evaluate, setup_runtime
+import textwrap
+import code
+
+class Repl(code.InteractiveConsole): # pragma: no cover
+ env = {}
+
+ def runsource(self, source: str, filename="<input>", symbol="single"):
+ lexer = Lexer(source)
+ parser = Parser(lexer)
+ expressions = parser.run()
+ evaluate(expressions, self.env)
+
+
+def read_file_contents(filename: str) -> str | None: # pragma: no cover
+ if filename is None:
+ raise ValueError("filename cannot be None")
+ try:
+ with open(filename, "r") as file:
+ contents = file.read()
+ return contents
+ except FileNotFoundError:
+ print(f"error: file `{filename}` doesn't exist")
+ return None
+
+
+def main():# pragma: no cover
+ usage_message = "interpret [-h | --help] [--debug] [file] [-- arg]"
+ arg_parser = ArgumentParser(
+ usage=usage_message,
+ description=textwrap.dedent("""
+ An interpreter for simple programming language developed for Software Measurement and
+ Quality Assurance coursework.
+
+ Checkout https://github.com/JackyLeicester/Coursework for the syntax of the language.
+ """),
+ formatter_class=RawDescriptionHelpFormatter,
+ epilog=textwrap.dedent("""
+ Copyright © 2025
+ Jacky Liang Xu, Myrza Danike, Syed Fasiuddin, Vatsal Chaudhari."""),
+ )
+ arg_parser.add_argument("file", nargs="?", help=": program read from script file")
+ arg_parser.add_argument("--debug", action="store_true", help="enable debug output")
+ arg_parser.add_argument(
+ "args",
+ nargs=argparse.REMAINDER,
+ help=": additional argument after `--` passed through",
+ )
+ args = arg_parser.parse_args()
+
+ if not args.file:
+ repl = Repl()
+ repl.interact(banner="", exitmsg="")
+ exit(0)
+
+ contents = read_file_contents(args.file)
+ if not contents:
+ exit(1)
+
+ lexer = Lexer(contents)
+
+ # Debug: Will execute if run with "--debug" argument
+ if args.debug:
+ print("=== TOKENS ===")
+ token, token_str = lexer.next_token()
+ while token.name != "EOF":
+ print(f"{token.name:15} {token_str}")
+ token, token_str = lexer.next_token()
+ print(f"{token.name:15} {token_str}")
+
+ lexer = Lexer(contents)
+ parser = Parser(lexer)
+ expressions = parser.run()
+
+ # Since our language doesn't support arrays, we can only pass one argument
+ # to the script, if we add functionality of arrays then we can pass in
+ # `argc` and `argv` similar to how its done in C.
+ env = None
+ if len(args.args) > 1:
+ arg_parser.print_usage()
+ exit(1)
+ if len(args.args) == 1:
+ env = setup_runtime(args.args[0])
+ return evaluate(expressions, env)
+ |
+