atrace 0.1.5__tar.gz → 0.1.6__tar.gz

{atrace-0.1.5 → atrace-0.1.6}/.github/workflows/publish-to-pypi.yml

@@ -25,8 +25,12 @@ jobs:
         uses: astral-sh/setup-uv@v7
       - name: Install Python 3.13
         run: uv python install 3.13
-      - name: Check
-        run: uv run ruff check src
+      - name: Lint
+        run: uv run ruff check src tests
+      - name: Type check
+        run: uv run mypy src tests
+      - name: Run tests
+        run: uv run pytest
       - name: Build
         run: uv build
       - name: Publish

atrace-0.1.6/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: atrace
+Version: 0.1.6
+Summary: Generate trace tables for programs
+Project-URL: Repository, https://github.com/nwolff/atrace.git
+Author-email: Nicholas Wolff <nwolff@gmail.com>
+Requires-Python: >=3.10
+Requires-Dist: tabulate>=0.9.0
+Description-Content-Type: text/markdown
+
+# Usage
+
+Automatically prints a trace table of a program once the execution is finished.
+
+Just import the module.
+
+An idea of how things look:
+
+```
+
+```
+
+Does not work with :
+
+- Multithreaded programs
+- Multi-module programs
+- Classes
+
+# TODO
+
+- Unit tests for the capture part (because the line numbers are so hard). If pytest adds too much magic, then revert to UnitTest
+- Fix line numbers in trace_vars. https://discuss.python.org/t/trace-a-line-after-the-line-but-not-only-before-the-line/89475/7
+  This might not even be possible. Start solving it without functions in the scope.
+
+- Handle returns (with and without return statements)
+
+- Thonny, which adds a lot of indirection and magic. Try and find a way to edit the package directly when running in thonny
+
+# Later
+
+- localize the names of the line and output columns in the report
+
+# Done
+
+- Sets the program print to stdout unhindered (this is important for input to work properly),
+  but captures the prints at the same time to show in the trace at the end.
+- Emits the trace at the end if the application ends normally and abruptly (exception, signal, etc.)
+- Shows bindings to local variables when entering a function
+- Handles mutations to objects like lists (by copying the previous version and then comparing)
+- Parallel assignations show up properly
+- Changes to variables in other scopes (for instance global)
+
+# Build
+
+Automatically deployed to pypi every time a new tag is pushed: https://pypi.org/project/atrace/
+
+# Inspiration
+
+https://github.com/DarshanLakshman/PyTracerTool/blob/master/PyTracerTool/pytracertool.py
+
+Does almost everything I want, but has many flaws:
+
+- it chokes trying to deepcopy some objects
+- it cannot be simply imported into a module
+- it fumbles the handling of output (preventing programs with input from working properly).
+- it repeats values for no good reason
+- its line numbers are very confused

atrace-0.1.6/README.md

@@ -0,0 +1,57 @@
+# Usage
+
+Automatically prints a trace table of a program once the execution is finished.
+
+Just import the module.
+
+An idea of how things look:
+
+```
+
+```
+
+Does not work with :
+
+- Multithreaded programs
+- Multi-module programs
+- Classes
+
+# TODO
+
+- Unit tests for the capture part (because the line numbers are so hard). If pytest adds too much magic, then revert to UnitTest
+- Fix line numbers in trace_vars. https://discuss.python.org/t/trace-a-line-after-the-line-but-not-only-before-the-line/89475/7
+  This might not even be possible. Start solving it without functions in the scope.
+
+- Handle returns (with and without return statements)
+
+- Thonny, which adds a lot of indirection and magic. Try and find a way to edit the package directly when running in thonny
+
+# Later
+
+- localize the names of the line and output columns in the report
+
+# Done
+
+- Sets the program print to stdout unhindered (this is important for input to work properly),
+  but captures the prints at the same time to show in the trace at the end.
+- Emits the trace at the end if the application ends normally and abruptly (exception, signal, etc.)
+- Shows bindings to local variables when entering a function
+- Handles mutations to objects like lists (by copying the previous version and then comparing)
+- Parallel assignations show up properly
+- Changes to variables in other scopes (for instance global)
+
+# Build
+
+Automatically deployed to pypi every time a new tag is pushed: https://pypi.org/project/atrace/
+
+# Inspiration
+
+https://github.com/DarshanLakshman/PyTracerTool/blob/master/PyTracerTool/pytracertool.py
+
+Does almost everything I want, but has many flaws:
+
+- it chokes trying to deepcopy some objects
+- it cannot be simply imported into a module
+- it fumbles the handling of output (preventing programs with input from working properly).
+- it repeats values for no good reason
+- its line numbers are very confused

