atrace 0.1.1__tar.gz → 0.1.2__tar.gz

{atrace-0.1.1 → atrace-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atrace
-Version: 0.1.1
+Version: 0.1.2
 Summary: Generate trace tables for programs
 Project-URL: Repository, https://github.com/nwolff/atrace.git
 Author-email: Nicholas Wolff <nwolff@gmail.com>
@@ -9,14 +9,21 @@ Description-Content-Type: text/markdown
 
 # TODO:
 
-- entering a function, binding the local arguments, returning
 - ignore function definitions (look at the type of object)
 
 - display at end only
 
-# Usage and intent
+- entering a function, binding the local arguments, returning
+
+# Usage
 
-A package that automatically prints a trace table of a program, just by importing the module
+Automatically prints a trace table of a program once the execution is finished.
+
+Just import the module.
+
+An animated example of a trace table: https://www.101computing.net/using-trace-tables/
+
+# Requirements
 
 - Should not interfere with the running program (apart from capturing stdout)
 - Should display the trace at the end of execution (not while the program is interacting with the user)
@@ -28,7 +35,10 @@ A package that automatically prints a trace table of a program, just by importin
   - binding the local arguments
   - returning
 
-An animated example of a trace table: https://www.101computing.net/using-trace-tables/
+# Supported environments
+
+- Thonny, which adds a shitload of magic
+- python 3.10+
 
 # Not in scope
 

{atrace-0.1.1 → atrace-0.1.2}/README.md

@@ -1,13 +1,20 @@
 # TODO:
 
-- entering a function, binding the local arguments, returning
 - ignore function definitions (look at the type of object)
 
 - display at end only
 
-# Usage and intent
+- entering a function, binding the local arguments, returning
+
+# Usage
 
-A package that automatically prints a trace table of a program, just by importing the module
+Automatically prints a trace table of a program once the execution is finished.
+
+Just import the module.
+
+An animated example of a trace table: https://www.101computing.net/using-trace-tables/
+
+# Requirements
 
 - Should not interfere with the running program (apart from capturing stdout)
 - Should display the trace at the end of execution (not while the program is interacting with the user)
@@ -19,7 +26,10 @@ A package that automatically prints a trace table of a program, just by importin
   - binding the local arguments
   - returning
 
-An animated example of a trace table: https://www.101computing.net/using-trace-tables/
+# Supported environments
+
+- Thonny, which adds a shitload of magic
+- python 3.10+
 
 # Not in scope
 

{atrace-0.1.1 → atrace-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atrace"
-version = "0.1.1"
+version = "0.1.2"
 description = "Generate trace tables for programs"
 readme = "README.md"
 authors = [{ name = "Nicholas Wolff", email = "nwolff@gmail.com" }]

{atrace-0.1.1 → atrace-0.1.2}/src/atrace/__init__.py

@@ -4,24 +4,20 @@ import sys
 from types import FrameType
 from typing import Any
 
-paused = True
+module_of_interest = None
 last_locals = {}
 
-ignored_variables = set(
-    [
-        "tid",
-    ]
-)
 
-
-def ignore_variable(var: str):
-    return var in ignored_variables
+def ignore_variable(name: str, value: Any):
+    # if name.startswith("_"):
+    #    return True
+    return callable(value)  # Functions, modules, tout ça
 
 
 def copy_carefully_using_ignored_variables(d: dict[str, Any]):
     res = {}
     for k, v in d.items():
-        if not ignore_variable(k):
+        if not ignore_variable(k, v):
             res[k] = copy.deepcopy(v)
     return res
 
@@ -38,9 +34,8 @@ def copy_carefully(d: dict[str, Any]):
 
 
 def trace_vars(frame: FrameType, event: str, arg: Any):
-    if paused:
+    if inspect.getmodule(frame) != module_of_interest:
         return
-    # print(frame.f_lineno, frame.f_code.co_name, frame.f_locals, event)
     if event != "line":
         return trace_vars
     code = frame.f_code
@@ -58,15 +53,15 @@ def trace_vars(frame: FrameType, event: str, arg: Any):
     old_locals = last_locals[code.co_name]
 
     for var, new_val in locals_now.items():
-        if not ignore_variable(var):
+        if not ignore_variable(var, new_val):
             if var not in old_locals:
                 print(f"[{lineno}] NEW {var} = {new_val}")
             elif old_locals[var] != new_val:
                 print(f"[{lineno}] MODIFIED {var}: {old_locals[var]} → {new_val}")
 
-    for var in old_locals:
-        if not ignore_variable(var):
-            if var not in locals_now:
+    for var, old_val in old_locals.items():
+        if var not in locals_now:
+            if not ignore_variable(var, old_val):
                 print(f"[{lineno}] DELETED {var}")
 
     last_locals[code.co_name] = locals_now
@@ -87,15 +82,16 @@ def get_importer_frame():
     return None
 
 
-# This will work next time we enter a function.
 # It also kicks off the tracing machinery (so that the lines below work)
-sys.settrace(trace_vars)
+sys.settrace(just_kicking_off)
 
 
-# This reaches into the importing module's frame to setup tracing
+# This reaches into the importing module's frame to setup tracing of code outside of functions
 importer_frame = get_importer_frame()
 if importer_frame:
     importer_frame.f_trace = trace_vars
-    paused = False
+    module_of_interest = inspect.getmodule(importer_frame)
+    # This will work next time we enter a function.
+    sys.settrace(trace_vars)
 else:
     print("Cannot trace")

{atrace-0.1.1 → atrace-0.1.2}/src/example.py

@@ -31,4 +31,7 @@ def recursive_count(x):
         return 1 + recursive_count(x - 1)
 
 
-print(recursive_count(20))
+print(recursive_count(4))
+
+
+# raise Exception("an exception")