1+ # pylint: disable=too-many-lines
12# coding=utf-8
23# --------------------------------------------------------------------------
34# Copyright (c) Microsoft Corporation. All rights reserved.
45# Licensed under the MIT License. See License.txt in the project root for
56# license information.
67# --------------------------------------------------------------------------
7- # pylint: disable=protected-access, arguments-differ, signature-differs, broad-except, too-many-lines
8+ # pylint: disable=protected-access, broad-except
89
910import copy
1011import calendar
@@ -372,15 +373,34 @@ def __ne__(self, other: typing.Any) -> bool:
372373 return not self .__eq__ (other )
373374
374375 def keys (self ) -> typing .KeysView [str ]:
376+ """
377+ :returns: a set-like object providing a view on D's keys
378+ :rtype: ~typing.KeysView
379+ """
375380 return self ._data .keys ()
376381
377382 def values (self ) -> typing .ValuesView [typing .Any ]:
383+ """
384+ :returns: an object providing a view on D's values
385+ :rtype: ~typing.ValuesView
386+ """
378387 return self ._data .values ()
379388
380389 def items (self ) -> typing .ItemsView [str , typing .Any ]:
390+ """
391+ :returns: set-like object providing a view on D's items
392+ :rtype: ~typing.ItemsView
393+ """
381394 return self ._data .items ()
382395
383396 def get (self , key : str , default : typing .Any = None ) -> typing .Any :
397+ """
398+ Get the value for key if key is in the dictionary, else default.
399+ :param str key: The key to look up.
400+ :param any default: The value to return if key is not in the dictionary. Defaults to None
401+ :returns: D[k] if k in D, else d.
402+ :rtype: any
403+ """
384404 try :
385405 return self [key ]
386406 except KeyError :
@@ -396,17 +416,38 @@ def pop(self, key: str, default: _T) -> _T: ...
396416 def pop (self , key : str , default : typing .Any ) -> typing .Any : ...
397417
398418 def pop (self , key : str , default : typing .Any = _UNSET ) -> typing .Any :
419+ """
420+ Removes specified key and return the corresponding value.
421+ :param str key: The key to pop.
422+ :param any default: The value to return if key is not in the dictionary
423+ :returns: The value corresponding to the key.
424+ :rtype: any
425+ :raises KeyError: If key is not found and default is not given.
426+ """
399427 if default is _UNSET :
400428 return self ._data .pop (key )
401429 return self ._data .pop (key , default )
402430
403431 def popitem (self ) -> typing .Tuple [str , typing .Any ]:
432+ """
433+ Removes and returns some (key, value) pair
434+ :returns: The (key, value) pair.
435+ :rtype: tuple
436+ :raises KeyError: if D is empty.
437+ """
404438 return self ._data .popitem ()
405439
406440 def clear (self ) -> None :
441+ """
442+ Remove all items from D.
443+ """
407444 self ._data .clear ()
408445
409446 def update (self , * args : typing .Any , ** kwargs : typing .Any ) -> None :
447+ """
448+ Updates D from mapping/iterable E and F.
449+ :param any args: Either a mapping object or an iterable of key-value pairs.
450+ """
410451 self ._data .update (* args , ** kwargs )
411452
412453 @typing .overload
@@ -416,6 +457,13 @@ def setdefault(self, key: str, default: None = None) -> None: ...
416457 def setdefault (self , key : str , default : typing .Any ) -> typing .Any : ...
417458
418459 def setdefault (self , key : str , default : typing .Any = _UNSET ) -> typing .Any :
460+ """
461+ Same as calling D.get(k, d), and setting D[k]=d if k not found
462+ :param str key: The key to look up.
463+ :param any default: The value to set if key is not in the dictionary
464+ :returns: D[k] if k in D, else d.
465+ :rtype: any
466+ """
419467 if default is _UNSET :
420468 return self ._data .setdefault (key )
421469 return self ._data .setdefault (key , default )
@@ -573,7 +621,7 @@ def __init__(self, *args: typing.Any, **kwargs: typing.Any) -> None:
573621 def copy (self ) -> "Model" :
574622 return Model (self .__dict__ )
575623
576- def __new__ (cls , * args : typing .Any , ** kwargs : typing .Any ) -> Self : # pylint: disable=unused-argument
624+ def __new__ (cls , * args : typing .Any , ** kwargs : typing .Any ) -> Self :
577625 if f"{ cls .__module__ } { cls .__qualname__ } not in cls ._calculated :
578626 # we know the last nine classes in mro are going to be 'Model', '_MyMutableMapping', 'MutableMapping',
579627 # 'Mapping', 'Collection', 'Sized', 'Iterable', 'Container' and 'object'
@@ -584,8 +632,8 @@ def __new__(cls, *args: typing.Any, **kwargs: typing.Any) -> Self: # pylint: di
584632 annotations = {
585633 k : v
586634 for mro_class in mros
587- if hasattr (mro_class , "__annotations__" ) # pylint: disable=no-member
588- for k , v in mro_class .__annotations__ .items () # pylint: disable=no-member
635+ if hasattr (mro_class , "__annotations__" )
636+ for k , v in mro_class .__annotations__ .items ()
589637 }
590638 for attr , rf in attr_to_rest_field .items ():
591639 rf ._module = cls .__module__
@@ -600,8 +648,8 @@ def __new__(cls, *args: typing.Any, **kwargs: typing.Any) -> Self: # pylint: di
600648
601649 def __init_subclass__ (cls , discriminator : typing .Optional [str ] = None ) -> None :
602650 for base in cls .__bases__ :
603- if hasattr (base , "__mapping__" ): # pylint: disable=no-member
604- base .__mapping__ [discriminator or cls .__name__ ] = cls # type: ignore # pylint: disable=no-member
651+ if hasattr (base , "__mapping__" ):
652+ base .__mapping__ [discriminator or cls .__name__ ] = cls # type: ignore
605653
606654 @classmethod
607655 def _get_discriminator (cls , exist_discriminators ) -> typing .Optional ["_RestField" ]:
@@ -612,7 +660,7 @@ def _get_discriminator(cls, exist_discriminators) -> typing.Optional["_RestField
612660
613661 @classmethod
614662 def _deserialize (cls , data , exist_discriminators ):
615- if not hasattr (cls , "__mapping__" ): # pylint: disable=no-member
663+ if not hasattr (cls , "__mapping__" ):
616664 return cls (data )
617665 discriminator = cls ._get_discriminator (exist_discriminators )
618666 if discriminator is None :
@@ -632,11 +680,11 @@ def _deserialize(cls, data, exist_discriminators):
632680 discriminator_value = data .find (xml_name ).text # pyright: ignore
633681 else :
634682 discriminator_value = data .get (discriminator ._rest_name )
635- mapped_cls = cls .__mapping__ .get (discriminator_value , cls ) # pyright: ignore # pylint: disable=no-member
683+ mapped_cls = cls .__mapping__ .get (discriminator_value , cls ) # pyright: ignore
636684 return mapped_cls ._deserialize (data , exist_discriminators )
637685
638686 def as_dict (self , * , exclude_readonly : bool = False ) -> typing .Dict [str , typing .Any ]:
639- """Return a dict that can be JSONify using json.dump.
687+ """Return a dict that can be turned into json using json.dump.
640688
641689 :keyword bool exclude_readonly: Whether to remove the readonly properties.
642690 :returns: A dict JSON compatible object
@@ -733,7 +781,7 @@ def _sorted_annotations(types: typing.List[typing.Any]) -> typing.List[typing.An
733781 )
734782
735783
736- def _get_deserialize_callable_from_annotation ( # pylint: disable=R0911, R0915, R0912
784+ def _get_deserialize_callable_from_annotation ( # pylint: disable=too-many-return-statements, too-many-branches
737785 annotation : typing .Any ,
738786 module : typing .Optional [str ],
739787 rf : typing .Optional ["_RestField" ] = None ,
@@ -753,7 +801,7 @@ def _get_deserialize_callable_from_annotation( # pylint: disable=R0911, R0915,
753801 except AttributeError :
754802 model_name = annotation
755803 if module is not None :
756- annotation = _get_model (module , model_name )
804+ annotation = _get_model (module , model_name ) # type: ignore
757805
758806 try :
759807 if module and _is_model (annotation ):
@@ -893,6 +941,35 @@ def _deserialize(
893941 return _deserialize_with_callable (deserializer , value )
894942
895943
944+ def _failsafe_deserialize (
945+ deserializer : typing .Any ,
946+ value : typing .Any ,
947+ module : typing .Optional [str ] = None ,
948+ rf : typing .Optional ["_RestField" ] = None ,
949+ format : typing .Optional [str ] = None ,
950+ ) -> typing .Any :
951+ try :
952+ return _deserialize (deserializer , value , module , rf , format )
953+ except DeserializationError :
954+ _LOGGER .warning (
955+ "Ran into a deserialization error. Ignoring since this is failsafe deserialization" , exc_info = True
956+ )
957+ return None
958+
959+
960+ def _failsafe_deserialize_xml (
961+ deserializer : typing .Any ,
962+ value : typing .Any ,
963+ ) -> typing .Any :
964+ try :
965+ return _deserialize_xml (deserializer , value )
966+ except DeserializationError :
967+ _LOGGER .warning (
968+ "Ran into a deserialization error. Ignoring since this is failsafe deserialization" , exc_info = True
969+ )
970+ return None
971+
972+
896973class _RestField :
897974 def __init__ (
898975 self ,
0 commit comments