jupyter-python-tutor 0.2.0__tar.gz → 0.3.1__tar.gz

{jupyter_python_tutor-0.2.0 → jupyter_python_tutor-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jupyter-python-tutor
-Version: 0.2.0
+Version: 0.3.1
 Summary: Python Tutor-style step-by-step code visualization for JupyterLab 4.x and Notebook 7
 Author: dive4dec
 License-Expression: MIT
@@ -34,10 +34,10 @@ In a Jupyter cell:
 %load_ext jupyter_python_tutor
 ```
 
-Then use the `%%tutor` cell magic:
+Then use the `%%pytutor` cell magic:
 
 ```python
-%%tutor
+%%pytutor
 x = 3
 y = x + 4
 print(y)
@@ -66,9 +66,10 @@ from frame variables to heap objects (like [Python Tutor](https://pythontutor.co
 ## Options
 
 ```
-%%tutor --max-steps 1000   # Limit trace steps (default: 5000)
-%%tutor --raw              # Output trace as JSON instead of HTML
-%%tutor --height 400       # Set minimum widget height (default: 500)
+%%pytutor --max-steps 1000   # Limit trace steps (default: 5000)
+%%pytutor --raw              # Output trace as JSON instead of HTML
+%%pytutor --height 400       # Set minimum widget height (default: 500)
+%%pytutor --input 2026       # Pre-collected input for input() calls
 ```
 
 ## Examples
@@ -76,7 +77,7 @@ from frame variables to heap objects (like [Python Tutor](https://pythontutor.co
 ### Loops
 
 ```python
-%%tutor
+%%pytutor
 total = 0
 for i in range(5):
     total += i
@@ -86,7 +87,7 @@ print(f"Sum: {total}")
 ### Functions with recursion
 
 ```python
-%%tutor
+%%pytutor
 def factorial(n):
     if n <= 1:
         return 1
@@ -99,7 +100,7 @@ print(result)
 ### Classes and inheritance
 
 ```python
-%%tutor
+%%pytutor
 class Animal:
     def __init__(self, name):
         self.name = name
@@ -116,7 +117,7 @@ print(d.speak())
 
 ## How It Works
 
-1. **Tracing**: The `%%tutor` magic compiles the cell code and executes it under
+1. **Tracing**: The `%%pytutor` magic compiles the cell code and executes it under
    `sys.settrace()`. At each line/call/return event, a snapshot of all local and
    global variables is captured. AST analysis (`ast.parse`) extracts the set of
    names the traced code touches, so only code-relevant variables are shown
@@ -136,7 +137,7 @@ print(d.speak())
 4. **JupyterLab 4 compatibility**: JupyterLab 4's HTML sanitizer (DOMPurify)
    strips JavaScript and external URLs from untrusted notebooks. The iframe
    `srcdoc` approach bypasses this entirely in trusted notebooks. Run
-   `jupyter trust your_notebook.ipynb` after executing cells with `%%tutor`
+   `jupyter trust your_notebook.ipynb` after executing cells with `%%pytutor`
    to ensure the visualization renders correctly.
 
 ## Limitations

{jupyter_python_tutor-0.2.0 → jupyter_python_tutor-0.3.1}/README.md

@@ -14,10 +14,10 @@ In a Jupyter cell:
 %load_ext jupyter_python_tutor
 ```
 
-Then use the `%%tutor` cell magic:
+Then use the `%%pytutor` cell magic:
 
 ```python
-%%tutor
+%%pytutor
 x = 3
 y = x + 4
 print(y)
@@ -46,9 +46,10 @@ from frame variables to heap objects (like [Python Tutor](https://pythontutor.co
 ## Options
 
 ```
-%%tutor --max-steps 1000   # Limit trace steps (default: 5000)
-%%tutor --raw              # Output trace as JSON instead of HTML
-%%tutor --height 400       # Set minimum widget height (default: 500)
+%%pytutor --max-steps 1000   # Limit trace steps (default: 5000)
+%%pytutor --raw              # Output trace as JSON instead of HTML
+%%pytutor --height 400       # Set minimum widget height (default: 500)
+%%pytutor --input 2026       # Pre-collected input for input() calls
 ```
 
 ## Examples
@@ -56,7 +57,7 @@ from frame variables to heap objects (like [Python Tutor](https://pythontutor.co
 ### Loops
 
 ```python
-%%tutor
+%%pytutor
 total = 0
 for i in range(5):
     total += i
@@ -66,7 +67,7 @@ print(f"Sum: {total}")
 ### Functions with recursion
 
 ```python
-%%tutor
+%%pytutor
 def factorial(n):
     if n <= 1:
         return 1
@@ -79,7 +80,7 @@ print(result)
 ### Classes and inheritance
 
 ```python
-%%tutor
+%%pytutor
 class Animal:
     def __init__(self, name):
         self.name = name
@@ -96,7 +97,7 @@ print(d.speak())
 
 ## How It Works
 
-1. **Tracing**: The `%%tutor` magic compiles the cell code and executes it under
+1. **Tracing**: The `%%pytutor` magic compiles the cell code and executes it under
    `sys.settrace()`. At each line/call/return event, a snapshot of all local and
    global variables is captured. AST analysis (`ast.parse`) extracts the set of
    names the traced code touches, so only code-relevant variables are shown
@@ -116,7 +117,7 @@ print(d.speak())
 4. **JupyterLab 4 compatibility**: JupyterLab 4's HTML sanitizer (DOMPurify)
    strips JavaScript and external URLs from untrusted notebooks. The iframe
    `srcdoc` approach bypasses this entirely in trusted notebooks. Run
-   `jupyter trust your_notebook.ipynb` after executing cells with `%%tutor`
+   `jupyter trust your_notebook.ipynb` after executing cells with `%%pytutor`
    to ensure the visualization renders correctly.
 
 ## Limitations

{jupyter_python_tutor-0.2.0 → jupyter_python_tutor-0.3.1}/jupyter_python_tutor/__init__.py

@@ -2,7 +2,7 @@
 
 Usage in a Jupyter cell:
 
-    %%tutor
+    %%pytutor
     x = 3
     y = x + 4
     print(y)
@@ -11,6 +11,6 @@ from .tracer import trace_code
 from .renderer import render_trace
 from .magics import load_ipython_extension
 
-__version__ = "0.2.0"
+__version__ = "0.3.1"
 
 __all__ = ["trace_code", "render_trace", "load_ipython_extension"]

{jupyter_python_tutor-0.2.0 → jupyter_python_tutor-0.3.1}/jupyter_python_tutor/magics.py

@@ -2,15 +2,16 @@
 
 Usage in a Jupyter cell:
 
-    %%tutor
+    %%pytutor
     x = 3
     y = x + 4
     print(y)
 
 Options:
-    %%tutor --max-steps 1000   — limit the number of trace steps
-    %%tutor --raw              — output the trace as JSON instead of HTML
-    %%tutor --height 400       — set max-height of the variables panel (px)
+    %%pytutor --max-steps 1000   — limit the number of trace steps
+    %%pytutor --raw              — output the trace as JSON instead of HTML
+    %%pytutor --height 400       — set max-height of the variables panel (px)
+    %%pytutor --input 2026       — pre-collected input for input() calls
 """
 from __future__ import annotations
 
@@ -28,7 +29,7 @@ __all__ = ["TutorMagics", "load_ipython_extension", "unload_ipython_extension"]
 
 def _make_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
-        prog="%%tutor",
+        prog="%%pytutor",
         description="Trace Python code and display an interactive visualization.",
     )
     parser.add_argument(
@@ -43,15 +44,21 @@ def _make_parser() -> argparse.ArgumentParser:
         "--height", type=int, default=300,
         help="Max height of the variables panel in pixels (default: 300)",
     )
+    parser.add_argument(
+        "--input", action="append", default=[], metavar="VALUE",
+        help="Pre-collected input for input() calls. "
+             "Repeat --input for multiple values: --input 2026 --input John. "
+             "If omitted and code contains input(), a dialog prompts for values.",
+    )
     return parser
 
 
 @magics_class
 class TutorMagics(Magics):
-    """Register the %%tutor cell magic."""
+    """Register the %%pytutor cell magic."""
 
-    @cell_magic("tutor")
-    def tutor(self, line: str, cell: str):
+    @cell_magic("pytutor")
+    def pytutor(self, line: str, cell: str):
         """Trace the cell code and display an interactive visualization."""
         parser = _make_parser()
         try:
@@ -67,10 +74,17 @@ class TutorMagics(Magics):
         # debugger operates.
         user_ns = self.shell.user_ns
 
+        # Pre-collected inputs for input() calls.
+        # If --input is provided, use those values.
+        # If not provided but code contains input(), use empty list
+        # (input() returns empty string instead of blocking).
+        inputs = args.input if args.input else None
+
         steps = trace_code(
             cell,
             max_steps=args.max_steps,
             user_globals=user_ns,
+            inputs=inputs,
         )
 
         if args.raw:
@@ -105,5 +119,5 @@ def load_ipython_extension(ipython):
 
 def unload_ipython_extension(ipython):
     """Unload the extension."""
-    if "tutor" in ipython.magics_manager.magics["cell"]:
-        ipython.magics_manager.magics["cell"].pop("tutor", None)
+    if "pytutor" in ipython.magics_manager.magics["cell"]:
+        ipython.magics_manager.magics["cell"].pop("pytutor", None)