{atrace-0.1.5 → atrace-0.1.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atrace"
-version = "0.1.5"
+version = "0.1.6"
 description = "Generate trace tables for programs"
 readme = "README.md"
 authors = [{ name = "Nicholas Wolff", email = "nwolff@gmail.com" }]
@@ -15,7 +15,12 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [dependency-groups]
-dev = ["mypy>=1.19.1", "ruff>=0.14.14"]
+dev = [
+ "mypy>=1.19.1",
+ "pytest>=9.0.2",
+ "ruff>=0.14.14",
+ "types-tabulate>=0.9.0.20241207",
+]
 
 [tool.uv.workspace]
 members = ["src/examples"]

{atrace-0.1.5 → atrace-0.1.6}/src/atrace/__init__.py

@@ -3,27 +3,13 @@ import inspect
 import signal
 import sys
 from types import FrameType
-from typing import Any, Optional
+from typing import Optional
 
 from . import model, outputlogger, report, vartracer
 
 trace: model.Trace = []
 
 
-def just_kicking_off(frame: FrameType, event: str, arg: Any):
-    return None
-
-
-def get_importer_frame() -> Optional[FrameType]:
-    # Get the current call stack
-    for frame_info in inspect.stack():
-        # Filter out internal importlib frames and the current module's frame
-        filename = frame_info.filename
-        if not filename.startswith("<") and filename != __file__:
-            return frame_info.frame
-    return None
-
-
 original_stdout = sys.stdout
 
 
@@ -37,12 +23,19 @@ def sig_handler(_signo, _frame):
     sys.exit(0)
 
 
+def get_importer_frame() -> Optional[FrameType]:
+    # Get the current call stack
+    for frame_info in inspect.stack():
+        # Filter out internal importlib frames and the current module's frame
+        filename = frame_info.filename
+        if not filename.startswith("<") and filename != __file__:
+            return frame_info.frame
+    return None
+
+
 def setup():
     """See https://docs.python.org/3/library/sys.html#sys.settrace for an explanation of all the convoluted things in here"""
 
-    # This kicks off the tracing machinery (so that the lines below work)
-    sys.settrace(just_kicking_off)
-
     # We want to only trace the module that imports us
     importer_frame = get_importer_frame()
     if importer_frame:
@@ -50,12 +43,13 @@ def setup():
         if module_of_interest:
             var_tracer = vartracer.VarTracer(trace, module_of_interest)
 
+            # Setup tracing inside of functions.
+            # Order is important. This must be called before seting the trace function for the current frame
+            sys.settrace(var_tracer.trace_vars)
+
             # Setup tracing outside of functions
             importer_frame.f_trace = var_tracer.trace_vars
 
-            # Setup tracing inside of functions
-            sys.settrace(var_tracer.trace_vars)
-
     sys.stdout = outputlogger.OutputLogger(trace=trace, stdout=sys.stdout)
 
     atexit.register(exit_handler)
@@ -64,4 +58,21 @@ def setup():
         signal.signal(sig, sig_handler)
 
 
-setup()
+def var_trace_for_code(code: str) -> model.Trace:
+    trace: model.Trace = []
+    # We want to only trace the module that imports us
+    importer_frame = get_importer_frame()
+    if importer_frame:
+        module_of_interest = inspect.getmodule(importer_frame)
+        if module_of_interest:
+            var_tracer = vartracer.VarTracer(trace, module_of_interest)
+            try:
+                sys.settrace(var_tracer.trace_vars)
+                exec(code)
+            finally:
+                sys.settrace(None)
+    return trace
+
+
+if "pytest" not in sys.modules:
+    setup()

{atrace-0.1.5 → atrace-0.1.6}/src/atrace/model.py

@@ -2,28 +2,34 @@ from dataclasses import dataclass
 from typing import Any, TypeAlias
 
 
-@dataclass
+@dataclass(frozen=True)
 class PrintEvent:
     text: str
 
 
 @dataclass(frozen=True)
 class Variable:
-    function_name: str | None
+    scope: str
     name: str
 
 
+@dataclass(frozen=True)
+class ReturnEvent:
+    function_name: str
+    return_value: Any
+
+
 @dataclass(frozen=True)
 class VariableChangeEvent:
     variable: Variable
     value: Any
 
 
-@dataclass
+@dataclass(frozen=True)
 class TraceItem:
     line_no: int
     function_name: str
-    event: PrintEvent | VariableChangeEvent
+    event: PrintEvent | VariableChangeEvent | ReturnEvent
 
 
 Trace: TypeAlias = list[TraceItem]

{atrace-0.1.5 → atrace-0.1.6}/src/atrace/outputlogger.py

@@ -6,7 +6,7 @@ from . import model
 
 class OutputLogger:
     """
-    OutputLogger wraps stdout, writing to it and simultaneously capturing the text to the trace.
+    OutputLogger wraps stdout, passing down writes and flushes to it, while simultaneously capturing the text to the trace.
     """
 
     def __init__(self, trace: model.Trace, stdout: TextIO):

atrace-0.1.6/src/atrace/report.py

@@ -0,0 +1,74 @@
+from dataclasses import dataclass
+from typing import Any, TypeAlias
+
+from tabulate import tabulate
+
+from . import model
+
+
+@dataclass
+class Instant:
+    line_no: int
+    variable_changes: dict[model.Variable, Any]
+    output: str
+
+
+Instants: TypeAlias = list[Instant]
+
+
+def trace_to_instants(trace: model.Trace) -> Instants:
+    instants = []
+    instant = None
+    for trace_item in trace:
+        if instant is None or instant.line_no != trace_item.line_no:
+            instant = Instant(trace_item.line_no, {}, "")
+            instants.append(instant)
+
+        match trace_item.event:
+            case model.PrintEvent(text):
+                instant.output += text
+            case model.VariableChangeEvent(variable, value):
+                # Don't clobber an existing value a variable if it changes again on the same line
+                # (this happens for example in tight loops)
+                if variable in instant.variable_changes:
+                    instant = Instant(trace_item.line_no, {}, "")
+                    instants.append(instant)
+                instant.variable_changes[variable] = value
+            case model.ReturnEvent():
+                pass  # XXX
+
+    return instants
+
+
+def variable_to_column_name(var: model.Variable) -> str:
+    return var.name if var.scope == "<module>" else f"({var.scope}) {var.name}"
+
+
+def formatted_table_from_instants(instants: Instants) -> str:
+    variables = []
+
+    for instant in instants:
+        for variable in instant.variable_changes:
+            if variable not in variables:
+                variables.append(variable)
+
+    LINE_NO, OUTPUT = "ligne", "affichage"
+
+    table = []
+    for instant in instants:
+        row: dict[str, Any] = {}
+        table.append(row)
+
+        row[LINE_NO] = instant.line_no
+        for variable in variables:
+            cell_for_variable = instant.variable_changes.get(variable, "")
+            row[variable_to_column_name(variable)] = cell_for_variable
+        row[OUTPUT] = instant.output
+
+    return tabulate(table, headers="keys", tablefmt="simple_outline")
+
+
+def dump_report(trace: model.Trace) -> None:
+    instants = trace_to_instants(trace)
+    formatted_table = formatted_table_from_instants(instants)
+    print(formatted_table)

{atrace-0.1.5 → atrace-0.1.6}/src/atrace/vartracer.py

@@ -33,13 +33,21 @@ class VarTracer:
     def __init__(self, trace: model.Trace, module_of_interest: ModuleType):
         self.trace = trace
         self.module_of_interest = module_of_interest
-        self.last_locals = {}
+        self.last_locals: dict[str, Any] = {}
 
     def trace_vars(self, frame: FrameType, event: str, arg: Any):
         if inspect.getmodule(frame) != self.module_of_interest:
             return
         if event == "return":
-            return
+            self.trace.append(
+                model.TraceItem(
+                    line_no=frame.f_lineno,
+                    function_name=frame.f_code.co_name,
+                    event=model.ReturnEvent(
+                        function_name=frame.f_code.co_name, return_value=arg  # XXX
+                    ),
+                )
+            )
 
         code = frame.f_code
 
@@ -57,9 +65,7 @@ class VarTracer:
                         line_no=frame.f_lineno,
                         function_name=frame.f_code.co_name,
                         event=model.VariableChangeEvent(
-                            variable=model.Variable(
-                                function_name=code.co_name, name=var
-                            ),
+                            variable=model.Variable(scope=code.co_name, name=var),
                             value=new_val,
                         ),
                     )

