+ ȟcs^RIHt^RIt^RIt^RIt^RIHtHtHtH t H t ^RI t ^RI H t ^RI Ht^RIHt^RIHtHtHt^RIHtHt^R IHt^R IHt^R IHtHtHtHtH t H!t!H"t"H#t#H$t$H%t%H&t&H't'H(t(H)t)H*t*H+t+H,t,H-t-H.t.]'d^R IH/t/H0t0^R IH1t1^RIH2t2H3t3H4t4H5t5H6t6H7t7!RR4t8!RR4t9!RR4t:]"!RR]44t;]"!RR]44t<!RR4t=R#)i) annotationsN) TYPE_CHECKINGAnyListTupleUnion) BeautifulSoup)utils) parse_page) ResultList Thumbnail_parse_results)Status ThumbnailType)ModdbException)Member)BASE_URLCOMMENT_LIMITERGLOBAL_LIMITERGLOBAL_THROTLELOGGER SSLAdapter concat_docs generate_hashgenerate_login_cookiesgetget_date get_page_type get_siteareaget_siteareaidjoinraise_for_status ratelimitsoupuser_agent_list)CommentTag) WatchType)EngineGameGroupModReviewTeamcs,]tRt^-tRtRRltRtRtR#)MessageaA single message within a thread. Attributes ----------- id : int The id of the message member : Thumbnail A member type thumbnail representing the member who sent the message timestamp : datetime.datetime Message send date text : str The html text of the message cV^8dQhRR/#htmlrZformat"1/usr/lib/python3.14/site-packages/moddb/client.py __annotate__ZMessage.__annotate__=s<<]<c sHVPRRR7p\VR,4Vn\VR,\P VR,R7Vn\ VPR4R,4VnVPR R R7PVnR #) aZavatarZclass_idhreftitle)urltypenametimedatetimedivcommentN) findintr9r r memberr timestamptext)selfr0rE&& r4__init__ZMessage.__init__=sx3x0d4j/F6N9M9MTZ[bTcd !$))F"3J"?@IIeII6;; r6c "RVP R2#)z< Message member= >)rErH&r4__repr__ZMessage.__repr__Es"4;;-r22r6)r9rErGrFN__name__ __module__ __qualname____firstlineno____doc__rJrO__static_attributes__r1r6r4r,r,-s <3r6r,cs,]tRt^ItRtRRltRtRtR#)ThreadaA thread is a conversation between two or more members in which one or more messages can be sent. Sorting -------- * **id** - when the message was sent, asc is oldest, desc is most recent * **name** - order alphabetically, asc is a-z, desc is z-a * **hasread** - order by whether or the message has been read, asc is unread first, desc is read first * **hasreplied** - order by whether or not you have replied to the message, asc us unreplied first, desc is replied first Attributes ----------- name : str Name of the thread id : int Id of the thread count : int The number of messages in this thread members : List[Tumbnail] All the members participating in the thread. Note: The thumbnail of the member who fetched the message will always be first and will have their name attribute be 'you' instead of the username message : List[Message] The messages associated to this thread cr-r.r1r2r3r4r5ZThread.__annotate__esCC]Cr6c  sXVPRRR7pVPRRR7pVPRRR7Pp\P!RV4pVfW@n^VnM5VP ^4Vn\VP ^44VnVPR R R7PPR 4pVPR R .R7pVPRR .R7PRRR7p\VR,VR,PR4^,R4Vn VU u.uF0p \V R,V P\PR7NK2 up VnVU u.uFp \!V 4NK up VnR#uup iuup i)rAZ firstmessager9Z normalcornerr8spanZheadingz(.*) \(([0-9]*) messages?\)NpZ introductionr7Z deleteiconZ tablecommentsFZ recursiver:Z=)r<r>r=)rCstringreZmatchr>countZgrouprDZstrongfind_allZindexr9r r rEmembersr,messages) rHr0threadZheaderZ header_stringZ header_matchr`ZoptionrarEmessages && r4rJZThread.__init__est5^4U>: F9 =DD xx > N  %IDJ$**1-DI\//23DJ++c.+9@@II#NS,8;;uo->;?HHZ_H`fVnVF^%9%9#%>%B%DEF" ! &.v}}=CWCW X!  :BBg)B  Cs 6F"F'c <RVP RVP R2#)z< Thread name=z count=rL)r>r^rMrNr4rOZThread.__repr__}s {'$**R@@r6)r^r9r`rar>NrPr1r6r4rWrWIs6C0Ar6rWcs&]tRt^tRtRtRtRtR#)ThreadThumbnailaThe thumbnail of a thread, these represent partial objects that must be parsed using a client to get the full thread. Attributes ----------- name : str The name of the thread id : int The id of the thread url : str The url for the thread last_messager : Thumbnail A thumbnail representig the user that sent the last message timestamp : datetime.datetime Datetime of the last message content : str Content of the last message. Useful for checking the last message without having to parse the thread. c sTVPR4Vn\VPR44VnVPR4VnVPR4VnVPR4Vn\VPPR4R,4Vn R#)r>r< last_messagerrFcontentZ/N) rr>rr<rfrFrgrDZsplitr9)rHkwargss&,r4rJZThreadThumbnail.__init__svJJv&  5)*#ZZ8K0zz), dhhnnS)"-.r6c rd)z< ThreadThumbnail name=z last_messager=rL)r>rfrMrNr4rOZThreadThumbnail.__repr__s#( ?4CUCUBVVXYYr6)rgr9rfr>rFr<NrPr1r6r4reres*/Zr6recsJa]tRt^tRtV3RltRtRRltRRltRt V;t #) UpdatezAn update object. Which is basically just a fancy thumbnail with a couple extra attributes and methods. Attributes ----------- updates : List[Thumbnail] A list of thumbnail objects of the things thave have been posted (new files, new images) c s<\SV`!R/VBVPR4Vn\ VPR44Vn\ VPR44VnVPR4VnR#)updatesunfollowclearclientNr1)superrJrrkr _unfollow_url _clear_url_clientrHZattrs __class__&,r4rJZUpdate.__init__s^ !5!yy+ !%))J"78uyy12yy* r6c s|RVP RVPP R\VP4 R2#)z )r>r=ZlenrkrMrNr4rOZUpdate.__repr__s5tyyk /?yT\\IZH[[\]]r6cr-r/returnboolr1r2r3r4r5Update.__annotate__s::t:r6c VPPRVPRR/R7pRVP4R,9#)zClears all updates Raises ------- ModdbException An error has occured while trying to clear the updates for this page Returns -------- bool True if the updates were successfully cleared POSTajaxtdatasuccessfully removedrG)rr_requestrqjsonrHr& r4rmZ Update.clears= LL ! !&$// ! N%&)999r6cr-rwr1r2r3r4r5rzs88$8r6c r{)zUnfollows the page. This will also clear the updates Raises ------- ModdbException An error has occured while trying to unfollow this page Returns -------- bool True if the page was successfully unfollowed r|r}r~rzno longer watchingrG)rrrrprrrr4rlZUpdate.unfollows? LL ! !&$*<*rMrNr4rOZRequest.__repr__ s {!,,r6)rrrr) rQrRrSrTrUrJrrrOrVrrrr4rrs! +6":"--r6rcs]tRtRtRtRRltRtRtRt] !] ] 4R4t R R lt R R ltR RltRFRRlltRRltRRltRRltRRltRRltRRltRRlt] !]4RR /R!R"ll4tR#tR$R%ltR&R'ltR(R)ltR*R R+R,/R-R.lltR/R0ltRGR1R2llt R3R4lt!R5R6lt"R7R8lt#R9R:lt$R;R<lt%R=R>lt&R?R@lt'RARBlt(RCRDlt)REt*R #)HClientiaLogin the user to moddb through the library, this allows user to see guest comments and see private groups they are part of. In addition, this can be used for a lot of the operation Parameters ----------- username : str The username of the user password : str The password associated to that username Raises ------- ValueError The password or username was incorrect Attributes ---------- member : Member The member objects this client instance represents cs V^8dQhRRRR/#)r/usernamestrpasswordr1r2r3r4r5Client.__annotate__(s       r6c  sZ\P!4pVPR\44\ WVR7VnW0n\P!RV4\\VPR\ RVPRR4 24P44VnR#)zhttps://)sessionzLogin successful for %sGETz /members/Z_-N)requestsZSessionZmountrrcookies_sessionrinforr!rrZreplacerGrE)rHrrr&&& r4rJZClient.__init__(s""$ j*,/0WU  -x8 u )HprofileZlevelrMrNr4rOZClient.__repr__3s4"4;;#3#3"4GDKKs++DMM,A,AB jjB' &--8    6SU@V --//4 M7;;/ MM  w CTVZ8[  \r6cr-)r/rxz List[Update]r1r2r3r4r5rSs11\1r6c sVPR\ R24p\VP4p.pRpVP RVR7pVUu.uFEpVP P P P RRR7P RRR 7NKG ppVUU u.uFqR RFqNK K p pp V EFp V P R 4p V P R R R 7R,p V P R RR 7R,pV P R4P R 4pTP\V R,V R,\V R,4V PR,TT TVUu.uF2p\VPVR,\VR,4R7NK4 up\V P R4R,4R7 4EK V#uupiuup piuupi)zGet the current updates the user has for models they are subscribed to. Returns -------- List[Update] List of updates (thumbnail like objects with extra methods and an extra attribute) r/messages/updatesrYr\rAtabler8Fr[Nr7z Stop Watchingr;r:ZClearrZr;src)r>r<r=r?r@) r>r<r=imagernrlrmrkdate)z Mods Watchz Members Watchz Engines Watchz Groups Watchz Games Watchrh)rrr!rGr_parentrCappendrjrimgr r\r)rHrr0rkZstringsrawZeZobjectsZsublistZitemZ objects_rawZupdate thumbnailrlrmZ updates_rawZxs& r4 get_updatesZClient.get_updatesSs MM%H:->!? @AFF| mmF7m3  HHOO " " ' 'g ' > G GY^ G _  ,3L7s|tt|t7 L!F C(I{{3o{>vFHKK7K3F;E ++c*33C8K NN"7+!&)&y'89#--.%"-!,A"qxxQvY]STU[S\E]^!,"&++f"5j"AB   ".; M s A GG)8Gc V^8dQhRRRR/#)r/categoryr%rxryr1r2r3r4r5rs::i:D:r6c sVVPR\ R24p\VP4p\P !RVP R24pVPRVR7pVfR#VPR\ VR , 2R R /R 7pR VP4R,9#)a5Clear all updates for a specific category of watched. This method will conduct two requests because the clear update request requires a hash generated by moddb. Parameters ----------- category: WatchType The category of watched to clear Returns -------- bool Whether or not the clear was successful rrz.*\/clearall\/(.*)\/1\/sr7)r:Tr|r:r}r~rzupdates were clearedrG) rrr!rGr]Zcompiler>rCr)rHrZ hash_pager0ZpatternZlinkrs&& r4 clear_updatesZClient.clear_updatess MM%H:5F)GH INN#** 7 aHIyy7y+ < MM&XJtF|n"=VSMM R%&)999r6cr-)r/rxz List[Request]r1r2r3r4r5rs""]"r6c sVPR\ R24p\VP4p.pVP RRR7pVP P P P RRR7P RR R 7pVR RFpVP R 4pVP R R R7R,pVP R RR7R,p VP!\VR,VR,\VR,4VPR,VVV \VP R4R,4R74K V#)zGet the current friend requests the user has. Returns -------- List[Request] List of requests (thumbnail like objects with extra methods) rrrYzFriend RequestsrrArr8Fr[Nr7ZAcceptrr:ZDecliner;rr?r@)r>r<r=rrnrrrrh) rrr!rGrCrr_rrrrr) rHrr0rrZ raw_requestsZrequestrrrs & r4get_friend_requestsZClient.get_friend_requestss. MM%H:->!? @AFF|ii'8i9zz((//44U74KTT UU $CR(G S)I\\#X\6v>Fll3il8@G OO"7+!&)&y'89#--.!#!',,v"6z"BC   )$r6c$V^8dQhRRRRRR/#)r/rr%pagerDrxr r1r2r3r4r5rs!  I S  r6c s\ RVP R2p\VPRV RV 24P4p\ V4wrVrx\ VVVVVR7#)aaGet a list of thumbnails of watched items based on the type parameters. Eventually, you'll also be able to paginate your mods. Parameters ----------- category : WatchType The type of watched thing you wanna get (mod, games, engines) page : int The page number you want to get Returns -------- ResultList[Thumbnail] List of watched things z/messages/watching/rrz/page/)resultsr< current_page total_pages total_results)rr>r!rrGr r ) rHrrr<r0rrrrs &&& r4 get_watchedZClient.get_watchedsl" -hmm_A>DMM%C5tf)=>CCD#!  %(888r6cr)r/rrrxryr1r2r3r4r5rbsGG3G4Gr6c  sVPR\ R2RRRRR\VP4RVP/R R 7pR VP 4R ,9#) a'Report a page. This can take any object that has an id and url attribute. Parameters ----------- page : Any The page to report Raises ------- ModdbException An error has occured while trying to report the page Returns -------- bool True if the page has been successfully reported r|rr}r~rreportrrFrzalready reported this contentrGrrrIr4rZ Client.reportbsh$ MM j. /(L2dgg  "  /affhv6FFFr6crr/rErrxryr1r2r3r4r5rsHHvH$Hr6c r) aUnfriend this member if you are friends with them. Parameters ----------- member : Member The member you wish to unfriend Raises ------- ModdbException An error has occured trying to unfriend this user Returns -------- bool True if the user was succesfully unfriended r|z/members/ajax/friends/delete/r}r~Frz"no longer friends with this memberrGrrHrErrIr4unfriendZClient.unfriendsO$ MM j5fii[ A#!  4qvvx7GGGr6crrr1r2r3r4r5rsBB6BdBr6c r) aSend a friend request to a user. You will not instantly become friends with them, they will have to accept the friend request you sent them first. Parameters ----------- member : Member The member you wish to send a friend request to Raises ------- ModdbException An error has occured trying to send a friend request to that user Returns -------- bool True if the user was succesfully sent a friend request r|z/members/ajax/friends/add/r}r~Frzfriend request has been sentrGrrrIr4 send_requestZClient.send_requestsO& MM j2699+ >#!  .&1AAAr6rBNcs(V^8dQhRRRRRRRR/#)r/rrrGrrBr#rxr1r2r3r4r5rs(,,,3,G,s,r6c sTPRVPR\4RV'd VPM^R^RVRR/R7pVP \ VP 44#) aAdd a comment to a page. Parameters ----------- page : Any Must be a moddb.page, the page you wish to add the comment to. test : str The content of the comment you wish to post comment : Optional[Comment] If you wish to reply to another comment you must provide the comment object for it there. Returns -------- Any The page's updated object containing the new comment and any other new data that has been posted since then r|formhashZreplyidrsummaryrBz Save commentr)rr<rr9rtr!rG)rHrrGrBrs&&&$ r4 add_commentZClient.add_commentsb( MM  HHMO7::a4>   ~~d166l++r6c sVf \R4hVPR\ R2RRRRRR R VPR VP/R R 7pV#)NzZThis comment no longer exists or is no longer on the page it was initially retrieved from.r|rr}r~rdeleterrBrhashFr)rrrr9_hashrrIr4_comment_state_updateZClient._comment_state_updatesl ? l  MM j. /(Igjj "  r6crrr1r2r3r4r5rsJJgJ$Jr6c sV;_uu_4\VP4p\VPVPR7pRRR4VP X4pRVP 4R,9# +'giL;;i)aThis will delete the supplied comment provided you have the correct permissions. This is an expensive request because if how moddb works. It needs to make two requests in order to get the correct hash to delete the comment. In addition, it may fail if the comment has changed location (page number) from what the object says. It is recommended to use a newly created comment object that is less than 30 minutes old. Parameters ----------- comment : Comment The comment to delete Raises ------- ModdbException An error occured while trying to delete the comment Returns -------- bool True if the comment was successfully deleted rXNz$You have deleted this commentrG)r_urlrZcommentsr9rrrHrBrZupdated_commentr&& r4delete_commentZClient.delete_comments`,Tgll+D!$--GJJ?O  & & 75&9III Ts 7A55 B crrr1r2r3r4r5rsMMMDMr6c  s2V;_uu_4\VP4p\VPVPRR7VPR7pRRR4VP X4pRVP 4R,9# +'giL;;i)aThis will undelete the supplied comment provided you have the correct permissions. This is an expensive request because of how moddb works. It needs to make three requests in order to get the correct hash to undelete the comment. In addition, it may fail if the comment has changed location (page number) from what the object says. It is recommended to use a newly created comment object that is less than 30 minutes old. Parameters ----------- comment : Comment The comment to undelete Raises ------- ModdbException An error occured while trying to undelete the comment Returns -------- bool True if the comment was successfully undeleted T)Z show_deletedrXNz'You have authorized this commentrG)rrrZ_get_comments_from_urlr9rrrrr4undelete_commentZClient.undelete_commentst,Tgll+D!++GLLt+L::O  & & 78AFFHVdeleted this review.rG)rEZ get_reviewsrrr9rr)rHrZ hash_reviewrs&& r4 delete_reviewZClient.delete_reviews&T++113A6K MM j. /(Ifii )) "  6&9III#Ts "B  B c s0V^8dQhRRRRRRRRRRR R /#) r/queryrreadryreplied sent_itemssortzTuple[str, str]rxzList[ThreadThumbnail]r1r2r3r4r5rsNBBBB B  B  B Br6c s<V'd \ R2pM \ R2pTPRTRRRTRVe \V4MTRVe \V4MTR VeV^, R V^, 2MT/R 7p\VP4pVP R R .R7R,P R R.R7p .p V Fp V P RRR7P R4^,p V P\V PR,V PR,\\PV PV R,R7\V P R4R,4V P R RR7P R4PR74K V #)ayGet all the messages this user has sent or received. This does not return threads you have left. Parameters ----------- query : Optional[str] Optional query to filter messages read : Optional[bool] True to filter only read message, false to filter unread, None to allow both replied : Optional[bool] True to filter messages where you are the last message, False for messages where another user is the last message, None for both. sent_items: Get only the threads you have started sort : Tuple[str, str] Optional sort tuple to order threads Returns -------- List[ThreadThumbnail] Thread typed thumbnails z/messages/sentitemsz/messages/inboxrZfilterr~ZkwZhasreadZ hasrepliedrr)paramsrAZtabinboxr8Z rowcontentrYZ subheadingr7r:r;)r=r>r<r?r@rgrZ)r<r>rfrFrgrh)rrrDr!rGr_rCrrer7r r rEr\r) rHrrrrrr<rr0Z threads_rawZthreadsrbrEs &&&&&& r4 get_threadsZClient.get_threadss< J12CJo.C MM  #e(83t9dg.Ac'lw$2B47)1T!WI.   AFF|mmE:,m?CLL <.M !F[[ [=FFsKANF NN('*"+*11 6RX>#'v{{6'::'FG"KKiK@EEcJQQ "r6cr)r/rbrerxrWr1r2r3r4r5rs$$?$v$r6c svVPRVP4p\\VP44#)zParse a thread thumbnail into a full thread object. Parameters ---------- thread : ThreadThumbnail The thumbnail to parse Returns -------- Thread The parsed thread and its messages r)rr<rWr!rGrHrbrrIr4 parse_threadZClient.parse_threads+ MM% ,d166l##r6cs(V^8dQhRRRRRRRR/#)r/r`z List[Member]r>rrcrxrWr1r2r3r4r5rs($$L$$c$f$r6c sVPR\ R2R\4RRPRV44RVRVR R /R 7p\ \ VP 44#) aGSend a message and start a thread with one or more members Parameters ---------- member : List[Member] The members to send the message to and start the thread with name : str The subject of the message message : str The message to send Returns -------- Thread The thread started from sending this message r|z/messages/compose/rZ memberstoZ,c3s8"TFqPxK R#5i)Nr)Z.0rErr4Z Z&Client.send_message..s%Hfkksr> descriptionra Send+messager)rrrrrWr!rG)rHr`r>rcrs&&&& r4 send_messageZClient.send_messagesi$ MM j* +MOSXX%H%HHwN   d166l##r6cr)r/rbUnion[Thread, ThreadThumbnail]rGrrxrWr1r2r3r4r5rs#$$&D$C$TZ$r6c  sVPR\ RVP 2R\4RVRR/R7p\ \ VP 44#)ahAdd an additional message to an exiting thread Parameters ----------- thread : Union[Thread, ThreadThumbnail] The thread to add the message to text : str The text to send Returns -------- Thread The updated thread containing the new message. It is recommended to use this object as it also contains a new hash for sending another message r|z/messages/inbox/rrrarr)rrr9rrWr!rG)rHrbrGrrr4reply_to_threadZClient.reply_to_threadsU" MM j( 4mo}dJP^_   d166l##r6cr)r/rbrrErrxryr1r2r3r4r5r5s)AA+IASYA^bAr6c  sVPR\ RVP 2RRRVPRR/RR 7pR VP 4R ,9#) aAdd a member to a conversation Parameters ----------- thread : Union[Thread, ThreadThumbnail] The thread to add add a member to member : Member The member to add Returns -------- bool Whether adding the member was succesful. This will not update the thread. r|z/messages/ajax/members/invite/r}r~rrEZ0Frzhas been successfully addedrG)rrr9r>r)rHrbrErrr4add_member_to_threadZClient.add_member_to_thread5s\ MM j6vyyk B#z6;;#F!  -0@@@r6cr)r/rbrrxryr1r2r3r4r5rNsXX#AXdXr6c sVPR\ R2RRRVP/RR7pRVP4R ,9#) zLeave a thread, you will not get any more notifications on this thread. Parameters ---------- thread : Union[Thread, ThreadThumbnail] The thread to leave Returns -------- bool Whether leaving the thread was successful r|z/messages/ajax/delete/r}r~rbFrz2You have successfully deleted the requested threadrGrrrIr4 leave_threadZClient.leave_threadNsR MM j. /#x3!  DqvvxPVGWWWr6cr-rwr1r2r3r4r5rds A At Ar6c spVPR\ R2RR/R7pRVP4R,9#)zbMark all threads as read. Returns -------- bool True if all threads have been marked as read r|z/messages/ajax/markallreadr}r~rzAll messages marked as readrG)rrrrrr4 mark_all_readZClient.mark_all_readds= MM&XJ.H"IQWY\P]M ^,0@@@r6cr)r/tagr$negativerDr1r2r3r4r5rps & &S &C &r6c sRRRVPR\VP4RVPR\ 4R\ V4/pVP R\ R2VR 7pVP4R ,#) r}r~rrZ siteareadidrrr|z/tags/ajax/addrZsuccess) Zname_idrrrrrrrr)rHrrrZresps&&& r4 _vote_tagZClient._vote_tagpsl C 3;; s||4 3>> MO H  }}Vz%@v}Nyy{9%%r6crr/rr$rxryr1r2r3r4r5r}s & &c &d &r6c s&VPV^4#)zUpvote a tag Parameters ----------- tag : Tag The tag to upvote Returns -------- bool Whether the upvote was successful rrHr&&r4 upvote_tagZClient.upvote_tag}~~c1%%r6crrr1r2r3r4r5rs & & & &r6c s&VPV^4#)zDownvote a tag Parameters ----------- tag : Tag The tag to downvote Returns -------- bool Whether the downvote was successful rrrr4 downvote_tagZClient.downvote_tagrr6)rrrE)i)NNNFN)+rQrRrSrTrUrJrOrrr rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrVr1r6r4rrs ,  Y5'~~./(1f:6"H :1@9@!9F9:G@H6B8,d, ,B*J<MBA:3@593@PU3@j$JLBH$"$@$2A2X, A & & & &r6r)>Z __future__rrr]rZtypingrrrrrrZbs4rrZbaserZboxesr r r Zenumsr r ZerrorsrZpagesrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,rWrerjrrr1r6r4rs" 9988(",# ==3385A5ApZZD 58Y58 58p 1-i1- 1-hH&H&r6