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

oscura/cli/shell.py

@@ -1,17 +1,17 @@
-"""Interactive REPL shell for TraceKit exploration.
+"""Interactive REPL shell for Oscura exploration.
 
-This module provides an interactive Python shell with TraceKit auto-imports,
+This module provides an interactive Python shell with Oscura auto-imports,
 tab completion, and persistent history for exploratory data analysis.
 
-  - Auto-imports TraceKit modules
+  - Auto-imports Oscura modules
   - Tab completion for methods and attributes
   - Persistent command history
   - Customized prompt with context info
 
 Example:
     $ oscura shell
-    TraceKit Shell v0.1.0
-    Type 'help()' for TraceKit help, 'exit()' to quit.
+    Oscura Shell v0.1.0
+    Type 'help()' for Oscura help, 'exit()' to quit.
 
     In [1]: trace = load("capture.wfm")
     In [2]: rise_time(trace)
@@ -40,18 +40,18 @@ HISTORY_LENGTH = 1000
 
 
 def get_oscura_namespace() -> dict[str, Any]:
-    """Build namespace with TraceKit auto-imports.
+    """Build namespace with Oscura auto-imports.
 
     Returns:
-        Dictionary with all commonly-used TraceKit functions and classes.
+        Dictionary with all commonly-used Oscura functions and classes.
     """
     namespace: dict[str, Any] = {}
 
     # Core imports
     try:
-        import oscura as tk
+        import oscura as osc
 
-        namespace["tk"] = tk
+        namespace["osc"] = osc
 
         # Auto-import commonly used functions at top level
         from oscura import (
@@ -191,7 +191,7 @@ def get_oscura_namespace() -> dict[str, Any]:
             pass
 
     except ImportError as e:
-        print(f"Warning: Could not import TraceKit: {e}")
+        print(f"Warning: Could not import Oscura: {e}")
 
     # Common utilities
     try:
@@ -229,9 +229,9 @@ def setup_history() -> None:
 
 
 def oscura_help() -> None:
-    """Display TraceKit help in the REPL."""
+    """Display Oscura help in the REPL."""
     help_text = """
-TraceKit Interactive Shell - Quick Reference
+Oscura Interactive Shell - Quick Reference
 =============================================
 
 Loading Data:
@@ -277,14 +277,14 @@ Full documentation: https://github.com/lair-click-bats/oscura
     print(help_text)
 
 
-class TraceKitConsole(code.InteractiveConsole):
-    """Custom interactive console for TraceKit.
+class OscuraConsole(code.InteractiveConsole):
+    """Custom interactive console for Oscura.
 
     Provides IPython-style prompts and enhanced error handling.
     """
 
     def __init__(self, locals: dict[str, Any] | None = None) -> None:
-        """Initialize the console with TraceKit namespace."""
+        """Initialize the console with Oscura namespace."""
         super().__init__(locals=locals, filename="<oscura>")
         self.prompt_counter = 1
 
@@ -294,7 +294,7 @@ class TraceKitConsole(code.InteractiveConsole):
             import oscura
 
             banner = f"""
-TraceKit Shell v{oscura.__version__}
+Oscura Shell v{oscura.__version__}
 Python {sys.version.split()[0]} on {sys.platform}
 Type 'oscura_help()' for quick reference, 'exit()' to quit.
 
@@ -320,10 +320,10 @@ Common functions: load, measure, fft, psd, thd, low_pass, high_pass
 
 
 def start_shell() -> None:
-    """Start the TraceKit interactive shell.
+    """Start the Oscura interactive shell.
 
     This is the main entry point for the REPL, providing:
-    - Auto-imported TraceKit functions and modules
+    - Auto-imported Oscura functions and modules
     - Tab completion
     - Persistent command history
     - Customized prompts
@@ -342,7 +342,7 @@ def start_shell() -> None:
     readline.set_completer(completer.complete)
 
     # Start console
-    console = TraceKitConsole(locals=namespace)
+    console = OscuraConsole(locals=namespace)
     console.interact()
 
 

oscura/comparison/__init__.py

