superset-showtime 0.6.4__py3-none-any.whl → 0.6.7__py3-none-any.whl

showtime/core/show.py

@@ -8,6 +8,8 @@ from dataclasses import dataclass
 from datetime import datetime
 from typing import List, Optional
 
+from .constants import DEFAULT_TTL
+
 
 # Import interfaces for singleton access
 # Note: These will be imported when the module loads, creating singletons
@@ -28,7 +30,7 @@ class Show:
     status: str  # building, built, deploying, running, updating, failed
     ip: Optional[str] = None  # Environment IP address
     created_at: Optional[str] = None  # ISO timestamp
-    ttl: str = "24h"  # 24h, 48h, close, etc.
+    ttl: str = DEFAULT_TTL  # 24h, 48h, close, etc.
     requested_by: Optional[str] = None  # GitHub username
 
     @property
@@ -80,26 +82,38 @@ class Show:
         """Check if environment needs update to latest SHA"""
         return self.sha != latest_sha[:7]
 
+    @property
+    def created_datetime(self) -> Optional[datetime]:
+        """Parse created_at timestamp into datetime object (UTC)"""
+        from .date_utils import parse_circus_time
+
+        if self.created_at is None:
+            return None
+        return parse_circus_time(self.created_at)
+
     def is_expired(self, max_age_hours: int) -> bool:
         """Check if this environment is expired based on age"""
-        if not self.created_at:
+        from .date_utils import is_expired
+
+        if self.created_at is None:
             return False
+        return is_expired(self.created_at, max_age_hours)
 
-        try:
-            from datetime import datetime, timedelta
+    def age_display(self) -> str:
+        """Get human-readable age of this environment"""
+        from .date_utils import age_display
 
-            created_time = datetime.fromisoformat(self.created_at.replace("-", ":"))
-            expiry_time = created_time + timedelta(hours=max_age_hours)
-            return datetime.now() > expiry_time
-        except (ValueError, AttributeError):
-            return False  # If we can't parse, assume not expired
+        if self.created_at is None:
+            return "unknown"
+        return age_display(self.created_at)
 
     def to_circus_labels(self) -> List[str]:
         """Convert show state to circus tent emoji labels (per-SHA format)"""
+        from .date_utils import format_utc_now
         from .emojis import CIRCUS_PREFIX, MEANING_TO_EMOJI
 
         if not self.created_at:
-            self.created_at = datetime.utcnow().strftime("%Y-%m-%dT%H-%M")
+            self.created_at = format_utc_now()
 
         labels = [
             f"{CIRCUS_PREFIX} {self.sha} {MEANING_TO_EMOJI['status']} {self.status}",  # SHA-first status
@@ -142,21 +156,20 @@ class Show:
             # Mock successful deployment for dry-run
             self.ip = "52.1.2.3"
 
-    def stop(self, dry_run_github: bool = False, dry_run_aws: bool = False) -> None:
+    def stop(self, dry_run_github: bool = False, dry_run_aws: bool = False) -> bool:
         """Stop this environment (cleanup AWS resources)
 
-        Raises:
-            Exception: On cleanup failure
+        Returns:
+            True if successful, False otherwise
         """
         github, aws = get_interfaces()
 
         # Delete AWS resources (pure technical work)
         if not dry_run_aws:
-            success = aws.delete_environment(self.aws_service_name, self.pr_number)
-            if not success:
-                raise Exception(f"Failed to delete AWS service: {self.aws_service_name}")
+            result = aws.delete_environment(self.aws_service_name, self.pr_number)
+            return bool(result)
 
-        # No comments - PullRequest handles that!
+        return True  # Dry run is always "successful"
 
     def _build_docker_image(self) -> None:
         """Build Docker image for this environment"""

showtime/core/sync_state.py

@@ -0,0 +1,137 @@
+"""
+🎪 Sync State - Typed state management for sync operations
+
+Provides structured state tracking with proper typing for analysis and debugging.
+"""
+
+from dataclasses import dataclass
+from enum import Enum
+from typing import List, Optional
+
+
+class ActionNeeded(Enum):
+    """Actions that sync can take"""
+
+    NO_ACTION = "no_action"
+    CREATE_ENVIRONMENT = "create_environment"
+    ROLLING_UPDATE = "rolling_update"
+    AUTO_SYNC = "auto_sync"
+    DESTROY_ENVIRONMENT = "destroy_environment"
+    BLOCKED = "blocked"
+
+
+class AuthStatus(Enum):
+    """Authorization check results"""
+
+    AUTHORIZED = "authorized"
+    DENIED_INSUFFICIENT_PERMS = "denied_insufficient_perms"
+    DENIED_404 = "denied_404"
+    ALLOWED_NO_ACTOR = "allowed_no_actor"
+    SKIPPED_NOT_ACTIONS = "skipped_not_actions"
+    ERROR = "error"
+
+
+class BlockedReason(Enum):
+    """Why an operation is blocked"""
+
+    EXISTING_BLOCKED_LABEL = "existing_blocked_label"
+    AUTHORIZATION_FAILED = "authorization_failed"
+    NOT_BLOCKED = "not_blocked"
+
+
+@dataclass
+class SyncState:
+    """Complete state information for a sync operation"""
+
+    # Core sync decision
+    action_needed: ActionNeeded
+    build_needed: bool
+    sync_needed: bool
+    target_sha: str
+
+    # Authorization info
+    github_actor: str
+    is_github_actions: bool
+    permission_level: str
+    auth_status: AuthStatus
+
+    # Blocking info
+    blocked_reason: BlockedReason = BlockedReason.NOT_BLOCKED
+
+    # Context info
+    trigger_labels: Optional[List[str]] = None
+    target_show_status: Optional[str] = None
+    has_previous_shows: bool = False
+    action_reason: str = ""
+
+    # Error details (if any)
+    auth_error: Optional[str] = None
+
+    def __post_init__(self) -> None:
+        """Initialize default values"""
+        if self.trigger_labels is None:
+            self.trigger_labels = []
+
+    @property
+    def is_blocked(self) -> bool:
+        """Check if operation is blocked"""
+        return self.action_needed == ActionNeeded.BLOCKED
+
+    @property
+    def is_authorized(self) -> bool:
+        """Check if actor is authorized"""
+        return self.auth_status == AuthStatus.AUTHORIZED
+
+    def to_gha_stdout(self, pr_number: int) -> str:
+        """Generate GitHub Actions compatible stdout with k=v pairs"""
+        lines = [
+            f"build_needed={str(self.build_needed).lower()}",
+            f"sync_needed={str(self.sync_needed).lower()}",
+            f"pr_number={pr_number}",
+            f"target_sha={self.target_sha}",
+            f"action_needed={self.action_needed.value}",
+            f"github_actor={self.github_actor}",
+            f"permission_level={self.permission_level}",
+            f"auth_status={self.auth_status.value}",
+        ]
+
+        # Add blocking info if relevant
+        if self.is_blocked:
+            lines.append(f"blocked_reason={self.blocked_reason.value}")
+
+        # Add context info for debugging
+        if self.trigger_labels:
+            lines.append(f"trigger_labels={','.join(self.trigger_labels)}")
+
+        if self.target_show_status:
+            lines.append(f"target_show_status={self.target_show_status}")
+
+        lines.append(f"has_previous_shows={str(self.has_previous_shows).lower()}")
+
+        if self.action_reason:
+            lines.append(f"action_reason={self.action_reason}")
+
+        # Add error info if present
+        if self.auth_error:
+            lines.append(f"auth_error={self.auth_error}")
+
+        return "\n".join(lines)
+
+    def to_debug_summary(self) -> str:
+        """Generate human-readable debug summary"""
+        status = "🚫 BLOCKED" if self.is_blocked else "✅ AUTHORIZED"
+
+        summary = [
+            f"🎪 Sync State Summary: {status}",
+            f"   Action: {self.action_needed.value} ({self.action_reason})",
+            f"   Actor: {self.github_actor} ({self.permission_level})",
+            f"   Auth: {self.auth_status.value}",
+        ]
+
+        if self.is_blocked:
+            summary.append(f"   Blocked: {self.blocked_reason.value}")
+
+        if self.trigger_labels:
+            summary.append(f"   Triggers: {', '.join(self.trigger_labels)}")
+
+        return "\n".join(summary)

{superset_showtime-0.6.4.dist-info → superset_showtime-0.6.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superset-showtime
-Version: 0.6.4
+Version: 0.6.7
 Summary: 🎪 Apache Superset ephemeral environment management with circus tent emoji state tracking
 Project-URL: Homepage, https://github.com/apache/superset-showtime
 Project-URL: Documentation, https://superset-showtime.readthedocs.io/

superset_showtime-0.6.7.dist-info/RECORD

@@ -0,0 +1,21 @@
+showtime/__init__.py,sha256=2Ky3eSk7FJq4kHOp0cH41haCJ3X8gZ5WpzxUqKXRnNM,448
+showtime/__main__.py,sha256=EVaDaTX69yIhCzChg99vqvFSCN4ELstEt7Mpb9FMZX8,109
+showtime/cli.py,sha256=uGqtmFHXTZd8vMWuoGZ6BLVWzuY34hMx-GMCkgvqvKk,34369
+showtime/core/__init__.py,sha256=54hbdFNGrzuNMBdraezfjT8Zi6g221pKlJ9mREnKwCw,34
+showtime/core/aws.py,sha256=7ifPmYryeuLR2c7RtGGzge8Ny9H6ZL40mDESiM1_fi8,34065
+showtime/core/constants.py,sha256=ssHiswRorqp2CnsZOebz2zqGsnDlMy9aeTQy8gju9fY,290
+showtime/core/date_utils.py,sha256=iQGQ1DfOwkWbdSTRM7CZdBhiXfpv26khobln5jg1d7k,2112
+showtime/core/emojis.py,sha256=arK0N5Q5FLkvOkci-lacb3WS56LTvY8NjYRqt_lhP9s,2188
+showtime/core/git_validation.py,sha256=2V9BSEjubGG4EHKZjcOUGYDWddNpB9uBZ_EVdU00C60,7203
+showtime/core/github.py,sha256=klUxIzUZRE7iQhG36A0lrtgnt6sTkmUjFazaXGgMlCY,12940
+showtime/core/github_messages.py,sha256=LDYAbVHMEwJaldeJy0ddKe91oRV3RVsUNAXo-RU5oDs,7490
+showtime/core/label_colors.py,sha256=gSe7EIMl4YjWkIgKHUvuaRSwgEB_B-NYQBxFFlF8Z3s,4065
+showtime/core/pull_request.py,sha256=vFlv6pTR3xI5jSODEaQh_af7CUA5kf1StQqQhmzVczI,44964
+showtime/core/service_name.py,sha256=ZgYzlgnMdMqqatCMVarSyzv9Za9njxDSfIvgYd0LUIY,3126
+showtime/core/show.py,sha256=VzjOeUG2ra2tdDIzO1EHkZiEt-kMznRk9O2PQ7VuE4I,10224
+showtime/core/sync_state.py,sha256=oe1lTWWPzfvEAzLBAowdsSJZIdmm5NN-RewzpYTj8zE,4147
+showtime/data/ecs-task-definition.json,sha256=d-NLkIhvr4C6AnwDfDIwUTx-6KFMH9wRkt6pVCbqZY4,2365
+superset_showtime-0.6.7.dist-info/METADATA,sha256=_2odjOOHSF_gh7E__iGf2oa4p7a0XV-Ow3qsgW2DVEw,12052
+superset_showtime-0.6.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+superset_showtime-0.6.7.dist-info/entry_points.txt,sha256=rDW7oZ57mqyBUS4N_3_R7bZNGVHB-104jwmY-hHC_ck,85
+superset_showtime-0.6.7.dist-info/RECORD,,

superset_showtime-0.6.4.dist-info/RECORD

@@ -1,17 +0,0 @@
-showtime/__init__.py,sha256=O8PG7VEz2VYlezufbPc7zRxajuNxLRaW7XTXnOYSki0,448
-showtime/__main__.py,sha256=EVaDaTX69yIhCzChg99vqvFSCN4ELstEt7Mpb9FMZX8,109
-showtime/cli.py,sha256=TLv9NaqPyewKJi9uCTZKWBijGelqunmsoSo7cyKajV4,31640
-showtime/core/__init__.py,sha256=54hbdFNGrzuNMBdraezfjT8Zi6g221pKlJ9mREnKwCw,34
-showtime/core/aws.py,sha256=uTjJAvEBQMyTccS93WZeNPhfeKQhJgOQQ0BJdnQjvCU,35007
-showtime/core/emojis.py,sha256=arK0N5Q5FLkvOkci-lacb3WS56LTvY8NjYRqt_lhP9s,2188
-showtime/core/git_validation.py,sha256=3dmSGpMDplDAmKWHUyoUEPgt3__8oTuBZxbfuhocT00,6831
-showtime/core/github.py,sha256=mSOqRLy2KMDhWUS37V2gJ-CQdeBpEqunBRKL10v5hxU,12268
-showtime/core/github_messages.py,sha256=MfgwCukrEsWWesMsuL8saciDgP4nS-gijzu8DXr-Alg,7450
-showtime/core/label_colors.py,sha256=gSe7EIMl4YjWkIgKHUvuaRSwgEB_B-NYQBxFFlF8Z3s,4065
-showtime/core/pull_request.py,sha256=DCrTYz3Fu2Oh9FRgYTwncvzX7zy4Wa0BZsBwYa3nTpg,32669
-showtime/core/show.py,sha256=sOgZvGXwdcNDsidF1F_XwPXlSeTb8-Zeqhqb8w1pqAM,9973
-showtime/data/ecs-task-definition.json,sha256=d-NLkIhvr4C6AnwDfDIwUTx-6KFMH9wRkt6pVCbqZY4,2365
-superset_showtime-0.6.4.dist-info/METADATA,sha256=SqFxH-mmg3jpLnOp2Gkl2AHJjewmga-nNtSe4HHk8bw,12052
-superset_showtime-0.6.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-superset_showtime-0.6.4.dist-info/entry_points.txt,sha256=rDW7oZ57mqyBUS4N_3_R7bZNGVHB-104jwmY-hHC_ck,85
-superset_showtime-0.6.4.dist-info/RECORD,,