daytona_api_client_async 0.21.3a0__py3-none-any.whl

daytona_api_client_async/exceptions.py

@@ -0,0 +1,217 @@
+# coding: utf-8
+
+"""
+    Daytona
+
+    Daytona AI platform API Docs
+
+    The version of the OpenAPI document: 1.0
+    Contact: support@daytona.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+from typing import Any, Optional
+from typing_extensions import Self
+
+class OpenApiException(Exception):
+    """The base exception class for all OpenAPIExceptions"""
+
+
+class ApiTypeError(OpenApiException, TypeError):
+    def __init__(self, msg, path_to_item=None, valid_classes=None,
+                 key_type=None) -> None:
+        """ Raises an exception for TypeErrors
+
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (list): a list of keys an indices to get to the
+                                 current_item
+                                 None if unset
+            valid_classes (tuple): the primitive classes that current item
+                                   should be an instance of
+                                   None if unset
+            key_type (bool): False if our value is a value in a dict
+                             True if it is a key in a dict
+                             False if our item is an item in a list
+                             None if unset
+        """
+        self.path_to_item = path_to_item
+        self.valid_classes = valid_classes
+        self.key_type = key_type
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiTypeError, self).__init__(full_msg)
+
+
+class ApiValueError(OpenApiException, ValueError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (list) the path to the exception in the
+                received_data dict. None if unset
+        """
+
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiValueError, self).__init__(full_msg)
+
+
+class ApiAttributeError(OpenApiException, AttributeError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Raised when an attribute reference or assignment fails.
+
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (None/list) the path to the exception in the
+                received_data dict
+        """
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiAttributeError, self).__init__(full_msg)
+
+
+class ApiKeyError(OpenApiException, KeyError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (None/list) the path to the exception in the
+                received_data dict
+        """
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiKeyError, self).__init__(full_msg)
+
+
+class ApiException(OpenApiException):
+
+    def __init__(
+        self, 
+        status=None, 
+        reason=None, 
+        http_resp=None,
+        *,
+        body: Optional[str] = None,
+        data: Optional[Any] = None,
+    ) -> None:
+        self.status = status
+        self.reason = reason
+        self.body = body
+        self.data = data
+        self.headers = None
+
+        if http_resp:
+            if self.status is None:
+                self.status = http_resp.status
+            if self.reason is None:
+                self.reason = http_resp.reason
+            if self.body is None:
+                try:
+                    self.body = http_resp.data.decode('utf-8')
+                except Exception:
+                    pass
+            self.headers = http_resp.getheaders()
+
+    @classmethod
+    def from_response(
+        cls, 
+        *, 
+        http_resp, 
+        body: Optional[str], 
+        data: Optional[Any],
+    ) -> Self:
+        if http_resp.status == 400:
+            raise BadRequestException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 401:
+            raise UnauthorizedException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 403:
+            raise ForbiddenException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 404:
+            raise NotFoundException(http_resp=http_resp, body=body, data=data)
+
+        # Added new conditions for 409 and 422
+        if http_resp.status == 409:
+            raise ConflictException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 422:
+            raise UnprocessableEntityException(http_resp=http_resp, body=body, data=data)
+
+        if 500 <= http_resp.status <= 599:
+            raise ServiceException(http_resp=http_resp, body=body, data=data)
+        raise ApiException(http_resp=http_resp, body=body, data=data)
+
+    def __str__(self):
+        """Custom error messages for exception"""
+        error_message = "({0})\n"\
+                        "Reason: {1}\n".format(self.status, self.reason)
+        if self.headers:
+            error_message += "HTTP response headers: {0}\n".format(
+                self.headers)
+
+        if self.data or self.body:
+            error_message += "HTTP response body: {0}\n".format(self.data or self.body)
+
+        return error_message
+
+
+class BadRequestException(ApiException):
+    pass
+
+
+class NotFoundException(ApiException):
+    pass
+
+
+class UnauthorizedException(ApiException):
+    pass
+
+
+class ForbiddenException(ApiException):
+    pass
+
+
+class ServiceException(ApiException):
+    pass
+
+
+class ConflictException(ApiException):
+    """Exception for HTTP 409 Conflict."""
+    pass
+
+
+class UnprocessableEntityException(ApiException):
+    """Exception for HTTP 422 Unprocessable Entity."""
+    pass
+
+
+def render_path(path_to_item):
+    """Returns a string representation of a path"""
+    result = ""
+    for pth in path_to_item:
+        if isinstance(pth, int):
+            result += "[{0}]".format(pth)
+        else:
+            result += "['{0}']".format(pth)
+    return result

