onlinepayments-sdk-python3 4.23.0__zip → 5.1.0__zip

{onlinepayments-sdk-python3-4.23.0 → onlinepayments_sdk_python3-5.1.0}/onlinepayments/sdk/domain/payment_output.py

@@ -1,40 +1,39 @@
 # -*- coding: utf-8 -*-
 #
-# This class was auto-generated.
+# This file was automatically generated.
 #
-from onlinepayments.sdk.data_object import DataObject
-from onlinepayments.sdk.domain.amount_of_money import AmountOfMoney
-from onlinepayments.sdk.domain.card_payment_method_specific_output import CardPaymentMethodSpecificOutput
-from onlinepayments.sdk.domain.customer_output import CustomerOutput
-from onlinepayments.sdk.domain.discount import Discount
-from onlinepayments.sdk.domain.mobile_payment_method_specific_output import MobilePaymentMethodSpecificOutput
-from onlinepayments.sdk.domain.payment_references import PaymentReferences
-from onlinepayments.sdk.domain.redirect_payment_method_specific_output import RedirectPaymentMethodSpecificOutput
-from onlinepayments.sdk.domain.sepa_direct_debit_payment_method_specific_output import SepaDirectDebitPaymentMethodSpecificOutput
-from onlinepayments.sdk.domain.surcharge_specific_output import SurchargeSpecificOutput
+from typing import Optional
+
+from .amount_of_money import AmountOfMoney
+from .card_payment_method_specific_output import CardPaymentMethodSpecificOutput
+from .customer_output import CustomerOutput
+from .data_object import DataObject
+from .discount import Discount
+from .mobile_payment_method_specific_output import MobilePaymentMethodSpecificOutput
+from .payment_references import PaymentReferences
+from .redirect_payment_method_specific_output import RedirectPaymentMethodSpecificOutput
+from .sepa_direct_debit_payment_method_specific_output import SepaDirectDebitPaymentMethodSpecificOutput
+from .surcharge_specific_output import SurchargeSpecificOutput
 
 
 class PaymentOutput(DataObject):
-    """
-    | Object containing payment details
-    """
-
-    __acquired_amount = None
-    __amount_of_money = None
-    __amount_paid = None
-    __card_payment_method_specific_output = None
-    __customer = None
-    __discount = None
-    __merchant_parameters = None
-    __mobile_payment_method_specific_output = None
-    __payment_method = None
-    __redirect_payment_method_specific_output = None
-    __references = None
-    __sepa_direct_debit_payment_method_specific_output = None
-    __surcharge_specific_output = None
+
+    __acquired_amount: Optional[AmountOfMoney] = None
+    __amount_of_money: Optional[AmountOfMoney] = None
+    __amount_paid: Optional[int] = None
+    __card_payment_method_specific_output: Optional[CardPaymentMethodSpecificOutput] = None
+    __customer: Optional[CustomerOutput] = None
+    __discount: Optional[Discount] = None
+    __merchant_parameters: Optional[str] = None
+    __mobile_payment_method_specific_output: Optional[MobilePaymentMethodSpecificOutput] = None
+    __payment_method: Optional[str] = None
+    __redirect_payment_method_specific_output: Optional[RedirectPaymentMethodSpecificOutput] = None
+    __references: Optional[PaymentReferences] = None
+    __sepa_direct_debit_payment_method_specific_output: Optional[SepaDirectDebitPaymentMethodSpecificOutput] = None
+    __surcharge_specific_output: Optional[SurchargeSpecificOutput] = None
 
     @property
-    def acquired_amount(self) -> AmountOfMoney:
+    def acquired_amount(self) -> Optional[AmountOfMoney]:
         """
         | Object containing amount and ISO currency code attributes
 
@@ -43,11 +42,11 @@ class PaymentOutput(DataObject):
         return self.__acquired_amount
 
     @acquired_amount.setter
-    def acquired_amount(self, value: AmountOfMoney):
+    def acquired_amount(self, value: Optional[AmountOfMoney]) -> None:
         self.__acquired_amount = value
 
     @property
-    def amount_of_money(self) -> AmountOfMoney:
+    def amount_of_money(self) -> Optional[AmountOfMoney]:
         """
         | Object containing amount and ISO currency code attributes
 
