flutter-dev 0.1.0__py3-none-any.whl

common_utils.py

@@ -0,0 +1,261 @@
+#!/usr/bin/env python3
+"""
+Common Utilities Module
+Shared functions and constants for flutter-dev tools
+"""
+
+import os
+import re
+import time
+import platform
+import subprocess
+from functools import wraps
+from pathlib import Path
+
+# ============================================================================
+# COLOR CONSTANTS
+# ============================================================================
+
+# Colors for output
+RED = '\033[0;31m'
+GREEN = '\033[0;32m'
+YELLOW = '\033[1;33m'
+BLUE = '\033[0;34m'
+NC = '\033[0m'
+MAGENTA = '\033[0;35m'
+CHECKMARK = '\033[32m✓\033[0m'
+CROSS = '\033[31m✗\033[0m'
+
+# Disable colors on Windows CMD (unless using Windows Terminal)
+if platform.system() == "Windows" and not os.environ.get('WT_SESSION'):
+    RED = GREEN = YELLOW = BLUE = NC = MAGENTA = ''
+    CHECKMARK = '✓'
+    CROSS = '✗'
+
+# ============================================================================
+# TIMER DECORATOR
+# ============================================================================
+
+def timer_decorator(func):
+    """
+    Decorator to automatically add timer functionality to any function
+    """
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        start_time = time.time()
+
+        # Execute the original function
+        result = func(*args, **kwargs)
+
+        end_time = time.time()
+        total_seconds = end_time - start_time
+        minutes, seconds = divmod(total_seconds, 60)
+
+        print(f"\n{BLUE}======================================================{NC}")
+        print(f"{BLUE}Total time taken: {int(minutes)} minute(s) and {seconds:.2f} seconds.{NC}")
+        print(f"{BLUE}======================================================{NC}")
+
+        return result
+    return wrapper
+
+# ============================================================================
+# LOADING SPINNER
+# ============================================================================
+
+def show_loading(description, process):
+    """
+    Displays a loading spinner with a custom message while a process is running
+    Parameters:
+        description: Description message to display
+        process: Process object to monitor
+    """
+    spinner_index = 0
+    braille_spinner_list = '⡿⣟⣯⣷⣾⣽⣻⢿'
+    print(description, end='', flush=True)
+    # Continue spinning while the process is running
+    while process.poll() is None:
+        print(f"\b{MAGENTA}{braille_spinner_list[spinner_index]}{NC}", end='', flush=True)
+        spinner_index = (spinner_index + 1) % len(braille_spinner_list)
+        time.sleep(0.025)
+    stdout, stderr = process.communicate()
+    # Display success or failure icon based on the process exit status
+    if process.returncode == 0:
+        print(f"\b{CHECKMARK} ", flush=True)
+        return True
+    else:
+        print(f"\b{CROSS} ", flush=True)
+        if stdout:
+            print(f"\n{GREEN}Output:\n{stdout}{NC}")
+        if stderr:
+            print(f"\n{RED}Error Output:\n{stderr}{NC}")
+        return False
+
+# ============================================================================
+# COMMAND EXECUTION WITH SPINNER
+# ============================================================================
+
+def run_command_with_spinner(cmd_list, description):
+    """
+    Runs a command with a loading spinner
+    Parameters:
+        cmd_list: List of command arguments
+        description: Description to show with spinner
+    Returns:
+        True if successful, False otherwise
+    """
+    shell_needed = platform.system() == "Windows"
+
+    process = subprocess.Popen(
+        cmd_list,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        shell=shell_needed,
+        encoding='utf-8',  # Fix Windows encoding issue
+        errors='replace'  # Replace problematic characters instead of crashing
+    )
+    return show_loading(description, process)
+
+# ============================================================================
+# ENVIRONMENT FILE OPERATIONS
+# ============================================================================
+
+def read_env_value(key, env_file=".env"):
+    """
+    Read a value from .env file
+    Parameters:
+        key: Environment variable key to read
+        env_file: Path to .env file (default: ".env")
+    Returns:
+        Value of the key or None if not found
+    """
+    if not os.path.exists(env_file):
+        return None
+
+    with open(env_file, 'r', encoding='utf-8') as f:
+        for line in f:
+            line = line.strip()
+            if line.startswith(f"{key}="):
+                return line.split('=', 1)[1]
+    return None
+
+def update_env_value(key, value, env_file=".env"):
+    """
+    Update a value in .env file
+    Parameters:
+        key: Environment variable key to update
+        value: New value to set
+        env_file: Path to .env file (default: ".env")
+    Returns:
+        True if successful, False otherwise
+    """
+    if not os.path.exists(env_file):
+        print(f"{RED}❌ .env file not found!{NC}")
+        return False
+
+    with open(env_file, 'r', encoding='utf-8') as f:
+        content = f.read()
+
+    # Replace the value using regex
+    pattern = f"^{key}=.*$"
+    replacement = f"{key}={value}"
+    new_content = re.sub(pattern, replacement, content, flags=re.MULTILINE)
+
+    with open(env_file, 'w', encoding='utf-8') as f:
+        f.write(new_content)
+
+    return True
+
+# ============================================================================
+# PLATFORM DETECTION
+# ============================================================================
+
+def is_windows():
+    """Check if running on Windows"""
+    return platform.system() == "Windows"
+
+def is_macos():
+    """Check if running on macOS"""
+    return platform.system() == "Darwin"
+
+def is_linux():
+    """Check if running on Linux"""
+    return platform.system() == "Linux"
+
+def get_user_shell():
+    """
+    Detect user's shell (zsh, bash, fish, etc.)
+    Returns:
+        Tuple of (shell_name, config_file_path)
+    """
+    home = Path.home()
+    shell_env = os.environ.get('SHELL', '')
+
+    # Detect shell type
+    if 'zsh' in shell_env:
+        return ('zsh', home / '.zshrc')
+    elif 'bash' in shell_env:
+        # Check if .bashrc or .bash_profile exists
+        if (home / '.bashrc').exists():
+            return ('bash', home / '.bashrc')
+        else:
+            return ('bash', home / '.bash_profile')
+    elif 'fish' in shell_env:
+        return ('fish', home / '.config/fish/config.fish')
+    else:
+        # Default to bash
+        return ('bash', home / '.bashrc')
+
+# ============================================================================
+# FILE/DIRECTORY OPERATIONS
+# ============================================================================
+
+def open_file_with_default_app(file_path):
+    """
+    Open file with default application based on platform
+    Parameters:
+        file_path: Path to the file to open
+    Returns:
+        True if successful, False otherwise
+    """
+    try:
+        if is_macos():
+            subprocess.run(['open', file_path])
+        elif is_linux():
+            subprocess.run(['xdg-open', file_path])
+        elif is_windows():
+            subprocess.run(['notepad', file_path])
+        else:
+            print(f"{YELLOW}Please manually open: {file_path}{NC}")
+            return False
+        return True
+    except Exception as e:
+        print(f"{RED}Error opening file: {e}{NC}")
+        print(f"{YELLOW}Please manually open: {file_path}{NC}")
+        return False
+
+def open_directory(directory_path):
+    """
+    Opens a directory based on the operating system
+    Parameters:
+        directory_path: Path to the directory to open
+    Returns:
+        True if successful, False otherwise
+    """
+    try:
+        if is_macos():
+            subprocess.run(["open", directory_path])
+        elif is_linux():
+            subprocess.run(["xdg-open", directory_path])
+        elif is_windows():
+            # Convert to absolute path and use Windows path separators
+            abs_path = os.path.abspath(directory_path)
+            # Use explorer to open the directory
+            subprocess.run(["explorer", abs_path], shell=True)
+        else:
+            print(f"{YELLOW}Cannot open directory automatically. Please check: {directory_path}{NC}")
+            return False
+        return True
+    except Exception as e:
+        print(f"{RED}Error opening directory: {e}{NC}")
+        print(f"{YELLOW}Please check: {directory_path}{NC}")
+        return False