daytona_api_client_async/models/__init__.py

@@ -0,0 +1,101 @@
+# coding: utf-8
+
+# flake8: noqa
+"""
+    Daytona
+
+    Daytona AI platform API Docs
+
+    The version of the OpenAPI document: 1.0
+    Contact: support@daytona.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+# import models into model package
+from daytona_api_client_async.models.account_provider import AccountProvider
+from daytona_api_client_async.models.api_key_list import ApiKeyList
+from daytona_api_client_async.models.api_key_response import ApiKeyResponse
+from daytona_api_client_async.models.build_info import BuildInfo
+from daytona_api_client_async.models.command import Command
+from daytona_api_client_async.models.completion_context import CompletionContext
+from daytona_api_client_async.models.completion_item import CompletionItem
+from daytona_api_client_async.models.completion_list import CompletionList
+from daytona_api_client_async.models.create_api_key import CreateApiKey
+from daytona_api_client_async.models.create_build_info import CreateBuildInfo
+from daytona_api_client_async.models.create_docker_registry import CreateDockerRegistry
+from daytona_api_client_async.models.create_linked_account import CreateLinkedAccount
+from daytona_api_client_async.models.create_organization import CreateOrganization
+from daytona_api_client_async.models.create_organization_invitation import CreateOrganizationInvitation
+from daytona_api_client_async.models.create_organization_quota import CreateOrganizationQuota
+from daytona_api_client_async.models.create_organization_role import CreateOrganizationRole
+from daytona_api_client_async.models.create_runner import CreateRunner
+from daytona_api_client_async.models.create_sandbox import CreateSandbox
+from daytona_api_client_async.models.create_session_request import CreateSessionRequest
+from daytona_api_client_async.models.create_snapshot import CreateSnapshot
+from daytona_api_client_async.models.create_user import CreateUser
+from daytona_api_client_async.models.create_volume import CreateVolume
+from daytona_api_client_async.models.create_workspace import CreateWorkspace
+from daytona_api_client_async.models.docker_registry import DockerRegistry
+from daytona_api_client_async.models.execute_request import ExecuteRequest
+from daytona_api_client_async.models.execute_response import ExecuteResponse
+from daytona_api_client_async.models.file_info import FileInfo
+from daytona_api_client_async.models.file_status import FileStatus
+from daytona_api_client_async.models.git_add_request import GitAddRequest
+from daytona_api_client_async.models.git_branch_request import GitBranchRequest
+from daytona_api_client_async.models.git_checkout_request import GitCheckoutRequest
+from daytona_api_client_async.models.git_clone_request import GitCloneRequest
+from daytona_api_client_async.models.git_commit_info import GitCommitInfo
+from daytona_api_client_async.models.git_commit_request import GitCommitRequest
+from daytona_api_client_async.models.git_commit_response import GitCommitResponse
+from daytona_api_client_async.models.git_delete_branch_request import GitDeleteBranchRequest
+from daytona_api_client_async.models.git_repo_request import GitRepoRequest
+from daytona_api_client_async.models.git_status import GitStatus
+from daytona_api_client_async.models.list_branch_response import ListBranchResponse
+from daytona_api_client_async.models.lsp_completion_params import LspCompletionParams
+from daytona_api_client_async.models.lsp_document_request import LspDocumentRequest
+from daytona_api_client_async.models.lsp_location import LspLocation
+from daytona_api_client_async.models.lsp_server_request import LspServerRequest
+from daytona_api_client_async.models.lsp_symbol import LspSymbol
+from daytona_api_client_async.models.match import Match
+from daytona_api_client_async.models.organization import Organization
+from daytona_api_client_async.models.organization_invitation import OrganizationInvitation
+from daytona_api_client_async.models.organization_role import OrganizationRole
+from daytona_api_client_async.models.organization_suspension import OrganizationSuspension
+from daytona_api_client_async.models.organization_user import OrganizationUser
+from daytona_api_client_async.models.paginated_snapshots_dto import PaginatedSnapshotsDto
+from daytona_api_client_async.models.port_preview_url import PortPreviewUrl
+from daytona_api_client_async.models.position import Position
+from daytona_api_client_async.models.project_dir_response import ProjectDirResponse
+from daytona_api_client_async.models.range import Range
+from daytona_api_client_async.models.registry_push_access_dto import RegistryPushAccessDto
+from daytona_api_client_async.models.replace_request import ReplaceRequest
+from daytona_api_client_async.models.replace_result import ReplaceResult
+from daytona_api_client_async.models.sandbox import Sandbox
+from daytona_api_client_async.models.sandbox_info import SandboxInfo
+from daytona_api_client_async.models.sandbox_labels import SandboxLabels
+from daytona_api_client_async.models.sandbox_state import SandboxState
+from daytona_api_client_async.models.sandbox_volume import SandboxVolume
+from daytona_api_client_async.models.search_files_response import SearchFilesResponse
+from daytona_api_client_async.models.session import Session
+from daytona_api_client_async.models.session_execute_request import SessionExecuteRequest
+from daytona_api_client_async.models.session_execute_response import SessionExecuteResponse
+from daytona_api_client_async.models.set_snapshot_general_status_dto import SetSnapshotGeneralStatusDto
+from daytona_api_client_async.models.snapshot_dto import SnapshotDto
+from daytona_api_client_async.models.snapshot_state import SnapshotState
+from daytona_api_client_async.models.storage_access_dto import StorageAccessDto
+from daytona_api_client_async.models.toggle_state import ToggleState
+from daytona_api_client_async.models.update_assigned_organization_roles import UpdateAssignedOrganizationRoles
+from daytona_api_client_async.models.update_docker_registry import UpdateDockerRegistry
+from daytona_api_client_async.models.update_organization_invitation import UpdateOrganizationInvitation
+from daytona_api_client_async.models.update_organization_member_role import UpdateOrganizationMemberRole
+from daytona_api_client_async.models.update_organization_quota import UpdateOrganizationQuota
+from daytona_api_client_async.models.update_organization_role import UpdateOrganizationRole
+from daytona_api_client_async.models.usage_overview import UsageOverview
+from daytona_api_client_async.models.user import User
+from daytona_api_client_async.models.user_public_key import UserPublicKey
+from daytona_api_client_async.models.volume_dto import VolumeDto
+from daytona_api_client_async.models.volume_state import VolumeState
+from daytona_api_client_async.models.workspace import Workspace

daytona_api_client_async/models/account_provider.py

@@ -0,0 +1,103 @@
+# coding: utf-8
+
+"""
+    Daytona
+
+    Daytona AI platform API Docs
+
+    The version of the OpenAPI document: 1.0
+    Contact: support@daytona.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List
+from typing import Optional, Set
+from typing_extensions import Self
+
+class AccountProvider(BaseModel):
+    """
+    AccountProvider
+    """ # noqa: E501
+    name: StrictStr
+    display_name: StrictStr = Field(alias="displayName")
+    additional_properties: Dict[str, Any] = {}
+    __properties: ClassVar[List[str]] = ["name", "displayName"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of AccountProvider from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        * Fields in `self.additional_properties` are added to the output dict.
+        """
+        excluded_fields: Set[str] = set([
+            "additional_properties",
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # puts key-value pairs in additional_properties in the top level
+        if self.additional_properties is not None:
+            for _key, _value in self.additional_properties.items():
+                _dict[_key] = _value
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of AccountProvider from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "name": obj.get("name"),
+            "displayName": obj.get("displayName")
+        })
+        # store additional fields in additional_properties
+        for _key in obj.keys():
+            if _key not in cls.__properties:
+                _obj.additional_properties[_key] = obj.get(_key)
+
+        return _obj
+
+

daytona_api_client_async/models/api_key_list.py

@@ -0,0 +1,130 @@
+# coding: utf-8
+
+"""
+    Daytona
+
+    Daytona AI platform API Docs
+
+    The version of the OpenAPI document: 1.0
+    Contact: support@daytona.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ApiKeyList(BaseModel):
+    """
+    ApiKeyList
+    """ # noqa: E501
+    name: StrictStr = Field(description="The name of the API key")
+    value: StrictStr = Field(description="The masked API key value")
+    created_at: datetime = Field(description="When the API key was created", alias="createdAt")
+    permissions: List[StrictStr] = Field(description="The list of organization resource permissions assigned to the API key")
+    last_used_at: Optional[datetime] = Field(description="When the API key was last used", alias="lastUsedAt")
+    expires_at: Optional[datetime] = Field(description="When the API key expires", alias="expiresAt")
+    additional_properties: Dict[str, Any] = {}
+    __properties: ClassVar[List[str]] = ["name", "value", "createdAt", "permissions", "lastUsedAt", "expiresAt"]
+
+    @field_validator('permissions')
+    def permissions_validate_enum(cls, value):
+        """Validates the enum"""
+        for i in value:
+            if i not in set(['write:registries', 'delete:registries', 'write:snapshots', 'delete:snapshots', 'write:sandboxes', 'delete:sandboxes', 'read:volumes', 'write:volumes', 'delete:volumes']):
+                raise ValueError("each list item must be one of ('write:registries', 'delete:registries', 'write:snapshots', 'delete:snapshots', 'write:sandboxes', 'delete:sandboxes', 'read:volumes', 'write:volumes', 'delete:volumes')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ApiKeyList from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        * Fields in `self.additional_properties` are added to the output dict.
+        """
+        excluded_fields: Set[str] = set([
+            "additional_properties",
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # puts key-value pairs in additional_properties in the top level
+        if self.additional_properties is not None:
+            for _key, _value in self.additional_properties.items():
+                _dict[_key] = _value
+
+        # set to None if last_used_at (nullable) is None
+        # and model_fields_set contains the field
+        if self.last_used_at is None and "last_used_at" in self.model_fields_set:
+            _dict['lastUsedAt'] = None
+
+        # set to None if expires_at (nullable) is None
+        # and model_fields_set contains the field
+        if self.expires_at is None and "expires_at" in self.model_fields_set:
+            _dict['expiresAt'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ApiKeyList from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "name": obj.get("name"),
+            "value": obj.get("value"),
+            "createdAt": obj.get("createdAt"),
+            "permissions": obj.get("permissions"),
+            "lastUsedAt": obj.get("lastUsedAt"),
+            "expiresAt": obj.get("expiresAt")
+        })
+        # store additional fields in additional_properties
+        for _key in obj.keys():
+            if _key not in cls.__properties:
+                _obj.additional_properties[_key] = obj.get(_key)
+
+        return _obj
+
+

daytona_api_client_async/models/api_key_response.py

@@ -0,0 +1,123 @@
+# coding: utf-8
+
+"""
+    Daytona
+
+    Daytona AI platform API Docs
+
+    The version of the OpenAPI document: 1.0
+    Contact: support@daytona.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ApiKeyResponse(BaseModel):
+    """
+    ApiKeyResponse
+    """ # noqa: E501
+    name: StrictStr = Field(description="The name of the API key")
+    value: StrictStr = Field(description="The API key value")
+    created_at: datetime = Field(description="When the API key was created", alias="createdAt")
+    permissions: List[StrictStr] = Field(description="The list of organization resource permissions assigned to the API key")
+    expires_at: Optional[datetime] = Field(description="When the API key expires", alias="expiresAt")
+    additional_properties: Dict[str, Any] = {}
+    __properties: ClassVar[List[str]] = ["name", "value", "createdAt", "permissions", "expiresAt"]
+
+    @field_validator('permissions')
+    def permissions_validate_enum(cls, value):
+        """Validates the enum"""
+        for i in value:
+            if i not in set(['write:registries', 'delete:registries', 'write:snapshots', 'delete:snapshots', 'write:sandboxes', 'delete:sandboxes', 'read:volumes', 'write:volumes', 'delete:volumes']):
+                raise ValueError("each list item must be one of ('write:registries', 'delete:registries', 'write:snapshots', 'delete:snapshots', 'write:sandboxes', 'delete:sandboxes', 'read:volumes', 'write:volumes', 'delete:volumes')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ApiKeyResponse from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        * Fields in `self.additional_properties` are added to the output dict.
+        """
+        excluded_fields: Set[str] = set([
+            "additional_properties",
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # puts key-value pairs in additional_properties in the top level
+        if self.additional_properties is not None:
+            for _key, _value in self.additional_properties.items():
+                _dict[_key] = _value
+
+        # set to None if expires_at (nullable) is None
+        # and model_fields_set contains the field
+        if self.expires_at is None and "expires_at" in self.model_fields_set:
+            _dict['expiresAt'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ApiKeyResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "name": obj.get("name"),
+            "value": obj.get("value"),
+            "createdAt": obj.get("createdAt"),
+            "permissions": obj.get("permissions"),
+            "expiresAt": obj.get("expiresAt")
+        })
+        # store additional fields in additional_properties
+        for _key in obj.keys():
+            if _key not in cls.__properties:
+                _obj.additional_properties[_key] = obj.get(_key)
+
+        return _obj
+
+