tritonparse 0.2.4.dev20251007071533__tar.gz → 0.2.4.dev20251009071511__tar.gz

{tritonparse-0.2.4.dev20251007071533 → tritonparse-0.2.4.dev20251009071511}/.github/workflows/test.yml

@@ -142,7 +142,7 @@ jobs:
                   TRITON_COMMIT: ${{ steps.triton-commit.outputs.commit }}
               run: |
                   bash .ci/install-triton.sh
-                  bash .ci/install-triton-kernels.sh
+
             - name: Install project dependencies
               env:
                   CONDA_ENV: tritonparse
@@ -192,12 +192,6 @@ jobs:
               run: |
                   bash .ci/setup.sh
 
-            - name: Install Triton kernels
-              env:
-                  CONDA_ENV: tritonparse-pip
-              run: |
-                  bash .ci/install-triton-kernels.sh
-
             - name: Install project dependencies
               env:
                   CONDA_ENV: tritonparse-pip

{tritonparse-0.2.4.dev20251007071533 → tritonparse-0.2.4.dev20251009071511}/.gitignore

@@ -70,4 +70,5 @@ env.bak/
 venv.bak/
 *.mdc
 repro_output/
+.github/copilot-instructions.md
 # end

{tritonparse-0.2.4.dev20251007071533 → tritonparse-0.2.4.dev20251009071511}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tritonparse
-Version: 0.2.4.dev20251007071533
+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
@@ -27,13 +27,27 @@ Dynamic: license-file
 
 ## ✨ Key Features
 
-- **🚀 Launch Difference Analysis** - Automatically detect and visualize variations in kernel launch parameters, helping you pinpoint performance bottlenecks and debug launch configurations.
-- **🔍 Interactive Visualization** - Explore Triton kernels with detailed metadata and stack traces
-- **📊 Multi-format IR Support** - View TTGIR, TTIR, LLIR, PTX, and AMDGCN in one place
-- **🔄 Side-by-side Comparison** - Compare IR stages with synchronized highlighting
-- **📝 Structured Logging** - Capture detailed compilation and launch events with source mapping
-- **🌐 Ready-to-use Interface** - No installation required, works in your browser
-- **🔒 Privacy-first** - All processing happens locally in your browser, no data uploaded
+### 🔍 Visualization & Analysis
+- **🚀 Launch Difference Analysis** - Detect and visualize kernel launch parameter variations
+- **📊 IR Code View** - Side-by-side IR viewing with synchronized highlighting and line mapping
+- **🔄 File Diff View** - Compare kernels across different trace files side-by-side
+- **📝 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
+- **🌐 Browser-based Interface** - No installation required, works in your browser
+- **🔒 Privacy-first** - All processing happens locally, no data uploaded
 
 ## 🚀 Quick Start
 
@@ -41,22 +55,22 @@ Dynamic: license-file
 
 ```python
 import tritonparse.structured_logging
+import tritonparse.utils
 
-# Initialize logging with launch tracing enabled
+# Initialize logging
 tritonparse.structured_logging.init("./logs/", enable_trace_launch=True)
 
 # Your Triton/PyTorch code here
 # ... your kernels ...
 
 # Parse and generate trace files
-import tritonparse.utils
-tritonparse.utils.unified_parse("./logs/")
+tritonparse.utils.unified_parse("./logs/", out="./parsed_output")
 ```
-The example terminal output is:
-```bash
-tritonparse log file list: /tmp/tmp1gan7zky/log_file_list.json
-INFO:tritonparse:Copying parsed logs from /tmp/tmp1gan7zky to /scratch/findhao/tritonparse/tests/parsed_output
 
+<details>
+<summary>📝 Example output (click to expand)</summary>
+
+```bash
 ================================================================================
 📁 TRITONPARSE PARSING RESULTS
 ================================================================================
@@ -64,13 +78,13 @@ INFO:tritonparse:Copying parsed logs from /tmp/tmp1gan7zky to /scratch/findhao/t
 📊 Total files generated: 2
 
 📄 Generated files:
---------------------------------------------------
    1. 📝 dedicated_log_triton_trace_findhao__mapped.ndjson.gz (7.2KB)
    2. 📝 log_file_list.json (181B)
 ================================================================================
 ✅ Parsing completed successfully!
 ================================================================================
 ```
+</details>
 
 ### 2. Visualize Results
 
@@ -78,6 +92,41 @@ INFO:tritonparse:Copying parsed logs from /tmp/tmp1gan7zky to /scratch/findhao/t
 
 > **🔒 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):**
@@ -106,18 +155,13 @@ pip install triton
 
 | 📖 Guide | Description |
 |----------|-------------|
-| **[🏠 Wiki Home](https://github.com/meta-pytorch/tritonparse/wiki)** | Complete documentation and navigation |
-| **[📦 Installation Guide](https://github.com/meta-pytorch/tritonparse/wiki/01.-Installation)** | Detailed setup for all scenarios |
-| **[📋 Usage Guide](https://github.com/meta-pytorch/tritonparse/wiki/02.-Usage-Guide)** | Complete workflow and examples |
-| **[🌐 Web Interface Guide](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 development setup |
-| **[❓ FAQ](https://github.com/meta-pytorch/tritonparse/wiki/06.-FAQ)** | Frequently asked questions |
-
-## 🛠️ Tech Stack
-
-- **Frontend**: React 19, TypeScript, Vite, Tailwind CSS, Monaco Editor
-- **Backend**: Python with Triton integration, structured logging
-- **Deployment**: GitHub Pages, automatic deployment
+| **[🏠 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, 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 |
+| **[❓ FAQ](https://github.com/meta-pytorch/tritonparse/wiki/06.-FAQ)** | Quick answers and troubleshooting |
 
 ## 📊 Understanding Triton Compilation
 
@@ -130,9 +174,10 @@ Each stage can be inspected and compared to understand optimization transformati
 ## 🤝 Contributing
 
 We welcome contributions! Please see our **[Developer Guide](https://github.com/meta-pytorch/tritonparse/wiki/04.-Developer-Guide)** for:
-- Development setup
-- Code formatting standards
-- Pull request process
+- Development setup and prerequisites
+- Code formatting standards (**[Formatting Guide](https://github.com/meta-pytorch/tritonparse/wiki/05.-Code-Formatting)**)
+- Pull request and code review process
+- Testing guidelines
 - Architecture overview
 
 ## 📞 Support & Community

{tritonparse-0.2.4.dev20251007071533 → tritonparse-0.2.4.dev20251009071511}/README.md

@@ -9,13 +9,27 @@
 
 ## ✨ Key Features
 
-- **🚀 Launch Difference Analysis** - Automatically detect and visualize variations in kernel launch parameters, helping you pinpoint performance bottlenecks and debug launch configurations.
-- **🔍 Interactive Visualization** - Explore Triton kernels with detailed metadata and stack traces
-- **📊 Multi-format IR Support** - View TTGIR, TTIR, LLIR, PTX, and AMDGCN in one place
-- **🔄 Side-by-side Comparison** - Compare IR stages with synchronized highlighting
-- **📝 Structured Logging** - Capture detailed compilation and launch events with source mapping
-- **🌐 Ready-to-use Interface** - No installation required, works in your browser
-- **🔒 Privacy-first** - All processing happens locally in your browser, no data uploaded
+### 🔍 Visualization & Analysis
+- **🚀 Launch Difference Analysis** - Detect and visualize kernel launch parameter variations
+- **📊 IR Code View** - Side-by-side IR viewing with synchronized highlighting and line mapping
+- **🔄 File Diff View** - Compare kernels across different trace files side-by-side
+- **📝 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
+- **🌐 Browser-based Interface** - No installation required, works in your browser
+- **🔒 Privacy-first** - All processing happens locally, no data uploaded
 
 ## 🚀 Quick Start
 
@@ -23,22 +37,22 @@
 
 ```python
 import tritonparse.structured_logging
+import tritonparse.utils
 
-# Initialize logging with launch tracing enabled
+# Initialize logging
 tritonparse.structured_logging.init("./logs/", enable_trace_launch=True)
 
 # Your Triton/PyTorch code here
 # ... your kernels ...
 
 # Parse and generate trace files
-import tritonparse.utils
-tritonparse.utils.unified_parse("./logs/")
+tritonparse.utils.unified_parse("./logs/", out="./parsed_output")
 ```
-The example terminal output is:
-```bash
-tritonparse log file list: /tmp/tmp1gan7zky/log_file_list.json
-INFO:tritonparse:Copying parsed logs from /tmp/tmp1gan7zky to /scratch/findhao/tritonparse/tests/parsed_output
 
+<details>
+<summary>📝 Example output (click to expand)</summary>
+
+```bash
 ================================================================================
 📁 TRITONPARSE PARSING RESULTS
 ================================================================================
@@ -46,13 +60,13 @@ INFO:tritonparse:Copying parsed logs from /tmp/tmp1gan7zky to /scratch/findhao/t
 📊 Total files generated: 2
 
 📄 Generated files:
---------------------------------------------------
    1. 📝 dedicated_log_triton_trace_findhao__mapped.ndjson.gz (7.2KB)
    2. 📝 log_file_list.json (181B)
 ================================================================================
 ✅ Parsing completed successfully!
 ================================================================================
 ```
+</details>
 
 ### 2. Visualize Results
 
@@ -60,6 +74,41 @@ INFO:tritonparse:Copying parsed logs from /tmp/tmp1gan7zky to /scratch/findhao/t
 
 > **🔒 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):**
@@ -88,18 +137,13 @@ pip install triton
 
 | 📖 Guide | Description |
 |----------|-------------|
-| **[🏠 Wiki Home](https://github.com/meta-pytorch/tritonparse/wiki)** | Complete documentation and navigation |
-| **[📦 Installation Guide](https://github.com/meta-pytorch/tritonparse/wiki/01.-Installation)** | Detailed setup for all scenarios |
-| **[📋 Usage Guide](https://github.com/meta-pytorch/tritonparse/wiki/02.-Usage-Guide)** | Complete workflow and examples |
-| **[🌐 Web Interface Guide](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 development setup |
-| **[❓ FAQ](https://github.com/meta-pytorch/tritonparse/wiki/06.-FAQ)** | Frequently asked questions |
-
-## 🛠️ Tech Stack
-
-- **Frontend**: React 19, TypeScript, Vite, Tailwind CSS, Monaco Editor
-- **Backend**: Python with Triton integration, structured logging
-- **Deployment**: GitHub Pages, automatic deployment
+| **[🏠 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, 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 |
+| **[❓ FAQ](https://github.com/meta-pytorch/tritonparse/wiki/06.-FAQ)** | Quick answers and troubleshooting |
 
 ## 📊 Understanding Triton Compilation
 
@@ -112,9 +156,10 @@ Each stage can be inspected and compared to understand optimization transformati
 ## 🤝 Contributing
 
 We welcome contributions! Please see our **[Developer Guide](https://github.com/meta-pytorch/tritonparse/wiki/04.-Developer-Guide)** for:
-- Development setup
-- Code formatting standards
-- Pull request process
+- Development setup and prerequisites
+- Code formatting standards (**[Formatting Guide](https://github.com/meta-pytorch/tritonparse/wiki/05.-Code-Formatting)**)
+- Pull request and code review process
+- Testing guidelines
 - Architecture overview
 
 ## 📞 Support & Community