&PSrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK r SSK J r Sr Sr "S S \5r"S S \5r"S S\5r"SS\5r"SS\5r"SS\5rg)z@Utilities for determining the current platform and architecture.)absolute_import)division)unicode_literalsN)encoding)/:*?"<>|c [R"SU5(a USS/nSnO/nSnSn[U[U55H[nX[;a9SnUR SR [RX555 MHUR X5 M] SRU5nU(aC[RRS R SR[5UU55 U$) 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_strings )lib/googlecloudsdk/core/util/platforms.pyMakePathWindowsCompatibler%"sYY}d##RazHKHK c$i (a w11!ooell ) / / 8:;oodg )GGH%/JJHHN!@A4(I*+ c\rSrSrSrSrg)Error=z2Base class for exceptions in the platforms moudle.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r*r&r$r(r(=s:r&r(c,^\rSrSrSrU4SjrSrU=r$)InvalidEnumValueBzFException for when a string could not be parsed to a valid enum value.c j>[[U] SRXSR U555 g)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)superr2__init__rr)selfgiven enum_typeoptions __class__s r$r6InvalidEnumValue.__init__Es- D*I $))G"4 57r&r*)r+r,r-r.r/r6r0 __classcell__)r;s@r$r2r2BsN 7 7r&r2c\rSrSrSr"SS\5r\"SSS5r\"SS S 5r\"S S S 5r \"SSS5r \"SSS5r \\\ \ \ /r \ S5r\ SSj5r\ S5r\ S5rSrg)OperatingSystemSz=An enum representing the operating system you are running on.c~\rSrSrSrSrSrSrSrSr \ S5r S r S r S rS r\S 5r\S5rSrg)OperatingSystem._OSVzA single operating system.c(XlX lX0lgNidname file_namer7rGrHrIs r$r6OperatingSystem._OS.__init__Zgi nr&cUR$rErGr7s r$__str__OperatingSystem._OS.__str___ WWnr&c[U[U55=(aY URUR:H=(a9 URUR:H=(a URUR:H$rE isinstancetyperGrHrIr7others r$__eq__OperatingSystem._OS.__eq__bVT +0gg!0ii5::%0nn/1r&c[UR5[UR5-[UR5-$rEhashrGrHrIrOs r$__hash__OperatingSystem._OS.__hash__h+ $'']T$))_ ,tDNN/C CCr&c X:X+$rEr*rWs r$__ne__OperatingSystem._OS.__ne__k  r&cX:X:- $z;Just a helper equivalent to the cmp() function in Python 2.r*clsxys r$ _CmpHelperOperatingSystem._OS._CmpHelperne r&cURURURUR4URURUR45S:$NrrlrGrHrIrWs r$__lt__OperatingSystem._OS.__lt__sG __ 77DIIt~~ . 88UZZ 135677r&cURURURUR4URURUR45S:$rprqrWs r$__gt__OperatingSystem._OS.__gt__xrtr&c.URU5(+$rErvrWs r$__le__OperatingSystem._OS.__le__}U# ##r&c.URU5(+$rErrrWs r$__ge__OperatingSystem._OS.__ge__r|r&c~U[R:Xa[R"5$[R"5$)z%Returns the operating system version.)r?WINDOWSplatformversionreleaserOs r$rOperatingSystem._OS.versions0 (( (!!    r&cRURnU[R:XaCUR5nUS;aU$UR S5(aUSSR SS5$[ R"SU5nU(dgSRS UR555$) z:Returns a cleaned version of the operating system version.)XPVISTASERVERN  _z(\d+)(\.\d+)?(\.\d+)?.*rc36# UHo(dM Uv M g7frEr*).0groups r$ 4OperatingSystem._OS.clean_version..sB(8uEUU(8s  ) rr?rupper startswithreplacermatchrgroups)r7r capitalizedmatchess r$ clean_version!OperatingSystem._OS.clean_versions g (( (mmo / ).  ! !( + +"%%c3/ /3W=g  WWB(8B BBr&rIrGrHN)r+r,r-r.r/r6rPrYr_rc classmethodrlrrrvrzrpropertyrrr0r*r&r$_OSrBVsq$! 1 D7 7 $$  CCr&rrWindowswindowsMACOSXzMac OS XdarwinLINUXLinuxlinuxCYGWINCygwincygwinMSYSMsysmsysc4[[R5$zFGets all possible enum values. Returns: list, All the enum values. )listr?_ALLr*r&r$ AllValuesOperatingSystem.AllValuess $$ %%r&cU(dg[RHnURU:XdMUs $ U(a5[US[RVs/sHo3RPM sn5egs snf)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 System)r?rrGr2)os_iderror_on_unknownoperating_systemvalues r$FromIdOperatingSystem.FromIdsm  +00    %1 U$64C4H4HI4H5hh4HI KK JA1 c$[RS:Xa[R$S[R ;a[R $S[R ;a[R$S[R ;a[R$g)zDetermines the current operating system. Returns: OperatingSystemTuple, One of the OperatingSystem constants or None if it cannot be determined. ntrrrN) osrHr?rrrrrrr*r&r$CurrentOperatingSystem.Currentsf ww$  $ $$ CLL  " "" S\\ !  # ## S\\ !  # ## r&cJ[R5[RL$)z8Returns True if the current operating system is Windows.)r?rrr*r&r$ IsWindowsOperatingSystem.IsWindowss  " " $(?(? ??r&r*NT)r+r,r-r.r/objectrrrrrrr staticmethodrrrrr0r*r&r$r?r?SsECCFCCJ  9i 0' xX .& gw (% x8 ,& VVV $$ 65&$ /$&&2"@@r&r?c"\rSrSrSr"SS\5r\"SSS5r\"SSS5r\"SSS5r \"S S S 5r \\\ \ /r 0S \_S\_S \_S \_S \_S\_S\_S\ _S\ _S\ _S\ _S\ _S\ _S\ _S\ _S\ _r \ S5r\ SSj5r\ S5rSrg) Architecturez@An enum representing the system architecture you are running on.c^\rSrSrSrSrSrSrSrSr \ S5r S r S r S rS rS rg)Architecture._ARCHzA single architecture.c(XlX lX0lgrErFrJs r$r6Architecture._ARCH.__init__rLr&cUR$rErNrOs r$rPArchitecture._ARCH.__str__rRr&c[U[U55=(aY URUR:H=(a9 URUR:H=(a URUR:H$rErTrWs r$rYArchitecture._ARCH.__eq__r[r&c[UR5[UR5-[UR5-$rEr]rOs r$r_Architecture._ARCH.__hash__rar&c X:X+$rEr*rWs r$rcArchitecture._ARCH.__ne__rer&cX:X:- $rgr*rhs r$rlArchitecture._ARCH._CmpHelperrnr&cURURURUR4URURUR45S:$rprqrWs r$rrArchitecture._ARCH.__lt__rtr&cURURURUR4URURUR45S:$rprqrWs r$rvArchitecture._ARCH.__gt__rtr&c.URU5(+$rEryrWs r$rzArchitecture._ARCH.__le__r|r&c.URU5(+$rEr~rWs r$rArchitecture._ARCH.__ge__ r|r&rN)r+r,r-r.r/r6rPrYr_rcrrlrrrvrzrr0r*r&r$_ARCHrsG ! 1 D7 7 $$r&rx86x86_64PPCppcarmamd64zi686-64i386i686ia64powerpczpower macintoshppc64armv6armv6larm64armv7armv7laarch64c4[[R5$r)rrrr*r&r$rArchitecture.AllValuess  !! ""r&cU(dg[RHnURU:XdMUs $ U(a5[US[RVs/sHo3RPM sn5egs snf)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. Nr)rrrGr2)architecture_idrarchrs r$rArchitecture.FromId&sh  !! O # " _n4@4E4EF4E5hh4EF HH Grc[RR[R"5R 55$)zDetermines the current system architecture. Returns: ArchitectureTuple, One of the Architecture constants or None if it cannot be determined. )r_MACHINE_TO_ARCHITECTUREgetrmachinelowerr*r&r$rArchitecture.Current@s-  0 0 4 4X5E5E5G5M5M5O PPr&r*Nr)r+r,r-r.r/rrrrrrrrrrrrr0r*r&r$rrsVH+$f+$Z eUE"# 8X .& eUE"# eUE"# vsC $ v)2F c3 %s c ( /6s  s  c  $+C  29#  @H   ##2QQr&rcT\rSrSrSrSrSr\S Sj5rSr Sr \S 5r S r g) PlatformiKz+Holds an operating system and architecture.cXlX lg)zConstructs a new platform. Args: operating_system: OperatingSystem, The OS architecture: Architecture, The machine architecture. N)r architecture)r7rrs r$r6Platform.__init__Ns-$r&cNSRURUR5$)Nz{}-{})rrrrOs r$rPPlatform.__str__Xs >>$//1B1B CCr&Nc[U(aUO[R5U(aU5$[R55$)aLDetermines 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. )rr?rr) os_override arch_overrides r$rPlatform.Current[s@ " (?(?(A&  DD,8,@,@,B DDr&cPUR[R:Xa8SRURRURR S9$UR[R :Xa8SRURRURR S9$UR[R:Xa\SnUR[R:XaURROSnURUURR S9$g)zGenerates 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}))rHrz({name} NT {version})z&(Macintosh; {name} Mac OS X {version})Intelz()) rr?rrrHrrrrrr)r7 format_string arch_strings r$UserAgentFragmentPlatform.UserAgentFragmentks  5 55" ( ($$))''//)11   /"9"9 9% + +$$))''//,11   /"8"8 8?m))\-=-==&&++CJ  ! !''//"11r&ct0nUR[R:XaSUS'SnSnX#-US'U$[RSS:Xa[RSS:aSUS 'O[ R US 'SUS'[RUS '[RUS '[RUS 'U$)aGReturns 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) rr?rr version_inforsetsid subprocessPIPE)r7argsdetached_processcreate_new_process_groups r$AsyncPopenArgsPlatform.AsyncPopenArgss& D  7 77d;#!+.Id? K  !  !c&6&6q&9A&=$( !YY\d; ood7m!d8n!d8n Kr&c/SQn[R"U[R[RS9nUR 5up#S[ R "U5;agg! g=f)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 stdoutdatars r$IsActuallyM1ArmArchitecture$Platform.IsActuallyM1ArmArchitecturesmr9r.MIN_REQUIRED_PY3_VERSIONrrrENV_VAR_MESSAGEr(r=rAUPCOMING_SUNSET_PY3_VERSIONUPCOMING_PY3_DEPRECATION_DATErB)r7raise_exceptionerror allow_py2 py2_errors r$ IsCompatiblePythonVersion.IsCompatible s$ E  JJ,g %'   I <<0t3353357  a1  &t'C'C'E'+'C'C'E!G i  >> >%t||A Q3353357  y jju jj}445   El jju jj}445  ||d444 jj EFLfll1o**,d.J.J.LGNO  jjtM999:"   : : ,,II I jj >>Df77:77:99224**, ?   jjtM999: r&)rrE)F)r+r,r-r.r/rKr=rrIrrJMAX_SUPPORTED_PY3_VERSIONrMrArNrLr6r9r>rBrSr0r*r&r$r.r.sy$$  ! ! **A    !''.$"6/P4  Sr&r.)r/ __future__rrrrrrrrgooglecloudsdk.core.utilrrr% Exceptionr(r2rr?rrr.r*r&r$rYs G&'   -#K6I 7u7"G@fG@TkQ6kQ\EvEPKFKr&