reverse-diagrams 1.3.4__py3-none-any.whl → 2.0.0__py3-none-any.whl

src/reports/save_results.py

@@ -1,26 +1,221 @@
-"""Save results."""
+"""Save results with enhanced error handling and validation."""
 import json
 import logging
 from pathlib import Path
+from typing import Any, Union, Optional
+import os
 
-from colorama import Fore
+from ..config import get_config
+from ..utils.progress import get_progress_tracker
 
+logger = logging.getLogger(__name__)
 
-def save_results(results, filename, directory_path="."):
+
+def save_results(
+    results: Any, 
+    filename: str, 
+    directory_path: Union[str, Path] = ".",
+    indent: Optional[int] = None,
+    validate_json: bool = True
+) -> bool:
     """
-    Save results to a file.
+    Save results to a JSON file with proper error handling.
 
-    :param directory_path:
-    :param results:
-    :param filename:
+    Args:
+        results: Data to save
+        filename: Output filename
+        directory_path: Directory to save the file
+        indent: JSON indentation (uses config default if None)
+        validate_json: Whether to validate JSON before saving
 
-    :return: None. Saves results to a file.
+    Returns:
+        True if successful, False otherwise
     """
-    if not Path.exists(Path(directory_path)):
-        Path.mkdir(Path(directory_path))
-        logging.debug(f"Directory {directory_path} created")
-    with open(f"{directory_path}/{filename}", "w") as f:
-        json.dump(results, fp=f, indent=4)
-        print(
-            f"{Fore.YELLOW}ℹ️  The accounts are stored in {directory_path}/{filename} {Fore.RESET}"
+    config = get_config()
+    progress = get_progress_tracker()
+    
+    if indent is None:
+        indent = config.output.json_indent
+    
+    try:
+        # Ensure directory exists
+        directory = Path(directory_path)
+        if config.output.create_directories:
+            directory.mkdir(parents=True, exist_ok=True)
+        
+        # Validate directory is writable
+        if not directory.exists():
+            raise FileNotFoundError(f"Directory {directory} does not exist")
+        
+        if not os.access(directory, os.W_OK):
+            raise PermissionError(f"No write permission for directory {directory}")
+        
+        # Prepare file path
+        file_path = directory / filename
+        
+        # Validate JSON serialization if requested
+        if validate_json:
+            try:
+                json.dumps(results, indent=indent, default=str)
+            except (TypeError, ValueError) as e:
+                raise ValueError(f"Data is not JSON serializable: {e}")
+        
+        # Write file
+        with file_path.open('w', encoding='utf-8') as f:
+            json.dump(results, f, indent=indent, default=str, ensure_ascii=False)
+        
+        # Set file permissions
+        try:
+            os.chmod(file_path, config.output.file_permissions)
+        except OSError as e:
+            logger.warning(f"Could not set file permissions for {file_path}: {e}")
+        
+        # Log success
+        file_size = file_path.stat().st_size
+        logger.debug(f"Saved {filename} ({file_size} bytes) to {directory}")
+        
+        progress.show_success(
+            f"💾 Data saved successfully",
+            f"File: {file_path}\nSize: {file_size:,} bytes"
+        )
+        
+        return True
+        
+    except Exception as e:
+        logger.error(f"Failed to save {filename}: {e}")
+        progress.show_error(
+            f"Failed to save {filename}",
+            f"Error: {e}\nDirectory: {directory_path}"
         )
+        return False
+
+
+def load_results(
+    filename: str, 
+    directory_path: Union[str, Path] = ".",
+    validate_exists: bool = True
+) -> Optional[Any]:
+    """
+    Load results from a JSON file with error handling.
+
+    Args:
+        filename: Input filename
+        directory_path: Directory containing the file
+        validate_exists: Whether to validate file exists
+
+    Returns:
+        Loaded data or None if failed
+    """
+    progress = get_progress_tracker()
+    
+    try:
+        file_path = Path(directory_path) / filename
+        
+        if validate_exists and not file_path.exists():
+            raise FileNotFoundError(f"File {file_path} does not exist")
+        
+        if not os.access(file_path, os.R_OK):
+            raise PermissionError(f"No read permission for file {file_path}")
+        
+        with file_path.open('r', encoding='utf-8') as f:
+            data = json.load(f)
+        
+        file_size = file_path.stat().st_size
+        logger.info(f"Loaded {filename} ({file_size} bytes) from {directory_path}")
+        
+        return data
+        
+    except Exception as e:
+        logger.error(f"Failed to load {filename}: {e}")
+        progress.show_error(
+            f"Failed to load {filename}",
+            f"Error: {e}\nPath: {Path(directory_path) / filename}"
+        )
+        return None
+
+
+def backup_file(file_path: Union[str, Path], max_backups: int = 5) -> bool:
+    """
+    Create a backup of an existing file.
+
+    Args:
+        file_path: Path to file to backup
+        max_backups: Maximum number of backups to keep
+
+    Returns:
+        True if backup created successfully, False otherwise
+    """
+    try:
+        file_path = Path(file_path)
+        
+        if not file_path.exists():
+            return True  # No file to backup
+        
+        # Create backup filename
+        backup_path = file_path.with_suffix(f"{file_path.suffix}.backup")
+        
+        # If backup already exists, rotate backups
+        if backup_path.exists():
+            for i in range(max_backups - 1, 0, -1):
+                old_backup = file_path.with_suffix(f"{file_path.suffix}.backup.{i}")
+                new_backup = file_path.with_suffix(f"{file_path.suffix}.backup.{i + 1}")
+                
+                if old_backup.exists():
+                    if new_backup.exists():
+                        new_backup.unlink()
+                    old_backup.rename(new_backup)
+            
+            # Move current backup to .backup.1
+            backup_1 = file_path.with_suffix(f"{file_path.suffix}.backup.1")
+            if backup_1.exists():
+                backup_1.unlink()
+            backup_path.rename(backup_1)
+        
+        # Create new backup
+        import shutil
+        shutil.copy2(file_path, backup_path)
+        
+        logger.debug(f"Created backup: {backup_path}")
+        return True
+        
+    except Exception as e:
+        logger.warning(f"Failed to create backup for {file_path}: {e}")
+        return False
+
+
+def ensure_directory_structure(base_path: Union[str, Path]) -> bool:
+    """
+    Ensure the standard directory structure exists.
+
+    Args:
+        base_path: Base directory path
+
+    Returns:
+        True if structure created successfully, False otherwise
+    """
+    try:
+        base_path = Path(base_path)
+        
+        # Standard directories
+        directories = [
+            base_path,
+            base_path / "json",
+            base_path / "code",
+            base_path / "images"
+        ]
+        
+        for directory in directories:
+            directory.mkdir(parents=True, exist_ok=True)
+            
+            # Set permissions
+            try:
+                os.chmod(directory, 0o755)
+            except OSError:
+                pass
+        
+        logger.info(f"Directory structure ensured at {base_path}")
+        return True
+        
+    except Exception as e:
+        logger.error(f"Failed to create directory structure at {base_path}: {e}")
+        return False

src/reverse_diagrams.py

@@ -1,23 +1,95 @@
 """Create graphs."""
 import argparse
 import logging
+import sys
+from pathlib import Path
 
 import argcomplete
-from boto3 import setup_default_session
+from colorama import Fore
 
 from .aws.describe_identity_store import graph_identity_center
 from .aws.describe_organization import graph_organizations
+from .aws.exceptions import AWSError, AWSCredentialsError, AWSPermissionError
 from .banner.banner import get_version
+from .config import get_config, Config
 from .reports.console_view import watch_on_demand
 from .version import __version__
+from .utils.progress import get_progress_tracker
+
+
+def validate_arguments(args) -> None:
+    """
+    Validate command line arguments.
+    
+    Args:
+        args: Parsed command line arguments
+        
+    Raises:
+        ValueError: If arguments are invalid
+    """
+    # Validate region format
+    if args.region and not args.region.replace('-', '').replace('_', '').isalnum():
+        raise ValueError(f"Invalid AWS region format: {args.region}")
+    
+    # Validate output directory path
+    if args.output_dir_path:
+        try:
+            Path(args.output_dir_path).resolve()
+        except Exception as e:
+            raise ValueError(f"Invalid output directory path: {e}")
+    
+    # Ensure at least one operation is selected
+    if not any([args.graph_organization, args.graph_identity, args.commands == "watch", args.list_plugins, args.plugins]):
+        if not args.version:
+            raise ValueError("Please specify at least one operation: -o, -i, or watch command")
+
+
+def setup_logging_from_args(args, config: Config) -> None:
+    """Setup logging based on command line arguments and configuration."""
+    if args.debug:
+        config.logging.level = "DEBUG"
+        config.setup_logging()
+        logging.info("Debug mode enabled")
+    else:
+        config.setup_logging()
+
+
+def handle_aws_errors(func):
+    """Decorator to handle AWS-specific errors gracefully."""
+    def wrapper(*args, **kwargs):
+        try:
+            return func(*args, **kwargs)
+        except AWSCredentialsError as e:
+            logging.error(f"{Fore.RED}❌ AWS Credentials Error: {e}{Fore.RESET}")
+            logging.error(f"{Fore.YELLOW}💡 Please check your AWS credentials and try again.{Fore.RESET}")
+            sys.exit(1)
+        except AWSPermissionError as e:
+            logging.error(f"{Fore.RED}❌ AWS Permission Error: {e}{Fore.RESET}")
+            logging.error(f"{Fore.YELLOW}💡 Please check your AWS permissions and try again.{Fore.RESET}")
+            sys.exit(1)
+        except AWSError as e:
+            logging.error(f"{Fore.RED}❌ AWS Error: {e}{Fore.RESET}")
+            sys.exit(1)
+        except Exception as e:
+            logging.error(f"{Fore.RED}❌ Unexpected error: {e}{Fore.RESET}")
+            if logging.getLogger().isEnabledFor(logging.DEBUG):
+                logging.exception("Full traceback:")
+            sys.exit(1)
+    return wrapper
+
+
+@handle_aws_errors
 
 
 def main() -> int:
     """
-    Crete architecture diagram from your current state.
+    Create architecture diagram from your current state.
 
-    :return:
+    :return: Exit code
     """
+    # Load configuration
+    config = get_config()
+    
     # Initialize parser
     parser = argparse.ArgumentParser(
         prog="reverse_diagrams",
@@ -32,7 +104,7 @@ def main() -> int:
         "-od",
         "--output_dir_path",
         help="Name of folder to save the diagrams python code files",
-        default="diagrams",
+        default=config.output.default_output_dir,
     )
     parser.add_argument("-r", "--region", help="AWS region", default="us-east-1")
     parser.add_argument(
@@ -54,6 +126,24 @@ def main() -> int:
         action="store_true",
         default=True,
     )
+    parser.add_argument(
+        "--plugin",
+        help="Use specific plugin for diagram generation (e.g., ec2, rds)",
+        action="append",
+        dest="plugins"
+    )
+    parser.add_argument(
+        "--list-plugins",
+        help="List available plugins",
+        action="store_true"
+    )
+    parser.add_argument(
+        "--concurrent",
+        help="Enable concurrent processing for better performance",
+        action="store_true",
+        default=True
+    )
+    
     # Create subparsers
     subparsers = parser.add_subparsers(
         dest="commands",
@@ -61,14 +151,16 @@ def main() -> int:
         help="%(prog)s Commands",
         description="Command and functionalities",
     )
-    # Create init subcommand options
+    
+    # Create watch subcommand options
     watch_parser = subparsers.add_parser(
         name="watch",
         description="Create view of diagrams in console based on kind of diagram and json file.",
         help="Create pretty console view: \n"
         "For example: %(prog)s watch -wi diagrams/json/account_assignments.json ",
     )
-    # Add idp options
+    
+    # Add watch options
     watch_group = watch_parser.add_argument_group(
         "Create view of diagrams in console based on kind of diagram and json file."
     )
@@ -94,41 +186,242 @@ def main() -> int:
     parser.add_argument("-v", "--version", help="Show version", action="store_true")
     parser.add_argument("-d", "--debug", help="Debug Mode", action="store_true")
 
-    # Read arguments from command line
-    args = parser.parse_args()
     # Add autocomplete
     argcomplete.autocomplete(parser)
-    logging.info(f"The arguments are {args}")
-    if args.debug:
-        logging.basicConfig(level=logging.DEBUG)
-
-    diagrams_path = args.output_dir_path
-
-    region = args.region
-
-    if args.profile:
-        profile = args.profile
-        if profile is not None:
-            setup_default_session(profile_name=profile)
-
-        logging.info(f"Profile is: {profile}")
-
-    if args.graph_organization:
-        graph_organizations(
-            diagrams_path=diagrams_path, region=region, auto=args.auto_create
-        )
-
-    if args.graph_identity:
-        graph_identity_center(
-            diagrams_path=diagrams_path, region=region, auto=args.auto_create
-        )
-    if args.commands == "watch":
-        watch_on_demand(args=args)
-
-    if args.version:
-        get_version(version=__version__)
+    
+    # Read arguments from command line
+    args = parser.parse_args()
+    
+    try:
+        # Validate arguments
+        validate_arguments(args)
+        
+        # Setup logging
+        setup_logging_from_args(args, config)
+        
+        logging.debug(f"Starting reverse_diagrams with arguments: {vars(args)}")
+        
+        # Handle list plugins request
+        if args.list_plugins:
+            from .plugins.registry import get_plugin_manager
+            manager = get_plugin_manager()
+            plugins = manager.list_available_plugins()
+            
+            progress = get_progress_tracker()
+            if plugins:
+                progress.show_summary(
+                    "Available Plugins",
+                    [f"{p.name} v{p.version} - {p.description}" for p in plugins]
+                )
+            else:
+                progress.show_warning("No plugins available", "Install plugins or check plugin directories")
+            return 0
+        
+        # Handle plugin-based diagram generation
+        if args.plugins:
+            from .plugins.registry import get_plugin_manager
+            from .models import DiagramConfig
+            from .aws.client_manager import get_client_manager
+            
+            manager = get_plugin_manager()
+            client_manager = get_client_manager(region=args.region, profile=args.profile)
+            progress = get_progress_tracker()
+            
+            # Create output directories
+            output_path = Path(args.output_dir_path)
+            output_path.mkdir(parents=True, exist_ok=True)
+            (output_path / "json").mkdir(exist_ok=True)
+            (output_path / "code").mkdir(exist_ok=True)
+            
+            for plugin_name in args.plugins:
+                try:
+                    plugin = manager.load_plugin(plugin_name, client_manager)
+                    
+                    # Collect data
+                    progress.show_success(f"🔌 Running {plugin_name} plugin")
+                    data = plugin.collect_data(client_manager, args.region)
+                    
+                    # Generate diagram
+                    diagram_config = DiagramConfig(
+                        title=f"{plugin_name.upper()} Infrastructure",
+                        direction="TB",
+                        output_format="png"
+                    )
+                    
+                    diagram_code = plugin.generate_diagram_code(data, diagram_config)
+                    
+                    # Save diagram code
+                    plugin_file = output_path / "code" / f"graph_{plugin_name}.py"
+                    plugin_file.write_text(diagram_code)
+                    
+                    # Save data
+                    data_file = output_path / "json" / f"{plugin_name}_data.json"
+                    import json
+                    data_file.write_text(json.dumps(data, indent=2, default=str))
+                    
+                    if args.auto_create:
+                        import os
+                        command = os.system(f"cd {output_path / 'code'} && python3 graph_{plugin_name}.py")
+                        if command == 0:
+                            progress.show_success(f"✅ {plugin_name} diagram created successfully")
+                        else:
+                            progress.show_error(f"Failed to create {plugin_name} diagram", f"Exit code: {command}")
+                    
+                except Exception as e:
+                    progress.show_error(f"Plugin {plugin_name} failed", str(e))
+                    if not args.debug:
+                        continue
+                    raise
+            
+            return 0
+        
+        # Handle version request
+        if args.version:
+            get_version(version=__version__)
+            return 0
+        
+        # Handle watch command
+        if args.commands == "watch":
+            watch_on_demand(args=args)
+            return 0
+        
+        # Setup AWS client manager
+        from .aws.client_manager import get_client_manager
+        client_manager = get_client_manager(region=args.region, profile=args.profile)
+        
+        diagrams_path = args.output_dir_path
+        region = args.region
+        
+        # Create output directories
+        output_path = Path(diagrams_path)
+        output_path.mkdir(parents=True, exist_ok=True)
+        (output_path / "json").mkdir(exist_ok=True)
+        (output_path / "code").mkdir(exist_ok=True)
+        
+        logging.info(f"Output directory: {output_path.absolute()}")
+        
+        # Execute requested operations using plugins
+        if args.graph_organization:
+            logging.info("Starting AWS Organizations diagram generation using plugin")
+            progress = get_progress_tracker()
+            try:
+                from .plugins.registry import get_plugin_manager
+                from .models import DiagramConfig
+                
+                manager = get_plugin_manager()
+                plugin = manager.load_plugin("organizations", client_manager)
+                
+                # Collect data
+                progress.show_success("🏢 Running Organizations plugin")
+                data = plugin.collect_data(client_manager, args.region)
+                
+                # Generate diagram
+                diagram_config = DiagramConfig(
+                    title="Organizations Structure",
+                    direction="TB",
+                    output_format="png"
+                )
+                
+                diagram_code = plugin.generate_diagram_code(data, diagram_config)
+                
+                # Save diagram code
+                org_file = output_path / "code" / "graph_org.py"
+                org_file.write_text(diagram_code)
+                
+                # Save data
+                from .reports.save_results import save_results
+                save_results(data["accounts"], "organizations.json", str(output_path / "json"))
+                save_results(data["organizations_complete"], "organizations_complete.json", str(output_path / "json"))
+                
+                if args.auto_create:
+                    import os
+                    command = os.system(f"cd {output_path / 'code'} && python3 graph_org.py")
+                    if command == 0:
+                        progress.show_success("✅ Organizations diagram created successfully")
+                    else:
+                        progress.show_error("Failed to create Organizations diagram", f"Exit code: {command}")
+                
+                logging.info("AWS Organizations diagram generation completed")
+                
+            except Exception as e:
+                logging.error(f"Organizations plugin failed: {e}")
+                # Fallback to original implementation with same client manager
+                logging.info("Falling back to original Organizations implementation")
+                # Pass the region and profile to ensure credentials are used
+                import os
+                os.environ['AWS_PROFILE'] = args.profile if args.profile else ''
+                graph_organizations(
+                    diagrams_path=diagrams_path, region=region, auto=args.auto_create
+                )
 
-    return 0
+        if args.graph_identity:
+            logging.info("Starting IAM Identity Center diagram generation using plugin")
+            progress = get_progress_tracker()
+            try:
+                from .plugins.registry import get_plugin_manager
+                from .models import DiagramConfig
+                
+                manager = get_plugin_manager()
+                plugin = manager.load_plugin("identity-center", client_manager)
+                
+                # Collect data
+                progress.show_success("🔐 Running Identity Center plugin")
+                data = plugin.collect_data(client_manager, args.region)
+                
+                # Generate diagram
+                diagram_config = DiagramConfig(
+                    title="IAM Identity Center",
+                    direction="LR",
+                    output_format="png"
+                )
+                
+                diagram_code = plugin.generate_diagram_code(data, diagram_config)
+                
+                # Save diagram code
+                sso_file = output_path / "code" / "graph_sso_complete.py"
+                sso_file.write_text(diagram_code)
+                
+                # Save data
+                from .reports.save_results import save_results
+                save_results(data["final_account_assignments"], "account_assignments.json", str(output_path / "json"))
+                save_results(data["group_memberships"], "groups.json", str(output_path / "json"))
+                
+                if args.auto_create:
+                    import os
+                    command = os.system(f"cd {output_path / 'code'} && python3 graph_sso_complete.py")
+                    if command == 0:
+                        progress.show_success("✅ Identity Center diagram created successfully")
+                    else:
+                        progress.show_error("Failed to create Identity Center diagram", f"Exit code: {command}")
+                
+                logging.info("IAM Identity Center diagram generation completed")
+                
+            except Exception as e:
+                logging.error(f"Identity Center plugin failed: {e}")
+                # Fallback to original implementation with same client manager
+                logging.info("Falling back to original Identity Center implementation")
+                # Pass the region and profile to ensure credentials are used
+                import os
+                os.environ['AWS_PROFILE'] = args.profile if args.profile else ''
+                graph_identity_center(
+                    diagrams_path=diagrams_path, region=region, auto=args.auto_create
+                )
+        
+        logging.info("All operations completed successfully")
+        return 0
+        
+    except ValueError as e:
+        logging.error(f"{Fore.RED}❌ Invalid arguments: {e}{Fore.RESET}")
+        parser.print_help()
+        return 1
+    except KeyboardInterrupt:
+        logging.info(f"{Fore.YELLOW}⚠️  Operation cancelled by user{Fore.RESET}")
+        return 1
+    except Exception as e:
+        logging.error(f"{Fore.RED}❌ Unexpected error: {e}{Fore.RESET}")
+        if logging.getLogger().isEnabledFor(logging.DEBUG):
+            logging.exception("Full traceback:")
+        return 1
 
 
 if __name__ == "__main__":

src/utils/__init__.py

@@ -0,0 +1 @@
+"""Utility modules for Reverse Diagrams."""