+
     h  c                  sv  a  0 t $ R t^ RIHt ^ RIt^ RIt^ RIt^ RIt^ RIt^ RI	t	^ RI
HtHt ^ RIHt ^ RIt]'       d	   ^ RIHtHt ]'       g"   ]	P(                  ! 4       R8X  d   ^ RIt^ RIHt M ! R R	4      t]! 4       tR
]R&    ! R R4      t ! R R4      t ! R R4      t ! R R]4      t ! R R4      tR# )zo
Environment info about Microsoft Compilers.

>>> getfixture('windows_only')
>>> ei = EnvironmentInfo('amd64')
)annotationsN)TYPE_CHECKING	TypedDict)unique_everseen)LiteralStringNotRequiredWindows)environc                  s&    ] tR t^ tRtRtRtRtRtR# )winregN )	__name__
__module____qualname____firstlineno__
HKEY_USERSHKEY_CURRENT_USERHKEY_LOCAL_MACHINEHKEY_CLASSES_ROOT__static_attributes__r	       4/usr/lib/python3.14/site-packages/setuptools/msvc.pyr   r       s    
 ! r   r   zdict[str, str]r   c                  s    ] tR t^)tRt]P                  ! RR4      P                  4       tR R lt	]
R 4       tR tR tRR	 R
 lltRR R lltRR ltRtR# )PlatformInfozi
Current and Target Architectures information.

Parameters
----------
arch: str
    Target architecture.
Zprocessor_architecture c                   V ^8  d   QhRR/#    returnZNoner	   Zformat   "r   __annotate__PlatformInfo.__annotate__5   s     9 9 9r   c                	sP    VP                  4       P                  R R4      V n        R# )x64amd64N)lowerreplacearch)selfr#      &&r   __init__ZPlatformInfo.__init__5   s    JJL((8	r   c                s`    V P                   V P                   P                  R4      ^,           R # )zC
Return Target CPU architecture.

Return
------
str
    Target CPU
_N)r#   Zfindr$      &r   
target_cpuZPlatformInfo.target_cpu8   s(     yy,q0233r   c                     V P                   R8H  # )zW
Return True if target CPU is x86 32 bits..

Return
------
bool
    CPU is x86 32 bits
x86r*   r(   r)   r   target_is_x86ZPlatformInfo.target_is_x86D   s     %''r   c                r+   )zX
Return True if current CPU is x86 32 bits..

Return
------
bool
    CPU is x86 32 bits
r,   current_cpur(   r)   r   current_is_x86ZPlatformInfo.current_is_x86O   s     5((r   c               r   r   r   strr	   r   r   r   r   r   Z   s     
 
s 
r   c                    V P                   R8X  d   V'       d   R# V P                   R8X  d   V'       d   R# RV P                    2# )u  
Current platform specific subfolder.

Parameters
----------
hidex86: bool
    return '' and not '' if architecture is x86.
x64: bool
    return 'd' and not 'md64' if architecture is amd64.

Return
------
str
    subfolder: '        arget', or '' (see hidex86 parameter)
r,   r   r    \x64\r/   r$   hidex86r      &&&r   current_dirZPlatformInfo.current_dirZ   sR    $   E)g 	
   G+ 	

 d&&'(	
r   c               r   r2   r	   r   r   r   r   r   r   s     
 
c 
r   c                r4   )a  
Target platform specific subfolder.

Parameters
----------
hidex86: bool
    return '' and not '\x86' if architecture is x86.
x64: bool
    return '\x64' and not '\amd64' if architecture is amd64.

Return
------
str
    subfolder: '\current', or '' (see hidex86 parameter)
r,   r   r    r5   r6   r-   r7   r9   r   
target_dirZPlatformInfo.target_dirr   sL    $ 5(W 	
 7*s 	

 doo&'	
r   c                s    V'       d   RMV P                   pV P                  V8X  d   R# V P                  4       P                  RRV R24      # )a  
Cross platform specific subfolder.

Parameters
----------
forcex86: bool
    Use 'x86' as current architecture even if current architecture is
    not x86.

Return
------
str
    subfolder: '' if target architecture is current architecture,
    '\current_target' if not.
r,   r   r6   r'   )r0   r*   r;   r"   )r$   forcex86Zcurrent   && r   	cross_dirZPlatformInfo.cross_dir   sQ      $%)9)9 ') 	
 "**42gYaA	
r   )r#   N)FFF)r
   r   r   r   __doc__r   getr!   r0   r&   propertyr*   r.   r1   r:   r;   r>   r   r	   r   r   r   r   )   sZ     ++6;AACK9 	4 	4	(	)
0
0
 
r   r   c                  s:   ] tR t^tRt]P                  ]P                  ]P                  ]P                  3t
R R lt]R R l4       t]R 4       t]R 4       t]R 4       t]R	 R
 l4       t]R R l4       t]R 4       t]R 4       t]R R l4       tRR ltR tRtR# )RegistryInfoz
Microsoft Visual Studio related registry information.

Parameters
----------
platform_info: PlatformInfo
    "PlatformInfo" instance.
c               r   r   r	   r   r   r   r   RegistryInfo.__annotate__   s          r   c                	s    Wn         R # Npi)r$   Zplatform_infor%   r   r&   ZRegistryInfo.__init__   s    r   c               r   r2   r	   r   r   r   r   rD      s     	 	c 	r   c                    R# )zP
Microsoft Visual Studio root registry key.

Return
------
str
    Registry key
ZVisualStudior	   r(   r)   r   visualstudioZRegistryInfo.visualstudio   s     r   c                V    \         P                  P                  V P                  R4      # )zO
Microsoft Visual Studio SxS registry key.

Return
------
str
    Registry key
ZSxS)ospathjoinrI   r(   r)   r   sxsZRegistryInfo.sxs   s     ww||D--u55r   c                rJ   )zL
Microsoft Visual C++ VC7 registry key.

Return
------
str
    Registry key
ZVC7rK   rL   rM   rN   r(   r)   r   vcZRegistryInfo.vc        ww||DHHe,,r   c                rJ   )zO
Microsoft Visual Studio VS7 registry key.

