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

oscura/pipeline/composition.py

@@ -34,14 +34,14 @@ def compose(*funcs: TraceFunc) -> TraceFunc:
         ValueError: If no functions provided.
 
     Example:
-        >>> import oscura as tk
+        >>> import oscura as osc
         >>> from functools import partial
         >>> # Create composed analysis function
-        >>> analyze_signal = tk.compose(
-        ...     tk.extract_thd,
-        ...     partial(tk.fft, nfft=8192, window='hann'),
-        ...     partial(tk.normalize, method='peak'),
-        ...     partial(tk.low_pass, cutoff=5e6)
+        >>> analyze_signal = osc.compose(
+        ...     osc.extract_thd,
+        ...     partial(osc.fft, nfft=8192, window='hann'),
+        ...     partial(osc.normalize, method='peak'),
+        ...     partial(osc.low_pass, cutoff=5e6)
         ... )
         >>> # Apply to trace: low_pass -> normalize -> fft -> extract_thd
         >>> thd = analyze_signal(trace)
@@ -84,24 +84,24 @@ def pipe(data: WaveformTrace, *funcs: TraceFunc) -> WaveformTrace:
         Transformed WaveformTrace after applying all functions.
 
     Example:
-        >>> import oscura as tk
+        >>> import oscura as osc
         >>> # Apply operations left-to-right
-        >>> result = tk.pipe(
+        >>> result = osc.pipe(
         ...     trace,
-        ...     tk.low_pass(cutoff=1e6),
-        ...     tk.resample(rate=1e9),
-        ...     tk.fft(nfft=8192)
+        ...     osc.low_pass(cutoff=1e6),
+        ...     osc.resample(rate=1e9),
+        ...     osc.fft(nfft=8192)
         ... )
         >>> # Equivalent to: fft(resample(low_pass(trace)))
 
     Advanced Example:
         >>> # Use with partial application
         >>> from functools import partial
-        >>> result = tk.pipe(
+        >>> result = osc.pipe(
         ...     trace,
-        ...     partial(tk.low_pass, cutoff=1e6),
-        ...     partial(tk.normalize, method='zscore'),
-        ...     partial(tk.fft, nfft=8192, window='hann')
+        ...     partial(osc.low_pass, cutoff=1e6),
+        ...     partial(osc.normalize, method='zscore'),
+        ...     partial(osc.fft, nfft=8192, window='hann')
         ... )
 
     References:

oscura/pipeline/pipeline.py

@@ -30,21 +30,21 @@ class Pipeline(TraceTransformer):
         named_steps: Dictionary mapping step names to transformers.
 
     Example:
-        >>> import oscura as tk
-        >>> pipeline = tk.Pipeline([
-        ...     ('lowpass', tk.LowPassFilter(cutoff=1e6)),
-        ...     ('resample', tk.Resample(rate=1e9)),
-        ...     ('normalize', tk.Normalize())
+        >>> import oscura as osc
+        >>> pipeline = osc.Pipeline([
+        ...     ('lowpass', osc.LowPassFilter(cutoff=1e6)),
+        ...     ('resample', osc.Resample(rate=1e9)),
+        ...     ('normalize', osc.Normalize())
         ... ])
         >>> result = pipeline.transform(trace)
 
     Advanced Example:
         >>> # Create analysis pipeline with fit/transform
-        >>> pipeline = tk.Pipeline([
-        ...     ('filter', tk.BandPassFilter(low=1e5, high=1e6)),
-        ...     ('normalize', tk.Normalize(method='zscore')),
-        ...     ('fft', tk.FFT(nfft=8192, window='hann')),
-        ...     ('extract', tk.ExtractMeasurement('thd'))
+        >>> pipeline = osc.Pipeline([
+        ...     ('filter', osc.BandPassFilter(low=1e5, high=1e6)),
+        ...     ('normalize', osc.Normalize(method='zscore')),
+        ...     ('fft', osc.FFT(nfft=8192, window='hann')),
+        ...     ('extract', osc.ExtractMeasurement('thd'))
         ... ])
         >>> # Fit on reference trace
         >>> pipeline.fit(reference_trace)

oscura/plugins/__init__.py

@@ -1,7 +1,7 @@
-"""TraceKit plugin system.
+"""Oscura plugin system.
 
 This package provides plugin discovery, registration, and management
-for extending TraceKit functionality.
+for extending Oscura functionality.
 
 
 Example:

oscura/plugins/base.py

@@ -1,6 +1,6 @@
 """Plugin base classes and metadata.
 
-This module defines the base class for TraceKit plugins and
+This module defines the base class for Oscura plugins and
 the metadata structures for plugin registration.
 
 
@@ -52,7 +52,7 @@ class PluginMetadata:
     Attributes:
         name: Unique plugin identifier.
         version: Plugin version (semver).
-        api_version: Required TraceKit API version.
+        api_version: Required Oscura API version.
         author: Plugin author.
         description: Human-readable description.
         homepage: Plugin homepage URL.
@@ -99,7 +99,7 @@ class PluginMetadata:
         Uses semver compatibility rules (major version must match).
 
         Args:
-            api_version: TraceKit API version to check against.
+            api_version: Oscura API version to check against.
 
         Returns:
             True if compatible.
@@ -113,7 +113,7 @@ class PluginMetadata:
 
 
 class PluginBase(ABC):  # noqa: B024
-    """Base class for all TraceKit plugins.
+    """Base class for all Oscura plugins.
 
     Subclass this to create a plugin. Define class attributes for
     metadata and implement lifecycle methods.
@@ -123,7 +123,7 @@ class PluginBase(ABC):  # noqa: B024
         ...     name = "uart_decoder"
         ...     version = "1.0.0"
         ...     api_version = "1.0.0"
-        ...     author = "TraceKit Contributors"
+        ...     author = "Oscura Contributors"
         ...     description = "UART protocol decoder"
         ...
         ...     def on_load(self):

oscura/plugins/discovery.py

@@ -36,8 +36,8 @@ except ImportError:
     YAML_AVAILABLE = False
 
 
-# TraceKit API version for compatibility checking
-TRACEKIT_API_VERSION = "1.0.0"
+# Oscura API version for compatibility checking
+OSCURA_API_VERSION = "1.0.0"
 
 
 @dataclass
@@ -218,7 +218,7 @@ def scan_entry_points() -> Iterator[DiscoveredPlugin]:
                         instance = plugin_class()
                         metadata = instance.metadata
 
-                        compatible = metadata.is_compatible_with(TRACEKIT_API_VERSION)
+                        compatible = metadata.is_compatible_with(OSCURA_API_VERSION)
 
                         yield DiscoveredPlugin(
                             metadata=metadata,
@@ -297,7 +297,7 @@ def _load_plugin_from_yaml(yaml_path: Path) -> DiscoveredPlugin | None:
                                 metadata.provides[key] = []
                             metadata.provides[key].append(value)
 
-        compatible = metadata.is_compatible_with(TRACEKIT_API_VERSION)
+        compatible = metadata.is_compatible_with(OSCURA_API_VERSION)
 
         return DiscoveredPlugin(
             metadata=metadata,
@@ -376,7 +376,7 @@ def _load_plugin_from_module(module_path: Path) -> DiscoveredPlugin | None:
             metadata = instance.metadata
             metadata.path = module_path
 
-            compatible = metadata.is_compatible_with(TRACEKIT_API_VERSION)
+            compatible = metadata.is_compatible_with(OSCURA_API_VERSION)
 
             return DiscoveredPlugin(
                 metadata=metadata,
@@ -402,7 +402,7 @@ def _load_plugin_from_module(module_path: Path) -> DiscoveredPlugin | None:
 
 
 __all__ = [
-    "TRACEKIT_API_VERSION",
+    "OSCURA_API_VERSION",
     "DiscoveredPlugin",
     "discover_plugins",
     "get_plugin_paths",

oscura/plugins/registry.py

@@ -16,7 +16,7 @@ import logging
 from typing import TYPE_CHECKING, Any
 
 from oscura.plugins.discovery import (
-    TRACEKIT_API_VERSION,
+    OSCURA_API_VERSION,
     DiscoveredPlugin,
     discover_plugins,
 )
@@ -55,7 +55,7 @@ class PluginVersionError(Exception):
 
     Attributes:
         plugin_api_version: Plugin's required API version.
-        oscura_api_version: Current TraceKit API version.
+        oscura_api_version: Current Oscura API version.
     """
 
     def __init__(
@@ -135,12 +135,12 @@ class PluginRegistry:
         metadata = instance.metadata
 
         # Check compatibility
-        if check_compatibility and not metadata.is_compatible_with(TRACEKIT_API_VERSION):
+        if check_compatibility and not metadata.is_compatible_with(OSCURA_API_VERSION):
             raise PluginVersionError(
                 f"Plugin '{metadata.name}' requires API v{metadata.api_version}, "
-                f"but TraceKit API is v{TRACEKIT_API_VERSION}",
+                f"but Oscura API is v{OSCURA_API_VERSION}",
                 plugin_api_version=metadata.api_version,
-                oscura_api_version=TRACEKIT_API_VERSION,
+                oscura_api_version=OSCURA_API_VERSION,
             )
 
         # Check conflicts (PLUG-002: conflict detection for duplicate plugins)
@@ -272,7 +272,7 @@ class PluginRegistry:
         metadata = self._metadata.get(name)
         if metadata is None:
             return False
-        return metadata.is_compatible_with(TRACEKIT_API_VERSION)
+        return metadata.is_compatible_with(OSCURA_API_VERSION)
 
     def discover_and_load(
         self,

oscura/plugins/versioning.py

@@ -163,7 +163,7 @@ class VersionCompatibilityLayer:
     """Multi-version compatibility layer for plugins.
 
     Allows plugins to support multiple API versions by adapting
-    the interface based on the current TraceKit API version.
+    the interface based on the current Oscura API version.
 
     References:
         PLUG-003: Plugin Versioning - multi-version compatibility layer
@@ -183,7 +183,7 @@ class VersionCompatibilityLayer:
         """Set target API version.
 
         Args:
-            api_version: TraceKit API version
+            api_version: Oscura API version
 
         References:
             PLUG-003: Plugin Versioning - multi-version compatibility

oscura/quality/__init__.py

@@ -1,4 +1,4 @@
-"""Signal quality analysis module for TraceKit."""
+"""Signal quality analysis module for Oscura."""
 
 from oscura.quality.ensemble import (
     AMPLITUDE_ENSEMBLE,

oscura/quality/scoring.py

@@ -1,4 +1,4 @@
-"""Analysis quality scoring for TraceKit.
+"""Analysis quality scoring for Oscura.
 
 This module provides quality scoring and reliability categorization for
 analysis results, enabling users to assess confidence in automated findings.

oscura/quality/warnings.py

@@ -1,4 +1,4 @@
-"""Signal quality warnings for TraceKit.
+"""Signal quality warnings for Oscura.
 
 This module provides automated detection and warning of signal quality issues
 including clipping, noise, saturation, and undersampling.

oscura/reporting/__init__.py

@@ -1,4 +1,4 @@
-"""Report generation module for TraceKit.
+"""Report generation module for Oscura.
 
 This module provides professional report generation including PDF/HTML
 output, templates, formatting, and multi-format export.

oscura/reporting/advanced.py

@@ -1,4 +1,4 @@
-"""Advanced reporting features for TraceKit.
+"""Advanced reporting features for Oscura.
 
 This module provides advanced reporting capabilities including interactive
 reports, scheduled generation, distribution, versioning, and compliance.

oscura/reporting/analyze.py

@@ -433,7 +433,7 @@ def _report_progress(
 
 
 def _get_version() -> str:
-    """Get TraceKit version."""
+    """Get Oscura version."""
     try:
         from oscura import __version__
 

oscura/reporting/auto_report.py

@@ -11,7 +11,7 @@ Example:
     >>> report.save_pdf("analysis_report.pdf")
 
 References:
-    TraceKit Auto-Discovery Specification
+    Oscura Auto-Discovery Specification
 """
 
 from __future__ import annotations
@@ -40,7 +40,7 @@ class ReportMetadata:
     """
 
     title: str = "Signal Analysis Report"
-    author: str = "TraceKit"
+    author: str = "Oscura"
     date: str = field(default_factory=lambda: datetime.now().strftime("%Y-%m-%d"))
     project: str | None = None
     tags: list[str] = field(default_factory=list)

oscura/reporting/batch.py

@@ -1,4 +1,4 @@
-"""Batch report generation for TraceKit.
+"""Batch report generation for Oscura.
 
 This module provides utilities for generating reports across multiple DUTs
 or files with summary reports and yield analysis.
@@ -114,7 +114,7 @@ def batch_report(
     References:
         RPT-003: Batch Report Generation
     """
-    import oscura as tk
+    import oscura as osc
     from oscura.reporting.template_system import load_template
 
     output_path = Path(output_dir)
@@ -143,7 +143,7 @@ def batch_report(
 
         try:
             # Load trace
-            trace = tk.load(str(file_path))
+            trace = osc.load(str(file_path))
 
             # Run analysis
             if analyzer is not None:

oscura/reporting/chart_selection.py

@@ -1,4 +1,4 @@
-"""Automated chart type selection for TraceKit reports.
+"""Automated chart type selection for Oscura reports.
 
 This module provides intelligent chart type selection based on data
 characteristics to optimize data visualization in reports.

oscura/reporting/comparison.py

@@ -1,4 +1,4 @@
-"""Comparison report generation for TraceKit.
+"""Comparison report generation for Oscura.
 
 This module provides utilities for comparing multiple traces or test runs
 and generating comparison reports with diff visualization.

oscura/reporting/core.py

@@ -1,4 +1,4 @@
-"""Core report generation for TraceKit.
+"""Core report generation for Oscura.
 
 This module provides the main report generation functionality including
 report structure, configuration, and output generation.
@@ -58,7 +58,7 @@ class ReportConfig:
         show_page_numbers: Include page numbers.
     """
 
-    title: str = "TraceKit Analysis Report"
+    title: str = "Oscura Analysis Report"
     author: str = ""
     verbosity: Literal["executive", "summary", "standard", "detailed", "debug"] = "standard"
     format: Literal["pdf", "html", "markdown", "docx"] = "pdf"
@@ -380,7 +380,7 @@ def generate_report(
     results: dict[str, Any],
     output_path: str | Path | None = None,
     *,
-    title: str = "TraceKit Analysis Report",
+    title: str = "Oscura Analysis Report",
     verbosity: Literal["executive", "summary", "standard", "detailed", "debug"] = ("standard"),
     template: str = "default",
     formats: list[str] | None = None,
@@ -413,7 +413,7 @@ def generate_report(
         **{k: v for k, v in kwargs.items() if hasattr(ReportConfig, k)},
     )
 
-    report = Report(config=config, metadata={"source": "TraceKit"})
+    report = Report(config=config, metadata={"source": "Oscura"})
 
     # Add executive summary
     if verbosity in ("executive", "summary", "standard", "detailed", "debug"):

oscura/reporting/export.py

@@ -1,4 +1,4 @@
-"""Multi-format report export for TraceKit.
+"""Multi-format report export for Oscura.
 
 This module provides unified export interface for generating reports in
 multiple formats (HTML, PDF, DOCX, Markdown) from a single source.

oscura/reporting/formatting.py

@@ -1,4 +1,4 @@
-"""Number and value formatting for TraceKit reports.
+"""Number and value formatting for Oscura reports.
 
 This module provides smart number formatting with SI prefixes,
 significant figures, and contextual annotations.

oscura/reporting/html.py

@@ -1,4 +1,4 @@
-"""HTML report generation for TraceKit.
+"""HTML report generation for Oscura.
 
 This module provides professional HTML report generation with modern features
 including responsive design, interactive plots, and collapsible sections.
@@ -73,8 +73,8 @@ def _generate_html_header(report: Report, dark_mode: bool, responsive: bool) ->
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="author" content="{report.config.author or "TraceKit"}">
-    <meta name="generator" content="TraceKit Reporting System">
+    <meta name="author" content="{report.config.author or "Oscura"}">
+    <meta name="generator" content="Oscura Reporting System">
     <title>{report.config.title}</title>"""
 
 

oscura/reporting/multichannel.py

@@ -1,4 +1,4 @@
-"""Multi-channel report generation for TraceKit.
+"""Multi-channel report generation for Oscura.
 
 This module provides utilities for generating reports across multiple channels
 with channel comparison and aggregation.

oscura/reporting/output.py

@@ -38,7 +38,7 @@ def _sanitize_for_serialization(obj: Any, max_depth: int = 10) -> Any:
         return "<max depth exceeded>"
 
     try:
-        # Don't sanitize TraceKit types - let the JSONEncoder handle them
+        # Don't sanitize Oscura types - let the JSONEncoder handle them
         if isinstance(obj, WaveformTrace | DigitalTrace | TraceMetadata):
             return obj
         if isinstance(obj, dict):

oscura/reporting/pdf.py

@@ -1,4 +1,4 @@
-"""PDF report generation for TraceKit.
+"""PDF report generation for Oscura.
 
 This module provides high-quality PDF report generation with embedded plots,
 metadata, and PDF/A compliance for archival.
@@ -86,7 +86,7 @@ def generate_pdf_report(
         topMargin=margin,
         bottomMargin=margin,
         title=report.config.title,
-        author=report.config.author or "TraceKit",
+        author=report.config.author or "Oscura",
     )
 
     # Build document story

oscura/reporting/pptx_export.py

@@ -1,4 +1,4 @@
-"""PowerPoint presentation export for TraceKit reports.
+"""PowerPoint presentation export for Oscura reports.
 
 This module provides PPTX generation for stakeholder presentations
 with automated slide layouts, embedded plots, and speaker notes.

oscura/reporting/sections.py

@@ -1,4 +1,4 @@
-"""Report section generation for TraceKit.
+"""Report section generation for Oscura.
 
 This module provides utilities for creating standardized report sections
 including title, summary, measurements, plots, and conclusions.

oscura/reporting/standards.py

@@ -1,7 +1,7 @@
 """Professional formatting standards and visual emphasis for reports.
 
 This module provides professional formatting standards, visual emphasis
-systems, and executive summary generation for TraceKit reports.
+systems, and executive summary generation for Oscura reports.
 
 
 Example:
@@ -88,7 +88,7 @@ class FormatStandards:
             REPORT-001: Professional Formatting Standards
         """
         return f"""
-/* TraceKit Professional Report Styles - REPORT-001 */
+/* Oscura Professional Report Styles - REPORT-001 */
 :root {{
     --heading-font: {self.heading_font};
     --body-font: {self.body_font};

oscura/reporting/summary_generator.py

@@ -11,7 +11,7 @@ Example:
     >>> print(summary.text)
 
 References:
-    TraceKit Auto-Discovery Specification
+    Oscura Auto-Discovery Specification
 """
 
 from __future__ import annotations

oscura/reporting/tables.py

@@ -1,4 +1,4 @@
-"""Table generation and formatting for TraceKit reports.
+"""Table generation and formatting for Oscura reports.
 
 This module provides utilities for creating and formatting measurement
 summary tables with professional appearance.

oscura/reporting/template_system.py

@@ -1,4 +1,4 @@
-"""Template system for TraceKit reports.
+"""Template system for Oscura reports.
 
 This module provides template loading, management, inheritance, and built-in
 report templates.

oscura/reporting/templates/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>{{title}} - TraceKit Analysis Report</title>
+    <title>{{title}} - Oscura Analysis Report</title>
     <style>
       :root {
         --bg-primary: #ffffff;
@@ -642,7 +642,7 @@
     </section>
 
     <footer>
-      <p>Generated by TraceKit Comprehensive Analysis System</p>
+      <p>Generated by Oscura Comprehensive Analysis System</p>
       <p>Report generated at {{timestamp}}</p>
     </footer>
   </body>

oscura/schemas/__init__.py

@@ -1,7 +1,7 @@
-"""JSON Schema definitions for TraceKit configuration types.
+"""JSON Schema definitions for Oscura configuration types.
 
 This module provides JSON Schema definitions for validating various
-configuration file types used in TraceKit, including packet formats,
+configuration file types used in Oscura, including packet formats,
 device mappings, bus configurations, and protocol definitions.
 
 

oscura/schemas/bus_configuration.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://tracekit.io/schemas/bus_configuration.json",
+  "$id": "https://oscura.io/schemas/bus_configuration.json",
   "title": "Bus Configuration Schema",
   "description": "Schema for validating parallel bus configurations for multi-bit protocols (CFG-001).",
   "type": "object",

oscura/schemas/device_mapping.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://tracekit.io/schemas/device_mapping.json",
+  "$id": "https://oscura.io/schemas/device_mapping.json",
   "title": "Device Mapping Configuration Schema",
   "description": "Schema for validating device ID to name mappings and device-specific parameters (CFG-001).",
   "type": "object",

oscura/schemas/packet_format.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://tracekit.io/schemas/packet_format.json",
+  "$id": "https://oscura.io/schemas/packet_format.json",
   "title": "Packet Format Configuration Schema",
   "description": "Schema for validating binary packet format configurations for custom DAQ systems and packet captures (CFG-001).",
   "type": "object",

oscura/schemas/protocol_definition.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://tracekit.io/schemas/protocol_definition.json",
+  "$id": "https://oscura.io/schemas/protocol_definition.json",
   "title": "Protocol Definition Schema",
   "description": "Schema for validating protocol DSL definitions for automatic decoder/encoder generation (CFG-001).",
   "type": "object",

oscura/search/__init__.py

@@ -1,4 +1,4 @@
-"""Pattern search and anomaly detection for TraceKit.
+"""Pattern search and anomaly detection for Oscura.
 
 
 This module enables efficient pattern matching, anomaly detection, and

oscura/session/__init__.py

@@ -1,18 +1,18 @@
-"""Session management for TraceKit analysis sessions.
+"""Session management for Oscura analysis sessions.
 
 This module provides session save/restore, trace annotations, and
 operation history tracking.
 
 
 Example:
-    >>> import oscura as tk
-    >>> session = tk.Session()
+    >>> import oscura as osc
+    >>> session = osc.Session()
     >>> session.load_trace('capture.wfm')
     >>> session.annotate(time=1.5e-6, text='Glitch here')
     >>> session.save('debug_session.tks')
     >>>
     >>> # Later...
-    >>> session = tk.load_session('debug_session.tks')
+    >>> session = osc.load_session('debug_session.tks')
     >>> print(session.annotations)
 """