o 2g6(@sdZddlmZddlmZddlmZddlmZGddde Z Gd d d Z Gd d d e Z Gd dde Z Gddde ZGddde ZGddde ZGddde ZGddde ZGddde ZGddde ZGdddeZGdd d e ZGd!d"d"eZd#S)$aNPRAW exception classes. Includes two main exceptions: :class:`.RedditAPIException` for when something goes wrong on the server side, and :class:`.ClientException` when something goes wrong on the client side. Both of these classes extend :class:`.PRAWException`. All other exceptions are subclassed from :class:`.ClientException`. ) annotations)Any)warn)_deprecate_argsc@eZdZdZdS) PRAWExceptionz@The base PRAW Exception that all other exception classes extend.N__name__ __module__ __qualname____doc__rrG/home/garg/my-data/venv/lib/python3.10/site-packages/praw/exceptions.pyrrcsbeZdZdZedddZdfd d Zed d d ddddddZdddZ dddZ Z S)RedditErrorItemz5Represents a single error returned from Reddit's API.returnstrcCs6|j}|jr|d|j7}|jr|d|j7}|S)z'Get the completed error message string.z: z on field  error_typemessagefield)self error_strrrr error_messages zRedditErrorItem.error_messageotherRedditErrorItem | list[str]boolcs6t|tr|j|j|jf|j|j|jfkSt|S)zCheck for equality.) isinstancerrrrsuper__eq__)rr __class__rrr $s  zRedditErrorItem.__eq__rrrN)rr str | NonecCs||_||_||_dS)aInitialize a :class:`.RedditErrorItem` instance. :param error_type: The error type set on Reddit's end. :param field: The input field associated with the error, if available. :param message: The associated message for the error. Nr)rrrrrrr__init__.s zRedditErrorItem.__init__cCs&|jjd|jd|jd|jdS)z?Return an object initialization representation of the instance.z (error_type=z , message=z, field=))r"r rrrrrrr__repr__As zRedditErrorItem.__repr__cCs|jS)z(Get the message returned from str(self).)rr&rrr__str__HszRedditErrorItem.__str__rr)rrrr)rrrr#rr#) r r r r propertyrr rr$r'r( __classcell__rrr!rrs   rc@r)ClientExceptionzEIndicate exceptions that don't involve interaction with Reddit's API.Nr rrrrr,Mrr,c eZdZdZfddZZS)DuplicateReplaceExceptionzKIndicate exceptions that involve the replacement of :class:`.MoreComments`.ctddS)z:Initialize a :class:`.DuplicateReplaceException` instance.ziA duplicate comment has been detected. Are you attempting to call 'replace_more_comments' more than once?Nrr$r&r!rrr$Tsz"DuplicateReplaceException.__init__r r r r r$r+rrr!rr.Qr.cs"eZdZdZdfdd ZZS)InvalidFlairTemplateIDz@Indicate exceptions where an invalid flair template ID is given. template_idrcstd|ddS)z8Initialize an :class:`.InvalidFlairTemplateID` instance.zThe flair template ID 'zO' is invalid. If you are trying to create a flair, please use the 'add' method.Nr0)rr4r!rrr$_s zInvalidFlairTemplateID.__init__)r4rr1rrr!rr3\sr3cr-)InvalidImplicitAuthzDIndicate exceptions where an implicit auth type is used incorrectly.cr/)z5Initialize an :class:`.InvalidImplicitAuth` instance.zrr$)rr>r=r!rrr$szTooLargeMediaException.__init__)r>r?r=r?r9rrr!rr<sr<csNeZdZdZedddZejdddZejddZdfd d ZZ S)WebSocketExceptionz0Indicate exceptions caused by use of WebSockets.r ExceptioncCstdtdd|jS)z=Access the ``original_exception`` attribute (now deprecated).zAccessing the attribute 'original_exception' is deprecated. Please rewrite your code in such a way that this attribute does not need to be used. It will be removed in PRAW 8.0.category stacklevel)rDeprecationWarning_original_exceptionr&rrroriginal_exceptions z%WebSocketException.original_exceptionvaluecCs ||_dSNrG)rrIrrrrHs cCs|`dSrJrKr&rrrrHsrr exceptionException | Nonecst|||_dS)aInitialize a :class:`.WebSocketException` instance. :param message: The exception message. :param exception: The exception thrown by the websocket library. .. note:: This parameter is deprecated. It will be removed in PRAW 8.0. N)rr$rG)rrrLr!rrr$s zWebSocketException.__init__)rrA)rIrA)rrrLrM) r r r r r*rHsetterdeleterr$r+rrr!rr@s   r@cr-)MediaPostFailedz0Indicate exceptions where media uploads failed..cstdddS)z0Initialize a :class:`.MediaPostFailed` instance.zThe attempted media upload action has failed. Possible causes include the corruption of media files. Check that the media file can be opened on your local machine.Nr0r&r!rrr$szMediaPostFailed.__init__r1rrr!rrPr2rPcsdeZdZdZedddZedd d Zedd d Zedd dZ dfdd Z dddZ Z S) APIExceptionzOld class preserved for alias purposes. .. deprecated:: 7.0 Class :class:`.APIException` has been deprecated in favor of :class:`.RedditAPIException`. This class will be removed in PRAW 8.0. exceptions!list[RedditErrorItem | list[str]]rlist[RedditErrorItem]cCsdd|DS)z?Covert an exception list into a :class:`.RedditErrorItem` list.cSsTg|]&}t|tr |nt|dt|dr|dndt|dr$|dnddqS)rrBr)rrr)rrr).0rLrrr s z5APIException.parse_exception_list..r)rRrrrparse_exception_lists z!APIException.parse_exception_listrcC |dS)aWGet error_type. .. deprecated:: 7.0 Accessing attributes through instances of :class:`.RedditAPIException` is deprecated. This behavior will be removed in PRAW 8.0. Check out the :ref:`PRAW 7 Migration tutorial ` on how to migrate code from this behavior. r _get_old_attrr&rrrr zAPIException.error_typecCrY)aRGet field. .. deprecated:: 7.0 Accessing attributes through instances of :class:`.RedditAPIException` is deprecated. This behavior will be removed in PRAW 8.0. Check out the :ref:`PRAW 7 Migration tutorial ` on how to migrate code from this behavior. rrZr&rrrrr\zAPIException.fieldcCrY)aTGet message. .. deprecated:: 7.0 Accessing attributes through instances of :class:`.RedditAPIException` is deprecated. This behavior will be removed in PRAW 8.0. Check out the :ref:`PRAW 7 Migration tutorial ` on how to migrate code from this behavior. rrZr&rrrrr\zAPIException.messageitems-list[RedditErrorItem | list[str] | str] | str optional_argscsTt|tr |g|g}nt|trt|dtr|g}|||_tj|jdS)a@Initialize a :class:`.RedditAPIException` instance. :param items: Either a list of instances of :class:`.RedditErrorItem` or a list containing lists of unformed errors. :param optional_args: Takes the second and third arguments that :class:`.APIException` used to take. rN)rrlistrXr]rr$)rr]r_r!rrr$s  zAPIException.__init__attrnamercCs&td|dtddt|jd|S)NzAccessing attribute 'z' through APIException is deprecated. This behavior will be removed in PRAW 8.0. Check out https://praw.readthedocs.io/en/latest/package_info/praw7_migration.html to learn how to migrate your code.rCr)rrFgetattrr])rrarrrr[&s  zAPIException._get_old_attr)rRrSrrTr))r]r^r_r)rarrr) r r r r staticmethodrXr*rrrr$r[r+rrr!rrQs     rQc@r)RedditAPIExceptionz/Container for error messages from Reddit's API.Nr rrrrre2rreN)r __future__rtypingrwarningsrutilrrArrr,r.r3r5r6r:r;r<r@rPrQrerrrrs&   6  & f