@@ -1,4 +1,4 @@
-"""Comparison and limit testing module for TraceKit.
+"""Comparison and limit testing module for Oscura.
 
 This module provides waveform comparison, limit testing, mask testing,
 and golden waveform comparison functionality.

oscura/comparison/compare.py

@@ -1,4 +1,4 @@
-"""Trace comparison functions for TraceKit.
+"""Trace comparison functions for Oscura.
 
 This module provides functions for comparing waveform traces including
 difference calculation, correlation, and similarity scoring.

oscura/comparison/golden.py

@@ -1,4 +1,4 @@
-"""Golden waveform comparison for TraceKit.
+"""Golden waveform comparison for Oscura.
 
 This module provides golden reference waveform management and comparison
 functions for pass/fail testing against known-good waveforms.

oscura/comparison/limits.py

@@ -1,4 +1,4 @@
-"""Limit testing for TraceKit.
+"""Limit testing for Oscura.
 
 This module provides specification limit testing including upper/lower
 bounds, pass/fail determination, and margin analysis.

oscura/comparison/mask.py

@@ -1,4 +1,4 @@
-"""Mask testing for TraceKit.
+"""Mask testing for Oscura.
 
 This module provides mask-based pass/fail testing for waveforms,
 including eye diagram masks and custom polygon masks.

oscura/comparison/trace_diff.py

@@ -12,7 +12,7 @@ Example:
     ...     print(f"{d.category}: {d.description}")
 
 References:
-    TraceKit Auto-Discovery Specification
+    Oscura Auto-Discovery Specification
     Phase 34 Task-245
 """
 

oscura/compliance/__init__.py

@@ -6,10 +6,10 @@ and MIL-STD standards.
 
 
 Example:
-    >>> import oscura as tk
+    >>> import oscura as osc
     >>> from oscura.compliance import load_limit_mask, check_compliance, generate_compliance_report
     >>>
-    >>> trace = tk.load('emissions.wfm')
+    >>> trace = osc.load('emissions.wfm')
     >>> mask = load_limit_mask('FCC_Part15_ClassB')
     >>> result = check_compliance(trace, mask)
     >>> generate_compliance_report(result, 'compliance_report.html')

oscura/compliance/reporting.py

@@ -295,7 +295,7 @@ def _generate_html_report(
     <div class="footer">
         <p>Report generated: {datetime.now().strftime("%Y-%m-%d %H:%M:%S")}</p>
         <p>Detector: {result.detector} | Distance: {result.metadata.get("distance", "N/A")}m</p>
-        <p>Generated by TraceKit EMC Compliance Module</p>
+        <p>Generated by Oscura EMC Compliance Module</p>
     </div>
 </body>
 </html>
@@ -426,7 +426,7 @@ def _generate_markdown_report(
     md += f"""
 ---
 *Report generated: {datetime.now().strftime("%Y-%m-%d %H:%M:%S")}*
