NjtSSKJrJr SSKrSSKJrJrJr SSK J r SSK J r SSK Jr \ S3r"S S \5rg) )ABCabstractmethodN)DictListOptional) _QUERY1_URL_)YfData)Tickerz /v1/financech\rSrSrSrSS\4Sjjr\S\4Sj5r\S\4Sj5r \S\4S j5r \S\ 4S j5r \S\ 4S j5r\S\\R"4S j5r\S\\ \\44S j5rS\ 4SjrSSjrS\ 4SjrS\\R"4Sjr\SSj5rSSjrSrg)Domain z Abstract base class representing a domain entity in financial data, with key attributes and methods for fetching and parsing data. Derived classes must implement the `_fetch_and_parse()` method. Nkeyc~XlX l[US9UlSUlSUlSUlSUlSUlg)z Initializes the Domain object with a key, session. Args: key (str): Unique key identifying the domain entity. session (Optional[requests.Session]): Session object for HTTP requests. Defaults to None. )sessionN) _keyrr _data_name_symbol _overview_top_companies_research_reports)selfrrs g/root/GenerationalWealth/GenerationalWealth/venv/lib/python3.13/site-packages/yfinance/domain/domain.py__init__Domain.__init__s?  #G4 $( &* )-7;AEreturncUR$)za Retrieves the key of the domain entity. Returns: str: The unique key of the domain entity. )rrs rr Domain.key#syyrcPURUR5 UR$)z\ Retrieves the name of the domain entity. Returns: str: The name of the domain entity. )_ensure_fetchedrr s rname Domain.name-s  TZZ(zzrcPURUR5 UR$)zj Retrieves the symbol of the domain entity. Returns: str: The symbol representing the domain entity. )r#rr s rsymbol Domain.symbol8s  T\\*||rcbURUR5 [UR5$)z Retrieves a Ticker object based on the domain entity's symbol. Returns: Ticker: A Ticker object associated with the domain entity. )r#rr r s rticker Domain.tickerCs% T\\*dll##rcPURUR5 UR$)z Retrieves the overview information of the domain entity. Returns: Dict: A dictionary containing an overview of the domain entity. )r#rr s roverviewDomain.overviewNs  T^^,~~rcPURUR5 UR$)z Retrieves the top companies within the domain entity. Returns: pandas.DataFrame: A DataFrame containing the top companies in the domain. )r#rr s r top_companiesDomain.top_companiesYs$ T001"""rcPURUR5 UR$)z Retrieves research reports related to the domain entity. Returns: List[Dict[str, str]]: A list of research reports, where each report is a dictionary with metadata. )r#rr s rresearch_reportsDomain.research_reportsds$ T334%%%rcFSSSSS.nURRXS9nU$)z Fetches data from the given query URL. Args: query_url (str): The URL used for the data query. Returns: Dict: The JSON response data from the request. truezen-USUS) formatted withReturnslangregion)params)r get_raw_json)r query_url params_dictresults r_fetch Domain._fetchos/%+67^bc (((G rc URS5UlURS5UlURURS055UlUR URS055UlURS5Ulg)z Parses and assigns common data fields such as name, symbol, overview, and top companies. Args: data (Dict): The raw data received from the API. r$r'r- topCompaniesresearchReportsN)getrr_parse_overviewr_parse_top_companiesrr)rdatas r_parse_and_assign_commonDomain._parse_and_assign_common}srXXf% xx) --dhhz2.FG"77QS8TU!%*;!<rc VURSS5URS05RSS5URSS5URSS5URSS5URS05RSS5URS 05RSS5S .$) z Parses the overview data for the domain entity. Args: overview (Dict): The raw overview data. Returns: Dict: A dictionary containing parsed overview information. companiesCountN marketCaprawmessageBoardId descriptionindustriesCount marketWeight employeeCount)companies_count market_capmessage_board_idrQindustries_count market_weightemployee_count)rF)rr-s rrGDomain._parse_overviews (||, E%\\."=AA%N&ll?B?CCE4P  rc 0/SQnUVs/sHVnURS5URS5URS5URS05RSS54PMX nnU(dg[R"XBS9RS5$s snf) z Parses the top companies data and converts it into a pandas DataFrame. Args: top_companies (Dict): The raw top companies data. Returns: Optional[pandas.DataFrame]: A DataFrame containing top company data, or None if no data is available. )r'r$ratingz market weightr'r$r]rSrON)columns)rF_pd DataFrame set_index)rr0top_companies_columnctop_companies_valuess rrHDomain._parse_top_companiess MTa bTaa"#x !f !h !nR 8 < _fetch_and_parse() needs to be implemented by children classes)NotImplementedErrorr s r_fetch_and_parseDomain._fetch_and_parses ""bccrc,UcUR5 gg)z Ensures that the given attribute is fetched by calling `_fetch_and_parse()` if the attribute is None. Args: attribute: The attribute to check and potentially fetch. N)rh)r attributes rr#Domain._ensure_fetcheds    ! ! # r)rrrrrrrr)N)rN)__name__ __module__ __qualname____firstlineno____doc__strrpropertyrr$r'r r*rr-rr_r`r0rr3rArJrGrHrrhr#__static_attributes__rrr r s7 FCF$Sc$$$$#x 6##&$tCH~"6&& 4  = 4 (eXcmm5Le*dd$rr )abcrrpandasr_typingrrrconstr rIr r*r _QUERY_URL_r rurrr{s4#'' k* x$Sx$r