i9<dZddlZddlZddlmZddlmZddlmZddl Z ddl m Z ddl m Z ejeZgdZGd d Zd e fd Zd e fd Zdededed e fdZdeezd dfdZd efdZd eeeffdZy)a ProjectX Configuration Management Author: @TexasCoding Date: 2025-08-02 Overview: Handles configuration for the ProjectX client, including environment variables, config files, and default settings. Provides comprehensive configuration management with priority-based loading, validation, and customization for different deployment environments. Key Features: - Priority-based configuration loading (Environment > Config file > Defaults) - Environment variable support with automatic type conversion - Configuration file management with JSON format - Configuration validation and error handling - Custom configuration creation for different endpoints - Authentication configuration management - Environment setup validation and status checking Configuration Sources: - Environment variables with PROJECTX_ prefix - JSON configuration files with customizable paths - Default configuration with TopStepX endpoints - Custom configuration for different ProjectX deployments Example Usage: ```python from project_x_py.config import ( load_default_config, create_custom_config, ConfigManager, check_environment, ) # Load default configuration config = load_default_config() # Create custom configuration custom_config = create_custom_config( user_hub_url="https://custom.projectx.com/hubs/user", market_hub_url="https://custom.projectx.com/hubs/market", ) # Use configuration manager manager = ConfigManager("config.json") config = manager.load_config() # Check environment setup status = check_environment() if status["auth_configured"]: print("Authentication configured") else: print(f"Missing: {status['missing_required']}") ``` Configuration Priority: 1. Environment variables (highest priority) 2. Configuration file (JSON format) 3. Default values (lowest priority) Environment Variables: - PROJECTX_API_URL: Base API URL - PROJECTX_REALTIME_URL: WebSocket URL - PROJECTX_USER_HUB_URL: User hub URL - PROJECTX_MARKET_HUB_URL: Market hub URL - PROJECTX_TIMEZONE: Timezone for timestamps - PROJECTX_TIMEOUT_SECONDS: Request timeout - PROJECTX_RETRY_ATTEMPTS: Retry attempts - PROJECTX_RETRY_DELAY_SECONDS: Retry delay - PROJECTX_REQUESTS_PER_MINUTE: Rate limiting - PROJECTX_BURST_LIMIT: Burst limit Authentication Variables: - PROJECT_X_API_KEY: API key for authentication - PROJECT_X_USERNAME: Username for authentication Configuration Validation: - URL format validation for all endpoints - Numeric value validation for timeouts and limits - Timezone validation using pytz - Authentication credential validation - Comprehensive error reporting See Also: - `models.ProjectXConfig`: Configuration data model - `utils.environment`: Environment variable utilities N)asdict)Path)Any)ProjectXConfig) get_env_var) ConfigManagercheck_environmentcreate_config_templatecreate_custom_configget_default_config_pathload_default_configload_topstepx_configceZdZdZddeezdzfdZdefdZde ee ffdZ de ee ffdZ dd ed eezdzddfd Z de eeffd Zd edefd Zy)rz Configuration manager for ProjectX client. Handles loading configuration from: 1. Environment variables 2. Configuration files 3. Default values Priority order: Environment variables > Config file > Defaults N config_filec:|r t|nd|_d|_y)z Initialize configuration manager. Args: config_file: Optional path to configuration file N)rr_config)selfrs L/home/work/apex_v16/venv/lib/python3.12/site-packages/project_x_py/config.py__init__zConfigManager.__init__s>I[(9d.2 returnc|j |jStt}|jr^|jj rD |j }|j |tjd|j|j}|j |tdi||_|jS#t$r/}tjd|jd|Yd}~pd}~wwxYw)zo Load configuration with priority order. Returns: ProjectXConfig instance NzLoaded configuration from zFailed to load config file : ) rrrrexists_load_config_fileupdateloggerinfo Exceptionwarning_load_env_config)r config_dict file_confige env_configs r load_configzConfigManager.load_configs << #<< ^-.     0 0 7 7 9 V"446 "";/ 89I9I8JKL **, :&%4 4 || V!'>'@I d&&9 DQ&&(||G,%/d%;tDz D D D&&0  LL6qc: ;I s<BAB  B BBBC2C CCc i}ddddddtfdtfdtfd tfd tfd }|jD]N\}}tjj |}|(t |tr|\}} ||||<J|||<P|S#t$r)}tjd |d|d|dYd }~d }~wwxYw)z.Load configuration from environment variables.api_url realtime_url user_hub_urlmarket_hub_urltimezonetimeout_secondsretry_attemptsretry_delay_secondsrequests_per_minute burst_limit PROJECTX_API_URLPROJECTX_REALTIME_URLPROJECTX_USER_HUB_URLPROJECTX_MARKET_HUB_URLPROJECTX_TIMEZONEPROJECTX_TIMEOUT_SECONDSPROJECTX_RETRY_ATTEMPTSPROJECTX_RETRY_DELAY_SECONDSPROJECTX_REQUESTS_PER_MINUTEPROJECTX_BURST_LIMITNzInvalid value for rz ()) intfloatitemsosenvirongetr.tuple ValueErrorrr!) rr& env_mappingsenv_var config_keyvaluekey value_typer%s rr"zConfigManager._load_env_configs !*%3%3'7!+):C(@(8#'>-BE,J-BC,H%2C$8  $0#5#5#7 3 GZJJNN7+E j%0&0OCV*4U*; 3.3Jz* 3 &V);G9BugRPQsRS'TUUVs< B CB>>Cconfig file_pathc|r t|n |j}| td |jj ddt |}t |d5}|jtj|tjdddtjd|y#1swY"xYw#t$r!}tjd|d |d}~wwxYw) z Save configuration to file. Args: config: Configuration to save file_path: Optional path to save to (uses self.config_file if None) NzNo config file path specifiedTparentsexist_okwboptionzConfiguration saved to zFailed to save config to r)rrrTparentmkdirrr*writer,dumps OPT_INDENT_2rrr r2)rr[r\ target_filer#r3r%s r save_configzConfigManager.save_configs*3d9o8H8H  <= =     $ $TD $ A!.Kk4( OA [9L9LMN O KK1+? @ O O   LL4[MA3G H  s/4B>5B2 B>2B;7B>> C(C##C(ctdd}tdd}|s td|s tdt|trt |dkr td||d S) z Get authentication configuration from environment variables. Returns: Dictionary with authentication settings Raises: ValueError: If required authentication variables are missing or invalid PROJECT_X_API_KEYT)requiredPROJECT_X_USERNAMEz2PROJECT_X_API_KEY environment variable is requiredz3PROJECT_X_USERNAME environment variable is required zMInvalid PROJECT_X_API_KEY format - must be a string longer than 10 characters)api_keyusername)rrTr.strlen)rrprqs rget_auth_configzConfigManager.get_auth_configsn1DA3dCQR RRS S'3'3w<"+<_ #99rcg}gd}|D][}t||}|rt|ts|j|d6|j drH|j|d]|j dkr|jd|j dkr|jd|jdkr|jd|jdkr|jd |jdkr|jd  dd l }|j|j|rtd dj|y#t$r!|jd |jYIwxYw)z Validate configuration settings. Args: config: Configuration to validate Returns: True if configuration is valid Raises: ValueError: If configuration is invalid )r7r8r9r:z must be a non-empty string)zhttp://zhttps://zwss://z must be a valid URLrz timeout_seconds must be positivez#retry_attempts must be non-negativez(retry_delay_seconds must be non-negativez$requests_per_minute must be positivezburst_limit must be positiveNzInvalid timezone: z!Configuration validation failed: z; T)getattrr.rrappend startswithr<r=r>r?r@pytzr;r rTjoin)rr[errors required_urls url_fieldurlrys rvalidate_configzConfigManager.validate_config sc$ ' BI&),Cjc2  +FGH^^$EF  +?@A  B  ! !Q & MM< =  1 $ MM? @  % % ) MMD E  % % * MM@ A    " MM8 9 B  MM&// * @6AR@STU U  B MM.v.?@ A BsE'E10E1)N)__name__ __module__ __qualname____doc__rrrrrr'r/rrr"rjrtboolrrrrrrss 3C$J$53^: 4S> $sCx.F(,:$  @:c3h:24n44rrrc6t}|jS)zw Load default configuration with environment variable overrides. Returns: ProjectXConfig instance )rr')managers rr r DsoG     rctS)z Load configuration for TopStepX endpoints (uses default config). Returns: ProjectXConfig: Configuration with TopStepX URLs )r rrrrrOs    rr9r:kwargsc t}||_||_|jD]\}}t ||st |||!|S)a Create custom configuration with specified URLs. Args: user_hub_url: Custom user hub URL market_hub_url: Custom market hub URL **kwargs: Additional configuration parameters Returns: ProjectXConfig: Custom configuration instance )r r9r:rOhasattrsetattr)r9r:rr[rYrXs rr r YsT! "F&F*Flln( U 63  FC '( Mrr\c |t}t|}ddddddddd d d d d |}t|}|jj ddt |d5}|j tj|tjdddtjd|y#1swY"xYw)zo Create a configuration file template. Args: file_path: Path where to create the template zProjectX Configuration TemplatezBase URL for the ProjectX APIz WebSocket URL for real-time datazSignalR hub URL for user eventszSignalR hub URL for market datazTimezone for timestamp handlingzRequest timeout in secondsz,Number of retry attempts for failed requestszDelay between retry attemptsz#Rate limiting - requests per minutezRate limiting - burst limit) r7r8r9r:r;r<r=r>r?r@)_comment _descriptionTr^rarbNz"Configuration template created at ) rrrrdrer*rfr,rgrhrr)r\template_configr#templater3s rr r ss%&O"("9K66>=?9;L#A#H8   H"YI 4$7 i D!  Xf.A.ABCD KK4YK@ADDs 5B22B;ctjdz dz dz tjdz tjdz g}|D]}|js|cS|dS)zd Get the default configuration file path. Returns: Path to default config file z.configprojectxz config.jsonzprojectx_config.jsonz.projectx_config.jsonr)rhomecwdr)possible_pathspaths rr r sm i*,}<  ++  ,,N ;;=K ! rcddggd} td}td}|r|rd|d<n,|s|djd|s|djdt }|j rd|d<t ||d <gd }|D]6}tjj|s#|d j|8|S#t$r|djddgYwxYw) zh Check environment setup for ProjectX. Returns: Dictionary with environment status F)auth_configuredconfig_file_existsenvironment_overridesmissing_requiredrlrnTrrrconfig_file_pathrAr) rrwr extendr rrrrPrQrR)statusrprq default_pathenv_varsvars rr r s!#!# F W1234 x(,F$ %)*112EF)*112FG 12L'+#$%(%6!" H8 ::>>#  * + 2 23 78 M7 W!"))+>@T*UVWsA CC%$C%)rloggingrP dataclassesrpathlibrtypingrr,project_x_py.modelsrproject_x_py.utilsr getLoggerrr__all__rr rrrr r r r/r rrrrsXt  .*   8 $ NNb!^!!n!'*694"BcDj"BT"BJ.54S>5r