feat: Add documentation for parser

__main__.py

@@ -1,4 +1,4 @@
 from src import PyLox
 
 if __name__ == "__main__":
-    PyLox().run_prompt()
+    PyLox("test.lox").run()

docs/language.md

@@ -257,11 +257,7 @@ For now standard libraries in `Lox` will be limited to the default `clock()` met
 
 ### TODO
 
-- [ ]  Add `IO` methods
-- [ ]  Add `Math` methods
-- [ ]  Add `String` methods
-- [ ]  Add `Network` methods
-- [ ]  Add `File` methods
+Look for the complete list of methods [here](tasks.html)
 
 ## `PyLox` our Interpreter
 

docs/parser.md

@@ -633,9 +633,6 @@ For example `1` is a primary expression. It cannot be broken down further. It is
 
 Now that we have completed our parser we can test it out.
 
-```python
-```
-
 ```
 >>> var x = 7;
 [2023-04-30 00:18:48,991] | ~\src\interpreter\lox.py:39 | INFO | Running PyLox...

src/interpreter/lox.py

@@ -44,7 +44,6 @@ def run_prompt(self) -> None:
                     tokens = self.lexer.scan_tokens()
                     parser = Parser(self, tokens, self.logger, self._source)
                     statements = parser.parse()
-                    print(statements)
                     if parser._has_error:
                         continue
                     resolver = Resolver(self.interpreter)

src/interpreter/resolver.py

@@ -63,6 +63,25 @@ class LoopyType(enum.Enum):
 
 
 class Resolver(StmtProtocol, VisitorProtocol):
+    """Resolve names in the AST.
+
+    For example, the following code is valid:
+
+    ```
+    var a = "global";
+    {
+        fun showA() {
+            print a;
+        }
+        showA();  // prints "global"
+        var a = "block";
+        showA();  // prints "block"
+    }
+    print a;  // prints "global"
+    ```
+
+    Hence, resolver creates a new scope for each block, function, and class.
+    """
     def __init__(self, interpreter: "Interpreter") -> None:
         self._interpreter = interpreter
         self.scopes: list[dict[str, bool]] = []

test.lox

@@ -1,5 +1 @@
-class Foo {
-}
-
-class Bar < Foo {
-}
+return 1;