SimpleInsulinCalc

A lightweight insulin dose calculator with CLI and GUI support for people with Type 1 diabetes.

---

📦 Versions

• v1.0 CLI – A simple command-line tool for calculating insulin doses.
• v1.1 GUI – A Tkinter-based GUI app with user-friendly features.
• v1.1.1 – Adds automated build and release workflow using GitHub Actions and PyInstaller.

---

🚀 Features

• Carbohydrate-based bolus dose calculation
• Optional correctional insulin input
• GUI supports dropdowns and radio buttons for better UX
• Fully testable and cross-platform
• GitHub Actions CI/CD for testing and builds

---

🔧 Installation

CLI Version

cd v1.0_cli
pip install -r requirements.txt
python main.py

GUI Version

cd v1.1_gui
pip install -r requirements.txt
python SimpleInsulinCalc_GUI_Refactored_Accessible.py

---

💾 Executable Download

Download the .exe from the Releases page for Windows — no Python required.

---

📄 Documentation

• User Guide
• CHANGELOG.md
• RELEASE_NOTES.md
• docs/ (for GitHub Pages)

---

🧪 Testing

Tests run automatically on GitHub Actions. You can run them locally with:

cd v1.0_cli
pytest test_cli.py

cd ../v1.1_gui
pytest test_gui.py

---

📁 Project Structure

insulin-calculator-simple/
├── v1.0_cli/             # CLI version
├── v1.1_gui/             # GUI version
├── installer/            # PyInstaller scripts & icon
├── .github/workflows/    # GitHub Actions
├── docs/                 # User guide and optional docs site
├── README.md
├── CHANGELOG.md
└── RELEASE_NOTES.md

---

👨‍⚕️ Disclaimer

This app does not replace medical advice. Always consult your doctor before making insulin adjustments.

---

📝 License

MIT License. See LICENSE for full terms.

---

📝 Notes

This project is a combination of two previous projects I created: simpleinsulincalc (v1.0) and simpleinsulincalcGUI (v1.1). I have since removed them from my GitHub account after the creation of this unified repository.