@@ -56,24 +55,26 @@ class PaymentOutput(DataObject):
         return self.__amount_of_money
 
     @amount_of_money.setter
-    def amount_of_money(self, value: AmountOfMoney):
+    def amount_of_money(self, value: Optional[AmountOfMoney]) -> None:
         self.__amount_of_money = value
 
     @property
-    def amount_paid(self) -> int:
+    def amount_paid(self) -> Optional[int]:
         """
         | Amount that has been paid. This is deprecated. Use acquiredAmount instead.
 
         Type: int
+
+        Deprecated; Amount that has been paid. This is deprecated. Use acquiredAmount instead.
         """
         return self.__amount_paid
 
     @amount_paid.setter
-    def amount_paid(self, value: int):
+    def amount_paid(self, value: Optional[int]) -> None:
         self.__amount_paid = value
 
     @property
-    def card_payment_method_specific_output(self) -> CardPaymentMethodSpecificOutput:
+    def card_payment_method_specific_output(self) -> Optional[CardPaymentMethodSpecificOutput]:
         """
         | Object containing the card payment method details
 
@@ -82,11 +83,11 @@ class PaymentOutput(DataObject):
         return self.__card_payment_method_specific_output
 
     @card_payment_method_specific_output.setter
-    def card_payment_method_specific_output(self, value: CardPaymentMethodSpecificOutput):
+    def card_payment_method_specific_output(self, value: Optional[CardPaymentMethodSpecificOutput]) -> None:
         self.__card_payment_method_specific_output = value
 
     @property
-    def customer(self) -> CustomerOutput:
+    def customer(self) -> Optional[CustomerOutput]:
         """
         | Object containing the details of the customer
 
@@ -95,11 +96,11 @@ class PaymentOutput(DataObject):
         return self.__customer
 
     @customer.setter
-    def customer(self, value: CustomerOutput):
+    def customer(self, value: Optional[CustomerOutput]) -> None:
         self.__customer = value
 
     @property
-    def discount(self) -> Discount:
+    def discount(self) -> Optional[Discount]:
         """
         | Object to apply a discount to the total basket by adding a discount line.
 
@@ -108,11 +109,11 @@ class PaymentOutput(DataObject):
         return self.__discount
 
     @discount.setter
-    def discount(self, value: Discount):
+    def discount(self, value: Optional[Discount]) -> None:
         self.__discount = value
 
     @property
-    def merchant_parameters(self) -> str:
+    def merchant_parameters(self) -> Optional[str]:
         """
         | It allows you to store additional parameters for the transaction in the format you prefer (e.g.-> key-value query string, JSON, etc.) These parameters are then echoed back to you in API GET calls and Webhook notifications. This field must not contain any personal data.
 
@@ -121,11 +122,11 @@ class PaymentOutput(DataObject):
         return self.__merchant_parameters
 
     @merchant_parameters.setter
-    def merchant_parameters(self, value: str):
+    def merchant_parameters(self, value: Optional[str]) -> None:
         self.__merchant_parameters = value
 
     @property
-    def mobile_payment_method_specific_output(self) -> MobilePaymentMethodSpecificOutput:
+    def mobile_payment_method_specific_output(self) -> Optional[MobilePaymentMethodSpecificOutput]:
         """
         | Object containing the mobile payment method details
 
@@ -134,11 +135,11 @@ class PaymentOutput(DataObject):
         return self.__mobile_payment_method_specific_output
 
     @mobile_payment_method_specific_output.setter
-    def mobile_payment_method_specific_output(self, value: MobilePaymentMethodSpecificOutput):
+    def mobile_payment_method_specific_output(self, value: Optional[MobilePaymentMethodSpecificOutput]) -> None:
         self.__mobile_payment_method_specific_output = value
 
     @property
-    def payment_method(self) -> str:
+    def payment_method(self) -> Optional[str]:
         """
         | Payment method identifier used by the our payment engine.
 
@@ -147,11 +148,11 @@ class PaymentOutput(DataObject):
         return self.__payment_method
 
     @payment_method.setter
-    def payment_method(self, value: str):
+    def payment_method(self, value: Optional[str]) -> None:
         self.__payment_method = value
 
     @property
