+ Q(i #Rt^RIHt^RIHt^RIHt^RIHt^RI H t H t ]'d^RI H t ]!RR44t]!R R 44tR R ltR RltRRltRRltRRltRRltR#)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) dataclass)total_ordering) TYPE_CHECKING)InvalidVersionVersion)FastMCPComponentcf]tRt^t$RtRtR]R&RtR]R&RtR]R&RR/R R llt R R lt R t R#) VersionSpeca~Specification 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). N str | Nonegtelteq match_noneTc$V^8dQhRRRRRR/#)versionr rboolreturn)formats"`/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/fastmcp/utilities/versions.py __annotate__VersionSpec.__annotate__-s!z$$c VfV#VPeWP8H#\V4pVPe\VP4pW48dR#VPe\VP4pW58gR#R#)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_keyr r )selfrrkeygte_keylt_keys&&$ rmatchesVersionSpec.matches-ss ?  77 gg% %( 88 '1G} 77 &tww/F<rc V^8dQhRRRR/#)rotherzVersionSpec | Nonerr r)rs"rrrNs   1  k  rc VfV#VPe0VPVP4'dV#\RR7#VPe0VPVP4'dV#\RR7#\\VPVP4\ VP VP 4R7#)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)r r )rr!r max_versionr min_versionr rr$s&&r intersectVersionSpec.intersectNs =K 77 }}TWW%% "23 3 88 ||EHH%% "23 3DHHeii0477EHH-  rr) __name__ __module__ __qualname____firstlineno____doc__r __annotations__r rr!r*__static_attributes__rrrr r s> CB B B   rr cN]tRt^qtRtR tRRltRRltRRltRR lt R t R #) 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 c V^8dQhRRRR/#)rrr rNoner)rs"rrVersionKey.__annotate__~s'' 't'rc WnVRJVnRVnRVnVeEVP R4'dVP R4MTp\ V4VnRVnR#R# \d YnR#i;i)NFvT)_raw_is_none _is_pep440_parsed startswithlstriprr)rr normalizeds&& r__init__VersionKey.__init__~sy 4 -1  070B0B30G0G,WJ '&z2 "&  " '&  's A((A=<A=c V^8dQhRRRR/#rr$objectrrr)rs"rrr7s  F t rc \V\4'g\#VP'dVP'dR#VPVP8wdR#VP'd,VP'dVP VP 8H#VP'g,VP'gVP VP 8H#R#)TF) isinstancer4NotImplementedr;r<r=r)s&&r__eq__VersionKey.__eq__s%,,! ! ===U^^^ ==ENN * ???u///<<5==0 0u'7'7'7<<5==0 0rc V^8dQhRRRR/#rDr)rs"rrr7sFtrc \V\4'g\#VP'dVP'dR#VP'dR#VP'dR#VP'dpVP'd^\VP \ 4'gQh\VP \ 4'gQhVP VP 8#VP'gpVP'g^\VP \4'gQh\VP \4'gQhVP VP 8#VP#)FT)rGr4rHr;r<r=rstrr)s&&r__lt__VersionKey.__lt__s%,,! ! ===U^^^ === >>> ???u///dllG44 44emmW55 55<<%--/ /u'7'7'7dllC00 00emmS11 11<<%--/ /rcV^8dQhRR/#)rrrMr)rs"rrr7s,,#,rc $RVP: R2#)z VersionKey())r:)rs&r__repr__VersionKey.__repr__sTYYM++r)r;r<r=r:N) r,r-r.r/r0 __slots__rArIrNrSr2rrrr4r4qs'>I' 4,,rr4c V^8dQhRRRR/#)rrr rr4r)rs"rrrs  z j rc\V4#)zParse a version string into a sortable key. Args: version: The version string, or None for unversioned. Returns: A VersionKey suitable for sorting. )r4)rs&rrrs g rc V^8dQhRRRR/#)r componentrrr4r)rs"rrrs00 00Z0rc,\VP4#)adGet a sort key for a component based on its version. Use with sorted() or max() to order components by version. Args: component: The component to get a sort key for. Returns: A sortable VersionKey. Example: ```python tools = [tool_v1, tool_v2, tool_unversioned] highest = max(tools, key=version_sort_key) # Returns tool_v2 ``` )rr)rYs&rversion_sort_keyr[s" Y.. //rc$V^8dQhRRRRRR/#)rar brintr)rs"rrrs!-- -z-c-rcH\V4p\V4pW#8W#8, #)anCompare 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)r]r^key_akey_bs&& rcompare_versionsrcs'" a E a E Mem ,,rc$V^8dQhRRRRRR/#)rr]r r^rrr)rs"rrrs! & &* & & &rc\W4^8#)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. rcr]r^s&&ris_version_greaterrhs A !A %%rc$V^8dQhRRRRRR/#rr]r r^rr)rs"rrr!33:3*33rcBVfV#VfV#\W4^8dV#T#)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. rfrgs&&rr'r'/ yy &!+122rc$V^8dQhRRRRRR/#rjr)rs"rrrrkrcBVfV#VfV#\W4^8:dV#T#)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. rfrgs&&rr(r(rmrN)r0 __future__r dataclassesr functoolsrtypingrpackaging.versionrrfastmcp.utilities.componentsrr r4rr[rcrhr'r(rrrrvsy #!$ 5= R R  R jF,F,F,R 0(-, &3"3r