+ h@cs6^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI H t H t H t Ht^RIHt^RIt^RIt^RIHtHt^RIHt^RIHtHt^RIHtHtHt]P:!R4tR tR R R R RRRRRRR^R?4t:]!R@4t;RARBltRFRGlt?RHRIRJRK/t@RLRMltARNRORPRQ/tBRRRSltCR#)WN)OptionalSequenceTupleTypeVar)urljoin) BeautifulSoupTag)utils) MediaCategory ThumbnailType)AwaitingAuthorisationModdbException Ratelimitedmoddbzhttps://www.moddb.comZyeariZmonthi$Zweeki: ZdayiQZhouriZminuteZecondcsaa.oVV3RloS!V4VPP4pRV9d#VPR4VPR4VRVPR4^,pTP SUu.uFq3P 4'gKVNK up4RP V4VnV#uupi)z$Does it look like I'm enjoying this?cs<VPR8XdR#VPP4pRV9d"WPR4^,RS,o\P !VP 4pW"PR4RpRV9dS!VP4R#RV9dS!VPP4R#R#)ZobjectN Attributesz):zsuper().__init____init__)__name____doc__ splitlinesindexinspectZ getsourcerZ__base__)ZparentZdocsZsource attributesget_docss& 0/usr/lib/python3.14/site-packages/moddb/utils.pyrZconcat_docs..get_docs3s ??h & ~~((* t #jj)9:Q>@AJNJ""6??3 T*,-  ' V__ % 6 ! V__-- ."rz -----------NZ )rrZappendrZextendstripjoin)ZclsZoriginalZfinalZxrrs& @@r concat_docsr/sJ/" SM{{%%'Hx'())* ;x~~&67!; r:r.Z total_secondsr0timer )r!r;ZexpiryZ remaining& rcallZRatelimit.callks##%""X%7%7%II < KK- . JJsO ??Q  *446Izz%)zz*A :IF 9% 3!$DYK"PR[\\ 1r)r:r9r8r/r.r0r<) rr&r'r(rr>rCr)r*r+@rr,r,Zs#rr,c$V^8dQhR\/#)r-limiters)r,r3"rr5r5s   rcsaV3RlpV#)csJ<a\P!S4VV3Rl4pV#)csF<SFpVP4K S!V/VB#r<)rC)r"r#ZlimiterfuncrGs*, rwrapperZ-ratelimit..decorator..wrappers(# $(( (r) functoolsZwraps)rJrKrGsf r decoratorZratelimit..decorators%   )  ) rr%)rGrMsj r ratelimitrNs ri,)r0csDV^8dQhR\R\P/#)r-dreturn)strr7rHrIrr5r5s 222))2rcs$\PPVRRVRR,R4# \dMi;i\PPTR4# \dMi;i\PPTR4#)agA helper function that takes a ModDB string representation of time and returns an equivalent datetime.datetime object. This can range from a datetime with the full year to second to just a year and a month. Parameters ----------- d : str String representation of a datetime Returns ------- datetime.datetime The datetime object for the given string Nz%Y-%m-%dT%H:%M:%S%zz%Y-%m-%dz%Y-%mi)r7Zstrptime ValueError)rO&rget_daterUs   ))!CR&1RS6/;PQQ       ))!Z88        % %a 11s,/ ==A!! A/.A/csXV^8dQhR\PR\P/#)r-reqsession)requestsRequestSessionrHrIrr5r5s& ( ()) (H4D4D (rcs(\P!VP4pVPe/VPCVCVnMW nRVP9d(\P !\ 4VPR&VPV4#)z/Prepared a request with the appropriate cookiesz User-Agent)rZdict_from_cookiejarcookiesZheadersrandomZchoiceuser_agent_listprepare_request)rVrWr[&& rr^r^sn''8G {{000  3;;&$*MM/$B L!  " "3 ''rc8V^8dQhR\P/#)r-response)rXZResponserHrIrr5r5s  x00 rcsVP4pVPRR4'd\PVR,4\PVPP 4\PVPP 4\VR,4hVP4RVPP49d \R4hR# \PPdL]i;i)z'Raise any error that could have occurederrorFtextzLis currently awaiting authorisation, which can take a couple of days while azEThis page is still await authorisation and cannot currently be parsedN)jsongetr?rbrequesturlZbodyr rXZ exceptionsZJSONDecodeErrorraise_for_statusrclowerr )rarcs& rrhrhs }} 88GU # # LLf & LL))-- . LL)).. / f. . $  W ==    !$ S   !    . .   s'C'BC''D D csPV^8dQhR\R\R\P/#)r-usernamepasswordrW)rQrXrZrHrIrr5r5s'SC(BRBRrc szVf"\PR,Pp\P!R\ R24pVP \W244p\VP4pVPRRR/R7pVPRR R 7pVPRR R R 7pRRVR,VVR,RRVRR.RR/p \P!R\ R2WPR7pVP \W24R R7p RV P9d\RV 24hV P#)zGLog a user in and return the `freeman` cookie containing the login hashrGETz/members/loginformZnameZ membersform)attrsZinputZmembersusername)idrcF)ZtyperoZrefererrkZ remembermeZ1memberszSign inZPOST)datar[)Zallow_redirectsZfreemanzLogin failed for user ) sysmodulesSESSIONrXrYBASE_URLsendr^souprcfindr[rS) rjrkrWrVresphtmlrmZusername_inputZ botcatcherrrZlogins &&& rgenerate_login_cookiesr|s*++g&..   5XJn"= >C <<5 6D  ?D 99VFM#:9 ;DYYw+TS_S_ `C LL6L NE %1(<== ==rcr`)r-rV)rXrYrHrIrr5r5s!!rcs\PR,Pp\W4pVP V4p\ V4V#)zHelper function to make get/post requests with the current SESSION object. Parameters ----------- req : requests.Request The request to perform Returns ------- requests.Response The returned response object r)rsrtrur^rwrh)rVrWZpreppedrzrBrrfrfs=!$ G 4 < ?D yy{  ?rcsRV^8dQhR\R\\\3,/#r-stringrP)rQrintrHrIrr5r58s"ceCHorcs\P!RV4p\VP^4P RR44p\VP^4P RR44pW#3#)alA helper function that takes a string representation of total something and daily amount of that same thing and returns both as a tuple of ints. Parameters ------------ string : str The string containing the numbers both total and daily Returns -------- Tuple[int, int] Tuple contains the total views (first element) and the daily views (second element) z^([0-9,]*) \(([0-9,]*) today\)$,rp)reZsearchrgroupreplace)rmatchesZviewsZtodayrBr get_viewsr8s]ii:FCG  a ((b1 2E  a ((b1 2E <rc0V^8dQhR\R\/#)r-pathrPrQrHrIrr5r5Msssrcs\VP\4'g\\V4#V#)zJoins a partial moddb url with the base url and returns the combined url Parameters ----------- path : str the url to join Return ------- str The full url. )Z startswithrvr)rrTrrrMs% ??8 $ $x&& KrcrrrrHrIrr5r5asXXcXcXrcsVPRR4PRR4PRR4P4#)aRemoves all extra fluff from a stat to get the barebone content. Stats usually have extra words like "members" or "visitors" and have command separated integers. Parameters ----------- string : str The string to clean up Returns -------- str The cleaned up stat rrprqZmember)rr)rrTr normalizeras8 >>#r " * *9b 9 A A(B O U U WWrcr})r-imgrP)rr rHrIrr5r5ss### #rcsVf\P#VR,RRR8Xd\P#\P#)zDetermines whether a media is an image, a video or an audio. This is somewhat of a brittle method, don't rely on it too much. Parameters ----------- img: bsa.Tag The image to check Returns --------- MediaCategory The category of the media Zsrcz.mp4ii)r audiovideoimage)rrTrget_media_typerss@ {""" UBr f $""""""rcs(V^8dQhR\RR/#)r-rgrPr rrHrIrr5r5s!!s!!rcsLRpRRRRRRRRRR R R R R /p\P!W4pV^,PR 4'd VR,^RMV^,p\V,p\ P RW4V# \d\Y$,,pL8i;i)zGet the page type based on a url. Parameters ----------- url : str The url to get Return ------- ThumbnailType The type of the page z\/((?!page|pages\b)\b\w+)\/ZnewZarticleZfeatureZtutorialZdownloadZfilerZmediarz mediarZsz %s is type %s)rZfindallZendswithr ZKeyErrorr?r@)rgZregexZ type_mappingrmatchZ page_types& r get_page_typers +E y9IFLjj$G!(!4!4S!9!9GBK" wqzE7!%(  KK0  7!,"56 7s BB#"B#cs<V^8dQhR\R\R\/#)r-abrP)rrHrIrr5r5s!sssrcsW),)#)z+Like a // b but rounded up instead of down.r%)rrr=rceildivrs "W:rc s|V^8dQhR\PR\R\\\\3,/#)r- result_boxper_pagerP)bs4rrrrHrIrr5r5s4"/"/s00"/C"/sTWY\}I]"/rcs\P!RVPRRR7PRRR7PRRR7P4pV'gR #\ VP ^4P RR 44p\ VP ^4P RR 44p\WA4p\W14pWeV3#) aGet the current page, total pages and total results from a result list Parameters ------------ result_box: bs4.BeautifulSoup The HTML of the result box from a list of results page per_page: Optional[int] The number of results per page, important for calculations. Defaults to 30, doesn't usually need to be touched Returns -------- Tuple[int, int, int] The stats in order of: number of current page (starting from 1), total number of pages (between 1 and X) and the total results. z(.*\(([0-9,]*) - ([0-9,]*) of ([0-9,]*)\)ZdivZ normalcorner)Zclass_ZtitleZspanZheadingrrp)rN)rrryrrrrr)rrZstatsZ max_resultsZ all_resultsZmax_pageZ current_pages&& rget_list_statsrs$ HH3n5 eG $ fY '   E ekk!n,,S"56Kekk!n,,S"56K{-H;1L ; ..rcs*a]tRtRtoRtRtRtVtR#)ObjectizEA dud objects that will transform every kwarg given into an attributec s<VPPV4R#r<)Z__dict__Zupdate)r!r#s&,rrZObject.__init__s V$rr%N)rr&r'r(rrr)r*rDrErrrsO%%rrDc\V^8dQhR\\,R\\,/#)r-seqrPrrrrHrIrr5r5s"!!rcs<VFpV!V4'gKVu# R#)a}A helper to return the first element found in the sequence that meets the predicate. For example: :: comment = find(lambda comment: comment.author.name == 'SilverElf', mod.comments.flatten()) would find the first :class:`.Comment` whose author's name is 'SilverElf' and return it. If no entry is found, then ``None`` is returned. This is different from `filter`_ due to the fact it stops the moment it finds a valid entry. .. _filter: https://docs.python.org/3.6/library/functions.html#filter Parameters ----------- predicate A function that returns a boolean-like result. seq : iterable The iterable to search through. Nr%) predicaterZelementr_rryrys#, W  N rcr)r-iterablerPrrHrIrr5r5s"7%7%(1+7%8A;7%rc s&aV3Rlp\W 4#)a>A helper that returns the first element in the iterable that meets all the traits passed in ``attrs``. This is an alternative for :func:`moddb.utils.find`. When multiple attributes are specified, they are checked using logical AND, not logical OR. Meaning they have to meet every attribute passed in and not one of them. To have a nested attribute search (i.e. search by ``x.y``) then pass in ``x__y`` as the keyword argument. If nothing is found that matches the attributes passed, then ``None`` is returned. Examples --------- Basic usage: .. code-block:: python3 article = moddb.utils.get(mod.get_articles(), name='Version 3.5 Released') Multiple attribute matching: .. code-block:: python3 comment = moddb.utils.get(mod.get_comments(2), content='Test', karma=3) Nested attribute matching: .. code-block:: python3 comment = moddb.utils.get(article.get_comments(), author__name='SilverElf', content='Best article ever') Parameters ----------- iterable An iterable to search through. \*\*attrs Keyword arguments that denote attributes to search with. cs<SP4F5wrVPR4pTpVFp\WE4pK WB8wgK4R# R#)Z__FT)ZitemssplitZgetattr)ZelemZattrZvalZnestedZobjZ attributerns& rrZget..predicate*sKIDZZ%FC# c-$z'r)ry)rrnrs&l rreresX   $$rcs@\P!4P#r<)uuidZuuid4Zhexr%rr generate_hashr8s ::<  rcr)r-rgrPrrHrIrr5r5<sccrcs2VPR4R,#)zGet the site area from a urlZ/rR)r)rgrTr get_sitearear<s 99S>" rZ3ZmodsZ2ZgamescrF)r-keyrrHrIrr5r5Gs444rcs@\P\V4R4#)zGet the sitearea id from an intZnone)siteareaid_mappingrerQ)rrTrget_siteareaidrGs  ! !#c(F 33rZkiZmi@Bcr}r)rQrrHrIrr5r5Os##rcsVR,P4pVP4'd \V4#\VRR4\V,,p\V4#)rNr)riZisdigitrr1number_mapping)rZ identifierZnumbers& r unroll_numberrOsQ!!#J6{ 6#2; ."< rs 55 "/FF   7 # " I W F 5 D b Q D9""..9""J 2s#.1aq)Ar"!Q 28 ( . => >>*+,.$%4*(X$#.!H "/J%% CL87%t  4 uc9-r