-*Generated by TraceKit EMC Compliance Module*
+*Generated by Oscura EMC Compliance Module*
 """
     with open(output_path, "w") as f:
         f.write(md)

oscura/component/__init__.py

@@ -1,4 +1,4 @@
-"""Component analysis module for TraceKit.
+"""Component analysis module for Oscura.
 
 This module provides TDR-based impedance extraction, capacitance/inductance
 measurement, parasitic extraction, and transmission line analysis.

oscura/component/impedance.py

@@ -1,4 +1,4 @@
-"""TDR impedance extraction for TraceKit.
+"""TDR impedance extraction for Oscura.
 
 This module provides impedance extraction from Time Domain Reflectometry
 (TDR) measurements, including impedance profiling and discontinuity analysis.

oscura/component/reactive.py

@@ -1,4 +1,4 @@
-"""Reactive component extraction for TraceKit.
+"""Reactive component extraction for Oscura.
 
 This module provides capacitance and inductance measurement from
 waveform data, including parasitic extraction.

oscura/component/transmission_line.py

@@ -1,4 +1,4 @@
-"""Transmission line analysis for TraceKit.
+"""Transmission line analysis for Oscura.
 
 This module provides transmission line characterization including
 characteristic impedance, propagation delay, and velocity factor.

oscura/config/__init__.py

@@ -1,4 +1,4 @@
-"""TraceKit configuration and schema validation system.
+"""Oscura configuration and schema validation system.
 
 This package provides:
 - JSON Schema-based configuration validation

oscura/config/loader.py

@@ -201,7 +201,7 @@ def load_config(
     *,
     use_defaults: bool = True,
 ) -> dict[str, Any]:
-    """Load TraceKit configuration.
+    """Load Oscura configuration.
 
     Searches for configuration in standard locations if no path provided.
 

oscura/config/memory.py

@@ -1,4 +1,4 @@
-"""Memory configuration module for TraceKit.
+"""Memory configuration module for Oscura.
 
 This module provides global memory limit configuration and settings.
 
@@ -22,7 +22,7 @@ from dataclasses import dataclass
 
 @dataclass
 class MemoryConfiguration:
-    """Global memory configuration for TraceKit operations.
+    """Global memory configuration for Oscura operations.
 
 
     Attributes:
@@ -76,7 +76,7 @@ def get_memory_config() -> MemoryConfiguration:
 
 
 def set_memory_limit(limit: int | str | None) -> None:
-    """Set global memory limit for all TraceKit operations.
+    """Set global memory limit for all Oscura operations.
 
 
     Args:

oscura/config/migration.py

@@ -1,4 +1,4 @@
-"""Schema migration system for TraceKit configuration files.
+"""Schema migration system for Oscura configuration files.
 
 This module provides schema migration functionality to automatically upgrade
 configuration files between schema versions while preserving user data.

oscura/config/preferences.py

@@ -1,6 +1,6 @@
 """User preferences management system.
 
-This module provides persistent user preferences for TraceKit including
+This module provides persistent user preferences for Oscura including
 visualization settings, default parameters, export options, and UI
 preferences.
 """

oscura/config/schema.py

@@ -1,4 +1,4 @@
-"""JSON Schema validation system for TraceKit configuration.
+"""JSON Schema validation system for Oscura configuration.
 
 This module provides a flexible schema validation system using JSON Schema
 for validating configuration files including protocols, pipelines, and
@@ -29,10 +29,10 @@ except ImportError:
     JsonSchemaError = Exception  # type: ignore[ignore-without-code]
 
 from oscura.core.exceptions import ConfigurationError
-from oscura.core.exceptions import ValidationError as TraceKitValidationError
+from oscura.core.exceptions import ValidationError as OscuraValidationError
 
 
-class ValidationError(TraceKitValidationError):
+class ValidationError(OscuraValidationError):
     """Schema validation error with detailed location information.
 
     Attributes:

oscura/config/settings.py

@@ -1,6 +1,6 @@
 """Application settings management system.
 
-This module provides application-wide settings management for TraceKit,
+This module provides application-wide settings management for Oscura,
 including feature flags, CLI defaults, output formats, and runtime
 configuration options.
 

oscura/convenience.py

@@ -4,22 +4,22 @@ This module provides one-call solutions for common signal analysis tasks,
 wrapping multiple lower-level functions into easy-to-use high-level APIs.
 
 Example:
-    >>> import oscura as tk
-    >>> trace = tk.load("audio_capture.wfm")
+    >>> import oscura as osc
+    >>> trace = osc.load("audio_capture.wfm")
     >>>
     >>> # 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-detect and decode protocol
-    >>> result = tk.auto_decode(trace)
+    >>> result = osc.auto_decode(trace)
     >>> print(f"Protocol: {result.protocol}, Frames: {len(result.frames)}")
     >>>
     >>> # Smart filtering
-    >>> clean = tk.smart_filter(trace, target="noise")
+    >>> clean = osc.smart_filter(trace, target="noise")
 
 References:
-    - TraceKit API Design Guidelines
+    - Oscura API Design Guidelines
     - IEEE 1241-2010 (ADC Characterization)
 """
 
