h$ddlmZmZddlZddlmZmZmZmZm Z ddl m Z m Z ddl m Z mZddlmZddlmZmZed eeejf ZGd d eZGd deZGddeZdS))ABCabstractmethodN)ListUnionDictTypeVarTuple)EQUITY_SCREENER_EQ_MAPEQUITY_SCREENER_FIELDS)FUND_SCREENER_EQ_MAPFUND_SCREENER_FIELDSYFNotImplementedError)dynamic_docstring'generate_list_table_from_dict_universalT)boundc eZdZdedeedeeeeeejfdffffdZ e e defdZ e e de fdZdedddfd Zdeeeejfddfd Zdeeeejfddfd Zdeeeejfddfd Zdedddfd Zde fdZddefdZdefdZdS) QueryBaseoperatoroperand.c|}t|tstdt |dkrt d|dkr||n{|dvr||na|dkr||nE|dkr| |n)|dvr| |nt d ||_ ||_ dS) NzInvalid operand typerzInvalid field for EquityQueryIS-IN>ORANDEQBTWN>GTLTGTELTEzInvalid Operator Value) upper isinstancelist TypeErrorlen ValueError_validate_isin_operand_validate_or_and_operand_validate_eq_operand_validate_btwn_operand_validate_gt_ltroperands)selfrrs U/var/www/html/marketdash/venv/lib/python3.11/site-packages/yfinance/screener/query.py__init__zQueryBase.__init__ s>>##'4(( 4233 3 w<<1  <== = w    ' ' 0 0 0 0  % %  ) )' 2 2 2 2     % %g . . . .     ' ' 0 0 0 0 0 0 0   ) ) ) )566 6   returnc td)Nz/valid_fields() needs to be implemented by childrr/s r0 valid_fieldszQueryBase.valid_fields%$$UVVVr2c td)Nz/valid_values() needs to be implemented by childrr5s r0 valid_valueszQueryBase.valid_values*r7r2Nct|dkrtdtd|Ddur tdt |ddS)Nz$Operand must be length longer than 1c3@K|]}t|tVdSNr$r.0es r0 z5QueryBase._validate_or_and_operand..2s,99Az!Y''999999r2FzOperand must be type z for OR/AND)r'r(allr&typer/rs r0r*z"QueryBase._validate_or_and_operand/sm w<<1  CDD D 99999 9 9U B BKDJJKKKLL L C Br2ctdkrtdtfd|jDs)tdt |dddd|jvr}|jd}t|tr2tj d|D}d |vrtd d ddSdS) NrzOperand must be length 2 for EQc3,K|]}d|vVdSrNr@fields_by_typers r0rBz1QueryBase._validate_eq_operand..9,bb^GAJ.0bbbbbbr2Invalid field for  "r"cg|]}|SrIrIr?s r0 z2QueryBase._validate_eq_operand..@":":":1":":":r2r;Invalid EQ value ") r'r(anyr6valuesrDr9r$dictsetunion)r/rvvs ` r0r+zQueryBase._validate_eq_operand5s! w<<1  >?? ?bbbbtGXG_G_GaGabbbbb OM$t**MM MMMNN N 1:* * *"71:.B"d## <!SUU[":":biikk":":":;qz## !Cgaj!C!C!CDDD + * $#r2ctdkrtdtfd|jDstdt |t dtjdurtdt dtjdurtddS) Nz!Operand must be length 3 for BTWNc3,K|]}d|vVdSrHrIrJs r0rBz3QueryBase._validate_btwn_operand..GrLr2rMr;Fz Invalid comparison type for BTWNr r'r(rTr6rUrDr$numbersRealr&rEs `r0r,z QueryBase._validate_btwn_operandDs w<<1  @AA AbbbbtGXG_G_GaGabbbbb @>$t**>>?? ? gaj', / /5 8 8>?? ? gaj', / /5 8 8>?? ? 9 8r2cdtdkrtdtfd|jDs)tdt |dddt dtjd urtd dS) Nrz"Operand must be length 2 for GT/LTc3,K|]}d|vVdSrHrIrJs r0rBz,QueryBase._validate_gt_lt..QrLr2rMrNrrOr;Fz!Invalid comparison type for GT/LTr]rEs `r0r-zQueryBase._validate_gt_ltNs w<<1  ABB BbbbbtGXG_G_GaGabbbbb OM$t**MM MMMNN N gaj', / /5 8 8?@@ @ 9 8r2c^tdkrtdtfd|jDs)tdt |dddd|jvr|jd}t|tr2tj d|D}td tD]'}||vrtd |d&dSdS) Nrz#Operand must be length 2+ for IS-INc3,K|]}d|vVdSrHrIrJs r0rBz3QueryBase._validate_isin_operand..ZrLr2rMrNrrOcg|]}|SrIrIr?s r0rQz4QueryBase._validate_isin_operand..arRr2r;rS) r'r(rTr6rUrDr9r$rVrWrXrange)r/rrYis ` r0r)z QueryBase._validate_isin_operandVsK w<.ls7VVVq:4::dT]1%5q$9::VVVr2r;cdg|]-}t|tr|n|.SrI)r$rto_dict)r@os r0rQz%QueryBase.to_dict..os3UUUA 1i(@(@GaUUUr2rr.rm)r/opopss` r0rkzQueryBase.to_dictfsn ]m =G # #BVVVVDMRSRTRTDUVVVCUUQTUUU   r2rcdz|jj}t|jtrzt d|jDr:dfd|jD}|d|jd|ddS|d|jd t|jd S|d|jd t|jd S) N c3@K|]}t|tVdSr=r>)r@rns r0rBz%QueryBase.__repr__..xs,EE:b),,EEEEEEr2z, c3K|]E}dt|tr|dznt|VFdS)rqr;N)r$r__repr__repr)r@rnindent indent_strs r0rBz%QueryBase.__repr__..zss**"ii 2y@Y@Y%gR[[!%<%<%<_cdf_g_gii******r2(z, [  z])z, )) __class____name__r$r.r%rTjoinrru)r/rv class_name operands_strrws ` @r0rtzQueryBase.__repr__rsF] ^, dmT * * KEEt}EEEEE O$zz*****"m***   %YYt}YY<YY:YYYY%NNt}NNT]8K8KNNNN!JJ4=JJD4G4GJJJ Jr2c*|Sr=)rtr5s r0__str__zQueryBase.__str__s}}r2)r)r| __module__ __qualname__strrrr r^r_r1propertyrr6rr9r*r+r,r-r)rkrtrrIr2r0rr s9  ud;6GsTYZ_`celeq`qZruxZxTyOyIz6z/|    0WdWWW^XWWdWWW^XWM[0AMdMMMM EDsGL7H1I,J Et E E E E@d5gl9J3K.L@QU@@@@AtE#w|2C,D'EA$AAAAId;.?IDIIII       KKCKKKK(r2rceZdZdZedeeiedefdZ edee ddgiedefd Z d S) EquityQuerya The `EquityQuery` class constructs filters for stocks based on specific criteria such as region, sector, exchange, and peer group. Start with value operations: `EQ` (equals), `IS-IN` (is in), `BTWN` (between), `GT` (greater than), `LT` (less than), `GTE` (greater or equal), `LTE` (less or equal). Combine them with logical operations: `AND`, `OR`. Example: Predefined Yahoo query `aggressive_small_caps`: .. code-block:: python from yfinance import EquityQuery EquityQuery('and', [ EquityQuery('is-in', ['exchange', 'NMS', 'NYQ']), EquityQuery('lt', ["epsgrowth.lasttwelvemonths", 15]) ]) valid_operand_fields_tabler3ctSz[ Valid operands, grouped by category. {valid_operand_fields_table} )r r5s r0r6zEquityQuery.valid_fields &%r2valid_values_tableexchangeindustry) concat_keysctSz Most operands take number values, but some have a restricted set of valid values. {valid_values_table} )r r5s r0r9zEquityQuery.valid_valuesrr2N) r|rr__doc__rrr rrr6r r9rIr2r0rrs(46]6]^t6u6uvww &d&&&Xxw&,.U.UVl|FHR{S/T/T/TUVV &d&&&XVV&&&r2rceZdZdZedeeiedefdZ edee iedefdZ dS) FundQuerya The `FundQuery` class constructs filters for mutual funds based on specific criteria such as region, sector, exchange, and peer group. Start with value operations: `EQ` (equals), `IS-IN` (is in), `BTWN` (between), `GT` (greater than), `LT` (less than), `GTE` (greater or equal), `LTE` (less or equal). Combine them with logical operations: `AND`, `OR`. Example: Predefined Yahoo query `solid_large_growth_funds`: .. code-block:: python from yfinance import FundQuery FundQuery('and', [ FundQuery('eq', ['categoryname', 'Large Growth']), FundQuery('is-in', ['performanceratingoverall', 4, 5]), FundQuery('lt', ['initialinvestment', 100001]), FundQuery('lt', ['annualreturnnavy1categoryrank', 50]), FundQuery('eq', ['exchange', 'NAS']) ]) rr3ctSr)r r5s r0r6zFundQuery.valid_fields $#r2rctSr)r r5s r0r9zFundQuery.valid_valuesrr2N) r|rrrrrr rrr6r r9rIr2r0rrs,46]6]^r6s6stuu $d$$$Xvu$,.U.UVj.k.klmm $d$$$Xnm$$$r2r)abcrrr^typingrrrrr yfinance.constr r r r yfinance.exceptionsrutilsrrrr_rrrrrIr2r0rs\########44444444444444IIIIIIIIEEEEEEEE555555NNNNNNNN GCuS',./000{{{{{{{{|%&%&%&%&%&)%&%&%&P'$'$'$'$'$ '$'$'$'$'$r2