oscura 0.1.2__py3-none-any.whl → 0.3.0__py3-none-any.whl

oscura/automotive/j1939/__init__.py

@@ -4,8 +4,6 @@ This module provides J1939 protocol decoding for heavy-duty vehicles
 (trucks, buses, agriculture, marine).
 """
 
-from __future__ import annotations
-
 __all__ = ["J1939Decoder", "J1939Message", "extract_pgn"]
 
 try:

oscura/automotive/loaders/__init__.py

@@ -8,8 +8,6 @@ This module provides loaders for common automotive logging file formats:
 - PCAP (Packet Capture - SocketCAN)
 """
 
-from __future__ import annotations
-
 __all__ = [
     "detect_format",
     "load_asc",

oscura/automotive/loaders/asc.py

@@ -9,8 +9,6 @@ ASC format example:
     0.010000 1 280 Rx d 8 0A 0B 0C 0D 0E 0F 10 11
 """
 
-from __future__ import annotations
-
 import re
 from pathlib import Path
 

oscura/automotive/loaders/blf.py

@@ -5,8 +5,6 @@ BLF is a proprietary binary format used by Vector tools (CANoe, CANalyzer, etc.)
 for logging CAN bus data.
 """
 
-from __future__ import annotations
-
 from pathlib import Path
 
 from oscura.automotive.can.models import CANMessage, CANMessageList

oscura/automotive/loaders/csv_can.py

@@ -9,8 +9,6 @@ Common CSV format:
     0.010000,0x280,0A0B0C0D0E0F1011
 """
 
-from __future__ import annotations
-
 import csv
 from pathlib import Path
 

oscura/automotive/obd/__init__.py

@@ -4,8 +4,6 @@ This module provides OBD-II (On-Board Diagnostics) protocol decoding
 for standard vehicle diagnostics.
 """
 
-from __future__ import annotations
-
 __all__ = ["PID", "OBD2Decoder", "OBD2Response"]
 
 try:

oscura/automotive/uds/__init__.py

@@ -36,8 +36,6 @@ Example:
     UDSService(0x10 DiagnosticSessionControl [Request], sub=0x01)
 """
 
-from __future__ import annotations
-
 __all__ = [
     "UDSDecoder",
     "UDSNegativeResponse",

oscura/automotive/uds/models.py

@@ -3,8 +3,6 @@
 This module defines the core data structures for UDS protocol analysis.
 """
 
-from __future__ import annotations
-
 from dataclasses import dataclass
 
 __all__ = [

oscura/cli/main.py

@@ -11,8 +11,6 @@ Example:
     $ oscura shell   # Interactive REPL
 """
 
-from __future__ import annotations
-
 import json
 import logging
 import sys

oscura/cli/shell.py

@@ -23,8 +23,6 @@ References:
     - IPython-style interaction patterns
 """
 
-from __future__ import annotations
-
 import atexit
 import code
 import contextlib

oscura/config/loader.py

@@ -9,8 +9,6 @@ Example:
     >>> config = load_config_file("pipeline.yaml", schema="pipeline")
 """
 
-from __future__ import annotations
-
 import json
 from pathlib import Path
 from typing import Any

oscura/core/backend_selector.py

@@ -43,7 +43,7 @@ except (ImportError, AttributeError):
     HAS_GPU = False
 
 try:
-    import numba  # type: ignore[import-untyped]
+    import numba  # type: ignore[import-not-found]
 
     HAS_NUMBA = True
     del numba

oscura/core/correlation.py

@@ -16,8 +16,6 @@ References:
     - Thread-local and async-safe context management
 """
 
-from __future__ import annotations
-
 import asyncio
 import contextvars
 import functools

oscura/core/exceptions.py

@@ -13,8 +13,6 @@ Example:
     ...
 """
 
-from __future__ import annotations
-
 from typing import Any
 
 # Documentation base URL
@@ -520,6 +518,61 @@ class ExportError(OscuraError):
         )
 
 
+class SecurityError(OscuraError):
+    """Security validation failed.
+
+    Raised when security checks fail, such as signature verification
+    or file integrity validation.
+
+    Attributes:
+        file_path: Path to the file that failed security checks.
+        check_type: Type of security check that failed.
+    """
+
+    docs_path: str = "errors#security"
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        file_path: str | None = None,
+        check_type: str | None = None,
+        details: str | None = None,
+        fix_hint: str | None = None,
+    ) -> None:
+        """Initialize SecurityError.
+
+        Args:
+            message: Brief description of the error.
+            file_path: Path to the file that failed security checks.
+            check_type: Type of security check that failed.
+            details: Additional context about the error.
+            fix_hint: Suggestion for how to fix the error.
+        """
+        self.file_path = file_path
+        self.check_type = check_type
+
+        details_parts = []
+        if file_path:
+            details_parts.append(f"File: {file_path}")
+        if check_type:
+            details_parts.append(f"Check: {check_type}")
+        if details:
+            details_parts.append(details)
+
+        combined_details = ". ".join(details_parts) if details_parts else None
+
+        if fix_hint is None:
+            fix_hint = "Only load files from trusted sources. File may be corrupted or tampered."
+
+        super().__init__(
+            message,
+            details=combined_details,
+            fix_hint=fix_hint,
+            docs_path=self.docs_path,
+        )
+
+
 __all__ = [
     "DOCS_BASE_URL",
     "AnalysisError",
@@ -530,6 +583,7 @@ __all__ = [
     "LoaderError",
     "OscuraError",
     "SampleRateError",
+    "SecurityError",
     "UnsupportedFormatError",
     "ValidationError",
 ]

oscura/core/lazy.py

@@ -49,7 +49,9 @@ from __future__ import annotations
 import functools
 import threading
 from dataclasses import dataclass
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, Generic, TypeVar
+
+T = TypeVar("T")
 
 if TYPE_CHECKING:
     from collections.abc import Callable
@@ -149,7 +151,7 @@ def reset_lazy_stats() -> None:
         _global_stats = LazyComputeStats()
 
 
-class LazyResult[T]:
+class LazyResult(Generic[T]):
     """Deferred computation wrapper with thread-safe compute-once semantics.
 
     Wraps a computation function that will be called only when the result is
@@ -557,7 +559,7 @@ class LazyDict(dict[str, Any]):
         ]
 
 
-def lazy[T](fn: Callable[..., T]) -> Callable[..., LazyResult[T]]:
+def lazy(fn: Callable[..., T]) -> Callable[..., LazyResult[T]]:
     """Decorator to make a function return a LazyResult.
 
     Wraps a function so it returns a LazyResult instead of computing

oscura/core/memory_limits.py

@@ -13,8 +13,6 @@ References:
     See oscura.config.memory for global memory configuration.
 """
 
-from __future__ import annotations
-
 import warnings
 from typing import Any
 

oscura/core/numba_backend.py

@@ -35,8 +35,6 @@ Example:
     >>> result = sum_of_squares(data)  # Fast on second call
 """
 
-from __future__ import annotations
-
 import functools
 from collections.abc import Callable
 from typing import Any, TypeVar
@@ -45,11 +43,11 @@ import numpy as np
 
 # Try to import Numba
 try:
-    from numba import guvectorize as _numba_guvectorize  # type: ignore[import-untyped]
-    from numba import jit as _numba_jit  # type: ignore[import-untyped]
-    from numba import njit as _numba_njit  # type: ignore[import-untyped]
-    from numba import prange as _numba_prange  # type: ignore[import-untyped]
-    from numba import vectorize as _numba_vectorize  # type: ignore[import-untyped]
+    from numba import guvectorize as _numba_guvectorize  # type: ignore[import-not-found]
+    from numba import jit as _numba_jit  # type: ignore[import-not-found]
+    from numba import njit as _numba_njit  # type: ignore[import-not-found]
+    from numba import prange as _numba_prange  # type: ignore[import-not-found]
+    from numba import vectorize as _numba_vectorize  # type: ignore[import-not-found]
 
     HAS_NUMBA = True
 except ImportError:

oscura/core/uncertainty.py

@@ -108,7 +108,7 @@ class MeasurementWithUncertainty:
             JCGM 100:2008 Section 5.1.6
         """
         if self.value == 0:
-            return np.inf
+            return float(np.inf)  # type: ignore[no-any-return]
         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 np.nan
+            return float(np.nan)  # type: ignore[no-any-return]
         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 np.nan
+            return float(np.nan)  # type: ignore[no-any-return]
         return float(np.std(data, ddof=1) / np.sqrt(len(data)))
 
     @staticmethod

oscura/dsl/interpreter.py

@@ -3,6 +3,8 @@
 Executes parsed DSL programs.
 """
 
+from __future__ import annotations
+
 from collections.abc import Callable
 from pathlib import Path
 from typing import Any

oscura/dsl/parser.py

@@ -3,6 +3,8 @@
 Implements simple domain-specific language for trace analysis workflows.
 """
 
+from __future__ import annotations
+
 from dataclasses import dataclass
 from enum import Enum, auto
 from typing import Any, Union
@@ -352,14 +354,14 @@ class Assignment(ASTNode):
     """Variable assignment: $var = expr."""
 
     variable: str
-    expression: "Expression"
+    expression: Expression
 
 
 @dataclass
 class Pipeline(ASTNode):
     """Pipeline expression: expr | command | command."""
 
-    stages: list["Expression"]
+    stages: list[Expression]
 
 
 @dataclass
@@ -367,7 +369,7 @@ class Command(ASTNode):
     """Command invocation: command arg1 arg2."""
 
     name: str
-    args: list["Expression"]
+    args: list[Expression]
 
 
 @dataclass
@@ -375,7 +377,7 @@ class FunctionCall(ASTNode):
     """Function call: func(arg1, arg2)."""
 
     name: str
-    args: list["Expression"]
+    args: list[Expression]
 
 
 @dataclass
@@ -397,8 +399,8 @@ class ForLoop(ASTNode):
     """For loop: for $var in expr: body."""
 
     variable: str
-    iterable: "Expression"
-    body: list["Statement"]
+    iterable: Expression
+    body: list[Statement]
 
 
 # Type aliases

oscura/exploratory/error_recovery.py

@@ -20,6 +20,8 @@ import numpy as np
 
 from oscura.core.types import WaveformTrace
 
+T = TypeVar("T")
+
 logger = logging.getLogger(__name__)
 
 if TYPE_CHECKING:
@@ -27,8 +29,6 @@ if TYPE_CHECKING:
 
     from numpy.typing import NDArray
 
-T = TypeVar("T")
-
 
 @dataclass
 class RecoveryStats:
@@ -547,7 +547,7 @@ class RetryResult:
     adjustments_made: list[str]
 
 
-def retry_with_adjustment[T](
+def retry_with_adjustment(
     func: Callable[..., T],
     trace: WaveformTrace,
     initial_params: dict[str, Any],

oscura/exploratory/parse.py

@@ -5,6 +5,8 @@ This module provides robust protocol decoding that continues after errors
 and timestamp correction for jittery captures.
 """
 
+from __future__ import annotations
+
 from dataclasses import dataclass
 from enum import Enum
 from typing import Any, Literal

oscura/exploratory/recovery.py

@@ -5,6 +5,8 @@ This module characterizes bit error patterns to diagnose capture quality
 issues (EMI, USB problems, clock jitter) and suggests likely causes.
 """
 
+from __future__ import annotations
+
 from dataclasses import dataclass
 from enum import Enum
 

oscura/exploratory/sync.py

@@ -6,6 +6,8 @@ in noisy or corrupted logic analyzer captures, with configurable bit error
 tolerance using Hamming distance.
 """
 
+from __future__ import annotations
+
 from dataclasses import dataclass
 from enum import Enum
 from typing import Literal

oscura/export/wireshark/generator.py

@@ -106,7 +106,7 @@ class WiresharkDissectorGenerator:
 
         # Render template
         template = self.env.get_template("dissector.lua.j2")
-        return template.render(**context)
+        return str(template.render(**context))  # type: ignore[no-any-return]
 
     def _build_template_context(self, protocol: ProtocolDefinition) -> dict[str, Any]:
         """Build context dictionary for template rendering.

oscura/export/wireshark/type_mapping.py

@@ -7,6 +7,8 @@ References:
     https://wiki.wireshark.org/LuaAPI/Proto
 """
 
+from __future__ import annotations
+
 from typing import Literal
 
 # Map Oscura field types to Wireshark ProtoField types

oscura/exporters/hdf5.py

@@ -11,8 +11,6 @@ References:
     HDF5 specification (https://www.hdfgroup.org/)
 """
 
-from __future__ import annotations
-
 from datetime import datetime
 from pathlib import Path
 from typing import Any
@@ -81,7 +79,7 @@ def export_hdf5(
 
 
 def _write_trace_dataset(
-    f: h5py.File,
+    f: "h5py.File",
     name: str,
     trace: WaveformTrace | DigitalTrace,
     compression: str | None,

oscura/extensibility/templates.py

@@ -622,8 +622,6 @@ def _generate_analyzer_stub(template: PluginTemplate, class_name: str) -> str:
         References:
             PLUG-008: Plugin Template Generator
         """
-        from __future__ import annotations
-
         import numpy as np
         from numpy.typing import NDArray
 
@@ -697,8 +695,6 @@ def _generate_loader_stub(template: PluginTemplate, class_name: str) -> str:
         References:
             PLUG-008: Plugin Template Generator
         """
-        from __future__ import annotations
-
         import numpy as np
         from numpy.typing import NDArray
         from pathlib import Path
@@ -782,8 +778,6 @@ def _generate_exporter_stub(template: PluginTemplate, class_name: str) -> str:
         References:
             PLUG-008: Plugin Template Generator
         """
-        from __future__ import annotations
-
         import numpy as np
         from numpy.typing import NDArray
         from pathlib import Path
@@ -871,8 +865,6 @@ def _generate_generic_stub(template: PluginTemplate, class_name: str) -> str:
         References:
             PLUG-008: Plugin Template Generator
         """
-        from __future__ import annotations
-
 
         class {class_name}:
             """Generic plugin implementation.

oscura/inference/active_learning/lstar.py

@@ -26,11 +26,9 @@ Complexity:
     - Produces minimal DFA (fewest states)
 """
 
-from __future__ import annotations
-
 from oscura.inference.active_learning.observation_table import ObservationTable
-from oscura.inference.active_learning.oracle import Oracle  # noqa: TC001
-from oscura.inference.state_machine import FiniteAutomaton  # noqa: TC001
+from oscura.inference.active_learning.oracle import Oracle
+from oscura.inference.state_machine import FiniteAutomaton
 
 
 class LStarLearner:

oscura/inference/active_learning/observation_table.py

@@ -8,8 +8,6 @@ References:
     Information and Computation, 75(2), 87-106.
 """
 
-from __future__ import annotations
-
 from dataclasses import dataclass, field
 
 from oscura.inference.state_machine import FiniteAutomaton, State, Transition

oscura/inference/active_learning/oracle.py

@@ -11,8 +11,10 @@ References:
 from __future__ import annotations
 
 from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING
 
-from oscura.inference.state_machine import FiniteAutomaton  # noqa: TC001
+if TYPE_CHECKING:
+    from oscura.inference.state_machine import FiniteAutomaton
 
 
 class Oracle(ABC):

oscura/inference/active_learning/teachers/simulator.py

@@ -7,10 +7,8 @@ requiring a live system.
 The simulator teacher treats traces as examples of valid protocol sequences.
 """
 
-from __future__ import annotations
-
 from oscura.inference.active_learning.oracle import Oracle
-from oscura.inference.state_machine import FiniteAutomaton  # noqa: TC001
+from oscura.inference.state_machine import FiniteAutomaton
 
 
 class SimulatorTeacher(Oracle):

oscura/inference/alignment.py

@@ -12,6 +12,8 @@ Key capabilities:
 - Conserved/variable region detection
 """
 
+from __future__ import annotations
+
 from dataclasses import dataclass
 from typing import Any, Literal
 

oscura/inference/message_format.py

@@ -18,6 +18,8 @@ References:
     Discoverer: Automatic Protocol Reverse Engineering. USENIX Security 2007.
 """
 
+from __future__ import annotations
+
 from dataclasses import dataclass
 from dataclasses import field as dataclass_field
 from typing import Any, Literal

oscura/inference/protocol_dsl.py

@@ -13,6 +13,8 @@ Key capabilities:
 - Comprehensive error reporting
 """
 
+from __future__ import annotations
+
 import ast
 import operator
 import struct
@@ -68,7 +70,7 @@ class FieldDefinition:
     element: dict[str, Any] | None = None  # Element definition for arrays
     count_field: str | None = None  # Field containing array count
     count: int | None = None  # Fixed array count
-    fields: list["FieldDefinition"] | None = None  # Nested fields for struct type
+    fields: list[FieldDefinition] | None = None  # Nested fields for struct type
 
     def __post_init__(self) -> None:
         """Handle size_ref as alias for size."""
@@ -117,7 +119,7 @@ class ProtocolDefinition:
     encoding: dict[str, Any] = field(default_factory=dict)
 
     @classmethod
-    def from_yaml(cls, path: str | Path) -> "ProtocolDefinition":
+    def from_yaml(cls, path: str | Path) -> ProtocolDefinition:
         """Load protocol definition from YAML file.
 
         : YAML parsing.
@@ -134,7 +136,7 @@ class ProtocolDefinition:
         return cls.from_dict(config)
 
     @classmethod
-    def from_dict(cls, config: dict[str, Any]) -> "ProtocolDefinition":
+    def from_dict(cls, config: dict[str, Any]) -> ProtocolDefinition:
         """Create from dictionary.
 
         : Configuration parsing.
@@ -168,7 +170,7 @@ class ProtocolDefinition:
     @classmethod
     def _parse_field_definition(
         cls, field_dict: dict[str, Any], default_endian: str
-    ) -> "FieldDefinition":
+    ) -> FieldDefinition:
         """Parse a single field definition from dictionary.
 
         Args:
@@ -365,7 +367,7 @@ class ProtocolDecoder:
         self._endian_map: dict[str, str] = {"big": ">", "little": "<"}
 
     @classmethod
-    def load(cls, path: str | Path) -> "ProtocolDecoder":
+    def load(cls, path: str | Path) -> ProtocolDecoder:
         """Load decoder from YAML protocol definition.
 
         : Load decoder from file.