{atrace-0.1.5 → atrace-0.1.6}/src/examples/complete_example.py

@@ -7,6 +7,8 @@ while x < y:
 
 print("x", x)
 
+t = (1, 2)
+
 kids = ["riri", "fifi", "loulou"]
 while kids:
     print(kids.pop(0))
@@ -21,8 +23,6 @@ def double(a):
     return b
 
 
-ligne = 666  # To test if it messes up the table header ligne
-
 print(double(6))
 
 

atrace-0.1.6/src/examples/function_example.py

@@ -0,0 +1,9 @@
+import atrace  # noqa
+
+
+def f(a, b):
+    c = a + b
+    return c
+
+
+print(f(3, 14))

atrace-0.1.6/src/examples/global_example.py

@@ -0,0 +1,13 @@
+import atrace  # noqa
+
+c = "first value of c"
+
+
+def f(a, b):
+    global c
+    c = a + b
+    d = a - b
+    return c, d
+
+
+print(f(3, 14))

atrace-0.1.6/src/examples/small_example.py

@@ -0,0 +1,18 @@
+import atrace  # noqa
+
+x, y = 1, 3
+
+while x < y:
+    x = x + 1
+
+print("x:", x)
+
+t = 1, 2
+
+
+def f(a, b):
+    c = a + " " + b
+    return c + "!"
+
+
+print(f("Bonjour", "tout le monde"))

