i #dZddlmZddlmZddlmZddlmZddl m Z m Z erddl m Z eGdd ZeGd d Zdd Zdd ZddZddZddZddZy)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)FastMCPComponentcReZdZUdZdZded<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). N str | NonegtelteqT) match_nonec||S|j||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_keyr r)selfversionrkeygte_keylt_keys j/Users/bowang/.openclaw/workspace/ChatDev/.venv/lib/python3.12/site-packages/fastmcp/utilities/versions.pymatcheszVersionSpec.matches-sy ?  77 dgg% %( 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)r r)rrr max_versionr min_versionrrothers r intersectzVersionSpec.intersectNs =K 77 }}TWW% "23 3 88 ||EHH% "23 3DHHeii0477EHH-  r)rr rboolreturnr")r zVersionSpec | Noner#r ) __name__ __module__ __qualname____doc__r __annotations__rrrr!rrr r s5 CB B AEB  rr c4eZdZdZdZddZd 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)r/r,r-r. startswithlstriprr)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) isinstancer+NotImplementedr,r-r.rs r__eq__zVersionKey.__eq__s|%,! ! ==U^^ ==ENN * ??u//<<5==0 0u'7'7<<5==0 0rcPt|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)r7r+r8r,r-r.rstrrs r__lt__zVersionKey.__lt__s%,! ! ==U^^ == >> ??u//dllG4 44emmW5 55<<%--/ /u'7'7dllC0 00emmS1 11<<%--/ /rc"d|jdS)Nz VersionKey())r/)rs r__repr__zVersionKey.__repr__sTYYM++rN)rr r#None)r objectr#r")r#r;) r$r%r&r' __slots__r5r9r<r?r)rrr+r+qs">I' 4,rr+ct|S)zParse a version string into a sortable key. Args: version: The version string, or None for unversioned. Returns: A VersionKey suitable for sorting. )r+)rs rrrs g rc,t|jS)aGet 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) components rversion_sort_keyrFs" Y.. //rcDt|}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_versionsrLs+" a E a E EMeem ,,rc 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. rrLrHrIs ris_version_greaterrPs Aq !A %%rc8||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. rrNrOs rrr1 yy A&!+122rc8||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. rrNrOs rrrrRrN)rr r#r+)rEr r#r+)rHr rIr r#int)rHr rIr r#r")rHr rIr r#r )r' __future__r dataclassesr functoolsrtypingrpackaging.versionrrfastmcp.utilities.componentsr r r+rrFrLrPrrr)rrr[sy #!$ 5= R R  R jF,F,F,R 0(-, &3"3r