capo-devops-agent 0.1.0__py3-none-any.whl

capo_devops_agent/types/user_message_block.py

@@ -0,0 +1,37 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#UserMessageBlock``."""
+
+from typing import TypeAlias
+
+from typing_extensions import TypedDict
+
+from capo_devops_agent.errors import DeserializationError, SerializationError
+
+
+class _UserMessageBlock_text(TypedDict, closed=True):
+    text: "str"
+
+
+class _UserMessageBlock_toolResult(TypedDict, closed=True):
+    toolResult: "object"
+
+
+UserMessageBlock: TypeAlias = _UserMessageBlock_text | _UserMessageBlock_toolResult
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: UserMessageBlock) -> dict:
+    if "text" in value:
+        return {"text": value["text"]}
+    elif "toolResult" in value:
+        return {"toolResult": value["toolResult"]}
+    else:
+        raise SerializationError("UserMessageBlock: no variant present")
+
+
+def deserialize_json(data: dict) -> UserMessageBlock:
+    if data.get("text") is not None:
+        return {"text": data["text"]}
+    elif data.get("toolResult") is not None:
+        return {"toolResult": data["toolResult"]}
+    else:
+        raise DeserializationError("UserMessageBlock: no recognized variant key")

capo_devops_agent/types/user_reference.py

@@ -0,0 +1,46 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#UserReference``."""
+
+from typing import TYPE_CHECKING
+
+from typing_extensions import TypedDict
+
+from capo_devops_agent.errors import DeserializationError
+
+if TYPE_CHECKING:
+    import capo_devops_agent.types.user_type
+
+
+class UserReference(TypedDict, closed=True):
+    user_id: "str"
+    """<p>The unique identifier for the user</p>"""
+    user_type: "capo_devops_agent.types.user_type.UserType"
+    """<p>The type of user</p>"""
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: UserReference) -> dict:
+    out: dict = {}
+    out["userId"] = value["user_id"]
+    import capo_devops_agent.types.user_type
+
+    out["userType"] = capo_devops_agent.types.user_type.serialize_json(
+        value["user_type"]
+    )
+    return out
+
+
+def deserialize_json(data: dict) -> UserReference:
+    out: UserReference = {}  # type: ignore[typeddict-item]
+    if data.get("userId") is not None:
+        out["user_id"] = data["userId"]
+    else:
+        raise DeserializationError("UserReference.user_id required")
+    if data.get("userType") is not None:
+        import capo_devops_agent.types.user_type
+
+        out["user_type"] = capo_devops_agent.types.user_type.deserialize_json(
+            data["userType"]
+        )
+    else:
+        raise DeserializationError("UserReference.user_type required")
+    return out

capo_devops_agent/types/user_type.py

@@ -0,0 +1,19 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#UserType``."""
+
+from typing import Literal, TypeAlias, cast
+
+"""<p>Types of users in the system</p>"""
+UserType: TypeAlias = Literal[
+    "IAM",
+    "IDC",
+    "IDP",
+]
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: UserType) -> str:
+    return value
+
+
+def deserialize_json(data: str) -> UserType:
+    return cast(UserType, data)

capo_devops_agent/types/validate_aws_associations_input.py

@@ -0,0 +1,24 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#ValidateAwsAssociationsInput``."""
+
+from typing import TYPE_CHECKING
+
+from typing_extensions import TypedDict
+
+if TYPE_CHECKING:
+    import capo_devops_agent.types.agent_space_id
+
+
+class ValidateAwsAssociationsInput(TypedDict, closed=True):
+    agent_space_id: "capo_devops_agent.types.agent_space_id.AgentSpaceId"
+    """<p>The unique identifier of the AgentSpace</p>"""
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: ValidateAwsAssociationsInput) -> dict:
+    out: dict = {}
+    return out
+
+
+def deserialize_json(data: dict) -> ValidateAwsAssociationsInput:
+    out: ValidateAwsAssociationsInput = {}  # type: ignore[typeddict-item]
+    return out

capo_devops_agent/types/validate_aws_associations_output.py

@@ -0,0 +1,18 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#ValidateAwsAssociationsOutput``."""
+
+from typing_extensions import TypedDict
+
+
+class ValidateAwsAssociationsOutput(TypedDict, closed=True):
+    pass
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: ValidateAwsAssociationsOutput) -> dict:
+    out: dict = {}
+    return out
+
+
+def deserialize_json(data: dict) -> ValidateAwsAssociationsOutput:
+    out: ValidateAwsAssociationsOutput = {}  # type: ignore[typeddict-item]
+    return out

capo_devops_agent/types/validation_exception_field.py

