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

src/aws/describe_sso.py

@@ -1,176 +1,203 @@
 """Describe SSO."""
 import logging
+from typing import List, Dict, Any, Optional
 
-from boto3 import client
+from .client_manager import get_client_manager
+from .exceptions import AWSServiceError
+from ..utils.progress import track_operation
+from ..config import get_config
 
+logger = logging.getLogger(__name__)
 
-def list_instances(region: str):
-    """
-    List all instances in the region.
 
-    :param region:
-    :return:
+def list_instances(region: str) -> List[Dict[str, Any]]:
     """
-    sso_client = client("sso-admin", region_name=region)
-    response = sso_client.list_instances()
-
-
-    return response["Instances"]
+    List all SSO instances in the region.
 
+    Args:
+        region: AWS region name
 
-# def list account assignments with pagination
-def list_account_assignments_pag(
-    instance_arn, account_id, permission_set_arn, region, next_token
-):
-    """
-    List all account assignments.
-
-    :param instance_arn:
-    :param account_id:
-    :param permission_set_arn:
-    :param region:
-    :return:
+    Returns:
+        List of SSO instances
 
+    Raises:
+        AWSServiceError: If the API call fails
     """
-    sso_client = client("sso-admin", region_name=region)
-    paginator = sso_client.get_paginator("list_account_assignments")
-    response_iterator = paginator.paginate(
-        InstanceArn=instance_arn,
-        AccountId=account_id,
-        PermissionSetArn=permission_set_arn,
-        PaginationConfig={
-            "MaxItems": 1000,
-            "PageSize": 20,
-            "StartingToken": next_token,
-        },
-    )
-    return response_iterator["AccountAssignments"]
+    client_manager = get_client_manager(region=region)
+    
+    with track_operation("Listing SSO instances") as task_id:
+        response = client_manager.call_api("sso-admin", "list_instances")
+        instances = response.get("Instances", [])
+        logger.info(f"Found {len(instances)} SSO instances")
+        return instances
 
 
 def list_account_assignments(
-    instance_arn, account_id, permission_set_arn, region, sso_client
-):
+    instance_arn: str, 
+    account_id: str, 
+    permission_set_arn: str, 
+    region: str
+) -> List[Dict[str, Any]]:
     """
-    List all account assignments.
+    List all account assignments for a permission set.
 
-    :param sso_client:
-    :param instance_arn:
-    :param account_id:
-    :param permission_set_arn:
-    :param region:
-    :return:
+    Args:
+        instance_arn: SSO instance ARN
+        account_id: AWS account ID
+        permission_set_arn: Permission set ARN
+        region: AWS region name
 
+    Returns:
+        List of account assignments
     """