-    def redirect_payment_method_specific_output(self) -> RedirectPaymentMethodSpecificOutput:
+    def redirect_payment_method_specific_output(self) -> Optional[RedirectPaymentMethodSpecificOutput]:
         """
         | Object containing the redirect payment product details
 
@@ -160,24 +161,24 @@ class PaymentOutput(DataObject):
         return self.__redirect_payment_method_specific_output
 
     @redirect_payment_method_specific_output.setter
-    def redirect_payment_method_specific_output(self, value: RedirectPaymentMethodSpecificOutput):
+    def redirect_payment_method_specific_output(self, value: Optional[RedirectPaymentMethodSpecificOutput]) -> None:
         self.__redirect_payment_method_specific_output = value
 
     @property
-    def references(self) -> PaymentReferences:
+    def references(self) -> Optional[PaymentReferences]:
         """
-        | Object that holds all reference properties that are linked to this transaction
+        | Object that holds all reference properties that are linked to this transaction. **Deprecated for capture/refund**: Use operationReferences instead.
 
         Type: :class:`onlinepayments.sdk.domain.payment_references.PaymentReferences`
         """
         return self.__references
 
     @references.setter
-    def references(self, value: PaymentReferences):
+    def references(self, value: Optional[PaymentReferences]) -> None:
         self.__references = value
 
     @property
-    def sepa_direct_debit_payment_method_specific_output(self) -> SepaDirectDebitPaymentMethodSpecificOutput:
+    def sepa_direct_debit_payment_method_specific_output(self) -> Optional[SepaDirectDebitPaymentMethodSpecificOutput]:
         """
         | Object containing the SEPA direct debit details
 
@@ -186,11 +187,11 @@ class PaymentOutput(DataObject):
         return self.__sepa_direct_debit_payment_method_specific_output
 
     @sepa_direct_debit_payment_method_specific_output.setter
-    def sepa_direct_debit_payment_method_specific_output(self, value: SepaDirectDebitPaymentMethodSpecificOutput):
+    def sepa_direct_debit_payment_method_specific_output(self, value: Optional[SepaDirectDebitPaymentMethodSpecificOutput]) -> None:
         self.__sepa_direct_debit_payment_method_specific_output = value
 
     @property
-    def surcharge_specific_output(self) -> SurchargeSpecificOutput:
+    def surcharge_specific_output(self) -> Optional[SurchargeSpecificOutput]:
         """
         | Object containing specific surcharging attributes applied to an order.
 
@@ -199,10 +200,10 @@ class PaymentOutput(DataObject):
         return self.__surcharge_specific_output
 
     @surcharge_specific_output.setter
-    def surcharge_specific_output(self, value: SurchargeSpecificOutput):
+    def surcharge_specific_output(self, value: Optional[SurchargeSpecificOutput]) -> None:
         self.__surcharge_specific_output = value
 
-    def to_dictionary(self):
+    def to_dictionary(self) -> dict:
         dictionary = super(PaymentOutput, self).to_dictionary()
         if self.acquired_amount is not None:
             dictionary['acquiredAmount'] = self.acquired_amount.to_dictionary()
@@ -232,7 +233,7 @@ class PaymentOutput(DataObject):
             dictionary['surchargeSpecificOutput'] = self.surcharge_specific_output.to_dictionary()
         return dictionary
 
-    def from_dictionary(self, dictionary):
+    def from_dictionary(self, dictionary: dict) -> 'PaymentOutput':
         super(PaymentOutput, self).from_dictionary(dictionary)
         if 'acquiredAmount' in dictionary:
             if not isinstance(dictionary['acquiredAmount'], dict):

{onlinepayments-sdk-python3-4.23.0 → onlinepayments_sdk_python3-5.1.0}/onlinepayments/sdk/domain/payment_product.py

@@ -1,37 +1,35 @@
 # -*- coding: utf-8 -*-
 #
-# This class was auto-generated.
+# This file was automatically generated.
 #
-from typing import List
+from typing import List, Optional
 
-from onlinepayments.sdk.data_object import DataObject
-from onlinepayments.sdk.domain.account_on_file import AccountOnFile
-from onlinepayments.sdk.domain.payment_product302_specific_data import PaymentProduct302SpecificData
-from onlinepayments.sdk.domain.payment_product320_specific_data import PaymentProduct320SpecificData
-from onlinepayments.sdk.domain.payment_product_display_hints import PaymentProductDisplayHints
-from onlinepayments.sdk.domain.payment_product_field import PaymentProductField
+from .account_on_file import AccountOnFile
+from .data_object import DataObject
+from .payment_product302_specific_data import PaymentProduct302SpecificData
+from .payment_product320_specific_data import PaymentProduct320SpecificData
+from .payment_product_display_hints import PaymentProductDisplayHints
+from .payment_product_field import PaymentProductField
 
 
 class PaymentProduct(DataObject):
-    """
-    | Payment product
-    """
-
-    __accounts_on_file = None
-    __allows_recurring = None
-    __allows_tokenization = None
-    __display_hints = None
-    __display_hints_list = None
-    __fields = None
-    __id = None
-    __payment_method = None
-    __payment_product302_specific_data = None
-    __payment_product320_specific_data = None
-    __payment_product_group = None
-    __uses_redirection_to3rd_party = None
+
+    __accounts_on_file: Optional[List[AccountOnFile]] = None
+    __allows_authentication: Optional[bool] = None
+    __allows_recurring: Optional[bool] = None
+    __allows_tokenization: Optional[bool] = None
+    __display_hints: Optional[PaymentProductDisplayHints] = None
+    __display_hints_list: Optional[List[PaymentProductDisplayHints]] = None
+    __fields: Optional[List[PaymentProductField]] = None
+    __id: Optional[int] = None
+    __payment_method: Optional[str] = None
+    __payment_product302_specific_data: Optional[PaymentProduct302SpecificData] = None
+    __payment_product320_specific_data: Optional[PaymentProduct320SpecificData] = None
+    __payment_product_group: Optional[str] = None
+    __uses_redirection_to3rd_party: Optional[bool] = None
 
     @property
-    def accounts_on_file(self) -> List[AccountOnFile]:
+    def accounts_on_file(self) -> Optional[List[AccountOnFile]]:
         """
         | List of tokens for that payment product
 
