panda-data 0.0.2__tar.gz → 0.0.4__tar.gz

{panda_data-0.0.2 → panda_data-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: panda_data
-Version: 0.0.2
+Version: 0.0.4
 Summary: PandaAI DataQuant
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown

panda_data-0.0.4/panda_data/config/__init__.py

@@ -0,0 +1,374 @@
+"""
+配置模块，用于加载和管理配置信息
+支持从配置文件和环境变量导入，环境变量优先级更高
+"""
+import os
+import yaml
+import logging
+from pathlib import Path
+
+# 获取logger
+try:
+    from panda_data.logger.config import logger
+except ImportError:
+    # 如果无法导入logger，创建一个基本的logger
+    logging.basicConfig(level=logging.INFO)
+    logger = logging.getLogger("config")
+
+
+# 初始化配置变量config = None
+
+def load_config():
+    """加载配置文件，并从环境变量更新配置"""
+    global config
+
+    config = {}
+
+    # 日志配置 Logging
+    config["LOG_LEVEL"] = os.getenv("LOG_LEVEL", "DEBUG")
+    config["log_file"] = os.getenv("LOG_FILE", "logs/panda_data.log")
+    config["log_rotation"] = os.getenv("LOG_ROTATION", "1 MB")
+    config["LOG_PATH"] = os.getenv("LOG_PATH", "~/log")
+
+    # HTTP service integration
+    config["DEFAULT_USERNAME"] = os.getenv("DEFAULT_USERNAME", "")
+    config["DEFAULT_PASSWORD"] = os.getenv("DEFAULT_PASSWORD", "")
+
+    config["HTTP_SERVICE_BASE_URL"] = os.getenv("HTTP_SERVICE_BASE_URL")
+    config["HTTP_TIMEOUT"] = os.getenv("HTTP_TIMEOUT", "300")
+    config["HTTP_MAX_RETRIES"] = os.getenv("HTTP_MAX_RETRIES", "3")
+    config["HTTP_VERIFY_SSL"] = os.getenv("HTTP_VERIFY_SSL", "true")
+    config["HTTP_PROXY_TYPE"] = os.getenv("HTTP_PROXY_TYPE")  # "http" or "https"
+    config["HTTP_PROXY_HOST"] = os.getenv("HTTP_PROXY_HOST")
+    config["HTTP_PROXY_PORT"] = os.getenv("HTTP_PROXY_PORT")
+    config["HTTP_PROXY_USERNAME"] = os.getenv("HTTP_PROXY_USERNAME")
+    config["HTTP_PROXY_PASSWORD"] = os.getenv("HTTP_PROXY_PASSWORD")
+    config["HTTP_USE_GZIP"] = os.getenv("HTTP_USE_GZIP", "false")
+    config["HTTP_DATA_FIELD"] = os.getenv("HTTP_DATA_FIELD", "data")
+    config["HTTP_ABNORMAL_ENDPOINT"] = os.getenv("HTTP_ABNORMAL_ENDPOINT", "/abnormal")
+
+    # Legacy HTTP service config (for backward compatibility)
+    config["JAVA_SERVICE_BASE_URL"] = os.getenv("JAVA_SERVICE_BASE_URL", "http://pandadata.pandaai.online")
+    config["JAVA_SERVICE_TIMEOUT"] = os.getenv("JAVA_SERVICE_TIMEOUT", "15")
+    config["JAVA_SERVICE_MAX_POOL_SIZE"] = os.getenv("JAVA_SERVICE_MAX_POOL_SIZE", "10")
+    config["JAVA_SERVICE_MAX_RETRIES"] = os.getenv("JAVA_SERVICE_MAX_RETRIES", "3")
+    config["JAVA_SERVICE_BACKOFF_FACTOR"] = os.getenv("JAVA_SERVICE_BACKOFF_FACTOR", "0.3")
+    config["JAVA_SERVICE_VERIFY_SSL"] = os.getenv("JAVA_SERVICE_VERIFY_SSL", "true")
+    config["JAVA_SERVICE_DATA_FIELD"] = os.getenv("JAVA_SERVICE_DATA_FIELD", "data")
+    config["JAVA_SERVICE_ABNORMAL_ENDPOINT"] = os.getenv("JAVA_SERVICE_ABNORMAL_ENDPOINT", "/abnormal")
+
+    config["JAVA_SERVICE_CALENDAR_ENDPOINT"] = os.getenv("JAVA_SERVICE_CALENDAR_ENDPOINT", "/tradeCalendar")
+    config["JAVA_SERVICE_CALENDAR_PATH_GET_TRADE_CALENDAR_DATA"] = os.getenv(
+        "JAVA_SERVICE_CALENDAR_PATH_GET_TRADE_CALENDAR_DATA", "/getTradeCalendarData")
+    config["JAVA_SERVICE_CALENDAR_PATH_GET_PREVIOUS_NTH_TRADING_DAY"] = os.getenv(
+        "JAVA_SERVICE_CALENDAR_PATH_GET_PREVIOUS_NTH_TRADING_DAY", "/getPreviousNthTradingDay")
+    config["JAVA_SERVICE_CALENDAR_PATH_GET_LATEST_TRADING_DAY"] = os.getenv(
+        "JAVA_SERVICE_CALENDAR_PATH_GET_LATEST_TRADING_DAY", "/getLatestTradingDay")
+
+    config["JAVA_SERVICE_ABNORMAL_ENDPOINT"] = os.getenv("JAVA_SERVICE_ABNORMAL_ENDPOINT", "/abnormal")
+    config["JAVA_SERVICE_ABNORMAL_PATH_GET_ABNORMAL_DATA"] = os.getenv("JAVA_SERVICE_ABNORMAL_PATH_GET_ABNORMAL_DATA",
+                                                                       "/getAbnormalData")
+    config["JAVA_SERVICE_ABNORMAL_PATH_GET_ABNORMAL_DETAIL"] = os.getenv(
+        "JAVA_SERVICE_ABNORMAL_PATH_GET_ABNORMAL_DETAIL", "/getAbnormalDetailData")
+
+    config["JAVA_SERVICE_BUY_BACK_ENDPOINT"] = os.getenv("JAVA_SERVICE_BUY_BACK_ENDPOINT", "/buyback")
+    config["JAVA_SERVICE_BUY_BACK_PATH_GET_BUY_BACK_DATA"] = os.getenv("JAVA_SERVICE_BUY_BACK_PATH_GET_BUY_BACK_DATA",
+                                                                       "/getBuyBackData")
+
+    config["JAVA_SERVICE_CONCEPT_ENDPOINT"] = os.getenv("JAVA_SERVICE_CONCEPT_ENDPOINT", "/concept")
+    config["JAVA_SERVICE_CONCEPT_PATH_GET_CONCEPT_LIST"] = os.getenv("JAVA_SERVICE_CONCEPT_PATH_GET_CONCEPT_LIST",
+                                                                     "/getConceptData")
+    config["JAVA_SERVICE_CONCEPT_PATH_GET_CONCEPT_STOCK"] = os.getenv("JAVA_SERVICE_CONCEPT_PATH_GET_CONCEPT_STOCK",
+                                                                      "/getConceptStockData")
+
+    config["JAVA_SERVICE_FINANCIAL_ENDPOINT"] = os.getenv("JAVA_SERVICE_FINANCIAL_ENDPOINT", "/financial")
+    config["JAVA_SERVICE_FINANCIAL_PATH_GET_FORECAST"] = os.getenv("JAVA_SERVICE_FINANCIAL_PATH_GET_FORECAST",
+                                                                   "/getFinancialForecastData")
+    config["JAVA_SERVICE_FINANCIAL_PATH_GET_PERFORMANCE"] = os.getenv("JAVA_SERVICE_FINANCIAL_PATH_GET_PERFORMANCE",
+                                                                      "/getFinancialPerformanceData")
+    config["JAVA_SERVICE_FINANCIAL_PATH_GET_EX"] = os.getenv("JAVA_SERVICE_FINANCIAL_PATH_GET_EX",
+                                                             "/getFinancialExData")
+    config["JAVA_SERVICE_FINANCIAL_PATH_GET_STATEMENT"] = os.getenv("JAVA_SERVICE_FINANCIAL_PATH_GET_STATEMENT",
+                                                                    "/getFinancialStatementData")
+
+    config["JAVA_SERVICE_FUND_ENDPOINT"] = os.getenv("JAVA_SERVICE_FUND_ENDPOINT", "/fund")
+    config["JAVA_SERVICE_FUND_PATH_GET_ALL_FUNDS"] = os.getenv("JAVA_SERVICE_FUND_PATH_GET_ALL_FUNDS", "/getAllFunds")
+    config["JAVA_SERVICE_FUND_PATH_GET_FUND_PRO"] = os.getenv("JAVA_SERVICE_FUND_PATH_GET_FUND_PRO",
+                                                              "/getFundPortfolioData")
+    config["JAVA_SERVICE_FUND_PATH_GET_FUND_NAV"] = os.getenv("JAVA_SERVICE_FUND_PATH_GET_FUND_NAV", "/getFundNavData")
+
+    config["JAVA_SERVICE_FUTURE_ENDPOINT"] = os.getenv("JAVA_SERVICE_FUTURE_ENDPOINT", "/future")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_LIST"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_LIST",
+                                                                   "/getFutureList")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FACTOR_POST"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_GET_FACTOR_POST",
+                                                                   "/getFutureMarketPostData")
+    config["JAVA_SERVICE_FUTURE_PATH_FUTURE_DOMINANT"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_FUTURE_DOMINANT",
+                                                                   "/getFutureDominantData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_SYMBOL_POSI_RANK"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_GET_SYMBOL_POSI_RANK",
+                                                                        "/getFutureSymbolPosiRankData")
+    config["JAVA_SERVICE_TICK_PATH_FUTURE_TICK"] = os.getenv("JAVA_SERVICE_TICK_PATH_FUTURE_TICK", "/getFutureTickData")
+    config["JAVA_SERVICE_FUTURE_PATH_FUTURE_NETPOSI_RANK"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_FUTURE_NETPOSI_RANK",
+                                                                       "/getFutureNetposiRankData")
+    config["JAVA_SERVICE_FUTURE_PATH_FUTURE_NET_FLOW"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_FUTURE_NET_FLOW",
+                                                                   "/getFutureNetFlowData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_BROKER_GRADE"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_GET_BROKER_GRADE",
+                                                                    "/getBrokerGradeData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_BROKER_NET_MARGIN"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_BROKER_NET_MARGIN", "/getBrokerNetMarginData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_BROKER_NET_MARGIN_CHANGE"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_BROKER_NET_MARGIN_CHANGE", "/getBrokerNetMarginChangeData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_BROKER_TOTAL_MARGIN"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_BROKER_TOTAL_MARGIN", "/getBrokerTotalMarginData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_BASIS"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_BASIS",
+                                                                    "/getFutureBasisData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_WR"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_WR",
+                                                                 "/getFutureWRData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_LS_RATIO"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_LS_RATIO",
+                                                                       "/getFutureLSRatioData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_CONTRACT_RANK"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_CONTRACT_RANK", "/getFutureContractRankData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_NET_CAP_CHANGE"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_NET_CAP_CHANGE", "/getFutureNetCapChangeData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_TERM_STRUCTURE"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_TERM_STRUCTURE", "/getFutureTermStructureData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_INVENTORY"] = os.getenv("JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_INVENTORY",
+                                                                        "/getFutureInventoryData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_RESEARCH_REPORT"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_RESEARCH_REPORT", "/getFutureResearchReportData")
+    config["JAVA_SERVICE_FUTURE_PATH_DOWNLOAD_FUTURE_RESEARCH_REPORT"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_DOWNLOAD_FUTURE_RESEARCH_REPORT", "/downloadFutureResearchReport")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SYMBOL_OI_VALUE"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SYMBOL_OI_VALUE", "/getFutureSymbolOiValueData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_BROKER_POSITION"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_BROKER_POSITION", "/getFutureBrokerPositionData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_BROKER_PROFIT"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_BROKER_PROFIT", "/getFutureBrokerProfitData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_NONBROKER_NET_OI"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_NONBROKER_NET_OI", "/getFutureNonbrokerNetOiData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_CROSS_TERM_ARBITRAGE"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_CROSS_TERM_ARBITRAGE", "/getFutureCrossTermArbitrageData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_FREE_SPREAD"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_FREE_SPREAD", "/getFutureFreeSpreadData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_FREE_RATIO"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_FREE_RATIO", "/getFutureFreeRatioData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_MARKET_MIN_DATA"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_MARKET_MIN_DATA", "/getMultiMarketMinData"
+    )
+
+    config["JAVA_SERVICE_INDEX_ENDPOINT"] = os.getenv("JAVA_SERVICE_INDEX_ENDPOINT", "/index")
+    config["JAVA_SERVICE_INDEX_PATH_GET_SYMBOL"] = os.getenv("JAVA_SERVICE_INDEX_PATH_GET_SYMBOL",
+                                                             "/getIndexSymbolData")
+    config["JAVA_SERVICE_INDEX_PATH_GET_INDICATOR"] = os.getenv("JAVA_SERVICE_INDEX_PATH_GET_INDICATOR",
+                                                                "/getIndexIndicatorData")
+    config["JAVA_SERVICE_INDEX_PATH_GET_WEIGHTS"] = os.getenv("JAVA_SERVICE_INDEX_PATH_GET_WEIGHTS",
+                                                              "/getIndexWeightsData")
+    config["JAVA_SERVICE_INDEX_PATH_GET_MARKET_MIN_DATA"] = os.getenv(
+        "JAVA_SERVICE_INDEX_PATH_GET_MARKET_MIN_DATA", "/getMultiMarketMinData"
+    )
+
+    config["JAVA_SERVICE_INDUSTRY_ENDPOINT"] = os.getenv("JAVA_SERVICE_INDUSTRY_ENDPOINT", "/industry")
+    config["JAVA_SERVICE_INDUSTRY_PATH_GET_STOCK"] = os.getenv("JAVA_SERVICE_INDUSTRY_PATH_GET_STOCK",
+                                                               "/getIndustryStockData")
+    config["JAVA_SERVICE_INDUSTRY_PATH_GET_LIST"] = os.getenv("JAVA_SERVICE_INDUSTRY_PATH_GET_LIST", "/getIndustryList")
+    config["JAVA_SERVICE_INDUSTRY_PATH_GET_STOCK_INDUSTRY"] = os.getenv("JAVA_SERVICE_INDUSTRY_PATH_GET_STOCK_INDUSTRY",
+                                                                        "/getStockIndustry")
+
+    config["JAVA_SERVICE_KLINE_ENDPOINT"] = os.getenv("JAVA_SERVICE_KLINE_ENDPOINT", "/multi")
+    config["JAVA_SERVICE_KLINE_PATH_GET_STOCK_DETAIL"] = os.getenv("JAVA_SERVICE_KLINE_PATH_GET_STOCK_DETAIL",
+                                                                   "/getStockDetail")
+    config["JAVA_SERVICE_KLINE_PATH_GET_MARKET_DATA"] = os.getenv("JAVA_SERVICE_KLINE_PATH_GET_MARKET_DATA",
+                                                                  "/getMultiMarketData")
+    config["JAVA_SERVICE_KLINE_PATH_GET_MARKET_MIN_DATA"] = os.getenv("JAVA_SERVICE_KLINE_PATH_GET_MARKET_MIN_DATA",
+                                                                      "/getMultiMarketMinData")
+    config["JAVA_SERVICE_KLINE_PATH_GET_FACTOR"] = os.getenv("JAVA_SERVICE_KLINE_PATH_GET_FACTOR", "/getFactor")
+
+    config["JAVA_SERVICE_SECURITIES_MARGIN_ENDPOINT"] = os.getenv("JAVA_SERVICE_SECURITIES_MARGIN_ENDPOINT",
+                                                                  "/stock")
+
+    config["JAVA_SERVICE_SECURITIES_MARGIN_PATH_GET_MARGIN"] = os.getenv(
+        "JAVA_SERVICE_SECURITIES_MARGIN_PATH_GET_MARGIN",
+        "/getSecuritiesMarginData")
+
+    config["JAVA_SERVICE_STOCK_CONNECT_ENDPOINT"] = os.getenv("JAVA_SERVICE_STOCK_CONNECT_ENDPOINT",
+                                                              "/stock")
+    config["JAVA_SERVICE_STOCK_CONNECT_PATH_GET_STOCK_CONNECT_DATA"] = os.getenv(
+        "JAVA_SERVICE_STOCK_CONNECT_PATH_GET_STOCK_CONNECT_DATA",
+        "/getStockConnectData")
+
+    config["JAVA_SERVICE_STOCK_ENDPOINT"] = os.getenv("JAVA_SERVICE_STOCK_ENDPOINT", "/stock")
+    config["JAVA_SERVICE_STOCK_PATH_GET_FLOW"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_FLOW", "/getStockFlowData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_AUDIT_OPINION"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_AUDIT_OPINION",
+                                                                    "/getStockAuditData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_INVESTOR_ACTIVITIES"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_INVESTOR_ACTIVITIES", "/getStockInvestorData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_RESTRICTED_DETAILS"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_RESTRICTED_DETAILS", "/getStockRestrictedData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_CASH_DIVIDEND"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_CASH_DIVIDEND", "/getStockCashDividendData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_DIVIDEND_INFO"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_DIVIDEND_INFO", "/getStockDividendInfoData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_SPLIT_INFO"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_SPLIT_INFO", "/getStockSplitInfoData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_DIVIDEND_AMOUNT"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_DIVIDEND_AMOUNT", "/getStockDividendAmountData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_PRIVATE_PLACEMENT"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_PRIVATE_PLACEMENT", "/getStockPrivatePlacementData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_ALLOTMENT"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_ALLOTMENT", "/getStockAllotmentData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_HOLDER_NUMBER"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_HOLDER_NUMBER",
+                                                                    "/getStockHolderNumberData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_MAIN_SHAREHOLDER"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_MAIN_SHAREHOLDER",
+                                                                       "/getStockMainHolderData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_SPECIAL_TREATMENT"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_SPECIAL_TREATMENT",
+                                                                        "/getStockSpecialTreatmentData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_FLOW_1M"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_FLOW_1M",
+                                                              "/getStockFlowMinData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_BLOCK_TRADE"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_BLOCK_TRADE",
+                                                                  "/getStockBlockTradeData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_FACTOR_RESTORED"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_FACTOR_RESTORED",
+                                                                      "/getFactorRestoredData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_SHARES"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_SHARES", "/getStockShareData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_TRADING_STOCK_LIST"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_TRADING_STOCK_LIST", "/getTradingStockList")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_CUMU_GUARANTEE"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_CUMU_GUARANTEE", "/getStockCumuGuaranteeData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_EQUITY_PLEDGE"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_EQUITY_PLEDGE", "/getStockEquityPledgeData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_EQUITY_PLEDGE_STAT"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_EQUITY_PLEDGE_STAT", "/getStockEquityPledgeStatData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_RELA_PARTY_TRANS"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_RELA_PARTY_TRANS", "/getStockRelaPartyTransData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_STOCK_SHAREHOLDER_TRADING_PLAN"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_STOCK_SHAREHOLDER_TRADING_PLAN", "/getStockShareholderTradingPlanData")
+
+    config["JAVA_SERVICE_STOCK_PATH_GET_EVENT_CAP_MARKET"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_EVENT_CAP_MARKET",
+                                                                       "/getEventCapMarketData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_EVENT_CORP_ACTION"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_EVENT_CORP_ACTION",
+                                                                        "/getEventCorpActionData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_EVENT_DEVIDEND"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_EVENT_DEVIDEND",
+                                                                     "/getEventDevidendData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_EVENT_INVESTOR_RA"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_EVENT_INVESTOR_RA",
+                                                                        "/getEventInvestorRAData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_EVENT_FINA_DISCLOSURE"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_EVENT_FINA_DISCLOSURE", "/getEventFinaDisclosureData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_COMPANY_CONCEN"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_COMPANY_CONCEN",
+                                                                     "/getCompanyConcenData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_COMPANY_TOP_CONCEN"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_COMPANY_TOP_CONCEN", "/getCompanyTopConcenData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_COMPANY_INSI_TRANS"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_COMPANY_INSI_TRANS", "/getCompanyInsiTransData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_COMPANY_SHRHOLDER_REP"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_COMPANY_SHRHOLDER_REP", "/getCompanyShrHolderRepData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_COMPANY_INVESTOR"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_COMPANY_INVESTOR",
+                                                                       "/getCompanyInvestorData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_COMPANY_CURRENT"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_COMPANY_CURRENT",
+                                                                      "/getCompanyCurrentData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_COMPANY_IMED"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_COMPANY_IMED",
+                                                                   "/getCompanyImedData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_COMPANY_PRICE_VOL"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_COMPANY_PRICE_VOL",
+                                                                        "/getCompanyPriceVolData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_CONSENSUS_NONPERIOD"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_CONSENSUS_NONPERIOD", "/getConsensusNonperiodData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_CONSENSUS_RECOMMEND"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_CONSENSUS_RECOMMEND", "/getConsensusRecommendData")
+    config["JAVA_SERVICE_STOCK_PATH_GET_COMPANY_OPER_METRIC"] = os.getenv(
+        "JAVA_SERVICE_STOCK_PATH_GET_COMPANY_OPER_METRIC", "/getCompanyOperMetricData")
+
+    config["JAVA_SERVICE_STOCK_PATH_GET_INDEX_COMP_HKUS"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_INDEX_COMP_HKUS",
+                                                                      "/getIndexCompHKUSData")
+
+    config["JAVA_SERVICE_TICK_ENDPOINT"] = os.getenv("JAVA_SERVICE_TICK_ENDPOINT", "/tick")
+    config["JAVA_SERVICE_TICK_PATH_HK_TICK"] = os.getenv("JAVA_SERVICE_TICK_PATH_HK_TICK", "/getStockHKTickData")
+
+    config["JAVA_SERVICE_HK_ENDPOINT"] = os.getenv("JAVA_SERVICE_HK_ENDPOINT", "/hkMarket")
+    config["JAVA_SERVICE_HK_PATH_STOCK"] = os.getenv("JAVA_SERVICE_HK_PATH_STOCK", "/getStockMarketHKData")
+    config["JAVA_SERVICE_HK_PATH_STOCK_MIN"] = os.getenv("JAVA_SERVICE_HK_PATH_STOCK_MIN", "/getStockMarketHKMinData")
+
+    config["JAVA_SERVICE_US_ENDPOINT"] = os.getenv("JAVA_SERVICE_US_ENDPOINT", "/usMarket")
+    config["JAVA_SERVICE_US_PATH_STOCK"] = os.getenv("JAVA_SERVICE_US_PATH_STOCK", "/getStockMarketUSData")
+    config["JAVA_SERVICE_US_PATH_STOCK_MIN"] = os.getenv("JAVA_SERVICE_US_PATH_STOCK_MIN", "/getStockMarketUSMinData")
+
+    config["JAVA_SERVICE_MACRO_ENDPOINT"] = os.getenv("JAVA_SERVICE_MACRO_ENDPOINT", "/macro")
+    config["JAVA_SERVICE_MACRO_PATH_GET_MACRO_CAL"] = os.getenv("JAVA_SERVICE_MACRO_PATH_GET_MACRO_CAL",
+                                                                "/getMacroCalData")
+    config["JAVA_SERVICE_MACRO_PATH_GET_MACRO_CAL_CONFIG"] = os.getenv("JAVA_SERVICE_MACRO_PATH_GET_MACRO_CAL_CONFIG",
+                                                                       "/getMacroCalConfig")
+    config["JAVA_SERVICE_MACRO_PATH_GET_MACRO_CAL_INFO"] = os.getenv("JAVA_SERVICE_MACRO_PATH_GET_MACRO_CAL_INFO",
+                                                                     "/getMacroCalInfo")
+
+    config["JAVA_SERVICE_USER_ENDPOINT"] = os.getenv("JAVA_SERVICE_USER_ENDPOINT", "/dataUser")
+    config["JAVA_SERVICE_USER_PATH_LOGIN"] = os.getenv("JAVA_SERVICE_USER_PATH_LOGIN", "/login")
+    config["JAVA_SERVICE_TICK_USER_ENDPOINT"] = os.getenv("JAVA_SERVICE_TICK_USER_ENDPOINT", "/tickUser")
+    config["JAVA_SERVICE_TICK_USER_PATH_LOGIN"] = os.getenv("JAVA_SERVICE_TICK_USER_PATH_LOGIN", "/login")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SAT_PROFIT_RAMKING"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SAT_PROFIT_RAMKING", "/getFutureSatProfitRankingData")
+    config["JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SAT_LOSS_RANKING"] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SAT_LOSS_RANKING", "/getFutureSatLossRankingData")
+    config['JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_POSITION_BUILDING_PROCESS'] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_POSITION_BUILDING_PROCESS", "/getFuturePositionBuildingProcessData")
+    config['JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_CAP_VALUE'] = os.getenv("JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_CAP_VALUE",
+                                                                        "/getFutureCapValueData")
+    config['JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SEAT_MATCHING'] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SEAT_MATCHING", "/getFutureSeatMatchingData")
+    config['JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_RATIO_OF_VIRTUAL_TO_REAL_POSITIONS'] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_RATIO_OF_VIRTUAL_TO_REAL_POSITIONS",
+        "/getFutureRatioOfVitualToRealPositionsData")
+    config['JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SPOT_PROFIT'] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SPOT_PROFIT", "/getFutureSpotProfitData")
+    config['JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SPOT_TRADER_QUOTATION'] = os.getenv(
+        "JAVA_SERVICE_FUTURE_PATH_GET_FUTURE_SPOT_TRADER_QUOTATION", "/getFutureSpotTraderQuotationData")
+
+    # Option service endpoints
+    config["JAVA_SERVICE_OPTION_PATH_GET_OPTION_DETAIL"] = os.getenv(
+        "JAVA_SERVICE_OPTION_PATH_GET_OPTION_DETAIL", "/getOptionDetailData")
+    config["JAVA_SERVICE_OPTION_PATH_GET_OPTION_UNDERLYING_DETAIL"] = os.getenv(
+        "JAVA_SERVICE_OPTION_PATH_GET_OPTION_UNDERLYING_DETAIL", "/getOptionUnderlyingDetailData")
+    config["JAVA_SERVICE_OPTION_PATH_GET_OPTION_MARKET_DATA"] = os.getenv(
+        "JAVA_SERVICE_OPTION_PATH_GET_OPTION_MARKET_DATA", "/getOptionMarketData")
+    config["JAVA_SERVICE_OPTION_PATH_GET_OPTION_IMPLIED_VOLATILITY"] = os.getenv(
+        "JAVA_SERVICE_OPTION_PATH_GET_OPTION_IMPLIED_VOLATILITY", "/getOptionImpliedVolatilityData")
+    config["JAVA_SERVICE_OPTION_PATH_GET_OPTION_UDERLYING_VOLATILITY"] = os.getenv(
+        "JAVA_SERVICE_OPTION_PATH_GET_OPTION_HISTORICAL_VOLATILITY",
+        "/getOptionUnderlyingVolatilityData")
+
+    # WebSocket 实时行情
+    # 网关需命中 /pandaData/ws/tick 才路由到 tick 服务；与 HTTP 登录端口可不同
+    config["WS_LIVE_MARKET_URL"] = os.getenv("WS_LIVE_MARKET_URL", "ws://127.0.0.1:8180/pandaData/ws/tick")
+    # 为 True 时 TickStreamClient 可不 init_token、不带头直连（与 skip_auth 参数二选一即可）
+    config["WS_LIVE_MARKET_SKIP_AUTH"] = os.getenv("WS_LIVE_MARKET_SKIP_AUTH", "").lower() in (
+        "1",
+        "true",
+        "yes",
+    )
+
+    # 打包前可加入 panda_data_local_config 模块覆盖配置（如 LOCAL_MODE=True），便于无鉴权本地调用
+    try:
+        import panda_data_local_config as _local
+        if getattr(_local, "JAVA_SERVICE_BASE_URL", None):
+            config["JAVA_SERVICE_BASE_URL"] = _local.JAVA_SERVICE_BASE_URL
+    except ImportError:
+        pass
+
+    return config
+
+
+def get_config():
+    """
+    获取配置对象，如果配置未加载则先加载配置
+
+    Returns:
+        dict: 配置信息字典
+    """
+    global config
+    if config is None:
+        config = load_config()
+    return config
+
+
+# 初始加载配置
+try:
+    config = load_config()
+    # logger.info(f"初始化配置成功: {config}")  # 已禁用初始化配置日志
+except Exception as e:
+    logger.error(f"初始化配置失败: {str(e)}")
+    # 不在初始化时抛出异常，留到实际使用时再处理