Return
------
str
    Registry key
ZVS7rO   r(   r)   r   vsZRegistryInfo.vs   rQ   r   c               r   r2   r	   r   r   r   r   rD      s     	% 	%s 	%r   c                rH   )zS
Microsoft Visual C++ for Python registry key.

Return
------
str
    Registry key
zDevDiv\VCForPythonr	   r(   r)   r   vc_for_pythonZRegistryInfo.vc_for_python   s     %r   c               r   r2   r	   r   r   r   r   rD      s     	  	 s 	 r   c                rH   )zA
Microsoft SDK registry key.

Return
------
str
    Registry key
zMicrosoft SDKsr	   r(   r)   r   microsoft_sdkZRegistryInfo.microsoft_sdk   s      r   c                rJ   )zR
Microsoft Windows/Platform SDK registry key.

Return
------
str
    Registry key
r   rK   rL   rM   rT   r(   r)   r   windows_sdkZRegistryInfo.windows_sdk   s     ww||D..	::r   c                rJ   )zP
Microsoft .NET Framework SDK registry key.

Return
------
str
    Registry key
ZNETFXSDKrU   r(   r)   r   	netfx_sdkZRegistryInfo.netfx_sdk
  s     ww||D..
;;r   c               r   r2   r	   r   r   r   r   rD     s     	/ 	/C 	/r   c                rH   )zP
Microsoft Windows Kits Roots registry key.

Return
------
str
    Registry key
zWindows Kits\Installed Rootsr	   r(   r)   r   windows_kits_rootsZRegistryInfo.windows_kits_roots  s     /r   c                s    V P                   P                  4       '       g	   V'       d   RMRp\        P                  P	                  RVRV4      # )z
Return key in Microsoft software registry.

Parameters
----------
key: str
    Registry key path where look.
x86: str
    Force x86 software registry.

Return
------
str
    Registry key
r   ZWow6432NodeZSoftwareZ	Microsoft)rG   r1   rK   rL   rM   )r$   keyr,   Znode64s   &&& r   	microsoftZRegistryInfo.microsoft"  s8      ww--//3Mww||JSAAr   c           	     sV   \         P                  p\         P                  p\         P                  pV P                  pV P
                   FG  pRp V! Wv! V4      ^ V4      p \         P                  ! Y4      ^ ,          T'       d   T! T4       u # u # 	  R#   \         dL    T P                  P                  4       '       g(    T! Yv! TR4      ^ T4      p Lv  \         d      K  i ; i K  i ; i  \         d     Mi ; i T'       d   T! T4       K  K    T'       d
   T! T4       i i ; i)z
Look for values in registry in Microsoft software registry.

Parameters
----------
key: str
    Registry key path where look.
name: str
    Value name to find.

Return
------
str
    value
NT)
r   KEY_READOpenKeyZCloseKeyrZ   HKEYSOSErrorrG   r1   ZQueryValueEx)	r$   rY   nameZkey_readZopenkeyZclosekeymshkeybkeys	   &&&      r   lookupZRegistryInfo.lookup5  s     ??..??^^JJDD	tRWa:#**46q9 TN # &   ww--//!&tRT]AxH" ! !   TN 4TN sT   B C/*C,CC% C,$C%%C,+C,/C=:D<C==DD(rF   Nr?   )r
   r   r   r   r@   r   r   r   r   r   r]   r&   rB   rI   rN   rP   rR   rS   rT   rV   rW   rX   rZ   rc   r   r	   r   r   rC   rC      s     	  !!  	E  	 	 	6 	6 	- 	- 	- 	- 	% 	% 	  	  	; 	; 	< 	< 	/ 	/B&'r   rC   c                  s   ] tR tRtRt]P                  ! RR4      t]P                  ! RR4      t]P                  ! R]4      t	R(R R	 llt
R
 tR tR R lt]R 4       t]R 4       t]R 4       tR tR t]R R l4       t]R 4       t]R R l4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R  R! l4       t ]R" R# l4       t!R$ R% lt"]R)R& l4       t#R't$R# )*
SystemInfoi_  z
Microsoft Windows and Visual Studio related system information.

Parameters
----------
registry_info: RegistryInfo
    "RegistryInfo" instance.
vc_ver: float
    Required Microsoft Visual C++ version.
WinDirr   ProgramFileszProgramFiles(x86)Nc               r   r   r	   r   r   r   r   SystemInfo.__annotate__q  s     S Sd Sr   c                	s    Wn         V P                   P                  V n        V P                  4       V n        T;'       g    V P	                  4       ;V n        V n        R # rE   )rirG   find_programdata_vs_versknown_vs_paths_find_latest_available_vs_vervs_vervc_ver)r$   Zregistry_inform   r9   r   r&   ZSystemInfo.__init__q  sH    ''**";;= %+$R$Rd.P.P.RRdkr   c                s   V P                  4       pV'       g2   V P                  '       g    \        P                  P	                  R4      h\        V4      pVP                  V P                  4       \        V4      R,          # )z=
Find the latest VC version

Return
------
float
    version
