retracesoftware-proxy 0.2.17__py3-none-any.whl → 0.2.18__py3-none-any.whl

retracesoftware/__main__.py

@@ -90,6 +90,9 @@ def checksums():
 
 def record(options, args):
     
+    if options.verbose:
+        print(f"Retrace enabled, recording to {options.recording}", file=sys.stderr)
+
     path = Path(expand_recording_path(options.recording))
     # ensure the path exists
     path.mkdir(parents=True, exist_ok=True) 

retracesoftware/install/patcher.py

@@ -61,12 +61,39 @@ def create_patcher(system):
 
     per_thread = PerThread()
         
+    # Hash patching for deterministic record/replay
+    # 
+    # Why we patch __hash__:
+    # Python's default object hashes are based on memory addresses, which vary
+    # between runs. Sets iterate in hash order, so iteration order is 
+    # non-deterministic. For record/replay to work correctly, we need identical
+    # set iteration order during both phases, so we replace __hash__ with a
+    # deterministic counter-based hash that returns stable values.
+    # (Note: dicts maintain insertion order since Python 3.7, so they're stable.)
+    #
+    # The hashfunc dispatches based on thread state:
+    # - disabled: returns None (unhashable, triggers fallback)
+    # - internal: counter for when thread is inside the sandbox (proxied code)
+    # - external: counter for when thread is outside the sandbox (user code)
+    #
+    # IMPORTANT - Python 3.12 compatibility:
+    # Python 3.12 changed typing._tp_cache to use a global _caches dict with
+    # functions as keys (see bpo GH-98253). If typing is imported BEFORE we
+    # patch FunctionType.__hash__, those functions won't be in our internal
+    # hash cache, and lookups will fail. utils.patch_hash handles this by
+    # pre-populating the cache with all existing instances of the patched type.
+    #
     hashfunc = system.thread_state.dispatch(
         functional.constantly(None),
         internal = functional.repeatedly(functional.partial(getattr, per_thread, 'internal')),
         external = functional.repeatedly(functional.partial(getattr, per_thread, 'external')))
 
     def patch_hash(obj):
+        """Patch __hash__ on a type to use deterministic counter-based hashing.
+        
+        This ensures stable set iteration order for instances of this type,
+        which is required for record/replay consistency.
+        """
         if not isinstance(obj, type):
             raise Exception("TODO")
 

{retracesoftware_proxy-0.2.17.dist-info → retracesoftware_proxy-0.2.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: retracesoftware_proxy
-Version: 0.2.17
+Version: 0.2.18
 License: Apache-2.0
 Requires-Python: >=3.11
 Requires-Dist: retracesoftware_utils

{retracesoftware_proxy-0.2.17.dist-info → retracesoftware_proxy-0.2.18.dist-info}/RECORD

@@ -1,5 +1,5 @@
 retracesoftware/__init__.py,sha256=jQw15XBREFZX93BHpvREfc-hQmMUHYtO6gO-qZmdW1o,482
-retracesoftware/__main__.py,sha256=tJR_vKz6-WRCXlioto2PP92SC_K-GPAKoT05fsA8Px0,9761
+retracesoftware/__main__.py,sha256=FwxTltjG1CnARYD4bdPLNiTTc8cF7WryLdBSDSg0zF0,9871
 retracesoftware/autoenable.py,sha256=6KxpaPpeleSN7-qmekA4w2HJQaet_9Flt9WikQvyN04,1808
 retracesoftware/config.json,sha256=Cw5YZCfTo8GLmtbTH2LYwST7wNe7925DAwsTtRIGhBE,3817
 retracesoftware/config.yaml,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -16,7 +16,7 @@ retracesoftware/install/edgecases.py,sha256=Ry3BETJ4Hmqpw9xXTlNeUgBL9q-sumaazqjm
 retracesoftware/install/globals.py,sha256=F8XvIoZQQ10gSRalk30dvdKllxlwxkaggYY6FogLDxY,510
 retracesoftware/install/install.py,sha256=fP7E9OWiQd1Dgi4jL8rL9T5SXW5AL62BM3NEW61fisw,4969
 retracesoftware/install/modulepatcher.py,sha256=yBXrbfr5J9JQXCVbcNpDm8H17bsPbL6DY54bImFjBKM,16715
-retracesoftware/install/patcher.py,sha256=DL8GKQzxCSVdTXeexgRuPaKL51SsymcPpP6lUJ1Ezo8,4364
+retracesoftware/install/patcher.py,sha256=Z98ux8SDw53wyRKCevOT-tPOFcwcM3KH1dyR7Tg_TJ4,5859
 retracesoftware/install/patchfindspec.py,sha256=uQkfdOQOY20hFAcwDAqx7m8rbtGM2rBKOfC3Szb1zhw,4942
 retracesoftware/install/phases.py,sha256=OWaw86xzC924tdIA9C-12Qdr3sCx67hEOn-Ih9FM--4,9359
 retracesoftware/install/predicate.py,sha256=tX7NQc0rGkyyHYO3mduYHcJHbw1wczT53m_Dpkzo6do,2679
@@ -39,7 +39,7 @@ retracesoftware/proxy/serializer.py,sha256=S5yhHoP2iYaXBY7Jr8Ei630Z31521x0IO6Deu
 retracesoftware/proxy/startthread.py,sha256=YKUcOSjA-9_5ZsDHhyP0fXJSP3RWDKV-ajX-I0SI-bU,1270
 retracesoftware/proxy/stubfactory.py,sha256=fyQtCZnkXvLaTlGcxE0Lx8od09ZOgnPWPn0YvNFfVeQ,6219
 retracesoftware/proxy/thread.py,sha256=AAj6BL4kw-KMHX4fV66LuePQbTYvPmI3IY8ZwV069nI,3073
-retracesoftware_proxy-0.2.17.dist-info/METADATA,sha256=_t4czKiwu0bwCYVOr24gXZS_QlH4cufaqEIn5f97asM,227
-retracesoftware_proxy-0.2.17.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-retracesoftware_proxy-0.2.17.dist-info/top_level.txt,sha256=hYHsR6txLidmqvjBMITpIHvmJJbmoCAgr76-IpZPRz8,16
-retracesoftware_proxy-0.2.17.dist-info/RECORD,,
+retracesoftware_proxy-0.2.18.dist-info/METADATA,sha256=KZeS6LA5Mqcp9H-ofq3949xU3ad9DmQdhp7sDmuw1k0,227
+retracesoftware_proxy-0.2.18.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+retracesoftware_proxy-0.2.18.dist-info/top_level.txt,sha256=hYHsR6txLidmqvjBMITpIHvmJJbmoCAgr76-IpZPRz8,16
+retracesoftware_proxy-0.2.18.dist-info/RECORD,,