core/__init__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+"""
+Core module - Constants and shared state
+"""
+
+from .constants import PATTERNS, PATHS, BUILD_COMMANDS
+from .state import get_selected_device, set_selected_device, clear_selected_device

core/constants.py

@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+"""
+Constants and compiled regex patterns
+"""
+import re
+from pathlib import Path
+
+# Regex patterns (compiled once)
+PATTERNS = {
+    'package_name_kts': re.compile(r'applicationId\s*=\s*["\']([^"\']+)["\']'),
+    'package_name_groovy': re.compile(r'applicationId\s+["\']([^"\']+)["\']'),
+    'app_label': re.compile(r'android:label="([^"]+)"'),
+    'architecture': re.compile(r'(arm64-v8a|armeabi-v7a|x86|x86_64)'),
+    'version': re.compile(r'^version:\s*(.+)$', re.MULTILINE),
+    'version_with_build': re.compile(r'^version:\s*["\']?([\d\.]+)\+(\d+)["\']?', re.MULTILINE),
+    'version_line': re.compile(r'^version:\s*["\']?[\d\.]+(\+\d+)?["\']?', re.MULTILINE),
+    'ip_address': re.compile(r'inet (\d+\.\d+\.\d+\.\d+)'),
+    'foreground_app': re.compile(r'u0 ([^/\s]+)'),
+    'resumed_activity': re.compile(r'mResumedActivity.*?{.*?u0\s+(\S+?)/'),
+    'top_resumed_activity': re.compile(r'(?:top)?ResumedActivity.*?u0\s+(\S+?)/'),
+    'sanitize_special': re.compile(r'[<>:"/\\|?*]'),
+    'sanitize_non_word': re.compile(r'[^\w\s-]'),
+    'sanitize_spaces': re.compile(r'[-\s]+'),
+}
+
+# Path constants
+PATHS = {
+    'gradle_kts': Path("android/app/build.gradle.kts"),
+    'gradle': Path("android/app/build.gradle"),
+    'manifest': Path("android/app/src/main/AndroidManifest.xml"),
+    'pubspec': Path("pubspec.yaml"),
+    'info_plist': Path("ios/Runner/Info.plist"),
+    'apk_output': Path("build/app/outputs/flutter-apk"),
+    'aab_output': Path("build/app/outputs/bundle/release"),
+    'ipa_output': Path("build/ios/ipa"),
+}
+
+# Build commands
+BUILD_COMMANDS = {
+    'apk': [
+        "flutter", "build", "apk", "--release", "--obfuscate",
+        "--target-platform", "android-arm64", "--split-debug-info=./"
+    ],
+    'apk_split': [
+        "flutter", "build", "apk", "--release", "--split-per-abi",
+        "--obfuscate", "--split-debug-info=./"
+    ],
+    'aab': [
+        "flutter", "build", "appbundle", "--release",
+        "--obfuscate", "--split-debug-info=./"
+    ],
+    'ipa': [
+        "flutter", "build", "ipa", "--release",
+        "--obfuscate", "--split-debug-info=./",
+        "--export-method", "app-store"
+    ],
+}

