k7i< RSrSSKrSSKrSSKJr SSKJrJrJr \R"\ 5r SS\ S\ S\S \ \ -4S jjrS \S\ S \\ \ 44S jrS \S-S \4SjrSS\S\S \ 4SjjrSS\ S\ \S-S\S-S \ 4SjjrSS\ S\\ \4S\ \S-S\S-S \ 4 Sjjr/SQrg)z6Parameter formatting functions for OpenAPI operations.N)Any) JsonSchema ParameterInfoRequestBodyInfovaluesparameter_nameis_query_parameterreturnc [SU55(aSRSU55$/nUHn[U[5(aS/nUR 5HupgUR USU35 M UR SRU55 MkUR [ U55 M SRU5$![anU(aSOSn [RSU S US U35 U(aUsS nA$[ U5RS S 5RSS 5RSS 5RSS 5n U sS nA$S nAff=f)aJ Format an array parameter according to OpenAPI specifications. Args: values: List of values to format parameter_name: Name of the parameter (for error messages) is_query_parameter: If True, can return list for explode=True behavior Returns: String (comma-separated) or list (for query params with explode=True) c3l# UH*n[U[[-[-[-5v M, g7fN) isinstancestrintfloatbool).0items k/home/james-whalen/.local/lib/python3.13/site-packages/fastmcp/experimental/utilities/openapi/formatters.py )format_array_parameter..s( I&$:dC#I-4 5 5&s24,c38# UHn[U5v M g7fr)r)rvs rrrs/1As:.querypathzFailed to format complex array z parameter 'z': N[]'") alljoinrdictitemsappendr Exceptionloggerwarningreplace) rr r formatted_partsr item_partskre param_type str_values rformat_array_parameterr4 sC I& IIIxx//// D$%%  JJLDA%%1QCj1)&&sxx ';<&&s4y1xx((  2W -j\nEUUXYZX[ \  MF b!b!b!b!  %s+BC E'1E" E'A E"E'"E' param_valuec[U[5(d&[RSUS[ U535 0$0nUR 5Hup4USUS3n[ U5X%'M U$)a Format a dictionary parameter for deepObject style serialization. According to OpenAPI 3.0 spec, deepObject style with explode=true serializes object properties as separate query parameters with bracket notation. For example: {"id": "123", "type": "user"} becomes: param[id]=123¶m[type]=user Args: param_value: Dictionary value to format parameter_name: Name of the parameter Returns: Dictionary with bracketed parameter names as keys zdeepObject style parameter 'z' expected dict, got r r")rr'r+r,typer(r)r5r resultkeyvalue bracketed_keys rformat_deep_object_parameterr<Bs~& k4 ( (*>*::OPTU`PaOb c  F!'') )*!C52 #E * MschemacU(a[U[5(dgSU;aUS$SU;a*[US[5(aUS(aUSS$SU;a*[US[5(aUS(aUSS$SU;aUS$URS5nUS:Xa0nURS 05n[U[5(a|[ URS /55n[UR 55S S nUHnXc;dM [ X65X&'M UH nXr;dM Xs;dM[ X75X''M" U(aU$S S0$US:Xa<URS5n[U[5(a[ U5n U bU /$/$S/$US:Xa5URS5n U S:XagU S:XagU S:XagU S:XagU S:XaggUS:XagUS :Xag!US":Xag#US$:Xag g%)&zm Generate a simple example value from a JSON schema dictionary. Very basic implementation focusing on types. unknowndefaultenumrexamplesexampler7object propertiesrequiredNr9r:arrayr( example_itemstringformatz date-timez2024-01-01T12:00:00Zdatez 2024-01-01emailzuser@example.comuuidz$123e4567-e89b-12d3-a456-426614174000bytez ZXhhbXBsZQ==integerrnumberg?booleanTnull unknown_type)rr'listgetsetkeysgenerate_example_from_schema) r> schema_typer8rFrequired_propsprops_to_include prop_namereq_prop items_schema item_example format_types rrZrZds4 FD11Fi   Jvf~t<<f~a   f vj)4 0 0 : j!!$$Fi  **V$KhZZ b1 j$ ' ' J!; E2 E  jj* + %) &  ' !% & 9 & !  !    !   r=dataindentcd[R"XS9nSUS3$![a SUS3s$f=f)z8Formats Python data as a JSON string block for markdown.rdz```json z ```z!``` Could not serialize to JSON: )jsondumps TypeError)rcrdjson_strs rformat_json_for_descriptionrksE@::d28*E** @3D6??@s //base_description parameters request_bodycFU/nU(aUVs/sH)oDRS:XdMUR(dM'UPM+ nnU(aEURS5 UH.nURSURSUR35 M0 SR U5$s snf)a Formats a simple description for MCP objects (tools, resources, prompts). Excludes response details, examples, and verbose status codes. Args: base_description (str): The initial description to be formatted. parameters (list[ParameterInfo] | None, optional): A list of parameter information. request_body (RequestBodyInfo | None, optional): Information about the request body. Returns: str: The formatted description string with minimal details. r **Path Parameters:** - ****:  )location descriptionr)namer&)rlrmrn desc_partsp path_paramsparams rformat_simple_descriptionr{s"##J",W*Q f0Dqq* W    8 9$!!F5::,d5;L;L:M"NO% 99Z  XsBBB responsesc  ^U/nU(Ga(UVs/sHoURS:XdMUPM nnU(ajSnURU5 UHQnUR(aSOSn SURSU SUR=(d S3n URU 5 MS UVs/sHoURS :XdMUPM n nU (ajS nURU5 U HQnUR(aSOSn SURSU SUR=(d S3n URU 5 MS U(GacUR(GaQS n URU 5 UR(aSOSn URS URU 35 UR (aS UR ;aS O[ [UR 5S5n U (aUR RU 05n[U[5(aSU;aURS5 USR5Haunn[U[5(dMSU;dM%XRS/5;nU(aSOSnURSUSUSUS35 Mc T(GaSnSn1Skn[ U4SjU5S5nTR5n[U5GHIunnU(dURU5 SnUU:XaSOSnURSUSUSUR=(d S35 UR (dMkS UR ;aS O[ [UR 5S5n U (dMUR RU 5nURSU S35 [U[5(GaURS5S:XaSU;aUSn[U[5(amSU;agURS5 USR5H?unn[U[5(dMSU;dM%URSUS US35 MA OmSU;agURS!5 USR5H?unn[U[5(dMSU;dM%URSUS US35 MA U(dGM[U5nUS":wdGMUcGMURS#5 UR[US$S%95 GML S RU5$s snfs snf)&a$ Formats the base description string with response, parameter, and request body information. Args: base_description (str): The initial description to be formatted. responses (dict[str, Any]): A dictionary of response information, keyed by status code. parameters (list[ParameterInfo] | None, optional): A list of parameter information, including path and query parameters. Each parameter includes details such as name, location, whether it is required, and a description. request_body (RequestBodyInfo | None, optional): Information about the request body, including its description, whether it is required, and its content schema. Returns: str: The formatted description string with additional details about responses, parameters, and the request body. rrpz (Required)r!rqz**z: zNo description.rz **Query Parameters:**z **Request Body:**rszapplication/jsonNrFz **Request Properties:**rurGz **Responses:**F>200201202204c36># UHoT;dM Uv M g7fr)rsr|s rr4format_description_with_responses..5sJ-Q >qq-s  Tz (Success)z - Content-Type: ``r7rIr(z" - **Response Item Properties:**z - **rrz - **Response Properties:**rUz - **Example:**rf)rtr)rGrvrucontent_schemanextiterrWrr'r(sortedrZrkr&)rlr|rmrnrwrxry param_sectionrzrequired_marker param_desc query_paramsreq_body_section media_typer>r^ prop_schemarGreq_markresponse_sectionadded_response_section success_codessuccess_statusresponses_to_process status_code resp_info status_markerr`rDs ` r!format_description_with_responsesrs0##J",E*Q f0Dq* E 6M   m ,$38>>-r%ejj\O3DBuGXGXGm\mFno !!*-% $.G:aw1F: G 7M   m ,%38>>-r%ejj\O3DBuGXGXGm\mFno !!*-&  0002*++7+@+@-bB|7788IJK  & &&)D)DD#$|::;TB  %4488RHfd++ 0F%%&CD282F2L2L2N. ;&{D99 - <'0JJz24N'NH8@}bH&--"( 2hZr+mB\A] ^3O/!&5 J-JDQ )0&,-A&B "K)!!"23)-&,7>,ILrM    R b9N9N9cRc8de  '''*Y-E-EE'd9#;#; >$0L$@ * 1 12W X>J$0?""'%'?*$:I{)3;(E(E,9[,H(2(9(9.8 4 TaHbGc,d)*?**V3&--.NO:@:N:T:T:V 6 ;$.{D$A$A(5(D$.$5$5*4YKtKP]D^C_(`%& ;Wv">v"F"n49L&--.BC&-- ;GA Ny'C@ 99Z  yFHsUU%U<U)r4r<rrkr{rZ)F)r)NN)__doc__rgloggingtypingrmodelsrrr getLogger__name__r+rVrrr4r'r<rZrrkr{r__all__rr=rrs]< >>   8 $CH3 3"%3;?34Z3l'* #s(^DPd):PsPf@c@3@s@.2+/!!]#d*!"D(! !L.2+/ Y!Y! SY! ]#d* Y! "D( Y! Y!z r=