corally 1.0.0__tar.gz

corally-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Corally Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

corally-1.0.0/MANIFEST.in

@@ -0,0 +1,38 @@
+# Include documentation files
+include README.md
+include LICENSE
+include CHANGELOG.md
+
+# Include configuration files
+include pyproject.toml
+include setup.py
+
+# Include documentation directory
+recursive-include docs *.md *.txt *.rst
+
+# Include test files
+recursive-include tests *.py
+
+# Include data files
+recursive-include src/corally *.txt *.csv *.json
+
+# Exclude compiled Python files
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *.pyd
+global-exclude __pycache__
+global-exclude .git*
+global-exclude .DS_Store
+
+# Exclude development files
+exclude .gitignore
+exclude .env
+exclude .env.example
+exclude tox.ini
+exclude .coverage
+exclude .pytest_cache
+
+# Exclude build artifacts
+exclude build
+exclude dist
+exclude *.egg-info

corally-1.0.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: corally
+Version: 1.0.0
+Summary: A comprehensive calculator suite with GUI and API support
+Home-page: https://github.com/yourusername/corally
+Author: Corally Team
+Author-email: Corally Team <fleermaxim@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/mephisto-007
+Project-URL: Documentation, https://github.com/mephisto-007/corally#readme
+Project-URL: Repository, https://github.com/mephisto-007/Corally
+Project-URL: Bug Tracker, https://github.com/mephisto-007/corally/issues
+Keywords: calculator,currency,converter,interest,gui,api,finance,math,tkinter,fastapi
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.68.0
+Requires-Dist: uvicorn>=0.15.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: python-dotenv>=0.19.0
+Provides-Extra: gui
+Requires-Dist: tkinter; extra == "gui"
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# 🧮 Corally Calculator Suite
+
+[![PyPI version](https://badge.fury.io/py/corally.svg)](https://badge.fury.io/py/corally)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A comprehensive Python calculator suite with modern GUI, CLI tools, and API servers. Features live currency conversion, interest calculations, and automatic operation logging.
+
+## ✨ Features
+
+- **🧮 Basic Calculator** - Four operations with automatic CSV logging
+- **💱 Currency Converter** - Static rates + live API integration (150+ currencies)
+- **📈 Interest Calculator** - Multiple methods (30/360, act/360, act/365, act/act)
+- **🎨 Modern GUI** - Dark theme with tabbed interface
+- **🌐 Live API** - Free & paid currency APIs with caching
+- **📊 Auto Logging** - All operations saved to CSV files
+- **🖥️ Multiple Interfaces** - GUI, CLI, and API access
+
+## 🚀 Quick Start
+
+### Installation from PyPI
+```bash
+pip install corally
+```
+
+### Command Line Usage
+```bash
+# Main calculator suite
+corally
+
+# Individual tools
+corally-calc      # Basic calculator
+corally-currency  # Currency converter
+corally-gui       # Launch GUI interface
+```
+
+### Python Package Usage
+```python
+from corally import CalculatorCore, CurrencyConverter, InterestCalculator
+
+# Basic calculator
+calc = CalculatorCore()
+result = calc.add(10, 5)  # Returns 15.0
+
+# Currency conversion (static rates)
+converter = CurrencyConverter()
+usd_amount = converter.eur_to_usd(100)
+
+# Interest calculation
+interest_calc = InterestCalculator()
+interest = interest_calc.calculate_interest(
+    principal=1000,
+    rate=5.0,
+    days=30,
+    method="30/360"
+)
+```
+
+## 📁 Project Structure
+
+```
+Calculator Suite/
+├── 📱 Core Applications
+│   ├── calculator_core.py      # Unified core library
+│   ├── calculator_gui.py       # Modern GUI application
+│   ├── gui_launcher.py         # GUI launcher
+│   ├── Hauptprogramm.py        # Console menu
+│   ├── Rechner.py             # Console calculator
+│   ├── Waerungsrechner.py     # Console currency converter
+│   ├── api.py                 # Paid API server
+│   ├── api_free.py            # Free API server
+│   ├── manage_api_server.py   # API management
+│   └── requirements.txt       # Dependencies
+│
+├── 📊 data/                   # Generated data files
+│   ├── rechner_log.csv        # Calculator operation logs
+│   ├── cache.csv              # API response cache
+│   └── api.log                # Server logs
+│
+├── 📚 docs/                   # Documentation
+│   ├── README.md              # Full documentation
+│   └── QUICK_START_GUIDE.md   # Quick setup guide
+│
+├── 🧪 tests/                  # Test files
+│   ├── test_api.py
+│   ├── test_gui.py
+│   └── test_*.py
+│
+├── 🔧 debug/                  # Debug & development tools
+│   ├── debug_*.py
+│   └── fix_*.py
+│
+└── 📁 misc_files/             # Miscellaneous files
+    ├── launch_calculator.bat
+    ├── RockYourBody.py
+    └── *.pptx
+```
+
+## ✨ Features
+
+- **🧮 Basic Calculator** - Four operations with automatic logging
+- **💱 Currency Converter** - Static + live rates (150+ currencies)
+- **📈 Interest Calculator** - Multiple calculation methods
+- **🎨 Modern GUI** - Dark theme with tabbed interface
+- **🌐 Live API** - Free & paid currency conversion
+- **📊 Auto Logging** - All operations saved to CSV
+
+## 📦 Installation
+
+```bash
+pip install -r requirements.txt
+```
+
+## 🔧 Configuration
+
+For live currency conversion, create `.env` file:
+```env
+API_KEY=your_api_key_here
+```
+
+## 📖 Documentation
+
+- **Full Documentation**: `docs/README.md`
+- **Quick Start Guide**: `docs/QUICK_START_GUIDE.md`
+
+## 🧪 Testing
+
+Run tests from the tests/ directory:
+```bash
+python tests/test_gui.py
+python tests/test_api.py
+```
+
+## 🛠️ Development
+
+Debug tools are available in the debug/ directory for troubleshooting and development.
+
+---
+
+**Version**: 2.0 | **Python**: 3.8+ | **License**: Educational Use

corally-1.0.0/README.md

@@ -0,0 +1,140 @@
+# 🧮 Corally Calculator Suite
+
+[![PyPI version](https://badge.fury.io/py/corally.svg)](https://badge.fury.io/py/corally)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A comprehensive Python calculator suite with modern GUI, CLI tools, and API servers. Features live currency conversion, interest calculations, and automatic operation logging.
+
+## ✨ Features
+
+- **🧮 Basic Calculator** - Four operations with automatic CSV logging
+- **💱 Currency Converter** - Static rates + live API integration (150+ currencies)
+- **📈 Interest Calculator** - Multiple methods (30/360, act/360, act/365, act/act)
+- **🎨 Modern GUI** - Dark theme with tabbed interface
+- **🌐 Live API** - Free & paid currency APIs with caching
+- **📊 Auto Logging** - All operations saved to CSV files
+- **🖥️ Multiple Interfaces** - GUI, CLI, and API access
+
+## 🚀 Quick Start
+
+### Installation from PyPI
+```bash
+pip install corally
+```
+
+### Command Line Usage
+```bash
+# Main calculator suite
+corally
+
+# Individual tools
+corally-calc      # Basic calculator
+corally-currency  # Currency converter
+corally-gui       # Launch GUI interface
+```
+
+### Python Package Usage
+```python
+from corally import CalculatorCore, CurrencyConverter, InterestCalculator
+
+# Basic calculator
+calc = CalculatorCore()
+result = calc.add(10, 5)  # Returns 15.0
+
+# Currency conversion (static rates)
+converter = CurrencyConverter()
+usd_amount = converter.eur_to_usd(100)
+
+# Interest calculation
+interest_calc = InterestCalculator()
+interest = interest_calc.calculate_interest(
+    principal=1000,
+    rate=5.0,
+    days=30,
+    method="30/360"
+)
+```
+
+## 📁 Project Structure
+
+```
+Calculator Suite/
+├── 📱 Core Applications
+│   ├── calculator_core.py      # Unified core library
+│   ├── calculator_gui.py       # Modern GUI application
+│   ├── gui_launcher.py         # GUI launcher
+│   ├── Hauptprogramm.py        # Console menu
+│   ├── Rechner.py             # Console calculator
+│   ├── Waerungsrechner.py     # Console currency converter
+│   ├── api.py                 # Paid API server
+│   ├── api_free.py            # Free API server
+│   ├── manage_api_server.py   # API management
+│   └── requirements.txt       # Dependencies
+│
+├── 📊 data/                   # Generated data files
+│   ├── rechner_log.csv        # Calculator operation logs
+│   ├── cache.csv              # API response cache
+│   └── api.log                # Server logs
+│
+├── 📚 docs/                   # Documentation
+│   ├── README.md              # Full documentation
+│   └── QUICK_START_GUIDE.md   # Quick setup guide
+│
+├── 🧪 tests/                  # Test files
+│   ├── test_api.py
+│   ├── test_gui.py
+│   └── test_*.py
+│
+├── 🔧 debug/                  # Debug & development tools
+│   ├── debug_*.py
+│   └── fix_*.py
+│
+└── 📁 misc_files/             # Miscellaneous files
+    ├── launch_calculator.bat
+    ├── RockYourBody.py
+    └── *.pptx
+```
+
+## ✨ Features
+
+- **🧮 Basic Calculator** - Four operations with automatic logging
+- **💱 Currency Converter** - Static + live rates (150+ currencies)
+- **📈 Interest Calculator** - Multiple calculation methods
+- **🎨 Modern GUI** - Dark theme with tabbed interface
+- **🌐 Live API** - Free & paid currency conversion
+- **📊 Auto Logging** - All operations saved to CSV
+
+## 📦 Installation
+
+```bash
+pip install -r requirements.txt
+```
+
+## 🔧 Configuration
+
+For live currency conversion, create `.env` file:
+```env
+API_KEY=your_api_key_here
+```
+
+## 📖 Documentation
+
+- **Full Documentation**: `docs/README.md`
+- **Quick Start Guide**: `docs/QUICK_START_GUIDE.md`
+
+## 🧪 Testing
+
+Run tests from the tests/ directory:
+```bash
+python tests/test_gui.py
+python tests/test_api.py
+```
+
+## 🛠️ Development
+
+Debug tools are available in the debug/ directory for troubleshooting and development.
+
+---
+
+**Version**: 2.0 | **Python**: 3.8+ | **License**: Educational Use

corally-1.0.0/docs/QUICK_START_GUIDE.md

@@ -0,0 +1,124 @@
+# 🚀 Quick Start Guide - Live Currency API
+
+## Option 1: Free API (Recommended) ⭐
+
+**No API key required - works immediately!**
+
+### Steps:
+1. **Launch the GUI:**
+   ```bash
+   python gui_launcher.py
+   ```
+
+2. **Go to the "Live Currency API" tab**
+
+3. **Select "Free API (No key required)" radio button**
+
+4. **Click "Start API Server"**
+   - Wait for status to show "Running (Free API)"
+
+5. **Test the conversion:**
+   - From Currency: `EUR`
+   - To Currency: `USD`
+   - Amount: `100`
+   - Click "Convert Currency"
+
+### If the Free API doesn't start:
+Try starting it manually first:
+```bash
+uvicorn api_free:app --host 127.0.0.1 --port 8000
+```
+
+Then in another terminal, test it:
+```bash
+curl "http://127.0.0.1:8000/convert?from_currency=EUR&to_currency=USD&amount=100"
+```
+
+## Option 2: Paid API (Requires API Key)
+
+### Steps:
+1. **Get a free API key from:**
+   - https://exchangerate.host/ (Free, no registration)
+   - https://fixer.io/ (Free tier available)
+   - https://exchangeratesapi.io/ (Free tier available)
+
+2. **Create a `.env` file in your Calculator folder:**
+   ```
+   API_KEY=your_actual_api_key_here
+   ```
+
+3. **In the GUI:**
+   - Select "Paid API (Requires .env file)"
+   - Click "Start API Server"
+
+## Troubleshooting 🔧
+
+### Problem: "Failed to start server"
+**Solution:** Check if port 8000 is already in use
+```bash
+netstat -an | findstr :8000
+```
+
+If something is using port 8000, either:
+- Stop that service, or
+- Modify the port in the GUI code
+
+### Problem: "Network error" or "API request failed"
+**Solutions:**
+1. **Check internet connection**
+2. **Try the Free API mode first**
+3. **Check Windows Firewall** - make sure Python is allowed
+
+### Problem: "Missing dependencies"
+**Solution:** Install required packages
+```bash
+pip install fastapi uvicorn httpx requests dotenv
+```
+
+## Testing the API Manually 🧪
+
+### Test Free API directly:
+```bash
+python -c "
+import requests
+response = requests.get('https://api.exchangerate-api.com/v4/latest/EUR')
+print(response.json()['rates']['USD'])
+"
+```
+
+### Test Local Server:
+1. Start server: `uvicorn api_free:app --port 8000`
+2. Open browser: `http://127.0.0.1:8000`
+3. Test conversion: `http://127.0.0.1:8000/convert?from_currency=EUR&to_currency=USD&amount=100`
+
+## Success Indicators ✅
+
+When working correctly, you should see:
+- ✅ Server status: "Running (Free API)" or "Running (Paid API)"
+- ✅ Conversion results showing in the text area
+- ✅ Exchange rates and amounts displayed
+- ✅ "Cached" or "Live" status for each conversion
+
+## Example Working Output:
+```
+🌐 Live Currency Conversion:
+100.0 EUR = 108.50 USD
+Exchange Rate: 1.0850
+----------------------------------------
+```
+
+## Still Having Issues? 🆘
+
+1. **Check the terminal/console** where you started the GUI for error messages
+2. **Try the basic calculator and currency converter tabs first** - they should work perfectly
+3. **The static currency converter** (tab 2) works without any API and gives you currency conversion
+4. **Contact me** if you need help - I can help debug specific error messages
+
+## Pro Tips 💡
+
+1. **Start with Free API** - it's more reliable and doesn't need setup
+2. **The GUI saves your calculations** - check the CSV files for history
+3. **You can use both APIs** - switch between them as needed
+4. **Cache system** - repeated conversions are faster (cached for 1 hour)
+
+Your Calculator Suite is fully functional - the Live API is just an extra feature! 🎯