core/state.py

@@ -0,0 +1,25 @@
+#!/usr/bin/env python3
+"""
+Shared state management for flutter-dev tools
+"""
+
+# Global variable to store selected Android device
+_SELECTED_DEVICE = None
+
+
+def get_selected_device():
+    """Get the currently selected device"""
+    global _SELECTED_DEVICE
+    return _SELECTED_DEVICE
+
+
+def set_selected_device(device):
+    """Set the selected device"""
+    global _SELECTED_DEVICE
+    _SELECTED_DEVICE = device
+
+
+def clear_selected_device():
+    """Clear the selected device"""
+    global _SELECTED_DEVICE
+    _SELECTED_DEVICE = None

create_page.py

@@ -0,0 +1,288 @@
+#!/usr/bin/env python3
+import os
+import re
+import sys
+
+
+RED = '\033[0;31m'
+GREEN = '\033[0;32m'
+YELLOW = '\033[1;33m'
+BLUE = '\033[0;34m'
+NC = '\033[0m'
+
+def get_project_name():
+    """Get the project name from pubspec.yaml using regex"""
+    if os.path.isfile("pubspec.yaml"):
+        with open("pubspec.yaml", 'r') as file:
+            try:
+                content = file.read()
+                # Use regex to find the name field in pubspec.yaml
+                name_match = re.search(r'^name:\s*(.+)$', content, re.MULTILINE)
+                if name_match:
+                    project_name = name_match.group(1).strip()
+                    # Remove quotes if present
+                    project_name = project_name.strip('"\'')
+                    return project_name
+                else:
+                    print(f"{RED}Error: Could not find 'name' field in pubspec.yaml.{NC}")
+                    exit(1)
+            except Exception as e:
+                print(f"{RED}Error: Could not read pubspec.yaml: {e}{NC}")
+                exit(1)
+    else:
+        print(f"{RED}Error: pubspec.yaml not found in the current directory.{NC}")
+        print(f"{YELLOW}Please run this command from the root of a Flutter project.{NC}")
+        exit(1)
+
+def update_service_locator(project_name, class_prefix, page_name):
+    """Update service_locator.dart with the new feature DI"""
+    service_locator_path = "lib/core/di/service_locator.dart"
+    
+    if not os.path.isfile(service_locator_path):
+        print(f"{YELLOW}Warning: Could not find service_locator.dart at {service_locator_path}.{NC}")
+        print(f"{YELLOW}Feature DI registration in service locator skipped.{NC}")
+        return
+    
+    with open(service_locator_path, 'r') as file:
+        content = file.read()
+    
+    # Add import statement
+    import_statement = f"import 'package:{project_name}/features/{page_name}/di/{page_name}_di.dart';"
+    if import_statement not in content:
+        # Find the last import statement and add after it
+        import_matches = re.findall(r'import [^;]+;', content)
+        if import_matches:
+            last_import = import_matches[-1]
+            content = content.replace(last_import, f"{last_import}\n{import_statement}")
+    
+    # Add DI setup call in setUp method
+    di_call = f"    await {class_prefix}Di.setup(_serviceLocator);"
+    
+    # Find the feature DI setup comment and add after it
+    feature_comment_pattern = r'//Feature DI setup'
+    if feature_comment_pattern in content:
+        content = re.sub(
+            r'(//Feature DI setup\s*\n)',
+            f'\\1{di_call}\n',
+            content
+        )
+    else:
+        # If comment doesn't exist, add before the closing brace of setUp method
+        setup_pattern = r'(\s+await\s+\w+\.setup\(_serviceLocator\);\s*\n)(\s*})'
+        match = re.search(setup_pattern, content)
+        if match:
+            content = re.sub(
+                setup_pattern,
+                f'\\1\n    //Feature DI setup\n{di_call}\n\\2',
+                content
+            )
+    
+    with open(service_locator_path, 'w') as file:
+        file.write(content)
+    
+    print(f"{GREEN}✓ Updated service_locator.dart with {class_prefix}Di registration.{NC}")
+    print(f"{BLUE}  Added: {NC}{di_call}")
+
+def generate_page(page_name):
+    """Generate Flutter feature structure and files"""
+    if not page_name:
+        print(f"{RED}Error: Page name is required.{NC}")
+        print(f"{BLUE}Usage: {sys.argv[0]} page <page_name>{NC}")
+        exit(1)
+    
+    project_name = get_project_name()
+    
+    # Convert page name to lowercase
+    page_name = page_name.lower()
+    
+    # Create class prefix - convert snake_case to PascalCase
+    class_prefix = ''.join(word.capitalize() for word in page_name.split('_'))
+    
+    print(f"{YELLOW}Creating feature structure for {class_prefix} in {project_name} project...{NC}\n")
+    
+    # Create folder structure
+    base_path = f"lib/features/{page_name}"
+    os.makedirs(f"{base_path}/data/datasource", exist_ok=True)
+    os.makedirs(f"{base_path}/data/models", exist_ok=True)
+    os.makedirs(f"{base_path}/data/repositories", exist_ok=True)
+    os.makedirs(f"{base_path}/domain/datasource", exist_ok=True)
+    os.makedirs(f"{base_path}/domain/repositories", exist_ok=True)
+    os.makedirs(f"{base_path}/domain/entities", exist_ok=True)
+    os.makedirs(f"{base_path}/domain/usecase", exist_ok=True)
+    os.makedirs(f"{base_path}/presentation/presenter", exist_ok=True)
+    os.makedirs(f"{base_path}/presentation/ui", exist_ok=True)
+    os.makedirs(f"{base_path}/presentation/widgets", exist_ok=True)
+    os.makedirs(f"{base_path}/di", exist_ok=True)
+    
+    # Generate Domain Repository content
+    domain_repository_content = f'''abstract class {class_prefix}Repository {{
+  
+}}
+'''
+    
+    # Generate Data Repository Implementation content
+    data_repository_content = f'''import 'package:{project_name}/features/{page_name}/domain/repositories/{page_name}_repository.dart';
+
+class {class_prefix}RepositoryImpl implements {class_prefix}Repository {{
+  
+}}
+'''
+    
+    # Generate DI file content
+    di_content = f'''import 'package:{project_name}/core/base/base_presenter.dart';
+import 'package:{project_name}/features/{page_name}/data/repositories/{page_name}_repository_impl.dart';
+import 'package:{project_name}/features/{page_name}/domain/repositories/{page_name}_repository.dart';
+import 'package:{project_name}/features/{page_name}/presentation/presenter/{page_name}_presenter.dart';
+
+import 'package:get_it/get_it.dart';
+
+class {class_prefix}Di {{
+  static Future<void> setup(GetIt serviceLocator) async {{
+    //  Data Source
+
+    //  Repository
+    serviceLocator.registerLazySingleton<{class_prefix}Repository>(
+      () => {class_prefix}RepositoryImpl(),
+    );
+
+    // Use Cases
+
+    // Presenters
+    serviceLocator.registerFactory(
+      () => loadPresenter({class_prefix}Presenter()),
+    );
+  }}
+}}
+'''
+
+    # Generate presenter content
+    presenter_content = f'''import 'dart:async';
+import 'package:{project_name}/core/base/base_presenter.dart';
+import 'package:{project_name}/core/utility/navigation_helpers.dart';
+import 'package:{project_name}/features/{page_name}/presentation/presenter/{page_name}_ui_state.dart';
+
+class {class_prefix}Presenter extends BasePresenter<{class_prefix}UiState> {{
+  final Obs<{class_prefix}UiState> uiState = Obs<{class_prefix}UiState>({class_prefix}UiState.empty());
+  {class_prefix}UiState get currentUiState => uiState.value;
+
+  @override
+  Future<void> addUserMessage(String message) async {{
+    uiState.value = currentUiState.copyWith(userMessage: message);
+    showMessage(message: currentUiState.userMessage);
+  }}
+
+  @override
+  Future<void> toggleLoading({{required bool loading}}) async {{
+    uiState.value = currentUiState.copyWith(isLoading: loading);
+  }}
+}}
+'''
+    
+    # Generate UI state content
+    ui_state_content = f'''import 'package:{project_name}/core/base/base_ui_state.dart';
+
+class {class_prefix}UiState extends BaseUiState {{
+  const {class_prefix}UiState({{required super.isLoading, required super.userMessage}});
+
+  factory {class_prefix}UiState.empty() {{
+    return {class_prefix}UiState(isLoading: false, userMessage: '');
+  }}
+
+  @override
+  List<Object?> get props => [isLoading, userMessage];
+
+  //Add more properties to the state
+
+  {class_prefix}UiState copyWith({{bool? isLoading, String? userMessage}}) {{
+    return {class_prefix}UiState(
+      isLoading: isLoading ?? this.isLoading,
+      userMessage: userMessage ?? this.userMessage,
+    );
+  }}
+}}
+'''
+    
+    # Generate page content
+    page_content = f'''import 'package:flutter/material.dart';
+
+class {class_prefix}Page extends StatelessWidget {{
+  const {class_prefix}Page({{super.key}});
+
+  @override
+  Widget build(BuildContext context) {{
+    return Scaffold(
+      appBar: AppBar(title: Text('{class_prefix}')),
+      body: Center(child: Text('{class_prefix}')),
+    );
+  }}
+}}
+'''
+    
+    # Write files
+    with open(f"{base_path}/domain/repositories/{page_name}_repository.dart", 'w') as file:
+        file.write(domain_repository_content)
+    
+    with open(f"{base_path}/data/repositories/{page_name}_repository_impl.dart", 'w') as file:
+        file.write(data_repository_content)
+    
+    with open(f"{base_path}/di/{page_name}_di.dart", 'w') as file:
+        file.write(di_content)
+    
+    with open(f"{base_path}/presentation/presenter/{page_name}_presenter.dart", 'w') as file:
+        file.write(presenter_content)
+    
+    with open(f"{base_path}/presentation/presenter/{page_name}_ui_state.dart", 'w') as file:
+        file.write(ui_state_content)
+    
+    with open(f"{base_path}/presentation/ui/{page_name}_page.dart", 'w') as file:
+        file.write(page_content)
+    
+    # Update service locator
+    update_service_locator(project_name, class_prefix, page_name)
+    
+    # Print success message
+    print(f"\n{GREEN}✓ Feature '{class_prefix}' created successfully!{NC}")
+    print(f"  {BLUE}Structure:{NC}")
+    print(f"    └── {BLUE}lib/features/{page_name}{NC}")
+    print(f"        ├── {BLUE}data{NC}")
+    print(f"        │   ├── {BLUE}datasource{NC}")
+    print(f"        │   └── {BLUE}repositories{NC}")
+    print(f"        │       └── {GREEN}{page_name}_repository_impl.dart{NC}")
+    print(f"        ├── {BLUE}domain{NC}")
+    print(f"        │   ├── {BLUE}datasource{NC}")
+    print(f"        │   ├── {BLUE}repositories{NC}")
+    print(f"        │   │   └── {GREEN}{page_name}_repository.dart{NC}")
+    print(f"        │   ├── {BLUE}entities{NC}")
+    print(f"        │   └── {BLUE}usecase{NC}")
+    print(f"        ├── {BLUE}presentation{NC}")
+    print(f"        │   ├── {BLUE}presenter{NC}")
+    print(f"        │   │   ├── {GREEN}{page_name}_presenter.dart{NC}")
+    print(f"        │   │   └── {GREEN}{page_name}_ui_state.dart{NC}")
+    print(f"        │   ├── {BLUE}ui{NC}")
+    print(f"        │   │   └── {GREEN}{page_name}_page.dart{NC}")
+    print(f"        │   └── {BLUE}widgets{NC}")
+    print(f"        └── {BLUE}di{NC}")
+    print(f"            └── {GREEN}{page_name}_di.dart{NC}")
+
+def main():
+    if len(sys.argv) < 3:
+        print(f"{RED}Error: Insufficient arguments.{NC}")
+        print(f"{BLUE}Usage: {sys.argv[0]} page <page_name>{NC}")
+        exit(1)
+
+    command = sys.argv[1].lower()
+
+    if command == "page":
+        if len(sys.argv) >= 3:
+            generate_page(sys.argv[2])
+        else:
+            print(f"{RED}Error: Page name is required.{NC}")
+            print(f"{BLUE}Usage: {sys.argv[0]} page <page_name>{NC}")
+            exit(1)
+    else:
+        print(f"{RED}Error: Unknown command '{command}'.{NC}")
+        print(f"{BLUE}Available commands: page{NC}")
+        exit(1)
+
+if __name__ == "__main__":
+    main()