o i< @sdZddlZddlZddlmZddlmZmZmZe e Z d!de de d ed e e Bfd d Zd ede d ee e ffddZdedBd efddZd"deded e fddZ  d#de de edBdedBd e fddZ  d#de dee efde edBdedBd e f ddZgd ZdS)$z6Parameter formatting functions for OpenAPI operations.N)Any) JsonSchema ParameterInfoRequestBodyInfoFvaluesparameter_nameis_query_parameterreturnc Cs"tdd|Drddd|DSz7g}|D],}t|tr=g}|D]\}}||d|q%|d|q|t|qd|WSty}z:|rVdnd} t d | d |d ||rp|WYd }~St| d d dd dd dd} | WYd }~Sd }~ww)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) css&|]}t|ttBtBtBVqdSN) isinstancestrintfloatbool).0itemrw/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/fastmcp/experimental/utilities/openapi/formatters.py s$z)format_array_parameter..,css|]}t|VqdSr )r )rvrrrrs:.querypathzFailed to format complex array z parameter 'z': N[]'") alljoinr dictitemsappendr Exceptionloggerwarningreplace) rrr formatted_partsr item_partskre param_type str_valuerrrformat_array_parameter s8   r0 param_valuecCs^t|tstd|dt|iSi}|D]\}}|d|d}t|||<q|S)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 rr)r r#r'r(typer$r )r1rresultkeyvalue bracketed_keyrrrformat_deep_object_parameterBs r7schemac Cs|rt|ts dSd|vr|dSd|vr&t|dtr&|dr&|ddSd|vr;t|dtr;|dr;|ddSd|vrC|dS|d}|dkri}|d i}t|trt|d g}t|d d }|D]}||vr{t||||<qm|D]}||vr||vrt||||<q~|r|Sd diS|dkr|d}t|trt|} | d ur| gSgSdgS|dkr|d} | dkrdS| dkrdS| dkrdS| dkrdS| dkrdSdS|dkrdS|d krd!S|d"krd#S|d$krd Sd%S)&zy Generate a simple example value from a JSON schema dictionary. Very basic implementation focusing on types. unknowndefaultenumrexamplesexampler2object propertiesrequiredNr4r5arrayr$ example_itemstringformatz date-timez2024-01-01T12:00:00Zdatez 2024-01-01emailzuser@example.comuuidz$123e4567-e89b-12d3-a456-426614174000bytez ZXhhbXBsZQ==integerrnumberg?booleanTnull unknown_type)r r#listgetsetkeysgenerate_example_from_schema) r8 schema_typer3r?required_propsprops_to_include prop_namereq_prop items_schema item_example format_typerrrrSds          rSdataindentcCs<ztj||d}d|dWStyd|dYSw)z8Formats Python data as a JSON string block for markdown.r^z```json z ```z!``` Could not serialize to JSON: )jsondumps TypeError)r]r^json_strrrrformat_json_for_descriptions  rdbase_description parameters request_bodycCsT|g}|r%dd|D}|r%|d|D]}|d|jd|jqd|S)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. cSs g|] }|jdkr|jr|qSr)location descriptionrprrr s z-format_simple_description.. **Path Parameters:** - ****:  )r%namerjr")rerfrg desc_parts path_paramsparamrrrformat_simple_descriptions  rv responsesc s|g}|redd|D}|r5d}|||D]}|jrdnd}d|jd|d|jp,d } || qd d|D} | red }||| D]}|jrNdnd}d|jd|d|jp\d } || qG|r|jrd } || |jrvdnd}|d |j||jrd|jvrdntt|jd} | r|j| i} t| t rd| vr|d| d D]+\}}t|t rd|vr|| dgv}|rdnd}|d|d|d|dqrd}d}hd}tfdd|Dd} }t |D]\}}|s ||d}||krdnd}|d|d|d|jp"d |jrd|jvr2dntt|jd} | r|j| } |d| dt| t r| ddkrd| vr| d}t|t rd|vr|d |d D]\}}t|t rd|vr|d!|d"|dqyn.d| vr|d#| d D]\}}t|t rd|vr|d!|d"|dq| rt | }|d$kr|dur|d%|t |d&d'qd |S)(aX 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. cSg|] }|jdkr|qSrhrirkrrrrmz5format_description_with_responses..rnz (Required)rroz**z: zNo description.cSrx)rryrkrrrrmrzz **Query Parameters:**z **Request Body:**rqzapplication/jsonNr?z **Request Properties:**rjr@z **Responses:**F>200201202204c3s|] }|vr|VqdSr r)rsrwrrr5sz4format_description_with_responses..Tz (Success)z - Content-Type: ``r2rBr$z" - **Response Item Properties:**z - **rpz - **Response Properties:**rNz - **Example:**r\r_)r%r@rrrjcontent_schemanextiterrPr r#r$sortedrSrdr")rerwrfrgrsrt param_sectionrurequired_marker param_desc query_paramsreq_body_section media_typer8rW prop_schemar@req_markresponse_sectionadded_response_section success_codessuccess_statusresponses_to_process status_code resp_info status_markerrYr=rrr!format_description_with_responsess                       r)r0r7rrdrvrS)F)r\)NN)__doc__r`loggingtypingrmodelsrrr getLogger__name__r'rOr rr0r#r7rSrrdrvr__all__rrrrsj   6  "S   &