clear-skies-cortex 2.0.4__py3-none-any.whl → 2.0.6__py3-none-any.whl

{clear_skies_cortex-2.0.4.dist-info → clear_skies_cortex-2.0.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clear-skies-cortex
-Version: 2.0.4
+Version: 2.0.6
 Summary: Cortex module for Clearskies
 Project-URL: Docs, https://https://clearskies.info/modules/clear-skies-cortex
 Project-URL: Repository, https://github.com/clearskies-py/cortex

{clear_skies_cortex-2.0.4.dist-info → clear_skies_cortex-2.0.6.dist-info}/RECORD

@@ -9,7 +9,7 @@ clearskies_cortex/defaults/__init__.py,sha256=tulZSvFgp4YUKj_bnArIevmlpC8z_AQKO0
 clearskies_cortex/defaults/default_cortex_auth.py,sha256=sWlWgXIoCXk0FkwK3Kz33TVohsaVpIOS9qj2Ef5_YN8,2135
 clearskies_cortex/defaults/default_cortex_url.py,sha256=sKBDQVPJWc4ozBquZ7fKryTbUOXYfrH6hUcQuUtMXEU,1576
 clearskies_cortex/models/__init__.py,sha256=zckJ4-KOjIcmtN7h7lXOESUu3d6JBsZZJq-s2MJ0NLQ,1145
-clearskies_cortex/models/cortex_catalog_entity.py,sha256=nWKApnvcr3pmSijEJgZ4cuZgG9ck6d8ey3AyVb8vfXQ,6632
+clearskies_cortex/models/cortex_catalog_entity.py,sha256=MqEe-Kb3JDzhmEckBZZr4Ms3Zv1Ul6Rom_1-XF5Moi0,12461
 clearskies_cortex/models/cortex_catalog_entity_domain.py,sha256=AOa07Fq-SWc8zkg6g-fBi5x1GnGg42GhPM2GozrgC2c,2327
 clearskies_cortex/models/cortex_catalog_entity_group.py,sha256=D5Je_kX4dBW8jkhmZBca02mFYT3cqK1walleMXTlcdg,1295
 clearskies_cortex/models/cortex_catalog_entity_scorecard.py,sha256=XT08_865AzsiMGsybIhQPQ8jTR1HrCfAtRAME7MdDo0,2372
@@ -22,7 +22,7 @@ clearskies_cortex/models/cortex_scorecard.py,sha256=aiM8_MkdMT_n-a6teG8y6zWSLmHu
 clearskies_cortex/models/cortex_team.py,sha256=UUS1KHufPqhO29h4eKIfeZzUz75KjwkqaW5ItmdAKS4,4356
 clearskies_cortex/models/cortex_team_category_tree.py,sha256=PRCIGeZrBoGiH1a7Q8ZsYYzSfj4cZF9tIRcBWEKAX60,1898
 clearskies_cortex/models/cortex_team_department.py,sha256=_0Go97ZFr_GCd_ol0iBw7Px5F_gE94WtAWFGnzQ9y-M,1582
-clear_skies_cortex-2.0.4.dist-info/METADATA,sha256=rhPhCyHqZqZ7yks_PDAaZX1aJ-MBL0kaG_oYh-NS_Bo,2117
-clear_skies_cortex-2.0.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-clear_skies_cortex-2.0.4.dist-info/licenses/LICENSE,sha256=MkEX8JF8kZxdyBpTTcB0YTd-xZpWnHvbRlw-pQh8u58,1069
-clear_skies_cortex-2.0.4.dist-info/RECORD,,
+clear_skies_cortex-2.0.6.dist-info/METADATA,sha256=Vp6Y9IyPqXd7GY_XTibg-WytYIgydZTON-sMHLMoIvI,2117
+clear_skies_cortex-2.0.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+clear_skies_cortex-2.0.6.dist-info/licenses/LICENSE,sha256=MkEX8JF8kZxdyBpTTcB0YTd-xZpWnHvbRlw-pQh8u58,1069
+clear_skies_cortex-2.0.6.dist-info/RECORD,,

clearskies_cortex/models/cortex_catalog_entity.py

@@ -225,6 +225,8 @@ class CortexCatalogEntity(Model):
 
     def parse_hierarchy(self) -> dataclasses.ServiceEntityHierarchy:
         """Parse the hierarchy column into a dictionary."""
+        if self.hierarchy is None:
+            return dataclasses.ServiceEntityHierarchy(parents=[], children=[])
         return from_dict(dataclasses.ServiceEntityHierarchy, data=self.hierarchy)
 
     def parse_groups(self) -> dict[str, str]:
@@ -243,5 +245,169 @@ class CortexCatalogEntity(Model):
         return parsed
 
     def parse_owners(self) -> dataclasses.EntityTeamOwner:
-        """Parse the owners column into a dictionary."""
+        """Parse the owners column into a dictionary.
+
+        Returns an empty EntityTeamOwner if owners is None.
+        """
+        if self.owners is None:
+            return dataclasses.EntityTeamOwner(teams=[], individuals=[])
         return from_dict(dataclasses.EntityTeamOwner, data=self.owners)
+
+    def get_group_tags(self) -> list[str]:
+        """Get groups as simple tags.
+
+        Returns groups that don't have a key:value format.
+
+        Returns:
+            List of group names that are simple tags without key:value format.
+
+        Example:
+            >>> entity.groups = ["my-tag", "team:platform", "production"]
+            >>> entity.get_group_tags()
+            ["my-tag", "production"]
+        """
+        tags: list[str] = []
+        if self.groups:
+            for group in self.groups:
+                if ":" not in group:
+                    tags.append(group)
+        return tags
+
+    def get_group_value(self, key: str) -> str | None:
+        """Get the value for a specific group key.
+
+        Groups can be formatted as "key:value" pairs. This method extracts
+        the value for a given key.
+
+        Args:
+            key: The group key to look up.
+
+        Returns:
+            The value associated with the key, or None if not found.
+
+        Example:
+            >>> entity.groups = ["team:platform", "env:production"]
+            >>> entity.get_group_value("team")
+            "platform"
+        """
+        if self.groups:
+            for group in self.groups:
+                if group.startswith(f"{key}:"):
+                    return group.split(":", 1)[1]
+        return None
+
+    def get_git_repository_url(self) -> str | None:
+        """Get the Git repository URL.
+
+        Returns:
+            The repository URL, or None if not configured.
+
+        Example:
+            >>> entity.git = {"repository": "https://github.com/org/repo"}
+            >>> entity.get_git_repository_url()
+            "https://github.com/org/repo"
+        """
+        if not self.git:
+            return None
+        return self.git.get("repository") or self.git.get("repositoryUrl")
+
+    def get_git_provider(self) -> str | None:
+        """Get the Git provider name.
+
+        Returns:
+            The provider name (e.g., "github", "gitlab", "bitbucket", "azure-devops"),
+            or None if not configured.
+
+        Example:
+            >>> entity.git = {"provider": "github", "repository": "..."}
+            >>> entity.get_git_provider()
+            "github"
+        """
+        if not self.git:
+            return None
+        return self.git.get("provider")
+
+    def get_git_project_id(self) -> str | None:
+        """Extract the project/repository identifier from the Git configuration.
+
+        Cortex supports multiple SCM providers (GitHub, GitLab, Bitbucket, Azure DevOps).
+        This method extracts the project identifier in a provider-agnostic way.
+
+        For GitLab, this returns the numeric project ID if available in the URL.
+        For GitHub/Bitbucket, this returns the "owner/repo" format.
+        For Azure DevOps, this returns the project/repo path.
+
+        Returns:
+            The project identifier as a string, or None if not found.
+
+        Example:
+            >>> entity.git = {"repository": "https://github.com/org/repo"}
+            >>> entity.get_git_project_id()
+            "org/repo"
+
+            >>> entity.git = {"repository": "https://gitlab.com/projects/12345"}
+            >>> entity.get_git_project_id()
+            "12345"
+        """
+        if not self.git:
+            return None
+
+        repo_url = self.git.get("repository") or self.git.get("repositoryUrl") or ""
+
+        # GitLab numeric project ID format: https://gitlab.com/projects/12345
+        if "/projects/" in repo_url:
+            try:
+                project_id = repo_url.split("/projects/")[1].split("/")[0]
+                return project_id
+            except IndexError:
+                pass
+
+        # Standard URL format: https://provider.com/owner/repo or https://provider.com/owner/repo.git
+        # Works for GitHub, GitLab (path format), Bitbucket
+        for prefix in ["github.com/", "gitlab.com/", "bitbucket.org/"]:
+            if prefix in repo_url:
+                try:
+                    path = repo_url.split(prefix)[1]
+                    # Remove .git suffix if present
+                    if path.endswith(".git"):
+                        path = path[:-4]
+                    # Remove trailing slashes
+                    path = path.rstrip("/")
+                    # Return owner/repo format
+                    parts = path.split("/")
+                    if len(parts) >= 2:
+                        return f"{parts[0]}/{parts[1]}"
+                except IndexError:
+                    pass
+
+        # Azure DevOps format: https://dev.azure.com/org/project/_git/repo
+        if "dev.azure.com/" in repo_url:
+            try:
+                path = repo_url.split("dev.azure.com/")[1]
+                parts = path.split("/")
+                if len(parts) >= 4 and parts[2] == "_git":
+                    return f"{parts[0]}/{parts[1]}/{parts[3]}"
+            except IndexError:
+                pass
+
+        return None
+
+    @property
+    def is_cloud_resource(self) -> bool:
+        """Check if entity represents a cloud resource.
+
+        Cortex supports pulling in resources from AWS, Azure, and Google Cloud.
+        This property checks if the entity type indicates a cloud resource.
+
+        Returns:
+            True if the entity type indicates a cloud resource.
+
+        Example:
+            >>> entity.type = "AWS::Lambda::Function"
+            >>> entity.is_cloud_resource
+            True
+        """
+        if not self.type:
+            return False
+        cloud_prefixes = ("AWS::", "Azure::", "Google::")
+        return self.type.startswith(cloud_prefixes)