atrace-0.1.6/tests/no_test_sample.py

@@ -0,0 +1,16 @@
+# import sys
+
+import atrace
+
+# from atrace import model, vartracer
+
+code = """
+print("hello")
+x = 1
+x = x + 1
+y, z = 7, 8
+"""
+
+trace = atrace.var_trace_for_code(code)
+print(trace)
+assert 1 == 0  # To show the output

atrace-0.1.6/tests/test_report.py

@@ -0,0 +1,151 @@
+import pytest
+
+from atrace.model import (
+    PrintEvent,
+    ReturnEvent,
+    TraceItem,
+    Variable,
+    VariableChangeEvent,
+)
+from atrace.report import Instant, trace_to_instants
+
+
+def test_simple_assignments():
+    trace = [
+        TraceItem(
+            line_no=1,
+            function_name="<module>",
+            event=VariableChangeEvent(Variable("<module>", "x"), 1),
+        ),
+        TraceItem(
+            line_no=2,
+            function_name="<module>",
+            event=VariableChangeEvent(Variable("<module>", "y"), 2),
+        ),
+    ]
+
+    assert trace_to_instants(trace) == [
+        Instant(
+            line_no=1,
+            variable_changes={Variable("<module>", "x"): 1},
+            output="",
+        ),
+        Instant(
+            line_no=2,
+            variable_changes={Variable("<module>", "y"): 2},
+            output="",
+        ),
+    ]
+
+
+def test_parallel_assignments():
+    trace = [
+        TraceItem(
+            line_no=1,
+            function_name="<module>",
+            event=VariableChangeEvent(Variable("<module>", "x"), 1),
+        ),
+        TraceItem(
+            line_no=1,
+            function_name="<module>",
+            event=VariableChangeEvent(Variable("<module>", "y"), 2),
+        ),
+    ]
+
+    assert trace_to_instants(trace) == [
+        Instant(
+            line_no=1,
+            variable_changes={
+                Variable("<module>", "x"): 1,
+                Variable("<module>", "y"): 2,
+            },
+            output="",
+        )
+    ]
+
+
+def test_assignments_in_tight_loop():
+    trace = [
+        TraceItem(
+            line_no=1,
+            function_name="<module>",
+            event=VariableChangeEvent(Variable("<module>", "x"), 1),
+        ),
+        TraceItem(
+            line_no=1,
+            function_name="<module>",
+            event=VariableChangeEvent(Variable("<module>", "x"), 2),
+        ),
+    ]
+
+    assert trace_to_instants(trace) == [
+        Instant(
+            line_no=1,
+            variable_changes={Variable("<module>", "x"): 1},
+            output="",
+        ),
+        Instant(
+            line_no=1,
+            variable_changes={Variable("<module>", "x"): 2},
+            output="",
+        ),
+    ]
+
+
+def test_simple_output():
+    trace = [
+        TraceItem(line_no=1, function_name="<module>", event=PrintEvent("hello")),
+        TraceItem(line_no=2, function_name="<module>", event=PrintEvent("world")),
+    ]
+
+    assert trace_to_instants(trace) == [
+        Instant(
+            line_no=1,
+            variable_changes={},
+            output="hello",
+        ),
+        Instant(
+            line_no=2,
+            variable_changes={},
+            output="world",
+        ),
+    ]
+
+
+def test_coalesce_output():
+    trace = [
+        TraceItem(line_no=1, function_name="<module>", event=PrintEvent("hello")),
+        TraceItem(line_no=1, function_name="<module>", event=PrintEvent("world")),
+    ]
+
+    assert trace_to_instants(trace) == [
+        Instant(
+            line_no=1,
+            variable_changes={},
+            output="helloworld",
+        ),
+    ]
+
+
+@pytest.mark.skip(reason="no way of currently testing this")
+def test_return_value():
+    trace = [
+        TraceItem(
+            line_no=1,
+            function_name="f",
+            event=VariableChangeEvent(Variable("f", "x"), 1),
+        ),
+        TraceItem(
+            line_no=2,
+            function_name="f",
+            event=ReturnEvent("f>", "a return value"),
+        ),
+    ]
+
+    assert trace_to_instants(trace) == [
+        Instant(
+            line_no=1,
+            variable_changes={Variable("f", "x"): 1},
+            output="",
+        ),
+    ]

