iltero-cli 0.3.2__tar.gz → 0.3.3__tar.gz

{iltero_cli-0.3.2 → iltero_cli-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iltero-cli
-Version: 0.3.2
+Version: 0.3.3
 Summary: Iltero CLI - Infrastructure compliance scanning and management
 Project-URL: Homepage, https://iltero.io
 Project-URL: Documentation, https://docs.iltero.io

iltero_cli-0.3.3/iltero/api_client/api/compliance_scans/compliance_get_run_summary.py

@@ -0,0 +1,187 @@
+from http import HTTPStatus
+from typing import Any
+from urllib.parse import quote
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.api_response_model_run_compliance_summary_schema import APIResponseModelRunComplianceSummarySchema
+from ...types import Response
+
+
+def _get_kwargs(
+    run_id: str,
+) -> dict[str, Any]:
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/v1/compliance/scans/runs/{run_id}/summary".format(
+            run_id=quote(str(run_id), safe=""),
+        ),
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> APIResponseModelRunComplianceSummarySchema | None:
+    if response.status_code == 200:
+        response_200 = APIResponseModelRunComplianceSummarySchema.from_dict(response.json())
+
+        return response_200
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[APIResponseModelRunComplianceSummarySchema]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    run_id: str,
+    *,
+    client: AuthenticatedClient,
+) -> Response[APIResponseModelRunComplianceSummarySchema]:
+    """Get compliance summary for a run
+
+
+            Retrieves a compliance summary for a specific StackRun, aggregating
+            data across all scans (STATIC, EVALUATION, RUNTIME) in the run.
+
+            Returns total violations, violations by severity, evidence count,
+            and an average compliance score.
+
+
+    Args:
+        run_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[APIResponseModelRunComplianceSummarySchema]
+    """
+
+    kwargs = _get_kwargs(
+        run_id=run_id,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    run_id: str,
+    *,
+    client: AuthenticatedClient,
+) -> APIResponseModelRunComplianceSummarySchema | None:
+    """Get compliance summary for a run
+
+
+            Retrieves a compliance summary for a specific StackRun, aggregating
+            data across all scans (STATIC, EVALUATION, RUNTIME) in the run.
+
+            Returns total violations, violations by severity, evidence count,
+            and an average compliance score.
+
+
+    Args:
+        run_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        APIResponseModelRunComplianceSummarySchema
+    """
+
+    return sync_detailed(
+        run_id=run_id,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    run_id: str,
+    *,
+    client: AuthenticatedClient,
+) -> Response[APIResponseModelRunComplianceSummarySchema]:
+    """Get compliance summary for a run
+
+
+            Retrieves a compliance summary for a specific StackRun, aggregating
+            data across all scans (STATIC, EVALUATION, RUNTIME) in the run.
+
+            Returns total violations, violations by severity, evidence count,
+            and an average compliance score.
+
+
+    Args:
+        run_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[APIResponseModelRunComplianceSummarySchema]
+    """
+
+    kwargs = _get_kwargs(
+        run_id=run_id,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    run_id: str,
+    *,
+    client: AuthenticatedClient,
+) -> APIResponseModelRunComplianceSummarySchema | None:
+    """Get compliance summary for a run
+
+
+            Retrieves a compliance summary for a specific StackRun, aggregating
+            data across all scans (STATIC, EVALUATION, RUNTIME) in the run.
+
+            Returns total violations, violations by severity, evidence count,
+            and an average compliance score.
+
+
+    Args:
+        run_id (str):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        APIResponseModelRunComplianceSummarySchema
+    """
+
+    return (
+        await asyncio_detailed(
+            run_id=run_id,
+            client=client,
+        )
+    ).parsed

{iltero_cli-0.3.2 → iltero_cli-0.3.3}/iltero/api_client/models/__init__.py

@@ -641,6 +641,10 @@ from .api_response_model_resource_delete_response_schema import APIResponseModel
 from .api_response_model_resource_delete_response_schema_metadata_type_0 import (
     APIResponseModelResourceDeleteResponseSchemaMetadataType0,
 )
