tritonparse 0.2.4.dev20251008071501__py3-none-any.whl → 0.2.4.dev20251009071511__py3-none-any.whl

{tritonparse-0.2.4.dev20251008071501.dist-info → tritonparse-0.2.4.dev20251009071511.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tritonparse
-Version: 0.2.4.dev20251008071501
+Version: 0.2.4.dev20251009071511
 Summary: TritonParse: A Compiler Tracer, Visualizer, and mini-Reproducer Generator for Triton Kernels
 Author-email: Yueming Hao <yhao@meta.com>
 License-Expression: BSD-3-Clause
@@ -34,13 +34,18 @@ Dynamic: license-file
 - **📝 Multi-format IR Support** - View TTGIR, TTIR, LLIR, PTX, and AMDGCN
 - **🎯 Interactive Code Views** - Click-to-highlight corresponding lines across IR stages
 
+### 🔧 Reproducer & Debugging Tools
+- **🔄 Standalone Script Generation** - Extract any kernel into a self-contained Python script
+- **💾 Tensor Data Reconstruction** - Preserve actual tensor data or use statistical approximation
+- **🎯 Custom Templates** - Flexible reproducer templates for different workflows
+- **🐛 Bug Isolation** - Share reproducible test cases for debugging and collaboration
+
 ### 📊 Structured Logging & Analysis
 - **📝 Compilation & Launch Tracing** - Capture detailed events with source mapping
 - **🔍 Stack Trace Integration** - Full Python stack traces for debugging
 - **📈 Metadata Extraction** - Comprehensive kernel statistics
 
 ### 🛠️ Developer Tools
-- **🔧 Reproducer Generation** - Generate standalone Python scripts to reproduce kernels
 - **🌐 Browser-based Interface** - No installation required, works in your browser
 - **🔒 Privacy-first** - All processing happens locally, no data uploaded
 
@@ -87,6 +92,41 @@ tritonparse.utils.unified_parse("./logs/", out="./parsed_output")
 
 > **🔒 Privacy Note**: Your trace files are processed entirely in your browser - nothing is uploaded to any server!
 
+### 3. Generate Reproducers (Optional)
+
+Extract any kernel into a standalone, executable Python script for debugging or testing:
+
+```bash
+# Generate reproducer from first launch event
+tritonparse reproduce ./parsed_output/trace.ndjson.gz --line 2 --out-dir repro_output
+
+# Run the generated reproducer
+cd repro_output/<kernel_name>/
+python repro_*.py
+```
+
+**Python API:**
+```python
+from tritonparse.reproducer.orchestrator import reproduce
+
+result = reproduce(
+    input_path="./parsed_output/trace.ndjson.gz",
+    line_index=1,           # Which launch event (1-based)
+    out_dir="repro_output"
+)
+```
+
+<details>
+<summary>🎯 Common Reproducer Use Cases (click to expand)</summary>
+
+- **🐛 Bug Isolation**: Extract a failing kernel into a minimal standalone script
+- **⚡ Performance Testing**: Benchmark specific kernels without running the full application
+- **🤝 Team Collaboration**: Share reproducible test cases with colleagues or in bug reports
+- **📊 Regression Testing**: Compare kernel behavior and performance across different versions
+- **🔍 Deep Debugging**: Modify and experiment with kernel parameters in isolation
+
+</details>
+
 ## 🛠️ Installation
 
 **For basic usage (trace generation):**
@@ -117,7 +157,7 @@ pip install triton
 |----------|-------------|
 | **[🏠 Wiki Home](https://github.com/meta-pytorch/tritonparse/wiki)** | Complete documentation and quick navigation |
 | **[📦 Installation](https://github.com/meta-pytorch/tritonparse/wiki/01.-Installation)** | Setup guide for all scenarios |
-| **[📋 Usage Guide](https://github.com/meta-pytorch/tritonparse/wiki/02.-Usage-Guide)** | Complete workflow, examples, and reproducer |
+| **[📋 Usage Guide](https://github.com/meta-pytorch/tritonparse/wiki/02.-Usage-Guide)** | Complete workflow, reproducer generation, and examples |
 | **[🌐 Web Interface](https://github.com/meta-pytorch/tritonparse/wiki/03.-Web-Interface-Guide)** | Master the visualization interface |
 | **[🔧 Developer Guide](https://github.com/meta-pytorch/tritonparse/wiki/04.-Developer-Guide)** | Contributing and architecture overview |
 | **[📝 Code Formatting](https://github.com/meta-pytorch/tritonparse/wiki/05.-Code-Formatting)** | Formatting standards and tools |

{tritonparse-0.2.4.dev20251008071501.dist-info → tritonparse-0.2.4.dev20251009071511.dist-info}/RECORD

@@ -30,9 +30,9 @@ tritonparse/tools/format_fix.py,sha256=Ol0Sjui8D7OzHwbamAfGnq8V5Y63uwNaFTKSORN5H
 tritonparse/tools/load_tensor.py,sha256=94-TiSYlpXJx4MPmGK1ovmZlTt56Q_B3KQeCPaA6Cnw,2734
 tritonparse/tools/prettify_ndjson.py,sha256=r2YlHwFDTHgML7KljRmMsHaDg29q8gOQAgyDKWJhxRM,11062
 tritonparse/tools/readme.md,sha256=w6PWYfYnRgoPArLjxG9rVrpcLUkoVMGuRlbpF-o0IQM,110
-tritonparse-0.2.4.dev20251008071501.dist-info/licenses/LICENSE,sha256=4ZciugpyN7wcM4L-9pyDh_etvMUeIfBhDTyH1zeZlQM,1515
-tritonparse-0.2.4.dev20251008071501.dist-info/METADATA,sha256=X2CK43nr0PhdprpuK3wPsCqtJbqfJwxkbDHafqKq1ec,6766
-tritonparse-0.2.4.dev20251008071501.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-tritonparse-0.2.4.dev20251008071501.dist-info/entry_points.txt,sha256=wEXdaieDoRRCCdhEv2p_C68iytnaXU_2pwt5CqjfbWY,56
-tritonparse-0.2.4.dev20251008071501.dist-info/top_level.txt,sha256=ITcTKgp3vf_bXV9vixuQU9IrZa3L1EfDSZwvRzRaoJU,12
-tritonparse-0.2.4.dev20251008071501.dist-info/RECORD,,
+tritonparse-0.2.4.dev20251009071511.dist-info/licenses/LICENSE,sha256=4ZciugpyN7wcM4L-9pyDh_etvMUeIfBhDTyH1zeZlQM,1515
+tritonparse-0.2.4.dev20251009071511.dist-info/METADATA,sha256=_kKjKy0Btt-CMFJyBS3giCWw07kTqht3JWybYpgC_p4,8250
+tritonparse-0.2.4.dev20251009071511.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+tritonparse-0.2.4.dev20251009071511.dist-info/entry_points.txt,sha256=wEXdaieDoRRCCdhEv2p_C68iytnaXU_2pwt5CqjfbWY,56
+tritonparse-0.2.4.dev20251009071511.dist-info/top_level.txt,sha256=ITcTKgp3vf_bXV9vixuQU9IrZa3L1EfDSZwvRzRaoJU,12
+tritonparse-0.2.4.dev20251009071511.dist-info/RECORD,,