oas2mcp.normalize
=================

.. py:module:: oas2mcp.normalize

.. autoapi-nested-parse::

   Normalization helpers for ``oas2mcp``.

   Purpose:
       Convert parsed OpenAPI specifications into stable internal Pydantic models.

   Design:
       - Keep normalization logic separate from loading and rendering.
       - Accept either LangChain ``OpenAPISpec`` objects or dumped spec
         dictionaries.
       - Produce ``ApiCatalog`` objects that are easy to inspect, enrich,
         and eventually transform into MCP-oriented structures.

   .. attribute:: __all__

      Curated public exports for normalization helpers.

   .. rubric:: Examples

   .. code-block:: python

       from oas2mcp.normalize import openapi_spec_to_catalog
       from oas2mcp.loaders import load_openapi_spec_from_url

       spec = load_openapi_spec_from_url(
           "https://petstore3.swagger.io/api/v3/openapi.json",
       )
       catalog = openapi_spec_to_catalog(
           spec,
           source_uri="https://petstore3.swagger.io/api/v3/openapi.json",
       )



Submodules
----------

.. toctree::
   :maxdepth: 1

   /autoapi/oas2mcp/normalize/spec_to_catalog/index