In the documentation, it is stated that ; represents the Console IO character. In the source code, hofstader.py lines 39-41 tokenize # as the "stdin/stdout" token. As such, current evaluation computes ; as a filename. Either the documentation should be updated to reflect that # is the appropriate operator, or the code should be changed to evaluate ; as the console operator.

https://github.com/AZHenley/hofstadter/blob/1c30c61a8b22e38b86b6883e618dea7b27e63692/hofstadter.py#L38-L41

In the above lines from the interpreter, the symbol for console io is denoted by #. Either the documentation should be updated to reflect that or the interpreter should be updated to be consistent with the documentation.

This program takes in a string from the user and removes all instances of the word "peanut" from the string in order for people with a peanut allergy to be able to read the string.

NOTE: The program will automatically try to read from a non-existing file in order to close and stop the program. If the user inputs an empty string or one without "peanut" in it then you must manually close the program using ctrl-c.

To Use: Run the program and enter a string of your choice that may or may not contain the word peanut and then hit the enter key. The program will then output the same string that was given just without peanut in the string. For example, you could type in:

• "Hello world." and the output would be: "" because the string does not need to be changed.
• "Hello peanut world." and the output would be: "Hello world."

NOTE: must manually quit the program after sorted input prints (ctrl-c/keyboard interrupt). Couldn't find a way to exit the program gracefully.

How to use: Type in 3 single-digit numbers (0-9) one line at a time. Example: 6 1 7

After hitting return/enter on the third input, the numbers will be printed out in numerical order. At this point, you must manually quit the program. I spent a while trying to figure out how to exit, but I haven't figured out a solution yet.

Takes 3 numbers and adds them together, printing the result. Tested for every combination of 0-9, undefined functionality for inputs outside those characters

Notes: Prevents lines from fully executing and getting frozen by putting !0 ?0 at the end. Some lines would get stuck if they began with ?<line>, not sure why but they were fixed with a swap to themselves. Works by counting down one input number at a time while simultaneously counting up the output. Expects const.txt to be in the directory where it is called. Exits by trying to read the non-existent file --.

Execution order / branching was forced by the following process:

• Have a line that is otherwise empty to hold an 'event' that marks the start of this group running
• Following 2+ lines begin with the same process of wiping, then concatenating the event
• If the event is active, wipe then concatenate what you are comparing against
• Each line must vary from this point by having mutually exclusive comparators, like ?<line> and !<line> or ?<line1> and ?<line2>
• Have the branch do some operations
• Wipe the event and write to the line corresponding to the next branch / event
• I varied this process slightly in my program by having the event line do the reading for the comparator, then adding a not conditional against the event symbol.

Most useful programs written in hofstadter will likely need some setup and cleanup utilities -- adding a __name__ check would allow for programmers to 'elegantly' import hofstadter into a python script which encompasses setup, execution, and cleanup.

Error:

Traceback (most recent call last):
  File "/home/cade/programs/hofstadter/hofstadter.py", line 221, in <module>
    evaluator = Evaluator([Line(x) for x in rawlines])
  File "/home/cade/programs/hofstadter/hofstadter.py", line 221, in <listcomp>
    evaluator = Evaluator([Line(x) for x in rawlines])
  File "/home/cade/programs/hofstadter/hofstadter.py", line 17, in __init__
    self.tokenize()
  File "/home/cade/programs/hofstadter/hofstadter.py", line 23, in tokenize
    t = self.nextToken()
  File "/home/cade/programs/hofstadter/hofstadter.py", line 76, in nextToken
    while not self.text[self.index].isspace() or escaped and self.index < length:
IndexError: string index out of range

https://github.com/AZHenley/hofstadter/blob/main/hofstadter.py#L76 has the conditional checks out of order, it change from:

            while not self.text[self.index].isspace() or escaped and self.index < length:

to:

            while self.index < length and not self.text[self.index].isspace() or escaped: