oscura 0.11.0__py3-none-any.whl → 0.12.0__py3-none-any.whl

oscura/sessions/legacy.py

@@ -18,6 +18,7 @@ import hashlib
 import hmac
 import pickle
 import secrets
+import threading
 from dataclasses import dataclass, field
 from datetime import datetime
 from enum import Enum
@@ -26,6 +27,17 @@ from typing import Any
 
 from oscura.core.exceptions import SecurityError
 
+# Global lock for security key generation to prevent race conditions (thread-level)
+_KEY_GENERATION_LOCK = threading.Lock()
+
+# Try to import fcntl for process-level file locking (Unix only)
+try:
+    import fcntl
+
+    HAS_FCNTL = True
+except ImportError:
+    HAS_FCNTL = False
+
 # Session file format constants
 _SESSION_MAGIC = b"OSC1"  # Magic bytes for new format with signature
 _SESSION_SIGNATURE_SIZE = 32  # SHA256 hash size in bytes
@@ -38,33 +50,82 @@ def _get_security_key() -> bytes:
     with restrictive permissions (0o600). This provides better security than a
     shared hardcoded key.
 
+    Uses both thread-level and process-level locking to prevent race conditions
+    during parallel key generation.
+
     Returns:
         32-byte security key for HMAC signing.
     """
     key_file = Path.home() / ".oscura" / "session_key"
-
-    if key_file.exists():
-        # Load existing key
+    lock_file = Path.home() / ".oscura" / "session_key.lock"
+
+    # Thread-level lock first
+    with _KEY_GENERATION_LOCK:
+        # Check if key exists
+        if key_file.exists():
+            try:
+                return key_file.read_bytes()
+            except (OSError, PermissionError):
+                # Fall back to generating new key if can't read
+                pass
+
+        # Create parent directory
+        key_file.parent.mkdir(parents=True, exist_ok=True)
+
+        # Process-level file lock for parallel pytest workers
+        if HAS_FCNTL:
+            # Use file locking on Unix systems
+            lock_file.parent.mkdir(parents=True, exist_ok=True)
+            with open(lock_file, "w") as lock_fd:
+                try:
+                    fcntl.flock(lock_fd.fileno(), fcntl.LOCK_EX)
+
+                    # Double-check after acquiring file lock
+                    if key_file.exists():
+                        try:
+                            key = key_file.read_bytes()
+                            fcntl.flock(lock_fd.fileno(), fcntl.LOCK_UN)
+                            return key
+                        except (OSError, PermissionError):
+                            pass
+
+                    # Generate new random key
+                    key = secrets.token_bytes(32)
+
+                    # Write with restrictive permissions
+                    try:
+                        key_file.write_bytes(key)
+                        key_file.chmod(0o600)  # Owner read/write only
+                    except (OSError, PermissionError):
+                        # Can't write key file - continue with ephemeral key
+                        pass
+
+                    fcntl.flock(lock_fd.fileno(), fcntl.LOCK_UN)
+                    return key
+                except OSError:
+                    # File locking failed, continue without lock
+                    pass
+
+        # Fallback without file locking (Windows or locking unavailable)
+        # Double-check one more time
+        if key_file.exists():
+            try:
+                return key_file.read_bytes()
+            except (OSError, PermissionError):
+                pass
+
+        # Generate new random key
+        key = secrets.token_bytes(32)
+
+        # Write with restrictive permissions
         try:
-            return key_file.read_bytes()
+            key_file.write_bytes(key)
+            key_file.chmod(0o600)  # Owner read/write only
         except (OSError, PermissionError):
-            # Fall back to generating new key if can't read
+            # Can't write key file - continue with ephemeral key
             pass
 
-    # Generate new random key
-    key_file.parent.mkdir(parents=True, exist_ok=True)
-    key = secrets.token_bytes(32)
-
-    # Write with restrictive permissions
-    try:
-        key_file.write_bytes(key)
-        key_file.chmod(0o600)  # Owner read/write only
-    except (OSError, PermissionError):
-        # Can't write key file - continue with ephemeral key
-        # This happens in read-only filesystems or restricted environments
-        pass
-
-    return key
+        return key
 
 
 _SECURITY_KEY = _get_security_key()

{oscura-0.11.0.dist-info → oscura-0.12.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oscura
-Version: 0.11.0
+Version: 0.12.0
 Summary: Python framework for hardware reverse engineering: signal analysis, protocol decoding, and automated dissector generation. Unified workflows from oscilloscope captures to Wireshark dissectors with IEEE-compliant measurements.
 Project-URL: Homepage, https://github.com/oscura-re/oscura
 Project-URL: Documentation, https://github.com/oscura-re/oscura/tree/main/docs
@@ -421,7 +421,7 @@ python3 .claude/hooks/validate_all.py # Must pass 5/5
 
 ## Project Status
 
-**Version**: [0.10.0](https://github.com/oscura-re/oscura/releases/latest) (2026-02-03)
+**Version**: [0.12.0](https://github.com/oscura-re/oscura/releases/latest) (2026-02-03)
 
 **Active Development**: Hypothesis-driven RE workflows, automotive protocol analysis (CAN-FD, J1939, OBD-II, UDS), unknown protocol inference (state machines, field detection, CRC recovery), multi-format loading, export automation
 
@@ -449,7 +449,7 @@ python3 .claude/hooks/validate_all.py # Must pass 5/5
   author = {Oscura Contributors},
   year = {2026},
   url = {https://github.com/oscura-re/oscura},
-  version = {0.10.0}
+  version = {0.12.0}
 }
 ```
 

{oscura-0.11.0.dist-info → oscura-0.12.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-oscura/__init__.py,sha256=DwhB48tFYd9xipcGCvkakl1Kskrj817d2wOnTYtIqXI,19119
+oscura/__init__.py,sha256=H-vPSx9MzJhUffDN4AjAFiJ1xsrUCiaKp_z0o-PdgIY,19119
 oscura/__main__.py,sha256=6qveGY8VHAHbxcrvxg8V4qxDCH0w0p1AMejDVHzVc88,11998
 oscura/convenience.py,sha256=YQgUr8zf386pQaOjXfNYhVL2NVUydRDVLoJizQW5_SU,29293
 oscura/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -8,6 +8,24 @@ oscura/analyzers/entropy.py,sha256=R3grNUbsPAyE5G3CwlvTgzWj_BLYFiJIXMLXrzMbDb8,2
 oscura/analyzers/measurements.py,sha256=ng5Qt2jyAvfKw3JQbJY_JNUqAOJEZwPo3UWa0xSg5Xk,697
 oscura/analyzers/signal_classification.py,sha256=-QSErG3WwLvv8mmM9WmcSszm9vbf8xHxrGwMmPlQUDk,17645
 oscura/analyzers/validation.py,sha256=uhpnGi9KP-yvKnpTr7U_XyvalKyMGvocpWhvO-Rltj8,23694
+oscura/analyzers/binary/__init__.py,sha256=ZvtDnPVEnJsUwpCPOsqquYbwrTAftQ8fuANZHAUELok,805
+oscura/analyzers/binary/core/__init__.py,sha256=fMn_vyTMRxOkbMDN5bHsoBL-mLMpCeTZFsFDguUWtYs,601
+oscura/analyzers/binary/core/file_access.py,sha256=3Vj-Vo41biQ-Er5ggHiHnJw7J8MWSRHWL3TW9y6UVfs,6083
+oscura/analyzers/binary/core/pipeline.py,sha256=8hqHfZec4g9GxDlUl86x-1wa2GA9DpXEldDFszMV1jg,5637
+oscura/analyzers/binary/core/results.py,sha256=Z0f2X8LlCLu8waQCG91vMY0knCKGSs03DWIjz68rkIU,5991
+oscura/analyzers/binary/detection/__init__.py,sha256=CJwb5hMpd6EmVtPfXX9NquBAW8RdYPi_vbuOqTpEZv0,388
+oscura/analyzers/binary/detection/encoding.py,sha256=0xp8BiTb8EDmrFOGyOGkSs9I0-t7wpse11RWdEnJF98,22398
+oscura/analyzers/binary/detection/patterns.py,sha256=BDgLU75sP_FbuFK72vK6z7v7Fkyo-L6naviZeEMwJ2E,11418
+oscura/analyzers/binary/detection/structure.py,sha256=NcPXEREXEF5jVU1on-AQrnn8JwN5EsJatj_7LY36lQM,22879
+oscura/analyzers/binary/export/__init__.py,sha256=UxTqVlZp6jdlIXDD2HaS8vJZYagMDrxJ_wcM7TAyYhA,190
+oscura/analyzers/binary/export/dissector.py,sha256=oG1idIdmmZk4AJy4V9nqA9Qj6zAwVz-OQKTJk9Np7Ew,5378
+oscura/analyzers/binary/inference/__init__.py,sha256=I3esl6ZGklO16D1HkzlQnIlZ_6pUAxCCHYeggk8YWEc,483
+oscura/analyzers/binary/inference/checksums.py,sha256=8xWGhYaWo7thqFq1BWGMOIRF0r0aXYaRHWwC6OyFoT0,6051
+oscura/analyzers/binary/inference/fields.py,sha256=SeI9OcmnWIB5KXA2J1DJceUbnX0FFoKyMkZX-tp0aJA,4915
+oscura/analyzers/binary/inference/sequences.py,sha256=3pHuT9Mihd_YakncPN7kMIsc0ZGrrtfFDEh4CFOTjXs,6818
+oscura/analyzers/binary/inference/timestamps.py,sha256=FFpbzyATaYrKorJACxhFkEkw4s0Tfz-LOZsUu256iGA,6537
+oscura/analyzers/binary/visualization/__init__.py,sha256=M8XHuO73DgEheE6bMv0DM_61CxRXHeLOm_mjJ2jpBNA,211
+oscura/analyzers/binary/visualization/structure_view.py,sha256=HrAeMIeNn-0rQEdUjDmgl2Fr4o1puZYAtpxrvKOS7S8,5188
 oscura/analyzers/digital/__init__.py,sha256=CrZxLveYI-nZ7INCZg-4zp8UP_uQRpMmX2vljzudJ6s,4228
 oscura/analyzers/digital/bus.py,sha256=Wf3QUKNSxzXaWItR1rdf32kELayywrIg0TC-OhKEub0,22717
 oscura/analyzers/digital/clock.py,sha256=2WihQyf2fUlKTDAOKrhQSStiuUw711CvR6bMbkiliAc,26088
@@ -163,7 +181,7 @@ oscura/api/server/templates/reports.html,sha256=LPdGkX-gXlg10FqNckB4WnY5eix0Tibh
 oscura/api/server/templates/session_detail.html,sha256=_NpjSi63fPulhWAJc2qhvN6cll3J3_TQ1mOp_ejf7Ns,2850
 oscura/api/server/templates/sessions.html,sha256=aAARmctGTaU7f-mtCpy-p13GRdTvR4jqTZ5MPIgbhG4,2346
 oscura/api/server/templates/waveforms.html,sha256=vxG9sPxcspsyV0ylpXf_8FzpTYDazPQcempY9iGljQ0,1977
-oscura/automotive/__init__.py,sha256=VCrOyBrV1S6fhgyEZY7GqZRbv6Yf8J2h_FV5gPEHdsI,2768
+oscura/automotive/__init__.py,sha256=gNfPcgjhMxQKzIA0SS2EkRghnVT2uJU8OAM7C3WkEBo,2768
 oscura/automotive/visualization.py,sha256=LD6Gia3kDqoB_jQkOeVmyRVLv1BPuTUVj6lJMVtbQWg,10664
 oscura/automotive/can/__init__.py,sha256=ZYxC8tMMi9Drm9adkH5yklypBTfIbf3D7BYA2SUp9fE,1491
 oscura/automotive/can/analysis.py,sha256=0z6MycxuJGusqDQhYEpHnGRmDw3OMf5yDbS8zI6GJO0,11251
@@ -181,7 +199,7 @@ oscura/automotive/dbc/__init__.py,sha256=HZlM2WAaaglpX4C9tJVkF7uZiaHW4iUPQAbhfJY
 oscura/automotive/dbc/generator.py,sha256=ayhwTwMjZlzh70fihVSTRFmDWEuGDZgwUYArWFG6TcM,29823
 oscura/automotive/dbc/parser.py,sha256=C5SL1bfJFZp0CYsw-ff8ysJ_57Us9dBoHZ1t6LVLGbo,4421
 oscura/automotive/dtc/__init__.py,sha256=09CgvnClJTQIvzgDOQ22CbcjGAg_zOhPlbm1-k-gl30,895
-oscura/automotive/dtc/data.json,sha256=5pddTolfBJjwimwp5epiMjUqSngZ1dur9LQlcHfdjrA,79331
+oscura/automotive/dtc/data.json,sha256=OrymnbjQkVMdJlIeQ6MUDIihkd9Kea-YvAizZwOZWcc,80011
 oscura/automotive/dtc/database.py,sha256=Ee1Jd4CbP5T4LON0Y2PdOkgdISHa8jf8c6znb0S_L00,9582
 oscura/automotive/flexray/__init__.py,sha256=2RuW8TR4M3tSDEfcj-pJQpGGSxGaw5GdyGSvjMnU8Lk,938
 oscura/automotive/flexray/analyzer.py,sha256=UG3e9tJSHGV7aR3WKwfVCrNDSVlT7ZgFm7vgCcw0qOo,16727
@@ -290,9 +308,9 @@ oscura/core/plugins/registry.py,sha256=XNtq0rBuppC1Z5V5RH74afW-LBnWSLc33lCE6BDZK
 oscura/core/plugins/versioning.py,sha256=d18sXMbgeWy_dVNaM7JWvCVIF6VgpnjIbjP8gdFfgSs,10785
 oscura/core/schemas/__init__.py,sha256=W33kQp0A8v9qZevqjm3T-1Fjrnou5cz0WCAbLRkwbgY,4327
 oscura/core/schemas/bus_configuration.json,sha256=gpcDsg04760KCaLeIDuWvP6RzRUcPZuQplJbe7xpc8E,9562
-oscura/core/schemas/device_mapping.json,sha256=I87-MWnXldVWIXRC1H-WgzNLszymRdnaxwE3B1z8qys,5415
-oscura/core/schemas/packet_format.json,sha256=NVa4RtwSye9QgD1pBi67nuCDRsVljudCpBBGjmZsMqk,12567
-oscura/core/schemas/protocol_definition.json,sha256=lThVXTWzh7GxN-XNb3h8Bh20l1NZUigivWBb04xvogs,11116
+oscura/core/schemas/device_mapping.json,sha256=sYOcc2zSe0rmMQN_vtg3Y5XeeDMktAO1ar8vAWl-E1M,5499
+oscura/core/schemas/packet_format.json,sha256=y2KavMGeOUlmjDq7AW_85bfTk3nHlGPuistpuVDdlAk,12893
+oscura/core/schemas/protocol_definition.json,sha256=VPHkgY4fAI-hUiRBtiqZvDNUGjp6_7O4xdi1z36IhCI,11256
 oscura/correlation/__init__.py,sha256=4H5lCJqBBG3_10oIPsdIOyCij8FlKtMxLp3SAYvSsRg,1537
 oscura/correlation/multi_protocol.py,sha256=Lce9AF2iqenpGRMYpSJ_LbXBA7nVK5mLbDEwHhbVldg,28260
 oscura/discovery/__init__.py,sha256=ytYa_s4PfKxRRopOdUGsmzUIDPevH25ze_VytBEX2Cw,1232
@@ -386,8 +404,8 @@ oscura/jupyter/exploratory/unknown.py,sha256=KaxpoP9tW9E7Ld16_3VaXaKszfcU2uw62Id
 oscura/jupyter/ui/__init__.py,sha256=XQJh89b_xRe1CB8jssjIdbVgQeLCplFzSkCiXQYKXFU,935
 oscura/jupyter/ui/formatters.py,sha256=roXZhaNLgypb30T6EGF805cDkrqsAh_RQ978iGLtlAU,13580
 oscura/jupyter/ui/progressive_display.py,sha256=Ew-xXek_f6-XkR0CZymyzYbYkbXn8qCZS6Usk2n86dQ,11993
-oscura/loaders/__init__.py,sha256=aqPopCVPBeZkreR38zvo-Lh94gk815t7o4NilUMRfic,20235
-oscura/loaders/binary.py,sha256=WYyoIHAkjfrJcCN0Rd3zjcAAUK5HZ1fu41FhgKhtkz0,5057
+oscura/loaders/__init__.py,sha256=qwIA1SULrb1M6rRq09PoiXu4T-jyTT2NzZFrs6kC0Fw,20394
+oscura/loaders/binary.py,sha256=zQn5JtNZ7F1-C0Ti1VhOhZ2Yh64QlFmZFuCrg2gaJ6Y,14597
 oscura/loaders/chipwhisperer.py,sha256=RK1dDdyRAr__4qA68CSdxxbXqk0btGgHRj6A6fHF3uc,12655
 oscura/loaders/configurable.py,sha256=7ms5dlVzF7PAam8fJRzBDRdLznfiKdonuYE7piPxbAQ,44478
 oscura/loaders/csv.py,sha256=hjToCQkXQEMUCOSBTf3a1d4AAsntvxYbW_jiccQ9JaM,918
@@ -470,7 +488,7 @@ oscura/sessions/__init__.py,sha256=gJMEZezGxt0KniCQNFinp65B9HwDDfmXkYiq3n4wWYk,2
 oscura/sessions/base.py,sha256=JjMO-QybHS55OqFZ4jZC1DTVehTKrxOgMPlSA5bwlkk,10847
 oscura/sessions/blackbox.py,sha256=nk1ZKapxwDSIHmweD9x7kSbiMOOLVdMqVN-lavRhYYI,26039
 oscura/sessions/generic.py,sha256=roecnb2ftlzyOyKioaB4N0klUJKfRsbPN1WyWO-YEws,6660
-oscura/sessions/legacy.py,sha256=RYerJGiO-Wov62phQhhtMHXJcV9bGeWxHI_PQGXKT6E,25631
+oscura/sessions/legacy.py,sha256=sXwGQ2mUQ0iGhiu8jWa9wmbYyKgCvqiehgD7PgbyoT4,27871
 oscura/side_channel/__init__.py,sha256=3-vgWWiaabnfZL6tXvzRtvXoUw4Gmquue0oFZ10amrU,1141
 oscura/utils/__init__.py,sha256=VGd2Hzqy1j47UtheI73Hc8GOPwIAi2SWX34CbOxhk1A,2771
 oscura/utils/autodetect.py,sha256=cP-_be6XK9neO28J2le1iZ8YLvPmfpc8L-p6KAlA6h8,9324
@@ -570,8 +588,8 @@ oscura/workflows/batch/logging.py,sha256=6YkTrOA2OSiRjYHmtRn-lL2wyNpya0sggVkgxsz
 oscura/workflows/batch/metrics.py,sha256=InbxaZmFQrANpp_RCcx5F3va55UaiQjhFJ-_SEKAS20,17322
 oscura/workflows/legacy/__init__.py,sha256=PqHw8AIWfP4-1lJEjCDC4c_O8GXYOcWodK9ciOnGJaU,409
 oscura/workflows/legacy/dag.py,sha256=tEhiWmOSdcEYKmrwYUETC0P5yN-_Cy9fEysPwTDVZ3A,12337
-oscura-0.11.0.dist-info/METADATA,sha256=YWJqgPrd73hr127e_dy1ip7sYIR0A7nF7Ab6PRcojqE,20170
-oscura-0.11.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-oscura-0.11.0.dist-info/entry_points.txt,sha256=QLBxd-iTjBQ5HidaVSkLBwvUsqxSG1ZTJ6i-0juu960,48
-oscura-0.11.0.dist-info/licenses/LICENSE,sha256=p1_oEK-oqWDXMFSv5mKbyYkgW-CPbCnFUvdICu490aY,1077
-oscura-0.11.0.dist-info/RECORD,,
+oscura-0.12.0.dist-info/METADATA,sha256=GJsEvV024r65hu9rlar5hc9sfk7saHdk8HuTqS8O5r8,20170
+oscura-0.12.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+oscura-0.12.0.dist-info/entry_points.txt,sha256=QLBxd-iTjBQ5HidaVSkLBwvUsqxSG1ZTJ6i-0juu960,48
+oscura-0.12.0.dist-info/licenses/LICENSE,sha256=p1_oEK-oqWDXMFSv5mKbyYkgW-CPbCnFUvdICu490aY,1077
+oscura-0.12.0.dist-info/RECORD,,