Add py mode

.gitignore

@@ -2,7 +2,10 @@ node_modules
 .env
 dist
 *.log
+logs/
 /src/config/config.json
 /.vs/
 /.idea/
 /proto_samples/
+/python/scripts/temp_tools/
+__pycache__/

python/README.md

@@ -0,0 +1,263 @@
+# ProtoDecoder Python Desktop Application
+
+Complete migration of JavaScript ProtoDecoderWebUI to Python 3.10+ desktop application using Tkinter for GUI, maintaining 100% functional equivalence of `/traffic`, `/golbat`, and `/PolygonX/PostProtos` endpoints while eliminating all web-based dependencies.
+
+## Features
+
+- **Protocol Buffer Processing**: Process protobuf data using existing `protos/*` Python folder
+- **HTTP Endpoints**: Maintain identical functionality for `/traffic`, `/golbat`, and `/PolygonX/PostProtos` endpoints
+- **Desktop GUI**: Native Tkinter interface without web browser dependencies
+- **Alternating Row Colors**: Excel-style alternating row colors in data table (white/gray in light theme, dark/lighter-dark in dark theme)
+- **Configuration Management**: Desktop-based configuration with file persistence
+- **Theme Management**: Dark/light theme switching with persistence
+- **Geographic Processing**: Coordinate processing for location data (distance, area calculation)
+- **Error Recovery**: Graceful error handling with exponential backoff
+- **Performance Monitoring**: Real-time performance tracking against targets
+- **Code Documentation**: All comments and documentation translated to English for consistency
+
+## Requirements
+
+- Python 3.10+
+- Tkinter (included with Python)
+- Existing `protos/*` Python folder
+- psutil (for performance monitoring)
+
+## Installation
+
+1. Clone this repository
+2. Install dependencies:
+   ```bash
+   pip install psutil
+   ```
+3. Ensure Python 3.10+ is installed
+4. Verify Tkinter is available: `python -m tkinter`
+5. Run the application: `python python/main.py`
+
+## Configuration
+
+Configuration is managed through:
+- Desktop GUI interface (recommended)
+- Configuration files in `config/` directory
+- Default config: `config/config.json`
+- Example config: `config/example.config.json`
+
+### Configuration Options
+
+- **Server Settings**: Port, traffic light identifier, protos path
+- **GUI Settings**: Window size, resizable, center on screen
+- **Theme Settings**: Dark/light themes, auto-switching, transition duration
+- **Logging Settings**: Log level, log file location
+- **Sample Saving**: Optional data sampling with path and format
+
+## Usage
+
+1. **Start Application**: Run `python python/main.py`
+2. **GUI Interface**: Use the desktop interface for configuration and monitoring
+3. **Server Control**: Start/stop HTTP server from GUI or menu
+4. **Theme Switching**: Use theme switcher in Configuration section
+5. **HTTP Endpoints**: Send protocol buffer data to:
+   - `/traffic` - Traffic data processing
+   - `/golbat` - Golbat data processing  
+   - `/PolygonX/PostProtos` - Polygon processing with geographic coordinates
+
+## GUI Features
+
+### Data Table
+- **Alternating Row Colors**: Excel-style row coloring for better readability
+  - Light theme: White rows (#ffffff) and gray rows (#e8e8e8)
+  - Dark theme: Dark rows (#1a1a1a) and lighter rows (#2d2d2d)
+- **Auto-Refresh**: Colors automatically refresh when data is added, deleted, or when themes change
+- **Double-Click**: View detailed JSON data in popup window
+
+### Theme Management
+- **Light Theme**: Clean, bright interface with high contrast
+- **Dark Theme**: Easy on the eyes for low-light environments
+- **Instant Switching**: Change themes without application restart
+- **Persistent Settings**: Theme preference saved across sessions
+
+### Data Filtering
+- **Instance Filtering**: Filter by specific instances
+- **Method Filtering**: Blacklist or whitelist specific method IDs
+- **Real-time Updates**: Filters apply immediately to new and existing data
+
+## API Endpoints
+
+### /traffic (POST)
+Process traffic protocol buffer data
+```json
+{
+  "protos": [
+    {
+      "method": 101,
+      "request": "base64_encoded_protobuf",
+      "response": "base64_encoded_protobuf"
+    }
+  ]
+}
+```
+
+### /golbat (POST)
+Process golbat protocol buffer data
+```json
+{
+  "data": "flexible_golbat_data_structure"
+}
+```
+
+### /PolygonX/PostProtos (POST)
+Process polygon protocol buffer data with geographic calculations
+```json
+{
+  "polygon_data": {
+    "coordinates": [
+      {"latitude": 37.7749, "longitude": -122.4194},
+      {"latitude": 37.7849, "longitude": -122.4094}
+    ]
+  }
+}
+```
+
+## Project Structure
+
+```
+python/
+├── main.py              # Application entry point
+├── config/              # Configuration management
+│   ├── manager.py       # Configuration loading/saving
+│   └── validator.py     # Configuration validation
+├── gui/                 # Tkinter desktop interface
+│   ├── main_window.py   # Main application window
+│   ├── config_dialog.py # Configuration settings dialog
+│   ├── theme_manager.py # Theme management
+│   ├── theme_config.py  # Theme configuration
+│   ├── theme_switcher.py # Theme switcher widget
+│   └── error_dialogs.py # Error handling dialogs
+├── server/              # HTTP endpoint handling
+│   ├── http_handler.py  # HTTP server setup and routing
+│   └── endpoints.py     # /traffic, /golbat, and /PolygonX/PostProtos endpoint logic
+├── proto_processor/     # Protocol buffer processing
+│   ├── decoder.py       # Protobuf decoding logic
+│   ├── traffic_handler.py # Traffic-specific processing
+│   ├── parser.py        # Payload parsing functions
+│   └── polygon.py       # Geographic coordinate processing
+├── utils/               # Shared utilities
+│   ├── logger.py        # Logging configuration
+│   ├── error_recovery.py # Error recovery with exponential backoff
+│   ├── performance_monitor.py # Performance monitoring
+│   └── integration_test.py # Integration testing
+└── constants/           # Generated constants
+
+config/                  # Configuration files
+logs/                    # Application logs
+scripts/                 # Utility scripts
+protos/                  # Existing protobuf definitions
+```
+
+## Performance Targets
+
+- **Response Time**: <100ms average
+- **Memory Usage**: <50MB average
+- **CPU Utilization**: <10% average
+
+## Testing
+
+### Integration Testing
+Run integration tests to verify all components:
+```bash
+python python/utils/integration_test.py
+```
+
+### Performance Testing
+Monitor performance through the GUI or programmatically:
+```python
+from python.utils.performance_monitor import PerformanceMonitor
+
+monitor = PerformanceMonitor()
+monitor.start_monitoring()
+# ... run application ...
+summary = monitor.get_performance_summary()
+```
+
+## Error Recovery
+
+The application implements comprehensive error recovery:
+- **Exponential Backoff**: Automatic retry with increasing delays
+- **Graceful Degradation**: Continue operation with reduced functionality
+- **Error Categorization**: Different recovery strategies for different error types
+- **User Notifications**: Clear error messages and recovery status
+
+## Theme Management
+
+### Available Themes
+- **Light Theme**: Clean, bright interface
+- **Dark Theme**: Easy on the eyes for low-light environments
+
+### Theme Features
+- **Dynamic Switching**: Change themes without restart
+- **Auto-Switching**: Optional automatic theme based on system preference
+- **Persistence**: Theme preference saved across restarts
+- **Custom Colors**: Support for custom color schemes
+
+## Code Improvements
+
+### Comment Translation
+All code comments and documentation have been translated to English for consistency:
+- **French Comments**: Translated Portuguese/French comments to English
+- **Documentation**: Updated all docstrings and inline comments
+- **Consistency**: Unified language across all Python files
+- **Maintainability**: Improved code readability for international developers
+
+### Alternating Row Colors Implementation
+- **Dynamic Color Assignment**: Rows automatically get alternating colors based on position
+- **Theme-Aware**: Colors adapt to light/dark theme changes
+- **Persistent**: Colors maintained during table updates, deletions, and theme switches
+- **Excel-Style**: Classic alternating pattern (row 0: white, row 1: gray, row 2: white, etc.)
+
+### Performance Optimizations
+- **Efficient Color Refresh**: Only refresh colors when necessary (after data changes)
+- **Minimal Overhead**: Color assignment has negligible performance impact
+- **Scalable**: Works efficiently with large datasets (1000+ rows)
+
+## Migration Notes
+
+This application maintains 100% functional equivalence with the JavaScript version:
+- All HTTP endpoints preserve identical behavior
+- Configuration files remain compatible
+- Protocol buffer processing is unchanged
+- Visual layout and themes are preserved
+- Error handling follows the same patterns
+
+## Development
+
+This project uses only Python standard library modules plus psutil for system monitoring:
+- No web framework dependencies
+- Zero external dependencies except psutil
+- Clean separation from JavaScript code
+- Constants generation from JavaScript source
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Server Won't Start**
+   - Check if port is available
+   - Verify protos directory exists
+   - Check configuration file validity
+
+2. **Theme Not Applying**
+   - Restart application after theme change
+   - Check configuration file permissions
+   - Verify theme configuration format
+
+3. **Performance Issues**
+   - Monitor performance metrics in GUI
+   - Check system resource usage
+   - Reduce concurrent requests if needed
+
+### Logs
+
+Application logs are stored in `logs/app.log` by default. Check logs for detailed error information.
+
+## License
+
+[Add your license information here]

python/config/__init__.py

@@ -0,0 +1,3 @@
+"""
+Config module - exact replica of JavaScript config structure
+"""

python/config/config.json

@@ -0,0 +1,27 @@
+{
+  "default_port": 8081,
+  "default_host": "0.0.0.0",
+  "trafficlight_identifier": "default",
+  "sample_saving": null,
+  "log_level": "INFO",
+  "log_file": "logs/app.log",
+  "gui_settings": {
+    "window_width": 800,
+    "window_height": 600,
+    "resizable": true,
+    "center_on_screen": true
+  },
+  "theme_settings": {
+    "current_theme": "light",
+    "auto_switch": false,
+    "transition_duration": 300
+  },
+  "filters": {
+    "enabled": true,
+    "mode": "blacklist",
+    "instances": [],
+    "methods": [],
+    "selected_instance": "",
+    "method_ids": ""
+  }
+}

python/config/example.config.json

@@ -0,0 +1,23 @@
+{
+  "default_port": 8081,
+  "default_host": "0.0.0.0",
+  "trafficlight_identifier": "example",
+  "sample_saving": {
+    "enabled": true,
+    "path": "samples/",
+    "format": "json"
+  },
+  "log_level": "DEBUG",
+  "log_file": "logs/app.log",
+  "gui_settings": {
+    "window_width": 1024,
+    "window_height": 768,
+    "resizable": true,
+    "center_on_screen": true
+  },
+  "theme_settings": {
+    "current_theme": "dark",
+    "auto_switch": true,
+    "transition_duration": 200
+  }
+}