{panda_data-0.0.2 → panda_data-0.0.4}/panda_data/readers/financial_and_factors_reader.py

@@ -18,7 +18,7 @@ from panda_data.utils.param_check_utils import (
     validate_quarter_range,
     validate_bool_type, validate_quarter_date_combination, validate_extra_params, validate_date_range,
     validate_stock_info_market, validate_not_empty, validate_factor_type, validate_future_symbol_format,
-    validate_index_component, validate_date_interval, validate_indicator
+    validate_index_component, validate_date_interval, validate_indicator, validate_quarter_interval
 )
 
 config = get_config()
@@ -243,16 +243,36 @@ def get_fina_performance(
 def get_fina_reports(
         symbol: Optional[Union[str, List[str]]] = None,
         fields: Optional[Union[str, List[str]]] = None,
-        start_quarter: Optional[str] = None,
-        end_quarter: Optional[str] = None,
+        start_quarter: str = None,
+        end_quarter: str = None,
         date: Optional[str] = None,
         is_latest: Optional[bool] = True,
         **kwargs
 ) -> pd.DataFrame:
     """
     获取季度财务报告
+
+    Args:
+        symbol: 股票代码列表
+        fields: 返回字段列表
+        start_quarter: 开始季度，必填，格式为YYYYqN（如2020q1）
+        end_quarter: 结束季度，必填，格式为YYYYqN（如2025q1），与start_quarter间隔不得超过5年
+        date: 日期参数，与start_quarter/end_quarter二选一
+        is_latest: 是否只返回最新数据，默认为True
+        **kwargs: 其他参数（会被验证）
+
+    Returns:
+        pd.DataFrame: 季度财务报告数据
+
+    Raises:
+        ServiceError: 当参数验证失败时抛出异常
     """
     validate_extra_params(kwargs)
+
+    # 验证必填参数
+    validate_not_empty(start_quarter, "start_quarter")
+    validate_not_empty(end_quarter, "end_quarter")
+
     # 验证参数类型
     params = {
         'symbol': symbol,
@@ -297,6 +317,9 @@ def get_fina_reports(
     # 验证季度范围
     validate_quarter_range(validated_start_quarter, validated_end_quarter)
 
+    # 验证季度间隔不超过5年
+    validate_quarter_interval(validated_start_quarter, validated_end_quarter, max_years=5)
+
     # 验证date格式
     validated_date = validate_date_format(date, "date")
 
@@ -436,12 +459,16 @@ def get_financial_statement(
     payload = _build_payload(
         symbol=validated_params['symbol'],
         fields=validated_params['fields'],
-        extra={
-            **({"startDate": validated_start_date} if validated_start_date is not None else {}),
-            **({"endDate": validated_end_date} if validated_end_date is not None else {}),
-            "market": market_lower,
-            "interimType": interim_type_lower,
-        },
+        start_date=validated_start_date,
+        end_date=validated_end_date,
+        market=market_lower,
+        interim_type=interim_type_lower,
+        # extra={
+        #     **({"startDate": validated_start_date} if validated_start_date is not None else {}),
+        #     **({"endDate": validated_end_date} if validated_end_date is not None else {}),
+        #     "market": market_lower,
+        #     "interimType": interim_type_lower,
+        # },
     )
 
     # 调用接口，返回的是 Parquet 文件，fetch_dataframe 会自动处理
@@ -575,12 +602,16 @@ def get_financial_statement_daily(
     payload = _build_payload(
         symbol=validated_params['symbol'],
         fields=validated_params['fields'],
-        extra={
-            **({"startDate": validated_start_date} if validated_start_date is not None else {}),
-            **({"endDate": validated_end_date} if validated_end_date is not None else {}),
-            "market": market_lower,
-            "interimType": interim_type_lower,
-        },
+        start_date=validated_start_date,
+        end_date=validated_end_date,
+        market=market_lower,
+        interim_type=interim_type_lower
+        # extra={
+        #     **({"startDate": validated_start_date} if validated_start_date is not None else {}),
+        #     **({"endDate": validated_end_date} if validated_end_date is not None else {}),
+        #     "market": market_lower,
+        #     "interimType": interim_type_lower,
+        # },
     )
 
     # 调用接口，返回的是 Parquet 文件，fetch_dataframe 会自动处理
@@ -814,6 +845,9 @@ def get_factor(
     # 验证index_component参数
     validated_index_component = validate_indicator(index_component, "indexComponent")
 
+    if validated_index_component == "000985":
+        validated_index_component = ""
+
     payload = {"type": validated_type}
     symbols = _normalise_symbols(validated_params['symbol'] if validated_params['symbol'] != [""] else None)
     if symbols is not None: