flutter-dev 0.1.0__tar.gz

flutter_dev-0.1.0/.env.example

@@ -0,0 +1,26 @@
+# AI API Keys Configuration
+# সব API keys এখানে secure ভাবে রাখুন
+# এই file টি .gitignore এ add করতে হবে
+
+# Groq API (Current - Active)
+GROQ_API_KEY=your_groq_api_key_here
+GROQ_API_URL=https://api.groq.com/openai/v1/chat/completions
+GROQ_MODEL=llama-3.3-70b-versatile
+
+# Mistral AI API
+MISTRAL_API_KEY=your_mistral_api_key_here
+MISTRAL_API_URL=https://api.mistral.ai/v1/chat/completions
+MISTRAL_MODEL=mistral-medium
+
+# SambaNova API
+SAMBANOVA_API_KEY=your_sambanova_api_key_here
+SAMBANOVA_API_URL=https://api.sambanova.ai/v1/chat/completions
+SAMBANOVA_MODEL=Meta-Llama-3.3-70B-Instruct
+
+# OpenRouter API
+OPENROUTER_API_KEY=your_openrouter_api_key_here
+OPENROUTER_API_URL=https://openrouter.ai/api/v1/chat/completions
+OPENROUTER_MODEL=openai/gpt-3.5-turbo
+
+# Default AI Service (groq, mistral, sambanova, openrouter)
+DEFAULT_AI_SERVICE=groq

flutter_dev-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maxcode
+
+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.

flutter_dev-0.1.0/MANIFEST.in

