oscura 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

oscura/__init__.py

@@ -1,8 +1,8 @@
-"""TraceKit - Reverse engineer ANY system from captured waveforms (analog or digital).
+"""Oscura - Reverse engineer ANY system from captured waveforms (analog or digital).
 
 The open-source toolkit for complete signal reverse engineering across analog and digital domains.
 
-TraceKit provides comprehensive tools for:
+Oscura provides comprehensive tools for:
 - Waveform analysis (rise/fall time, frequency, amplitude)
 - Digital signal analysis (edge detection, clock recovery)
 - Spectral analysis (FFT, PSD, THD, SNR, SINAD, ENOB)
@@ -23,24 +23,24 @@ TraceKit provides comprehensive tools for:
 - One-call convenience functions
 
 Example:
-    >>> import oscura as tk
-    >>> trace = tk.load("capture.wfm")
-    >>> print(f"Rise time: {tk.rise_time(trace):.2e} s")
-    >>> freq, mag = tk.fft(trace)
-    >>> print(f"THD: {tk.thd(trace):.1f} dB")
+    >>> import oscura as osc
+    >>> trace = osc.load("capture.wfm")
+    >>> print(f"Rise time: {osc.rise_time(trace):.2e} s")
+    >>> freq, mag = osc.fft(trace)
+    >>> print(f"THD: {osc.thd(trace):.1f} dB")
     >>> # One-call spectral analysis
-    >>> metrics = tk.quick_spectral(trace, fundamental=1000)
+    >>> metrics = osc.quick_spectral(trace, fundamental=1000)
     >>> print(f"THD: {metrics.thd_db:.1f} dB, SNR: {metrics.snr_db:.1f} dB")
     >>> # Auto-decode protocol
-    >>> result = tk.auto_decode(trace)
+    >>> result = osc.auto_decode(trace)
     >>> print(f"Protocol: {result.protocol}, Frames: {len(result.frames)}")
     >>> # Generate test signals
