mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-18 19:44:19 +02:00
b501f05794* Switch to new OpenAPI parser as default Remove the legacy OpenAPI parser and make the experimental parser the default. The experimental parser (introduced in 2.11) offers better performance, improved compatibility, and a more maintainable architecture. - Delete legacy parser (server/openapi.py, utilities/openapi.py) - Move experimental parser to main locations - Remove enable_new_openapi_parser feature flag - Update documentation to remove experimental references * Add deprecation stubs for experimental OpenAPI imports * Add deprecated enable_new_openapi_parser setting and deprecation tests * SDK docs * REview comments * Fix docstrings * Update docstring * Review comments * Fix broken links
73 lines
2.9 KiB
Python
73 lines
2.9 KiB
Python
"""Tests for OpenAPI-related deprecations in 2.14."""
|
|
|
|
import warnings
|
|
|
|
import pytest
|
|
|
|
import fastmcp
|
|
|
|
pytestmark = pytest.mark.filterwarnings("default::DeprecationWarning")
|
|
|
|
|
|
class TestEnableNewOpenAPIParserDeprecation:
|
|
"""Test enable_new_openapi_parser setting deprecation."""
|
|
|
|
def test_setting_true_emits_warning(self):
|
|
"""Setting enable_new_openapi_parser=True should emit deprecation warning."""
|
|
with pytest.warns(
|
|
DeprecationWarning,
|
|
match=r"enable_new_openapi_parser is deprecated.*now the default",
|
|
):
|
|
fastmcp.settings.experimental.enable_new_openapi_parser = True
|
|
|
|
def test_setting_false_no_warning(self):
|
|
"""Setting enable_new_openapi_parser=False should not emit warning."""
|
|
with warnings.catch_warnings(record=True) as recorded:
|
|
warnings.simplefilter("always")
|
|
fastmcp.settings.experimental.enable_new_openapi_parser = False
|
|
|
|
deprecation_warnings = [
|
|
w for w in recorded if issubclass(w.category, DeprecationWarning)
|
|
]
|
|
assert len(deprecation_warnings) == 0
|
|
|
|
|
|
class TestExperimentalOpenAPIImportDeprecation:
|
|
"""Test experimental OpenAPI import path deprecations."""
|
|
|
|
def test_experimental_server_openapi_import_warns(self):
|
|
"""Importing from fastmcp.experimental.server.openapi should warn."""
|
|
with pytest.warns(
|
|
DeprecationWarning,
|
|
match=r"Importing from fastmcp\.experimental\.server\.openapi is deprecated",
|
|
):
|
|
from fastmcp.experimental.server.openapi import FastMCPOpenAPI # noqa: F401
|
|
|
|
def test_experimental_utilities_openapi_import_warns(self):
|
|
"""Importing from fastmcp.experimental.utilities.openapi should warn."""
|
|
with pytest.warns(
|
|
DeprecationWarning,
|
|
match=r"Importing from fastmcp\.experimental\.utilities\.openapi is deprecated",
|
|
):
|
|
from fastmcp.experimental.utilities.openapi import HTTPRoute # noqa: F401
|
|
|
|
def test_experimental_imports_resolve_to_same_classes(self):
|
|
"""Experimental imports should resolve to the same classes as main imports."""
|
|
with warnings.catch_warnings():
|
|
warnings.simplefilter("ignore")
|
|
|
|
from fastmcp.experimental.server.openapi import (
|
|
FastMCPOpenAPI as ExpFastMCPOpenAPI,
|
|
)
|
|
from fastmcp.experimental.server.openapi import MCPType as ExpMCPType
|
|
from fastmcp.experimental.server.openapi import RouteMap as ExpRouteMap
|
|
from fastmcp.experimental.utilities.openapi import (
|
|
HTTPRoute as ExpHTTPRoute,
|
|
)
|
|
from fastmcp.server.openapi import FastMCPOpenAPI, MCPType, RouteMap
|
|
from fastmcp.utilities.openapi import HTTPRoute
|
|
|
|
assert FastMCPOpenAPI is ExpFastMCPOpenAPI
|
|
assert RouteMap is ExpRouteMap
|
|
assert MCPType is ExpMCPType
|
|
assert HTTPRoute is ExpHTTPRoute
|