@@ -0,0 +1,14 @@
+include README.md
+include LICENSE
+include requirements.txt
+include .env.example
+include install_legacy.py
+recursive-include core *.py
+recursive-include managers *.py
+global-exclude __pycache__/*
+global-exclude *.py[cod]
+global-exclude .DS_Store
+exclude .env
+exclude dist/*
+exclude build/*
+exclude *.egg-info/*

flutter_dev-0.1.0/PKG-INFO

@@ -0,0 +1,411 @@
+Metadata-Version: 2.4
+Name: flutter-dev
+Version: 0.1.0
+Summary: A cross-platform CLI toolkit for Flutter development workflows.
+Author: Maxcode
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/royalcourtbd/flutter-development-tools
+Project-URL: Repository, https://github.com/royalcourtbd/flutter-development-tools
+Project-URL: Issues, https://github.com/royalcourtbd/flutter-development-tools/issues
+Keywords: flutter,cli,developer-tools,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# Flutter Development Tools 🚀
+
+Advanced Flutter development utilities with **AI-powered commit messages** that work on **macOS**, **Linux**, and **Windows**.
+
+## 💫 Prerequisites
+
+- **Python 3.8+** installed and available in PATH
+- **Flutter SDK** installed and configured
+- **Git** installed and configured
+- **Internet connection** (for AI features)
+- **AI provider API access** (Groq, Mistral, SambaNova, or OpenRouter for AI commit messages)
+
+## 🚀 Quick Setup
+
+### Install from PyPI
+
+> Public PyPI packaging is the target distribution path. Until a release is published, use the local repository setup below.
+
+```bash
+python -m pip install flutter-dev
+```
+
+After installation, verify the command is available:
+
+```bash
+fdev doctor
+```
+
+### Install from source
+
+### 1. Download/Clone this repository
+
+```bash
+git clone <repository-url>
+cd flutter-tools
+```
+
+### 2. Install locally
+
+For package-style local installation:
+
+```bash
+python -m pip install .
+```
+
+For the legacy global script installer:
+
+```bash
+python3 install_legacy.py    # macOS/Linux
+python install_legacy.py     # Windows
+```
+
+### 3. Follow the instructions
+
+The legacy setup script will:
+
+- Create necessary directories
+- Install scripts globally
+- Set up PATH (with instructions)
+
+## 📦 Packaging for PyPI
+
+This project is being migrated toward a public PyPI package. Packaging metadata should stay declarative and safe for public distribution:
+
+- Keep package metadata, README content, and license files free of API keys, tokens, passwords, `.env` contents, private repository URLs, and machine-specific paths.
+- Use `.env.example` only for placeholder values such as `your_api_key_here`.
+- Prefer PyPI Trusted Publishing for release automation. If a token is required locally, pass it through an environment variable and never write the token into docs, config files, commit messages, or terminal transcripts.
+- Build release artifacts from a clean checkout and inspect the generated source distribution before upload.
+
+Recommended local release checks:
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+When the package metadata is ready and the release has been reviewed, publish with one of these approaches:
+
+```bash
+# Recommended for CI configured with PyPI Trusted Publishing:
+python -m twine upload dist/*
+
+# Local token-based publish, only if needed:
+TWINE_USERNAME=__token__ TWINE_PASSWORD="$PYPI_API_TOKEN" python -m twine upload dist/*
+```
+
+Do not paste the value of `PYPI_API_TOKEN` or any AI provider API key into documentation or issue/PR text.
+
+## 💡 Quick Usage Examples
+
+```bash
+# AI-powered commit
+fdev commit                     # Generate smart commit message with AI
+
+# Build and deploy
+fdev apk                        # Build release APK
+fdev release-run                # Build and install on device
+
+# Project maintenance
+fdev setup                      # Full project setup
+fdev cleanup                    # Clean and refresh dependencies
+
+# Page generation
+fdev page login                 # Create login page structure
+
+# Version management
+fdev tag                        # Create git tag from pubspec version
+```
+
+## 📱 Available Commands
+
+### Build Commands
+
+```bash
+fdev apk                     # Build release APK (Full Process)
+fdev apk-split               # Build APK with --split-per-abi
+fdev aab                     # Build release AAB
+fdev release-run             # Build & install APK on device
+```
+
+### Development Commands
+
+```bash
+fdev setup                   # Full project setup
+fdev cleanup                 # Clean project and get dependencies
+fdev db                      # Run build_runner
+fdev lang                    # Generate localization files
+fdev cache-repair            # Repair pub cache
+```
+
+### iOS Commands
+
+```bash
+fdev pod                     # Update iOS pods (macOS only)
+```
+
+### Git Commands 🤖
+
+```bash
+fdev tag                     # Create and push git tag from pubspec version
+fdev commit                  # Smart git commit with AI-generated message
+```
+
+### Project Generation
+
+```bash
+fdev page user_profile              # Via fdev command
+create-page page user_profile       # Direct command
+```
+
+### Device Commands
+
+```bash
+fdev uninstall               # Uninstall app from connected device
+fdev clear-data              # Clear data of currently running foreground app (Android/iOS)
+fdev mirror                  # Launch scrcpy screen mirror
+fdev mirror --wireless       # Setup wireless ADB connection first
+fdev mirror --no-top         # Launch mirror without always-on-top window
+```
+
+#### 🆕 Clear App Data Feature
+
+Automatically clears data of the currently running foreground app without manual package name input!
+
+**Features:**
+
+- ✅ Automatic package name detection (no manual input needed)
+- ✅ Android full support (works on all OS: macOS, Linux, Windows)
+- ✅ iOS partial support (manual options provided)
+- ✅ Safety confirmation before clearing
+- ✅ Clears all app data: cache, database, settings, files
+
+**Quick Usage:**
+
+```bash
+# 1. Open the app you want to clear data for on your device
+# 2. Run the command
+fdev clear-data
+
+# It will detect the app and ask for confirmation
+```
+
+**Platform Support:**
+
+- **Android**: Full automatic support - detects foreground app and clears data with `pm clear`
+- **iOS**: Provides manual instructions (iOS doesn't support direct data clearing)
+
+📖 **Detailed Documentation:**
+
+- English: See `CLEAR_DATA_FEATURE.md`
+- বাংলা: See `CLEAR_DATA_BANGLA.md`
+
+### 📱 Screen Mirroring (scrcpy)
+
+`fdev mirror` command দিয়ে আপনার Android device screen mirror করতে পারবেন।
+
+**Installation:**
+
+scrcpy install করার দুইটি উপায়:
+
+**Option 1: Homebrew দিয়ে (Recommended)**
+
+```bash
+brew install scrcpy
+```
+
+**Option 2: Manual Download থেকে PATH এ add করুন**
+
+যদি scrcpy already download করা থাকে (যেমন `/Users/sayed/Documents/scrcpy-macos-x86_64-v3.3`), তাহলে এটা PATH এ add করুন:
+
+```bash
+# .zshrc file এ scrcpy path add করুন
+echo 'export PATH="/Users/sayed/Documents/scrcpy-macos-x86_64-v3.3:$PATH"' >> ~/.zshrc
+
+# তারপর reload করুন
+source ~/.zshrc
+```
+
+**Usage:**
+
+```bash
+# Wired connection দিয়ে mirror করুন
+fdev mirror
+
+# Wireless ADB setup করে তারপর mirror করুন
+fdev mirror --wireless
+
+# Always-on-top ছাড়া mirror করুন (normal window)
+fdev mirror --no-top
+```
+
+**Features:**
+
+- ✅ Automatic device detection
+- ✅ Optimized settings for performance
+- ✅ Wireless ADB support
+- ✅ Multiple device selection
+
+## 🤖 AI Features
+
+### Smart Commit Messages
+
+The `fdev commit` command uses **Google Gemini AI** to generate professional commit messages:
+
+```bash
+fdev commit
+```
+
+**Features:**
+
+- 🎯 **Conventional Commits**: Follows Angular format (`feat:`, `fix:`, `docs:`, etc.)
+- 📝 **Automatic Analysis**: Analyzes your git diff to understand changes
+- 🎨 **Smart Formatting**: Adds bullet points to description lines
+- ✅ **Review & Confirm**: Shows generated message before committing
+- 🔄 **Auto-staging**: Stages unstaged changes if needed
+
+**Example Output:**
+
+```
+Generated commit message:
+feat(auth): implement user login with validation 🔐
+
+- Added email and password input fields with real-time validation
+- Integrated Firebase Authentication for secure user login
+- Added loading states and error handling for better UX
+- Implemented remember me functionality with secure storage
+
+Proceed with this commit? (y/N):
+```
+
+## 🔧 Platform-Specific Notes
+
+### Windows
+
+- Commands available as: `fdev.bat`, `create-page.bat`
+- Uses batch wrappers for cross-platform compatibility
+- Add `%USERPROFILE%\bin` to your PATH
+
+### macOS/Linux
+
+- Commands available as: `fdev`, `create-page`
+- Uses symlinks for better performance
+- Add `$HOME/bin` to your PATH
+
+## 📁 File Structure
+
+```
+~/scripts/flutter-tools/
+├── fdev.py                # Main utility script with AI features
+├── create_page.py          # Page generator script
+├── gemini_api.py          # Google Gemini AI integration
+├── git_diff_output_editor.py # Git diff processing utilities
+├── setup.py               # Cross-platform setup
+└── README.md              # This file
+
+~/bin/                     # Global commands
+├── fdev[.bat]             # Main command
+└── create-page[.bat]      # Page generator
+```
+
+## 🔄 Updates
+
+To update the tools:
+
+1. **Edit the master files:**
+   - `~/scripts/flutter-tools/fdev.py`
+   - `~/scripts/flutter-tools/create_page.py`
+   - `~/scripts/flutter-tools/gemini_api.py`
+
+2. **Changes are automatically available globally!**
+
+### AI Configuration
+
+The AI features use provider API keys loaded from environment configuration. Keep real keys in your local `.env` or shell environment only, and keep committed examples limited to placeholders.
+
+## 🐛 Troubleshooting
+
+### Command not found
+
+- **Windows**: Make sure `%USERPROFILE%\bin` is in your PATH
+- **macOS/Linux**: Make sure `$HOME/bin` is in your PATH
+- Restart your terminal after PATH changes
+
+### Permission denied (macOS/Linux)
+
+```bash
+chmod +x ~/scripts/flutter-tools/*.py
+chmod +x ~/bin/fdev ~/bin/create-page
+```
+
+### Python not found
+
+Make sure Python 3 is installed and available in your PATH.
+
+### Flutter project not detected
+
+Make sure you're running commands from the root of a Flutter project (where `pubspec.yaml` exists).
+
+### AI commit message generation fails
+
+- Check your internet connection
+- Verify the selected AI provider API key in your local `.env` or shell environment
+- Make sure you have git changes to analyze
+- Try running `python3 gemini_api.py` to test the API connection
+
+## 🎯 Features
+
+### Core Features
+
+- ✅ **Cross-platform** - Works on macOS, Linux, Windows
+- ✅ **Global access** - Use from any Flutter project directory
+- ✅ **Auto-updates** - Edit once, use everywhere
+- ✅ **Clean architecture** - Separate concerns, maintainable
+- ✅ **Flutter project detection** - Prevents running in wrong directories
+- ✅ **Time tracking** - Shows how long operations take
+- ✅ **Color output** - Easy to read terminal output
+- ✅ **Error handling** - Graceful error messages and recovery
+
+### AI-Powered Features 🤖
+
+- 🎯 **Smart Commits** - AI-generated commit messages using Google Gemini
+- 📝 **Conventional Format** - Follows industry-standard commit conventions
+- 🔍 **Code Analysis** - Automatically analyzes git diffs to understand changes
+- ✨ **Professional Output** - Clean, formatted commit messages with bullet points
+- 🔄 **Interactive Workflow** - Review and confirm before committing
+
+### Development Utilities
+
+- 📦 **Build Management** - APK, AAB, split builds
+- 📱 **Device Management** - Install, uninstall, release builds
+- 🌍 **Localization** - Generate language files
+- 🗺 **Page Generation** - Create Flutter page structures
+- 🧹 **Project Maintenance** - Cleanup, cache repair, dependency management
+- 🏷 **Version Control** - Git tagging from pubspec version
+
+## 📝 License
+
+MIT License. See [LICENSE](LICENSE).