{atrace-0.1.5 → atrace-0.1.6}/uv.lock

@@ -10,7 +10,7 @@ members = [
 
 [[package]]
 name = "atrace"
-version = "0.1.5"
+version = "0.1.6"
 source = { editable = "." }
 dependencies = [
     { name = "tabulate" },
@@ -19,7 +19,9 @@ dependencies = [
 [package.dev-dependencies]
 dev = [
     { name = "mypy" },
+    { name = "pytest" },
     { name = "ruff" },
+    { name = "types-tabulate" },
 ]
 
 [package.metadata]
@@ -28,7 +30,18 @@ requires-dist = [{ name = "tabulate", specifier = ">=0.9.0" }]
 [package.metadata.requires-dev]
 dev = [
     { name = "mypy", specifier = ">=1.19.1" },
+    { name = "pytest", specifier = ">=9.0.2" },
     { name = "ruff", specifier = ">=0.14.14" },
+    { name = "types-tabulate", specifier = ">=0.9.0.20241207" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
 ]
 
 [[package]]
@@ -42,6 +55,27 @@ dependencies = [
 [package.metadata]
 requires-dist = [{ name = "tabulate", specifier = ">=0.9.0" }]
 
+[[package]]
+name = "exceptiongroup"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/0e/97c33bf5009bdbac74fd2beace167cab3f978feb69cc36f1ef79360d6c4e/exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598", size = 16740, upload-time = "2025-11-21T23:01:53.443Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
 [[package]]
 name = "librt"
 version = "0.7.8"
@@ -170,6 +204,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/79/7b/2c79738432f5c924bef5071f933bcc9efd0473bac3b4aa584a6f7c1c8df8/mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505", size = 4963, upload-time = "2025-04-22T14:54:22.983Z" },
 ]
 
+[[package]]
+name = "packaging"
+version = "26.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/65/ee/299d360cdc32edc7d2cf530f3accf79c4fca01e96ffc950d8a52213bd8e4/packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4", size = 143416, upload-time = "2026-01-21T20:50:39.064Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/b9/c538f279a4e237a006a2c98387d081e9eb060d203d8ed34467cc0f0b9b53/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366, upload-time = "2026-01-21T20:50:37.788Z" },
+]
+
 [[package]]
 name = "pathspec"
 version = "1.0.4"
@@ -179,6 +222,42 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ef/3c/2c197d226f9ea224a9ab8d197933f9da0ae0aac5b6e0f884e2b8d9c8e9f7/pathspec-1.0.4-py3-none-any.whl", hash = "sha256:fb6ae2fd4e7c921a165808a552060e722767cfa526f99ca5156ed2ce45a5c723", size = 55206, upload-time = "2026-01-27T03:59:45.137Z" },
 ]
 
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+    { name = "tomli", marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },
+]
+
 [[package]]
 name = "ruff"
 version = "0.14.14"
@@ -268,6 +347,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/23/d1/136eb2cb77520a31e1f64cbae9d33ec6df0d78bdf4160398e86eec8a8754/tomli-2.4.0-py3-none-any.whl", hash = "sha256:1f776e7d669ebceb01dee46484485f43a4048746235e683bcdffacdf1fb4785a", size = 14477, upload-time = "2026-01-11T11:22:37.446Z" },
 ]
 