+from .api_response_model_run_compliance_summary_schema import APIResponseModelRunComplianceSummarySchema
+from .api_response_model_run_compliance_summary_schema_metadata_type_0 import (
+    APIResponseModelRunComplianceSummarySchemaMetadataType0,
+)
 from .api_response_model_scan_activity_response_schema import APIResponseModelScanActivityResponseSchema
 from .api_response_model_scan_activity_response_schema_metadata_type_0 import (
     APIResponseModelScanActivityResponseSchemaMetadataType0,
@@ -1489,6 +1493,8 @@ from .resource_delete_response_schema import ResourceDeleteResponseSchema
 from .resource_item import ResourceItem
 from .resource_item_metadata import ResourceItemMetadata
 from .rule_content_response import RuleContentResponse
+from .run_compliance_summary_schema import RunComplianceSummarySchema
+from .run_compliance_summary_schema_violations_by_severity import RunComplianceSummarySchemaViolationsBySeverity
 from .runtime_state_data_schema import RuntimeStateDataSchema
 from .runtime_state_data_schema_resource_status import RuntimeStateDataSchemaResourceStatus
 from .scan_activity_item_schema import ScanActivityItemSchema
@@ -2099,6 +2105,8 @@ __all__ = (
     "APIResponseModelRepositoryResponseSchemaMetadataType0",
     "APIResponseModelResourceDeleteResponseSchema",
     "APIResponseModelResourceDeleteResponseSchemaMetadataType0",
+    "APIResponseModelRunComplianceSummarySchema",
+    "APIResponseModelRunComplianceSummarySchemaMetadataType0",
     "APIResponseModelScanActivityResponseSchema",
     "APIResponseModelScanActivityResponseSchemaMetadataType0",
     "APIResponseModelScanListResponseSchema",
@@ -2747,6 +2755,8 @@ __all__ = (
     "ResourceItem",
     "ResourceItemMetadata",
     "RuleContentResponse",
+    "RunComplianceSummarySchema",
+    "RunComplianceSummarySchemaViolationsBySeverity",
     "RuntimeStateDataSchema",
     "RuntimeStateDataSchemaResourceStatus",
     "ScanActivityItemSchema",

iltero_cli-0.3.3/iltero/api_client/models/api_response_model_run_compliance_summary_schema.py

@@ -0,0 +1,187 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, TypeVar, cast
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..types import UNSET, Unset
+
+if TYPE_CHECKING:
+    from ..models.api_response_model_run_compliance_summary_schema_metadata_type_0 import (
+        APIResponseModelRunComplianceSummarySchemaMetadataType0,
+    )
+    from ..models.run_compliance_summary_schema import RunComplianceSummarySchema
+
+
+T = TypeVar("T", bound="APIResponseModelRunComplianceSummarySchema")
+
+
+@_attrs_define
+class APIResponseModelRunComplianceSummarySchema:
+    """
+    Attributes:
+        status (str | Unset):  Default: 'success'.
+        status_code (int | Unset):  Default: 200.
+        data (None | RunComplianceSummarySchema | Unset):
+        message (None | str | Unset):
+        error (None | str | Unset):
+        metadata (APIResponseModelRunComplianceSummarySchemaMetadataType0 | None | Unset):
+    """
+
+    status: str | Unset = "success"
+    status_code: int | Unset = 200
+    data: None | RunComplianceSummarySchema | Unset = UNSET
+    message: None | str | Unset = UNSET
+    error: None | str | Unset = UNSET
+    metadata: APIResponseModelRunComplianceSummarySchemaMetadataType0 | None | Unset = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        from ..models.api_response_model_run_compliance_summary_schema_metadata_type_0 import (
+            APIResponseModelRunComplianceSummarySchemaMetadataType0,
+        )
+        from ..models.run_compliance_summary_schema import RunComplianceSummarySchema
+
+        status = self.status
+
+        status_code = self.status_code
+
+        data: dict[str, Any] | None | Unset
+        if isinstance(self.data, Unset):
+            data = UNSET
+        elif isinstance(self.data, RunComplianceSummarySchema):
+            data = self.data.to_dict()
+        else:
+            data = self.data
+
+        message: None | str | Unset
+        if isinstance(self.message, Unset):
+            message = UNSET
+        else:
+            message = self.message
+
+        error: None | str | Unset
+        if isinstance(self.error, Unset):
+            error = UNSET
+        else:
+            error = self.error
+
+        metadata: dict[str, Any] | None | Unset
+        if isinstance(self.metadata, Unset):
+            metadata = UNSET
+        elif isinstance(self.metadata, APIResponseModelRunComplianceSummarySchemaMetadataType0):
+            metadata = self.metadata.to_dict()
+        else:
+            metadata = self.metadata
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({})
+        if status is not UNSET:
+            field_dict["status"] = status
+        if status_code is not UNSET:
+            field_dict["status_code"] = status_code
+        if data is not UNSET:
+            field_dict["data"] = data
+        if message is not UNSET:
+            field_dict["message"] = message
+        if error is not UNSET:
+            field_dict["error"] = error
+        if metadata is not UNSET:
+            field_dict["metadata"] = metadata
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.api_response_model_run_compliance_summary_schema_metadata_type_0 import (
+            APIResponseModelRunComplianceSummarySchemaMetadataType0,
+        )
+        from ..models.run_compliance_summary_schema import RunComplianceSummarySchema
+
+        d = dict(src_dict)
+        status = d.pop("status", UNSET)
+
+        status_code = d.pop("status_code", UNSET)
+
+        def _parse_data(data: object) -> None | RunComplianceSummarySchema | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, dict):
+                    raise TypeError()
+                data_type_0 = RunComplianceSummarySchema.from_dict(data)
+
+                return data_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(None | RunComplianceSummarySchema | Unset, data)
+
+        data = _parse_data(d.pop("data", UNSET))
+
+        def _parse_message(data: object) -> None | str | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | str | Unset, data)
+
+        message = _parse_message(d.pop("message", UNSET))
+
+        def _parse_error(data: object) -> None | str | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | str | Unset, data)
+
+        error = _parse_error(d.pop("error", UNSET))
+
+        def _parse_metadata(data: object) -> APIResponseModelRunComplianceSummarySchemaMetadataType0 | None | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, dict):
+                    raise TypeError()
+                metadata_type_0 = APIResponseModelRunComplianceSummarySchemaMetadataType0.from_dict(data)
+
+                return metadata_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(APIResponseModelRunComplianceSummarySchemaMetadataType0 | None | Unset, data)
+
+        metadata = _parse_metadata(d.pop("metadata", UNSET))
+
+        api_response_model_run_compliance_summary_schema = cls(
+            status=status,
+            status_code=status_code,
+            data=data,
+            message=message,
+            error=error,
+            metadata=metadata,
+        )
+
+        api_response_model_run_compliance_summary_schema.additional_properties = d
+        return api_response_model_run_compliance_summary_schema
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

