o &P@sdZddlmZddlmZddlmZddlZddlZddlZddlZddl Z ddl m Z dZ dd Z Gd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZdS)z@Utilities for determining the current platform and architecture.)absolute_import)division)unicode_literalsN)encoding)/:*?"<>|c Cstd|r|ddg}d}ng}d}d}t|t|D]}||tvr5d}|dt||q|||qd|}|rRt j d dt|||S) zGConverts invalid Windows characters to Unicode 'unsupported' character.z ^[A-Za-z]:NrFTz${}zgWARNING: The following characters are invalid in Windows file and directory names: {} Renaming {} to {}) researchrangelenINVALID_WINDOWS_PATH_CHARACTERSappendformatindexjoinsysstderrwrite)pathnew_path start_indexperformed_conversioninew_path_stringr"?/tmp/google-cloud-sdk/lib/googlecloudsdk/core/util/platforms.pyMakePathWindowsCompatible"s,     r$c@seZdZdZdS)Errorz2Base class for exceptions in the platforms moudle.N)__name__ __module__ __qualname____doc__r"r"r"r#r%=sr%cs eZdZdZfddZZS)InvalidEnumValuezFException for when a string could not be parsed to a valid enum value.c s$tt|d||d|dS)zConstructs a new exception. Args: given: str, The given string that could not be parsed. enum_type: str, The human readable name of the enum you were trying to parse. options: list(str), The valid values for this enum. z?Could not parse [{0}] into a valid {1}. Valid values are [{2}]z, N)superr*__init__rr)selfgiven enum_typeoptions __class__r"r#r,Es zInvalidEnumValue.__init__)r&r'r(r)r, __classcell__r"r"r1r#r*Bsr*c@seZdZdZGdddeZedddZeddd Zed d d Zed ddZ edddZ eeee e gZ e ddZ e dddZe ddZe ddZdS)OperatingSystemz=An enum representing the operating system you are running on.c@s|eZdZdZddZddZddZdd Zd d Ze d d Z ddZ ddZ ddZ ddZeddZeddZdS)zOperatingSystem._OSzA single operating system.cC||_||_||_dSNidname file_namer-r8r9r:r"r"r#r,Z zOperatingSystem._OS.__init__cC|jSr6r8r-r"r"r#__str___zOperatingSystem._OS.__str__cC2t|t|o|j|jko|j|jko|j|jkSr6 isinstancetyper8r9r:r-otherr"r"r#__eq__b   zOperatingSystem._OS.__eq__cCt|jt|jt|jSr6hashr8r9r:r?r"r"r#__hash__hzOperatingSystem._OS.__hash__cC ||k Sr6r"rFr"r"r#__ne__k zOperatingSystem._OS.__ne__cC||k||kSz;Just a helper equivalent to the cmp() function in Python 2.r"clsxyr"r"r# _CmpHelpernzOperatingSystem._OS._CmpHelpercC(||j|j|jf|j|j|jfdkSNrrXr8r9r:rFr"r"r#__lt__s zOperatingSystem._OS.__lt__cC(||j|j|jf|j|j|jfdkSr[r\rFr"r"r#__gt__xr^zOperatingSystem._OS.__gt__cC || Sr6r`rFr"r"r#__le__} zOperatingSystem._OS.__le__cCrar6r]rFr"r"r#__ge__rdzOperatingSystem._OS.__ge__cCs|tjkr tStS)z%Returns the operating system version.)r4WINDOWSplatformversionreleaser?r"r"r#ris zOperatingSystem._OS.versioncCsn|j}|tjkr!|}|dvr|S|dr!|ddddStd|}|s+dSdd d | DS) z:Returns a cleaned version of the operating system version.)XPVISTASERVERN  _z(\d+)(\.\d+)?(\.\d+)?.*rcss|]}|r|VqdSr6r").0groupr"r"r# sz4OperatingSystem._OS.clean_version..) rir4rgupper startswithreplacermatchrgroups)r-ri capitalizedmatchesr"r"r# clean_versions   z!OperatingSystem._OS.clean_versionN)r&r'r(r)r,r@rHrMrP classmethodrXr]r`rcrfpropertyrir{r"r"r"r#_OSVs"  r~rgWindowswindowsMACOSXzMac OS XdarwinLINUXLinuxlinuxCYGWINCygwincygwinMSYSMsysmsyscC ttjSzRGets all possible enum values. Returns: list, All the enum values. )listr4_ALLr"r"r"r# AllValues zOperatingSystem.AllValuesTcCF|sdStjD] }|j|kr|Sq|r!t|dddtjDdS)aGets the enum corresponding to the given operating system id. Args: os_id: str, The operating system id to parse error_on_unknown: bool, True to raise an exception if the id is unknown, False to just return None. Raises: InvalidEnumValue: If the given value cannot be parsed. Returns: OperatingSystemTuple, One of the OperatingSystem constants or None if the input is None. NzOperating SystemcSg|]}|jqSr"r>rqvaluer"r"r# z*OperatingSystem.FromId..)r4rr8r*)os_iderror_on_unknownoperating_systemr"r"r#FromId  zOperatingSystem.FromIdcCsDtjdkrtjSdtjvrtjSdtjvrtjSdtjvr tjSdS)zDetermines the current operating system. Returns: OperatingSystemTuple, One of the OperatingSystem constants or None if it cannot be determined. ntrrrN) osr9r4rgrrhrrrr"r"r"r#Currents    zOperatingSystem.CurrentcCsttjuS)z8Returns True if the current operating system is Windows.)r4rrgr"r"r"r# IsWindowsszOperatingSystem.IsWindowsNT)r&r'r(r)objectr~rgrrrrr staticmethodrrrrr"r"r"r#r4Ss" E       r4c@seZdZdZGdddeZedddZedddZedddZedddZ eeee gZ id eded ed ed eded edededede de de de de de Z e ddZ e dddZe ddZdS) Architecturez@An enum representing the system architecture you are running on.c@sdeZdZdZddZddZddZdd Zd d Ze d d Z ddZ ddZ ddZ ddZdS)zArchitecture._ARCHzA single architecture.cCr5r6r7r;r"r"r#r,r<zArchitecture._ARCH.__init__cCr=r6r>r?r"r"r#r@rAzArchitecture._ARCH.__str__cCrBr6rCrFr"r"r#rHrIzArchitecture._ARCH.__eq__cCrJr6rKr?r"r"r#rMrNzArchitecture._ARCH.__hash__cCrOr6r"rFr"r"r#rPrQzArchitecture._ARCH.__ne__cCrRrSr"rTr"r"r#rXrYzArchitecture._ARCH._CmpHelpercCrZr[r\rFr"r"r#r]r^zArchitecture._ARCH.__lt__cCr_r[r\rFr"r"r#r`r^zArchitecture._ARCH.__gt__cCrar6rbrFr"r"r#rcrdzArchitecture._ARCH.__le__cCrar6rerFr"r"r#rf rdzArchitecture._ARCH.__ge__N)r&r'r(r)r,r@rHrMrPr|rXr]r`rcrfr"r"r"r#_ARCHs  rx86x86_64PPCppcarmamd64zi686-64i386i686ia64powerpczpower macintoshppc64armv6armv6larm64armv7armv7laarch64cCrr)rrrr"r"r"r#rrzArchitecture.AllValuesTcCr)aGets the enum corresponding to the given architecture id. Args: architecture_id: str, The architecture id to parse error_on_unknown: bool, True to raise an exception if the id is unknown, False to just return None. Raises: InvalidEnumValue: If the given value cannot be parsed. Returns: ArchitectureTuple, One of the Architecture constants or None if the input is None. NrcSrr"r>rr"r"r#r=rz'Architecture.FromId..)rrr8r*)architecture_idrarchr"r"r#r&rzArchitecture.FromIdcCstjtS)zDetermines the current system architecture. Returns: ArchitectureTuple, One of the Architecture constants or None if it cannot be determined. )r_MACHINE_TO_ARCHITECTUREgetrhmachinelowerr"r"r"r#r@szArchitecture.CurrentNr)r&r'r(r)rrrrrrrrrrrrr"r"r"r#rs^ -      rc@sJeZdZdZddZddZedddZd d Zd d Z ed dZ dS)Platformz+Holds an operating system and architecture.cCs||_||_dS)zConstructs a new platform. Args: operating_system: OperatingSystem, The OS architecture: Architecture, The machine architecture. N)r architecture)r-rrr"r"r#r,Ns zPlatform.__init__cCsd|j|jS)Nz{}-{})rrrr?r"r"r#r@XszPlatform.__str__NcCs$t|r|nt|r |StS)ahDetermines the current platform you are running on. Args: os_override: OperatingSystem, A value to use instead of the current. arch_override: Architecture, A value to use instead of the current. Returns: Platform, The platform tuple of operating system and architecture. Either can be None if it could not be determined. )rr4rr) os_override arch_overrider"r"r#r[s  zPlatform.CurrentcCs|jtjkrdj|jj|jjdS|jtjkr"dj|jj|jjdS|jtjkr?d}|jt j kr4|jjnd}|j||jjdSdS)aGenerates the fragment of the User-Agent that represents the OS. Examples: (Linux 3.2.5-gg1236) (Windows NT 6.1.7601) (Macintosh; PPC Mac OS X 12.4.0) (Macintosh; Intel Mac OS X 12.4.0) Returns: str, The fragment of the User-Agent string. z({name} {version}))r9riz({name} NT {version})z&(Macintosh; {name} Mac OS X {version})Intelz()) rr4rrr9rirgrrrr)r- format_string arch_stringr"r"r#UserAgentFragmentks*    zPlatform.UserAgentFragmentcCsi}|jtjkrd|d<d}d}||B|d<|Stjddkr+tjddkr+d|d <ntj|d <d|d<tj|d <tj|d <tj|d <|S)a{Returns the args for spawning an async process using Popen on this OS. Make sure the main process does not wait for the new process. On windows this means setting the 0x8 creation flag to detach the process. Killing a group leader kills the whole group. Setting creation flag 0x200 on Windows or running setsid on *nix makes sure the new process is in a new session with the new process the group leader. This means it can't be killed if the parent is killed. Finally, all file descriptors (FD) need to be closed so that waiting for the output of the main process does not inadvertently wait for the output of the new process, which means waiting for the termination of the new process. If the new process wants to write to a file, it can open new FDs. Returns: {str:}, The args for spawning an async process using Popen on this OS. T close_fdsi creationflagsrstart_new_session preexec_fnstdinstdoutr) rr4rgr version_inforsetsid subprocessPIPE)r-argsdetached_processcreate_new_process_groupr"r"r#AsyncPopenArgss        zPlatform.AsyncPopenArgscCsPgd}ztj|tjtjd}|\}}dt|vrWdSWdSYdS)aMethod that detects if platform is actually M1 Arm. This will return True even in the case where x86 Python is running under Rosetta 2. This will ONLY return true when running on a Macos M1 machine. Normal methods, for example "uname -a" will see x86_64 in the M1 case when Rosetta 2 is running, this method exists for when we want to know what the actual hardware is. Returns: True if M1 Arm detected, False otherwise. )sysctlz-nzmachdep.cpu.brand_string)rrzApple M1TF)rPopenrSTDOUT communicaterDecode)cmd_argsproc stdoutdatarpr"r"r#IsActuallyM1ArmArchitectures   z$Platform.IsActuallyM1ArmArchitecture)NN) r&r'r(r)r,r@rrrrrr"r"r"r#rKs  ''rc@sjeZdZdZdZdZeej drdndZ dZ dZ dZ d Zdd d Zd dZddZddZdddZd S) PythonVersiona Class to validate the Python version we are using. The Cloud CLI officially supports Python 3.9. However, many commands do work with Python 3.6, so we don't error out when users are using this (we consider it sometimes "compatible" but not "supported"). )r)r )ENABLE_MAX_GCLOUD_PYTHON_VERSION_OVERRIDE)r)r )r zJanuary 27th, 2026z If you have a compatible Python interpreter installed, you can use it by setting the CLOUDSDK_PYTHON environment variable to point to it. NcCs6|r||_dSttdrtjdd|_dSd|_dS)Nrr)rihasattrrr)r-rir"r"r#r,s    zPythonVersion.__init__cCsttjkr dSdS)Nrz~ To reinstall gcloud, run: $ gcloud components reinstall This will also prompt to install a compatible version of Python.)r4rrr?r"r"r#InstallMacPythonMessagesz%PythonVersion.InstallMacPythonMessagecCdtjdtjdSNz)Please use Python version {0}.{1} and up.rr)rrMIN_SUPPORTED_PY3_VERSIONr?r"r"r#SupportedVersionMessagez%PythonVersion.SupportedVersionMessagecCrr)rr"UPCOMING_PY3_MIN_SUPPORTED_VERSIONr?r"r"r#UpcomingSupportedVersionMessagerz-PythonVersion.UpcomingSupportedVersionMessageFc Csd}ttjdddk}d}|jsd||}n,|jddkr2d ||}d }n|jt j krJd |jd|jd ||}|r_|r_|r_t j |t j t jd S|rv|rgt|t j |t j t jdS|j|jkrt j d |jd ||t j dt jd St jr|jt jkrt j dt jdt jd t j||t j dt jd S)aEnsure that the Python version we are using is compatible. This will print an error message if not compatible. Compatible versions are 3.6+. We don't guarantee support for 3.6 so we want to warn about it. Args: raise_exception: bool, True to raise an exception rather than printing the error and exiting. Raises: Error: If not compatible and raise_exception is True. Returns: bool, True if the version is valid, False otherwise. NCLOUDSDK_ALLOW_PY2FalsetrueFzZERROR: Your current version of Python is not compatible with the Google Cloud CLI. {0}{1} rrzDERROR: Python 2 is not compatible with the Google Cloud CLI. {0}{1} TzJERROR: Python {0}.{1} is not compatible with the Google Cloud CLI. {2}{3} rzyWARNING: Python 3.{0}.x is no longer officially supported by the Google Cloud CLI and may not function correctly. {1}{2} z:WARNING: Python {0}.{1} will be deprecated on {2}. {3}{4})rGetEncodedValuerenvironrrirrrrMIN_REQUIRED_PY3_VERSIONrrrENV_VAR_MESSAGEr%rrUPCOMING_SUNSET_PY3_VERSIONUPCOMING_PY3_DEPRECATION_DATEr)r-raise_exceptionerror allow_py2 py2_errorr"r"r# IsCompatible s~        zPythonVersion.IsCompatibler6)F)r&r'r(r)rrrrrrMAX_SUPPORTED_PY3_VERSIONrrrrr,rrrrr"r"r"r#rs&  r)r) __future__rrrrrhrrrgooglecloudsdk.core.utilrrr$ Exceptionr%r*rr4rrrr"r"r"r#s(     n