Ej8*:ddlmZmZddlZddlmZmZmZmZm Z ddl m Z m Z ddl m Z mZddl mZmZddlmZdd lmZmZed eeejf Ze d ZGd deZGddeZGddeZGddeZdS))ABCabstractmethodN)ListUnionDictTypeVarLiteral)EQUITY_SCREENER_EQ_MAPEQUITY_SCREENER_FIELDS)FUND_SCREENER_EQ_MAPFUND_SCREENER_FIELDS)ETF_SCREENER_EQ_MAPETF_SCREENER_FIELDSYFNotImplementedError)dynamic_docstring'generate_list_table_from_dict_universalT)bound) eqzis-inbtwngtltgtelteandorceZdZdedeedeeeejffdZ e e de fdZ e e de fdZdedddfdZdeeeejfddfd Zdeeeejfddfd Zdeeeejfddfd Zdedddfd Zde fd ZddefdZdefdZdS) QueryBaseoperatoroperandc|}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_ltr!operands)selfr!r"s S/var/www/html/bolsaweb/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 childrr9s r: valid_fieldszQueryBase.valid_fields($$UVVVr<c td)Nz/valid_values() needs to be implemented by childrr?s r: valid_valueszQueryBase.valid_values-rAr<Nct|dkrtdtd|Ddur tdt |ddS)Nz$Operand must be length longer than 1c3@K|]}t|tVdSNr.r .0es r: z5QueryBase._validate_or_and_operand..5s,99Az!Y''999999r<FzOperand must be type z for OR/AND)r1r2allr0typer9r"s r:r4z"QueryBase._validate_or_and_operand2sm w<<1  CDD D 99999 9 9U B BKDJJKKKLL L C Br<ctdkrtdtfd|jDs)tdt |dddd|jvr}|jd}t|tr2tj d|D}d |vrtd d ddSdS) NrzOperand must be length 2 for EQc3,K|]}d|vVdSrNrJfields_by_typer"s r:rLz1QueryBase._validate_eq_operand..<,bb^GAJ.0bbbbbbr<Invalid field for  "r"cg|]}|SrSrSrIs r: z2QueryBase._validate_eq_operand..C":":":1":":":r<rEInvalid EQ value ") r1r2anyr@valuesrNrCr.dictsetunion)r9r"vvs ` r:r5zQueryBase._validate_eq_operand8s! w<<1  >?? ?bbbbtGXG_G_GaGabbbbb OM$t**MM MMMNN N 1:* * *"71:.B"d## <!SUU[":":biikk":":":;qz## !Cgaj!C!C!CDDD + * $#r<ctdkrtdtfd|jDstdt |t dtjdurtdt dtjdurtddS) Nz!Operand must be length 3 for BTWNc3,K|]}d|vVdSrRrSrTs r:rLz3QueryBase._validate_btwn_operand..JrVr<rWrEFz Invalid comparison type for BTWNr r1r2r^r@r_rNr.numbersRealr0rOs `r:r6z QueryBase._validate_btwn_operandGs w<<1  @AA AbbbbtGXG_G_GaGabbbbb @>$t**>>?? ? gaj', / /5 8 8>?? ? gaj', / /5 8 8>?? ? 9 8r<cdtdkrtdtfd|jDs)tdt |dddt dtjd urtd dS) Nrz"Operand must be length 2 for GT/LTc3,K|]}d|vVdSrRrSrTs r:rLz,QueryBase._validate_gt_lt..TrVr<rWrXrrYrEFz!Invalid comparison type for GT/LTrgrOs `r:r7zQueryBase._validate_gt_ltQs w<<1  ABB BbbbbtGXG_G_GaGabbbbb OM$t**MM MMMNN N gaj', / /5 8 8?@@ @ 9 8r<c^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|vVdSrRrSrTs r:rLz3QueryBase._validate_isin_operand..]rVr<rWrXrrYcg|]}|SrSrSrIs r:r[z4QueryBase._validate_isin_operand..dr\r<rEr]) r1r2r^r@r_rNrCr.r`rarbrange)r9r"rcis ` r:r3z QueryBase._validate_isin_operandYsK w<.os7VVVq:4::dT]1%5q$9::VVVr<rEcdg|]-}t|tr|n|.SrS)r.r to_dict)rJos r:r[z%QueryBase.to_dict..rs3UUUA 1i(@(@GaUUUr<r!r8rw)r9opopss` r:ruzQueryBase.to_dictisn ]m =G # #BVVVVDMRSRTRTDUVVVCUUQTUUU   r<rcdz|jj}t|jtrzt d|jDr:dfd|jD}|d|jd|ddS|d|jd t|jd S|d|jd t|jd S) N c3@K|]}t|tVdSrGrH)rJrxs r:rLz%QueryBase.__repr__..{s,EE:b),,EEEEEEr<z, c3K|]E}dt|tr|dznt|VFdS)r{rEN)r.r __repr__repr)rJrxindent indent_strs r:rLz%QueryBase.__repr__..}ss**"ii 2y@Y@Y%gR[[!%<%<%<_cdf_g_gii******r<(z, [  z])z, )) __class____name__r.r8r/r^joinr!r)r9r class_name operands_strrs ` @r:r~zQueryBase.__repr__usF] ^, dmT * * KEEt}EEEEE O$zz*****"m***   %YYt}YY<YY:YYYY%NNt}NNT]8K8KNNNN!JJ4=JJD4G4GJJJ Jr<c*|SrG)r~r?s r:__str__zQueryBase.__str__s}}r<)r)r __module__ __qualname__Operatorrrstrrhrir;propertyrrr@rCr4r5r6r7r3rur~rrSr<r:r r s$  E4 ;LdSViY]^e^jYk;k4m    0WdWWW^XWWdWWW^XWM[0AMdMMMM EDsGL7H1I,J Et E E E E@d5gl9J3K.L@QU@@@@AtE#w|2C,D'EA$AAAAId;.?IDIIII       KKCKKKK(r<r ceZdZdZedeeiedefdZ 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_tabler=ctSz[ Valid operands, grouped by category. {valid_operand_fields_table} )r r?s r:r@zEquityQuery.valid_fields &%r<valid_values_tableexchangeindustry) concat_keysctSz Most operands take number values, but some have a restricted set of valid values. {valid_values_table} )r r?s r:rCzEquityQuery.valid_valuesrr<N) rrr__doc__rrr rrr@r rCrSr<r:rrs(46]6]^t6u6uvww &d&&&Xxw&,.U.UVl|FHR{S/T/T/TUVV &d&&&XVV&&&r<rceZdZdZedeeiedefdZ 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']) ]) rr=ctSr)r r?s r:r@zFundQuery.valid_fields $#r<rctSr)r r?s r:rCzFundQuery.valid_valuesrr<N) rrrrrrr rrr@r rCrSr<r:rrs,46]6]^r6s6stuu $d$$$Xvu$,.U.UVj.k.klmm $d$$$Xnm$$$r<rceZdZdZedeeiedefdZ edee iedefdZ dS)ETFQuerya The `ETFQuery` class constructs filters for ETFs based on specific criteria such as category, fund family, exchange, and performance ratings. 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 `top_etfs_us`: .. code-block:: python from yfinance import ETFQuery ETFQuery('and', [ ETFQuery('gt', ['intradayprice', 10]), ETFQuery('is-in', ['performanceratingoverall', 4, 5]), ETFQuery('eq', ['region', 'us']) ]) rr=ctSr)rr?s r:r@zETFQuery.valid_fields #"r<rctSr)rr?s r:rCzETFQuery.valid_valuesrr<N) rrrrrrrrrr@rrCrSr<r:rrs(46]6]^q6r6rstt #d###Xut#,.U.UVi.j.jkll #d###Xml###r<r)abcrrrhtypingrrrrr yfinance.constr r r r rryfinance.exceptionsrutilsrrrrirrr rrrrSr<r:rs########66666666666666IIIIIIIIEEEEEEEECCCCCCCC555555NNNNNNNN GCuS',./000 O P{{{{{{{{|%&%&%&%&%&)%&%&%&P'$'$'$'$'$ '$'$'$R%#%#%#%#%#y%#%#%#%#%#r<