o ùT·jò-ã@spddlZddlmZmZddlmZddlmZddl m Z ddl m Z ddl mZe ›dZGd d „d ƒZdS) éN)ÚDictÚOptional)Úutils)ÚYfConfig)Ú _BASE_URL_)ÚYfData)ÚYFDataExceptionz/v10/finance/quoteSummary/c@s:eZdZdZdedefdd„Zdefdd„Zedefd d „ƒZ ede ee effd d „ƒZ ede jfd d„ƒZede eeffdd„ƒZede jfdd„ƒZede jfdd„ƒZede jfdd„ƒZede eeffdd„ƒZede eeffdd„ƒZdd„Zd(dd„Zed)d d!„ƒZd(d"d#„Zd(d$d%„Zd&d'„ZdS)*Ú FundsDatazÓ ETF and Mutual Funds Data Queried Modules: quoteType, summaryProfile, fundProfile, topHoldings Notes: - fundPerformance module is not implemented as better data is queryable using history ÚdataÚsymbolcCsL||_||_d|_d|_d|_d|_d|_d|_d|_d|_ d|_ d|_ dS)z‰ Args: data (YfData): The YfData object for fetching data. symbol (str): The symbol of the fund. N) Ú_dataÚ_symbolÚ _quote_typeÚ _descriptionÚ_fund_overviewÚ_fund_operationsÚ_asset_classesÚ _top_holdingsÚ_equity_holdingsÚ_bond_holdingsÚ _bond_ratingsÚ_sector_weightings)Úselfr r ©rúZ/home/dinkstrade/pdmp-scanner/venv/lib/python3.10/site-packages/yfinance/scrapers/funds.pyÚ__init__s zFundsData.__init__ÚreturncCó|jdur | ¡|jS)zh Returns the quote type of the fund. Returns: str: The quote type. N)rÚ_fetch_and_parse©rrrrÚ quote_type/s zFundsData.quote_typecCr)zj Returns the description of the fund. Returns: str: The description. N)rrrrrrÚ description:ó zFundsData.descriptioncCr)zw Returns the fund overview. Returns: Dict[str, Optional[str]]: The fund overview. N)rrrrrrÚ fund_overviewFr"zFundsData.fund_overviewcCr)zo Returns the fund operations. Returns: pd.DataFrame: The fund operations. N)rrrrrrÚfund_operationsRr"zFundsData.fund_operationscCr)z{ Returns the asset classes of the fund. Returns: Dict[str, float]: The asset classes. N)rrrrrrÚ asset_classes^r"zFundsData.asset_classescCr)zu Returns the top holdings of the fund. Returns: pd.DataFrame: The top holdings. N)rrrrrrÚ top_holdingsjr"zFundsData.top_holdingscCr)z{ Returns the equity holdings of the fund. Returns: pd.DataFrame: The equity holdings. N)rrrrrrÚequity_holdingsvr"zFundsData.equity_holdingscCr)zw Returns the bond holdings of the fund. Returns: pd.DataFrame: The bond holdings. N)rrrrrrÚ bond_holdings‚r"zFundsData.bond_holdingscCr)zy Returns the bond ratings of the fund. Returns: Dict[str, float]: The bond ratings. N)rrrrrrÚ bond_ratingsŽr"zFundsData.bond_ratingscCr)zƒ Returns the sector weightings of the fund. Returns: Dict[str, float]: The sector weightings. N)rrrrrrÚsector_weightingsšr"zFundsData.sector_weightingscCs8d gd¢¡}|d|jddœ}|jjt|j|d}|S)zp Fetches the raw JSON data from the API. Returns: dict: The raw JSON data. ú,)Ú quoteTypeÚsummaryProfileÚ topHoldingsÚ fundProfilezfinance.yahoo.comÚfalse)ÚmodulesÚ corsDomainr Ú formatted)Úparams)Újoinr r Ú get_raw_jsonÚ_QUOTE_SUMMARY_URL_)rr1Ú params_dictÚresultrrrÚ_fetch¦szFundsData._fetchNc Csü| ¡}z'|ddd}|dd|_| |d¡| |d¡| |d¡WdSty?tjjs7‚t |j ›dƒ‚t y}}z3tjjsK‚t   ¡}| d |j ›d |›¡| d ¡| d ¡| d |›¡| d ¡WYd}~dSd}~ww)z; Fetches and parses the data from the API. Ú quoteSummaryr9rr,r-r.r/z: No Fund data found.zFailed to get fund data for 'z ' reason: zGot response: z -------------ú N)r:rÚ_parse_descriptionÚ_parse_top_holdingsÚ_parse_fund_profileÚKeyErrorrÚdebugÚhide_exceptionsrr Ú ExceptionrÚ get_yf_loggerÚerror)rr9r ÚeÚloggerrrrr²s,   €øzFundsData._fetch_and_parsecCst|tƒs|S| d|¡S)zï Parses raw values from the data. Args: data: The data to parse. default: The default value if data is not a dictionary. Returns: The parsed value or the default value. Úraw)Ú isinstanceÚdictÚget)r ÚdefaultrrrÚ_parse_raw_valuesÎs  zFundsData._parse_raw_valuescCs| dd¡|_dS)zk Parses the description from the data. Args: data: The data to parse. ÚlongBusinessSummaryÚN)rKr)rr rrrr=ßszFundsData._parse_descriptionc Cs²| | dd¡¡| | dd¡¡| | dd¡¡| | dd¡¡| | dd¡¡| | dd¡¡dœ|_| d g¡}ggg}}}|D]}| |d ¡| |d ¡| |d ¡qDt |||d œ¡ d¡|_| di¡}t dgd¢|j| | dtj ¡¡| | dtj ¡¡| | dtj ¡¡| | dtj ¡¡| | dtj ¡¡| | dtj ¡¡gd| | dtj ¡¡| | dtj ¡¡| | dtj ¡¡| | dtj ¡¡| | dtj ¡¡| | dtj ¡¡gi¡ d¡|_ | di¡}t dgd ¢|j| | d!tj ¡¡| | d"tj ¡¡| | d#tj ¡¡gd| | d$tj ¡¡| | d%tj ¡¡| | d&tj ¡¡gi¡ d¡|_ t d'd(„| d)g¡Dƒƒ|_ t d*d(„| d+g¡Dƒƒ|_dS),zl Parses the top holdings from the data. Args: data: The data to parse. Ú cashPositionNÚ stockPositionÚ bondPositionÚpreferredPositionÚconvertiblePositionÚ otherPosition)rPrQrRrSrTrUÚholdingsr Ú holdingNameÚholdingPercent)ÚSymbolÚNamezHolding PercentrYÚequityHoldingsÚAverage)zPrice/Earningsz Price/Bookz Price/SaleszPrice/CashflowzMedian Market Capz3 Year Earnings GrowthÚpriceToEarningsÚ priceToBookÚ priceToSalesÚpriceToCashflowÚmedianMarketCapÚthreeYearEarningsGrowthúCategory AverageÚpriceToEarningsCatÚpriceToBookCatÚpriceToSalesCatÚpriceToCashflowCatÚmedianMarketCapCatÚthreeYearEarningsGrowthCatÚ bondHoldings)ÚDurationÚMaturityzCredit QualityÚdurationÚmaturityÚ creditQualityÚ durationCatÚ maturityCatÚcreditQualityCatcsó&|]}|D] }|||fVqqdS©Nr©Ú.0ÚdÚkeyrrrÚ /ó€$z0FundsData._parse_top_holdings..Ú bondRatingscsrsrtrrurrrry2rzÚsectorWeightings)rMrKrÚappendÚpdÚ DataFrameÚ set_indexrr ÚNArrrJrr) rr Ú _holdingsr Ú_nameÚ_holding_percentÚitemrrrrrr>èsx ú ýü úúöî ýýù ô zFundsData._parse_top_holdingscCsÒ| dd¡| dd¡| dd¡dœ|_| di¡}| di¡}t dgd ¢|j| | d tj¡¡| | d tj¡¡| | d tj¡¡gd | | d tj¡¡| | d tj¡¡| | d tj¡¡gi¡ d¡|_dS)zl Parses the fund profile from the data. Args: data: The data to parse. Ú categoryNameNÚfamilyÚ legalType)r†r‡rˆÚfeesExpensesInvestmentÚfeesExpensesInvestmentCatÚ Attributes)zAnnual Report Expense RatiozAnnual Holdings TurnoverzTotal Net AssetsÚannualReportExpenseRatioÚannualHoldingsTurnoverÚtotalNetAssetsrc) rKrr~rr rMrr€r)rr rÚ_fund_operations_catrrrr?4s*   ý  ýýù ôzFundsData._parse_fund_profile)rNrt)Ú__name__Ú __module__Ú __qualname__Ú__doc__rÚstrrr Úpropertyr!rrr#r~rr$Úfloatr%r&r'r(r)r*r:rÚ staticmethodrMr=r>r?rrrrr s:             Lr )Úpandasr~ÚtypingrrÚyfinancerÚyfinance.configrÚyfinance.constrÚ yfinance.datarÚyfinance.exceptionsrr7r rrrrÚs