+[[package]]
+name = "types-tabulate"
+version = "0.9.0.20241207"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/3f/43/16030404a327e4ff8c692f2273854019ed36718667b2993609dc37d14dd4/types_tabulate-0.9.0.20241207.tar.gz", hash = "sha256:ac1ac174750c0a385dfd248edc6279fa328aaf4ea317915ab879a2ec47833230", size = 8195, upload-time = "2024-12-07T02:54:42.554Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5e/86/a9ebfd509cbe74471106dffed320e208c72537f9aeb0a55eaa6b1b5e4d17/types_tabulate-0.9.0.20241207-py3-none-any.whl", hash = "sha256:b8dad1343c2a8ba5861c5441370c3e35908edd234ff036d4298708a1d4cf8a85", size = 8307, upload-time = "2024-12-07T02:54:41.031Z" },
+]
+
 [[package]]
 name = "typing-extensions"
 version = "4.15.0"

atrace-0.1.5/PKG-INFO

@@ -1,86 +0,0 @@
-Metadata-Version: 2.4
-Name: atrace
-Version: 0.1.5
-Summary: Generate trace tables for programs
-Project-URL: Repository, https://github.com/nwolff/atrace.git
-Author-email: Nicholas Wolff <nwolff@gmail.com>
-Requires-Python: >=3.10
-Requires-Dist: tabulate>=0.9.0
-Description-Content-Type: text/markdown
-
-# Usage
-
-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/
-
-An idea of how things look:
-
-```
-+-----------+-----+-----+---------+---------------+-----------------------+-------------------------+
-|    ligne  |   x |   y | (f) a   | (f) b         | (f) c                 |  affichage              |
-+===========+=====+=====+=========+===============+=======================+=========================+
-|         5 |   1 |   3 |         |               |                       |                         |
-|         7 |   2 |     |         |               |                       |                         |
-|         5 |     |   2 |         |               |                       |                         |
-|         7 |   3 |     |         |               |                       |                         |
-|         5 |     |   1 |         |               |                       |                         |
-|         7 |   4 |     |         |               |                       |                         |
-|         5 |     |     |         |               |                       |                         |
-|         9 |     |     |         |               |                       | somme:  4               |
-|        12 |     |     | Bonjour | tout le monde |                       |                         |
-|        14 |     |     |         |               | Bonjour tout le monde | Bonjour tout le monde ! |
-+-----------+-----+-----+---------+---------------+-----------------------+-------------------------+
-```
-
-Does not work with :
-
-- Multithreaded programs
-- Multi-module programs
-- Classes
-
-# TODO
-
-- Fix line numbers in trace_vars. https://discuss.python.org/t/trace-a-line-after-the-line-but-not-only-before-the-line/89475/7
-  This is a bitch
-- Thonny, which adds a lot of indirection and magic
-
-# Later
-
-- Make robust. In other words should never raise an exception.
-- mypy, unit-tests. Integrate in build pipeline
-- localize the names of the line and output columns in the report
-- Handle classes better
-
-# Possible enhancements
-
-- More details when recursive invocations
-- Think about how to show returns
-- Find if there could be a good use for colors in the trace
-
-# Done
-
-- Sets the program print to stdout unhindered (this is important for input to work properly),
-  but captures the prints at the same time to show in the trace at the end.
-- Emits the trace at the end if the application ends normally and abruptly (exception, signal, etc.)
-- Shows bindings to local variables when entering a function
-- Handles mutations to objects like lists (by copying the previous version and then comparing)
-- Parallel assignations show up properly
-
-# Build
-
-Automatically deployed to pypi every time a new tag is pushed: https://pypi.org/project/atrace/
-
-# Inspiration
-
-https://github.com/DarshanLakshman/PyTracerTool/blob/master/PyTracerTool/pytracertool.py
-
-Does almost everything I want, but has many flaws:
-
-- it chokes trying to deepcopy some objects
-- it cannot be simply imported into a module
-- it fumbles the handling of output (preventing programs with input from working properly).
-- it repeats values for no good reason
-- its line numbers are very confused