@@ -0,0 +1,33 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#ValidationExceptionField``."""
+
+from typing_extensions import TypedDict
+
+from capo_devops_agent.errors import DeserializationError
+
+
+class ValidationExceptionField(TypedDict, closed=True):
+    path: "str"
+    """<p>A JSONPointer expression to the structure member whose value failed to satisfy the modeled constraints.</p>"""
+    message: "str"
+    """<p>A detailed description of the validation failure.</p>"""
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: ValidationExceptionField) -> dict:
+    out: dict = {}
+    out["path"] = value["path"]
+    out["message"] = value["message"]
+    return out
+
+
+def deserialize_json(data: dict) -> ValidationExceptionField:
+    out: ValidationExceptionField = {}  # type: ignore[typeddict-item]
+    if data.get("path") is not None:
+        out["path"] = data["path"]
+    else:
+        raise DeserializationError("ValidationExceptionField.path required")
+    if data.get("message") is not None:
+        out["message"] = data["message"]
+    else:
+        raise DeserializationError("ValidationExceptionField.message required")
+    return out

capo_devops_agent/types/validation_exception_field_list.py

@@ -0,0 +1,35 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#ValidationExceptionFieldList``."""
+
+from typing import TYPE_CHECKING, TypeAlias
+
+if TYPE_CHECKING:
+    import capo_devops_agent.types.validation_exception_field
+
+ValidationExceptionFieldList: TypeAlias = list[
+    "capo_devops_agent.types.validation_exception_field.ValidationExceptionField"
+]
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: ValidationExceptionFieldList) -> list:
+    import capo_devops_agent.types.validation_exception_field
+
+    out: list = []
+    for item in value:
+        out.append(
+            capo_devops_agent.types.validation_exception_field.serialize_json(item)
+        )
+    return out
+
+
+def deserialize_json(data: list) -> ValidationExceptionFieldList:
+    import capo_devops_agent.types.validation_exception_field
+
+    out: ValidationExceptionFieldList = []
+    for item in data:
+        if item is None:
+            continue
+        out.append(
+            capo_devops_agent.types.validation_exception_field.deserialize_json(item)
+        )
+    return out

capo_devops_agent/types/validation_status.py

@@ -0,0 +1,19 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#ValidationStatus``."""
+
+from typing import Literal, TypeAlias, cast
+
+"""<p>Represents the validation state of an association.</p>"""
+ValidationStatus: TypeAlias = Literal[
+    "valid",
+    "invalid",
+    "pending-confirmation",
+]
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: ValidationStatus) -> str:
+    return value
+
+
+def deserialize_json(data: str) -> ValidationStatus:
+    return cast(ValidationStatus, data)

capo_devops_agent/types/vpc_id.py

@@ -0,0 +1,6 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#VpcId``."""
+
+from typing import TypeAlias
+
+"""<p>VPC identifier.</p>"""
+VpcId: TypeAlias = str

capo_devops_agent/types/web_identity_token_audience_list.py

@@ -0,0 +1,14 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#WebIdentityTokenAudienceList``."""
+
+from typing import TypeAlias
+
+WebIdentityTokenAudienceList: TypeAlias = list["str"]
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: WebIdentityTokenAudienceList) -> list:
+    return list(value)
+
+
+def deserialize_json(data: list) -> WebIdentityTokenAudienceList:
+    return [item for item in data if item is not None]

capo_devops_agent/types/webhook.py

@@ -0,0 +1,52 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#Webhook``."""
+
+from typing import TYPE_CHECKING
+
+from typing_extensions import NotRequired, TypedDict
+
+from capo_devops_agent.errors import DeserializationError
+
+if TYPE_CHECKING:
+    import capo_devops_agent.types.webhook_type
+
+
+class Webhook(TypedDict, closed=True):
+    webhook_url: "str"
+    """<p>Webhook endpoint URL.</p>"""
+    webhook_type: NotRequired["capo_devops_agent.types.webhook_type.WebhookType"]
+    """<p>Webhook authentication type.</p>"""
+    webhook_id: "str"
+    """<p>The unique identifier of the Webhook</p>"""
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: Webhook) -> dict:
+    out: dict = {}
+    out["webhookUrl"] = value["webhook_url"]
+    if "webhook_type" in value:
+        import capo_devops_agent.types.webhook_type
+
+        out["webhookType"] = capo_devops_agent.types.webhook_type.serialize_json(
+            value["webhook_type"]
+        )
+    out["webhookId"] = value["webhook_id"]
+    return out
+
+
+def deserialize_json(data: dict) -> Webhook:
+    out: Webhook = {}  # type: ignore[typeddict-item]
+    if data.get("webhookUrl") is not None:
+        out["webhook_url"] = data["webhookUrl"]
+    else:
+        raise DeserializationError("Webhook.webhook_url required")
+    if data.get("webhookType") is not None:
+        import capo_devops_agent.types.webhook_type
+
+        out["webhook_type"] = capo_devops_agent.types.webhook_type.deserialize_json(
+            data["webhookType"]
+        )
+    if data.get("webhookId") is not None:
+        out["webhook_id"] = data["webhookId"]
+    else:
+        raise DeserializationError("Webhook.webhook_id required")
+    return out

