docspring 3.1.0__py3-none-any.whl

docspring/exceptions.py

@@ -0,0 +1,217 @@
+# coding: utf-8
+
+"""
+    DocSpring API
+
+    Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+
+    The version of the OpenAPI document: v1
+    Contact: support@docspring.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

docspring/models/__init__.py

@@ -0,0 +1,146 @@
+# coding: utf-8
+
+# flake8: noqa
+"""
+    DocSpring API
+
+    Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+
+    The version of the OpenAPI document: v1
+    Contact: support@docspring.com
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+if __import__("typing").TYPE_CHECKING:
+    # import models into model package
+    from docspring.models.add_fields_data import AddFieldsData
+    from docspring.models.batch_generate_pdfs201_response import BatchGeneratePdfs201Response
+    from docspring.models.combine_pdfs_data import CombinePdfsData
+    from docspring.models.combined_submission import CombinedSubmission
+    from docspring.models.combined_submission_action import CombinedSubmissionAction
+    from docspring.models.copy_template_options import CopyTemplateOptions
+    from docspring.models.create_combined_submission_response import CreateCombinedSubmissionResponse
+    from docspring.models.create_custom_file_data import CreateCustomFileData
+    from docspring.models.create_custom_file_response import CreateCustomFileResponse
+    from docspring.models.create_folder_data import CreateFolderData
+    from docspring.models.create_html_template import CreateHtmlTemplate
+    from docspring.models.create_pdf_submission_data import CreatePdfSubmissionData
+    from docspring.models.create_pdf_template import CreatePdfTemplate
+    from docspring.models.create_submission_data_request_data import CreateSubmissionDataRequestData
+    from docspring.models.create_submission_data_request_event_request import CreateSubmissionDataRequestEventRequest
+    from docspring.models.create_submission_data_request_event_response import CreateSubmissionDataRequestEventResponse
+    from docspring.models.create_submission_data_request_response import CreateSubmissionDataRequestResponse
+    from docspring.models.create_submission_data_request_token_response import CreateSubmissionDataRequestTokenResponse
+    from docspring.models.create_submission_response import CreateSubmissionResponse
+    from docspring.models.create_webhook_data import CreateWebhookData
+    from docspring.models.custom_file import CustomFile
+    from docspring.models.error_or_multiple_errors_response import ErrorOrMultipleErrorsResponse
+    from docspring.models.error_response import ErrorResponse
+    from docspring.models.folder import Folder
+    from docspring.models.json_schema import JsonSchema
+    from docspring.models.list_submissions_response import ListSubmissionsResponse
+    from docspring.models.move_folder_data import MoveFolderData
+    from docspring.models.move_template_data import MoveTemplateData
+    from docspring.models.multiple_errors_response import MultipleErrorsResponse
+    from docspring.models.publish_version_data import PublishVersionData
+    from docspring.models.rename_folder_data import RenameFolderData
+    from docspring.models.restore_version_data import RestoreVersionData
+    from docspring.models.submission import Submission
+    from docspring.models.submission422_response import Submission422Response
+    from docspring.models.submission_action import SubmissionAction
+    from docspring.models.submission_batch import SubmissionBatch
+    from docspring.models.submission_batch_data import SubmissionBatchData
+    from docspring.models.submission_batch_with_submissions import SubmissionBatchWithSubmissions
+    from docspring.models.submission_data_request import SubmissionDataRequest
+    from docspring.models.submission_data_request_event import SubmissionDataRequestEvent
+    from docspring.models.submission_data_request_show import SubmissionDataRequestShow
+    from docspring.models.submission_data_request_token import SubmissionDataRequestToken
+    from docspring.models.submission_preview import SubmissionPreview
+    from docspring.models.success_error_response import SuccessErrorResponse
+    from docspring.models.success_multiple_errors_response import SuccessMultipleErrorsResponse
+    from docspring.models.template import Template
+    from docspring.models.template_add_fields_response import TemplateAddFieldsResponse
+    from docspring.models.template_delete_response import TemplateDeleteResponse
+    from docspring.models.template_model_code_response import TemplateModelCodeResponse
+    from docspring.models.template_preview import TemplatePreview
+    from docspring.models.template_publish_version_response import TemplatePublishVersionResponse
+    from docspring.models.update_html_template import UpdateHtmlTemplate
+    from docspring.models.update_pdf_template import UpdatePdfTemplate
+    from docspring.models.update_submission_data_request_data import UpdateSubmissionDataRequestData
+    from docspring.models.update_webhook_data import UpdateWebhookData
+    from docspring.models.upload_presign_response import UploadPresignResponse
+    from docspring.models.webhook import Webhook
+    
+else:
+    from lazy_imports import LazyModule, as_package, load
+
+    load(
+        LazyModule(
+            *as_package(__file__),
+            """# import models into model package
+from docspring.models.add_fields_data import AddFieldsData
+from docspring.models.batch_generate_pdfs201_response import BatchGeneratePdfs201Response
+from docspring.models.combine_pdfs_data import CombinePdfsData
+from docspring.models.combined_submission import CombinedSubmission
+from docspring.models.combined_submission_action import CombinedSubmissionAction
+from docspring.models.copy_template_options import CopyTemplateOptions
+from docspring.models.create_combined_submission_response import CreateCombinedSubmissionResponse
+from docspring.models.create_custom_file_data import CreateCustomFileData
+from docspring.models.create_custom_file_response import CreateCustomFileResponse
+from docspring.models.create_folder_data import CreateFolderData
+from docspring.models.create_html_template import CreateHtmlTemplate
+from docspring.models.create_pdf_submission_data import CreatePdfSubmissionData
+from docspring.models.create_pdf_template import CreatePdfTemplate
+from docspring.models.create_submission_data_request_data import CreateSubmissionDataRequestData
+from docspring.models.create_submission_data_request_event_request import CreateSubmissionDataRequestEventRequest
+from docspring.models.create_submission_data_request_event_response import CreateSubmissionDataRequestEventResponse
+from docspring.models.create_submission_data_request_response import CreateSubmissionDataRequestResponse
+from docspring.models.create_submission_data_request_token_response import CreateSubmissionDataRequestTokenResponse
+from docspring.models.create_submission_response import CreateSubmissionResponse
+from docspring.models.create_webhook_data import CreateWebhookData
+from docspring.models.custom_file import CustomFile
+from docspring.models.error_or_multiple_errors_response import ErrorOrMultipleErrorsResponse
+from docspring.models.error_response import ErrorResponse
+from docspring.models.folder import Folder
+from docspring.models.json_schema import JsonSchema
+from docspring.models.list_submissions_response import ListSubmissionsResponse
+from docspring.models.move_folder_data import MoveFolderData
+from docspring.models.move_template_data import MoveTemplateData
+from docspring.models.multiple_errors_response import MultipleErrorsResponse
+from docspring.models.publish_version_data import PublishVersionData
+from docspring.models.rename_folder_data import RenameFolderData
+from docspring.models.restore_version_data import RestoreVersionData
+from docspring.models.submission import Submission
+from docspring.models.submission422_response import Submission422Response
+from docspring.models.submission_action import SubmissionAction
+from docspring.models.submission_batch import SubmissionBatch
+from docspring.models.submission_batch_data import SubmissionBatchData
+from docspring.models.submission_batch_with_submissions import SubmissionBatchWithSubmissions
+from docspring.models.submission_data_request import SubmissionDataRequest
+from docspring.models.submission_data_request_event import SubmissionDataRequestEvent
+from docspring.models.submission_data_request_show import SubmissionDataRequestShow
+from docspring.models.submission_data_request_token import SubmissionDataRequestToken
+from docspring.models.submission_preview import SubmissionPreview
+from docspring.models.success_error_response import SuccessErrorResponse
+from docspring.models.success_multiple_errors_response import SuccessMultipleErrorsResponse
+from docspring.models.template import Template
+from docspring.models.template_add_fields_response import TemplateAddFieldsResponse
+from docspring.models.template_delete_response import TemplateDeleteResponse
+from docspring.models.template_model_code_response import TemplateModelCodeResponse
+from docspring.models.template_preview import TemplatePreview
+from docspring.models.template_publish_version_response import TemplatePublishVersionResponse
+from docspring.models.update_html_template import UpdateHtmlTemplate
+from docspring.models.update_pdf_template import UpdatePdfTemplate
+from docspring.models.update_submission_data_request_data import UpdateSubmissionDataRequestData
+from docspring.models.update_webhook_data import UpdateWebhookData
+from docspring.models.upload_presign_response import UploadPresignResponse
+from docspring.models.webhook import Webhook
+
+""",
+            name=__name__,
+            doc=__doc__,
+        )
+    )