-    response = sso_client.list_account_assignments(
-        InstanceArn=instance_arn,
-        AccountId=account_id,
-        PermissionSetArn=permission_set_arn,
-        MaxResults=50,
-    )
-    account_assignments = response["AccountAssignments"]
-    if len(response["AccountAssignments"]) >= 50:
-        logging.info("Paginating ...")
-        response_iterator = list_account_assignments_pag(
-            instance_arn,
-            account_id,
-            permission_set_arn,
-            region,
-            next_token=response["NextToken"],
+    client_manager = get_client_manager(region=region)
+    config = get_config()
+    
+    try:
+        # Use paginated API call for better handling of large result sets
+        assignments = client_manager.paginate_api_call(
+            "sso-admin",
+            "list_account_assignments",
+            "AccountAssignments",
+            InstanceArn=instance_arn,
+            AccountId=account_id,
+            PermissionSetArn=permission_set_arn,
+            PaginationConfig={
+                'MaxItems': config.pagination.max_items,
+                'PageSize': config.pagination.default_page_size
+            }
         )
-        for response in response_iterator:
-            logging.debug(response)
-            account_assignments.append(response["AccountAssignments"])
-            logging.info(response["AccountAssignments"])
-    return account_assignments
+        
+        logger.debug(f"Retrieved {len(assignments)} account assignments for account {account_id}")
+        return assignments
+        
+    except Exception as e:
+        logger.error(f"Failed to list account assignments for account {account_id}: {e}")
+        raise AWSServiceError(f"Failed to list account assignments: {e}")
 
 
-def list_permissions_set_pag(instance_arn, region, next_token):
+def list_permissions_set(instance_arn: str, region: str) -> List[str]:
     """
-    List all permission set in a region.
+    List all permission sets in an SSO instance.
 
-    :param next_token:
-    :param instance_arn:
-    :param region:
-    :return:
-    """
-    sso_client = client("sso-admin", region_name=region)
-    paginator = sso_client.get_paginator("list_permission_sets")
-    response_iterator = paginator.paginate(
-        InstanceArn=instance_arn,
-        PaginationConfig={
-            "MaxItems": 1000,
-            "PageSize": 20,
-            "StartingToken": next_token,
-        },
-    )
-    response_iterator = response_iterator.build_full_result()
-    return response_iterator["PermissionSets"]
-
-
-def list_permissions_set(instance_arn, region):
-    """
-    List all permission set in a region.
+    Args:
+        instance_arn: SSO instance ARN
+        region: AWS region name
 
-    :param instance_arn:
-    :param region:
-    :return:
+    Returns:
+        List of permission set ARNs
     """
-    sso_client = client(
-        "sso-admin",
-        region_name=region,
-    )
-    response = sso_client.list_permission_sets(InstanceArn=instance_arn, MaxResults=20)
-    logging.debug(response)
-    permissions_set = response["PermissionSets"]
-
-    if len(response["PermissionSets"]) >= 20:
-        logging.info("Paginating ...")
-        response_iterator = list_permissions_set_pag(
-            instance_arn, region, next_token=response["NextToken"]
-        )
-        for response in response_iterator:
-            logging.debug(response)
-            permissions_set.append(response)
-            logging.info(response)
-
-    return permissions_set
+    client_manager = get_client_manager(region=region)
+    config = get_config()
+    
+    with track_operation("Listing permission sets") as task_id:
+        try:
+            permission_sets = client_manager.paginate_api_call(
+                "sso-admin",
+                "list_permission_sets",
+                "PermissionSets",
+                InstanceArn=instance_arn,
+                PaginationConfig={
+                    'MaxItems': config.pagination.max_items,
+                    'PageSize': config.pagination.default_page_size
+                }
+            )
+            
+            logger.info(f"Found {len(permission_sets)} permission sets")
+            return permission_sets
+            
+        except Exception as e:
+            logger.error(f"Failed to list permission sets: {e}")
+            raise AWSServiceError(f"Failed to list permission sets: {e}")
+
+
+def list_permission_provisioned(account_id: str, instance_arn: str, region: str) -> List[str]:
+    """
+    List permission sets provisioned to an account.
 
+    Args:
+        account_id: AWS account ID
+        instance_arn: SSO instance ARN
+        region: AWS region name
 
-def list_permission_provisioned(account_id, instance_arn, region):
+    Returns:
+        List of provisioned permission set ARNs
     """
-    List permission provisioned.
-
-    :param account_id:
-    :param instance_arn:
-    :param region:
-    :return:
+    client_manager = get_client_manager(region=region)
+    
+    try:
+        response = client_manager.call_api(
+            "sso-admin",
+            "list_permission_sets_provisioned_to_account",
+            InstanceArn=instance_arn,
+            AccountId=account_id
+        )
+        
+        permission_sets = response.get("PermissionSets", [])
+        logger.debug(f"Found {len(permission_sets)} provisioned permission sets for account {account_id}")
+        return permission_sets
+        
+    except Exception as e:
+        logger.error(f"Failed to list provisioned permission sets for account {account_id}: {e}")
+        raise AWSServiceError(f"Failed to list provisioned permission sets: {e}")
+
+
+def extends_permissions_set(
+    permissions_sets: List[str], 
+    store_arn: str, 
+    region: str
+) -> Dict[str, str]:
     """
-    l_client = client("sso-admin", region_name=region)
-    response = l_client.list_permission_sets_provisioned_to_account(
-        InstanceArn=instance_arn,
-        AccountId=account_id,
-    )
-    logging.debug(response)
-    return response["PermissionSets"]
+    Get detailed information for permission sets.
 
+    Args:
+        permissions_sets: List of permission set ARNs
+        store_arn: SSO instance ARN
+        region: AWS region name
 
-def extends_permissions_set(permissions_sets, store_arn, region):
+    Returns:
+        Dictionary mapping permission set ARN to name
     """
-    List all permission set in a region.
-
-    :param permissions_sets:
-    :param store_arn:
-    :param region:
-    :return:
+    client_manager = get_client_manager(region=region)
+    permissions_map = {}
+    
+    with track_operation(f"Getting details for {len(permissions_sets)} permission sets") as task_id:
+        for i, permission_set_arn in enumerate(permissions_sets):
+            try:
+                response = client_manager.call_api(
+                    "sso-admin",
+                    "describe_permission_set",
+                    InstanceArn=store_arn,
+                    PermissionSetArn=permission_set_arn
+                )
+                
+                permission_set = response.get("PermissionSet", {})
+                permissions_map[permission_set_arn] = permission_set.get("Name", "Unknown")
+                
+                # Update progress
+                if i % 5 == 0:  # Update every 5 items to avoid too frequent updates
+                    client_manager._progress_tracker.update_progress(task_id, advance=5)
+                
+            except Exception as e:
+                logger.warning(f"Failed to describe permission set {permission_set_arn}: {e}")
+                permissions_map[permission_set_arn] = "Unknown"
+    
+    logger.info(f"Retrieved details for {len(permissions_map)} permission sets")
+    return permissions_map
+
+
+# Backward compatibility function
+def client(service_name: str, region_name: str, profile: Optional[str] = None):
     """
-    sso_client = client("sso-admin", region_name=region)
-    l_permissions_set_arn_name = {}
-    for p in permissions_sets:
-        response = sso_client.describe_permission_set(
-            InstanceArn=store_arn, PermissionSetArn=p
-        )
-
-        l_permissions_set_arn_name[p] = response["PermissionSet"]["Name"]
-
-        logging.debug(response["PermissionSet"]["Name"])
-    return l_permissions_set_arn_name
+    Backward compatibility function for existing code.
+    
+    Args:
+        service_name: AWS service name
+        region_name: AWS region
+        profile: AWS profile (optional)
+        
+    Returns:
+        Boto3 client instance
+    """
+    from .client_manager import client as new_client
+    return new_client(service_name, region_name, profile)

src/aws/exceptions.py

@@ -0,0 +1,26 @@
+"""Custom exceptions for AWS operations."""
+
+
+class AWSError(Exception):
+    """Base exception for AWS-related errors."""
+    pass
+
+
+class AWSCredentialsError(AWSError):
+    """Raised when AWS credentials are invalid or missing."""
+    pass
+
+
+class AWSPermissionError(AWSError):
+    """Raised when AWS permissions are insufficient."""
+    pass
+
+
+class AWSServiceError(AWSError):
+    """Raised when AWS service calls fail."""
+    pass
+
+
+class AWSResourceNotFoundError(AWSError):
+    """Raised when AWS resources are not found."""
+    pass

src/banner/banner.py

@@ -1,48 +1,51 @@
 """Create Banner."""
-from colorama import Fore
-
-
-banner = (
-    Fore.GREEN
-    + """
- .----------------.  .----------------.  .----------------.  .----------------.  .----------------.  .----------------.  .----------------.                     
-| .--------------. || .--------------. || .--------------. || .--------------. || .--------------. || .--------------. || .--------------. |                    
-| |  _______     | || |  _________   | || | ____   ____  | || |  _________   | || |  _______     | || |    _______   | || |  _________   | |                    
-| | |_   __ \    | || | |_   ___  |  | || ||_  _| |_  _| | || | |_   ___  |  | || | |_   __ \    | || |   /  ___  |  | || | |_   ___  |  | |                    
-| |   | |__) |   | || |   | |_  \_|  | || |  \ \   / /   | || |   | |_  \_|  | || |   | |__) |   | || |  |  (__ \_|  | || |   | |_  \_|  | |                    
-| |   |  __ /    | || |   |  _|  _   | || |   \ \ / /    | || |   |  _|  _   | || |   |  __ /    | || |   '.___`-.   | || |   |  _|  _   | |                    
-| |  _| |  \ \_  | || |  _| |___/ |  | || |    \ ' /     | || |  _| |___/ |  | || |  _| |  \ \_  | || |  |`\____) |  | || |  _| |___/ |  | |                    
-| | |____| |___| | || | |_________|  | || |     \_/      | || | |_________|  | || | |____| |___| | || |  |_______.'  | || | |_________|  | |                    
-| |              | || |              | || |              | || |              | || |              | || |              | || |              | |                    
-| '--------------' || '--------------' || '--------------' || '--------------' || '--------------' || '--------------' || '--------------' |                    
- '----------------'  '----------------'  '----------------'  '----------------'  '----------------'  '----------------'  '----------------'                     
- .----------------.  .----------------.  .----------------.  .----------------.  .----------------.  .----------------.  .----------------.  .----------------. 
-| .--------------. || .--------------. || .--------------. || .--------------. || .--------------. || .--------------. || .--------------. || .--------------. |
-| |  ________    | || |     _____    | || |      __      | || |    ______    | || |  _______     | || |      __      | || | ____    ____ | || |    _______   | |
-| | |_   ___ `.  | || |    |_   _|   | || |     /  \     | || |  .' ___  |   | || | |_   __ \    | || |     /  \     | || ||_   \  /   _|| || |   /  ___  |  | |
-| |   | |   `. \ | || |      | |     | || |    / /\ \    | || | / .'   \_|   | || |   | |__) |   | || |    / /\ \    | || |  |   \/   |  | || |  |  (__ \_|  | |
-| |   | |    | | | || |      | |     | || |   / ____ \   | || | | |    ____  | || |   |  __ /    | || |   / ____ \   | || |  | |\  /| |  | || |   '.___`-.   | |
-| |  _| |___.' / | || |     _| |_    | || | _/ /    \ \_ | || | \ `.___]  _| | || |  _| |  \ \_  | || | _/ /    \ \_ | || | _| |_\/_| |_ | || |  |`\____) |  | |
-| | |________.'  | || |    |_____|   | || ||____|  |____|| || |  `._____.'   | || | |____| |___| | || ||____|  |____|| || ||_____||_____|| || |  |_______.'  | |
-| |              | || |              | || |              | || |              | || |              | || |              | || |              | || |              | |
-| '--------------' || '--------------' || '--------------' || '--------------' || '--------------' || '--------------' || '--------------' || '--------------' |
- '----------------'  '----------------'  '----------------'  '----------------'  '----------------'  '----------------'  '----------------'  '----------------' 
-
-
-Power by - Avelez- 👤
-"""
-)
+from rich.console import Console
+from rich.text import Text
 
 
 def get_version(version):
     """
-    Get package version.
+    Display professional banner with version.
 
-    :param version:
-    :return:
+    :param version: Version string
+    :return: Version string
     """
-    print(Fore.BLUE + banner)
-
-    print(version + Fore.RESET)
-
+    console = Console()
+    
+    # Create the banner with a clean, modern design
+    banner_lines = [
+        "",
+        "╔═══════════════════════════════════════════════════════════════╗",
+        "║                                                               ║",
+        "║              🔄  REVERSE DIAGRAMS                             ║",
+        "║                                                               ║",
+        "║        AWS Infrastructure Documentation as Code               ║",
+        "║                                                               ║",
+        "╚═══════════════════════════════════════════════════════════════╝",
+        ""
+    ]
+    
+    # Print banner with colors
+    for line in banner_lines:
+        if "REVERSE DIAGRAMS" in line:
+            text = Text(line, style="bold cyan")
+        elif "AWS Infrastructure" in line:
+            text = Text(line, style="green")
+        elif "═" in line or "║" in line:
+            text = Text(line, style="cyan")
+        else:
+            text = Text(line)
+        console.print(text, justify="center")
+    
+    # Print version info
+    version_text = Text()
+    version_text.append("  Version ", style="dim")
+    version_text.append(version, style="bold yellow")
+    version_text.append("  •  ", style="dim")
+    version_text.append("github.com/velez94/reverse_diagrams", style="dim cyan underline")
+    version_text.append("  ", style="dim")
+    
+    console.print(version_text, justify="center")
+    console.print()
+    
     return version

src/config.py

@@ -0,0 +1,153 @@
+"""Configuration management for Reverse Diagrams."""
+import os
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Optional, Dict, Any
+import logging
+
+
+@dataclass
+class PaginationConfig:
+    """Configuration for AWS API pagination."""
+    default_page_size: int = 20
+    max_page_size: int = 1000
+    max_items: int = 10000
+
+
+@dataclass
+class AWSConfig:
+    """Configuration for AWS operations."""
+    timeout: int = 30
+    max_retries: int = 3
+    backoff_factor: float = 2.0
+    
+    # Required permissions documentation
+    required_permissions: Dict[str, list] = field(default_factory=lambda: {
+        'organizations': [
+            'organizations:DescribeOrganization',
+            'organizations:ListRoots',
+            'organizations:ListOrganizationalUnitsForParent',
+            'organizations:ListAccounts',
+            'organizations:ListParents'
+        ],
+        'sso-admin': [
+            'sso:ListInstances',
+            'sso:ListPermissionSets',
+            'sso:DescribePermissionSet',
+            'sso:ListAccountAssignments'
+        ],
+        'identitystore': [
+            'identitystore:ListGroups',
+            'identitystore:ListUsers',
+            'identitystore:ListGroupMemberships'
+        ]
+    })
+
+
+@dataclass
+class OutputConfig:
+    """Configuration for output generation."""
+    default_output_dir: str = "diagrams"
+    json_indent: int = 4
+    create_directories: bool = True
+    file_permissions: int = 0o644
+    
+    # Supported output formats
+    supported_formats: list = field(default_factory=lambda: ['png', 'svg', 'pdf'])
+
+
+@dataclass
+class LoggingConfig:
+    """Configuration for logging."""
+    level: str = "INFO"
+    format: str = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+    file_path: Optional[Path] = None
+    max_file_size: int = 10 * 1024 * 1024  # 10MB
+    backup_count: int = 5
+
+
+@dataclass
+class Config:
+    """Main configuration class."""
+    pagination: PaginationConfig = field(default_factory=PaginationConfig)
+    aws: AWSConfig = field(default_factory=AWSConfig)
+    output: OutputConfig = field(default_factory=OutputConfig)
+    logging: LoggingConfig = field(default_factory=LoggingConfig)
+    
+    # Performance settings
+    max_concurrent_workers: int = 5
+    enable_caching: bool = True
+    cache_ttl_hours: int = 1
+    
+    @classmethod
+    def from_env(cls) -> 'Config':
+        """Create configuration from environment variables."""
+        config = cls()
+        
+        # AWS configuration from environment
+        if os.getenv('AWS_TIMEOUT'):
+            config.aws.timeout = int(os.getenv('AWS_TIMEOUT'))
+        if os.getenv('AWS_MAX_RETRIES'):
+            config.aws.max_retries = int(os.getenv('AWS_MAX_RETRIES'))
+        
+        # Output configuration from environment
+        if os.getenv('REVERSE_DIAGRAMS_OUTPUT_DIR'):
+            config.output.default_output_dir = os.getenv('REVERSE_DIAGRAMS_OUTPUT_DIR')
+        
+        # Logging configuration from environment
+        if os.getenv('LOG_LEVEL'):
+            config.logging.level = os.getenv('LOG_LEVEL').upper()
+        if os.getenv('LOG_FILE'):
+            config.logging.file_path = Path(os.getenv('LOG_FILE'))
+        
+        # Performance settings from environment
+        if os.getenv('MAX_WORKERS'):
+            config.max_concurrent_workers = int(os.getenv('MAX_WORKERS'))
+        if os.getenv('ENABLE_CACHING'):
+            config.enable_caching = os.getenv('ENABLE_CACHING').lower() == 'true'
+        
+        return config
+    
+    def setup_logging(self):
+        """Setup logging based on configuration."""
+        handlers = [logging.StreamHandler()]
+        
+        if self.logging.file_path:
+            from logging.handlers import RotatingFileHandler
+            file_handler = RotatingFileHandler(
+                self.logging.file_path,
+                maxBytes=self.logging.max_file_size,
+                backupCount=self.logging.backup_count
+            )
+            handlers.append(file_handler)
+        
+        logging.basicConfig(
+            level=getattr(logging, self.logging.level),
+            format=self.logging.format,
+            handlers=handlers
+        )
+        
+        # Reduce noise from AWS SDK
+        logging.getLogger('boto3').setLevel(logging.WARNING)
+        logging.getLogger('botocore').setLevel(logging.WARNING)
+        logging.getLogger('urllib3').setLevel(logging.WARNING)
+
+
+# Global configuration instance
+_config: Optional[Config] = None
+
+
+def get_config() -> Config:
+    """Get global configuration instance."""
+    global _config
+    if _config is None:
+        _config = Config.from_env()
+        _config.setup_logging()
+    return _config
+
+
+def set_config(config: Config):
+    """Set global configuration instance."""
+    global _config
+    _config = config
+    _config.setup_logging()