z%No Microsoft Visual C++ version found)find_reg_vs_versrj   	distutilserrorsDistutilsPlatformErrorZsetZupdatesorted)r$   Zreg_vc_versZvc_vers   &  r   rk   Z(SystemInfo._find_latest_available_vs_verz  si     ++-t222""997  k"t**+gr""r   c                sd   V P                   P                  pV P                   P                  V P                   P                  V P                   P                  3p. p\
        P                  ! V P                   P                  V4       EFL  w  rE \        P                  ! WA! V4      ^ \        P                  4      pT;_uu_ 4        \        P                  ! T4      w  rxp	\        T4       Fk  p
\        P                  ! \         4      ;_uu_ 4        \#        \        P$                  ! Yj4      ^ ,          4      pY9  d   TP'                  T4       RRR4       Km  	  \        T4       Fd  p
\        P                  ! \         4      ;_uu_ 4        \#        \        P(                  ! Yj4      4      pY9  d   TP'                  T4       RRR4       Kf  	  RRR4       EKO  	  \+        V4      #   \         d     EKk  i ; i  + '       g   i     EK  ; i  + '       g   i     K  ; i  + '       g   i     EK  ; i)zh
Find Microsoft Visual Studio versions available in registry.

Return
------
list of float
    Versions
N)rh   rZ   rP   rS   rR   	itertoolsproductr]   r   r\   r[   r^   ZQueryInfoKeyZrange
contextlibZsuppressZ
ValueErrorfloatZ	EnumValueZappendZEnumKeyrs   )r$   r`   ZvckeysZvs_versra   rY   rb   ZsubkeysZvaluesr'   Zivers   &           r   ro   ZSystemInfo.find_reg_vs_vers  s    WW''**dgg33TWWZZ@"**477==&AID~~dBsGQH %+%8%8%>"vA#,,Z88#F$4$4T$=a$@A-#NN3/ 98 '
 wA#,,Z88#FNN4$;<-#NN3/ 98 (  B" g  
 988
 988 sO   ,G!A
H>G4
<H7H	=H!G10G14H?
H	H	HH/c               r   )r   r   zdict[float, str]r	   r   r   r   r   rg     s     ( (*: (r   c                s$   / pRp \         P                  ! V4      pT F  p \         P                  P	                  Y$R4      p\        TRRR7      ;_uu_ 4       p\        P                  ! T4      pRRR4       XR,          p\         P                  ! \         P                  P	                  TR4      4       TYP                  TR	,          4      &   K  	  T#   \         d    Tu # i ; i  + '       g   i     L; i  \        \        3 d     K  i ; i)
z
Find Visual studio 2017+ versions from information in
"C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances".

Return
------
dict
    float version as key, path as value.
z9C:\ProgramData\Microsoft\VisualStudio\Packages\_Instancesz
state.jsonZrtzutf-8)ZencodingNZinstallationPathVC\Tools\MSVCZinstallationVersion)
rK   listdirr^   rL   rM   ZopenjsonZload_as_float_versionKeyError)	r$   Zvs_versionsZinstances_dirZhashed_namesr_   Z
state_pathZ
state_fileZstateZvs_path	   &        r   ri   Z#SystemInfo.find_programdata_vs_vers  s     )+T	::m4L !DWW\\-|L
*dW== IIj1E > 23 

277<<1ABC  2259N3OPQ !( 1  		 >= X& s;   C 6C:C'/AC:C$#C$'C72C::DDc                sb    \        RP                  V P                  R4      R,          4      4      # )z
Return a string version as a simplified float version (major.minor)

Parameters
----------
version: str
    Version.

Return
------
float
    version
.Nr   N)rx   rM   split)Zversionr)   r   r}   ZSystemInfo._as_float_version  s&     SXXgmmC04566r   c                s    \         P                  P                  V P                  RV P                  R 24      pV P
                  P                  V P
                  P                  V P                  R 4      ;'       g    T# )z@
Microsoft Visual Studio directory.

Return
------
str
    path
Microsoft Visual Studio 0.1f)rK   rL   rM   ProgramFilesx86rl   rh   rc   rR   )r$   default   & r   VSInstallDirZSystemInfo.VSInstallDir  s`     '',,  $<T[[<N"O

 ww~~dggjjT[[,>@KKGKr   c                s    V P                  4       ;'       g    V P                  4       p\        P                  P	                  V4      '       g"   Rp\
        P                  P                  V4      hV# )z=
Microsoft Visual C++ directory.

Return
------
str
    path
z(Microsoft Visual C++ directory not found)	_guess_vc_guess_vc_legacyrK   rL   isdirrp   rq   rr   )r$   rL   msgrt   r   VCInstallDirZSystemInfo.VCInstallDir  sU     ~~::4#8#8#:ww}}T""<C""99#>>r   c                s   V P                   R8:  d   R#  V P                  V P                   ,          p\        P
                  P                  VR4      p \        P                  ! V4      R,          pV P                  V4      V n	        \        P
                  P                  W#4      #   \         d    T P                  p Li ; i  \        \        3 d     R# i ; i)z<
Locate Visual C++ for VS2017+.

Return
------
str
    path
      ,@r   rz   rn   )rl   rj   r~   r   rK   rL   rM   r{   r}   rm   r^   Z
IndexError)r$   Zvs_dirZguess_vcrm      &   r   r   ZSystemInfo._guess_vc  s     ;;$	'((5F
 77<<(89	ZZ)"-F008DK77<<11  	'&&F	' $ 		s$   B% AC %B?>B?CCc                s   \         P                  P                  V P                  RV P                  R R24      p\         P                  P                  V P
                  P                  V P                  R 4      pV P
                  P                  VR4      pV'       d!   \         P                  P                  VR4      MTpV P
                  P                  V P
                  P                  V P                  R 4      ;'       g    T# )zK
Locate Visual C++ for versions prior to 2017.

Return
------
str
    path
r   r   z\VC
installdirZVC)	rK   rL   rM   r   rl   rh   rS   rc   rP   )r$   r   Zreg_pathZ	python_vcZ
default_vc   &    r   r   ZSystemInfo._guess_vc_legacy*  s     '',,  'D'9=
 77<< 5 5$++d9KMGGNN8\:	6?RWW\\)T2W
 ww~~dggjjT[[,>@NNJNr   c               r   )r   r   ztuple[LiteralString, ...]r	   r   r   r   r   rg   A  s      #< r   c                s    V P                   R8:  d   R# V P                   R8X  d   R# V P                   R8X  d   R# V P                   R8X  d   R	# V P                   R8  d   R
# R# )zg
Microsoft Windows SDK versions for specified MSVC++ version.

Return
------
tuple of str
    versions
      "@      $@      &@      (@r   )z7.0z6.1z6.0a)z7.1z7.0a)z8.0z8.0a)8.1z8.1a)z10.0r   r	   rl   r(   r)   r   WindowsSdkVersionZSystemInfo.WindowsSdkVersion@  sc     ;;#''[[D   [[D   [[D   [[D   	r   c                t    V P                  \        P                  P                  V P                  R4      4      # )zD
Microsoft Windows SDK last version.

Return
------
str
    version
lib)_use_last_dir_namerK   rL   rM   WindowsSdkDirr(   r)   r   WindowsSdkLastVersionZ SystemInfo.WindowsSdkLastVersionV  s*     &&rww||D4F4F'NOOr   c               r   r   r   z
str | Noner	   r   r   r   r   rg   c  s     ( (z (r   c                s8   RpV P                    F`  p\        P                  P                  V P                  P
                  RV 24      pV P                  P                  VR4      pV'       g   K`   M	  V'       d&   \        P                  P                  V4      '       g   \        P                  P                  V P                  P                  V P                  R 4      pV P                  P                  VR4      pV'       d!   \        P                  P                  VR4      pV'       d&   \        P                  P                  V4      '       g   V P                    Fo  pVRVP                  R4       pR	V 2p\        P                  P                  V P                  V4      p\        P                  P                  V4      '       g   Km  TpKq  	  V'       d&   \        P                  P                  V4      '       gl   V P                    F[  pR
V 2p\        P                  P                  V P                  V4      p\        P                  P                  V4      '       g   KY  TpK]  	  V'       g+   \        P                  P                  V P                  R4      pV# )z>
Microsoft Windows SDK directory.

Return
------
str
    path
r   vinstallationfolderr   r   ZWinSDKNr   zMicrosoft SDKs\Windows Kits\zMicrosoft SDKs\Windows\vZPlatformSDK)r   rK   rL   rM   rh   rV   rc   r   rS   rm   Zrfindrf   r   )r$   sdkdirry   locrL   Zinstall_baseZintverZd   &       r   r   ZSystemInfo.WindowsSdkDirb  s     ))C'',,tww22auI>CWW^^C)=>Fv * RWW]]62277<< 5 5$++d9KMD77>>$=LlH=RWW]]622---syy~.6vh?GGLL!2!2D977==##F . RWW]]622--23%8GGLL!2!2D977==##F	 .
 WW\\$"3"3]CFr   c                s   V P                   R8:  d   ^#pRpMD^(pV P                   R8:  d   RMRpV P                  P                  RVR7      P                  RR4      pR	V R
