$j-)dZddlmZddlmZmZddlmZddlm Z ddl m Z m Z m Z mZddlmZmZe rddlmZe d e ZeGd d Ze Gd dZd%dZd&dZd'dZd(dZd)dZd)dZd*d#Zd$S)+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_CHECKINGAnyTypeVarcast)InvalidVersionVersion)FastMCPComponentC)boundcTeZdZUdZdZded<dZded<dZded<dddd ZddZ dS) 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_noneversionrboolreturnc||S|j ||jkSt|}|jt|j}||krdS|jt|j}||ksdSdS)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. NFT)rparse_version_keyrr)selfrrkeygte_keylt_keys b/home/rurouni/.hermes/hermes-agent/venv/lib/python3.11/site-packages/fastmcp/utilities/versions.pymatcheszVersionSpec.matches0s ?  7 dg% %(( 8 '11GW}}u 7 &tw//F<<utotherVersionSpec | NonecX||S|j,||jr|StdS|j,||jr|StdStt|j|jt |j|jS)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. N__impossible__)r)rr)rr"r max_versionr min_versionrrr$s r! intersectzVersionSpec.intersectQs =K 7 }}TW%%  "2333 3 8 ||EH%%  "2333 3DHei0047EH--    r#)rrrrrr)r$r%rr) __name__ __module__ __qualname____doc__r__annotations__rrr"r+r#r!rrs  CBBAEB       r#rc6eZdZdZdZddZdd Zdd ZddZdS) 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_rawrrrNonec ||_|du|_d|_d|_|b|dr|dn|} t ||_d|_dS#t$r ||_YdSwxYwdS)NFvT)r7r4r5r6 startswithlstripr r )rr normalizeds r!__init__zVersionKey.__init__s 4 -1  070B0B30G0GT,,,WJ '&z22 "&! ' ' '&  '  sA++B?Br$objectrct|tstS|jr |jrdS|j|jkrdS|jr|jr|j|jkS|js|js|j|jkSdS)NTF) isinstancer3NotImplementedr4r5r6r*s r!__eq__zVersionKey.__eq__s%,, "! ! = U^ 4 =EN * *5 ? 1u/ 1<5=0 0 1u'7 1<5=0 0ur#ct|tstS|jr |jrdS|jrdS|jrdS|jrO|jrHt|jt sJt|jt sJ|j|jkS|jsO|jsHt|jtsJt|jtsJ|j|jkS|jS)NFT)rAr3rBr4r5r6r strr*s r!__lt__zVersionKey.__lt__s%,, "! ! = U^ 5 = 4 > 5 ? 0u/ 0dlG44 4 44emW55 5 55<%-/ / 0u'7 0dlC00 0 00emS11 1 11<%-/ /r#rEcd|jdS)Nz VersionKey())r7)rs r!__repr__zVersionKey.__repr__s+TY++++r#N)rrrr8)r$r?rr)rrE) r,r-r.r/ __slots__r>rCrFrIr1r#r!r3r3tsu>I''''    4,,,,,,r#r3rrrc t|S)zParse a version string into a sortable key. Args: version: The version string, or None for unversioned. Returns: A VersionKey suitable for sorting. )r3rs r!rrs g  r# componentrc*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)rMs r!version_sort_keyrOs" Y. / //r#abintcXt|}t|}||k||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)rPrQkey_akey_bs r!compare_versionsrVs1" a E a E EMeem ,,r#rc*t||dkS)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. rrVrPrQs r!is_version_greaterrZs Aq ! !A %%r#cB||S||St||dkr|n|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. NrrXrYs r!r(r(6 yy A&&!++112r#cB||S||St||dkr|n|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. NrrXrYs r!r)r)r\r# components Sequence[C]key_fnCallable[[C], str]list[C]c i}|D]4}|||g|5g}|D]}ttt |t }td|Drbtd|Dtd}|j pi}| di|di| did|iii }|||S) 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. )rc3(K|] }|jduVdSNrL.0cs r! z'dedupe_with_versions..:s)77qy$777777r#c*g|]}|j |jSrerLrfs r! z(dedupe_with_versions..<s!FFFq 0E0E0E0Er#T)rreversemetafastmcpversions)update) setdefaultappendvaluesr rmaxrOanysortedrrm model_copyget) r^r`by_keyrhresultrohighest all_versionsrms r!dedupe_with_versionsr}#sZ "$F 33&&))R((//2222FMMOO!S/?@@@AA 77h777 7 7 !FFHFFF%L <%2D((!$"hhy"55$& $$)  G  g Mr#N)rrrr3)rMrrr3)rPrrQrrrR)rPrrQrrr)rPrrQrrr)r^r_r`rarrb)r/ __future__rcollections.abcrr dataclassesr functoolsrtypingrr r r packaging.versionr r fastmcp.utilities.componentsrrrr3rrOrVrZr(r)r}r1r#r!rs  #"""""........!!!!!!$$$$$$44444444444455555555>====== GCs R R R R R R R  R jF,F,F,F,F,F,F,F,R    0000(----, & & & &3333"3333"******r#