docspring/models/add_fields_data.py

@@ -0,0 +1,88 @@
+# coding: utf-8
+
+"""
+    DocSpring API
+
+    Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+
+    The version of the OpenAPI document: v1
+    Contact: support@docspring.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
+from typing import Any, ClassVar, Dict, List
+from typing import Optional, Set
+from typing_extensions import Self
+
+class AddFieldsData(BaseModel):
+    """
+    AddFieldsData
+    """ # noqa: E501
+    fields: List[Dict[str, Any]]
+    __properties: ClassVar[List[str]] = ["fields"]
+
+    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 AddFieldsData 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.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of AddFieldsData from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj, context={"skip_enum_validation": True})
+
+        _obj = cls.model_validate({
+            "fields": obj.get("fields")
+        }, context={"skip_enum_validation": True})
+        return _obj
+
+

docspring/models/batch_generate_pdfs201_response.py

@@ -0,0 +1,111 @@
+# coding: utf-8
+
+"""
+    DocSpring API
+
+    Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+
+    The version of the OpenAPI document: v1
+    Contact: support@docspring.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, StrictStr, ValidationInfo, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from docspring.models.submission_batch import SubmissionBatch
+from typing import Optional, Set
+from typing_extensions import Self
+
+class BatchGeneratePdfs201Response(BaseModel):
+    """
+    BatchGeneratePdfs201Response
+    """ # noqa: E501
+    status: StrictStr
+    error: Optional[StrictStr] = None
+    errors: Optional[List[StrictStr]] = None
+    submission_batch: SubmissionBatch
+    submissions: List[Dict[str, Any]]
+    __properties: ClassVar[List[str]] = ["status", "error", "errors", "submission_batch", "submissions"]
+
+    @field_validator('status')
+    def status_validate_enum(cls, value, info: ValidationInfo):
+        """Validates the enum"""
+        # from_dict accepts enum values this client doesn't know about yet
+        if info.context and info.context.get("skip_enum_validation"):
+            return value
+
+        if value not in set(['success', 'error']):
+            raise ValueError("must be one of enum values ('success', 'error')")
+        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 BatchGeneratePdfs201Response 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.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of submission_batch
+        if self.submission_batch:
+            _dict['submission_batch'] = self.submission_batch.to_dict()
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of BatchGeneratePdfs201Response from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj, context={"skip_enum_validation": True})
+
+        _obj = cls.model_validate({
+            "status": obj.get("status"),
+            "error": obj.get("error"),
+            "errors": obj.get("errors"),
+            "submission_batch": SubmissionBatch.from_dict(obj["submission_batch"]) if obj.get("submission_batch") is not None else None,
+            "submissions": obj.get("submissions")
+        }, context={"skip_enum_validation": True})
+        return _obj
+
+