atrace-0.1.5/README.md

@@ -1,76 +0,0 @@
-# Usage
-
-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/
-
-An idea of how things look:
-
-```
-+-----------+-----+-----+---------+---------------+-----------------------+-------------------------+
-|    ligne  |   x |   y | (f) a   | (f) b         | (f) c                 |  affichage              |
-+===========+=====+=====+=========+===============+=======================+=========================+
-|         5 |   1 |   3 |         |               |                       |                         |
-|         7 |   2 |     |         |               |                       |                         |
-|         5 |     |   2 |         |               |                       |                         |
-|         7 |   3 |     |         |               |                       |                         |
-|         5 |     |   1 |         |               |                       |                         |
-|         7 |   4 |     |         |               |                       |                         |
-|         5 |     |     |         |               |                       |                         |
-|         9 |     |     |         |               |                       | somme:  4               |
-|        12 |     |     | Bonjour | tout le monde |                       |                         |
-|        14 |     |     |         |               | Bonjour tout le monde | Bonjour tout le monde ! |
-+-----------+-----+-----+---------+---------------+-----------------------+-------------------------+
-```
-
-Does not work with :
-
-- Multithreaded programs
-- Multi-module programs
-- Classes
-
-# TODO
-
-- Fix line numbers in trace_vars. https://discuss.python.org/t/trace-a-line-after-the-line-but-not-only-before-the-line/89475/7
-  This is a bitch
-- Thonny, which adds a lot of indirection and magic
-
-# Later
-
-- Make robust. In other words should never raise an exception.
-- mypy, unit-tests. Integrate in build pipeline
-- localize the names of the line and output columns in the report
-- Handle classes better
-
-# Possible enhancements
-
-- More details when recursive invocations
-- Think about how to show returns
-- Find if there could be a good use for colors in the trace
-
-# Done
-
-- Sets the program print to stdout unhindered (this is important for input to work properly),
-  but captures the prints at the same time to show in the trace at the end.
-- Emits the trace at the end if the application ends normally and abruptly (exception, signal, etc.)
-- Shows bindings to local variables when entering a function
-- Handles mutations to objects like lists (by copying the previous version and then comparing)
-- Parallel assignations show up properly
-
-# Build
-
-Automatically deployed to pypi every time a new tag is pushed: https://pypi.org/project/atrace/
-
-# Inspiration
-
-https://github.com/DarshanLakshman/PyTracerTool/blob/master/PyTracerTool/pytracertool.py
-
-Does almost everything I want, but has many flaws:
-
-- it chokes trying to deepcopy some objects
-- it cannot be simply imported into a module
-- it fumbles the handling of output (preventing programs with input from working properly).
-- it repeats values for no good reason
-- its line numbers are very confused

