Metadata-Version: 2.4
Name: win_can_tool
Version: 1.2.16
Summary: Windows CAN simulator and testing tool with GUI and CLI.
Author: Kurtis Fafard
License: MIT
Project-URL: Homepage, https://github.com/kfafard/win_can_tool
Project-URL: Source, https://github.com/kfafard/win_can_tool
Project-URL: Issues, https://github.com/kfafard/win_can_tool/issues
Keywords: CAN,J1939,NMEA2000,tractor,simulator,python-can,PyQt6
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt6
Requires-Dist: python-can
Dynamic: license-file

# win_can_tool

A lightweight, Windows‑focused CAN message generator and simulation tool.

This project provides a simple GUI for sending repeating CAN messages using selectable profiles.  
It is designed primarily for agricultural CANbus development, CDL gateway testing, bench simulations, and rapid prototyping.

---

## ⭐ Features
- Clean Windows GUI (PyQt6)
- Select CAN interface:
  - **Virtual CAN (python-can built‑in virtual bus)**
  - **ValueCAN4** (verified)
- Load prebuilt CAN message profiles
- Live message editing (ID, DLC, hex bytes)
- Adjustable send frequency
- Console log for events and message prints
- Light/Dark theme assets included

---

## 🖥️ Running the Application

### **Option 1 — Use the EXE (Recommended)**
Download the latest release from GitHub:

```
win_can_tool.exe
```

Run it directly — no Python install required.

---

### **Option 2 — Run From Source**
```bash
pip install -r requirements.txt
python -m win_can_tool.gui
```

---

## 🧩 Project Layout
```
win_can_tool/
  bus.py
  cli.py
  engine.py
  gui.py
  profiles.py
  version.py
assets/
  gui_dark.png
  gui_light.png
win_can_tool.ico
```

---

## 📦 Releases
Every tagged version automatically builds:
- PyPI package
- Windows EXE
- CHANGELOG
- GitHub Release with artifacts

Tag format:
```
v1.2.8
```

---

## 🤝 Contributing
See **CONTRIBUTING.md** for full guidelines.

## 🛠 Development Details
See **DEVELOPMENT.md** for deep-dive architecture and internals.
