Files
dify/api/tests/unit_tests/controllers/openapi/test_device_code.py
GareArc 2a38df2b7f refactor(api): consolidate openapi/oauth_device into per-domain modules
Match the existing api-group convention: one module per resource family
with multiple Resource classes per file (cf service_api/dataset/dataset.py
with 7 routes, console/auth/oauth_device.py with 2 before this branch).

The Phase B-D fragmentation (one file per route under
controllers/openapi/oauth_device/) was inconsistent with the codebase.
Collapse into:

  controllers/openapi/oauth_device.py        (5 routes: code, token,
                                              lookup, approve, deny —
                                              account branch)
  controllers/openapi/oauth_device_sso.py    (4 routes: sso-initiate,
                                              sso-complete,
                                              approval-context,
                                              approve-external —
                                              EE-only SSO branch)

The split mirrors the original pre-migration layout: account branch in
console/auth/oauth_device.py, SSO branch in controllers/oauth_device_sso.py
(root). Both legacy mount files updated to import from the new modules.

No behavior change; 59 tests still green. Test files updated to import
from the consolidated module paths.

Plan: docs/superpowers/plans/2026-04-26-openapi-migration.md (in difyctl repo).
2026-04-27 00:07:15 -07:00

82 lines
2.7 KiB
Python

"""Phase B step 6: POST /openapi/v1/oauth/device/code is the canonical
RFC 8628 device authorization endpoint. The legacy /v1/oauth/device/code
mount stays until Phase F; both paths must dispatch to the same class.
Tests verify URL routing and re-registration without invoking the
handler — invoking would require Redis, which the unit-test runtime
does not initialise.
"""
import builtins
import pytest
from flask import Flask
from flask.views import MethodView
from controllers.openapi import bp as openapi_bp
from controllers.openapi.oauth_device import OAuthDeviceCodeApi
from controllers.service_api import bp as service_api_bp
if not hasattr(builtins, "MethodView"):
builtins.MethodView = MethodView # type: ignore[attr-defined]
@pytest.fixture
def dual_app() -> Flask:
"""Both blueprints registered, mirroring production layout."""
app = Flask(__name__)
app.config["TESTING"] = True
app.register_blueprint(service_api_bp)
app.register_blueprint(openapi_bp)
return app
def test_openapi_route_registered(dual_app: Flask):
rules = {r.rule for r in dual_app.url_map.iter_rules()}
assert "/openapi/v1/oauth/device/code" in rules
def test_legacy_v1_route_still_registered(dual_app: Flask):
"""service_api/oauth.py re-registers the lifted class on /v1/."""
rules = {r.rule for r in dual_app.url_map.iter_rules()}
assert "/v1/oauth/device/code" in rules
def test_both_paths_dispatch_to_same_class(dual_app: Flask):
"""Single source of truth — no duplicated handler logic."""
new = next(
r for r in dual_app.url_map.iter_rules() if r.rule == "/openapi/v1/oauth/device/code"
)
legacy = next(
r for r in dual_app.url_map.iter_rules() if r.rule == "/v1/oauth/device/code"
)
new_view = dual_app.view_functions[new.endpoint]
legacy_view = dual_app.view_functions[legacy.endpoint]
# Flask-RESTX wraps Resource classes in a `view_class` attribute.
assert new_view.view_class is OAuthDeviceCodeApi
assert legacy_view.view_class is OAuthDeviceCodeApi
def test_route_accepts_post_and_options(dual_app: Flask):
new = next(
r for r in dual_app.url_map.iter_rules() if r.rule == "/openapi/v1/oauth/device/code"
)
legacy = next(
r for r in dual_app.url_map.iter_rules() if r.rule == "/v1/oauth/device/code"
)
assert "POST" in new.methods
assert "POST" in legacy.methods
def test_handler_class_imports_match():
"""service_api re-uses the openapi class, not a copy."""
from controllers.service_api import oauth as service_api_oauth
assert service_api_oauth.OAuthDeviceCodeApi is OAuthDeviceCodeApi
def test_known_client_ids_default_includes_difyctl():
from configs import dify_config
assert "difyctl" in dify_config.OPENAPI_KNOWN_CLIENT_IDS