Metadata-Version: 2.3
Name: failtrace
Version: 0.0.8
Summary: Leveraging Large Language Models for Automated Test Results Analysis
License: MIT
Keywords: cli,testing,llm,analysis
Author: Mohadese Akhoondy
Author-email: m.akhoondy1381@gmail.com
Requires-Python: >=3.12
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Dist: javalang (>=0.13.0,<0.14.0)
Requires-Dist: libcst (>=1.8.2,<2.0.0)
Requires-Dist: networkx (>=3.5,<4.0)
Requires-Dist: openai (>=1.99.9,<2.0.0)
Requires-Dist: platformdirs (>=4.2,<5.0)
Requires-Dist: pycg (>=0.0.8,<0.0.9)
Requires-Dist: pyvis (>=0.3.2,<0.4.0)
Requires-Dist: requests (>=2.32.4,<3.0.0)
Requires-Dist: rich (>=14.1.0,<15.0.0)
Requires-Dist: tree-sitter (>=0.25.1,<0.26.0)
Requires-Dist: tree-sitter-c-sharp (==0.23.1)
Description-Content-Type: text/markdown

# FailTrace  

**Leveraging Large Language Models for Automated Test Results Analysis**  

[![PyPI version](https://badge.fury.io/py/failtrace.svg)](https://pypi.org/project/failtrace/)  
[![Python Version](https://img.shields.io/pypi/pyversions/failtrace)](https://www.python.org/)  

---

## 🌍 Overview  

FailTrace helps developers and QA engineers **analyze automated test results** with **Large Language Models (LLMs)**.  
It builds **dependency graphs**, maps them with test execution logs, and generates **interactive HTML reports** with insights into failures.  

---

## ✨ Features  

- Supports **Python, Java, C#**  
- Dependency graph visualization (PyVis + NetworkX)  
- Test log parsing (Pytest, JSON, TRX, …)  
- Interactive reports (`HTML + CSS + JS`)  
- Dry-run mode (no API calls)  
- CLI-first design for CI/CD  

---

## 📦 Installation  

```bash
pip install failtrace
````

---

## ⚡ Quickstart

Run the **full pipeline**:

```bash
python -m failtrace full -p ./your-source-code -l ./your-test-results.xml --open-report
```

Run in **quick mode** (reuse cached graph):

```bash
failtrace quick -p ./src -l ./results.json
```

---

## 📜 License

Licensed under the [MIT License](https://opensource.org/licenses/MIT).

---

## 👩‍💻 Author

[**Mohadese Akhoondy**](mailto:m.akhoondy1381@gmail.com)

```