-    >>> signal = (tk.SignalBuilder(sample_rate=1e6, duration=0.01)
+    >>> signal = (osc.SignalBuilder(sample_rate=1e6, duration=0.01)
     ...     .add_sine(frequency=1000)
     ...     .add_noise(snr_db=40)
     ...     .build())
     >>> # Reverse engineer unknown signal
-    >>> result = tk.workflows.reverse_engineer_signal(trace)
+    >>> result = osc.workflows.reverse_engineer_signal(trace)
     >>> print(result.protocol_spec)
 
 For more information, see https://github.com/lair-click-bats/oscura
@@ -254,8 +254,8 @@ from oscura.core.exceptions import (
     FormatError,
     InsufficientDataError,
     LoaderError,
+    OscuraError,
     SampleRateError,
-    TraceKitError,
     UnsupportedFormatError,
     ValidationError,
 )
@@ -544,6 +544,8 @@ __all__ = [
     "NoiseMarginResult",
     "NumberFormatter",
     "OperationHistory",
+    # Exceptions
+    "OscuraError",
     # Signal quality (QUAL-007)
     "PLLRecoveryResult",
     # Expert API - Pipeline (API-001, API-002, API-004)
@@ -578,8 +580,6 @@ __all__ = [
     "Trace",
     # Discovery
     "TraceDiff",
-    # Exceptions
-    "TraceKitError",
     # Core types
     "TraceMetadata",
     "TraceTransformer",

oscura/__main__.py

@@ -1,6 +1,6 @@
-"""TraceKit command-line interface.
+"""Oscura command-line interface.
 
-This module provides the main entry point for TraceKit CLI operations,
+This module provides the main entry point for Oscura CLI operations,
 including sample data download.
 
 
@@ -239,7 +239,7 @@ def download_samples(force: bool = False, generate: bool = True) -> int:
     samples_dir = get_samples_dir()
     sample_files = get_sample_files()
 
-    print("TraceKit Sample Data Download")
+    print("Oscura Sample Data Download")
     print("==============================")
     print(f"Destination: {samples_dir}")
     print()
@@ -290,8 +290,8 @@ def download_samples(force: bool = False, generate: bool = True) -> int:
     print("Sample files downloaded successfully!")
     print()
     print("Example usage:")
-    print("  >>> import oscura as tk")
-    print(f"  >>> trace = tk.load('{samples_dir / 'sine_1khz.csv'}')")
+    print("  >>> import oscura as osc")
+    print(f"  >>> trace = osc.load('{samples_dir / 'sine_1khz.csv'}')")
     print("  >>> trace.plot()")
 
     return 0
@@ -320,14 +320,14 @@ def list_samples() -> int:
 
 
 def main() -> int:
-    """Main entry point for TraceKit CLI.
+    """Main entry point for Oscura CLI.
 
     Returns:
         Exit code.
     """
     parser = argparse.ArgumentParser(
         prog="oscura",
-        description="TraceKit signal analysis toolkit",
+        description="Oscura signal analysis toolkit",
     )
 
     subparsers = parser.add_subparsers(dest="command", help="Available commands")
@@ -378,9 +378,9 @@ def main() -> int:
         try:
             from oscura import __version__
 
-            print(f"TraceKit version {__version__}")
+            print(f"Oscura version {__version__}")
         except ImportError:
-            print("TraceKit version unknown")
+            print("Oscura version unknown")
         return 0
 
     else:

oscura/analyzers/__init__.py

@@ -1,4 +1,4 @@
-"""TraceKit analyzers module.
+"""Oscura analyzers module.
 
 Provides signal analysis functionality including:
 - Waveform measurements (timing, amplitude)

oscura/analyzers/packet/daq.py

@@ -201,7 +201,7 @@ def detect_gaps(
         DAQGapAnalysis with detected gaps
 
     Example:
-        >>> trace = tk.load('acquisition.wfm')
+        >>> trace = osc.load('acquisition.wfm')
         >>> result = detect_gaps(trace)
         >>> for gap in result.gaps:
         ...     print(f"Gap at {gap.start_time:.6f}s: {gap.missing_samples} samples")

oscura/analyzers/patterns/__init__.py

@@ -1,4 +1,4 @@
-"""Pattern Detection & Analysis module for TraceKit.
+"""Pattern Detection & Analysis module for Oscura.
 
 This module provides comprehensive pattern detection and analysis capabilities
 for digital signals and binary data, including:
@@ -17,7 +17,7 @@ for digital signals and binary data, including:
     - RE-PAT-003: Fuzzy Pattern Matching
     - RE-PAT-004: Pattern Learning and Discovery
 
-Author: TraceKit Development Team
+Author: Oscura Development Team
 """
 
 # Periodic pattern detection (PAT-001)

oscura/analyzers/patterns/clustering.py

@@ -4,7 +4,7 @@ This module implements algorithms for clustering similar patterns/messages
 using various distance metrics and clustering approaches.
 
 
-Author: TraceKit Development Team
+Author: Oscura Development Team
 """
 
 from dataclasses import dataclass

oscura/analyzers/patterns/discovery.py

@@ -4,7 +4,7 @@ This module implements algorithms for automatically discovering candidate
 signatures, headers, and delimiters in binary data through statistical analysis.
 
 
-Author: TraceKit Development Team
+Author: Oscura Development Team
 """
 
 from __future__ import annotations

oscura/analyzers/patterns/periodic.py

@@ -5,7 +5,7 @@ and binary data using autocorrelation, FFT spectral analysis, and suffix array
 techniques.
 
 
-Author: TraceKit Development Team
+Author: Oscura Development Team
 """
 
 from __future__ import annotations

oscura/analyzers/patterns/sequences.py

@@ -4,7 +4,7 @@ This module implements algorithms for finding repeating sequences, n-grams,
 and approximate pattern matching in binary data and digital signals.
 
 
-Author: TraceKit Development Team
+Author: Oscura Development Team
 """
 
 from __future__ import annotations

oscura/analyzers/power/__init__.py

@@ -1,4 +1,4 @@
-"""Power analysis module for TraceKit.
+"""Power analysis module for Oscura.
 
 Provides comprehensive power analysis capabilities including:
 - Basic power measurements (instantaneous, average, RMS, peak)

oscura/analyzers/power/ac_power.py

@@ -1,4 +1,4 @@
-"""AC power analysis for TraceKit.
+"""AC power analysis for Oscura.
 
 Provides AC power calculations including reactive power, apparent power,
 power factor, and harmonic analysis.

oscura/analyzers/power/basic.py

@@ -1,4 +1,4 @@
-"""Basic power analysis for TraceKit.
+"""Basic power analysis for Oscura.
 
 Provides fundamental power calculations including instantaneous power,
 average power, RMS power, peak power, and energy.

oscura/analyzers/power/conduction.py

@@ -1,4 +1,4 @@
-"""Conduction loss analysis for TraceKit.
+"""Conduction loss analysis for Oscura.
 
 Provides conduction loss calculations for power semiconductor devices
 during their on-state.

oscura/analyzers/power/efficiency.py

@@ -1,4 +1,4 @@
-"""Power efficiency calculations for TraceKit.
+"""Power efficiency calculations for Oscura.
 
 Provides efficiency calculations for power converters and systems.
 

oscura/analyzers/power/ripple.py

@@ -1,4 +1,4 @@
-"""Ripple measurement for TraceKit.
+"""Ripple measurement for Oscura.
 
 Provides AC ripple analysis for DC power supply outputs.
 

oscura/analyzers/power/soa.py

@@ -1,4 +1,4 @@
-"""Safe Operating Area (SOA) analysis for TraceKit.
+"""Safe Operating Area (SOA) analysis for Oscura.
 
 Provides SOA checking and visualization for power semiconductor devices.
 

oscura/analyzers/power/switching.py

@@ -1,4 +1,4 @@
-"""Switching loss analysis for TraceKit.
+"""Switching loss analysis for Oscura.
 
 Provides switching loss calculations for power semiconductor devices
 including MOSFETs, IGBTs, and diodes.

oscura/api/__init__.py

@@ -1,4 +1,4 @@
-"""Expert API module for TraceKit.
+"""Expert API module for Oscura.
 
 This module provides advanced APIs for power users including DSL,
 fluent interfaces, performance profiling, and advanced workflow control.

oscura/automotive/__init__.py

@@ -13,7 +13,7 @@ Key features:
 - UDS (ISO 14229) diagnostic services decoding
 - DTC database (200+ codes for Powertrain, Chassis, Body, Network)
 - Discovery documentation with evidence tracking (.tkcan format)
-- Integration with TraceKit's CRC reverse engineering and state machine learning
+- Integration with Oscura's CRC reverse engineering and state machine learning
 
 Example:
     >>> from oscura.automotive.can import CANSession

oscura/automotive/can/checksum.py

@@ -1,6 +1,6 @@
 """CAN message checksum detection.
 
-This module integrates with TraceKit's CRC reverse engineering capabilities
+This module integrates with Oscura's CRC reverse engineering capabilities
 to detect and identify checksums in CAN messages.
 """
 
@@ -20,7 +20,7 @@ __all__ = ["ChecksumDetector"]
 class ChecksumDetector:
     """Detect checksums and CRCs in CAN messages.
 
-    This class uses TraceKit's CRC reverse engineering to detect
+    This class uses Oscura's CRC reverse engineering to detect
     checksums in CAN message data.
     """
 

oscura/automotive/can/session.py

@@ -416,7 +416,7 @@ class CANSession:
     ) -> FiniteAutomaton:
         """Learn state machine from message sequences.
 
-        This method integrates TraceKit's state machine inference to learn
+        This method integrates Oscura's state machine inference to learn
         protocol state machines from CAN message sequences around trigger messages.
 
         Args:

oscura/automotive/can/state_machine.py

@@ -1,6 +1,6 @@
 """State machine learning for CAN protocol reverse engineering.
 
-This module integrates TraceKit's state machine inference capabilities with
+This module integrates Oscura's state machine inference capabilities with
 CAN bus analysis to learn protocol state machines from message sequences.
 
 Key capabilities:

oscura/automotive/dbc/generator.py

@@ -1,6 +1,6 @@
 """DBC file generator from discovery documents.
 
-This module generates standard DBC files from TraceKit discovery documents,
+This module generates standard DBC files from Oscura discovery documents,
 enabling export of reverse-engineered protocols to industry-standard format.
 """
 

oscura/automotive/dbc/parser.py

@@ -1,6 +1,6 @@
 """DBC file parser using cantools.
 
-This module provides parsing of standard DBC files for use with TraceKit.
+This module provides parsing of standard DBC files for use with Oscura.
 """
 
 from __future__ import annotations

oscura/automotive/loaders/pcap.py

@@ -29,7 +29,7 @@ def load_pcap(file_path: Path | str) -> CANMessageList:
     """Load CAN messages from a PCAP file.
 
     This function reads PCAP files containing SocketCAN frames and converts
-    them to TraceKit's CANMessage format. It uses scapy to parse the PCAP
+    them to Oscura's CANMessage format. It uses scapy to parse the PCAP
     file and extract CAN frames.
 
     Args:

oscura/batch/__init__.py

@@ -1,4 +1,4 @@
-"""Batch processing functionality for TraceKit.
+"""Batch processing functionality for Oscura.
 
 
 This module enables efficient batch analysis of multiple signal files

oscura/batch/aggregate.py

@@ -52,8 +52,8 @@ def aggregate_results(
         ValueError: If no numeric metrics are found in results.
 
     Examples:
-        >>> results = tk.batch_analyze(files, tk.characterize_buffer)
-        >>> summary = tk.aggregate_results(
+        >>> results = osc.batch_analyze(files, osc.characterize_buffer)
+        >>> summary = osc.aggregate_results(
         ...     results,
         ...     metrics=['rise_time', 'fall_time'],
         ...     outlier_threshold=2.5

oscura/batch/analyze.py

@@ -46,12 +46,12 @@ def batch_analyze(
         Always includes a 'file' column with the input filename.
 
     Examples:
-        >>> import oscura as tk
+        >>> import oscura as osc
         >>> import glob
         >>> files = glob.glob('captures/*.wfm')
-        >>> results = tk.batch_analyze(
+        >>> results = osc.batch_analyze(
         ...     files,
-        ...     analysis_fn=tk.characterize_buffer,
+        ...     analysis_fn=osc.characterize_buffer,
         ...     parallel=True,
         ...     workers=4
         ... )

oscura/builders/__init__.py

@@ -1,30 +1,30 @@
-"""Signal and protocol builders for TraceKit.
+"""Signal and protocol builders for Oscura.
 
 This module provides fluent builders for generating test signals, protocol
 transactions, and test scenarios. These builders enable composable signal
 generation without manual numpy operations.
 
 Example:
-    >>> import oscura as tk
+    >>> import oscura as osc
     >>> # Simple sine wave with noise
-    >>> signal = (tk.SignalBuilder(sample_rate=1e6, duration=0.01)
+    >>> signal = (osc.SignalBuilder(sample_rate=1e6, duration=0.01)
     ...     .add_sine(frequency=1000, amplitude=1.0)
     ...     .add_noise(snr_db=40)
     ...     .build())
     >>>
     >>> # UART signal for protocol testing
-    >>> uart = (tk.SignalBuilder(sample_rate=10e6)
-    ...     .add_uart(baud_rate=115200, data=b"Hello TraceKit!")
+    >>> uart = (osc.SignalBuilder(sample_rate=10e6)
+    ...     .add_uart(baud_rate=115200, data=b"Hello Oscura!")
     ...     .add_noise(snr_db=30)
     ...     .build())
     >>>
     >>> # Multi-channel SPI transaction
-    >>> spi = (tk.SignalBuilder(sample_rate=10e6)
+    >>> spi = (osc.SignalBuilder(sample_rate=10e6)
     ...     .add_spi(clock_freq=1e6, data_mosi=b"\\x9F\\x00\\x00")
     ...     .build())
 
 References:
-    - TraceKit Signal Generation Guide
+    - Oscura Signal Generation Guide
     - Protocol Test Signal Specifications
 """
 

oscura/builders/signal_builder.py

@@ -101,7 +101,7 @@ class GeneratedSignal:
         return self.data[name]
 
     def to_trace(self, channel: str | None = None) -> WaveformTrace:
-        """Convert to WaveformTrace for TraceKit analysis.
+        """Convert to WaveformTrace for Oscura analysis.
 
         Args:
             channel: Channel name to convert. If None, uses first channel.
@@ -210,7 +210,7 @@ class SignalBuilder:
         >>> # UART signal with realistic characteristics
         >>> uart_signal = (SignalBuilder()
         ...     .sample_rate(10e6)
-        ...     .add_uart(baud_rate=115200, data=b"Hello TraceKit!", config="8N1")
+        ...     .add_uart(baud_rate=115200, data=b"Hello Oscura!", config="8N1")
         ...     .add_noise(snr_db=30)
         ...     .build())
     """
@@ -1083,13 +1083,13 @@ class SignalBuilder:
         return GeneratedSignal(data=self._channels.copy(), metadata=metadata)
 
     def build_trace(self, channel: str | None = None) -> WaveformTrace:
-        """Build and return as WaveformTrace for direct use with TraceKit.
+        """Build and return as WaveformTrace for direct use with Oscura.
 
         Args:
             channel: Channel to return as trace. If None, uses first channel.
 
         Returns:
-            WaveformTrace ready for TraceKit analysis.
+            WaveformTrace ready for Oscura analysis.
         """
         signal = self.build()
         return signal.to_trace(channel)

oscura/cli/__init__.py

@@ -1,4 +1,4 @@
-"""TraceKit Command-Line Interface.
+"""Oscura Command-Line Interface.
 
 This module provides command-line tools for signal analysis workflows.
 

oscura/cli/batch.py

@@ -1,4 +1,4 @@
-"""TraceKit Batch Command implementing CLI-004.
+"""Oscura Batch Command implementing CLI-004.
 
 Provides CLI for batch processing multiple files with parallel execution support.
 

oscura/cli/characterize.py

@@ -1,4 +1,4 @@
-"""TraceKit Characterize Command implementing CLI-002.
+"""Oscura Characterize Command implementing CLI-002.
 
 Provides CLI for buffer/signal characterization with automatic logic family
 detection and optional reference comparison.
@@ -168,7 +168,7 @@ def _perform_characterization(
 ) -> dict[str, Any]:
     """Perform characterization analysis.
 
-    Calls actual TraceKit analysis functions based on the analysis type.
+    Calls actual Oscura analysis functions based on the analysis type.
 
     Args:
         trace: Main trace to analyze.

oscura/cli/compare.py

@@ -1,4 +1,4 @@
-"""TraceKit Compare Command implementing CLI-005.
+"""Oscura Compare Command implementing CLI-005.
 
 Provides CLI for comparing two signal captures with timing, noise, and
 spectral difference analysis.
@@ -573,7 +573,7 @@ def _generate_html_report(
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>TraceKit Signal Comparison Report</title>
+    <title>Oscura Signal Comparison Report</title>
     <style>
         body {{
             font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
@@ -634,7 +634,7 @@ def _generate_html_report(
 </head>
 <body>
     <div class="header">
-        <h1>TraceKit Signal Comparison Report</h1>
+        <h1>Oscura Signal Comparison Report</h1>
         <p>File 1: {Path(file1).name}</p>
         <p>File 2: {Path(file2).name}</p>
     </div>
@@ -767,7 +767,7 @@ def _generate_html_report(
         </div>
 
         <footer style="margin-top: 30px; text-align: center; color: #6c757d;">
-            <p>Generated by TraceKit - Signal Analysis Toolkit</p>
+            <p>Generated by Oscura - Signal Analysis Toolkit</p>
         </footer>
     </div>
 </body>

oscura/cli/decode.py

@@ -1,4 +1,4 @@
-"""TraceKit Decode Command implementing CLI-003.
+"""Oscura Decode Command implementing CLI-003.
 
 Provides CLI for protocol decoding with automatic protocol detection and
 error highlighting.

oscura/cli/main.py

@@ -1,4 +1,4 @@
-"""TraceKit Core CLI Framework implementing CLI-001.
+"""Oscura Core CLI Framework implementing CLI-001.
 
 Provides the main entry point for the oscura command-line interface with
 support for multiple output formats and verbose logging.
@@ -62,7 +62,7 @@ class OutputFormat:
             "<html>",
             "<head>",
             "<meta charset='utf-8'>",
-            "<title>TraceKit Analysis Results</title>",
+            "<title>Oscura Analysis Results</title>",
             "<style>",
             "body { font-family: Arial, sans-serif; margin: 20px; }",
             "table { border-collapse: collapse; width: 100%; }",
@@ -72,7 +72,7 @@ class OutputFormat:
             "</style>",
             "</head>",
             "<body>",
-            "<h1>TraceKit Analysis Results</h1>",
+            "<h1>Oscura Analysis Results</h1>",
             "<table>",
             "<tr><th>Parameter</th><th>Value</th></tr>",
         ]
@@ -138,7 +138,7 @@ def format_output(data: dict[str, Any], format_type: str) -> str:
 @click.version_option(version="0.1.0", prog_name="oscura")  # type: ignore[misc]
 @click.pass_context  # type: ignore[misc]
 def cli(ctx: click.Context, verbose: int) -> None:
-    """TraceKit - Signal Analysis Framework for Oscilloscope Data.
+    """Oscura - Signal Analysis Framework for Oscilloscope Data.
 
     Command-line tools for characterizing buffers, decoding protocols,
     analyzing spectra, and comparing signals.
@@ -172,14 +172,14 @@ def cli(ctx: click.Context, verbose: int) -> None:
 
 @click.command()  # type: ignore[misc]
 def shell() -> None:
-    """Start an interactive TraceKit shell.
+    """Start an interactive Oscura shell.
 
-    Opens a Python REPL with TraceKit pre-imported and ready to use.
+    Opens a Python REPL with Oscura pre-imported and ready to use.
     Features tab completion, persistent history, and helpful shortcuts.
 
     Example:
         $ oscura shell
-        TraceKit Shell v0.1.0
+        Oscura Shell v0.1.0
         >>> trace = load("signal.wfm")
         >>> rise_time(trace)
     """
@@ -194,7 +194,7 @@ def shell() -> None:
 def tutorial(tutorial_id: str | None, list_tutorials: bool) -> None:
     """Run an interactive tutorial.
 
-    Provides step-by-step guidance for learning TraceKit.
+    Provides step-by-step guidance for learning Oscura.
 
     Args:
         tutorial_id: ID of the tutorial to run (or None to list).