docspring/models/combine_pdfs_data.py

@@ -0,0 +1,98 @@
+# coding: utf-8
+
+"""
+    DocSpring API
+
+    Use DocSpring's API to programmatically fill out PDF forms, convert HTML to PDFs, merge PDFs, or request legally binding e-signatures.
+
+    The version of the OpenAPI document: v1
+    Contact: support@docspring.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, StrictBool, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class CombinePdfsData(BaseModel):
+    """
+    CombinePdfsData
+    """ # noqa: E501
+    delete_custom_files: Optional[StrictBool] = Field(default=None, description="Delete the custom files in source_pdfs once the combined PDF has been processed (they're kept if it fails). Other combined submissions can't use them after that. A test API token can't delete custom files.")
+    expires_in: Optional[StrictInt] = None
+    metadata: Optional[Dict[str, Any]] = None
+    password: Optional[StrictStr] = None
+    source_pdfs: List[Dict[str, Any]]
+    test: Optional[StrictBool] = Field(default=None, description="Deprecated, and has no effect. A combined PDF is a test or live document because of its source PDFs.")
+    __properties: ClassVar[List[str]] = ["delete_custom_files", "expires_in", "metadata", "password", "source_pdfs", "test"]
+
+    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 CombinePdfsData 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.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of CombinePdfsData from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj, context={"skip_enum_validation": True})
+
+        _obj = cls.model_validate({
+            "delete_custom_files": obj.get("delete_custom_files"),
+            "expires_in": obj.get("expires_in"),
+            "metadata": obj.get("metadata"),
+            "password": obj.get("password"),
+            "source_pdfs": obj.get("source_pdfs"),
+            "test": obj.get("test")
+        }, context={"skip_enum_validation": True})
+        return _obj
+
+