kKj-dZddlmZddlmZmZddlmZddlm Z ddl m Z m Z m Z ddlmZmZe rddlmZe d e ZeGd d Ze Gd dZddZddZddZddZddZddZ ddZy)uFVersion comparison utilities for component versioning. This module provides utilities for comparing component versions. Versions are strings that are first attempted to be parsed as PEP 440 versions (using the `packaging` library), falling back to lexicographic string comparison. Examples: - "1", "2", "10" → parsed as PEP 440, compared semantically (1 < 2 < 10) - "1.0", "2.0" → parsed as PEP 440 - "v1.0" → 'v' prefix stripped, parsed as "1.0" - "2025-01-15" → not valid PEP 440, compared as strings - None → sorts lowest (unversioned components) ) annotations)CallableSequence) dataclass)total_ordering) TYPE_CHECKINGAnyTypeVar)InvalidVersionVersion)FastMCPComponentC)boundcReZdZUdZdZded<dZded<dZded<ddd d Zd d Z y) VersionSpecaSpecification for filtering components by version. Used by transforms and providers to filter components to a specific version or version range. Unversioned components (version=None) always match any spec. Args: gte: If set, only versions >= this value match. lt: If set, only versions < this value match. eq: If set, only this exact version matches (gte/lt ignored). Matching is PEP 440-normalized and `v`-prefix insensitive, so `eq="v1.0"` matches a component versioned `"1.0"`, and `eq="1.0"` matches `"1"` (PEP 440 treats `1` and `1.0` as the same version). If a server registers two PEP 440-equivalent spellings of the same component (e.g. both `"1"` and `"1.0"`), they are the same version under this spec; selection among them is deterministic (see `version_sort_key`), not registration-order dependent. N str | NonegtelteqT) match_nonec||S|j!t|t|jk(St|}|jt|j}||kry|jt|j}||ksyy)aCheck if a version matches this spec. Args: version: The version to check, or None for unversioned. match_none: Whether unversioned (None) components match. Defaults to True for backward compatibility with retrieval operations. Set to False when filtering (e.g., enable/disable) to exclude unversioned components from version-specific rules. Returns: True if the version matches the spec. FT)rparse_version_keyrr)selfversionrkeygte_keylt_keys k/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/fastmcp/utilities/versions.pymatcheszVersionSpec.matches7s ?  77 $W-1B4771KK K( 88 '1GW} 77 &tww/F<cp||S|j)|j|jr|StdS|j)|j|jr|StdStt|j|jt |j |j S)aReturn a spec that satisfies both this spec and other. Used by transforms to combine caller constraints with filter constraints. For example, if a VersionFilter has lt="3.0" and caller requests eq="1.0", the intersection validates "1.0" is in range and returns the exact spec. Args: other: Another spec to intersect with, or None. Returns: A VersionSpec that matches only versions satisfying both specs. __impossible__)r)rr)rrr max_versionr min_versionrrothers r intersectzVersionSpec.intersectXs =K 77 }}TWW% "23 3 88 ||EHH% "23 3DHHeii0477EHH-  r )rrrboolreturnr()r&zVersionSpec | Noner)r) __name__ __module__ __qualname____doc__r__annotations__rrrr'r rrrs5&CB B AEB  r rc4eZdZdZdZddZd dZd dZd dZy) VersionKeya:A comparable version key that handles None, PEP 440 versions, and strings. Comparison order: 1. None (unversioned) sorts lowest 2. PEP 440 versions sort by semantic version order 3. Invalid versions (strings) sort lexicographically 4. When comparing PEP 440 vs string, PEP 440 comes first )_is_none _is_pep440_parsed_rawc||_|du|_d|_d|_|=|j dr|j dn|} t ||_d|_yy#t$r ||_YywxYw)NFvT)r5r2r3r4 startswithlstripr r )rr normalizeds r__init__zVersionKey.__init__sz 4 -1  070B0B30G,WJ '&z2 "&  " '&  'sAA21A2cZt|tstS|jr |jry|j|jk7ry|jr%|jr|j |j k(S|js%|js|j |j k(Sy)NTF) isinstancer1NotImplementedr2r3r4r%s r__eq__zVersionKey.__eq__s|%,! ! ==U^^ ==ENN * ??u//<<5==0 0u'7'7<<5==0 0r cPt|tstS|jr |jry|jry|jry|jr]|jrQt|j t sJt|j t sJ|j |j kS|js]|jsQt|j tsJt|j tsJ|j |j kS|jS)NFT)r=r1r>r2r3r4r strr%s r__lt__zVersionKey.__lt__s%,! ! ==U^^ == >> ??u//dllG4 44emmW5 55<<%--/ /u'7'7dllC0 00emmS1 11<<%--/ /r c"d|jdS)Nz VersionKey())r5)rs r__repr__zVersionKey.__repr__sTYYM++r N)rrr)None)r&objectr)r()r)rA) r*r+r,r- __slots__r;r?rBrEr/r rr1r1{s">I' 4,r r1ct|S)zParse a version string into a sortable key. Args: version: The version string, or None for unversioned. Returns: A VersionKey suitable for sorting. )r1rs rrrs g r cLt|j|jxsdfS)aGet a sort key for a component based on its version. Use with sorted() or max() to order components by version. The key is a `(VersionKey, raw)` tuple. The `VersionKey` orders by PEP 440 semantics (or lexicographically for non-PEP 440 strings); the raw version string is a deterministic tie-breaker so that two components whose versions are PEP 440-equivalent but spelled differently (e.g. `"1"` and `"1.0"`) are ordered reproducibly instead of by registration order. The raw tie-breaker only affects equivalent-version ties and never the primary version order, so range/equality matching (which uses `VersionKey` directly) is unchanged. Args: component: The component to get a sort key for. Returns: A deterministic, sortable `(VersionKey, raw)` tuple. Example: ```python tools = [tool_v1, tool_v2, tool_unversioned] highest = max(tools, key=version_sort_key) # Returns tool_v2 ``` )rr) components rversion_sort_keyrNs%2 i// 0)2C2C2Ir JJr cDt|}t|}||kD||kz S)aCompare two version strings. Args: a: First version string (or None). b: Second version string (or None). Returns: -1 if a < b, 0 if a == b, 1 if a > b. Example: ```python compare_versions("1.0", "2.0") # Returns -1 compare_versions("2.0", "1.0") # Returns 1 compare_versions(None, "1.0") # Returns -1 (None < any version) ``` )r)abkey_akey_bs rcompare_versionsrTs+" a E a E EMeem ,,r c t||dkDS)zCheck if version a is greater than version b. Args: a: First version string (or None). b: Second version string (or None). Returns: True if a > b, False otherwise. rrTrPrQs ris_version_greaterrXs Aq !A %%r c8||S||St||dk\r|S|S)zReturn the greater of two versions. Args: a: First version string (or None). b: Second version string (or None). Returns: The greater version, or None if both are None. rrVrWs rr#r#1 yy A&!+122r c8||S||St||dkr|S|S)zReturn the lesser of two versions. Args: a: First version string (or None). b: Second version string (or None). Returns: The lesser version, or None if both are None. rrVrWs rr$r$!rZr c i}|D])}|j||gj|+g}|jD]}t|t}t d|Drwt |Dcgc]}|j|jc}td}|jxsi}|jdi|di|jdid|iii}|j||Scc}w) aDeduplicate components by key, keeping highest version. Groups components by key, selects the highest version from each group, and injects available versions into meta if any component is versioned. Args: components: Sequence of components to deduplicate. key_fn: Function to extract the grouping key from a component. Returns: Deduplicated list with versions injected into meta. )rc38K|]}|jduyw)NrJ).0cs r z'dedupe_with_versions..Is7hqyy$hsT)rreversemetafastmcpversions)update) setdefaultappendvaluesmaxrNanysortedrrrb model_copyget) componentskey_fnby_keyr_resultrdhighest all_versionsrbs rdedupe_with_versionsrt2s "$F &)R(//2FMMO'78 7h7 7!$,FHq 0EHF%L <<%2D((!$"hhy"5$& $) G  g)$* M#Gs 2C5 C5 N)rrr)r1)rMr r)ztuple[VersionKey, str])rPrrQrr)int)rPrrQrr)r()rPrrQrr)r)rnz Sequence[C]rozCallable[[C], str]r)zlist[C])r- __future__rcollections.abcrr dataclassesr functoolsrtypingrr r packaging.versionr r fastmcp.utilities.componentsr rrr1rrNrTrXr#r$rtr/r rr}s #.!$..5= Cs Y Y  Y xF,F,F,R K8-, &3"3"** * *r