signwell-sdk-python 0.1.0__py3-none-any.whl

signwell_sdk/models/document_from_template_response.py

@@ -0,0 +1,353 @@
+"""
+SignWell Developer API
+
+API for creating, managing, and tracking electronic signature workflows.
+
+The version of the OpenAPI document: v1
+Contact: support@signwell.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, StrictBool, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from signwell_sdk.models.checkbox_group_info import CheckboxGroupInfo
+from signwell_sdk.models.copied_contact_info import CopiedContactInfo
+from signwell_sdk.models.document_from_template_response_fields_inner_inner import (
+    DocumentFromTemplateResponseFieldsInnerInner,
+)
+from signwell_sdk.models.document_from_template_response_recipients_inner import (
+    DocumentFromTemplateResponseRecipientsInner,
+)
+from signwell_sdk.models.document_response_attachment_requests_inner import DocumentResponseAttachmentRequestsInner
+from signwell_sdk.models.file_info import FileInfo
+from signwell_sdk.models.label_info import LabelInfo
+from typing import Any, Optional, Set
+from typing_extensions import Self
+
+
+class DocumentFromTemplateResponse(BaseModel):
+    """
+    DocumentFromTemplateResponse
+    """  # noqa: E501
+
+    test_mode: StrictBool
+    id: StrictStr
+    template_id: StrictStr | None = None
+    template_ids: List[StrictStr] | None = None
+    api_application_id: StrictStr | None = None
+    requester_email_address: StrictStr | None = None
+    custom_requester_name: StrictStr | None = None
+    custom_requester_email: StrictStr | None = None
+    name: StrictStr | None = None
+    subject: StrictStr | None = None
+    message: StrictStr | None = None
+    metadata: Dict[str, StrictStr] | None = None
+    created_at: datetime | None = None
+    updated_at: datetime | None = None
+    recipients: List[DocumentFromTemplateResponseRecipientsInner] | None = None
+    status: StrictStr | None = Field(
+        default=None,
+        description="Possible values: Draft, Created, Sending, Sent, Pending, Viewed, Completed, Manually completed, Declined, Canceled, Bounced, Blocked, Error, Expired",
+    )
+    reminders: StrictBool | None = None
+    archived: StrictBool | None = None
+    embedded_signing: StrictBool | None = None
+    embedded_edit_url: StrictStr | None = None
+    embedded_preview_url: StrictStr | None = None
+    apply_signing_order: StrictBool | None = None
+    redirect_url: StrictStr | None = None
+    decline_redirect_url: StrictStr | None = None
+    language: StrictStr | None = None
+    expires_in: StrictInt | None = None
+    decline_message: StrictStr | None = None
+    error_message: StrictStr | None = None
+    embedded_signing_notifications: StrictBool | None = None
+    attachment_requests: List[DocumentResponseAttachmentRequestsInner] | None = None
+    files: List[FileInfo] | None = None
+    copied_contacts: List[CopiedContactInfo] | None = None
+    fields: List[List[DocumentFromTemplateResponseFieldsInnerInner]] | None = None
+    allow_decline: StrictBool | None = None
+    allow_reassign: StrictBool | None = None
+    labels: List[LabelInfo] | None = None
+    checkbox_groups: List[CheckboxGroupInfo] | None = None
+    additional_properties: Dict[str, Any] = {}
+    __properties: ClassVar[List[str]] = [
+        "test_mode",
+        "id",
+        "template_id",
+        "template_ids",
+        "api_application_id",
+        "requester_email_address",
+        "custom_requester_name",
+        "custom_requester_email",
+        "name",
+        "subject",
+        "message",
+        "metadata",
+        "created_at",
+        "updated_at",
+        "recipients",
+        "status",
+        "reminders",
+        "archived",
+        "embedded_signing",
+        "embedded_edit_url",
+        "embedded_preview_url",
+        "apply_signing_order",
+        "redirect_url",
+        "decline_redirect_url",
+        "language",
+        "expires_in",
+        "decline_message",
+        "error_message",
+        "embedded_signing_notifications",
+        "attachment_requests",
+        "files",
+        "copied_contacts",
+        "fields",
+        "allow_decline",
+        "allow_reassign",
+        "labels",
+        "checkbox_groups",
+    ]
+
+    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) -> Self | None:
+        """Create an instance of DocumentFromTemplateResponse 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,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in recipients (list)
+        _items_recipients: list[Any] = []
+        if self.recipients:
+            for _item_recipients in self.recipients:
+                if _item_recipients:
+                    _items_recipients.append(_item_recipients.to_dict())
+            _dict["recipients"] = _items_recipients
+        # override the default output from pydantic by calling `to_dict()` of each item in attachment_requests (list)
+        _items_attachment_requests: list[Any] = []
+        if self.attachment_requests:
+            for _item_attachment_requests in self.attachment_requests:
+                if _item_attachment_requests:
+                    _items_attachment_requests.append(_item_attachment_requests.to_dict())
+            _dict["attachment_requests"] = _items_attachment_requests
+        # override the default output from pydantic by calling `to_dict()` of each item in files (list)
+        _items_files: list[Any] = []
+        if self.files:
+            for _item_files in self.files:
+                if _item_files:
+                    _items_files.append(_item_files.to_dict())
+            _dict["files"] = _items_files
+        # override the default output from pydantic by calling `to_dict()` of each item in copied_contacts (list)
+        _items_copied_contacts: list[Any] = []
+        if self.copied_contacts:
+            for _item_copied_contacts in self.copied_contacts:
+                if _item_copied_contacts:
+                    _items_copied_contacts.append(_item_copied_contacts.to_dict())
+            _dict["copied_contacts"] = _items_copied_contacts
+        # override the default output from pydantic by calling `to_dict()` of each item in fields (list of list)
+        _items_fields: list[Any] = []
+        if self.fields:
+            for _item_fields in self.fields:
+                if _item_fields:
+                    _items_fields.append(
+                        [_inner_item.to_dict() for _inner_item in _item_fields if _inner_item is not None]
+                    )
+            _dict["fields"] = _items_fields
+        # override the default output from pydantic by calling `to_dict()` of each item in labels (list)
+        _items_labels: list[Any] = []
+        if self.labels:
+            for _item_labels in self.labels:
+                if _item_labels:
+                    _items_labels.append(_item_labels.to_dict())
+            _dict["labels"] = _items_labels
+        # override the default output from pydantic by calling `to_dict()` of each item in checkbox_groups (list)
+        _items_checkbox_groups: list[Any] = []
+        if self.checkbox_groups:
+            for _item_checkbox_groups in self.checkbox_groups:
+                if _item_checkbox_groups:
+                    _items_checkbox_groups.append(_item_checkbox_groups.to_dict())
+            _dict["checkbox_groups"] = _items_checkbox_groups
+        # 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 api_application_id (nullable) is None
+        # and model_fields_set contains the field
+        if self.api_application_id is None and "api_application_id" in self.model_fields_set:
+            _dict["api_application_id"] = None
+
+        # set to None if custom_requester_name (nullable) is None
+        # and model_fields_set contains the field
+        if self.custom_requester_name is None and "custom_requester_name" in self.model_fields_set:
+            _dict["custom_requester_name"] = None
+
+        # set to None if custom_requester_email (nullable) is None
+        # and model_fields_set contains the field
+        if self.custom_requester_email is None and "custom_requester_email" in self.model_fields_set:
+            _dict["custom_requester_email"] = None
+
+        # set to None if metadata (nullable) is None
+        # and model_fields_set contains the field
+        if self.metadata is None and "metadata" in self.model_fields_set:
+            _dict["metadata"] = None
+
+        # set to None if embedded_preview_url (nullable) is None
+        # and model_fields_set contains the field
+        if self.embedded_preview_url is None and "embedded_preview_url" in self.model_fields_set:
+            _dict["embedded_preview_url"] = None
+
+        # set to None if redirect_url (nullable) is None
+        # and model_fields_set contains the field
+        if self.redirect_url is None and "redirect_url" in self.model_fields_set:
+            _dict["redirect_url"] = None
+
+        # set to None if decline_redirect_url (nullable) is None
+        # and model_fields_set contains the field
+        if self.decline_redirect_url is None and "decline_redirect_url" in self.model_fields_set:
+            _dict["decline_redirect_url"] = None
+
+        # set to None if decline_message (nullable) is None
+        # and model_fields_set contains the field
+        if self.decline_message is None and "decline_message" in self.model_fields_set:
+            _dict["decline_message"] = None
+
+        # set to None if error_message (nullable) is None
+        # and model_fields_set contains the field
+        if self.error_message is None and "error_message" in self.model_fields_set:
+            _dict["error_message"] = None
+
+        # set to None if allow_decline (nullable) is None
+        # and model_fields_set contains the field
+        if self.allow_decline is None and "allow_decline" in self.model_fields_set:
+            _dict["allow_decline"] = None
+
+        # set to None if allow_reassign (nullable) is None
+        # and model_fields_set contains the field
+        if self.allow_reassign is None and "allow_reassign" in self.model_fields_set:
+            _dict["allow_reassign"] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Dict[str, Any] | None) -> Self | None:
+        """Create an instance of DocumentFromTemplateResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate(
+            {
+                "test_mode": obj.get("test_mode"),
+                "id": obj.get("id"),
+                "template_id": obj.get("template_id"),
+                "template_ids": obj.get("template_ids"),
+                "api_application_id": obj.get("api_application_id"),
+                "requester_email_address": obj.get("requester_email_address"),
+                "custom_requester_name": obj.get("custom_requester_name"),
+                "custom_requester_email": obj.get("custom_requester_email"),
+                "name": obj.get("name"),
+                "subject": obj.get("subject"),
+                "message": obj.get("message"),
+                "metadata": obj.get("metadata"),
+                "created_at": obj.get("created_at"),
+                "updated_at": obj.get("updated_at"),
+                "recipients": [
+                    DocumentFromTemplateResponseRecipientsInner.from_dict(_item) for _item in obj["recipients"]
+                ]
+                if obj.get("recipients") is not None
+                else None,
+                "status": obj.get("status"),
+                "reminders": obj.get("reminders"),
+                "archived": obj.get("archived"),
+                "embedded_signing": obj.get("embedded_signing"),
+                "embedded_edit_url": obj.get("embedded_edit_url"),
+                "embedded_preview_url": obj.get("embedded_preview_url"),
+                "apply_signing_order": obj.get("apply_signing_order"),
+                "redirect_url": obj.get("redirect_url"),
+                "decline_redirect_url": obj.get("decline_redirect_url"),
+                "language": obj.get("language"),
+                "expires_in": obj.get("expires_in"),
+                "decline_message": obj.get("decline_message"),
+                "error_message": obj.get("error_message"),
+                "embedded_signing_notifications": obj.get("embedded_signing_notifications"),
+                "attachment_requests": [
+                    DocumentResponseAttachmentRequestsInner.from_dict(_item) for _item in obj["attachment_requests"]
+                ]
+                if obj.get("attachment_requests") is not None
+                else None,
+                "files": [FileInfo.from_dict(_item) for _item in obj["files"]]
+                if obj.get("files") is not None
+                else None,
+                "copied_contacts": [CopiedContactInfo.from_dict(_item) for _item in obj["copied_contacts"]]
+                if obj.get("copied_contacts") is not None
+                else None,
+                "fields": [
+                    [DocumentFromTemplateResponseFieldsInnerInner.from_dict(_inner_item) for _inner_item in _item]
+                    for _item in obj["fields"]
+                ]
+                if obj.get("fields") is not None
+                else None,
+                "allow_decline": obj.get("allow_decline"),
+                "allow_reassign": obj.get("allow_reassign"),
+                "labels": [LabelInfo.from_dict(_item) for _item in obj["labels"]]
+                if obj.get("labels") is not None
+                else None,
+                "checkbox_groups": [CheckboxGroupInfo.from_dict(_item) for _item in obj["checkbox_groups"]]
+                if obj.get("checkbox_groups") is not None
+                else None,
+            }
+        )
+        # 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

signwell_sdk/models/document_from_template_response_fields_inner_inner.py

@@ -0,0 +1,270 @@
+"""
+SignWell Developer API
+
+API for creating, managing, and tracking electronic signature workflows.
+
+The version of the OpenAPI document: v1
+Contact: support@signwell.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, StrictFloat, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional, Union
+from signwell_sdk.models.date_format import DateFormat
+from signwell_sdk.models.document_from_template_response_fields_inner_inner_recipient import (
+    DocumentFromTemplateResponseFieldsInnerInnerRecipient,
+)
+from signwell_sdk.models.document_response_fields_inner_inner_options_inner import (
+    DocumentResponseFieldsInnerInnerOptionsInner,
+)
+from signwell_sdk.models.document_response_fields_inner_inner_value import DocumentResponseFieldsInnerInnerValue
+from signwell_sdk.models.field_type import FieldType
+from signwell_sdk.models.text_validation import TextValidation
+from pydantic import model_validator
+from typing import Any, Optional, Set, get_args
+from typing_extensions import Self
+
+
+class DocumentFromTemplateResponseFieldsInnerInner(BaseModel):
+    """
+    DocumentFromTemplateResponseFieldsInnerInner
+    """  # noqa: E501
+
+    x: Union[StrictFloat, StrictInt]
+    y: Union[StrictFloat, StrictInt]
+    page: StrictInt
+    recipient: DocumentFromTemplateResponseFieldsInnerInnerRecipient | None = None
+    api_id: StrictStr | None = None
+    name: StrictStr | None = None
+    date_format: DateFormat | None = None
+    fixed_width: StrictBool | None = None
+    formula: StrictStr | None = None
+    label: StrictStr | None = None
+    lock_sign_date: StrictBool | None = None
+    required: StrictBool | None = None
+    type: FieldType | None = None
+    validation: TextValidation | None = None
+    value: DocumentResponseFieldsInnerInnerValue | None = None
+    height: StrictStr | None = None
+    width: StrictStr | None = None
+    recipient_id: StrictStr | None = None
+    signing_elements_group_id: StrictStr | None = None
+    placeholder_name: StrictStr | None = None
+    options: List[DocumentResponseFieldsInnerInnerOptionsInner] | None = Field(
+        default=None, description="Dropdown options (for dropdown/select fields)"
+    )
+    default_option: StrictStr | None = Field(default=None, description="Default selected option")
+    allow_other: StrictBool | None = Field(default=None, description='Whether "Other" option is allowed')
+    additional_properties: Dict[str, Any] = {}
+    __properties: ClassVar[List[str]] = [
+        "x",
+        "y",
+        "page",
+        "recipient",
+        "api_id",
+        "name",
+        "date_format",
+        "fixed_width",
+        "formula",
+        "label",
+        "lock_sign_date",
+        "required",
+        "type",
+        "validation",
+        "value",
+        "height",
+        "width",
+        "recipient_id",
+        "signing_elements_group_id",
+        "placeholder_name",
+        "options",
+        "default_option",
+        "allow_other",
+    ]
+
+    @model_validator(mode="before")
+    @classmethod
+    def normalize_checkbox_value_input(cls, data: Any) -> Any:
+        if not isinstance(data, dict):
+            return data
+        if cls._field_type_value(data.get("type")) != "checkbox":
+            return data
+        if data.get("value") is None:
+            return data
+
+        normalized = dict(data)
+        normalized["value"] = cls._build_value_model(cls._normalize_checkbox_value(data["value"]))
+        return normalized
+
+    @model_validator(mode="after")
+    def normalize_checkbox_value(self) -> Self:
+        field_type = getattr(self.type, "value", self.type)
+        if field_type == "checkbox" and self.value is not None:
+            self.value.actual_instance = self._normalize_checkbox_value(self.value)
+        return self
+
+    @classmethod
+    def _build_value_model(cls, value: str) -> Any:
+        value_field = cls.model_fields.get("value")
+        if value_field is None:
+            return value
+
+        annotation = value_field.annotation
+        candidates = get_args(annotation) or (annotation,)
+        for candidate in candidates:
+            if candidate is type(None):
+                continue
+            value_model: Any = candidate
+            if callable(value_model):
+                return value_model(value)
+        return value
+
+    @staticmethod
+    def _field_type_value(value: Any) -> Any:
+        return getattr(value, "value", value)
+
+    @staticmethod
+    def _normalize_checkbox_value(value: Any) -> str:
+        actual_value = getattr(value, "actual_instance", value)
+        if isinstance(actual_value, bool):
+            return "t" if actual_value else "f"
+        if isinstance(actual_value, str):
+            normalized = actual_value.strip().lower()
+            if normalized in {"true", "t"}:
+                return "t"
+            if normalized in {"false", "f"}:
+                return "f"
+        raise ValueError('Checkbox field values must be boolean or one of "true", "false", "t", or "f"')
+
+    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) -> Self | None:
+        """Create an instance of DocumentFromTemplateResponseFieldsInnerInner 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,
+        )
+        # override the default output from pydantic by calling `to_dict()` of recipient
+        if self.recipient:
+            _dict["recipient"] = self.recipient.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of value
+        if self.value:
+            _dict["value"] = self.value.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of each item in options (list)
+        _items_options: list[Any] = []
+        if self.options:
+            for _item_options in self.options:
+                if _item_options:
+                    _items_options.append(_item_options.to_dict())
+            _dict["options"] = _items_options
+        # 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 name (nullable) is None
+        # and model_fields_set contains the field
+        if self.name is None and "name" in self.model_fields_set:
+            _dict["name"] = None
+
+        # set to None if value (nullable) is None
+        # and model_fields_set contains the field
+        if self.value is None and "value" in self.model_fields_set:
+            _dict["value"] = None
+
+        # set to None if recipient_id (nullable) is None
+        # and model_fields_set contains the field
+        if self.recipient_id is None and "recipient_id" in self.model_fields_set:
+            _dict["recipient_id"] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Dict[str, Any] | None) -> Self | None:
+        """Create an instance of DocumentFromTemplateResponseFieldsInnerInner from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate(
+            {
+                "x": obj.get("x"),
+                "y": obj.get("y"),
+                "page": obj.get("page"),
+                "recipient": DocumentFromTemplateResponseFieldsInnerInnerRecipient.from_dict(obj["recipient"])
+                if obj.get("recipient") is not None
+                else None,
+                "api_id": obj.get("api_id"),
+                "name": obj.get("name"),
+                "date_format": obj.get("date_format"),
+                "fixed_width": obj.get("fixed_width"),
+                "formula": obj.get("formula"),
+                "label": obj.get("label"),
+                "lock_sign_date": obj.get("lock_sign_date"),
+                "required": obj.get("required"),
+                "type": obj.get("type"),
+                "validation": obj.get("validation"),
+                "value": DocumentResponseFieldsInnerInnerValue.from_dict(obj["value"])
+                if obj.get("value") is not None
+                else None,
+                "height": obj.get("height"),
+                "width": obj.get("width"),
+                "recipient_id": obj.get("recipient_id"),
+                "signing_elements_group_id": obj.get("signing_elements_group_id"),
+                "placeholder_name": obj.get("placeholder_name"),
+                "options": [DocumentResponseFieldsInnerInnerOptionsInner.from_dict(_item) for _item in obj["options"]]
+                if obj.get("options") is not None
+                else None,
+                "default_option": obj.get("default_option"),
+                "allow_other": obj.get("allow_other"),
+            }
+        )
+        # 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