iltero_cli-0.3.3/iltero/api_client/models/api_response_model_run_compliance_summary_schema_metadata_type_0.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+T = TypeVar("T", bound="APIResponseModelRunComplianceSummarySchemaMetadataType0")
+
+
+@_attrs_define
+class APIResponseModelRunComplianceSummarySchemaMetadataType0:
+    """ """
+
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        api_response_model_run_compliance_summary_schema_metadata_type_0 = cls()
+
+        api_response_model_run_compliance_summary_schema_metadata_type_0.additional_properties = d
+        return api_response_model_run_compliance_summary_schema_metadata_type_0
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

{iltero_cli-0.3.2 → iltero_cli-0.3.3}/iltero/api_client/models/policy_resolution_request_schema.py

@@ -35,6 +35,8 @@ class PolicyResolutionRequestSchema:
                 Required when template_bundle_id is not provided (attached/brownfield stacks). If provided, only bundles
                 supporting these frameworks are returned. If None and template_bundle_id is set, all bundles from manifest are
                 returned.
+            run_id (None | Unset | UUID): Optional StackRun UUID to link the scan to. If provided, the created scan will be
+                associated with this run.
     """
 
     workspace_id: UUID
@@ -45,6 +47,7 @@ class PolicyResolutionRequestSchema:
     infrastructure_unit: str | Unset = ""
     scan_phase: None | PolicyResolutionRequestSchemaScanPhaseType0 | Unset = UNSET
     frameworks: list[str] | None | Unset = UNSET
+    run_id: None | Unset | UUID = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
@@ -91,6 +94,14 @@ class PolicyResolutionRequestSchema:
         else:
             frameworks = self.frameworks
 
+        run_id: None | str | Unset
+        if isinstance(self.run_id, Unset):
+            run_id = UNSET
+        elif isinstance(self.run_id, UUID):
+            run_id = str(self.run_id)
+        else:
+            run_id = self.run_id
+
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update(
@@ -111,6 +122,8 @@ class PolicyResolutionRequestSchema:
             field_dict["scan_phase"] = scan_phase
         if frameworks is not UNSET:
             field_dict["frameworks"] = frameworks
+        if run_id is not UNSET:
+            field_dict["run_id"] = run_id
 
         return field_dict
 
@@ -193,6 +206,23 @@ class PolicyResolutionRequestSchema:
 
         frameworks = _parse_frameworks(d.pop("frameworks", UNSET))
 
+        def _parse_run_id(data: object) -> None | Unset | UUID:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                run_id_type_0 = UUID(data)
+
+                return run_id_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(None | Unset | UUID, data)
+
+        run_id = _parse_run_id(d.pop("run_id", UNSET))
+
         policy_resolution_request_schema = cls(
             workspace_id=workspace_id,
             environment=environment,
@@ -202,6 +232,7 @@ class PolicyResolutionRequestSchema:
             infrastructure_unit=infrastructure_unit,
             scan_phase=scan_phase,
             frameworks=frameworks,
+            run_id=run_id,
         )
 
         policy_resolution_request_schema.additional_properties = d

{iltero_cli-0.3.2 → iltero_cli-0.3.3}/iltero/api_client/models/policy_resolution_response_schema.py

@@ -47,6 +47,7 @@ class PolicyResolutionResponseSchema:
             tenant_policy_sets (list[TenantPolicySetSchema] | Unset): Tenant-specific PolicySets (Git repos or imported from
                 registry)
             scan_id (None | Unset | UUID): If stack_id provided, scan is created and ID returned
+            run_id (None | Unset | UUID): StackRun UUID the scan is linked to (if run_id was provided in request)
             warnings (list[str] | Unset): Any non-fatal warnings during resolution
             frameworks_resolved (list[str] | Unset): Frameworks that were resolved (from request or all from manifest)
             framework_bundle_map (PolicyResolutionResponseSchemaFrameworkBundleMap | Unset): Mapping of frameworks to policy
@@ -61,6 +62,7 @@ class PolicyResolutionResponseSchema:
     stack_metadata: None | PolicyResolutionResponseSchemaStackMetadataType0 | Unset = UNSET
     tenant_policy_sets: list[TenantPolicySetSchema] | Unset = UNSET
     scan_id: None | Unset | UUID = UNSET
+    run_id: None | Unset | UUID = UNSET
     warnings: list[str] | Unset = UNSET
     frameworks_resolved: list[str] | Unset = UNSET
     framework_bundle_map: PolicyResolutionResponseSchemaFrameworkBundleMap | Unset = UNSET
@@ -112,6 +114,14 @@ class PolicyResolutionResponseSchema:
         else:
             scan_id = self.scan_id
 
+        run_id: None | str | Unset
+        if isinstance(self.run_id, Unset):
+            run_id = UNSET
+        elif isinstance(self.run_id, UUID):
+            run_id = str(self.run_id)
+        else:
+            run_id = self.run_id
+
         warnings: list[str] | Unset = UNSET
         if not isinstance(self.warnings, Unset):
             warnings = self.warnings
@@ -152,6 +162,8 @@ class PolicyResolutionResponseSchema:
             field_dict["tenant_policy_sets"] = tenant_policy_sets
         if scan_id is not UNSET:
             field_dict["scan_id"] = scan_id
+        if run_id is not UNSET:
+            field_dict["run_id"] = run_id
         if warnings is not UNSET:
             field_dict["warnings"] = warnings
         if frameworks_resolved is not UNSET:
@@ -248,6 +260,23 @@ class PolicyResolutionResponseSchema:
 
         scan_id = _parse_scan_id(d.pop("scan_id", UNSET))
 
+        def _parse_run_id(data: object) -> None | Unset | UUID:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            try:
+                if not isinstance(data, str):
+                    raise TypeError()
+                run_id_type_0 = UUID(data)
+
+                return run_id_type_0
+            except (TypeError, ValueError, AttributeError, KeyError):
+                pass
+            return cast(None | Unset | UUID, data)
+
+        run_id = _parse_run_id(d.pop("run_id", UNSET))
+
         warnings = cast(list[str], d.pop("warnings", UNSET))
 
         frameworks_resolved = cast(list[str], d.pop("frameworks_resolved", UNSET))
@@ -284,6 +313,7 @@ class PolicyResolutionResponseSchema:
             stack_metadata=stack_metadata,
             tenant_policy_sets=tenant_policy_sets,
             scan_id=scan_id,
+            run_id=run_id,
             warnings=warnings,
             frameworks_resolved=frameworks_resolved,
             framework_bundle_map=framework_bundle_map,