{i6(jSrSSKJr SSKJr SSKJr SSKJr "SS\ 5r "S S 5r "S S \ 5r "S S\ 5r "SS\ 5r"SS\ 5r"SS\ 5r"SS\ 5r"SS\ 5r"SS\ 5r"SS\ 5r"SS\5r"SS \ 5r"S!S"\5rg#)$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\rSrSrSrSrg) PRAWExceptionz@The base PRAW Exception that all other exception classes extend.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r I/home/james-whalen/.local/lib/python3.13/site-packages/praw/exceptions.pyr r sJrr c^\rSrSrSr\SSj5rSU4Sjjr\"SSS5SSS .SS jj5r SS jr SS jr S r U=r $)RedditErrorItemz5Represents a single error returned from Reddit's API.cURnUR(aUSUR<3- nUR(aUSUR<3- nU$)z'Get the completed error message string.z: z on field  error_typemessagefield)self error_strs r error_messageRedditErrorItem.error_messagesLOO << 2dll-. .I :: :djj^4 4Irc>[U[5(aGURURUR4URURUR4:H$[ TU]U5$)zCheck for equality.) isinstancerrrrsuper__eq__)rother __class__s rr$RedditErrorItem.__eq__$s^ e_ - -OOT\\4::>    C  w~e$$rrrrN)rrc(XlX0lX lg)zInitialize 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)rrrrs r__init__RedditErrorItem.__init__.s%  rcURRSUR<SUR<SUR<S3$)z?Return an object initialization representation of the instance.z (error_type=z , message=z, field=))r&r rrrrs r__repr__RedditErrorItem.__repr__AsF~~&&'|DOO3FG 'x ~Q @ rcUR$)z(Get the message returned from str(self).)rr-s r__str__RedditErrorItem.__str__Hs!!!rrrrreturnstr)r%zRedditErrorItem | list[str]r5bool)rr6r str | Nonerr8)r rrrrpropertyrr$rr)r.r1r __classcell__r&s@rrrsm? %\9g6 !"    7$ ""rrc\rSrSrSrSrg)ClientExceptionMzEIndicate exceptions that don't involve interaction with Reddit's API.r Nr r rrr=r=MsOrr=c,^\rSrSrSrU4SjrSrU=r$)DuplicateReplaceExceptionQzKIndicate exceptions that involve the replacement of :class:`.MoreComments`.c$>[TU]S5 g)z:Initialize a :class:`.DuplicateReplaceException` instance.ziA duplicate comment has been detected. Are you attempting to call 'replace_more_comments' more than once?Nr#r)rr&s rr)"DuplicateReplaceException.__init__Ts  7 rr r rrrrr)rr:r;s@rr@r@QsU  rr@c0^\rSrSrSrSU4SjjrSrU=r$)InvalidFlairTemplateID\z@Indicate exceptions where an invalid flair template ID is given.c,>[TU]SUS35 g)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.NrC)r template_idr&s rr)InvalidFlairTemplateID.__init___s! %k]3< < rr )rKr6rFr;s@rrHrH\sJ  rrHc,^\rSrSrSrU4SjrSrU=r$)InvalidImplicitAuthgzDIndicate exceptions where an implicit auth type is used incorrectly.c$>[TU]S5 g)z5Initialize an :class:`.InvalidImplicitAuth` instance.z[TU]URU55 g)zInitialize an :class:`.InvalidURL` instance. :param url: The invalid URL. :param message: The message to display. Must contain a format identifier (``{}`` or ``{0}``) (default: ``"Invalid URL: {}"``). N)r#r)format)rrUrr&s rr)InvalidURL.__init__rs ,-rr )rUr6rr6 r rrrrrr)rr:r;s@rrSrSos'>UI&3D..'.rrSc\rSrSrSrSrg)!MissingRequiredAttributeException~zAIndicate exceptions caused by not including a required attribute.r Nr r rrr[r[~sKrr[c\rSrSrSrSrg)ReadOnlyExceptionzJRaised when a method call requires :attr:`.read_only` mode to be disabled.r Nr r rrr^r^sTrr^cH^\rSrSrSr\"SS5SU4Sjj5rSrU=r$)TooLargeMediaExceptionz:Indicate exceptions from uploading media that's too large. maximum_sizeactualcJ>X lXl[TU] SUSUS35 g)zInitialize a :class:`.TooLargeMediaException` instance. :param actual: The actual size of the uploaded media. :param maximum_size: The maximum size of the uploaded media. z;The media that you uploaded was too large (maximum size is z bytes, uploaded z bytes)N)rcrdr#r))rrdrcr&s rr)TooLargeMediaException.__init__s2)  I,xw 0 r)rdrc)rdintrcrgrYr;s@rrarasD^X.  /  rrac^\rSrSrSr\SSj5r\RS Sj5r\RS5rS U4Sjjr Sr U=r $) WebSocketExceptionz0Indicate exceptions caused by use of WebSockets.c8[S[SS9 UR$)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-s roriginal_exception%WebSocketException.original_exceptions'  ,(  '''rcXlgNrq)rvalues rrrrss#( rcU?grurvr-s rrrrss  $rc0>[TU]U5 X lg)zInitialize 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)r#r)rq)rr exceptionr&s rr)WebSocketException.__init__s !#, rrv)r5 Exception)rwr|)rr6rzzException | None) r rrrrr9rrsetterdeleterr)rr:r;s@rririsV:  ( ())% % - -rric,^\rSrSrSrU4SjrSrU=r$)MediaPostFailedz0Indicate exceptions where media uploads failed..c&>[TU]SS5 g)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.NrCrDs rr)MediaPostFailed.__init__s  #   rr rFr;s@rrrs:  rrc^\rSrSrSr\S Sj5r\S Sj5r\S Sj5r \S Sj5r S U4Sjjr S Sjr S r U=r$) 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. c UVs/sHXn[U[5(aUO=[US[US5(aUSOS[US5(aUSOSS9PMZ sn$s snf)z?Covert an exception list into a :class:`.RedditErrorItem` list.rrlrr3)r"rr7) exceptionsrzs rparse_exception_list!APIException.parse_exception_lists~(  ( i99$(|*.y|*<*<)A,",01,>,>IaLB(   sAA'c$URS5$)a'Get 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-s rrAPIException.error_types!!,//rc$URS5$)a"Get 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. rrr-s rrAPIException.fields!!'**rc$URS5$)a$Get 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. rrr-s rrAPIException.messages!!),,rc>[U[5(aU/UQ/nO0[U[5(a[US[5(aU/nURU5Ul[ TU]"UR6 g)aInitialize 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)r"r6listritemsr#r))rr optional_argsr&s rr)APIException.__init__si eS ! !,m,-E t $ $E!Hc)B)BGE..u5  $**%rcZ[SUS3[SS9 [URSU5$)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.rmr)rrpgetattrr)rattrnames rrAPIException._get_old_attr&s: #H:.2 2(  tzz!}h//r)r)rz!list[RedditErrorItem | list[str]]r5zlist[RedditErrorItem]r4)rz-list[RedditErrorItem | list[str] | str] | strrr6)rr6r5r)r rrrr staticmethodrr9rrrr)rrr:r;s@rrrs 5   " 0 0 + + - -&<&&( 0 0rrc\rSrSrSrSrg)RedditAPIExceptioni2z/Container for error messages from Reddit's API.r Nr r rrrr2s9rrN)r __future__rtypingrwarningsrutilrr|r rr=r@rHrNrSr[r^rarirrrr rrrs#!KIK3"3"lPmP   _ Y/Y . .LLUU _ &#-#-L  (  c0=c0L::r