@@ -40,41 +38,56 @@ class PaymentProduct(DataObject):
         return self.__accounts_on_file
 
     @accounts_on_file.setter
-    def accounts_on_file(self, value: List[AccountOnFile]):
+    def accounts_on_file(self, value: Optional[List[AccountOnFile]]) -> None:
         self.__accounts_on_file = value
 
     @property
-    def allows_recurring(self) -> bool:
+    def allows_authentication(self) -> Optional[bool]:
+        """
+        | True when 3DS authentication is supported or required for the product
+
+        Type: bool
+        """
+        return self.__allows_authentication
+
+    @allows_authentication.setter
+    def allows_authentication(self, value: Optional[bool]) -> None:
+        self.__allows_authentication = value
+
+    @property
+    def allows_recurring(self) -> Optional[bool]:
         """
         | Indicates if the product supports recurring payments
-        | * true - This payment product supports recurring payments
-        | * false - This payment product does not support recurring transactions and can only be used for one-off payments
+        
+        * true - This payment product supports recurring payments
+        * false - This payment product does not support recurring transactions and can only be used for one-off payments
 
         Type: bool
         """
         return self.__allows_recurring
 
     @allows_recurring.setter
-    def allows_recurring(self, value: bool):
+    def allows_recurring(self, value: Optional[bool]) -> None:
         self.__allows_recurring = value
 
     @property
-    def allows_tokenization(self) -> bool:
+    def allows_tokenization(self) -> Optional[bool]:
         """
         | Indicates if the payment details can be tokenized for future re-use
-        | * true - Payment details from payments done with this payment product can be tokenized for future re-use
-        | * false - Payment details from payments done with this payment product can not be tokenized
+        
+        * true - Payment details from payments done with this payment product can be tokenized for future re-use
+        * false - Payment details from payments done with this payment product can not be tokenized
 
         Type: bool
         """
         return self.__allows_tokenization
 
     @allows_tokenization.setter
-    def allows_tokenization(self, value: bool):
+    def allows_tokenization(self, value: Optional[bool]) -> None:
         self.__allows_tokenization = value
 
     @property
