oscura 0.5.1__py3-none-any.whl → 0.7.0__py3-none-any.whl

oscura/{plugins → core/plugins}/manager.py

@@ -6,7 +6,7 @@ versioning, and CLI operations.
 
 
 Example:
-    >>> from oscura.plugins.manager import PluginManager
+    >>> from oscura.core.plugins.manager import PluginManager
     >>> manager = PluginManager()
     >>> manager.discover_and_load()
     >>> plugin = manager.get_plugin("uart_decoder")
@@ -19,21 +19,21 @@ import logging
 from pathlib import Path
 from typing import TYPE_CHECKING, Any
 
-from oscura.plugins.discovery import discover_plugins, get_plugin_paths
-from oscura.plugins.isolation import IsolationManager, PermissionSet, ResourceLimits
-from oscura.plugins.lifecycle import (
+from oscura.core.plugins.discovery import discover_plugins, get_plugin_paths
+from oscura.core.plugins.isolation import IsolationManager, PermissionSet, ResourceLimits
+from oscura.core.plugins.lifecycle import (
     DependencyGraph,
     PluginLifecycleManager,
 )
-from oscura.plugins.registry import (
+from oscura.core.plugins.registry import (
     PluginConflictError,
     PluginRegistry,
     PluginVersionError,
 )
-from oscura.plugins.versioning import MigrationManager
+from oscura.core.plugins.versioning import MigrationManager
 
 if TYPE_CHECKING:
-    from oscura.plugins.base import PluginBase, PluginCapability, PluginMetadata
+    from oscura.core.plugins.base import PluginBase, PluginCapability, PluginMetadata
 
 logger = logging.getLogger(__name__)
 

oscura/{plugins → core/plugins}/registry.py

@@ -5,7 +5,7 @@ registering, and accessing plugins.
 
 
 Example:
-    >>> from oscura.plugins.registry import register_plugin, get_plugin
+    >>> from oscura.core.plugins.registry import register_plugin, get_plugin
     >>> register_plugin(MyDecoder)
     >>> decoder = get_plugin("my_decoder")
 """
@@ -15,14 +15,14 @@ from __future__ import annotations
 import logging
 from typing import TYPE_CHECKING, Any
 
-from oscura.plugins.discovery import (
+from oscura.core.plugins.discovery import (
     OSCURA_API_VERSION,
     DiscoveredPlugin,
     discover_plugins,
 )
 
 if TYPE_CHECKING:
-    from oscura.plugins.base import PluginBase, PluginCapability, PluginMetadata
+    from oscura.core.plugins.base import PluginBase, PluginCapability, PluginMetadata
 
 logger = logging.getLogger(__name__)
 

oscura/{plugins → core/plugins}/versioning.py

@@ -13,7 +13,7 @@ from typing import TYPE_CHECKING, Any
 if TYPE_CHECKING:
     from collections.abc import Callable
 
-    from oscura.plugins.base import PluginBase
+    from oscura.core.plugins.base import PluginBase
 
 logger = logging.getLogger(__name__)
 

oscura/core/progress.py

@@ -23,7 +23,14 @@ import time
 import warnings
 from typing import TYPE_CHECKING, Protocol
 
-import psutil
+# Lazy import for optional system monitoring
+try:
+    import psutil
+
+    _HAS_PSUTIL = True
+except ImportError:
+    psutil = None  # type: ignore[assignment]
+    _HAS_PSUTIL = False
 
 if TYPE_CHECKING:
     from collections.abc import Callable
@@ -423,6 +430,10 @@ def check_memory_available(required_bytes: int, *, threshold: float = 0.8) -> bo
     References:
         PROG-003: Memory Usage Warnings
     """
+    # If psutil not available, assume memory is sufficient
+    if not _HAS_PSUTIL:
+        return True
+
     memory = psutil.virtual_memory()
     available_bytes = memory.available
     threshold_bytes = available_bytes * threshold
@@ -454,6 +465,10 @@ def warn_memory_usage(
     References:
         PROG-003: Memory Usage Warnings
     """
+    # If psutil not available, skip memory warning
+    if not _HAS_PSUTIL:
+        return
+
     memory = psutil.virtual_memory()
     available_bytes = memory.available
     threshold_bytes = available_bytes * threshold

oscura/core/provenance.py

@@ -17,8 +17,14 @@ import numpy as np
 if TYPE_CHECKING:
     from numpy.typing import NDArray
 
-# Oscura version (in production would import from __version__)
-OSCURA_VERSION = "0.1.0"
+# Oscura version dynamically imported from package metadata (SSOT: pyproject.toml)
+try:
+    from importlib.metadata import version
+
+    OSCURA_VERSION = version("oscura")
+except Exception:
+    # Fallback for development/testing when package not installed
+    OSCURA_VERSION = "0.0.0+dev"
 
 
 @dataclass

oscura/{schemas → core/schemas}/__init__.py

@@ -6,7 +6,7 @@ device mappings, bus configurations, and protocol definitions.
 
 
 Example:
-    >>> from oscura.schemas import load_schema, validate_config
+    >>> from oscura.core.schemas import load_schema, validate_config
     >>> schema = load_schema("packet_format")
     >>> validate_config(config_dict, "packet_format")
     True
@@ -18,7 +18,7 @@ import json
 from pathlib import Path
 from typing import Any
 
-from oscura.config.schema import (
+from oscura.core.config.schema import (
     ConfigSchema,
     get_schema_registry,
     register_schema,

oscura/{schemas → core/schemas}/device_mapping.json

@@ -149,20 +149,14 @@
           "type": "array",
           "description": "Device IDs to include (whitelist)",
           "items": {
-            "oneOf": [
-              { "type": "integer" },
-              { "type": "string", "pattern": "^0[xX][0-9A-Fa-f]+$" }
-            ]
+            "oneOf": [{ "type": "integer" }, { "type": "string", "pattern": "^0[xX][0-9A-Fa-f]+$" }]
           }
         },
         "exclude_devices": {
           "type": "array",
           "description": "Device IDs to exclude (blacklist)",
           "items": {
-            "oneOf": [
-              { "type": "integer" },
-              { "type": "string", "pattern": "^0[xX][0-9A-Fa-f]+$" }
-            ]
+            "oneOf": [{ "type": "integer" }, { "type": "string", "pattern": "^0[xX][0-9A-Fa-f]+$" }]
           }
         },
         "include_categories": {

oscura/{schemas → core/schemas}/packet_format.json

@@ -118,10 +118,7 @@
               },
               "value": {
                 "description": "Expected constant value for validation",
-                "oneOf": [
-                  { "type": "integer" },
-                  { "type": "array", "items": { "type": "integer" } }
-                ]
+                "oneOf": [{ "type": "integer" }, { "type": "array", "items": { "type": "integer" } }]
               },
               "description": {
                 "type": "string",
@@ -188,18 +185,7 @@
             },
             "type": {
               "type": "string",
-              "enum": [
-                "uint8",
-                "uint16",
-                "uint32",
-                "uint64",
-                "int8",
-                "int16",
-                "int32",
-                "int64",
-                "float32",
-                "float64"
-              ],
+              "enum": ["uint8", "uint16", "uint32", "uint64", "int8", "int16", "int32", "int64", "float32", "float64"],
               "description": "Sample data type"
             },
             "endian": {
@@ -303,10 +289,7 @@
             },
             "expected": {
               "description": "Expected value",
-              "oneOf": [
-                { "type": "integer" },
-                { "type": "array", "items": { "type": "integer" } }
-              ]
+              "oneOf": [{ "type": "integer" }, { "type": "array", "items": { "type": "integer" } }]
             },
             "on_failure": {
               "type": "string",
@@ -379,10 +362,7 @@
             },
             "pattern": {
               "description": "Idle pattern to detect",
-              "oneOf": [
-                { "type": "string", "enum": ["auto", "zeros", "ones"] },
-                { "type": "integer" }
-              ]
+              "oneOf": [{ "type": "string", "enum": ["auto", "zeros", "ones"] }, { "type": "integer" }]
             },
             "min_duration": {
               "type": "integer",

oscura/{schemas → core/schemas}/protocol_definition.json

@@ -241,12 +241,7 @@
         },
         "value": {
           "description": "Expected constant value for validation",
-          "oneOf": [
-            { "type": "integer" },
-            { "type": "number" },
-            { "type": "string" },
-            { "type": "array" }
-          ]
+          "oneOf": [{ "type": "integer" }, { "type": "number" }, { "type": "string" }, { "type": "array" }]
         },
         "condition": {
           "type": "string",
@@ -331,12 +326,7 @@
             },
             "expected": {
               "description": "Expected value",
-              "oneOf": [
-                { "type": "integer" },
-                { "type": "number" },
-                { "type": "string" },
-                { "type": "array" }
-              ]
+              "oneOf": [{ "type": "integer" }, { "type": "number" }, { "type": "string" }, { "type": "array" }]
             },
             "on_mismatch": {
               "type": "string",

oscura/core/types.py

@@ -44,6 +44,7 @@ class CalibrationInfo:
         coupling: Input coupling ("DC", "AC", "GND") (optional).
         bandwidth_limit: Bandwidth limit in Hz, None if disabled (optional).
         vertical_resolution: ADC resolution in bits (optional).
+        timebase_accuracy: Timebase accuracy in ppm (parts per million) (optional).
 
     Example:
         >>> from datetime import datetime
@@ -74,6 +75,7 @@ class CalibrationInfo:
     coupling: str | None = None
     bandwidth_limit: float | None = None
     vertical_resolution: int | None = None
+    timebase_accuracy: float | None = None
 
     def __post_init__(self) -> None:
         """Validate calibration info after initialization."""
@@ -85,6 +87,8 @@ class CalibrationInfo:
             raise ValueError(
                 f"vertical_resolution must be positive, got {self.vertical_resolution}"
             )
+        if self.timebase_accuracy is not None and self.timebase_accuracy <= 0:
+            raise ValueError(f"timebase_accuracy must be positive, got {self.timebase_accuracy}")
 
     @property
     def is_calibration_current(self) -> bool | None:

oscura/core/uncertainty.py

@@ -108,7 +108,7 @@ class MeasurementWithUncertainty:
             JCGM 100:2008 Section 5.1.6
         """
         if self.value == 0:
-            return float(np.inf)  # type: ignore[no-any-return]
+            return float(np.inf)
         return abs(self.uncertainty / self.value)
 
     @property
@@ -173,7 +173,7 @@ class UncertaintyEstimator:
             JCGM 100:2008 Section 4.2 (Type A evaluation)
         """
         if len(data) < 2:
-            return float(np.nan)  # type: ignore[no-any-return]
+            return float(np.nan)
         return float(np.std(data, ddof=1))  # Sample std (Bessel correction)
 
     @staticmethod
@@ -190,7 +190,7 @@ class UncertaintyEstimator:
             JCGM 100:2008 Section 4.2.3
         """
         if len(data) < 2:
-            return float(np.nan)  # type: ignore[no-any-return]
+            return float(np.nan)
         return float(np.std(data, ddof=1) / np.sqrt(len(data)))
 
     @staticmethod

oscura/correlation/__init__.py

@@ -0,0 +1,52 @@
+"""Multi-protocol correlation and session analysis.
+
+This module provides tools for correlating messages and sessions across
+different protocols (CAN, Ethernet, Serial, etc.) to discover cross-protocol
+communication patterns and dependencies.
+
+Example:
+    >>> from oscura.correlation import MultiProtocolCorrelator, ProtocolMessage
+    >>> correlator = MultiProtocolCorrelator(time_window=0.1, min_confidence=0.5)
+    >>>
+    >>> # Add messages from different protocols
+    >>> can_msg = ProtocolMessage(
+    ...     protocol="can",
+    ...     timestamp=1.234,
+    ...     message_id=0x123,
+    ...     payload=b"\\x01\\x02\\x03"
+    ... )
+    >>> eth_msg = ProtocolMessage(
+    ...     protocol="ethernet",
+    ...     timestamp=1.238,
+    ...     payload=b"\\x01\\x02\\x03\\x04"
+    ... )
+    >>> correlator.add_message(can_msg)
+    >>> correlator.add_message(eth_msg)
+    >>>
+    >>> # Find correlations
+    >>> correlations = correlator.correlate_all()
+    >>> print(f"Found {len(correlations)} correlations")
+    >>>
+    >>> # Extract sessions
+    >>> sessions = correlator.extract_sessions()
+    >>> print(f"Protocols used: {sessions[0].protocols}")
+
+References:
+    Network protocol analysis
+    Graph theory for dependency analysis
+    Session correlation algorithms
+"""
+
+from oscura.correlation.multi_protocol import (
+    MessageCorrelation,
+    MultiProtocolCorrelator,
+    ProtocolMessage,
+    SessionFlow,
+)
+
+__all__ = [
+    "MessageCorrelation",
+    "MultiProtocolCorrelator",
+    "ProtocolMessage",
+    "SessionFlow",
+]