+ ߢ2j@ Rt^RIt^RIt^RIt^RIt^RIt^RIHtHtH t H t H t H t H t Ht^RIHt^RIHt^RIHtRt!RR4tR R ltR R ltR t]!]4t!RR]4t!RR]]4t!RR]]4tR#)zDTypes and functions to manage information on CPU microarchitectures.N)IOAnyDictListOptionalSetTupleUnion)schema)FEATURE_ALIASES)LazyDictionarycFa\P!S4V3Rl4pV#)z`Decorator that automatically converts a known target name to a proper Microarchitecture object. c<\V\4'd5V\9dRp\VP V44h\V,pS!W4#)z "{0}" is not a valid target name) isinstancestrTARGETS ValueErrorformat)selfothermsgfuncs&& >lib/python3.14/site-packages/archspec/cpu/microarchitecture.py_impl"coerce_target_names.._implsE eS ! !G#8 E!233ENED  ) functoolswraps)rrsf rcoerce_target_namesrs' __T!! Lrca]tRt^$toRt]tR*V3RlRllt]V3RlRl4t V3RlRlt ] V3RlR l4t V3R lR lt ] V3R lR l4t] V3RlRl4t] V3RlRl4t] V3RlRl4t] V3RlRl4tV3RlRltV3RlRlt]P,^3V3RlRlltV3RlRlt]V3RlRl4t]V3R lR!l4tV3R"lR#lt]V3R$lR%l4tV3R&lR'ltR(tVt R)#)+Microarchitecturez!A specific CPU micro-architecturec<V^8dQhRS[RS[R,RS[RS[S[,RS[S[S[S[S[S[3,,3,RS[RS[/#) nameparentsr vendorfeatures compilers generationcpu_part)rrrrint)r __classdict__s"r __annotate__Microarchitecture.__annotate__+sr7&7&7&)*7& 7& c( 7& T$sCx.112 7&7&7&rc WnW nW0nW@nWPnW`nWpnRVnRVnRVn RVP9dVPPR4R#R#)a Args: name: name of the micro-architecture (e.g. ``icelake``) parents: list of parent micro-architectures, if any. Parenthood is considered by cpu features and not chronologically. As such, each micro-architecture is compatible with its ancestors. For example, ``skylake``, which has ``broadwell`` as a parent, supports running binaries optimized for ``broadwell``. vendor: vendor of the micro-architecture features: supported CPU flags. Note that the semantic of the flags in this field might vary among architectures, if at all present. For instance, x86_64 processors will list all the flags supported by a given CPU, while Arm processors will list instead only the flags that have been added on top of the base model for the current micro-architecture. compilers: compiler support to generate tuned code for this micro-architecture. This dictionary has as keys names of supported compilers, while values are a list of dictionaries with fields: * name: name of the micro-architecture according to the compiler. This is the name passed to the ``-march`` option or similar. Not needed if it is the same as ``self.name``. * versions: versions that support this micro-architecture. * flags: flags to be passed to the compiler to generate optimized code generation: generation of the micro-architecture, if relevant. cpu_part: cpu part of the architecture, if relevant. Nssse3sse3) r#r$r%r&r'r(r) _ancestors_generic_familyadd)rr#r$r%r&r'r(r)s&&&&&&&&r__init__Microarchitecture.__init__+sfH    "$ @D7; 6:  dmm # MM  f % $rc.<V^8dQhRS[R,/#r"returnr )r)rr+s"rr,r-es4 34rc aVPfSVPR,oVPF(pSPV3RlVP44K* SVnVP#)z,All the ancestors of this microarchitecture.:NNNc38<"TFqS9gK VxK R#5iN).0avalues& r .Microarchitecture.ancestors..jsK(81UNQQ(8s )r1r$extend ancestors)rparentr@s& @rrDMicroarchitecture.ancestorsdsS ?? "LLOE,, K(8(8KK'#DOrc0<V^8dQhRS[S[,/#r"r9)rr)rr+s"rr,r-nsCCSCrc  \\V4.VPUu.uFp\V4NK up,4#uupi)z9Returns a set of the nodes in this microarchitecture DAG.)setrrDrxs& r_to_setMicroarchitecture._to_setns4CI;$..!A.Q#a&.!AABB!AsA c:<V^8dQhRS[S[R3,RS[/#r"rr r9r rbool)rr+s"rr,r-us&   E#':":;    rc\V\4'g\#VPVP8H;'dVPVP8H;'dVP VP 8H;'d}VP VP 8H;'d\VPVP8H;'d;VPVP8H;'dVPVP8H#r<) rr NotImplementedr#r%r&r$r'r(r)rrs&&r__eq__Microarchitecture.__eq__ts%!233! ! II # 0 0 u||+ 0 0 / 0 0  - 0 0%//1  0 0 5#3#33  0 0  / rc <V^8dQhRS[/#rHr*)rr+s"rr,r-s#rc,\VP4#r<)hashr#rs&r__hash__Microarchitecture.__hash__sDIIrc:<V^8dQhRS[S[R3,RS[/#rPrQ)rr+s"rr,r-s&!!E#':":;!!rc W8X*#r<r=rUs&&r__ne__Microarchitecture.__ne__s   rc:<V^8dQhRS[S[R3,RS[/#rPrQ)rr+s"rr,r-&00E#':":;00rc|\V\4'g\#VP4VP48#r<rr rTrMrUs&&r__lt__Microarchitecture.__lt__-%!233! !||~ //rc:<V^8dQhRS[S[R3,RS[/#rPrQ)rr+s"rr,r-&11E#':":;11rc"W8H;'gW8#r<r=rUs&&r__le__Microarchitecture.__le__ 004<0rc:<V^8dQhRS[S[R3,RS[/#rPrQ)rr+s"rr,r-rdrc|\V\4'g\#VP4VP48#r<rfrUs&&r__gt__Microarchitecture.__gt__rirc:<V^8dQhRS[S[R3,RS[/#rPrQ)rr+s"rr,r-rkrc"W8H;'gW8#r<r=rUs&&r__ge__Microarchitecture.__ge__rorc <V^8dQhRS[/#rHr)rr+s"rr,r-s;;#;rcPVPP RVP: R2#)()) __class____name__r#r\s&r__repr__Microarchitecture.__repr__s$..))*!DII=::rc <V^8dQhRS[/#rHry)rr+s"rr,r-srcVP#r<r#r\s&r__str__Microarchitecture.__str__s yyrc:<V^8dQhRS[S[,RS[RR/#)r"fpindentr9N)rrr*)rr+s"rr,r-s& & &r#w &S & &rc `\4p^V3.pV'dVP4wrV\RRV 2 VP 2VR7\ VP 4FJpVPV9dKVP WR,V34VPVP4KL KR#)zIFormat the partial order of this microarchitecture's ancestors as a tree.>)fileN)rJpopprintr#reversedr$appendr4)rrrseenstacklevelcurrentrEs&&& rtreeMicroarchitecture.trees78$i["YY[NE R%yM',,0r :"7??3;;$& enf56% 4 rc&<V^8dQhRS[RS[/#)r"featurer9)rrR)rr+s"rr,r-s ! !C !D !rc \V\4'g/Rp\VP\\ V4444hWP 9dR#\ PPVR4pV!V4#)z3only objects of string types are accepted [got {0}]TcR#)Fr=rLs&r0Microarchitecture.__contains__..sur) rr TypeErrorrtyper&r feature_aliasesget)rrr match_aliass&& r __contains__Microarchitecture.__contains__se'3''GCCJJs4='9:; ; mm #(77;;G_U 4  rc<V^8dQhRR/#r8r=)rr+s"rr,r-s  + rc NVPfV.VP,Uu.uFqP'dKVNK ppRpVRRPRV44 R2, p\V4^8XgQV4hVP 4VnVP#uupi)z9Returns the architecture family a given target belongs toz>a target is expected to belong to just one architecture familyz[found , c38"TFp\V4xK R#5ir<ryr>rLs& rrA+Microarchitecture.family..s&=u!s1vvu])r3rDjoinlenr)rrLrootsrs& rfamilyMicroarchitecture.familys << !% 7K 71{{QQ 7EKRC WTYY&=u&==>a@ @Cu:? 'C '? 99;DL|| Ls B"B"c<V^8dQhRR/#r8r=)rr+s"rr,r-s,rc VPfIV.VP,Uu.uFqPR8XgKVNK pp\VRR7VnVP#uupi)zBReturns the best generic architecture that is compatible with selfgenericc,\VP4#r<)rrDrs&rr+Microarchitecture.generic..s AKK8Hr)key)r2rDr%max)rrLgenericss& rrMicroarchitecture.genericsY == $(6DNN#:T#:ahh)>S#:HT.HIDM}}Us A#A#c6<V^8dQhRS[S[S[3,/#rH)rrr)rr+s"rr,r-s   c3h  rc .R\VP4R\VP4R\RVP44RVP RVP Uu.uFp\V4NK upRVPRVP/#uupi) z3Returns a dictionary representation of this object.r#r%r&c38"TFp\V4xK R#5ir<ryrs& rrA,Microarchitecture.to_dict..s=}!s1vv}rr(r$r'cpupart) rr#r%sortedr&r(r$r'r)rKs& rto_dictMicroarchitecture.to_dictsy C N c$++& =t}}== $//  5 1A 5  t}}  6s"Bc<V^8dQhRR/#r8r=)rr+s"rr,r-s   .  rc  \VR,VR,Uu.uFp\V,NK upVR,\VR,4VPR/4VPR^4VPRR4R 7#uupi) z?Construct a microarchitecture from a dictionary representation.r#r$r%r&r'r(rr)r#r$r%r&r'r(r))r rrJr)datarLs& r from_dictMicroarchitecture.from_dictsu!f)-i9AWQZZ9>j)*hh{B/xx a0XXi,  9sB c,<V^8dQhRS[RS[RS[/#)r"compilerversionr9ry)rr+s"rr,r-s']0]03]0]0]0rc WPP9dR#WP9d_VPUu.uFq1VP9gKVNK up^,pRpVPWVP4p\ V4h\ P !RV4'gRp\V4hVPV,pRpVF|pV!W4'gKVR,p VPRVP4VPRR 4p V 'd\P!V 4V P!R/VBp V u# R pV'd5VUu.uF q3R ,NK p pVR R PV 4 R2, pM VR, pVPVPW4p\ V4huupiuupi)aReturns a string containing the optimization flags that needs to be used to produce code optimized for this micro-architecture. The version is expected to be a string of dot-separated digits. If there is no information on the compiler passed as an argument, the function returns an empty string. If it is known that the compiler version we want to use does not support this architecture, the function raises an exception. Args: compiler: name of the compiler to be used version: version of the compiler to be used Raises: UnsupportedMicroarchitecture: if the requested compiler does not support this micro-architecture. ValueError: if the version doesn't match the expected format rzf'{0}' compiler is known to optimize up to the '{1}' microarchitecture in the '{2}' architecture familyz^(?:\d+\.)*\d+$zXinvalid format for the compiler version argument. Only dot separated digits are allowed.cVR,PR4wr#\V4wr$\V4wr4\V4wrRpV!V4pV'dV!V4pW!8dR#V'dV!V4pW18dR#R#)versions:c\;QJd#.RVPR44FNK 5#!RVPR444#)c38"TFp\V4xK R#5ir<rY)r>ys& rrAfMicroarchitecture.optimization_flags..satisfies_constraint..tuplify..(s<^SVV^r.)tuplesplit)vers&rtuplifySMicroarchitecture.optimization_flags..satisfies_constraint..tuplify's4u.satisfies_constraints',Z'8'>'>s'C $K0 > )&*nnPnAKK8O11nPQRSKF **XK4F4FGC.s3 3xx*G449 )- -x0  2,N#N<<*73 ))&$))<#1"4"4Z"F"MM/2!((:>: ,Z /<=}!* }H= 7 (8K7LAN NC 6 6CjjH6*3//GQ|>sF;F;G) r1r3r2r'r)r&r(r#r$r%N)r)!r~ __module__ __qualname____firstlineno____doc__r rr5propertyrDrMrrVr]rargrmrrrvrrsysstdoutrrrrr staticmethodrr__static_attributes____classdictcell__)r+s@rr r $sA+&O7&7&rCC     !!00 1100 11;;"%1 & & ! !         ]0]0rr c0V^8dQhR\R\/#)r"r#r9)rr )rs"rr,r,Ps__C_,=_rc2\V.R\4/R7#)zuReturns a generic micro-architecture with no vendor and no features. Args: name: name of the micro-architecture r)r$r%r&r')r rJrs&rgeneric_microarchitecturerPs T2i#%[] ^^rcRV^8dQhR\R\\\3,/#)r"rr9)rr)rs"rr,r,Ys""""c3h"rc\P!R\V44pV'gR#VP^4pVP^4pW#3#)zDecomposes the version passed as input in version number and suffix and returns them. If the version number or the suffix are not present, an empty string is returned. Args: version: version to be decomposed into its components z([\d.]*)(-?)(.*))rr)rrrgroup)rrversion_numbersuffixs& rrrYsD HH(#g, 7E  [[^N [[^F  !!rcaV3Rlo/p\PR,pVFpW 9dK S!W!V4K \P!4pVP V\ V44V#)zReturns a dictionary of the known micro-architectures. If the current host platform is unknown, add it too as a generic target. c j<W,pVR,pVFpWR9dK S !WQV4K VUu.uFqRPV4NK ppVR,p\VR,4pVPR/4p VPR^4p VPRR4p \WWxWV R7W &R #uupi) a>Recursively fills targets by adding the micro-architecture passed as argument and all its ancestors. Args: name (str): micro-architecture to be added to targets. data (dict): raw data loaded from JSON. targets (dict): dictionary that maps micro-architecture names to ``Microarchitecture`` objects fromr%r&r'r(rr)r(r)N)rrJr ) r#rtargetsvalues parent_namesrEr$r%r&r'r(r)fill_target_from_dicts &&& rr8_known_microarchitectures..fill_target_from_dictrsf~ "F  !& 8 # 6BB\6;;v&\B!vj)*JJ{B/ ZZ a0 ::i,) 6YX`  CsB0microarchitectures)r TARGETS_JSONplatformmachinerr) known_targetsrr# host_platformrs @r_known_microarchitecturesrmsi  >M   3 4D  d-8 $$&M],Em,TU rc]tRtRtRtRtR#) ArchspecErroriz%Base class for errors within archspecr=Nr~rrrrrr=rrrrs/rrc]tRtRtRtRtR#)riz[Raised if a compiler version does not support optimization for a given micro-architecture. r=Nrr=rrrrsrrc]tRtRtRtRtR#)rizHRaised when an invalid format is used for compiler versions in archspec.r=Nrr=rrrrsRrr)rrr rrrtypingrrrrrrrr rr aliasr r rr rrrr Exceptionrrrrr=rrrs K CCC""$i0i0X _"(0h 2 30I0=* S]JSr