-    def display_hints(self) -> PaymentProductDisplayHints:
+    def display_hints(self) -> Optional[PaymentProductDisplayHints]:
         """
         | Object containing display hints like the order of the product when shown in a list, the name of the product and the logo
 
@@ -83,24 +96,22 @@ class PaymentProduct(DataObject):
         return self.__display_hints
 
     @display_hints.setter
-    def display_hints(self, value: PaymentProductDisplayHints):
+    def display_hints(self, value: Optional[PaymentProductDisplayHints]) -> None:
         self.__display_hints = value
 
     @property
-    def display_hints_list(self) -> List[PaymentProductDisplayHints]:
+    def display_hints_list(self) -> Optional[List[PaymentProductDisplayHints]]:
         """
-        | List of display hints
-
         Type: list[:class:`onlinepayments.sdk.domain.payment_product_display_hints.PaymentProductDisplayHints`]
         """
         return self.__display_hints_list
 
     @display_hints_list.setter
-    def display_hints_list(self, value: List[PaymentProductDisplayHints]):
+    def display_hints_list(self, value: Optional[List[PaymentProductDisplayHints]]) -> None:
         self.__display_hints_list = value
 
     @property
-    def fields(self) -> List[PaymentProductField]:
+    def fields(self) -> Optional[List[PaymentProductField]]:
         """
         | Object containing all the fields and their details that are associated with this payment product. If you are not interested in the data on the fields you should have us filter them our (using filter=fields in the query-string)
 
@@ -109,11 +120,11 @@ class PaymentProduct(DataObject):
         return self.__fields
 
     @fields.setter
-    def fields(self, value: List[PaymentProductField]):
+    def fields(self, value: Optional[List[PaymentProductField]]) -> None:
         self.__fields = value
 
     @property
-    def id(self) -> int:
+    def id(self) -> Optional[int]:
         """
         | The ID of the payment product in our system
 
@@ -122,11 +133,11 @@ class PaymentProduct(DataObject):
         return self.__id
 
     @id.setter
-    def id(self, value: int):
+    def id(self, value: Optional[int]) -> None:
         self.__id = value
 
     @property
-    def payment_method(self) -> str:
+    def payment_method(self) -> Optional[str]:
         """
         | Payment method identifier used by the our payment engine.
 
@@ -135,67 +146,71 @@ class PaymentProduct(DataObject):
         return self.__payment_method
 
     @payment_method.setter
-    def payment_method(self, value: str):
+    def payment_method(self, value: Optional[str]) -> None:
         self.__payment_method = value
 
     @property
-    def payment_product302_specific_data(self) -> PaymentProduct302SpecificData:
+    def payment_product302_specific_data(self) -> Optional[PaymentProduct302SpecificData]:
         """
         Type: :class:`onlinepayments.sdk.domain.payment_product302_specific_data.PaymentProduct302SpecificData`
         """
         return self.__payment_product302_specific_data
 
     @payment_product302_specific_data.setter
-    def payment_product302_specific_data(self, value: PaymentProduct302SpecificData):
+    def payment_product302_specific_data(self, value: Optional[PaymentProduct302SpecificData]) -> None:
         self.__payment_product302_specific_data = value
 
     @property
-    def payment_product320_specific_data(self) -> PaymentProduct320SpecificData:
+    def payment_product320_specific_data(self) -> Optional[PaymentProduct320SpecificData]:
         """
         Type: :class:`onlinepayments.sdk.domain.payment_product320_specific_data.PaymentProduct320SpecificData`
         """
         return self.__payment_product320_specific_data
 
     @payment_product320_specific_data.setter
-    def payment_product320_specific_data(self, value: PaymentProduct320SpecificData):
+    def payment_product320_specific_data(self, value: Optional[PaymentProduct320SpecificData]) -> None:
         self.__payment_product320_specific_data = value
 
     @property
-    def payment_product_group(self) -> str:
+    def payment_product_group(self) -> Optional[str]:
         """
         | The payment product group that has this payment product, if there is any. Not populated otherwise. Currently only one payment product group is supported:
-        | * cards
+        
+        * cards
 
         Type: str
         """
         return self.__payment_product_group
 
     @payment_product_group.setter
-    def payment_product_group(self, value: str):
+    def payment_product_group(self, value: Optional[str]) -> None:
         self.__payment_product_group = value
 
     @property
-    def uses_redirection_to3rd_party(self) -> bool:
+    def uses_redirection_to3rd_party(self) -> Optional[bool]:
         """
         | Indicates whether the payment product requires redirection to a third party to complete the payment. You can use this to filter out products that require a redirect if you do not want to support that.
-        | * true - Redirection is required
-        | * false - No redirection is required
+        
+        * true - Redirection is required
+        * false - No redirection is required
 
         Type: bool
         """
         return self.__uses_redirection_to3rd_party
 
     @uses_redirection_to3rd_party.setter
