Files
RuoYi-Vue3-FastAPI/ruoyi-fastapi-backend/tests/cli/completion/test_providers.py
T
insistence 9f7a0daa3b feat: 新增cli系统 (#103)
* feat: 新增cli系统

* feat: ruoyi completion支持powershell

* perf: 优化tui显示

* fix: 修复前端构建异常
2026-05-13 11:19:31 +08:00

443 lines
12 KiB
Python

import importlib
import os
import sys
from pathlib import Path
from pytest import MonkeyPatch
BACKEND_DIR = Path(__file__).resolve().parents[3]
sys.path.insert(0, str(BACKEND_DIR))
sys.modules.pop('cli.completion.providers', None)
sys.modules.pop('cli', None)
completion_support = importlib.import_module('cli.completion.providers')
completion_gateway = completion_support.COMPLETION_PROVIDER_GATEWAY
completion_registry = completion_gateway.provider_registry
def test_complete_alembic_revisions_returns_default_choices_and_local_revisions(
tmp_path: Path,
monkeypatch: MonkeyPatch,
) -> None:
"""
校验 Alembic 版本补全会返回默认候选和本地迁移版本。
:param tmp_path: pytest 临时目录
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
versions_dir = tmp_path / 'alembic' / 'versions'
versions_dir.mkdir(parents=True)
(versions_dir / '2026_04_29_1000-abc123_add_demo_table.py').write_text('# test', encoding='utf-8')
monkeypatch.chdir(tmp_path)
candidates = completion_gateway.complete_alembic_revisions(None, None, 'a')
default_candidates = completion_gateway.complete_alembic_revisions(None, None, '')
assert 'abc123' in candidates
assert 'head' in default_candidates
assert 'base' in default_candidates
assert 'current' in default_candidates
assert '-1' in default_candidates
def test_complete_sql_files_returns_project_relative_sql_paths(
tmp_path: Path,
monkeypatch: MonkeyPatch,
) -> None:
"""
校验 SQL 文件补全会返回项目相对路径。
:param tmp_path: pytest 临时目录
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
sql_dir = tmp_path / 'sql'
sql_dir.mkdir()
(sql_dir / 'demo.sql').write_text('select 1;', encoding='utf-8')
monkeypatch.chdir(tmp_path)
candidates = completion_gateway.complete_sql_files(None, None, 'sql/d')
assert candidates == ['sql/demo.sql']
def test_complete_cache_names_returns_static_cache_name_choices(monkeypatch: MonkeyPatch) -> None:
"""
校验缓存名称补全会返回系统内置缓存名称。
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
class _FakeCacheKeyConfig:
"""
模拟缓存键配置对象。
"""
def __init__(self, key: str) -> None:
"""
初始化模拟缓存键配置对象。
:param key: 缓存名称
:return: None
"""
self.key = key
class _FakeEnumsModule:
"""
模拟枚举模块。
"""
RedisInitKeyConfig = [_FakeCacheKeyConfig('sys_config'), _FakeCacheKeyConfig('login_tokens')]
monkeypatch.setattr(
completion_registry.dynamic_service, 'load_runtime_module', lambda module_name: _FakeEnumsModule
)
candidates = completion_gateway.complete_cache_names(None, None, 'sys')
assert candidates == ['sys_config']
def test_complete_output_paths_returns_directories_and_zip_files(
tmp_path: Path,
monkeypatch: MonkeyPatch,
) -> None:
"""
校验导出路径补全会返回目录和 zip 文件。
:param tmp_path: pytest 临时目录
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
build_dir = tmp_path / 'build'
build_dir.mkdir()
(build_dir / 'gen.zip').write_text('zip', encoding='utf-8')
(build_dir / 'notes.txt').write_text('ignore', encoding='utf-8')
monkeypatch.chdir(tmp_path)
candidates = completion_gateway.complete_output_paths(None, None, 'build/')
assert 'build/gen.zip' in candidates
assert 'build/notes.txt' not in candidates
def test_complete_config_keys_returns_dynamic_readonly_choices(monkeypatch: MonkeyPatch) -> None:
"""
校验参数键名补全会返回动态只读查询结果。
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
class _FakeConfigRuntime:
"""
模拟配置运行时模块。
"""
class ConfigRuntime:
"""
模拟配置运行时服务对象。
"""
@staticmethod
def list_configs(**kwargs: str) -> dict:
"""
模拟配置列表查询入口。
:param kwargs: 查询参数
:return: 伪造的结果字典
"""
return kwargs
CONFIG_RUNTIME = ConfigRuntime()
monkeypatch.setattr(
completion_registry.dynamic_service, 'load_runtime_module', lambda module_name: _FakeConfigRuntime
)
monkeypatch.setattr(
completion_registry.dynamic_service,
'run_completion_coroutine',
lambda coroutine, *, env: {
'ok': True,
'items': [
{'configKey': 'sys.user.initPassword'},
{'configKey': 'sys.user.maxRetryCount'},
],
},
)
candidates = completion_gateway.complete_config_keys(None, None, 'sys.user.i')
assert candidates == ['sys.user.initPassword']
def test_complete_gen_table_names_returns_dynamic_readonly_choices(monkeypatch: MonkeyPatch) -> None:
"""
校验代码生成业务表补全会返回动态只读查询结果。
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
class _FakeGenRuntime:
"""
模拟代码生成运行时模块。
"""
class GenRuntime:
"""
模拟代码生成运行时服务对象。
"""
@staticmethod
def list_gen_tables(**kwargs: str) -> dict:
"""
模拟业务表列表查询入口。
:param kwargs: 查询参数
:return: 伪造的结果字典
"""
return kwargs
@staticmethod
def list_gen_db_tables(**kwargs: str) -> dict:
"""
模拟数据库物理表列表查询入口。
:param kwargs: 查询参数
:return: 伪造的结果字典
"""
return kwargs
GEN_RUNTIME = GenRuntime()
monkeypatch.setattr(completion_registry.dynamic_service, 'load_runtime_module', lambda module_name: _FakeGenRuntime)
monkeypatch.setattr(
completion_registry.dynamic_service,
'run_completion_coroutine',
lambda coroutine, *, env: {
'ok': True,
'items': [
{'tableName': 'sys_user'},
{'tableName': 'sys_role'},
],
},
)
candidates = completion_gateway.complete_gen_table_names(None, None, 'sys_u')
assert candidates == ['sys_user']
def test_dynamic_completion_returns_empty_list_when_runtime_fails(monkeypatch: MonkeyPatch) -> None:
"""
校验动态补全在运行时失败时会优雅降级为空列表。
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
monkeypatch.setattr(
completion_registry.dynamic_service,
'load_runtime_module',
lambda module_name: (_ for _ in ()).throw(RuntimeError('boom')),
)
candidates = completion_gateway.complete_gen_db_table_names(None, None, 'sys')
assert candidates == []
def test_complete_cache_keys_returns_dynamic_readonly_choices(monkeypatch: MonkeyPatch) -> None:
"""
校验缓存键名补全会基于缓存名称返回动态只读查询结果。
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
class _FakeCacheRuntime:
"""
模拟缓存运行时模块。
"""
class CacheRuntime:
"""
模拟缓存运行时服务对象。
"""
@staticmethod
def list_cache_keys(cache_name: str) -> dict[str, str]:
"""
模拟缓存键列表查询入口。
:param cache_name: 缓存名称
:return: 伪造的参数字典
"""
return {'cache_name': cache_name}
CACHE_RUNTIME = CacheRuntime()
class _FakeContext:
"""
模拟 Click 上下文。
"""
params = {'cache_name': 'sys_config'}
monkeypatch.setattr(
completion_registry.dynamic_service, 'load_runtime_module', lambda module_name: _FakeCacheRuntime
)
monkeypatch.setattr(
completion_registry.dynamic_service,
'run_completion_coroutine',
lambda coroutine, *, env: {
'ok': True,
'keys': ['site.name', 'site.logo'],
},
)
candidates = completion_gateway.complete_cache_keys(_FakeContext(), None, 'site.n')
assert candidates == ['site.name']
def test_complete_job_names_returns_dynamic_readonly_choices(monkeypatch: MonkeyPatch) -> None:
"""
校验任务名称补全会返回动态只读查询结果。
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
class _FakeJobRuntime:
"""
模拟任务运行时模块。
"""
class JobRuntime:
"""
模拟任务运行时服务对象。
"""
@staticmethod
def list_jobs(**kwargs: str) -> dict:
"""
模拟任务列表查询入口。
:param kwargs: 查询参数
:return: 伪造的参数字典
"""
return kwargs
JOB_RUNTIME = JobRuntime()
monkeypatch.setattr(completion_registry.dynamic_service, 'load_runtime_module', lambda module_name: _FakeJobRuntime)
monkeypatch.setattr(
completion_registry.dynamic_service,
'run_completion_coroutine',
lambda coroutine, *, env: {
'ok': True,
'items': [
{'jobName': '同步任务'},
{'jobName': '缓存预热'},
],
},
)
candidates = completion_gateway.complete_job_names(None, None, '同')
assert candidates == ['同步任务']
def test_complete_job_ids_returns_dynamic_readonly_choices(monkeypatch: MonkeyPatch) -> None:
"""
校验任务 ID 补全会返回动态只读查询结果。
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
class _FakeJobRuntime:
"""
模拟任务运行时模块。
"""
class JobRuntime:
"""
模拟任务运行时服务对象。
"""
@staticmethod
def list_jobs(**kwargs: str) -> dict:
"""
模拟任务列表查询入口。
:param kwargs: 查询参数
:return: 伪造的参数字典
"""
return kwargs
JOB_RUNTIME = JobRuntime()
monkeypatch.setattr(completion_registry.dynamic_service, 'load_runtime_module', lambda module_name: _FakeJobRuntime)
monkeypatch.setattr(
completion_registry.dynamic_service,
'run_completion_coroutine',
lambda coroutine, *, env: {
'ok': True,
'items': [
{'jobId': 101},
{'jobId': 202},
],
},
)
candidates = completion_gateway.complete_job_ids(None, None, '1')
assert candidates == ['101']
def test_run_completion_coroutine_scopes_app_env(monkeypatch: MonkeyPatch) -> None:
"""
校验动态补全执行时会临时注入 APP_ENV,并在结束后恢复原值。
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
monkeypatch.setenv('APP_ENV', 'prod')
captured: dict[str, str | None] = {}
async def _read_env() -> str | None:
captured['during'] = os.environ.get('APP_ENV')
return captured['during']
result = completion_registry.dynamic_service.run_completion_coroutine(_read_env(), env='dev')
assert result == 'dev'
assert captured['during'] == 'dev'
assert os.environ.get('APP_ENV') == 'prod'
def test_run_completion_coroutine_clears_scoped_app_env_when_original_missing(monkeypatch: MonkeyPatch) -> None:
"""
校验动态补全执行结束后会移除临时注入的 APP_ENV。
:param monkeypatch: pytest monkeypatch 工具
:return: None
"""
monkeypatch.delenv('APP_ENV', raising=False)
async def _read_env() -> str | None:
return os.environ.get('APP_ENV')
result = completion_registry.dynamic_service.run_completion_coroutine(_read_env(), env='dockerpg')
assert result == 'dockerpg'
assert 'APP_ENV' not in os.environ