V 2p. pV P                   R8  dP   V P                   F?  pV\
        P                  P                  V P                  P                  Wd4      .,          pKA  	  V P                   FD  pV\
        P                  P                  V P                  P                  RV R2V4      .,          pKF  	  V F+  pV P                  P                  VR4      pV'       g   K)  Vu # 	  R# )zI
Microsoft Windows SDK executable directory.

Return
------
str
    path
r   r   r   TF)r   r8   r6   Z-zWinSDK-NetFxZToolsr   r   ZAr   N)rl   rG   r:   r"   NetFxSdkVersionrK   rL   rM   rh   rW   r   rV   rc   )	r$   Znetfxverr#   r8   ZfxZregpathsry   rL   Zexecpathr   r   WindowsSDKExecutablePathZ#SystemInfo.WindowsSDKExecutablePath  s%    ;;$HDH"kkT1duG77&&4&AII$PSTDH:U4&1 ;;$++RWW\\$''*;*;SEFF , ))Cdgg&9&9Qse1:rJKKH * Dww~~d,@AHx 
 r   c                s    \         P                  P                  V P                  P                  V P
                  R R24      pV P                  P                  VR4      ;'       g    R# )z<
Microsoft Visual F# directory.

Return
------
str
    path
r   z	\Setup\F#Z
productdirr   )rK   rL   rM   rh   rI   rl   rc   )r$   rL   r   r   FSharpInstallDirZSystemInfo.FSharpInstallDir  sM     ww||DGG00dkk$5Gy2QRww~~dL177R7r   c                s    V P                   R8  d   RMRpV FL  pV P                  P                  V P                  P                  RV 24      pV'       g   K@  T;'       g    Ru # 	  R# )zD
Microsoft Universal CRT SDK directory.

Return
------
str
    path
