Aj:@ ddlZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlZddlmZddlmZddlmZddl mZddlmZddlmZ ddlZejn##e$rZeee ddZ[wwxYwdd l!m"Z"dd l!m#Z#dd l!m$Z$dd l!m%Z%dd l!m&Z&ddl!m'Z'ddl!m(Z(ddl!m)Z)ddl!m*Z*ddl!m+Z+ddl,m-Z-ddl.m/Z/ddl.m0Z0ddl1m2Z2ddl3m4Z4 ddl5m6Z6n#e7$rGdde8Z6YnwxYwdZ9dZ:dZ;dZ?d d!Z@d"ZAe jBd#ZCd$ZDe jEFd%pd&ZGd'ZHdZId(ZJe jEFd)ZKe jEFd)ZLd*ZMe jEFd+d,ZNd-ZOejPjQd.ejPjRZSd/ZTGd0d1ZUeUZVd2eWd3eWd4dfd5ZXd2eWd3eWd4dfd6ZYdd2eWd7e(e"eWd3eWd4dfd8ZZd9eWd4dfd:Z[e j\d;e j]Z^dZad?Zbd@ZcdAZddBZedCZfdDZgGdEdFZhdGeWd4eWfdHZieie^ZjdIZkdJZldKZmdLZnenemdMZo ddNe'eWdOe(eWdPe(e'eWd4epfdQZqdRe'eWd4e'eWfdSZrdPe'eWd4e%eWeWffdTZsddVeWdWetd4e*eteWffdXZudYetdWetdZetd4dfd[Zvd\eWd4dfd]ZwdVeWd^eWd4dfd_Zxd`eWd4e*e(eWeWffdaZy dd`eWdVeWdbe(e$etetetgdfdce(epdde(ed4e*eWe4ff deZzd`eWd^eWd4e+de{ffdfZ|dgeWdheWd4dfdiZ}d\eWdjetd4dfdkZ~GdldmeZGdndoeZGdpdqeZGdrdseZejGdtdueZedvgdwZGdxdyeZGdzd{eZGd|d}ZGd~dZGddZd4e%eWeffdZdZde(e%eWeffdZd4e*eWeWffdZd4eWfdZd4e*eWeWeWeWffdZde'eWd4e'eWfdZde'eWdede'eWd4e'eWfdZdeWd4e'eWfdZdedeWd4e'eWfdZdeWd4eWfdZdedeWd4e'eWfdZd4e'eWfdZdede%eWefd4e%eWeffdZd3e'eWde%eWe#fd4eWfdZd3e'eWd4dfdZd3e'eWd4e*eWeWffdZd3e'eWd4e*eWeWffdZd4eWfdZdZdZdZdZdedeWdeWdeWd4e*eeff dZdedeWd4dfdZdedeWdeWdeWd4df dZdedeWd3ejdeWdeWd4e*eeeff dZdeWdeWd4dfdZd3e#d4dfdZdeMfd3e#deWd4eWfdZd3e#deWd4eWfdZdeWd4eWfdZ ddeWde'eWde'eWded4e*e'eWe%eWefff dZdZdZd4e(eWfdZdeWd4e'eWfdZddeWded4eWfdZd\eWd4dfdZdZd„ZGdÄdĦZGdńdeZGdDŽdȦZd3e#d4dfdɄZdʄZd3e#d4dfd˄Zd̄Zd̈́Zd3e#d4dfd΄Zd3e#d4dfdτZde'eWd4dfdфZedkr9de jEvreXdԦe deejdddSdS)N) OrderedDict) namedtuple) JSONEncoder) SSLContext)TarFile)ZipFile)IO)Any)Callable)Dict)Iterator)List)Optional)Set)Tuple)Union)ContentTooShortError)urljoin)urlparse)urlopen) addinfourl) WindowsErrorceZdZdS)rN)__name__ __module__ __qualname__C/home/lighthouse/esp32-dev/.cache/esp-idf-v5.5.4/tools/idf_tools.pyrrWs rrztools/tools.jsonztools/tools_schema.jsonztools/tools.new.jsonz idf-env.json~z .espressifunknownz \${TOOL_PATH}z\1IDF_MAINTAINERFTODO,IDF_TOOLS_INSTALL_CMDz#https://dl.espressif.com/dl/esp-idfIDF_PIP_WHEELS_URLzhttps://dl.espressif.com/pypizidf{}_py{}_env.zidf_version.txtceZdZUdZdZeded<ddgZgdZde de d dffd Z dd Z d e d e fd Z d e de d dffd ZxZS)GlobalVarsStorez Pythonic way how to handle global variables. One global instance of this class is initialized and used as an entrypoint (store) It handles string and boolean properties. N _instancequietnon_interactive)idf_pathidf_tools_path tools_jsonargskwargsreturnc|jsBtt|j|g|Ri||_|j|jSN)r,superr+__new___initialize_properties)clsr2r3 __class__s r r8zGlobalVarsStore.__new__|sW} 3?E/377?UdUUUfUUCM M 0 0 2 2 2}rc~|jD]}t|d|d|jD]}t|d|ddS)N_F)_bool_propertiessetattr_string_properties)selfprops r r9z&GlobalVarsStore._initialize_propertiessf) - -D D*d**e , , , ,+ , ,D D*d**d + + + + , ,rnamec||j|jzvr3t|d|}|||jvrtd|d|St |d)Nr=z Variable z accessed before initialization.z is not a valid attribute)r>r@getattrReferenceErrorAttributeError)rArCvalues r __getattr__zGlobalVarsStore.__getattr__su 4(4+BB B B&-dJJJ&?&?E})@!@!@$%W%W%W%WXXXL???@@@rrHc||j|jzvr'td||dSt||dS)Nr=)r>r@r7 __setattr__)rArCrHr;s r rKzGlobalVarsStore.__setattr__s_ 4(4+BB B B GG   D E 2 2 2 2 2 GG  e , , , , ,rr4N)rrr__doc__r,r__annotations__r>r@r r8r9strrIrK __classcell__)r;s@r r+r+qs .2Ix)*111!23EEEC33D ,,,,AAAAAA--C-D----------rr+textr2r4cXtjstjjd|dg|RdSdS)z- Writes ERROR: + text to sys.stderr. zERROR:  Ngr-sysstderrwriterQr2s r fatalrZsE 74 +4+++3d33333344rcXtjstjjd|dg|RdSdS)z/ Writes WARNING: + text to sys.stderr. z WARNING: rSNrTrYs r warnr\sE 76 -T---555555566rfc`tjs!| tj}|j|dg|RdSdS)zQ Writes text to a stream specified by second arg, sys.stdout by default. NrS)rUr-rVstdoutrX)rQr]r2s r infor`sJ 7$ 9 A4 #d######$$rerrc"tdd|vrZtdtdtjdkrtdtdtjdtjd krtd d Sd S) z] Prints hint on download error. Tries to specify the message depending on the error. z8Please make sure you have a working Internet connection. CERTIFICATEz[Certificate issues are usually caused by an outdated certificate database on your computer.zNPlease check the documentation of your operating system for how to upgrade it.darwinzJRunning "./Install\ Certificates.command" might be able to fix this issue.z Running "zM -m pip install --upgrade certifi" can also resolve this issue in some cases.win32zBy downloading and using the offline installer from https://dl.espressif.com/dl/esp-idf you might be able to work around this issue.N)r`rVplatform executable)ras r print_hints_on_download_errorrhs CDDD jkkk ]^^^ <8 # # ^ _ _ _ v v v vwww |w  ;     r-rewin64macosz macos-arm64z linux-i686z linux-amd64z linux-armelz linux-armhfz linux-arm64c eZdZdZieedededeeededededeeed ed ed ed eeed edeideeededededee e de de de de de e e de de de de e e de e e de de d e iZ d!gZed"eed#eefd$Zed%eed#efd&Zed'ed#efd(Zd)S)* Platformsz Mappings from various other names these platforms are known as, to the identifiers above. This includes strings produced from "platform.system() + '-' + platform.machine()", see PYTHON_PLATFORM definition above. z Windows-i686z Windows-x86zi686-w64-mingw32zWindows-x86_64z Windows-AMD64zx86_64-w64-mingw32z Windows-ARM64osxrdz Darwin-x86_64zx86_64-apple-darwinz Darwin-arm64zaarch64-apple-darwinzarm64-apple-darwinlinux64z Linux-x86_64z FreeBSD-amd64zx86_64-linux-gnulinux32z Linux-i686z FreeBSD-i386zi586-linux-gnuzi686-linux-gnuz Linux-arm64z Linux-aarch64z Linux-armv8laarch64zarm-linux-gnueabihfzarm-linux-gnueabiz Linux-armv7lz Linux-armz Linux-armv6lsupposed_platformr4c|tttfvr|Sttjd5}t |dtj t dtj kr|cdddS| dt |dtj }|dkrt}ng|dkra| d t |dtj }|d zrt}nt}dddn #1swxYwY|S) aR We probe the python binary to check exactly what environment the script is running in. ARM platform may run on armhf hardware but having armel installed packages. To avoid possible armel/armhf libraries mixing need to define user's packages architecture to use the same See note section in https://gcc.gnu.org/onlinedocs/gcc/ARM-Options.html#index-mfloat-abi ARM platform may run on aarch64 hardware but having armhf installed packages (it happens if a docker container is running on arm64 hardware, but using an armhf image). rbsELFN($i) PLATFORM_LINUX_ARM32PLATFORM_LINUX_ARMHFPLATFORM_LINUX_ARM64openrVrgint from_bytesread byteorderseek)rrr] e_machinee_flagss r detect_linux_arm_platformz#Platforms.detect_linux_arm_platforms %9;OQe$f f f$ $#.$ ' ' =1~~affQii773>>*VYVc;d;ddd(  = = = = = = = = FF2JJJqvvayy#-@@IC$8!!br ..CMBBU?=(<%%(<% = = = = = = = = = = = = = = ="! sA!E/!CE//E36E3platform_aliascP|std|tjvrtd|d|dkrtrt}tj|d}t jdkrt|}|std|d|S) zN Get a proper platform name based on PLATFORM_FROM_NAME dict. z(System platform could not be identified.z Platform 'z' is not supported by ESP-IDF.anyNlinuxzSupport for platform 'z' hasn't been added yet.) ValueErrorrmUNSUPPORTED_PLATFORMSCURRENT_PLATFORMPLATFORM_FROM_NAMEgetrVrfr)r platform_names r rz Platforms.get<s  IGHH H Y< < <X.XXXYY Y U " "'7 "-N!488NN <7 " "%?? NNM `^n^^^__ _r file_namecd}tjD](}||vr"t|t|kr|})t|S)zB Guess the right platform based on the file name. )rmrlenr)r found_aliasrs r get_by_filenamezPlatforms.get_by_filenameRsX  ': - -N**s;/?/?#nBUBU/U/U, }}[)))rN)rrrrMPLATFORM_WIN32PLATFORM_WIN64PLATFORM_MACOSPLATFORM_MACOS_ARM64PLATFORM_LINUX64PLATFORM_LINUX32r}r|r{rr staticmethodrrOrrrrrr rmrms,, , ~ , N ,  , ., , n, , , ~, ., , ~!," 2#,$ ,%,&  4',,( 2),, *-,. #/,0 (1,2 )3,4 ,5,6 *7,8 #9,: &;,< (=,> *?,@ *A,B 2C,D +E,F -G,H ,I,J 'K,,L 2321,)W,,^,,!!Xc]!!xPS}!!!!!!\!!FHSMc\* *3 *3 * * *\ * * *rrm platform_strc t|}n=#t$r0}tt |t dd}~wwxYw|S)z Parses platform from input string and checks whether it is a valid platform. If not, raises SystemExit exception with error message. r N)rmrrrZrO SystemExit)rrfes r parse_platform_argr_s] ==..  c!ff mm Os A+AAshellz key-valuea; -----BEGIN CERTIFICATE----- MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG 9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97 nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt 43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4 gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg 06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4= -----END CERTIFICATE----- a -----BEGIN CERTIFICATE----- MIIDjjCCAnagAwIBAgIQAzrx5qcRqaC7KGSxHQn65TANBgkqhkiG9w0BAQsFADBh MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBH MjAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVT MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEcyMIIBIjANBgkqhkiG 9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuzfNNNx7a8myaJCtSnX/RrohCgiN9RlUyfuI 2/Ou8jqJkTx65qsGGmvPrC3oXgkkRLpimn7Wo6h+4FR1IAWsULecYxpsMNzaHxmx 1x7e/dfgy5SDN67sH0NO3Xss0r0upS/kqbitOtSZpLYl6ZtrAGCSYP9PIUkY92eQ q2EGnI/yuum06ZIya7XzV+hdG82MHauVBJVJ8zUtluNJbd134/tJS7SsVQepj5Wz tCO7TG1F8PapspUwtP1MVYwnSlcUfIKdzXOS0xZKBgyMUNGPHgm+F6HmIcr9g+UQ vIOlCsRnKPZzFBQ9RnbDhxSJITRNrw9FDKZJobq7nMWxM4MphQIDAQABo0IwQDAP BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUTiJUIBiV 5uNu5g/6+rkS7QYXjzkwDQYJKoZIhvcNAQELBQADggEBAGBnKJRvDkhj6zHd6mcY 1Yl9PMWLSn/pvtsrF9+wX3N3KjITOYFnQoQj8kVnNeyIv/iPsGEMNKSuIEyExtv4 NeF22d+mQrvHRAiGfzZ0JFrabA0UWTW98kndth/Jsw1HKj2ZL7tcu7XUIOGZX1NG Fdtom/DzMNU+MeKNhJ7jitralj41E6Vf8PlwUHBHQRFXGU7Aj64GxJUTFy8bJZ91 8rGOmaFvE7FBcf6IKshPECBV1/MUReXgRPTqh5Uykw7+U0b6LJ3/iyK5S9kJRaTe pLiaWN0bfVKfjllDiIGknibVb63dDcY3fe0Dkhvld1927jyNxF1WW6LZZm6zNTfl MrY= -----END CERTIFICATE----- )zdl.espressif.comz github.comcmd input_text extra_pathsc8|rd}dg}tjdkr|d|D]\}|D]S}tj||d|z}tj|r ||d<d}nT|rn] d}|r|}tj |tj tj d|} | j | j zS#ttf$rtj|tj tj tj } | |\} } | jdkrF tj| j|| | #t$rtj| j|| wxYw| | zcYSwxYw) a$ Runs command and checks output for exceptions. If AttributeError or TypeError occurs, function re-runs the process. If return code was not 0, subprocess.CalledProcessError is raised, otherwise, the original error is masked. Returns both stdout and stderr of the run command. Frrez.exerTN)r_rWcheckinput)r_stdinrW)rVrfappendospathjoinexistsencode subprocessrunPIPEr_rWrG TypeErrorPopen communicate returncodeCalledProcessError) rrrfound extensionsrextfullpath input_bytesresultpr_rWs r run_cmd_check_outputrs T <7 " "   f % % %  D!  7<<c!fsl;;7>>(++%CF EE    .$++--KJOJO[_grsss}v},, I &  S XbXg h h h{33 <1   O 3AL#vvVVV O O O 3AL#vNNN Os& AC!!A*F E((&FFF paths_listc>tjdkr d|D}|S)zL Converts / (linux) to \ (Windows) if called under win32 platform. recg|]<}tjj|vr%|dtjjn|=S)/)rrsepreplace).0rs r z+to_shell_specific_paths..s>aaaQRRW[A5E5EaiiRW[1111aaarrVrf)rs r to_shell_specific_pathsrs+ |waaV`aaa rctj}tj|tjz|dz}||d<|S)z Return a copy of environment variables dict, prepending paths listed in extra_paths to the PATH environment variable. PATH)renvironcopypathsepr)renv_argnew_paths r get_env_for_extra_pathsrsF jooGz{++bj876?JHGFO Nrfilename block_sizec*tj}d}t|d5tfddD])}|||t |z }* dddn #1swxYwY||fS)z( Gets file size and its sha256. rrtc.Sr6)r)rr]sr z&get_file_size_sha256..s!&&"4"4rrN)hashlibsha256r~iterupdater hexdigest)rrrsizeblockr]s ` @r get_file_size_sha256rs^  F D h  44444c::  E MM% CJJ DD  !!## ##s?A44A8;A8count total_sizect||zdz|z }td|}tjd|ztjdS)zL Prints progress (count * block_size * 100 / total_size) to stdout. dz %d%%N)rminrVr_rXflush)rrrpercents r report_progressrsd%*$s*Z788G#wGJX'(((Jrrc tj|dS#t$r@}|jtjkstj|sYd}~dSd}~wwxYw)zz Makes directory in given path. Suppresses error when directory is already created or path is a path to file. N)rmakedirsOSErrorerrnoEEXISTrisdir)rexcs r mkdir_prsu  D  9 $ $BGMM$,?,? $  % $ $ $ $ $s A"5AA" destinationctd|d||drtj|d}n|drtj|d}n_|drtj|d}n4|d rt |}nt d t |tjr0tj d d d kr| |dn| |tj dkr|d rt |tr| D]n}tj||j}|jdz dz}tj|rtj||id Sd Sd Sd S)zU Extracts file specified by filename into destination depending on its type. z Extracting  to ).tar.gzz.tgzzr:gz.tar.xzzr:xzz.tar.bz2zr:bz2zipzUnsupported archive typeNrw)r! tar)filterrei)r`endswithtarfiler~rNotImplementedError isinstancerrV version_info extractallrfinfolistrrrr external_attrrchmod)rr archive_obj file_infoextracted_fileextracted_permissionss r unpackr s 2x 2 2[ 2 2333,-- >/6|Hf/M/M   I ' '>l8V44   J ( (>l8W55   5 ! !>h'' !"<===+w//,C4DRaR4HG4S4S{59999{+++ |w8#4#4U#;#; ;X_@`@`$--// @ @IW\\+y7IJJN$-$;r$AE$I !w~~n-- @)>???  @ @rurlctjd|tj}|r-|\}}||fSd|fS)zI Splits given url into its type (e.g. https, file) and the rest. z ([^/:]+):(.*)N)rematchDOTALLgroupslower)r r schemedatas r splittyper.sO H_c29 5 5E $||~~ ||~~t## 9r reporthookrcontextct|\}}i}|r||d<tjt||fi|5}|} |dkr/|s-t j|| fcdddSt|d} | 5|| f} d} t| dd} d}d}|r ||| |  | | }|sn<|t|z }| ||d z }|r ||| | T dddn #1swxYwYdddn #1swxYwY| dkr|| krtd || fz| | S) zu Retrieve data from given URL. An alternative version of urlretrieve which takes SSL context as an argument. rfileNwbi zcontent-lengthrTr z1retrieval incomplete: got only %i out of %i bytes)r contextlibclosingrr`rrnormpathr~rrrrrXr)r rrrrurl_typerextra_urlopen_argsfpheaderstfprbsrrblocknumrs r urlretrieve_ctxr#9sfs^^NHd0(/9%  GCDD1CDD E E3'')) v  h 7##D))72 333333338T""  3 3w&FBw{{#3R8899DDH / 8R... 3 E " %   A 3JxT222 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3333333333333333> qyyTD[["#VZ^`dYe#egmnnn Ms<=EEBD7+ E7D; ;E>D; ?EEEcltd|td| tD]4\}}||vr+tj}||n5d}t ||tjstnd|tj d tj dS#t$r*}|cYd}~tj Sd}~wwxYw#tj wxYw)zB Download from given url and save into given destination. Downloading z Destination: )cadataN)rz Done )r` DL_CERT_DICTitemssslcreate_default_contextload_verify_locationsr#rUr.rrVr_rXr Exception)r rsitecertctxrs r downloadr0nsS    & & &'''&,,..  JD$s{{022)))666 C[AR*\//X\fijjjj $$$     s0BC D&D 'D(D DD D3 path_frompath_tocVtjdrdnd}t|D]u} t j||dS#t $rNd|d|d}||dz krt|dt|d tj d YrwxYwdS) aD Sometimes renaming a directory on Windows (randomly?) causes a PermissionError. This is confirmed to be a workaround: https://github.com/espressif/esp-idf/issues/3819#issuecomment-515167118 https://github.com/espressif/esp-idf/issues/4063#issuecomment-531490140 https://stackoverflow.com/a/43046729 winr NzRename rz failedz[. Antivirus software might be causing this. Disabling it temporarily could solve the issue.z , retrying...g?) rVrf startswithrangerrenamerrZr\timesleep)r1r2 retry_countretrymsgs r rename_with_retryr>s //66=""AK{##    Ii ) ) ) FF   ;I;;7;;;C a''www C&&& ' ' ' JsOOOOO   sAAB&%B&levelsc*|dksJ|d}tj|rtj|t ||tj||}t|D]}tj|}t|dkrtd|d|tj ||d}tj |std|d|ddtj|}|D]R}tj ||}tj ||}t ||Stj|dS) z The number of top directory levels specified by levels argument will be removed when extracting. E.g. if levels=2, archive path a/b/c/d.txt will be extracted as c/d.txt. r.tmpr z at level z, expected 1 entry, got , z is not a directoryN) rrrshutilrmtreer>mkdirr7listdirr RuntimeErrorrr) rr?tmp_path base_pathlevelcontentsrC move_frommove_tos r do_strip_container_dirsrNs A::::}}}H w~~h  hdH%%%HTNNNIvVV:i(( x==1  T5TT(TTUU UGLLHQK88 w}}Y'' VT5TTHQKTTTUU U Vz)$$H..GLLD11 ',,tT**)W---- M(rceZdZdZdS)ToolNotFoundErrorzK Raise when the tool is not found (not present in the paths etc.). NrrrrMrrr rPrP DrrPceZdZdZdS) ToolExecErrorzA Raise when the tool returns with a non-zero exit code. NrQrrr rTrTrRrrTceZdZdZdS)ToolBinaryErrorzN " Raise when an error occurred when running any version of the tool. NrQrrr rVrVrRrrVc 2eZdZdZdedededededdf d ZdS) IDFToolDownloadzT Structure to store all the relevant information about particular download. rr rr rename_distr4NcL||_||_||_||_||_dSr6)rr rrrYrArr rrrYs r __init__zIDFToolDownload.__init__s-*  &r)rrrrMrOrr\rrr rXrXs^'c''3''Z]'bf''''''rrXc eZdZdZdZdZdZeeegZdededdfd Z d dde fd Z d e de fd Z ddedededededdf dZdeedeefdZefdeede fdZdeefdZdS)IDFToolVersionz Used for storing information about version; status (recommended, supported, deprecated) and easy way of comparing different versions. Also allows platform compatibility check and getting right download for given platform, if available. recommended supported deprecatedversionstatusr4NcV||_||_t|_d|_dSNF)rbrcr downloadslatest)rArbrcs r r\zIDFToolVersion.__init__s&  %( (tsAA AAc0||duS)zT Check whether this version is compatible with given platform name. N)rurts r compatible_with_platformz'IDFToolVersion.compatible_with_platforms--m<&&(()))rr)rrrrMrjSTATUS_SUPPORTEDSTATUS_DEPRECATED STATUS_VALUESrOr\boolrlobjectrorrqrrXruPYTHON_PLATFORMrwrr{rrr r^r^s '"$')9;LMMST 0,00000MFMtMMMM gg#gCgsgCg^agkogggg x} RaIb    GVIIhsmIZ^IIII *S******rr^IDFToolOptions) version_cmd version_regexversion_regex_replace is_executabletool_info_file export_paths export_varsinstallinfo_urllicensestrip_container_dirssupported_targetsceZdZdZdZdZdZ d;d ed ed ed ed edeededeede ede de deddfdZ deddfdZ dIDFToolz Used to store info about IDF tools from tools.json file in a Python-accesible form. The term "IDF tool" is used for e.g. CMake, ninja, QUEMU and toolchains. always on_requestneverNrTrrC descriptionrrlicrrrrrrrr4c 8||_||_|d|_g|_| t } t ||| | | gt|||| | |_g|_ t|_ | | |_ | |_dSr6)rCr drop_versionsversion_in_pathversions_installedVERSION_REGEX_REPLACE_DEFAULTrroptionsplatform_overridesr _platform_update_current_optionsrr) rArCrrrrrrrrrrrs r r\zIDFTool.__init__Gs & .2-/ ($A !%   !    MM        9;) $$&&&*,rrfcdtj|}||_||S)zg Copy the IDFTool record in respect to given platform (e.g. apply platform overrides). )rdeepcopyrr)rArfrs r copy_for_platformzIDFTool.copy_for_platformqs2t$$#&&((( rct|j|_|jD]G}|jr|j|dvr|}|d=|jjdi||_HdS)zc Update current options by platform overrides, if applicable for current platform. platformsNr)rr_current_optionsrrr_replace)rAoverride override_dicts r rzIDFTool._update_current_optionszs!/ =/ T TH~ $.8M"M"M$MMOOMk*$BD$9$B$S$S]$S$SD ! !  T Trc,t|_dS)z1 Clear self.versions dictionary. N)rversionsrzs r rzIDFTool.drop_versionss4?== rrbcTt|tusJ||j|j<dS)z6 Add new IDFVersion to self.versions. N)typer^rrbrArbs r add_versionzIDFTool.add_versions/G}}....)0 go&&&rcbtjtjd|jS)z; Returns path where the tool is installed. tools)rrrrUr0rCrzs r get_pathzIDFTool.get_paths!w||A,gtyAAArc|||jvsJtj||S)z= Returns path for the tool of given version. )rrrrrrs r get_path_for_versionzIDFTool.get_path_for_versions5$-''''w||DMMOOW555rc^||fd|jjDS)zC Returns a list of paths that need to be exported. c>g|]}tjjg|RSrrrr)rr tool_paths r rz,IDFTool.get_export_paths..s-XXX Y++++XXXr)rrr)rArbrs @r get_export_pathszIDFTool.get_export_pathss8--g66 XXXXT5J5WXXXXrci}|jjD]\}}||dd}t jt||}||krt|gd}tj |}tj dks|||kr|||<|S)z Get the dictionary of environment variables to be exported, for the given version. Expands: - ${TOOL_PATH} => the actual path where the version is installed. \\\rre)rrr(rrr subSUBST_TOOL_PATH_REGEXrrrrrVrf)rArbrkv replace_pathv_replold_vs r get_export_varszIDFTool.get_export_varss )5;;== # #DAq44W==EEdFSSLV1<CCF{{0&::1=JNN1%%E|w&&%-5F??"q  rver_strctj|jj|}|stStj|jj|jj|dS)z Extract the version string from the provided input and return it as a result. Returns 'unknown' if version string can not be extracted.. r)r searchrrUNKNOWN_VERSIONrrgroup)rArr s r parse_tool_versionzIDFTool.parse_tool_versionsY  $/=wGG #" "vd+94;P;fhmhshstuhvhvwwwrrexecutable_pathc |jtksJ|jj}|r||d<|dst d|jd t |d|}nr#t$r}t d|jd|d}~wtj $r9}td|j d|j dd d}~wwxYw|| dS) a Execute the tool, optionally prepending extra_paths to PATH, extract the version string and return it as a result. Raises ToolNotFoundError if the tool is not found (not present in the paths). Raises ToolExecError if the tool returns with a non-zero exit code. Returns 'unknown' if tool returns something from which version string can not be extracted. rTool z not foundNz not found with error: znon-zero exit code (z) with message: utf-8ignore)errors)rrrrrPrCrrrrrTrrWdecoder)rArrrversion_cmd_resultrs r get_versionzIDFTool.get_versions5~!11111#/  %$CF1v C$$ADI$A$A$ABB B !5c4!M!M   S S S#$QDI$Q$Qa$Q$QRR R,   pq|ppQX__U\em_EnEnpp   &&'9'@'@'I'IJJJs$A C#A==C4CCc|jtksJtjj|jd}tj|||}tj|std|j dt|dd5} tj |}n2#tjtf$rtd|j dwxYw dddn #1swxYwYd |vrtd|j d ||d S) z Extract the version string from tool info file and return it as a result. Returns 'unknown' if version string can not be extracted. rrz not found: No info file.rrencodingz not found: Bad info file.Nrbz$ not found: No version in info file.)rrrrrrsplitrrrPrCr~jsonloadJSONDecodeErrorUnicodeDecodeErrorr)rArbinfo_file_pathr] tool_infos r get_version_from_filezIDFTool.get_version_from_files ~!11111t':'@'@'E'EFd&?&?&H&H.YYw~~n-- R#$PDI$P$P$PQQ Q .# 8 8 8 WA W IaLL (*<= W W W'(U (U(U(UVVV W W W W W W W W W W W W W W W W I % %#$[DI$[$[$[\\ \&&y';<<z:IDFTool.is_supported_for_any_of_targets..#s'AAt47?AAAAAArall)rr)rArrs ` r is_supported_for_any_of_targetsz'IDFTool.is_supported_for_any_of_targetssJ!6688AAAA/@AAAAAaEV[`ZaEaarcbtd|jDS)zZ Checks whether this tool (any version) is compatible with the platform. c6g|]}|Srrw)rrs r rz4IDFTool.compatible_with_platform..)s$QQQQA..00QQQr)rrvaluesrzs r rwz IDFTool.compatible_with_platform%s/QQ$-:N:N:P:PQQQRRRrct}|jD])}||*|S)za Return set of platforms that are supported by at least one version of the tool. )ryrrrr{)rArrs r r{zIDFTool.get_supported_platforms+sP%%'' 7 7A MM!3355 6 6 6 6 rcfdjD}t|dksJ|r|dSdS)zz Get all recommended versions of the tool. If more versions are recommended, highest version is returned. cxg|]6\}}|jtjk|j4|7Sr)rcr^rjrwr)rrrrAs r rz3IDFTool.get_recommended_version..8sN   1x><<<A[A[\`\jAkAk< <<.Ps[( ( ( }Q&.*III a 99$.IIJ IIIrcj|Sr6)r)xrAs r rz9IDFTool.get_preferred_installed_version..Ws a8HrTkeyreverserzUsing supported version r for tool  zas recommended version z is not installed.N)find_installed_versionsrVrrsortedr\rrC)rAsupported_installed_versions#sorted_supported_installed_versionss` r get_preferred_installed_versionz'IDFTool.get_preferred_installed_versionBs?    ( ( * * * *    D   ' ' ) )T-D D D//11 1( ( ( ( ,( ( ( $ /5 (.H.H.H.HRV/ / / + / : q3VWX3Yqqeienqqqd$2N2N2P2Pddd   7q9 9ts  %%c |jtksJd}|js[ |}||_n>#t $rYn2t $r&}td|jd|d}Yd}~nd}~wwxYwg|_ |j D][\}}| s| |}tj|sP|js|j |r |jr||}n(|||}||krt+d|jd|d||j |#t $r(}t+d|jd|d |Yd}~#d}~wt $r*}td|jd|d |d}Yd}~Ud}~wwxYw|rt,dS) a  Checks whether the tool can be found in PATH and in GlobalVarsStore.idf_tools_path. Writes results to self.version_in_path and self.versions_installed. Raises ToolBinaryError if an error occurred when running any version of the tool. Frz# is found in PATH, but has failed: TNrz( is installed, but has reported version zdirectory for tool z. is present, but the tool has not been found: z" is installed, but cannot be run: )rrrrrrPrTrZrCrrr(rwrrrrrrrrr\rV)rA tool_errorrrrb version_objrs r rzIDFTool.find_installed_versionses~!11111 " / /**,,(/$$%     " " "OdiOOAOOPPP!  "#%$(M$7$7$9$9 8 8 G[7799 11'::I7>>),, % '..w777 8&O"88AAGG"..t/D/DW/M/MNNGg%%oooWoofmooppp'..w7777%   x$)xxgxxuvxx! " " "`di``'``]^``aaa!  "  "! ! " "s@9 A4 A4A//A4 AF  G1F:: G1G,,G1c|tjsdStj}fd|D}t |dD]pfd|jjD} |jr| }n| |}n#ttf$rYbwxYw|krmcSdS)zt Get the latest installed tool version by directly checking the tool's version directories. Ncg|]A}tjtj|?|BSr)rrrr)rdrs r rz4IDFTool.latest_installed_version..s<QQQarw}}RW\\)Q5O5O'P'PQQQQrT)rc@g|]}tjjg|RSrr)rrrrbs r rz4IDFTool.latest_installed_version..s/fffaRW\)W9q999fffr) rrrrrFrrrrrrrPrT)rAdentriesdirspathsrrrbs @@r latest_installed_versionz IDFTool.latest_installed_versions MMOO w~~i(( 4:i((QQQQ8QQQdD111  Ggffff4CXCefffE &6"88AAGG"..u55G%}5    '!!NNNts2B::C Cct||jvsJ|j||j}|s/td|jd|jdt d|j}|jr|jntj |}tj tj d|}ttj |tj |rS|||s(t%d|dtj|nt)d|d d Sd }|d }t+t,D]}t/||} tj |r|||s(t%d | t%d|d|ot1||d}|s:tdt3t5| t dd S)zT Download archive of the tool for platform given by self._platform. zNo packages for tool z platform !r distzremoving downloaded file z and downloading againzfile z is already downloadedNFrADownload failure: Failed to download rT/Failed to download, and retry count has expired)rrurrZrCrr rYrrbasenamerrUr0rdirnameisfilecheck_download_filer\unlinkr`r7DOWNLOAD_RETRY_COUNTr0r>rhrO) rArb download_objr  archive_name local_path downloadedlocal_temp_pathr<ras r r0zIDFTool.downloadsH$-''''}W-GGWW  P$)PPt~PPP Q Q QQ-- 3?3Kf|//QSQXQaQabeQfQf W\\!"2FLII  ++,,, 7>>* % % ++L*EE UUUUVVV *%%%%A\AAABBB '---/00  E300C7>>/22 $:R:RS_ap:q:q /#//000E3EEOEEFFF oz : : :J  C D D D )#c(( 3 3 3Q--   rc6||jvsJ|j||j}|J|jr|jn#tj|j}tjtj d|}tj |sJ| |}tj |r#tdtj|t#|t%|||jjrt+||jj||s5t/d|tj|t1ddS)z Unpack archive to destination directory and remove given number of top-level folder if specified. Should always be called after IDFTool.download(). Nrz)destination path already exists, removingz=Failed to check the tool while installed. Removing directory r )rrurrYrrrr rrUr0rrrr\rCrDrrrrrNrrZr)rArbrr  archive_pathdest_dirs r rzIDFTool.installs}$-''''}W-GGWW '''3?3Ks|//QSQXQaQabnbrQsQs w||A$4flKK w~~l+++++,,W55 7>>( # # $ < = = = M( # # #|X&&&  5 Z #Hd.C.X Y Y Y&&w// \RZ\\ ] ] ] M( # # #Q--   rrr!c|j}|j}t|\}}||krtd|d|d|dS||krtd|d|d|dSdS)zX Compare the computed sha256 to sha256 specified by downloaded archive. zfile size mismatch for z , expected z, got Fzhash mismatch for T)rrrr\)rr!expected_sha256 expected_size file_size file_sha256s r rzIDFTool.check_download_files '-$) !5j!A!A ;  % % b:bb-bbW`bb c c c5 / ) ) ajaa_aaT_aa b b b5tr tool_dictc|d}t|tstd|d}t|tstd|dd}t|tstd|d|d d }t|tstd |d |d }t |t urtd|d|d}t|tr|s|rtd|d|d}|r(t|tstd|d |d} t | t urtd|d|di} t | turtd|d|d} t | t urtd|d|dd} t| tstd |d |d!d} t| tstd"|d |d#d}t|tstd$|d |d%d&}|r)t |turtd'|d(|d)g}t |t urtd*|d|d+}t|t std,|d|||| | |||||||| }| D]!}|j j |"| D]\}}||j j |<t|D]\}}|d-}t |t urtd.||fz|d} | )t| tstd0||fz|d }|*t |t urtd1||fz|d}|+t|tr|std2||fz|d}|)t|tstd3||fz|d} | *t | t urtd4||fz|d} | *t | turtd5||fz|j |i}| D]}|d}t|tstd6|d |d7}t|ts*|t jvrtd8||t jt!||}| D]\}}|d9vr t$|n&#t&$rtd:|d;|d<|wxYw|||d=|d>|d?|d@d |t jkr$||vrg||<|| |||| D]w\}} t/| dAkr&tdB|dC|dDt/|dE| t0jkr)t/|d&krtdF|dC|dGx||S)HzC Create IDFTool class instance form its JSON dump. rCztool_name is not a stringrzdescription is not a stringrTzis_executable for tool z is not a boolrrztool_info_file for tool z is not a stringrzversion_cmd for tool z is not a list of stringsrzversion_regex for tool z is not a non-empty stringrzversion_regex_replace for tool rzexport_paths for tool z is not a listrzexport_vars for tool z is not a mappingrzversions for tool z is not an arrayrFzinstall for tool rzinfo_url for tool rzlicense for tool rrzstrip_container_dirs for tool z is not an intrzplatform_overrides for tool rzsupported_targets for tool rz2platforms for override %d of tool %s is not a listNz2install for override %d of tool %s is not a stringz?version_cmd for override %d of tool %s is not a list of stringszBversion_regex for override %d of tool %s is not a non-empty stringz@version_regex_replace for override %d of tool %s is not a stringz5export_paths for override %d of tool %s is not a listz7export_vars for override %d of tool %s is not a mappingzversion name for tool rcz*tool {} version {} status is not one of {}rCrczinvalid platform rrr rrrYr rz for platform z has z recommended versionszrequired/optional tool z has no recommended versions)rrrOrGrrlistdictrrrrr(r enumeraterr^rrmrrqrjrrr INSTALL_NEVERr)!r:r, tool_namerrrrrrrrrrrrroverrides_listrtool_objrrCrHindexrplatforms_listr version_dictrbversion_statusr  platform_id platform_dict version_lists! r from_jsonzIDFTool.from_jsons~ MM&)) )S)) <:;; ;mmM22 +s++ ><== =! ot<< -.. TRRRRSS S"'7<<.#.. WU)UUUVV VmmM22   D ( ([y[[[\\ \! o66 --- `m `  `^^^^__ _ ) .E F F  ^4I3)O)O ^\\\\]] ] }}^44   T ) )Q QQQRR RmmM266   D ( (SySSSTT T==,, >> % %OIOOOPP P-- 511'3'' PN9NNNOO O==U33(C(( QOIOOOPP PmmIu--#s## PN9NNNOO O(}}-CQGG  [D)=$>$>c$I$IY YYYZZ Z"';R@@   t + +WiWWWXX X%MM*=>>+T22 caYaaabb b"c         !     ! 7 7D   ) 0 0 6 6 6 6&,,.. 7 7KD%16H  ( . .(88" 9" 9OE8%\\+66NN##4//"#W[`bkZl#lmmmll9--G":gs+C+C""#W[`bkZl#lmmm",,}55K&4 +<+,>d,J,J"#Z^cen]o#oppp",,}55K&4 +<+>><>,[9(5<\#\<c g}|jD]\}}||jd}|jD]C\}}|jr|j|j|j|jd||<+|j|j|jd||<D|||j }|j |j |j j |j j|j j|j j|j j|j j|j j|j j|d }|j jt,kr|j j|d<|r||d<|j jr|j j|d<|j jdur|j j|d <|j jr|j j|d <|S) z+ Make a JSON dump of self. r.)r rrrY)r rr) rCrrrrrrrrrrrrrFrr)rr(rcrfrYr rrrrrCrrrrrrrrrrrrrrr) rAversions_arrayrbr  version_jsonr:r0overrides_array tool_jsons r to_jsonzIDFTool.to_jsons$(M$7$7$9$9 0 0 G[$+{7IJJL)4)>)D)D)F)F x x% X'x'| ( "*/'/'; 11L--9A hmgogv0w0wL--  ! !, / / / /1I+ L5<3|+ -|+<3!\7!%!?&    < -1N N N151SI- .  >.=I* + < , R04 0QI, - < % . .)-)CIo & < & F*.,*EI& 'r)NrTrrLNN)0rrrrMINSTALL_ALWAYSINSTALL_ON_REQUESTr2rOrrrrr\rrrr^rrrrr rrrrrrr rrrrwrr{rrrrr0rrrXr classmethodrr=rCrrr rr<s N%M04$%" (-(-(-(- (-  (-  (-#Y(-(- 9(- (}(-"(-(-(- (-(-(-(-T#) T T T TAAAA 1>1d1111B#BBBB 6C6C6666YYS YYYYstCH~$x#x#xxxxKKxS ':KT\]`TaKmpKKKKB=S=S====.#$ (Xc](t((((-(C5$;"7---- 7tCy7777 btCybTbbbbS$SSSS S #    !#!!!!F4"4"4"4"l(3-8% % % % % % N s t    4 / s t   \ m$sE#tCy$sCx.2P,Q'Q"RmW`mmm[m^+++++rrceZdZdZdZdS) IDFEnvEncoderz IDFEnvEncoder is used for encoding IDFEnv, IDFRecord, SelectedIDFRecord classes to JSON in readable format. Not as (__main__.IDFRecord object at '0x7fcxx'). Additionally remove first underscore with private properties when processing. cXdt|DS)Nc@i|]\}}|d|S)r=)lstriprrrs r z)IDFEnvEncoder.default..s(???TQ q???r)varsr()rAobjs r defaultzIDFEnvEncoder.defaults&??T#YY__->->????rN)rrrrMrQrrr rIrIs2 @@@@@rrIcJeZdZdZddZdZdefdZdefdZde de fd Z de de fd Z e deefd Zdd eedfdeedfddfdZddZe deefdZdeeddfdZeddZedeeefddfdZdS) IDFRecorda IDFRecord represents one record of installed ESP-IDF on system. Contains: * version - actual version of ESP-IDF (example '5.0') * path - absolute path to the ESP-IDF * features - features using ESP-IDF * targets - ESP chips for which are installed needed toolchains (example ['esp32' , 'esp32s2']) - Default value is [], since user didn't define any targets yet r4Nc@d|_d|_dg|_g|_dS)Nrcore)rbr _features_targetsrzs r r\zIDFRecord.__init__s$  %+H#% rc#pK|j|j|j|jdEd{VdS)Nrbrfeaturesr)rbrrVrWr(rzs r __iter__zIDFRecord.__iter__s\|I}   %''          rcJtjt|ddS)NFru ensure_asciiindent)rdumpsr0rzs r __str__zIDFRecord.__str__ sz$t**5CCCCrc*|Sr6rarzs r __repr__zIDFRecord.__repr__ ||~~rrhclttsdStfddDS)NFc3\K|]&}t|t|kV'dSr6)rE)rrrhrAs r rz#IDFRecord.__eq__..s<mmQ74##wua'8'88mmmmmmrrY)rrSrrks``r rozIDFRecord.__eq__sB%++ 5mmmmmBlmmmmmmrc\t|tsdS|| Sre)rrSrorks r __ne__zIDFRecord.__ne__s.%++ 5;;u%%%%rc|jSr6)rVrzs r rZzIDFRecord.featuress ~rradd.removecdt|}t|}||}||}t|j}|||||dt ||_dS)NrU)ry differencerVrdifference_updaterkr/)rArkrladd_set remove_setfeatures_to_addfeatures_to_removerZs r update_featureszIDFRecord.update_featuressc(([[ !,,Z88'227;;t~&&(((""#5666 Vhrc d}|jD]l}tjt |s>t ddt |dd|g||fz }m||dS)zw Check if feature requirements files exist. If not, remove the feature from the features list. rrSzFeature file 'z' does not exist.zRemoving feature )rlN)rVrrrfeature_to_requirements_pathr`rrt)rArsfeatures r check_feature_requirements_filesz*IDFRecord.check_feature_requirements_files-s /1~ 1 1G7>>">w"G"GHH 1IIe-I'-R-Reee999#wj0" $677777rc|jSr6)rWrzs r rzIDFRecord.targets@s }rrcXtt||jz|_dSr6)r/ryrW)rArs r extend_targetszIDFRecord.extend_targetsDs$S4=!899:: rcb|}t|_tj|_|Sr6)get_idf_versionrbrUr/r)r:idf_record_objs r get_active_idf_recordzIDFRecord.get_active_idf_recordHs+!0!2!2jr record_dictc0|} |d|_|d|_n#t$rtdwxYw||dg||dg|S)NrbrzInconsistent recordrZr)rbrKeyErrorrrtrr{)r:rr~s r get_idf_record_from_dictz"IDFRecord.get_idf_record_from_dictOs 4%0%;N ""-f"5N   4 4 4233 3 4 &&{z2'F'FGGG%%kooi&D&DEEEs 'ArL)rr)r4rS)rrrrMr\r[rOrardrrroripropertyrrZrrtrxrr{rGrr r rrrr rSrSs&&&& DDDDD#nFntnnnn &F&t&&&& $s)X ( (5c? (sCx (Z^ ( ( ( (8888&cX;d3i;D;;;;[  4S> k   [   rrScdeZdZdZd dZdZdefdZdefdZd dZ de fd Z e d d Z dS) IDFEnva IDFEnv represents ESP-IDF Environments installed on system and is responsible for loading and saving structured data. All information is saved and loaded from IDF_ENV_FILE. Contains: * idf_installed - all installed environments of ESP-IDF on system. r4Ncbt}|ti|_dSr6)active_repo_idrSr idf_installed)rA active_idf_ids r r\zIDFEnv.__init__is,&(( 4A9CbCbCdCd3erc#LKd|jiEd{VdS)N idfInstalled)rr(rzs r r[zIDFEnv.__iter__msI D. %''         rcVtjt|tddS)NFrur:r^r_)rr`r0rIrzs r razIDFEnv.__str__rs"z$t**-eTUVVVVrc*|Sr6rcrzs r rdzIDFEnv.__repr__urerc||kr-tjt jt} t jrtt jt|dd5}td|tj t||tddddddS#1swxYwYdS#tt f$rZtjt jtjst!d t jd t!d |d wxYwdS) zt Diff current class instance with instance loaded from IDF_ENV_FILE and save only if are different. wrrz Updating FrurNzIDF_TOOLS_PATH zA is not accessible to write. Required changes have not been savedzFile zN is not accessible to write or corrupted. Required changes have not been saved)r get_idf_envrrrrUr0 IDF_ENV_FILErr~r`rdumpr0rIIOErrorraccessW_OK)rAidf_env_file_pathrs r savez IDFEnv.savexs  % % ' '4+;+;+=+=+S+S+U+U U U " Q-=| L L  #.A,---+S7CCC^q8%688999Id4jj!U[\]]]]^^^^^^^^^^^^^^^^^^W%   y!127;;!?!*:???;-;;;  V Us1.7C=%>C0# C=0C44C=7C48C==A+E(c4|jtSr6)rrrzs r rzIDFEnv.get_active_idf_records!."2"233rc t|} tjtjt }t |dd5}tj|} |d}| ddi}|D]U} t ||||<'#t$r"}t|d|d|d Yd}~Nd}~wwxYwt|jfi||_n#t $rYnwxYwdddn #1swxYwYn#t"t$tf$rYnwxYw|S) z IDFEnv class is used to process IDF_ENV_FILE file. The constructor is therefore called only in this method that loads the file and checks its contents. rrrrshaNz "z " found in z, removing this record.)rrrrUr0rr~rrpoprSrrr\r0rrrr) r: idf_env_objr idf_env_file idf_env_jsonridf_installed_verifiedidfras r rzIDFEnv.get_idf_envs cee   " Q-=| L L 'w??? j<#y66 j$0$@M"%%eT222CE*,ggg:C:\:\]jkn]o:p:p2377)ggg C!e!e3!e!e;L!e!e!effffffffg 15[5N0i0iRh0i0iK--! D  j j j j j j j j j j j j j j j.*-    D sAD D#C3+D#B,+D, C6CDCD3 D=D?DD DDDDDD54D5rL)r4r)rrrrMr\r[rOrardrrSrrGrrrr rr`sffff WWWWW#24y4444###[###rrcxeZdZdZdZejedZd dZ e d dZ de fdZ dS) ENVStatea ENVState is used to handle IDF global variables that are set in environment and need to be removed when switching between ESP-IDF versions in opened shell. Every opened shell/terminal has it's own temporary file to store these variables. The temporary file's name is generated automatically with suffix 'idf_ + opened shell ID'. Path to this tmp file is stored as env global variable (env_key). The shell ID is crucial, since in one terminal can be opened more shells. * env_key - global variable name/key * deactivate_file_path - global variable value (generated tmp file name) * idf_variables - loaded IDF variables from file IDF_DEACTIVATE_FILE_PATHrr4Nci|_dSr6) idf_variablesrzs r r\zENVState.__init__s-/rc|}|jrg t|jdd5}tj||_dddn #1swxYwYn#t t tf$rYnwxYw|S)Nrrr)deactivate_file_pathr~rrrrrr)r: env_state_objrs r get_env_statezENVState.get_env_states  #  #2C'JJJ@b26)B--M/@@@@@@@@@@@@@@@Wj1    s4AA AAAAAA65A6cT |jrMt|jdd5}tj|j|dddddn #1swxYwYnt jddttj 5}|j |_| tj |jdd ddddn #1swxYwYn/#ttf$rt!d |jd YnwxYw|jS) NrrrFrur]idf_)deletesuffixzFile storing IDF env variables zV is not accessible to write. Potentional switching ESP-IDF versions may cause problems)rr~rrrtempfileNamedTemporaryFilerOrgetppidrCrXr`rrrr\)rArrs r rz ENVState.saves ( k$3S7KKKSqId0!%PQRRRRSSSSSSSSSSSSSSS0F`SQSQ[Q]Q]M^M^F`F`aaakeg02D-HHTZ(:WXYYY``ahiijjjkkkkkkkkkkkkkkk!    L$2KLLL       ((sXC4A  C4 AC4A;C4 AC( C4(C,,C4/C,0C44)D D rL)r4r)rrrrMenv_keyrrrrr\rGrrOrrrr rrs  )G:>>'2660000   [ )c))))))rrctj}t|dd5}tj|}dddn #1swxYwYt |S)zZ Load tools metadata from tools.json, return a dictionary: tool name - tool info. rrrN)rUr1r~rrparse_tools_info_json)tool_versions_file_namer] tools_infos r load_tools_infors  l %sW = = ="Yq\\ """"""""""""""" ! , ,,sAAAct}|d}t|turt d|D]&}t |}|||j<'|S)z Parse and validate the dictionary obtained by loading the tools.json file. Returns a dictionary of tools (key: tool name, value: IDFTool object). rz)tools property is missing or not an array)rrrr/rGrr=rC)r tools_dict tools_arrayr,tools r rrsw J..))K K$$FGGG %%   ++ $ 49 rrcg}|re|D].\}}|}||/t|d}t j|dddSt jidddS)z' Dump all the tools into JSON. )rbrrw)r&: T)r_ separators sort_keys)r(rCrTOOLS_FILE_VERSIONrr`)rrr=r5rB file_jsons r dump_tools_jsonr sKP%++-- * *KAx ((**I   y ) ) ) ) 2[II z)A+QUVVVVz"Q;$OOOOrc<tjdkrd}d}nd}d}||fS)z Returns: * python executable name (python on Unix, python.exe on Win) * subdir in which the executable is (bin for Unix, Scripts for Win) reScriptsz python.exebinpythonr)subdir python_exes r get_python_exe_and_subdirrs2  |w!  v rc d}tjtjd}tj|rjt |dd5}|}dddn #1swxYwYtj d|}|r| d}|' t tjtjdd d d d5}tj d |tj tj z}|r>d | d| df}ntdtd dddn #1swxYwYn3#t $r&}td|tdd}~wwxYw|S)z! Return ESP-IDF version. Nz version.txtrrrz^v([0-9]+\.[0-9]+).*r components esp_commonincludezesp_idf_version.hzS^#define\s+ESP_IDF_VERSION_MAJOR\s+(\d+).+?^#define\s+ESP_IDF_VERSION_MINOR\s+(\d+)r)rwz.Reading IDF version from C header file failed!z1It is not possible to determine the IDF version: )rrrrUr/rr~rr r rrr  MULTILINErZrr,) idf_versionversion_file_path version_fileidf_version_strr r]mrs r r}r}(s<"&K QZ?? w~~'(() #S7 ; ; ; 2|*//11O 2 2 2 2 2 2 2 2 2 2 2 2 2 2 20/BB  )++a..K  QZ|YPcddov (IjFFHHI , ("%((AGGAJJ +C"D"DKKJKKK$Q--'  ( ( ( ( ( ( ( ( ( ( ( ( ( ( (   IaII J J JQ--   sOA??BB:.ss;qqqDAqW_QP\=]=]qbckpbpbpabpbpbprrcfg|]-\}}|tjk'|v+|.Sr)rrrErrrrs r rz$expand_tools_arg..xsB v v v41aA4F4F4H4HGLb4b4bghpuguguQgugugurrcfg|]-\}}|tjk'|v+|.Sr)rrr2rs r rz$expand_tools_arg..}sB u u u41aA4F4F4H4HGLa4a4afgotftftQftftftrcJg|]}|| Sr)r)rrrrs r rz$expand_tools_arg..s2 [ [ [1q!1!Q!QRY!Z!Z [Q [ [ [rcg|]}d|v| S)@r)rrs r rz$expand_tools_arg..s"UUU< ATAT,ATATATr)extendr()rrrrrs ``@@r expand_tools_argrgs1 E#ss  qqqqqM$7$7$9$9qqqrrrrZ v v v v=..00 v v v     *   u u u u=..00 u u u   \ [ [ [ [ [ [ [E LLUU:UUUVVV Lr targets_strcjtg}|}|ddd}|dgkrSfd|D}|rKt dd|ddd t d |S) z] Parse and check if targets_str is a valid list of targets and return a target list. rirr&rcg|]}|v| Srr)rttargets_from_tools_jsons r rz%parse_targets_arg..s$RRR:Q1Q1Q11Q1Q1Qrz Targets: "rBz/" are not supported. Only allowed options are: r)r )get_all_targets_from_tools_jsonrrrr\rr)rinvalid_targetsrrs @r parse_targets_argrs>??O##%%K!!#r**0055G5'&&RRRRgRRR  STYY77SS-1YY7N-O-OSSS   Q-- rrct|}|||jS)zm Define targets from targets_str, check that the target names are valid and add them to idf_env_obj. )rrr{r)rrrs r add_and_check_targetsrsF ,,G%%''66w???  , , . . 66rrwcbtjtjddd|dS)zd Convert feature (ci, core, docs, gdbgui, pytest, ...) to the path to its requirements.txt. r requirementsz requirements..txt)rrrrUr/)rws r rvrvs, 7<< G^=ZW=Z=Z=Z [ [[r features_strcg}g}g}d|dDD]}|d}tjt |s||gz }J|dr||dgz }y||dgz }|r4tdd|td| t|t|| | jS) z[ Check whether new feature is valid. If yes, update features in active IDF record. cg|] }|dk| Sr|rrrws r rz.process_and_check_features..s$!b!b!bgT[_aTaTa'TaTaTarr&z-+ri+z/The following selected features are not valid: rBr )rrLrrrrvr6rZrrrrttuplerxrZ)rr new_featuresremove_featuresinvalid_featuresnew_feature_candidatesanitized_feats r process_and_check_featuresr svLO!b!b9K9KC9P9P!b!b!b @ @.55d;;w~~:>JJKK   0 0   + +C 0 0 @  5 < >? ?LL ] JZ@[@[]]^^^mm%%''77l8K8KUSbMcMcddd%%''HHJJJ  , , . . 77rc,t}g}|D],\}}||-t t |}d|vr|dt|S)z; Returns list of all targets from tools.json file. r)rr(rrr/ryrlr)rrr=rs r rrs!""J)+  ""BB1&&q'>'>'@'@AAAA"3'>#?#?@@ '''&&u--- ) * **rc|js|Sfd|D}t|S)z Filter tools info; return only those targets which: * are installable (install type is INSTALL_ALWAYS or INSTALL_ON_REQUEST) * support at least one target from active IDF record c0i|]\}}|tjks"|tjkrIt fd|Ds|dgk||S)c3 K|]}|vV dSr6rrs r rz/filter_tools_info...s'KKTW_KKKKKKrr)rrrErFrr)rrrrs r rNz%filter_tools_info..s   1""$$(>>>!BTBTBVBVZaZtBtBtKKKK1H1H1J1JKKKKKCuOPOfOfOhOhmrlsOsOs qPtOsOsr)rrr(r)rrfiltered_tools_specrs @r filter_tools_inforsm //119G  0    "((**    .///r new_idf_varsc Hd|vr&|dddd|d<|dg|d<t|d}|r|d|dzn|d|d<t}|jrV|j}t t|d|dgz|d<t|fi||_n||_| }|S)zn Add IDF global variables that need to be removed when the active esp-idf environment is deactivated. r:Nradd_paths_extras) rrrOrrrr/ryr0r)r2rargs_add_paths_extrasrexported_idf_varsrs r add_variables_to_deactivate_filers9+F399#>>ssC V'++FB77L JJNN+=>>CXr V4::3????^jkq^r**,,M"3)7#C V(.s*$c$c$c1qPZ[aPbGbGbQGbGbGbrcg|] }|dk| Srr)rrs r rz.print_deactivate_statement..s>>>!v++!+++rc:g|]}|Srr)rr unset_formats r rz.print_deactivate_statement..s'KKK1 3 3A 6 6KKKr)rrrrrrrrsget_unset_format_and_separatorget_export_format_and_separatorrprintclearr) r2renv_pathcleared_env_path unset_listrunset_statement export_formatexport_statementdeactivate_statement_strrrs @@r print_deactivate_statementr+ sK **,,M  &,J i//He88$c$c$c$cs0C0C$c$c$cdd>>Z__..>>>J6t<<L#hhKKKK KKKLLO8>>M3$++F4DEE"xx:J(KLL "###%%''' Frc8tdtdi|jS)zi Returns export pattern (formatted string) either for exporting in shell or as a key-value pair. )zexport {}="{}";)z{}={}rS EXPORT_SHELLEXPORT_KEY_VALUErr2s r r!r!&s 13C_ UVZVa bbrc8tdtdi|jS)zh Returns pattern to unset a variable (formatted string) either for shell or for key-value pair. )zunset {}r-)z{}rSr.r1s r r r -s +-=| LT[ YYrc ttjdtS#t$rdtcYSwxYw)z Function returns unique id of running ESP-IDF combining current idfpath with version. The id is unique with same version & different path or same path & different version. z-vzUNKNOWN_PATH-v)rOrUr/r}rFrrr rr4s^ 4aj//88_%6%6888 4443 1 1333334s),A  A c t}|D]C\}}|tjkr)|tjkrdnd}t d|d|j| |n#t$rYnwxYwd|j D}|st dtdt| |j jd }|D]C}|j |}t d ||j||jvrd ndDEd S) z\ Prints currently installed versions of all tools compatible with current platform. z (optional)rz* rcBi|]\}}|||SrrrMs r rNz list_default..N/ h h h$!Q1KeKeKgKg hA h h hrz( (no versions compatible with platform )Trz - {} ({}{})z , installedN)rr(rrr2rFr`rrrVrrrrsrrrcr) r2rrCr optional_strversions_for_platformversions_sortedrbr s r list_defaultr;@s!""J &&(( d  " "g&; ; ; (,(=(=(?(?7C](](]}}ce  :$ : :$* :L : :;;;   ( ( * * * *    D  h h$-2E2E2G2G h h h$  NONNN O O O  !6!;!;!=!=4=CT^bccc&  G-0K &&[/'TMdBdBdjl     sB$$ B10B1ct}|D]\}}|tjkr(d|jD}|sN|}|set||jj dd}||krt|d|d|dS)za Prints info if currently installed version can be replaced by newer one for every tool. cBi|]\}}|||SrrrMs r rNz!list_outdated..dr6rTrrz : version z is outdated by N) rr(rrr2rrrrsrr`)r2rrCrr9version_installedversion_availables r list_outdatedr@\s!""J &&(( \ \ d  " "g&; ; ;  h h$-2E2E2G2G h h h$   99;;   "#8#=#=#?#?T]EV`deeefgh 0 0 0 DZZ$5ZZGXZZ [ [ [ \ \rcT|jrt|dSt|dS)z If args.outdated flag is set, prints if currently installed tools can be replaced by their newer version. If not, prints currently installed tools with their version. N)outdatedr@r;r1s r action_listrCos6  }dTrc$t}tt|}g}d}t d|D]\}}|tjkr(d}t d| | n#t$rd}YnwxYw|j rt d|j d}nt d|j D]}t d|d}|s7|tj kr|||r4tdd |t#d |rt#d d S) zj Checks what tools are installed and if some mandatory tool is missing, exits with return code 1. FzChecking for installed tools...zChecking tool Tz version found in PATH: z no version found in PATHz* version installed in tools directory: z-The following required tools were not found: rr N)rrrrr`r(rrr2rrVrrrErrZrr)r2rnot_found_listr rCrtool_found_somewhererbs r action_checkrGzs!""J"6#5#5#7#7DDJNJ *+++ &&(((( d  " "g&; ; ; $ $d $ $%%%   ( ( * * * *   JJJ    1 Et/CEE F F F#' / 0 0 0. ( (G GgGG H H H#' # ((=(=(?(?7CY(Y(Y  ! !$ ' ' ' Xchh~>V>VXXYYYmmmmsB// B>=B>rr3version_to_useprefer_system_hintc||}||}|jr=|j|jvr/t d|jd|jd|zt j||fS)zP If there is unsupported tools version in PATH, prints info about that. z)Not using an unsupported version of tool  found in PATH: r)r])rrrrr`rCrVrW)rr3rHrItool_export_pathstool_export_varss r !handle_recommended_version_to_userOs--n==++N;;   4DM I I j j jSWSg j j j  !j    . ..rcj|j|j}|jtjkrZt d|d|jdt jt d|dt jdS|jtj krtd|d|jdSdS)zb Prints info if supported, but not recommended or deprecated version of the tool is used. z"Using a supported version of tool rKr)rLz#However the recommended version is z#using a deprecated version of tool N) rrrcr^r}r`rVrWrr~r\)rr3r s r &handle_supported_or_deprecated_versionrQs#'-0D"EK^<<< d) d dTMa d d dhkhrssss T43O3O3Q3Q T T TX[Xbcccccc  ~? ? ? d9 d ddNb d deeeee @ ?r install_cmdcd|jd}dtjvrt|dnt|d|d|jr:|j|jvr.t d|d|jd |ztj d Sd Sd S) zc Prints the info about missing tool to stderr if tool has no supported versions installed. rz has no installed versions.NIX_PATHz The environment indicates that you might be using NixOS. Please see https://nixos.wiki/wiki/ESP-IDF for how to install tools for it.z Please run 'z' to install it.zAn unsupported version of tool z was found in PATH: z. rLN) rCrrrZrrr`rVrW)rr3rRrIr=s r handle_missing_versionsrUs 9$) 8 8 8CRZ  Z Z Z    @@;@@@AAA   4DM I I ei e eTMa e e e  !j        I IrcVd}g}i}|}|js|r||}|||fS|r!|jst ||||\}}|||fS|jrO|j|jvr,|jr$td|jd|j|||fSnt|||||fS|j sh| tj krAtjdddkrtd|dnt!||||d }|||fS|||fS) z Helper function used only in action export. Returns: * Paths that need to be exported. * Dictionary of environment variables that need to be exported for the tool. * Flag if any tool was found. Tz%using an unsupported version of tool rKIDF_SKIP_TOOLS_CHECK01rzQ is not installed and IDF_SKIP_TOOLS_CHECK is set. This may cause build failures.F)rrr prefer_systemrOrrr\rCrQrrrrErrrU) rr3r2rRrI tool_foundrMrNrecommended_version_to_uses r process_toolr]sJ#%')!%!E!E!G!G  ?"<?//0JKK "2J>>!?$*<?.O )79K/ / ++!"2J>>  C  t} 4 4! nTYnnX\Xlnnooo(*:JFF 34 C C C$&6 B B  " ?  " "g&< < <y/55<<xIxxx(iFXYYY"  "2J>> . ::rrrc  ttj|tdd5}|}dddn #1swxYwY||kr(td|d|d|dtddS#t$r}td |d Yd}~dSd}~wwxYw) NrrrzPython environment is set to z! which was generated for ESP-IDF z instead of the current z. The issue can be solved by (1) removing the directory and re-running the install script, or (2) unsetting the IDF_PYTHON_ENV_PATH environment variable, or (3) re-runing the install script from a clean shell where an ESP-IDF environment is not active.r zaThe following issue occurred while accessing the ESP-IDF version file in the Python environment: z.. (Diagnostic information. It can be ignored.)) r~rrr VENV_VER_FILErstriprZrrr\)rrr]read_idf_versionrs r check_python_venv_compatibilityrb se "',,2MBBCRY Z Z Z 0^_ vvxx~~//  0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 { * * 0C+EP   Q--  + *      ;pq ; ; ;          s:5B%'A* B%*A..B%1A.21B%% C /CC c|jrt|dSt}tt|}d}i}g}t jdt|j rdnd}t|gd}trdnd|d}trttgdn|d }| D]N\}} | tjkr(t#| ||||\} } } | sd }|| z }i|| }O|st%d t'jd } t+\}}}}t&j|rrt|gd}t'jd |krt|gd|d <| r)t jdks|| vr||t5}t'jd|kr||d<t7||t&jt:jd}t|gd}| r)t jdks|| vr||t jdkrd}d}nd}d}t?|\}|r|t||gz|d <t jdkr||d t&j d } |!d|!dkrtEdn##tF$rtId|dYnwxYw|rutK||&}||tNj(<|fd| D}tS|dSdS)zV Exports all necessary environment variables and paths needed for tools used. NTrz --tools-json {args.tools_json}rrz To use it, run 'z export --prefer-system'z installFr rrreESP_IDF_VERSIONrz%PATH%r-z$PATHrz\tools;z\idf-exezIThe PATH is not in correct order (idf-exe should be before esp-idf\tools)zMBoth of the directories (..\idf-exe\.. and ..\tools) has to be in the PATH: rScBg|]\}}||Srr)rrrr(s r rz!action_export..y s-,h,h,hDAq]-A-A!Q-G-G,h,h,hr)* deactivater+rrrrrVrg__file__r1rIDF_TOOLS_EXPORT_CMDr'r(rrr2r]rrrrrrrfrr}rbrrUr/r!rr6r\rrZrrrrr")r2rall_tools_foundrpaths_to_exportself_restart_cmdrIrRrCrrMrNr[ current_pathrrrr=r idf_tools_dirold_pathpath_sep export_seppaths_to_checkrexport_statementsr(s @r action_exportrs" s "4((( ""J"6#5#5#7#7DDJO"$KO.uu8u\`\k5s6W6Wqsuu.0@/ABB1E3w9wM]9w9w9w?Tw!6 788;;]mZwZwZw!&&(( : : d  " "g&; ; ; :F $k+=; ; 7+Z $#O,,99(89 mm9V$$LH[H]H]E/1BA w~~'((?57J6KLLQO 9* + +/B B B1HJ]I^1_1_`a1bK- .  ?|w&&*@ *T*T&&'=>>>!##K y"##{22)4 %&#$7EEEGLLW55M+]O< ) rrrr$mirror_prefix_mapr\URL_PREFIX_MAP_SEPARATORrr rr`)r2rynew_urlr}mirror_prefix_map_envrrrs r rvrv sA GI&=>>=177<<3$34#93   <   !2 %  D't33dAYdd^bddeee"jj)A1EEOFGoodF33GfVW.>??G***M.>MMGMMNNN+ NrcN|}tjdd}|s|Sd|vrt dt d|d}tjdd|d|}||krtd |d ||S) z Rewrite URL for given idf_download_url if the download URL is an https://github.com/ URL and the variable IDF_GITHUB_ASSETS is set. The github.com part of the URL will be replaced. IDF_GITHUB_ASSETSrz://zJIDF_GITHUB_ASSETS shouldn't include any URL qualifier, https:// is assumedr rz^https://github.com/https://z$Using GitHub assets mirror for URL: r|) rrrr`rZrrstripr rr`)ryr github_assetss r rwrw s GJNN#6;;AACCM   Z[[[mm"((--Mf,.I.I.I.IK[\\G""" S4D S S' S STTT Nrselected_platformr-c tj}|t_t}t}|D]\}}||} | ||< t |||}td|dd||t_n#|t_wxYw||fS)a Returns tools_spec list and dict of tools for selected platform in form tool_name : IDFTool object. NOTE: If this function is not called from action_download, but is used just for detecting active tools, info about downloading is unwanted. zDownloading tools for rrB) rUr-rrr(rrr`r) rrrr-old_global_quietrtools_info_for_platformrCr5tool_for_platforms r get_tools_spec_and_platform_infor s #7$&& "---(..00 > >ND( ( : :;L M M ,= #D ) )%j2I7SS  R&7 R R499Z;P;P R RSSS"""""" . ..s B!B00B>c.t|j}g}d|vsd|vrt}t ||j} |n`#t$r?}|j|vr||jtd|Yd}~nd}~wwxYwt|j}t|j }t|||\}}|D]&}d|vr|}d} n|dd\}} ||vr!td|t!d||} | -| | jvr$td|d | t!d| | } | %td |d |d t!d|d| }t'd || j| |} t+|| j| _| | (dS)z Saves current IDF environment and for every tools in tools_spec, downloads the right archive for tools version and target platform, if possible. If not, prints appropriate message to stderr and raise SystemExit() exception. rrz=Downloading tools for targets was not successful with error: Nrr unknown tool name: unknown version for tool rrz not found for z platformr%)rrrrrrrrrlr\rrrfrrrZrrrr`rurxr r0) r2rrrrarfr tool_specr3 tool_versionr5 _idf_tool_objs r action_downloadr s !,,JGZ5J#6#6((** ' T\BB X        X X X|w&&t|,,, VQTVV W W W W W W W W X $DL11!$-00H*J8U\^h*i*i'J'(( i  !ILL&/ooc1&=&= #I| 3 3 3 3 33 4 4 4Q-- *95  # Ht]EVWW ,''''1((sA## B,-5B''B,ct|j}g}d|vsd|vrt}t ||j} |nL#t$r?}|j|vr||jtd|Yd}~nd}~wwxYwtdd |nt|j}tdtt}t|||}tdd ||D]}d |vr|}d}n|d d \}}||vr!t#d |t%d ||} | s)t#d |d tt%d |-|| jvr$t#d|d|t%d || }|J | n#t.$rYnwxYw|d |}|| jvrtd|d#td|| j|t4} t7|| j| _| || |dS)z Saves current IDF environment and for every tool in tools_spec, installs the tool from the archive downloaded before, if possible. If not, raises SystemExit. rrz2Installing targets was not successful with error: NzSelected targets are: rBzCurrent system platform: zInstalling tools: rr rrz1 does not have versions compatible with platform rrz Skipping z (already installed)z Installing )rrrrrrrrrlr\r`rrrrrrrZrrwrrrrVrrurrxr r0r) r2rrrrarrr3rr5rs r action_installr sq !,,JGZ5J#6#6((** ' T\BB M        M M M|w&&t|,,, KcKK L L L L L L L L M :dii&8&8 : :;;;;$DL11 7%5 7 7888 ""J!*j'BBJ 5dii 33 5 5666!'!' i  !ILL&/ooc1&=&= #I| J & & 3 33 4 4 4Q-- i(0022 h)hhVfhh i i iQ--   # Ht]EVWW ,'''&&&&C!'!'s*A## B,-5B''B,H44 IIct}d}||vrdS||}|}|dS||}tj|sdS|S)z2 Gets path for idf-python-wheels package. zidf-python-wheelsN)rrrrrr)rwheels_package_namewheels_packagerecommended_version wheels_dirs r get_wheels_dirrN s!""J-*,,t 34N(@@BB"t445HIIJ 7>>* % %t rrct}t||} |nB#t$r5}||vr||t d|Yd}~nd}~wwxYwd|DS)zK Returns list of path for requirements.txt for given feature list. z1Updating features was not successful with error: Nc,g|]}t|Sr)rvrs r rz$get_requirements..l s! J J Jg ( 1 1 J J Jr)rrr rrrlr\)rrrZras r get_requirementsr` s$$&&K)+|DDHH HHH 8 # # OOL ) ) ) F F FGGGGGGGGH K J J J JJsA A? +A::A?Tonlinec&t}d|d}tjtj|}d||g}|d}|sBtj|r|St|dtdttj | tj tj tj|z }|tjdkrt#d|d |Sn#t$$rYnwxYwt't(D]}t+||} tj|s(t-d | t-d |d |Ytj|rtj|t1|||cStj|rt-d |Stdt3t5| t#dtd)z Download constraints file for specified IDF vversion if it was not downloaded recently (1 day), check success and place it in constraints file location. zespidf.constraints.vrrrAz~ doesn't exist. Perhaps you've forgotten to run the install scripts. Please check the installation guide for more information.r )dayszSkipping the download of z$ because it was downloaded recently.rrrzRFailed to download, retry count has expired, using a previously downloaded versionrzNSee the help on how to disable constraints in order to work around this issue.)rxrrrrUr0rrZrrrdatetimedatetoday fromtimestampgetmtime timedeltar`rr7rr0r\rlr>rhrO) rrryconstraint_fileconstraint_pathconstraint_url temp_pathager=ras r get_constraintsro s :;;>[>>>Ogll1#3_EEOXX/ABBN"(((I  7>>/ * * " " "MMM   Q--  BGOOI & &''' m!!##hm&A&A"'BRBRSbBcBc&d&dd #+++ + + b_bbb c c c" " ,      ' ( (  ~y11w~~i((  +c++ , , , F~FF9FF G G G  7>>/ * * ' Io & & &)_555 w~~o&& abbb ?@@@%c#hh/// ]^^^mms BE E#"E#c J tjtjdddgn?#tj$r-t dtjdt dwxYwd} dd l}n\#t$rOtd tjtjddd d d gtj tj d}YnwxYwd}|sr t|j dd}|dkrtd|j dd}n##t t"t$t&f$rYnwxYwtd|dtjg}|r|ddgz }tjtjdd g||tj tj d S)z Checks if pip is installed (and installs it if not), checks whether virtualenv is already installed (and in which version), and finally creates virtual environment with python -m virtualenv . -mpip --versionzPython interpreter at zx doesn't have pip installed. Please check the Getting Started Guides for the steps to install prerequisites for your OS.r FrNzInstalling virtualenvrz--user virtualenvr_rWTr)r5zVirtualenv version z% is old, please consider upgrading itz6Creating a new Python environment using virtualenv in z--pythonz--seeder)r check_callrVrgrrZrr ImportErrorr`r_rWr __version__rr\r NameErrorrG IndexError)rvirtualenv_installed_via_piprwith_seeder_option major_vervirtualenv_optionss r install_legacy_python_virtualenvr ss~tUKHIIII  (  jS^ j j j   mm $) , ,,, $%%% ^T5)X| LUXU_hkhr    (,$$$ , '  J288==a@AAI2~~h:+Ahhhiii%*"I~zB    D  H$ H HIII$cn52z511 |G.@G$GPSPZcfcms/"%.o s(JJ4JJJJJJr)6no_constraints reinstallrrrrrVrr6prefixhasattrrrrZrrrr_rWrrr\rfrCrDrbrrgDEVNULLrr`rrrrr rrr_rrFrr~rXrrrrrZextra_wheels_dirno_indexextra_wheels_urlrlinesep)r2use_constraintsrrr=rr nix_storeis_nix is_virtualenvrenviron_idf_python_env_pathcorrect_env_pathr]env_copyrrun_argsrequirements_file_listrequirement_filers r action_install_python_envr s --OI=P=R=R:-{ {++I d " qs'A'A)'L'L qQTQ[QfQfgpQqQqFJ]##f](C(C(e[^[eHebgnn-@AAY mnnnmm w~~'((!   !#4k"B3:^a^h i i i i i67   III     !#4dE;"OX[Xbknku v v v v v,    u v v vIII  <7 " " !%'8$&PY\Yclolvwwwww0 ! ! ![\\\  !+RW^^$788+ Q#G#G,33KAWXX$$ ( BI,33KMMOj-- &9T&&(3&&Vl&&&7>>"',,/JM"Z"Z[[ _a_h,33KMMOj`` '--i8888Z ;<<m9Tmmm       !vX0BXDWXzz      "',,':MJJCZabbb)fgGGK((()))))))))))))))   C  --@ A A Az  HHZ6EOok2224O !4 ;NH6^_55(3:cjhWWWW "###!4 ; UH6^_55(3:cjhWWWW!4 ;VWH-dm<<2--T+,,C[./BB <^T%:;; }#\N" A($*?@@!!J^Z00 %&&&5 3/ 3 3444 JJ3IJJJ J JKKK(3:cjhWWWWWWs--EE65E6:/F** G  G !.H H32H3EQ QQ5S8 S, S8,S00S83S04S88TTc|j }td}t\}}}}tj|s!t |dtd|r#t|d}td|tdttj d|Dtd ||tj tj d d g}|r|d |gz }|D] }|d |gz } tj|} | r| jrt| j dSdS#t"$rt dtdwxYw)z Checks if all the dependencies (from requirements, constraints...) are installed properly. Raises SystemExit if not. rzh doesn't exist! Please run the install script or "idf_tools.py install-python-env" in order to create itr F)rzConstraint file: zRequirement files:c3 K|] }d|V dS)z - Nrrs r rz3action_check_python_dependencies.. s(<<$t<<<<<+@+@(Aq [ 7>>+ , ,   F F F   mm0%k%@@@  . . ./// <<)<<< < <=== 5"3 5 5666' QZJh(i(ijM-$ ,, **$)) n]++  .3> .cn_-- - . . . .  /000mms *2E )F cXeZdZdZdeeddfdZdeee eeffdZ dS)ChecksumCalculatorzM A class used to get size/checksum/basename of local artifact files. filesr4Nc||_dSr6)r)rArs r r\zChecksumCalculator.__init__ s  rc#K|jD]5}gt|tj|RV6dSr6)rrrrr)rAr]s r r[zChecksumCalculator.__iter__ sZ B BAA(++ARW-=-=a-@-@AA A A A A B Br) rrrrMrrOr\rrrr[rrr rr svd3iDB(5c3#78BBBBBBrrceZdZdZdS)ChecksumParsingErrorz0 Raised when checksum cannot be parsed. NrQrrr rr rRrrcdeZdZdZdededdfdZdededefd Zdeee eeffd Z dS) ChecksumFileParserz A class used to get size/sha256/filename of artifact using checksum-file with format: # : bytes * ... (2 lines for every artifact) ... filename_prefixr r4Nc||_tjtjdd}tj|}t|jr|}t||t|dd5}| |_ dddn #1swxYwYtj|rtj|dSdS)Nrzadd-version.sha256.tmprrr)rrrrrUr0abspathrrr0r~r splitlineschecksumrrl)rArr sha256_file_tmp sha256_filer]s r r\zChecksumFileParser.__init__ s.',,q'7BZ[[gooc**  C==  ')K S+ & & & +sW 5 5 5 2FFHH//11DM 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 7>>/ * * ' Io & & & & & ' 's ,CC Cregexlinectj||}|std|d|d|dS)NzCan not parse line "z" with regex ""r )r rrr)rArrr s r parseLinezChecksumFileParser.parseLine sO %&& \&'Zd'Z'ZRW'Z'Z'Z[[ [{{1~~rc#<K t|jddd|jdddD]\}}|d|}|d|}||krtdt d||jsp|d|}|d|}t|||fVdS#ttf$r'}td |d t dd}~wwxYw) Nrrwr z ^# (\S*):z^\S* [\* ](\S*)z8filename in hash-line and in bytes-line are not the samez^# \S*: (\d*) bytesz^(\S*) z*Error while parsing, check checksum file (r7) rrrrZrr6rrrrG)rA bytes_strhash_strbytes_filename hash_filenamerrras r r[zChecksumFileParser.__iter__ sH '*4=A+> adQRd@S'T'T 7 7# 8!% i!H!H $/A8 L L  N22TUUU$Q--'%//0DEE~~&*   EsEEE F F FQ--  sCC##D4"DD) rrrrMrOr\rrrrr[rrr rr s''#'$''''$s## (5c3#78      rrc Jt}|j}||}|sWtd|t |t tjt t t gt t g}|||<|j}tj }|j r4t|j r | tj}|j |}|s,td|t||}||j |<|jp dt d}t|jr|jn|}|jrt%||jnt'|j} g} | D]\} } } | dd}|| vr! t,| }n)#t0$rtd| t }YnwxYwt3|| }td|td | td | td ||||| | | | t9|}|js4t<j tBj"tF|_tI|jd d 5}|%||%ddddn #1swxYwYtd|jdS)zl Adds new version of the tool to IDFTool entry together with download entry and updating json dump. zCreating new tool entry for zCreating new version rrrrz"Could not guess platform for file zAdding download for platform z size: z SHA256: z URL: rrrrSNWrote output to )&rrrr`r TODO_MESSAGErErbr^r}rrrrrj url_prefixdist_filename_prefix checksum_filerr artifact_filerrmrrrrqrroutputrrrrUr/TOOLS_FILE_NEWr~rX)r2rr3r5rbr9r rr checksum_info updated_toolsr*r+rxz_filefound_platformr json_strr]s r action_add_versionr s!""J I~~i((H  ) 7I 7 7888    "   N  N   !) 9lG#4N };X.//;   ':#''00K 1 .W . .///$Wn== %0'">$>|$>$>$>J36t7P3Q3Q`d//W`O   4?D,>???  2 3 3 M-:(() ; ##Iy99 m # #  *&66yAANN * * * AiAA B B B)NNN *j),, =^ = =>>> 'I ' '((( )K ) )*** !C ! !"""  iMMMY''''z**H ;?gll1:~>> dk3 1 1 1Q    )DK ) )*****s$F::#G G  +LLLct}t|}|js4tjt jt|_t|jdd5}| || ddddn #1swxYwYtd|jdS)zZ Write JSON dump of all tools from tools_info into file specified by args.output. rrrrSNr) rrr rrrrUr/r r~rXr`)r2rrr]s r action_rewriter/ s!""Jz**H ;?gll1:~>> dk3 1 1 1Q    )DK ) )*****s0+B''B+.B+c ttjtjd}tjtjd}tj|rtj|ng}i}|D]tjtj|r2tjtj|ng} fd|D}n#t$rdg}YnwxYw|r||<ddg}|D]|vr| |j rw|rstd d|td tjtjdd d d S|D]|D]} |r"tj||} n tj|} tj| t#| d n#t$$r)} t'| jd| jdYd } ~ d } ~ wwxYw|jrGt/t0dgdgd\} } g} | D]}d|vr|}d }n|dd\}}| |}||}|%|j|t0}||j}tj|}| |tj|}|D]j}|| vrbtj tj||t#tj||d id Sd S)z Print or remove installed tools versions, that are not used by active ESP-IDF version anymore. Additionally remove all older versions of previously downloaded archives. rrcPg|]"}|k |#Sr)r)rrrrs r rz$action_uninstall..M s4sssQ1 4@P@p@p@r@r;r;rq;r;r;rrrzidf-gitz idf-pythonz6For removing old versions of {} use command '{} {} {}'rBrz idf_tools.py uninstallNz was removed.z can not be removed because r)rT)r-rr )!rrrrrUr0rrFrrdry_runr"rrr/rCrDr`rr\rstrerrorremove_archivesrrrrrrur rrrl)r2 tools_path dist_pathinstalled_toolsunused_tools_versions tool_versionsunused_versionsKEEP_WIN_TOOLSrbpath_to_removeerrorrr used_archivesrr3rr5archive_versionarchive_version_urlarchivedownloaded_archivesrrs @@r action_uninstallr'= sQ !""Ja.88J Q-v66I02 j0I0IQbj,,,rO : ::<'-- U_aeHfHf:g:g oBJrw||J55 6 6 6mo  #sssss-sssOO  # # # "dOOO #  :*9 !$ ' .N,, ( ( ( ! % %d + + + |    HOOII344-//2GLLWnEE     & W W,T2 W WG WD%'W\\*dG%L%LNN%'W\\*d%C%CN n---5556666 W W WUUENUUUVVVVVVVV W W I.N ugwd/ / / + + $ * *I)##% # *3//#q*A*A' <.y9H#'GGII '"*"3L"A"["[\l"m"m*&5&9#g&&':;;G   ) ) ) ) j33* I IGm++ "',,y'::;;; Y88GGGHHH;II4 I Is+D"" D21D2,A*I J !JJ cB ddl}n,#t$rtdtdwxYwt t jtj tdd5}tj |}dddn #1swxYwYt t jtj tdd5}tj |}dddn #1swxYwY|||dS)z= Validate whether everything is installed correctly. rNz>You need to install jsonschema package to use validate commandr rrr) jsonschemarrZrr~rrrrUr/ TOOLS_FILErrTOOLS_SCHEMA_FILEvalidate)r2r) tools_filer1 schema_file schema_jsons r action_validater0 s~  NOOOmm bgll1:z22C' J J J+jYz** +++++++++++++++ bgll1:'8993 Q Q Q-U`i ,, --------------- K00000s,)02BBBC>>DDc 0|jt}dtddffd }|d|d|dd}|D]\}}|jj}|d |vrt j|d d |}d |jj}|d ||j t|z|j |jj||t|D]}||} | } | t$jkr<| t$jkrd} n!| t$jkrd} nt-| } | j| } | |}|dd || |j|j|d|ddS)zU Prints basic documentation and information about every tool from tool_info. rQr4Nc8|ddS)NrS)rX)rQr]s r print_outz!action_gen_doc..print_out s! 4 rz.. |zwsp| unicode:: U+200Bz :trim:rz$https://github.com/espressif/esp-idfz/treez/tree/\w+/(.*)z :idf:`\1`zhttps://spdx.org/licenses/a6 .. _tool-{name}: {name} {underline} {description} .. include:: idf-tools-notes.inc :start-after: tool-{name}-notes :end-before: --- License: `{license} <{license_url}>`_ More info: {info_url} .. list-table:: :widths: 10 10 80 :header-rows: 1 * - Platform - Required - Download )rC underlinerr license_urlrroptionalzX * - {} - {} - {} .. rst-class:: tool-sha256 SHA256: {} rS)r rrOr(rrr rrrrheading_underline_charrrrr{rrrr2rErFrrrrur`r r)r2rr3 idf_gh_urlr3r5rr5r platform_tool install_typeinstall_type_strrbr rr]s @r action_gen_docr< sv A ""JI*+++ Ik IbMMM7J)//11GG 8#,   8 + +v<<d? } | d@dAd| dBdC | dDdEtF| dGdH | dIdJdK+| dLd|dMNtr|dOdP } | dQdR | dSdTdUV| dWdXdUV| dYdZ | d[dd\]| d^d_d9F| dU`} | dadb | dcddd$e|dfdg } | dQdR |dhdi |djdk }|dQtjdlt"jdmn|dodpdqF|drds }|dLd|dMNtj dtrv|dudv }|dwdUdxy|dzdUd{y|d|d} }|dwdUdxy||}|j)||d~|jt0_|jt0_d|vr|jrdU|_|jp}tj dp^tjtjtj tBdt0_t0jtj d<tj dp#tj"tFt0_$tj %ddt'tMdtNdtQd~|j)r|j)t0_)n9tjt0jtTt0_)d|j+dd}tY|}||dS)Nz--quietz1Don't output diagnostic messages to stdout/stderr store_true)helpactionz--non-interactivez/Don't output interactive messages and questionsz --tools-jsonz"Path to the tools.json file to use)rFz --idf-pathzESP-IDF path to userG)destr/z!List tools and versions availablez --outdatedz#Print only outdated installed toolsrz1Print summary of tools installed or found in PATHexportz9Output command for setting tool paths, suitable for shellz--formatzqFormat of the output: shell (suitable for printing into shell), or key-value (suitable for parsing by other tools)choicesrQrFz--prefer-systemzNormally, if the tool is already present in PATH, but has an unsupported version, a version from the tools directory will be used instead. If this flag is given, the version in PATH will be used.z --deactivatezSOutput command for deactivate different ESP-IDF version, previously set with exportz--unsetz--add_paths_extrasz1Add idf-related path extras for deactivate optionrz3Download and install tools into the tools directoryrTOOL*raTools to install. To install a specific version use @ syntax. To install tools by pattern use wildcards in . Use empty or 'required' to install required tools, not optional ones. Use 'all' to install all tools, including the optional ones.)metavarnargsrQrFz --targetsrzoA comma separated list of desired chip targets for installing. It defaults to installing all supported targets.)rQrFr0z*Download the tools into the dist directoryz --platformz"Platform to download the tools foraTools to download. To download a specific version use @ syntax. To download tools by pattern use wildcards in . Use empty or 'required' to download required tools, not optional ones. Use 'all' to download all tools, including the optional ones.zpA comma separated list of desired chip targets for installing. It defaults to installing all supported targets.rzHRemove installed tools, that are not used by current version of ESP-IDF.z --dry-runzPrint unused tools.z--remove-archivesz;Remove old archive versions and archives from unused tools.IDF_PYTHON_CHECK_CONSTRAINTSr)rXnrz--mirror-prefix-mapzyPattern to rewrite download URLs, with source and replacement separated by comma. E.g. http://foo.com,http://test.foo.com)rNrFzinstall-python-envzJCreate Python virtual environment and install the required Python packagesz --reinstallz,Discard the previously installed environmentz--extra-wheels-dirz=Additional directories with wheels to use during installationz--extra-wheels-urlzAdditional URL with wheels)rFrQrz,Work offline without retrieving wheels indexz --featuresrUzqA comma separated list of desired features for installing. It defaults to installing just the core functionality.z--no-constraintszDisable constraint settings. Use with care and only when you want to manage package versions by yourself. It can be set with the IDF_PYTHON_CHECK_CONSTRAINTS environment variable.)rGrQrFz add-versionz)Add or update download info for a versionz--outputz"Save new tools.json into this filez--toolz"Tool name to set add a version forT)rFrrzVersion identifierz --url-prefixz7String to prepend to file names to obtain download URLsz --overridez$Override tool versions with new data)rGrFz--dist-filename-prefixzMPrefix of distro archive name in checksum file. If skipped tool name is used.)rz--checksum-filez:URL or path to local file with checksum/size for artifactsz--artifact-filez$File names of the download artifacts)rFrNrewritez=Load tools.json, validate, and save the result back into JSONr,z'Validate tools.json against schema filezgen-docz/Write the list of tools as a documentation pagerzOutput file name)rrQrFz--heading-underline-charz-Character to use when generating RST sectionsr"zcheck-python-dependenciesz6Check that all required Python packages are installed.IDF_TOOLS_VERSION_HELPERzcheck-tool-supportedz\Check that selected tool is compatible with IDF. Writes "True"/"False" to stdout in success.z --tool-namezTool name (from tools.json))rrFz --exec-pathz&Full path to executable under the testzget-tool-supported-versionsz*Prints a list of tool's supported versionsr unsetIDF_PATHz..IDF_TOOLS_PATH__PYVENV_LAUNCHER__z Platform z appears to be unsupportedaction_rir=)-argparseArgumentParser add_argumentadd_subparsers add_parserr/r0SUPPRESSrrrrrr$r(add_mutually_exclusive_groupFileTyperVr_ parse_argsrG print_helpexitr-rUr.rSrfr/rrealpathrrrg expanduserIDF_TOOLS_PATH_DEFAULTr0rrZrrr1r*rglobals)rCparser subparsers list_parserrIrr0rno_constraints_default subparserinstall_python_envradd_version_files_grouprQgen_doccheck_python_dependenciescheck_tool_supportedget_tool_supported_versionsr2action_func_name action_funcs r mainrt% sK  $ & &F  ([dpqqq "S\h -QRRR  +@AAA&&H&55J''5X'YYK\0U^jkkk'([\\\  " "82m " n nF /0 @         b   (9,OOO ,3fggg##I4i#jjG   K      ? $$Z6b$ccH ,0@Gklll   L      @ %%d&I;-B<XXX "_ht Z^^,JBOOUUWW[kk "G,  I  " "%> #    $..$p/##JS_$##$c$##$8?[ew#xxx##L7e#fff## E $##& $ $     ++M@k+ll   2V WWW  0T_c ddd  3GRV WWW  6o ppp  lIo ppp  $` !   #."J"JTX"J"Y"Y,, $` -    ,,->Eksv,www'' 8w'xxZ.RSSSj/XYYY'' 8i'jjZh.?.D.Dcj_qrrr &-\fi    !+ 5 5#*b!6!!**& + z~~011 s)44 "o 5   ))-$Mj)kkk))-$Mu)vvv&0&;&; )0\'<' ' # $00Tq0rrr   T " "D { AjAG,A$4: v 33vrw7G7G UWU\UdUdemUnUnptHuHu7v7vJZBJzz~~&677e27;M;MNd;e;eA JNN($/// E/EEEFFFmm < w||AJ ;; @!4!4S#!>!>@@)),-KKr__main__MSYSTEMz{MSys/Mingw is not supported. Please follow the getting started guide of the documentation to set up a supported environmentr6rD)r)NNN)F)T)rXrrrrr functoolsrrrrfr rCr)rrVrrr9 collectionsrrrrrzipfilerpython_version_checkerrrGrr"rtypingr r r r rrrrrr urllib.errorr urllib.parserrurllib.requestrurllib.responser exceptionsrrrr*r+r rrrrrercompilerrrrr$rrr~r'rh IDF_DL_URLr(rrmajorminorrr_r+rUrOrZr\r`rhsystemmachinerrrrrrrr{r|r}rmrrr/r0DIGICERT_ROOT_CA_CERTDIGICERT_ROOT_G2_CERTr'bytesrrrrrrrrrr#r,r0r>rNrPrTrVrrXtotal_orderingr^rrrIrSrrrrrrr}rrrrrrvr rrrr+r!r rr;r@rCrGr/r0rOrQrU Namespacerr]rbrsrxrvrwrrrrrrrrrrrrrrr'r0r<r@rBrtrrCrrr rs<      ######""""""!!!!! """" E!HHH *Q-------- !!!!!!""""""&&&&&& '''''''        w       -' c<88" #344 % 011:U  '>??z~~&=>> 2 Z^^$8:YZZ+,2MMS5E5KMM! %-%-%-%-%-%-%-%-PO44C4D44446s63646666$$s$x3($$$$$$ s t    0%X_&&==)9)9););==$ $$$@*@*@*@*@*@*@*@*F S S    &%o66 42%:I^__ Z^(( c( ( (CKDQTICV( ((((VS d3ictCH~ $ $3 $C $E#s(O $ $ $ $3CST # $    @S@s@t@@@@B35#!34=A $( 22 223S/4"7892 5/ 2 j ! 2  3 ? 2222j#CE$ /,B6st2#st<             L        l    ' ' ' ' 'f ' ' ' @*@*@*@*@*V@*@*@*F   &g g g g g fg g g T@@@@@K@@@llllllll^XXXXXXXXv-)-)-)-)-)-)-)-)` -c7l+ - - - -$ Pc7l); < P P P P 5c?    !!!!!HWU3S##56WWWW"tCyT#Yc;QUVYQZ_cdg_hB349,7v7C7DI7777\#\#\\\\8F8#8$s)8888: +c + + + + 060tCL7I0dSVX_S_N`0000& 49 DcN WZ    6 T#Y 4    :c$s)cc3hccccZcZuS#XZZZZ 4 4 4 4 48\\\&!!!J/ /// /  4: ////* f fS fT f f f f ' c  ad im    (4; 4;!4;)1);4;JM4;cf4; 4t 4;4;4;4;n  3 SW    ,X!X!X!X!X!X!v48ZSs\_#>4V[///%)#Y/<@I/NR/ 49d3<( ()////42(2(2(j='='='@ $ K3 K49 K K K K333d3c3333l/3/4////dYXYXYXx,,,^ B B B B B B B B     <   4 4 4 4 4 4 4 4 n>+S>+T>+>+>+>+B + + +VI3VI4VIVIVIVIr111&WWWtcd"ST"gtCygTggggT zBJ  &   jmmD!""s*2BB& B!!B&D D! D!