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

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

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

panda_data-0.0.3/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.3}/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:

{panda_data-0.0.2 → panda_data-0.0.3}/panda_data/readers/market_reader.py

@@ -24,8 +24,18 @@ from panda_data.utils.param_check_utils import (
 
 config = get_config()
 MULTI_ENDPOINT = config.get("JAVA_SERVICE_KLINE_ENDPOINT", "/multi")
+INDEX_ENDPOINT = config.get("JAVA_SERVICE_INDEX_ENDPOINT", "/index")
+FUTURE_ENDPOINT = config.get("JAVA_SERVICE_FUTURE_ENDPOINT", "/future")
+
 PATH_GET_MARKET_DATA = config.get("JAVA_SERVICE_KLINE_PATH_GET_MARKET_DATA", "/getMultiMarketData")
 PATH_GET_MARKET_MIN_DATA = config.get("JAVA_SERVICE_KLINE_PATH_GET_MARKET_MIN_DATA", "/getMultiMarketMinData")
+# 期货 / 指数 分钟 K 的 path 可与多行情一致，也可通过环境变量覆盖
+PATH_GET_FUTURE_MARKET_MIN_DATA = config.get(
+    "JAVA_SERVICE_FUTURE_PATH_GET_MARKET_MIN_DATA", "/getMultiMarketMinData"
+)
+PATH_GET_INDEX_MARKET_MIN_DATA = config.get(
+    "JAVA_SERVICE_INDEX_PATH_GET_MARKET_MIN_DATA", "/getMultiMarketMinData"
+)
 
 TICK_ENDPOINT = config.get("JAVA_SERVICE_TICK_ENDPOINT", "/tick")
 FUTURE_TICK_ENDPOINT = config.get("JAVA_SERVICE_TICK_ENDPOINT_FUTURE", "/future")
@@ -115,6 +125,9 @@ def get_market_data(
     # 验证st参数
     validated_st = validate_bool_type(st, "st") if st is not None else st
 
+    if validated_indicator == "000985":
+        validated_indicator = ""
+
     payload = {"type": validated_type}
     symbols = _normalise_symbols(validated_params['symbol'] if validated_params['symbol'] != [""] else None)
     if symbols is not None:
@@ -236,137 +249,27 @@ def get_market_min_data(
     if validated_frequency:
         payload["frequency"] = validated_frequency
 
-    # 排序已在读取 Parquet 时通过 DuckDB ORDER BY 完成，返回的 DataFrame 索引已是 0..n-1，无需 reset_index
-    df = fetch_dataframe(build_endpoint(MULTI_ENDPOINT, PATH_GET_MARKET_MIN_DATA), payload=payload)
-    if not df.empty and {"symbol", "date"}.issubset(df.columns):
-        # 将 symbol 和 date 列放在最前面
-        cols = df.columns.tolist()
-        priority_cols = ["symbol", "date"]
-        other_cols = [col for col in cols if col not in priority_cols]
-        df = df[priority_cols + other_cols]
-    return df
-
-def get_hk_transaction(
-        date: str = None,
-        symbol: Optional[Union[str, List[str]]] = None,
-        fields: Optional[Union[str, List[str]]] = None,
-        **kwargs
-) -> pd.DataFrame:
-    """
-    获取港股tick数据
-    """
-    # 1. 检查额外参数
-    validate_extra_params(kwargs)
-
-    # 2. 验证必填参数date
-    validate_not_empty(date, "date")
-
-    # 3. 验证参数类型
-    params = {
-        'symbol': symbol,
-        'fields': fields
-    }
-
-    type_config = {
-        'symbol': str,
-        'fields': str
-    }
-
-    validated_params = validate_param_types(
-        params,
-        type_config,
-        allowed_list_params=['symbol', 'fields']
-    )
-
-    # 4. 验证港股symbol格式（空值会被正确处理）
-    if validated_params['symbol'] is not None:
-        validated_params['symbol'] = validate_hk_symbol_format(validated_params['symbol'])
-        # 验证symbol列表中是否有重复值
-        validate_no_duplicates(validated_params['symbol'], 'symbol')
-
-    # 5. 验证fields列表中是否有重复值（空值会被正确处理）
-    if validated_params['fields'] is not None:
-        validate_no_duplicates(validated_params['fields'], 'fields')
-
-    # 6. 验证日期格式
-    validated_date = validate_date_format(date, "date")
-
-    payload = {}
-    if validated_date is not None:
-        payload["date"] = validated_date
-    if validated_params['symbol'] is not None:
-        payload["symbol"] = validated_params['symbol']
-    if validated_params['fields']:
-        payload["fields"] = validated_params['fields']
-
-    df = fetch_dataframe(build_endpoint(TICK_ENDPOINT, PATH_GET_STOCK_HK_TICK), payload=payload)
-
-    if not df.empty and {"symbol", "date"}.issubset(df.columns):
-        # 将 symbol 和 date 列放在最前面
-        cols = df.columns.tolist()
-        priority_cols = ["symbol", "date"]
-        other_cols = [col for col in cols if col not in priority_cols]
-        df = df[priority_cols + other_cols]
-
-    return df
-
-def get_future_tick(
-        date: str = None,
-        symbol: Optional[Union[str, List[str]]] = None,
-        fields: Optional[Union[str, List[str]]] = None,
-        **kwargs
-) -> pd.DataFrame:
-    """
-    获取期货Tick数据
-    """
-    # 1. 检查额外参数
-    validate_extra_params(kwargs)
-
-    # 2. 验证必填参数date
-    validate_not_empty(date, "date")
-
-    # 3. 验证参数类型
-    params = {
-        'symbol': symbol,
-        'fields': fields
-    }
-
-    type_config = {
-        'symbol': str,
-        'fields': str
-    }
-
-    validated_params = validate_param_types(
-        params,
-        type_config,
-        allowed_list_params=['symbol', 'fields']
-    )
-
-    # 4. 验证fields列表中是否有重复值（空值会被正确处理）
-    if validated_params['fields'] is not None:
-        validate_no_duplicates(validated_params['fields'], 'fields')
-
-    # 5. 验证日期格式
-    validated_date = validate_date_format(date, "date")
-
-    payload = {}
-    if validated_date is not None:
-        payload["date"] = validated_date
-    if validated_params['symbol'] is not None:
-        payload["symbol"] = validated_params['symbol']
-    if validated_params['fields']:
-        payload["fields"] = validated_params['fields']
-
-    # 获取数据
-    df = fetch_dataframe(build_endpoint(FUTURE_TICK_ENDPOINT, PATH_GET_FUTURE_TICK), payload=payload)
+    if validated_symbol_type == "stock":
+        min_endpoint = MULTI_ENDPOINT
+        min_path = PATH_GET_MARKET_MIN_DATA
+    elif validated_symbol_type == "future":
+        min_endpoint = FUTURE_ENDPOINT
+        min_path = PATH_GET_FUTURE_MARKET_MIN_DATA
+    elif validated_symbol_type == "index":
+        min_endpoint = INDEX_ENDPOINT
+        min_path = PATH_GET_INDEX_MARKET_MIN_DATA
+    else:
+        min_endpoint = MULTI_ENDPOINT
+        min_path = PATH_GET_MARKET_MIN_DATA
 
+    # 排序已在读取 Parquet 时通过 DuckDB ORDER BY 完成，返回的 DataFrame 索引已是 0..n-1，无需 reset_index
+    df = fetch_dataframe(build_endpoint(min_endpoint, min_path), payload=payload)
     if not df.empty and {"symbol", "date"}.issubset(df.columns):
         # 将 symbol 和 date 列放在最前面
         cols = df.columns.tolist()
         priority_cols = ["symbol", "date"]
         other_cols = [col for col in cols if col not in priority_cols]
         df = df[priority_cols + other_cols]
-
     return df
 
 def get_hk_daily(

panda_data-0.0.3/panda_data/test.py

@@ -0,0 +1,27 @@
+
+import panda_data
+import time
+
+if __name__ == "__main__":
+    # 1. pip install panda_data
+    # 2. 账号为：86+官网注册的手机号（eg:8617777777777）,密码与官网同步
+    # 3. 接口文档见官方知识库
+    panda_data.init_token(username="", password="")
+
+
+    # 开始计时
+    start_time = time.time()
+
+
+    result = panda_data.get_market_data(
+        symbol="000001.SZ",
+        start_date="20200101",
+        end_date="20250101",
+        # fields = ["open"],
+        type="stock"
+    )
+    print(result)
+    end_time = time.time()
+    print(f"耗时:{end_time - start_time}")
+
+    print(result)

{panda_data-0.0.2 → panda_data-0.0.3}/panda_data/utils/param_check_utils.py

@@ -1653,4 +1653,43 @@ def validate_rank_type(rank_type: str, param_name: str = "rank_type") -> str:
             message=f"[错误码 {ServiceErrorCode.REQUEST_PARAM_INVALID}] {param_name}参数值{rank_type}无效：有效值为 ratio,line"
         )
 
-    return rank_type.strip().lower()
+    return rank_type.strip().lower()
+
+
+def validate_quarter_interval(start_quarter: Optional[str], end_quarter: Optional[str], max_years: int = 5) -> None:
+    """
+    验证季度间隔是否超过限制（默认最大5年）
+
+    Args:
+        start_quarter: 开始季度（YYYYqN格式，如2020q1）
+        end_quarter: 结束季度（YYYYqN格式，如2025q1）
+        max_years: 最大年数限制，默认为5年
+
+    Raises:
+        ServiceError: 当季度间隔超过限制时抛出异常
+    """
+    if not start_quarter or not end_quarter:
+        return
+
+    # 解析季度
+    start_year = int(start_quarter[:4])
+    start_q = int(start_quarter[5])
+
+    end_year = int(end_quarter[:4])
+    end_q = int(end_quarter[5])
+
+    # 计算年份差和季度差
+    year_diff = end_year - start_year
+    quarter_diff = end_q - start_q
+
+    # 计算总季度差
+    total_quarters = year_diff * 4 + quarter_diff
+
+    # 5年 = 20个季度
+    max_quarters = max_years * 4
+
+    if total_quarters > max_quarters:
+        raise ServiceError(
+            code=ServiceErrorCode.DATE_RANGE_INVALID,
+            message=f"[错误码 {ServiceErrorCode.DATE_RANGE_INVALID}] 季度范围无效: 开始季度({start_quarter})和结束季度({end_quarter})的间隔不能超过{max_years}年（{max_quarters}个季度）"
+        )

{panda_data-0.0.2 → panda_data-0.0.3}/panda_data.egg-info/PKG-INFO

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

{panda_data-0.0.2 → panda_data-0.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "panda_data"
-version = "0.0.2"
+version = "0.0.3"
 description = "PandaAI DataQuant"
 readme = "README.md"
 requires-python = ">=3.10"

panda_data-0.0.2/panda_data/config/__init__.py

@@ -1,177 +0,0 @@
-"""
-配置模块，用于加载和管理配置信息
-支持从配置文件和环境变量导入，环境变量优先级更高
-"""
-import os
-import logging
-
-
-# 获取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 = {}
-
-    # ========== 日志配置 ==========
-    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 通用配置（client / init_token 等使用） ==========
-    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")
-
-    # ========== init_token（登录） ==========
-    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")
-
-    # ========== market_reader（行情数据） ==========
-    config["JAVA_SERVICE_KLINE_ENDPOINT"] = os.getenv("JAVA_SERVICE_KLINE_ENDPOINT", "/multi")
-    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_TICK_PATH_FUTURE_TICK"] = os.getenv("JAVA_SERVICE_TICK_PATH_FUTURE_TICK", "/getFutureTickData")
-
-    # ========== market_reference_reader（市场参考） ==========
-    # KLINE - 股票详情
-    config["JAVA_SERVICE_KLINE_PATH_GET_STOCK_DETAIL"] = os.getenv("JAVA_SERVICE_KLINE_PATH_GET_STOCK_DETAIL", "/getStockDetail")
-
-    # INDEX - 指数
-    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")
-
-    # CONCEPT - 概念
-    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")
-
-    # INDUSTRY - 行业
-    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")
-
-    # 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")
-
-    # BUYBACK - 回购
-    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")
-
-    # SECURITIES_MARGIN / STOCK_CONNECT / STOCK - 两融、北向、资金等
-    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_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_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_BLOCK_TRADE"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_BLOCK_TRADE", "/getStockBlockTradeData")
-    config["JAVA_SERVICE_STOCK_PATH_GET_SHARES"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_SHARES", "/getStockShareData")
-
-    # ========== financial_and_factors_reader（财务与因子） ==========
-    # FINANCIAL - 财务
-    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_FINANCIAL_PATH_GET_STATEMENT_DAILY"] = os.getenv("JAVA_SERVICE_FINANCIAL_PATH_GET_STATEMENT_DAILY", "/getFinancialStatementDailyData")
-
-    # STOCK - 审计、复权因子
-    config["JAVA_SERVICE_STOCK_PATH_GET_AUDIT_OPINION"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_AUDIT_OPINION", "/getStockAuditData")
-    config["JAVA_SERVICE_STOCK_PATH_GET_FACTOR_RESTORED"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_FACTOR_RESTORED", "/getFactorRestoredData")
-
-    # KLINE - 因子
-    config["JAVA_SERVICE_KLINE_PATH_GET_FACTOR"] = os.getenv("JAVA_SERVICE_KLINE_PATH_GET_FACTOR", "/getFactor")
-
-    # ========== future_reader（期货） ==========
-    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")
-
-    # ========== trading_tools_reader（交易工具） ==========
-    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_STOCK_PATH_GET_SPECIAL_TREATMENT"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_SPECIAL_TREATMENT", "/getStockSpecialTreatmentData")
-    config["JAVA_SERVICE_STOCK_PATH_GET_TRADING_STOCK_LIST"] = os.getenv("JAVA_SERVICE_STOCK_PATH_GET_TRADING_STOCK_LIST", "/getTradingStockList")
-
-    # 打包前可加入 panda_data_local_config 模块覆盖配置
-    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/test.py

@@ -1,32 +0,0 @@
-
-import panda_data
-import time
-
-if __name__ == "__main__":
-    panda_data.init_token(username="", password="")
-
-
-    # 开始计时
-    start_time = time.time()
-
-
-    # result = panda_data.get_market_data(
-    #     symbol="000001.SZ",
-    #     start_date="20200101",
-    #     end_date="20250101",
-    #     # fields = ["open"],
-    #     type="stock"
-    # )
-    # print(result)
-    # end_time = time.time()
-    # print(f"耗时:{end_time - start_time}")
-
-    fac = panda_data.get_factor(
-        symbol=["000001.SZ"],
-        start_date="20250101",
-        end_date="20250131",
-        factors=["market_cap", "ratio_pe_ttm","MA20"],
-        # factors=["open", "high", "low", "close", "volume"],
-        type="stock"
-    )
-    print(fac)