Home

fixpy Wiki 🚀

Welcome to the official documentation for fixpy-traceback.

fixpy is a smart Python CLI tool that analyzes and explains Python tracebacks in a beginner-friendly way with beautiful terminal output and Arabic language support.

---

Quick Links

• Installation
• Getting Started
• CLI Commands
• Supported Errors
• Arabic Support
• Watch Mode
• JSON Output
• Architecture
• Contributing

---

Installation

Install from PyPI

pip install fixpy-traceback

---

Quick Example

Analyze a Python traceback

python app.py 2>&1 | fixpy

Analyze a log file

fixpy error.log

Arabic mode

fixpy --lang ar error.log

Watch mode

fixpy --watch app.py

---

Features

• Smart traceback analysis
• Beginner-friendly explanations
• Suggested fixes and solutions
• Ready-to-use code examples
• Arabic language support
• Rich terminal UI
• Watch mode
• JSON output
• pip install suggestions
• Python 3.9 – 3.13 support

---

Supported Errors

fixpy currently supports analysis for:

• SyntaxError
• IndentationError
• NameError
• TypeError
• AttributeError
• ImportError
• ModuleNotFoundError
• IndexError
• KeyError
• ZeroDivisionError
• ValueError
• FileNotFoundError
• RuntimeError
• RecursionError

---

Project Architecture

fixpy uses a modular architecture:

Parser
   ↓
Analyzer Registry
   ↓
Specific Error Analyzers
   ↓
Formatter
   ↓
CLI Output

Main technologies used:

• Python
• Rich
• Typer
• Pytest
• GitHub Actions

---

Contributing

Contributions are welcome!

If you'd like to contribute:

1. Fork the repository
2. Create a new branch
3. Make your changes
4. Open a Pull Request

Please read the CONTRIBUTING.md file before submitting changes.

---

GitHub

https://github.com/yousseeff20/fixpy

PyPI

https://pypi.org/project/fixpy-traceback/

---

⭐ If you like the project, consider giving it a star on GitHub!