-    def uses_redirection_to3rd_party(self, value: bool):
+    def uses_redirection_to3rd_party(self, value: Optional[bool]) -> None:
         self.__uses_redirection_to3rd_party = value
 
-    def to_dictionary(self):
+    def to_dictionary(self) -> dict:
         dictionary = super(PaymentProduct, self).to_dictionary()
         if self.accounts_on_file is not None:
             dictionary['accountsOnFile'] = []
             for element in self.accounts_on_file:
                 if element is not None:
                     dictionary['accountsOnFile'].append(element.to_dictionary())
+        if self.allows_authentication is not None:
+            dictionary['allowsAuthentication'] = self.allows_authentication
         if self.allows_recurring is not None:
             dictionary['allowsRecurring'] = self.allows_recurring
         if self.allows_tokenization is not None:
@@ -226,7 +241,7 @@ class PaymentProduct(DataObject):
             dictionary['usesRedirectionTo3rdParty'] = self.uses_redirection_to3rd_party
         return dictionary
 
-    def from_dictionary(self, dictionary):
+    def from_dictionary(self, dictionary: dict) -> 'PaymentProduct':
         super(PaymentProduct, self).from_dictionary(dictionary)
         if 'accountsOnFile' in dictionary:
             if not isinstance(dictionary['accountsOnFile'], list):
@@ -235,6 +250,8 @@ class PaymentProduct(DataObject):
             for element in dictionary['accountsOnFile']:
                 value = AccountOnFile()
                 self.accounts_on_file.append(value.from_dictionary(element))
+        if 'allowsAuthentication' in dictionary:
+            self.allows_authentication = dictionary['allowsAuthentication']
         if 'allowsRecurring' in dictionary:
             self.allows_recurring = dictionary['allowsRecurring']
         if 'allowsTokenization' in dictionary:

{onlinepayments-sdk-python3-4.23.0 → onlinepayments_sdk_python3-5.1.0}/onlinepayments/sdk/domain/payment_product130_specific_input.py

@@ -1,20 +1,19 @@
 # -*- coding: utf-8 -*-
 #
-# This class was auto-generated.
+# This file was automatically generated.
 #
-from onlinepayments.sdk.data_object import DataObject
-from onlinepayments.sdk.domain.payment_product130_specific_three_d_secure import PaymentProduct130SpecificThreeDSecure
+from typing import Optional
+
+from .data_object import DataObject
+from .payment_product130_specific_three_d_secure import PaymentProduct130SpecificThreeDSecure
 
 
 class PaymentProduct130SpecificInput(DataObject):
-    """
-    | Object containing specific input required for CB payments
-    """
 
-    __three_d_secure = None
+    __three_d_secure: Optional[PaymentProduct130SpecificThreeDSecure] = None
 
     @property
-    def three_d_secure(self) -> PaymentProduct130SpecificThreeDSecure:
+    def three_d_secure(self) -> Optional[PaymentProduct130SpecificThreeDSecure]:
         """
         | Object containing specific data regarding 3-D Secure
 
@@ -23,16 +22,16 @@ class PaymentProduct130SpecificInput(DataObject):
         return self.__three_d_secure
 
     @three_d_secure.setter
-    def three_d_secure(self, value: PaymentProduct130SpecificThreeDSecure):
+    def three_d_secure(self, value: Optional[PaymentProduct130SpecificThreeDSecure]) -> None:
         self.__three_d_secure = value
 
-    def to_dictionary(self):
+    def to_dictionary(self) -> dict:
         dictionary = super(PaymentProduct130SpecificInput, self).to_dictionary()
         if self.three_d_secure is not None:
             dictionary['threeDSecure'] = self.three_d_secure.to_dictionary()
         return dictionary
 
-    def from_dictionary(self, dictionary):
+    def from_dictionary(self, dictionary: dict) -> 'PaymentProduct130SpecificInput':
         super(PaymentProduct130SpecificInput, self).from_dictionary(dictionary)
         if 'threeDSecure' in dictionary:
             if not isinstance(dictionary['threeDSecure'], dict):