22# coding=utf-8
33# --------------------------------------------------------------------------
44# Copyright (c) Microsoft Corporation. All rights reserved.
5- # Licensed under the MIT License. See License.txt in the project root for
6- # license information.
5+ # Licensed under the MIT License. See License.txt in the project root for license information.
6+ # Code generated by Microsoft (R) Python Code Generator.
7+ # Changes may cause incorrect behavior and will be lost if the code is regenerated.
78# --------------------------------------------------------------------------
8- # pylint: disable=protected-access, arguments-differ, signature-differs, broad-except, too-many-lines
9+ # pylint: disable=protected-access, broad-except
910
1011import copy
1112import calendar
@@ -373,15 +374,34 @@ def __ne__(self, other: typing.Any) -> bool:
373374 return not self .__eq__ (other )
374375
375376 def keys (self ) -> typing .KeysView [str ]:
377+ """
378+ :returns: a set-like object providing a view on D's keys
379+ :rtype: ~typing.KeysView
380+ """
376381 return self ._data .keys ()
377382
378383 def values (self ) -> typing .ValuesView [typing .Any ]:
384+ """
385+ :returns: an object providing a view on D's values
386+ :rtype: ~typing.ValuesView
387+ """
379388 return self ._data .values ()
380389
381390 def items (self ) -> typing .ItemsView [str , typing .Any ]:
391+ """
392+ :returns: set-like object providing a view on D's items
393+ :rtype: ~typing.ItemsView
394+ """
382395 return self ._data .items ()
383396
384397 def get (self , key : str , default : typing .Any = None ) -> typing .Any :
398+ """
399+ Get the value for key if key is in the dictionary, else default.
400+ :param str key: The key to look up.
401+ :param any default: The value to return if key is not in the dictionary. Defaults to None
402+ :returns: D[k] if k in D, else d.
403+ :rtype: any
404+ """
385405 try :
386406 return self [key ]
387407 except KeyError :
@@ -397,17 +417,38 @@ def pop(self, key: str, default: _T) -> _T: ...
397417 def pop (self , key : str , default : typing .Any ) -> typing .Any : ...
398418
399419 def pop (self , key : str , default : typing .Any = _UNSET ) -> typing .Any :
420+ """
421+ Removes specified key and return the corresponding value.
422+ :param str key: The key to pop.
423+ :param any default: The value to return if key is not in the dictionary
424+ :returns: The value corresponding to the key.
425+ :rtype: any
426+ :raises KeyError: If key is not found and default is not given.
427+ """
400428 if default is _UNSET :
401429 return self ._data .pop (key )
402430 return self ._data .pop (key , default )
403431
404432 def popitem (self ) -> typing .Tuple [str , typing .Any ]:
433+ """
434+ Removes and returns some (key, value) pair
435+ :returns: The (key, value) pair.
436+ :rtype: tuple
437+ :raises KeyError: if D is empty.
438+ """
405439 return self ._data .popitem ()
406440
407441 def clear (self ) -> None :
442+ """
443+ Remove all items from D.
444+ """
408445 self ._data .clear ()
409446
410447 def update (self , * args : typing .Any , ** kwargs : typing .Any ) -> None :
448+ """
449+ Updates D from mapping/iterable E and F.
450+ :param any args: Either a mapping object or an iterable of key-value pairs.
451+ """
411452 self ._data .update (* args , ** kwargs )
412453
413454 @typing .overload
@@ -417,6 +458,13 @@ def setdefault(self, key: str, default: None = None) -> None: ...
417458 def setdefault (self , key : str , default : typing .Any ) -> typing .Any : ...
418459
419460 def setdefault (self , key : str , default : typing .Any = _UNSET ) -> typing .Any :
461+ """
462+ Same as calling D.get(k, d), and setting D[k]=d if k not found
463+ :param str key: The key to look up.
464+ :param any default: The value to set if key is not in the dictionary
465+ :returns: D[k] if k in D, else d.
466+ :rtype: any
467+ """
420468 if default is _UNSET :
421469 return self ._data .setdefault (key )
422470 return self ._data .setdefault (key , default )
@@ -574,7 +622,7 @@ def __init__(self, *args: typing.Any, **kwargs: typing.Any) -> None:
574622 def copy (self ) -> "Model" :
575623 return Model (self .__dict__ )
576624
577- def __new__ (cls , * args : typing .Any , ** kwargs : typing .Any ) -> Self : # pylint: disable=unused-argument
625+ def __new__ (cls , * args : typing .Any , ** kwargs : typing .Any ) -> Self :
578626 if f"{ cls .__module__ } { cls .__qualname__ } not in cls ._calculated :
579627 # we know the last nine classes in mro are going to be 'Model', '_MyMutableMapping', 'MutableMapping',
580628 # 'Mapping', 'Collection', 'Sized', 'Iterable', 'Container' and 'object'
@@ -585,8 +633,8 @@ def __new__(cls, *args: typing.Any, **kwargs: typing.Any) -> Self: # pylint: di
585633 annotations = {
586634 k : v
587635 for mro_class in mros
588- if hasattr (mro_class , "__annotations__" ) # pylint: disable=no-member
589- for k , v in mro_class .__annotations__ .items () # pylint: disable=no-member
636+ if hasattr (mro_class , "__annotations__" )
637+ for k , v in mro_class .__annotations__ .items ()
590638 }
591639 for attr , rf in attr_to_rest_field .items ():
592640 rf ._module = cls .__module__
@@ -601,8 +649,8 @@ def __new__(cls, *args: typing.Any, **kwargs: typing.Any) -> Self: # pylint: di
601649
602650 def __init_subclass__ (cls , discriminator : typing .Optional [str ] = None ) -> None :
603651 for base in cls .__bases__ :
604- if hasattr (base , "__mapping__" ): # pylint: disable=no-member
605- base .__mapping__ [discriminator or cls .__name__ ] = cls # type: ignore # pylint: disable=no-member
652+ if hasattr (base , "__mapping__" ):
653+ base .__mapping__ [discriminator or cls .__name__ ] = cls # type: ignore
606654
607655 @classmethod
608656 def _get_discriminator (cls , exist_discriminators ) -> typing .Optional ["_RestField" ]:
@@ -613,7 +661,7 @@ def _get_discriminator(cls, exist_discriminators) -> typing.Optional["_RestField
613661
614662 @classmethod
615663 def _deserialize (cls , data , exist_discriminators ):
616- if not hasattr (cls , "__mapping__" ): # pylint: disable=no-member
664+ if not hasattr (cls , "__mapping__" ):
617665 return cls (data )
618666 discriminator = cls ._get_discriminator (exist_discriminators )
619667 if discriminator is None :
@@ -633,7 +681,7 @@ def _deserialize(cls, data, exist_discriminators):
633681 discriminator_value = data .find (xml_name ).text # pyright: ignore
634682 else :
635683 discriminator_value = data .get (discriminator ._rest_name )
636- mapped_cls = cls .__mapping__ .get (discriminator_value , cls ) # pyright: ignore # pylint: disable=no-member
684+ mapped_cls = cls .__mapping__ .get (discriminator_value , cls ) # pyright: ignore
637685 return mapped_cls ._deserialize (data , exist_discriminators )
638686
639687 def as_dict (self , * , exclude_readonly : bool = False ) -> typing .Dict [str , typing .Any ]:
@@ -754,7 +802,7 @@ def _get_deserialize_callable_from_annotation( # pylint: disable=too-many-retur
754802 except AttributeError :
755803 model_name = annotation
756804 if module is not None :
757- annotation = _get_model (module , model_name )
805+ annotation = _get_model (module , model_name ) # type: ignore
758806
759807 try :
760808 if module and _is_model (annotation ):
@@ -894,6 +942,35 @@ def _deserialize(
894942 return _deserialize_with_callable (deserializer , value )
895943
896944
945+ def _failsafe_deserialize (
946+ deserializer : typing .Any ,
947+ value : typing .Any ,
948+ module : typing .Optional [str ] = None ,
949+ rf : typing .Optional ["_RestField" ] = None ,
950+ format : typing .Optional [str ] = None ,
951+ ) -> typing .Any :
952+ try :
953+ return _deserialize (deserializer , value , module , rf , format )
954+ except DeserializationError :
955+ _LOGGER .warning (
956+ "Ran into a deserialization error. Ignoring since this is failsafe deserialization" , exc_info = True
957+ )
958+ return None
959+
960+
961+ def _failsafe_deserialize_xml (
962+ deserializer : typing .Any ,
963+ value : typing .Any ,
964+ ) -> typing .Any :
965+ try :
966+ return _deserialize_xml (deserializer , value )
967+ except DeserializationError :
968+ _LOGGER .warning (
969+ "Ran into a deserialization error. Ignoring since this is failsafe deserialization" , exc_info = True
970+ )
971+ return None
972+
973+
897974class _RestField :
898975 def __init__ (
899976 self ,
0 commit comments