@@ -106,8 +106,8 @@ def quick_spectral(
         SpectralMetrics with all computed values.
 
     Example:
-        >>> trace = tk.load("audio_1khz.wfm")
-        >>> metrics = tk.quick_spectral(trace, fundamental=1000)
+        >>> trace = osc.load("audio_1khz.wfm")
+        >>> metrics = osc.quick_spectral(trace, fundamental=1000)
         >>> print(f"THD: {metrics.thd_db:.1f} dB")
         >>> print(f"SNR: {metrics.snr_db:.1f} dB")
         >>> print(f"ENOB: {metrics.enob:.1f} bits")
@@ -185,8 +185,8 @@ def auto_decode(
         DecodeResult with protocol name, decoded frames, and statistics.
 
     Example:
-        >>> trace = tk.load("serial_capture.wfm")
-        >>> result = tk.auto_decode(trace)
+        >>> trace = osc.load("serial_capture.wfm")
+        >>> result = osc.auto_decode(trace)
         >>> print(f"Protocol: {result.protocol}")
         >>> print(f"Frames decoded: {len(result.frames)}")
         >>> for frame in result.frames[:5]:
@@ -325,10 +325,10 @@ def smart_filter(
         Filtered WaveformTrace.
 
     Example:
-        >>> noisy = tk.load("noisy_capture.wfm")
-        >>> clean = tk.smart_filter(noisy, target="noise")
+        >>> noisy = osc.load("noisy_capture.wfm")
+        >>> clean = osc.smart_filter(noisy, target="noise")
         >>> # Or auto-detect
-        >>> clean = tk.smart_filter(noisy, target="auto")
+        >>> clean = osc.smart_filter(noisy, target="auto")
     """
     from oscura.filtering.convenience import (
         high_pass,

oscura/core/__init__.py

@@ -1,4 +1,4 @@
-"""TraceKit core module.
+"""Oscura core module.
 
 Provides core data types, configuration, exception handling, and logging infrastructure.
 """
@@ -12,7 +12,7 @@ from oscura.core.audit import (
 from oscura.core.cache import (
     CacheEntry,
     CacheStats,
-    TraceKitCache,
+    OscuraCache,
     clear_cache,
     get_cache,
     show_cache_stats,
@@ -63,8 +63,8 @@ from oscura.core.exceptions import (
     FormatError,
     InsufficientDataError,
     LoaderError,
+    OscuraError,
     SampleRateError,
-    TraceKitError,
     UnsupportedFormatError,
     ValidationError,
 )
@@ -213,6 +213,9 @@ __all__ = [
     # Memory monitoring
     "MemoryMonitor",
     "MemorySnapshot",
+    "OscuraCache",
+    # Exceptions
+    "OscuraError",
     "PerformanceCollector",
     "PerformanceContext",
     "PerformanceRecord",
@@ -226,9 +229,6 @@ __all__ = [
     "SampleRateError",
     "SignalQualityReport",
     "Trace",
-    "TraceKitCache",
-    # Exceptions
-    "TraceKitError",
     # Types
     "TraceMetadata",
     "UnsupportedFormatError",

oscura/core/cache.py

@@ -1,4 +1,4 @@
-"""Persistent LRU cache with disk spillover for TraceKit intermediate results.
+"""Persistent LRU cache with disk spillover for Oscura intermediate results.
 
 This module provides memory-bounded caching for expensive operations like FFT,
 spectrograms, and filtered traces with automatic disk spillover when memory
@@ -6,7 +6,7 @@ limits are exceeded.
 
 
 Example:
-    >>> from oscura.core.cache import TraceKitCache, get_cache
+    >>> from oscura.core.cache import OscuraCache, get_cache
     >>> cache = get_cache(max_memory="2GB")
     >>> result = cache.get_or_compute("fft_key", compute_fft, signal, 1024)
     >>> cache.show_stats()
@@ -108,7 +108,7 @@ class CacheStats:
         )
 
 
-class TraceKitCache:
+class OscuraCache:
     """LRU cache with disk spillover for intermediate results.
 
 
@@ -122,7 +122,7 @@ class TraceKitCache:
         auto_cleanup: Clean up disk cache on exit (default: True).
 
     Example:
-        >>> cache = TraceKitCache(max_memory="1GB")
+        >>> cache = OscuraCache(max_memory="1GB")
         >>> result = cache.get_or_compute("key", expensive_func, arg1, arg2)
         >>> stats = cache.get_stats()
         >>> cache.clear()
@@ -180,7 +180,7 @@ class TraceKitCache:
         self._disk_spills = 0
         self._current_memory = 0
 
-    def __enter__(self) -> TraceKitCache:
+    def __enter__(self) -> OscuraCache:
         """Enter context."""
         return self
 
@@ -514,14 +514,14 @@ class TraceKitCache:
 
 
 # Global cache instance
-_global_cache: TraceKitCache | None = None
+_global_cache: OscuraCache | None = None
 
 
 def get_cache(
     max_memory: int | str = "2GB",
     *,
     cache_dir: str | Path | None = None,
-) -> TraceKitCache:
+) -> OscuraCache:
     """Get or create global cache instance.
 
 
@@ -530,7 +530,7 @@ def get_cache(
         cache_dir: Cache directory.
 
     Returns:
-        Global TraceKitCache instance.
+        Global OscuraCache instance.
 
     Example:
         >>> cache = get_cache(max_memory="1GB")
@@ -542,7 +542,7 @@ def get_cache(
     global _global_cache
 
     if _global_cache is None:
-        _global_cache = TraceKitCache(max_memory, cache_dir=cache_dir)
+        _global_cache = OscuraCache(max_memory, cache_dir=cache_dir)
 
     return _global_cache
 
@@ -583,7 +583,7 @@ def show_cache_stats() -> None:
 __all__ = [
     "CacheEntry",
     "CacheStats",
-    "TraceKitCache",
+    "OscuraCache",
     "clear_cache",
     "get_cache",
     "show_cache_stats",

oscura/core/cancellation.py

@@ -1,4 +1,4 @@
-"""Enhanced cancellation support for TraceKit operations.
+"""Enhanced cancellation support for Oscura operations.
 
 This module provides advanced cancellation features including signal handling,
 cleanup routines, and resume support for long-running operations.

oscura/core/confidence.py

@@ -11,7 +11,7 @@ Example:
     Confidence: 0.85 (likely)
 
 References:
-    TraceKit Auto-Discovery Specification
+    Oscura Auto-Discovery Specification
 """
 
 from __future__ import annotations

oscura/core/config.py

@@ -1,4 +1,4 @@
-"""TraceKit configuration loading and management.
+"""Oscura configuration loading and management.
 
 This module provides configuration loading from YAML files with support
 for nested structures, user overrides, and schema validation.

oscura/core/correlation.py

@@ -1,7 +1,7 @@
 """Correlation ID management for distributed tracing.
 
 This module provides correlation ID generation and propagation for
-request tracing across TraceKit operations.
+request tracing across Oscura operations.
 
 
 Example:

oscura/core/debug.py

@@ -250,21 +250,21 @@ def should_log_debug(min_level: DebugLevel = DebugLevel.NORMAL) -> bool:
 def configure_debug_from_env() -> None:
     """Configure debug mode from environment variables.
 
-    Reads TRACEKIT_DEBUG environment variable and sets debug level
+    Reads OSCURA_DEBUG environment variable and sets debug level
     accordingly.
 
     Environment Variables:
-        TRACEKIT_DEBUG: Debug level (minimal, normal, verbose, trace)
+        OSCURA_DEBUG: Debug level (minimal, normal, verbose, trace)
 
     Example:
         >>> import os
-        >>> os.environ['TRACEKIT_DEBUG'] = 'verbose'
+        >>> os.environ['OSCURA_DEBUG'] = 'verbose'
         >>> configure_debug_from_env()
 
     References:
         LOG-007: Programmatic Debug Mode
     """
-    debug_env = os.environ.get("TRACEKIT_DEBUG", "").lower()
+    debug_env = os.environ.get("OSCURA_DEBUG", "").lower()
     if debug_env in _LEVEL_MAP:
         enable_debug(level=debug_env)  # type: ignore[arg-type]
 

oscura/core/edge_cases.py

@@ -1,4 +1,4 @@
-"""Edge case handling utilities for TraceKit.
+"""Edge case handling utilities for Oscura.
 
 This module provides utilities for gracefully handling edge cases including
 empty inputs, single-sample traces, and NaN/Inf values.