atrace-0.1.5/src/atrace/report.py

@@ -1,98 +0,0 @@
-from dataclasses import dataclass
-from typing import Any
-
-from tabulate import tabulate
-
-from . import model
-
-
-def collect_variable_list(trace: model.Trace) -> list[model.Variable]:
-    variable_list = []
-    for traceItem in trace:
-        match traceItem.event:
-            case model.VariableChangeEvent(variable_name, _):
-                if variable_name not in variable_list:
-                    variable_list.append(variable_name)
-    return variable_list
-
-
-def coalesce_print_events(trace: model.Trace) -> model.Trace:
-    last_print_item = None
-    for trace_item in trace:
-        match trace_item.event:
-            case model.PrintEvent(text):
-                if (
-                    last_print_item is None
-                    or trace_item.line_no != last_print_item.line_no
-                ):
-                    last_print_item = trace_item
-                else:
-                    last_print_item.event.text += text
-                    trace_item.event = None  # Mark for deletion
-            case _:
-                last_print_item = None
-
-    return [item for item in trace if item.event is not None]
-
-
-def contains_prints(trace: model.Trace) -> bool:
-    for trace_item in trace:
-        match trace_item.event:
-            case model.PrintEvent:
-                return True
-    return False
-
-
-def variable_to_column_name(var: model.Variable) -> str:
-    context = None if var.function_name == "<module>" else var.function_name
-    return "(" + context + ") " + var.name if context else var.name
-
-
-@dataclass
-class Line:
-    line_no: int
-    variable_changes: dict[str, Any]
-    output: str | None
-
-
-def dump_report(trace: model.Trace) -> None:
-    trace = coalesce_print_events(trace)
-
-    # Build intermediate "lines" datastructure, that collects all events that happen on a given line
-    lines = []
-    current_line = None
-    for trace_item in trace:
-        if current_line is None or current_line.line_no != trace_item.line_no:
-            current_line = Line(trace_item.line_no, {}, None)
-            lines.append(current_line)
-
-        match trace_item.event:
-            case model.VariableChangeEvent(variable, value):
-                # Don't clobber a new value if it changes on the same line
-                # (this happens for example in tight loops)
-                if variable in current_line.variable_changes:
-                    current_line = Line(trace_item.line_no, {}, None)
-                    lines.append(current_line)
-
-                current_line.variable_changes[variable_to_column_name(variable)] = value
-            case model.PrintEvent(text):
-                current_line.output = text
-
-    # The extra spaces so the names cannot collide with variable names
-    LINE_NO, OUTPUT = " ligne", "affichage "
-
-    variable_list = collect_variable_list(trace)
-    headers = [LINE_NO] + [variable_to_column_name(v) for v in variable_list] + [OUTPUT]
-    table = []
-    for line in lines:
-        table_row = [line.line_no]
-        for column_name in headers[1:-1]:
-            variable_value = line.variable_changes.get(column_name)
-            if variable_value:
-                table_row.append(variable_value)
-            else:
-                table_row.append(None)
-        table_row.append(line.output)
-        table.append(table_row)
-
-    print(tabulate(table, headers=headers, tablefmt="outline"))

atrace-0.1.5/src/examples/example_with_classes.py

@@ -1,14 +0,0 @@
-import atrace  # noqa
-
-
-class Animal:
-    def __init__(self, name):
-        self.name = name
-
-
-class Cat(Animal):
-    pass
-
-
-ivy = Cat("Ivy Megaman")
-print(ivy)

atrace-0.1.5/src/examples/small_example.py

@@ -1,17 +0,0 @@
-import atrace  # noqa
-
-x, y = 1, 3
-
-while y > 0:
-    x = x + 1
-    y = y - 1
-
-print("somme: ", x)
-
-
-def f(a, b):
-    c = a + " " + b
-    print(c, "!")
-
-
-f("Bonjour", "tout le monde")