+ hZcs^RIHt^RIt^RIHtHtHtHt^RIt^RI H t H t H t H t ^RIHtHt^RIHtHtHtHtHtHt]'d ^RIHtHt.ROtRRR RR ^/R R lltR RltR//RRlltRRltRt RRlt!RRlt"RRlt#R#)i) annotationsN) TYPE_CHECKINGAnyTupleUnion) PartialTag ResultListTag_parse_results) FrontPageMember)BASE_URLgenerate_login_cookiesget_page get_page_typerequestsoup)RSSTypeSearchCategoryquerysortpagec s,V^8dQhRRRRRRRRR R /#) categoryrrstrrzTuple[str, str]rZintreturnrZformat"//usr/lib/python3.14/site-packages/moddb/base.py __annotate__rsCDDD D  D  DDc s V'dV^, RV^, 2MRpVPRR4pV'd VPMRp\ RVP RV 2pVP 4UU u/uF%wr\ V R4'gKWP bK' p pp RRR VR VRVR VPR R4/V Cp \VV R 7p \V 4wrpp\V VVV \ RVP 2VR7#uup pi)a)Search for for a certain type of models and return a list of thumbnails of that model. This function was created to make full use of moddb's filter and sorting system as long as the appropriate parameters are passed. Because this function is a single one for every model type in moddb the parameters that can be passed vary between model type but the documentation will do its best to document all the possibilities. All the objects listed in this function are enumerations. Finally it is key to note that the result attribute of the returned search object is not a list of the parsed pages but a list of Thumbnail objects containing the image, url, name and type of the object on which. Call the thumbnail's parse method and it will return the full model. Parameters ------------ category : SearchCategory The model type that you want to search query : str String to search for in the model title sort : Tuple[str, str] The tuple to sort by, look at the models your are searching for documentation on sorting. page : int The page of results to get first filters : dict Search filters Returns -------- ResultList The search object containing the current query settings (so at to be able to redo the search easily), pagination metadata and helper methods to navigate the list of results. -NgameZ/z/page/valuefilterZtZkwrZyearZyearsparams)results total_pages current_pager%url total_results) ZgetZidr nameZitemsZhasattrr"r rr)rrrrfiltersZ sort_readyr!r)keyr"Z filter_parsedr%htmlr&r(r'r*s&$$$, rsearchr/sJ,0DG9Ad1gY'TJ ;;vt $D477D Ja fTF 3C8? c*#7SXZaKb%S++%Mc # e  GT*   F   D 9Gt8L5G; !j(-- )#  %ds 3C?C?cs V^8dQhRRRR/#)rr)rrrrrrrrrZsCCrcs\V4p\V4p\\PR,VP P 44!V4pV#)zParse a url and return the appropriate object. Parameters ------------ url : str The url to parse Returns -------- Model The parsed page as the instance of the model the page represents, can be anything like Mod or Game moddb)r rZgetattrsysmodulesr+Ztitle)r)r.Z page_typeZmodels& r parse_pager3ZsC C=Dc"I CKK()..*>*>*@ A$ GE Lrr%cs$V^8dQhRRRRRR/#)rr)rr%Zdictrrrrrrrrps!&&s&t&Z&rc s\\P!RWR74p\VP4p\ V4wrErgVP PR4pV^,PR4^,p/p \V4^8d7V^,PR4Fp V PR4wrWV &K \VVVVVV R7#)a'Parse a list of results and return them as a list of thumbnails. Parameters ----------- url : str The url of the result list to parse Returns -------- ResultList The list of thumbnails, wrapped in a ResultList so as to benefit from the helper methods that help with navigation ZGETr$Z?z/pageZ&Z=)r&r'r(r)r*r%) rrequestsZRequestrZtextrr)ZsplitZlenr) r)r%Zrespr.r&r(r'r*Zpartsr,r#r-r"s &$ r parse_resultsr5ps" 8##E3> ?D  ?D8Ft8L5G; HHNN3 E (.. !! $CG 5zA~AhnnS)Fc*JC CL* ! #  rcs$V^8dQhRRRRRR/#)rusernamerpasswordrr rrrrrrs&PPCP3P6Prc s\W4\PR,Pn\ \ \ RVPRR4 244#)aLogin the user to moddb through the library, this allows user to see guest comments and see private groups they are part of. Parameters ----------- username : str The username of the user password : str The password associated to that username Raises ------- ValueError The password or username was incorrect Returns -------- Member The member you are logged in as r0z /members/Z_r ) r r1r2SESSIONcookiesr r r Zreplace)r6r7s&&rloginr:sJ,,B(+UCKK  ( (hZy1A1A#s1K0LMN OOrcsx\PR,PPP 4R#)zLogs the user out by clearing the cookies, all unapproved guest comments will be hidden and all private groups will be hidden once more r0N)r1r2r8r9Zclearrrrlogoutr;s%KK  ((..0rcV^8dQhRR/#)rrr rrrrrrs  I rcs6\\4p\V4#)zThis returns a model representing the front page of May sound fancy but it is no more than a collection of popular mods, files, games and articles. In addition jobs are listed and a poll. Returns -------- FrontPage The front page object. )r r r )r.s r front_pager=s H D T?rcr<)rrss_typerrrrrrrs A A' Arcs"RVP R2#)zGet the RSS feed url for the entire site depending on which feed type you want Parameters ----------- rss_type : RSSType The type of feed you desire to get Returns -------- str URL for the feed type zhttps://rss.moddb.com/z /feed/rss.xml)r+)r>s&rrssr?s$HMM?- @@rcr<)rtagzUnion[str, PartialTag, Tag]rrrrrrs0rcsr\V\\34'd VPpRV 2p\ V4#)zSearch for entities tagged with a tag-id or Tag. Parameters ----------- tag : Union[str, PartialTag, Tag] Either a name-id or the Tag to search for Returns -------- ResultList[Thumbnail] List of entities tagged with this zhttps://www.moddb.com/tags/)Z isinstancerrZname_idr5)r@r)s& r search_tagsrAs6#Z())kk 'u -C  r)r/r3r:r;r=r5)$Z __future__rr1Ztypingrrrrr4ZboxesrrrrZpagesr r Zutilsr r r rrrZenumsrrZ__all__r/r3r5r:r;r=r?rArrrrBs" 33>>$[[. UDD! D  DN,&b&RP41  A r