capo_devops_agent/types/webhook_secret.py

@@ -0,0 +1,6 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#WebhookSecret``."""
+
+from typing import TypeAlias
+
+"""<p>Webhook secret for secure webhook communication.</p>"""
+WebhookSecret: TypeAlias = str

capo_devops_agent/types/webhook_type.py

@@ -0,0 +1,20 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#WebhookType``."""
+
+from typing import Literal, TypeAlias, cast
+
+"""<p>Webhook authentication type.</p>"""
+WebhookType: TypeAlias = Literal[
+    "hmac",
+    "apikey",
+    "gitlab",
+    "pagerduty",
+]
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: WebhookType) -> str:
+    return value
+
+
+def deserialize_json(data: str) -> WebhookType:
+    return cast(WebhookType, data)

capo_devops_agent/types/webhooks_list.py

@@ -0,0 +1,29 @@
+"""Generated from Smithy shape ``com.amazonaws.devopsagent#WebhooksList``."""
+
+from typing import TYPE_CHECKING, TypeAlias
+
+if TYPE_CHECKING:
+    import capo_devops_agent.types.webhook
+
+WebhooksList: TypeAlias = list["capo_devops_agent.types.webhook.Webhook"]
+
+
+# --- restJson1 ser/de ---
+def serialize_json(value: WebhooksList) -> list:
+    import capo_devops_agent.types.webhook
+
+    out: list = []
+    for item in value:
+        out.append(capo_devops_agent.types.webhook.serialize_json(item))
+    return out
+
+
+def deserialize_json(data: list) -> WebhooksList:
+    import capo_devops_agent.types.webhook
+
+    out: WebhooksList = []
+    for item in data:
+        if item is None:
+            continue
+        out.append(capo_devops_agent.types.webhook.deserialize_json(item))
+    return out

capo_devops_agent-0.1.0.dist-info/METADATA

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: capo-devops-agent
+Version: 0.1.0
+Summary: Python SDK for Devops Agent.
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: zapros>=0.13.0
+Provides-Extra: sso
+Requires-Dist: capo-sso>=0.2.0; extra == "sso"
+Requires-Dist: capo-sso-oidc>=0.2.0; extra == "sso"
+Requires-Dist: capo-sts>=0.3.0; extra == "sso"
+Dynamic: license-file
+
+# Getting Started
+
+## Installation
+
+```
+pip install capo-devops-agent
+```
+
+## Usage
+
+```python
+from capo_devops_agent import AsyncDevOpsAgentClient
+
+
+async def main():
+    async with AsyncDevOpsAgentClient() as dev_ops_agent:
+        # Example: call the create_asset operation
+        response = await dev_ops_agent.create_asset()
+        print(response["asset"])
+```
+
+## Pagination
+
+Some operations in this SDK support pagination. If the operation supports pagination it will have an `iter_` prefixed method that returns an async iterator.
+
+```python
+from capo_devops_agent import AsyncDevOpsAgentClient
+
+
+async def main():
+    async with AsyncDevOpsAgentClient() as dev_ops_agent:
+        # Example: paginate over list_asset_files
+        async for item in dev_ops_agent.iter_list_asset_files():
+            print(item)
+```
+
+## Error Handling
+
+The SDK raises exceptions for errors returned by the API. Catch them to handle failures gracefully.
+
+```python
+from capo_devops_agent import AsyncDevOpsAgentClient
+from capo_devops_agent.error import AccessDeniedException
+
+
+async def main():
+    async with AsyncDevOpsAgentClient() as dev_ops_agent:
+        try:
+            await dev_ops_agent.create_asset()
+        except AccessDeniedException as e:
+            print(f"Error: {e}")
+            print(e.data)  # additional error data
+```
+
+## Retrying
+
+The SDK retries failed operations automatically. Retry behaviour follows the Smithy specification: errors are retried based on their `is_retryable` and `is_throttling_error` attributes. Throttling errors use a longer base delay. Network-level failures (connection errors and timeouts) are also retried. Non-retryable errors, such as client errors without the `@retryable` trait, are raised immediately without further attempts.
+
+The number of attempts defaults to 3 and can be changed at the client level via `retry_max_attempts`, or per call via `config_overrides`.
+
+```python
+from capo_devops_agent import AsyncDevOpsAgentClient
+
+
+async def main():
+    async with AsyncDevOpsAgentClient() as dev_ops_agent:
+        # Default: 3 attempts for every operation
+        response = await dev_ops_agent.create_asset()
+
+        # Override per operation
+        response = await dev_ops_agent.create_asset(config_overrides={"retry_max_attempts": 5})
+
+        # Disable retries for this call
+        response = await dev_ops_agent.create_asset(config_overrides={"retry_max_attempts": 1})
+```