sco1-pylox 0.3.2

A Python interpreter for the Lox programming language.

pylox

Introduction

This is my Python implementation of an interpreter for the Lox programming language from Robert Nystrom's Crafting Interpreters.

Python?

While the text is implemented in Java and C as its high & low-level implementations, I have no idea how to write either of them! Instead, I'll be using Python for the high-level implementation & eventually Rust for the low-level imeplementation.

Differences From Text

For the sake of fitting within a decently sized text, the fully implemented Lox spec omits features that users of other programming languages may miss. Often these are discussed as notes within a chapter, or presented as challenges at the end of a chapter. Significant difference in this implementation from the text reference are noted below.

Defined by Challenges

• (Chapter 4): Arbitrarily nested block comments (/* ... */)
• (Chapter 9): break statements are available for for and while loops

User Choice

• Division by zero returns NaN (Python's float('nan'))
• Strings may be defined using either " or '
• Modulo operator (%)
• Power operator (^)
• Integer division operator (\)
• Both floats and integers are represented
  • Return type from operations follows Python3's semantics
• Containers
  • array()

Additional Built-ins:

Unless otherwise noted, behavior mirrors the similarly named Python function

• abs
• ceil
• divmod
• floor
• input
• len
• max
• mean
• median
• min
• mode
• ord
• read_text (via pathlib.Path.read_text)
• std
• str2num
• string_array
  • Gives a LoxArray whose contents are equivalent to collections.deque(<some string>)