k7i3SrSSKJr SSKrSSKrSSKJr SSKJr SSK J r SSK J r SSK JrJr SS KJr SS KJrJr SS KJr SS KJr \"\5r"S S5rg)zResource manager functionality.) annotationsN)Callable)Any)AnyUrl)settings) NotFoundError ResourceError)Resource)ResourceTemplatematch_uri_template)DuplicateBehavior) get_loggerc\rSrSrSrSSSjjrSSjrSSjrSSSjjrSSSjjr SS jr SSS jjr SS jr SS jr SS jrSSjrSrg)ResourceManagerzManages FastMCP resources.Nc0Ul0UlU=(d [RUlUcSnU[R ;a.[ SUSSR[R 535eXlg)zInitialize the ResourceManager. Args: duplicate_behavior: How to handle duplicate resources (warn, error, replace, ignore) mask_error_details: Whether to mask error details from exceptions other than ResourceError NwarnzInvalid duplicate_behavior: z. Must be one of: z, ) _resources _templatesrmask_error_detailsr __args__ ValueErrorjoinduplicate_behavior)selfrrs \/home/james-whalen/.local/lib/python3.13/site-packages/fastmcp/resources/resource_manager.py__init__ResourceManager.__init__s0279"4"S8S8S  %!'  %6%?%? ?./A.BC##'99->-G-G#H"IK #5c4# [UR5$7f)z+Get all registered resources, keyed by URI.)dictrrs r get_resourcesResourceManager.get_resources8DOO$$c4# [UR5$7f)z4Get all registered templates, keyed by URI template.)r!rr"s rget_resource_templates&ResourceManager.get_resource_templates<r%r&cN^ SSKJm SU;=(a SU;n[U 4Sj[R"U5R R 555nU(dU(aURXX4XV5$U(dU(dURXX4XV5$[S5e)aCAdd a resource or template to the manager from a function. Args: fn: The function to register as a resource or template uri: The URI for the resource or template name: Optional name for the resource or template description: Optional description of the resource or template mime_type: Optional MIME type for the resource or template tags: Optional set of tags for categorizing the resource or template Returns: The added resource or template. If a resource or template with the same URI already exists, returns the existing resource or template. r)Context{}c3J># UHnURTLdMUv M g7f)N) annotation).0pr+s r CResourceManager.add_resource_or_template_from_fn..\s& >||7* A>s# #ziInvalid resource or template definition due to a mismatch between URI parameters and function parameters.) fastmcp.server.contextr+anyinspect signature parametersvaluesadd_template_from_fnadd_resource_from_fnr) rfnuriname description mime_typetagshas_uri_paramshas_func_paramsr+s @r add_resource_or_template_from_fn0ResourceManager.add_resource_or_template_from_fn@s. 32s  &&r*55<<>   _,,I  ,,I K rc [R(a[R"S[SS9 [ R "UUUUUUS9nURU5$)aAdd a resource to the manager from a function. Args: fn: The function to register as a resource uri: The URI for the resource name: Optional name for the resource description: Optional description of the resource mime_type: Optional MIME type for the resource tags: Optional set of tags for categorizing the resource Returns: The added resource. If a resource with the same URI already exists, returns the existing resource. zaadd_resource_from_fn is deprecated. Use Resource.from_function() and call add_resource() instead. stacklevel)r<r=r>r?r@rA)rdeprecation_warningswarningsrDeprecationWarningr from_function add_resource)rr<r=r>r?r@rAresources rr;$ResourceManager.add_resource_from_fnpsY0  ( ( MMs"  ))#    **rcURRUR5nU(aURS:Xa;[R SUR35 XRUR'OcURS:XaXRUR'O:URS:Xa[ SUR35eURS:XaU$XRUR'U$)zAdd a resource to the manager. Args: resource: A Resource instance to add. The resource's .key attribute will be used as the storage key. To overwrite it, call Resource.model_copy(key=new_key) before calling this method. rzResource already exists: replaceerrorignore)rgetkeyrloggerwarningr)rrOexistings rrNResourceManager.add_resources??&&x||4 &&&0!:8<<.IJ08 -((I508 -((G3 #r?r@rA)rrJrKrrLr rM add_template)rr<r\r>r?r@rAtemplates rr:$ResourceManager.add_template_from_fnsY  ( ( MM{"  $11 %#    **rcURRUR5nU(aURS:Xa;[R SUR35 XRUR'OcURS:XaXRUR'O:URS:Xa[ SUR35eURS:XaU$XRUR'U$)awAdd a template to the manager. Args: template: A ResourceTemplate instance to add. The template's .key attribute will be used as the storage key. To overwrite it, call ResourceTemplate.model_copy(key=new_key) before calling this method. Returns: The added template. If a template with the same URI already exists, returns the existing template. rzTemplate already exists: rRrSrT)rrUrVrrWrXr)rr^rYs rr]ResourceManager.add_templates??&&x||4 &&&0!:8<<.IJ08 -((I508 -((G3 #N"7f)zCheck if a resource exists.NTF)strr#r(r )rr=uri_str resources templates template_keys r has_resourceResourceManager.has_resourcesdc(,,..  5577 %L!'88&/ 8s&A$A A$A"A$A$"A$c# [U5n[RSSU0S9 UR5IShvN nUR U5=n(aU$UR 5IShvN nUR 5H2upg[X&5=n(dMURUUS9IShvN s $ [SU35eNNZN![an [RSU 35 U eSn A f[aIn [RSU 35 UR(a [S5U e[SU 35U eSn A ff=f7f) zGet resource by URI, checking concrete resources first, then templates. Args: uri: The URI of the resource to get Raises: NotFoundError: If no resource or template matching the URI is found. zGetting resourcer=)extraNparamsz'Error creating resource from template: z%Error creating resource from templatezUnknown resource: )rcrWdebugr#rUr(itemsr create_resourcer rS Exceptionrrr) rr=rdrerOrf storage_keyr^rmes r get_resourceResourceManager.get_resourcesPc( 'w/? @,,..  }}W- -8 -O5577 %.__%6 !K+GAAvA!!)!9!9%":" &700 :;;=/ 8  %LL#J1#!NOG !LL#J1#!NO..()PQWXX)EaSI ! !sd5EC1E)C*)EC+C,C/EEC EC,, E9AD==EEc# [U5nX R;a2URU5IShvN nUR5IShvN $URR5HIupV[X%5=n(dMURX'S9IShvN nUR5IShvN s $ [SU<S35eNN}![a n[ R SU<35 UeSnAf[aRn[ R SU<35 UR(a[ SU<35Ue[ SU<SU35UeSnAff=fNN![a n[ R SU<35 UeSnAf[aRn[ R SU<35 UR(a[ SU<35Ue[ SU<SU35UeSnAff=f7f)z^ Internal API for servers: Finds and reads a resource, respecting the filtered protocol path. NzError reading resource z: rlz%Error reading resource from template z Resource z not found.)rcrrtreadr rW exceptionrqrrror rpr)rr=rdrOrsrVr^rms r read_resourceResourceManager.read_resource!s c( oo %!..w77H %]]_,,("__224MC+G99v9!%-%=%=g%=%UUH!)00 5.i{+>??[8,!   #:7+!FG   #:7+!FG**'*A'(MNTUU(1'BqcB  V0$$$?{KG !$$?{K..+CG;O !,CG;bQRPST ! !s/GCGC C C 0GEEE-E.E1GC EC// E str | Noner?r}r@r}rAset[str] | Noner{zResource | ResourceTemplate)r<r|r=rcr>r}r?r}r@r}rAr~r{r )rOr r{r )r<r|r\rcr>r}r?r}r@r}rAr~r{r )r^r r{r )r= AnyUrl | strr{bool)r=rr{r )r=rr{z str | bytes)__name__ __module__ __qualname____firstlineno____doc__rr#r(rDr;rNr:r]rhrtry__static_attributes__rrrrsP$8<*.545(58%% "& $ $. .. .  .  .. %.h "& $ $&+ &+&+ &+  &+  &+&+ &+P4 "& $ $+ ++ +  +  ++ +64"+rsH%"$;//0 H ~@~@r