r   Zkitsrootr   N)Z10Z81r	   )rl   rh   rc   rX   )r$   Zversry   r   r   r   UniversalCRTSdkDirZSystemInfo.UniversalCRTSdkDir  s]      ${{d2| CWW^^DGG$>$>(3%@PQFv||# 
 r   c                r   )zP
Microsoft Universal C Runtime SDK last version.

Return
------
str
    version
r   )r   rK   rL   rM   r   r(   r)   r   UniversalCRTSdkLastVersionZ%SystemInfo.UniversalCRTSdkLastVersion  s*     &&rww||D4K4KU'STTr   c                s,    V P                   R8  d   R# R# )zQ
Microsoft .NET Framework SDK versions.

Return
------
tuple of str
    versions
r   )	z4.7.2z4.7.1z4.7z4.6.2z4.6.1z4.6z4.5.2z4.5.1z4.5r	   r   r(   r)   r   r   ZSystemInfo.NetFxSdkVersion  s%     {{d" X	
 	
r   c                s    RpV P                    F^  p\        P                  P                  V P                  P
                  V4      pV P                  P                  VR4      pV'       g   K]   V# 	  V# )zE
Microsoft .NET Framework SDK directory.

Return
------
str
    path
r   Zkitsinstallationfolder)r   rK   rL   rM   rh   rW   rc   )r$   r   ry   r   r   r   NetFxSdkDirZSystemInfo.NetFxSdkDir  s`     ''C'',,tww00#6CWW^^C)ABFv (
 r   c                    \         P                  P                  V P                  R4      pV P                  P                  V P                  P                  R4      ;'       g    T# )zG
Microsoft .NET Framework 32bit directory.

Return
------
str
    path
zMicrosoft.NET\FrameworkZframeworkdir32rK   rL   rM   re   rh   rc   rP   r$   Zguess_fwr   r   FrameworkDir32ZSystemInfo.FrameworkDir32  sE     77<<-GH ww~~dggjj*:;GGxGr   c                r   )zG
Microsoft .NET Framework 64bit directory.

Return
------
str
    path
zMicrosoft.NET\Framework64Zframeworkdir64r   r   r   r   FrameworkDir64ZSystemInfo.FrameworkDir64  sE     77<<-IJ ww~~dggjj*:;GGxGr   c               r   r   r   ztuple[str, ...]r	   r   r   r   r   rg   $       	/ 	/O 	/r   c                s$    V P                  ^ 4      # )zS
Microsoft .NET Framework 32bit versions.

Return
------
tuple of str
    versions
_find_dot_net_versionsr(   r)   r   FrameworkVersion32ZSystemInfo.FrameworkVersion32#       **2..r   c               r   r   r	   r   r   r   r   rg   0  r   r   c                s$    V P                  ^@4      # )zS
Microsoft .NET Framework 64bit versions.

Return
------
tuple of str
    versions
r   r(   r)   r   FrameworkVersion64ZSystemInfo.FrameworkVersion64/  r   r   c               r   r   r	   r   r   r   r   rg   ;  s      o r   c                s   V P                   P                  V P                   P                  RV 24      p\        V RV 24      pT;'       g    V P	                  VR4      ;'       g    RpV P
                  R8  d   VR3# V P
                  R8  d#   VP                  4       R,          R	8w  d   R# TR
3# V P
                  R8X  d   R# V P
                  R8X  d   R# R# )z
Find Microsoft .NET Framework versions.

Parameters
----------
bits: int
    Platform number of bits: 32 or 64.

Return
------
tuple of str
    versions
ZframeworkverZFrameworkDirr   r   r   zv4.0r   r   Zv4v3.5r   g       @)z
v4.0.30319r   )r   
v2.0.50727)zv3.0r   r	   )rh   rc   rP   Zgetattrr   rl   r!   )r$   ZbitsZreg_verZdot_net_dirry   s   &&   r   r   Z!SystemInfo._find_dot_net_versions;  s     ''..|D6-BCdl4&$9:HH00cBHHb ;;$;[[D #&99;r?d#:KKVKK[[C''[[C''	r   c                s   a a V V3R l\        \        P                  ! S 4      4       4       p\        VR4      ;'       g    R# )z
Return name of the last dir in path or '' if no dir found.

Parameters
----------
path: str
    Use dirs in this path
prefix: str
    Use only dirs starting by this prefix

Return
------
str
    name
c              3  s   <"   T Fe  p\         P                  P                  \         P                  P                  SV4      4      '       g   KH  VP	                  S4      '       g   Ka  Vx  Kg  	  R # 5irE   )rK   rL   r   rM   Z
startswith).0Zdir_namerL   prefixs   & r   	<genexpr>Z0SystemInfo._use_last_dir_name.<locals>.<genexpr>j  sN      
6ww}}RWW\\$9:  ##F+ H6s   AA0A0&
A0Nr   )ZreversedrK   r{   next)rL   r   Zmatching_dirss   ff r   r   ZSystemInfo._use_last_dir_nameY  s7    "
$RZZ%56
 M4(..B.r   )rj   rG   rh   rm   rl   rE   )r   )%r
   r   r   r   r@   r   rA   re   rf   r   r&   rk   ro   ri   Zstaticmethodr}   rB   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r	   r   r   rd   rd   _  s   	 [[2&F;;~r2Lkk"5|DOS#(>(T 7 7  L L"  "<O,  * 	P 	P ( (T " "H 
8 
8  ( 	U 	U 
 
   " H H H H 	/ 	/ 	/ 	/< / /r   rd   c                  sJ    ] tR tRt$ R]R&   R]R&   R]R&   R]R&   R]R&   R	tR
# )_EnvironmentDictis  r3   includer   libpathrL   zNotRequired[str | None]py_vcruntime_redistr	   N)r
   r   r   r   __annotations__r   r	   r   r   r   r   s  s    L	HL
I00r   r   c                  s   ] tR tRtRtR$R R llt]R 4       t]R 4       t]R 4       t	]R	 4       t
]R
 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       tR t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R 4       t]R R l4       tR%R  R! llt R" t!R#t"R# )&EnvironmentInfoi{  a  
Return environment variables for specified Microsoft Visual C++ version
and platform : Lib, Include, Path and libpath.

This function is compatible with Microsoft Visual C++ 9.0 to 14.X.

Script created by analysing Microsoft environment configuration files like
"vcvars[...].bat", "SetEnv.Cmd", "vcbuildtools.bat", ...

Parameters
----------
arch: str
    Target architecture.
vc_ver: float
    Required Microsoft Visual C++ version. If not set, autodetect the last
    version.
vc_min_ver: float
    Minimum Microsoft Visual C++ version.
Nc               r   r   r	   r   r   r   r   EnvironmentInfo.__annotate__  s     ? ?4 ?r   c                	s    \        V4      V n        \        V P                  4      V n        \	        V P                  V4      V n        V P                  V8  d"   R p\        P                  P                  V4      hR# )z.No suitable Microsoft Visual C++ version foundN)
r   rG   rC   rh   rd   sirm   rp   rq   rr   )r$   r#   rm   Z
vc_min_verZerrs   &&&& r   r&   ZEnvironmentInfo.__init__  s]    t$tww'TWWf-;;#BC""99#>> $r   c                .    V P                   P                  # )z;
Microsoft Visual Studio.

Return
------
float
    version
)r   rl   r(   r)   r   rl   ZEnvironmentInfo.vs_ver       ww~~r   c                r   )z@
Microsoft Visual C++ version.

Return
------
float
    version
)r   rm   r(   r)   r   rm   ZEnvironmentInfo.vc_ver  r   r   c                s:   RR.pV P                   R8  d?   V P                  P                  RRR7      pVR.,          pVR.,          pVRV 2.,          pV Uu. uF7  p\        P                  P                  V P                  P                  V4      NK9  	  up# u upi )zE
Microsoft Visual Studio Tools.

Return
------
list of str
    paths
zCommon7\IDEzCommon7\Toolsr   Tr8   r   z1Common7\IDE\CommonExtensions\Microsoft\TestWindowzTeam Tools\Performance Tools)rl   rG   r:   rK   rL   rM   r   r   )r$   pathsarch_subdirrL   r   r   VSToolsZEnvironmentInfo.VSTools  s      !12;;$''--d-EKJKKE566E5k]CDDEEJKUTTWW1148UKKKs   =Bc                s    \         P                  P                  V P                  P                  R4      \         P                  P                  V P                  P                  R4      .# )zb
Microsoft Visual C++ & Microsoft Foundation Class Includes.

Return
------
list of str
    paths
ZIncludezATLMFC\Include)rK   rL   rM   r   r   r(   r)   r   
VCIncludesZEnvironmentInfo.VCIncludes  sG     GGLL--y9GGLL--/@A
 	
r   c                sx   V P                   R8  d   V P                  P                  RR7      pMV P                  P                  RR7      pRV 2RV 2.pV P                   R8  d   VRV 2.,          pV Uu. uF7  p\        P                  P                  V P                  P                  V4      NK9  	  up# u upi )	zc
Microsoft Visual C++ & Microsoft Foundation Class Libraries.

Return
------
list of str
    paths
      .@Tr   r8   Libz
ATLMFC\Libr   z	Lib\store)rl   rG   r;   rK   rL   rM   r   r   )r$   r   r   rL   r   r   VCLibrariesZEnvironmentInfo.VCLibraries  s     ;;$'',,,6K'',,T,:K{m$K=&AB;;$;-011EEJKUTTWW1148UKKKs   7=B7c                    V P                   R8  d   . # \        P                  P                  V P                  P
                  R4      .# )zW
Microsoft Visual C++ store references Libraries.

Return
------
list of str
    paths
r   zLib\store\references)rl   rK   rL   rM   r   r   r(   r)   r   VCStoreRefsZEnvironmentInfo.VCStoreRefs  s8     ;;ITWW113JKLLr   c           	     s   V P                   p\        P                  P                  VP                  R4      .pV P
                  R8:  d   RMRpV P                  P                  V4      pV'       d6   V\        P                  P                  VP                  RV 24      .,          pV P
                  R8X  dT   RV P                  P                  RR7       2pV\        P                  P                  VP                  V4      .,          pV# V P
                  R8  Ed.   V P                  P                  P                  R	R
4      P                  4       p\        P                  P                  RRV R24      pV\        P                  P                  VP                  WpP                  P                  RR7      ,          4      .,          pV P                  P                  V P                  P                  8w  dS   V\        P                  P                  VP                  WpP                  P                  RR7      ,          4      .,          pV# V\        P                  P                  VP                  R4      .,          pV# )ak  
Microsoft Visual C++ Tools.

Return
------
list of str
    paths

When host CPU is ARM, the tools should be found for ARM.

>>> getfixture('windows_only')
>>> mp = getfixture('monkeypatch')
>>> mp.setattr(PlatformInfo, 'current_cpu', 'arm64')
>>> ei = EnvironmentInfo(arch='irrelevant')
>>> paths = ei.VCTools
>>> any('HostARM64' in path for path in paths)
True
Z
VCPackagesr   TFBinr   r   r   r    r   ZbinZHostz%sr   )r   rK   rL   rM   r   rl   rG   r>   r:   r0   r"   upperr;   r*   )r$   r   toolsr<   r   rL   Zhost_idZhost_dirr   r   VCToolsZEnvironmentInfo.VCTools  s   ( WWboo|<=;;$.4Egg''1bggll2??c+4GHIIE;;$,,T,:;<Dbggll2??D9::E& # [[D gg))11'5AGGIGww||ET'"+=>HR__h9K9KPT9K9U.UV E ww""dgg&8&88GGLLGG4G4GD4G4Q)Q   bggll2??E:;;Er   c                s   V P                   R8:  dV   V P                  P                  RRR7      p\        P                  P                  V P                  P                  RV 24      .# V P                  P                  RR7      p\        P                  P                  V P                  P                  R4      pV P                  p\        P                  P                  W# RV 24      .# )zG
Microsoft Windows SDK Libraries.

Return
------
list of str
    paths
r   Tr   r   r   r   um)	rl   rG   r;   rK   rL   rM   r   r   _sdk_subdir)r$   r   r   Zlibverr   r   OSLibrariesZEnvironmentInfo.OSLibraries-  s     ;;$'',,Tt,DKGGLL!6!6#k]8KLMM '',,,6K'',,tww44e<C%%FGGLL;-&@ABBr   c                s   \         P                  P                  V P                  P                  R4      pV P
                  R8:  d#   V\         P                  P                  VR4      .# V P
                  R8  d   V P                  pMRp\         P                  P                  W R24      \         P                  P                  W R24      \         P                  P                  W R24      .# )	zE
Microsoft Windows SDK Include.

Return
------
list of str
    paths
r   r   Zglr   r   Zsharedr   Zwinrt)rK   rL   rM   r   r   rl   r   )r$   r   sdkverrt   r   
OSIncludesZEnvironmentInfo.OSIncludesA  s     '',,tww44i@;;$RWW\\'4899 {{d"))W&78Wm4W&67 r   c                s   \         P                  P                  V P                  P                  R4      p. pV P
                  R8:  d   W P                  ,          pV P
                  R8  d)   V\         P                  P                  VR4      .,          pV P
                  R8  d   VV\         P                  P                  V P                  P                  R4      \         P                  P                  VRR4      \         P                  P                  VR	R4      \         P                  P                  VR
R4      \         P                  P                  V P                  P                  RRV P
                  R RRR4      .,          pV# )zM
Microsoft Windows SDK Libraries Paths.

Return
------
list of str
    paths
Z
Referencesr   r   zCommonConfiguration\Neutralr   ZUnionMetadataz'Windows.Foundation.UniversalApiContractz1.0.0.0z%Windows.Foundation.FoundationContractz,Windows.Networking.Connectivity.WwanContractZExtensionSDKszMicrosoft.VCLibsr   ZCommonConfigurationZneutral)rK   rL   rM   r   r   rl   r   )r$   Zrefr   rt   r   	OSLibpathZEnvironmentInfo.OSLibpath[  s'    ggll47700,?;;#'''G;;$S*HIJJG;;$TWW22ODS"KYWS"I9UG GG))#&{{4( ) G$ r   c                s4    \        V P                  4       4      # )zC
Microsoft Windows SDK Tools.

Return
------
list of str
    paths
)list
_sdk_toolsr(   r)   r   SdkToolsZEnvironmentInfo.SdkTools  s     DOO%&&r   c              #  sr  "   V P                   R8  dL   V P                   R8:  d   RMRp\        P                  P                  V P                  P
                  V4      x  V P                  P                  4       '       gX   V P                  P                  RR7      pRV 2p\        P                  P                  V P                  P
                  V4      x  V P                   R9   d}   V P                  P                  4       '       d   RpMV P                  P                  RRR7      pR	V 2p\        P                  P                  V P                  P
                  V4      x  MV P                   R8  d   \        P                  P                  V P                  P
                  R4      pV P                  P                  RR7      pV P                  P                  p\        P                  P                  W4 V 24      x  V P                  P                  '       d   V P                  P                  x  R
# R
# 5i)zX
Microsoft Windows SDK Tools paths generator.

Return
------
generator of str
    paths
r   r   r   zBin\x86Tr   r   r   zBin\NETFX 4.0 ToolsN)r   r   )rl   rK   rL   rM   r   r   rG   r1   r:   r.   r   r   )r$   Zbin_dirr   rL   r   r   r   r   ZEnvironmentInfo._sdk_tools  s     ;;#{{d2e
G'',,tww44g>>ww%%''''--$-7K&D'',,tww44d;;;;,&ww$$&& "gg11$D1I)+7D'',,tww44d;;[[D 77<< 5 5u=D''--$-7KWW22F'',,tx}%=>>77+++''222 ,s   A<H7?BH7DH7H7c                L    V P                   P                  pV'       d   V R2# R# )zE
Microsoft Windows SDK version subdir.

Return
------
str
    subdir
r6   r   )r   r   r$   ucrtverr   r   r   ZEnvironmentInfo._sdk_subdir  s&     ''//#*7)222r   c                s    V P                   R8  d   . # \        P                  P                  V P                  P
                  R4      .# )zC
Microsoft Windows SDK Setup.

Return
------
list of str
    paths
r   ZSetup)rl   rK   rL   rM   r   r   r(   r)   r   SdkSetupZEnvironmentInfo.SdkSetup  s7     ;;ITWW22G<==r   c                s   V P                   pV P                  pV P                  R8:  d6   RpVP                  4       '       * ;'       d    VP	                  4       '       * pMNVP                  4       ;'       g    VP	                  4       pVP
                  R8H  ;'       g    VP                  R8H  p. pV'       dL   TVP                   Uu. uF-  p\        P                  P                  VP                  V4      NK/  	  up,          pV'       dL   TVP                   Uu. uF-  p\        P                  P                  VP                  V4      NK/  	  up,          pV# u upi u upi )zF
Microsoft .NET Framework Tools.

Return
------
list of str
    paths
r   Tr    )rG   r   rl   r.   r1   r0   r*   r   rK   rL   rM   r   r   r   )r$   rG   r   Z	include32Z	include64r   ry   s   &      r   FxToolsZEnvironmentInfo.FxTools  s"    WWWW;;$I,,..JJr7H7H7J3JI((*AAb.?.?.AI'1MMR]]g5MI@B@U@U@UR..4@U E @B@U@U@UR..4@U E s   3E3Ec                s   V P                   R8  g   V P                  P                  '       g   . # V P                  P	                  RR7      p\
        P                  P                  V P                  P                  RV 24      .# )zN
Microsoft .Net Framework SDK Libraries.

Return
------
list of str
    paths
r   Tr   zlib\um)rl   r   r   rG   r;   rK   rL   rM   )r$   r   r   r   NetFxSDKLibrariesZ!EnvironmentInfo.NetFxSDKLibraries  sd     ;;TWW%8%8%8Igg((T(2TWW00VK=2IJKKr   c                s    V P                   R8  g   V P                  P                  '       g   . # \        P                  P                  V P                  P                  R4      .# )zM
Microsoft .Net Framework SDK Includes.

Return
------
list of str
    paths
r   z
include\um)rl   r   r   rK   rL   rM   r(   r)   r   NetFxSDKIncludesZ EnvironmentInfo.NetFxSDKIncludes  sF     ;;TWW%8%8%8ITWW00-@AAr   c                sl    \         P                  P                  V P                  P                  R4      .# )zT
Microsoft Visual Studio Team System Database.

Return
------
list of str
    paths
zVSTSDB\Deploy)rK   rL   rM   r   r   r(   r)   r   VsTDbZEnvironmentInfo.VsTDb  s'     TWW113CDEEr   c                s   V P                   R8  d   . # V P                   R8  d4   V P                  P                  pV P                  P	                  RR7      pMV P                  P
                  pRpRV P                   R RV 2p\        P                  P                  W4      .pV P                   R8  d)   V\        P                  P                  WR	4      .,          pV# )
z>
Microsoft Build Engine.

Return
------
list of str
    paths
r   r   Tr   r   zMSBuild\r   z\binZRoslyn)	rl   r   r   rG   r:   r   rK   rL   rM   )r$   Z	base_pathr   rL   Zbuildr   r   MSBuildZEnvironmentInfo.MSBuild  s     ;;I[[4//I''--d-;K,,IK4;;t,D>i./;;$bggll9H=>>Er   c                r   )zD
Microsoft HTML Help Workshop.

Return
------
list of str
    paths
r   zHTML Help Workshop)rl   rK   rL   rM   r   r   r(   r)   r   HTMLHelpWorkshopZ EnvironmentInfo.HTMLHelpWorkshop4  s8     ;;ITWW446JKLLr   c                s*   V P                   R8  d   . # V P                  P                  RR7      p\        P                  P                  V P                  P                  R4      pV P                  p\        P                  P                  W# RV 24      .# )zS
Microsoft Universal C Runtime SDK Libraries.

Return
------
list of str
    paths
r   Tr   r   ucrt)	rl   rG   r;   rK   rL   rM   r   r   _ucrt_subdir)r$   r   r   r   r   r   UCRTLibrariesZEnvironmentInfo.UCRTLibrariesC  sv     ;;Igg((T(2ggll47755u=##SIT+"?@AAr   c                s    V P                   R8  d   . # \        P                  P                  V P                  P
                  R4      p\        P                  P                  WP                   R24      .# )zQ
Microsoft Universal C Runtime SDK Include.

Return
------
list of str
    paths
r   r   r   )rl   rK   rL   rM   r   r   r   )r$   r   r   r   UCRTIncludesZEnvironmentInfo.UCRTIncludesU  sW     ;;I'',,tww999EW):):(;4&@ABBr   c                r   )zQ
Microsoft Universal C Runtime SDK version subdir.

Return
------
str
    subdir
r6   r   )r   r   r   r   r   r   ZEnvironmentInfo._ucrt_subdire  s&     ''44#*7)222r   c                sj    RV P                   u;8  d
   R8  d    . #  V P                  P                  .# )z;
Microsoft Visual F#.

Return
------
list of str
    paths
r   r   )rl   r   r   r(   r)   r   FSharpZEnvironmentInfo.FSharpr  s4     $++$$I % (())r   c               r   r   r	   r   r   r   r   r     s      C  C  Cr   c                sv  aa RV P                    R2oV P                  P                  RR7      P                  R4      o. pV P                  P
                  p\        P                  P                  VP                  RR4      4      p\        P                  P                  V4      '       dd   \        P                  P                  V\        P                  ! V4      R,          4      pW\        P                  P                  VR4      .,          pV\        P                  P                  VR	4      .,          pR
V P                   ^
,           R2R
\        V P                  4      ^
,           R23pVV3R l\        P                   ! W4       4       p\#        \%        \        P                  P&                  V4      R4      # )zc
Microsoft Visual C++ runtime redistributable dll.

Returns the first suitable path found or None.
	vcruntimez0.dllTr   r6   z\Toolsz\RedistZonecoreZredistzMicrosoft.VCz.CRTc              3  sl   <"   T F)  w  r\         P                  P                  VSVS4      x  K+  	  R # 5irE   )rK   rL   rM   )r   r   Zcrt_dirr   r   s   &  r   r   Z2EnvironmentInfo.VCRuntimeRedist.<locals>.<genexpr>  s1      
%J! GGLLgyAA%Js   14Nrn   )rm   rG   r;   Zstripr   r   rK   rL   Zdirnamer"   r   rM   r{   Zintrl   ru   rv   r   filterZisfile)r$   ZprefixesZ
tools_pathZredist_pathZcrt_dirsZcandidate_pathsr   r   s   &     @@r   VCRuntimeRedistZEnvironmentInfo.VCRuntimeRedist  sM     }E2	gg((T(288> WW))
ggooj&8&8J&OP77==%%'',,{BJJ{4KB4OPKbggll;	&JKKHRWW\\*h788 4;;+,D13t{{+b016

%.%6%6x%J
 F277>>?;TBBr   c               s     V ^8  d   QhRRRR/# )r   existsZboolr   r   r	   r   r   r   r   r     s     ; ; ;1A ;r   c                s   \        V P                  RV P                  V P                  V P                  V P
                  .V4      V P                  RV P                  V P                  V P                  V P                  V P                  .V4      V P                  RV P                  V P                  V P                  V P                  .V4      V P                  RV P                  V P                  V P                  V P                   V P"                  V P                  V P$                  V P&                  V P(                  .	V4      R7      pV P*                  ^8  d"   V P,                  '       d   V P,                  VR&   V# )z
Return environment dict.

Parameters
----------
exists: bool
    It True, only return existing paths.

Return
------
dict
    environment
r   r   r   rL   )r   r   r   rL   r   )r   _build_pathsr   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   rl   r   )r$   r   Zenvr=   r   
return_envZEnvironmentInfo.return_env  sU    %%OOOO%%))	 	 !!$$$$LL&&** 
 %%!!4<<1A1A4>>R
 ""LLLLJJMMMMLLLL))KK
 7*
V ;;"!5!5!5)-)=)=C%&
r   c                s
   \         P                  P                  V4      p\        P                  ! VR4      P                  \        P                  4      p\         P                  ! WE4      pV'       d.   \        \        \        P                  P                  V4      4      MTpV'       g3   VP                  4        R2p\        P                  P                  V4      h\!        V4      p	\        P                  P#                  V	4      # )a  
Given an environment variable name and specified paths,
return a pathsep-separated string of paths containing
unique, extant, directories from those paths and from
the environment variable. Raise an error if no paths
are resolved.

Parameters
----------
name: str
    Environment variable name
spec_path_lists: list of str
    Paths
exists: bool
    It True, only return existing paths.

Return
------
str
    Pathsep-separated paths
r   z environment variable is empty)ru   ZchainZfrom_iterabler   rA   r   rK   Zpathsepr   r   rL   r   r   rp   rq   rr   r   rM   )
r$   r_   Zspec_path_listsr   Z
spec_pathsZ	env_pathsr   Zextant_pathsr   Zunique_pathss
   &&&&      r   r   ZEnvironmentInfo._build_paths  s    . __22?C
KKb)//

;	
6=CtF277==%89ZZ\N"@AC""99#>>&|4zz|,,r   )rG   rh   r   )Ni    )T)#r
   r   r   r   r@   r&   rB   rl   rm   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r	   r   r   r   r   {  s   .? 	 	 	 	 L L& 
 
 L L( M M 0 0d C C&  2 % %N 	' 	'!3F 
3 
3 > >  < L L B B 	F 	F  6 M M B B" C C 
3 
3 * *  C  CD;z-r   r   )__conditional_annotations__r@   Z
__future__r    rw   ru   r|   rK   Zos.pathZplatformZtypingr   r   Zmore_itertoolsr   Zdistutils.errorsrp   Ztyping_extensionsr   r   Zsystemr   r   Zdictr   r   rC   rd   r   r   )r   s   @r   <module>r      s    #    	   + * < *i7! ! #fG^$v
 v
rz zzQ/ Q/h1y 1E
- E
-r   