mirror of
https://github.com/vastsa/FileCodeBox.git
synced 2026-11-20 13:29:56 +08:00
- ci.yml: ruff + pytest on push/PR, installing from the hashed lockfile with --require-hashes, plus a lockfile-vs-requirements consistency check (dependabot cannot regenerate the lockfile; drift was silent). - test_api_contract.py: deep-scans public config, dashboard, admin file list and share metadata responses for camelCase keys - the regression net for the D7 public-config leak found during review.
78 lines
2.9 KiB
Python
78 lines
2.9 KiB
Python
"""API contract guard: responses must carry snake_case keys only.
|
|
|
|
Regression net for the D7 lesson: a camel+snake dual-field contract crept
|
|
back through build_public_config/build_public_meta (file-based scoping hid
|
|
that they serve a live endpoint). Any key matching [a-z]+[A-Z] camel shape
|
|
anywhere in these documented response payloads now fails the suite.
|
|
"""
|
|
import re
|
|
|
|
import httpx
|
|
import pytest
|
|
|
|
CAMEL_KEY = re.compile(r"^[a-z0-9]+(?:[A-Z][a-zA-Z0-9]*)+$")
|
|
|
|
|
|
def _assert_no_camel_keys(node, path, violations):
|
|
if isinstance(node, dict):
|
|
for key, value in node.items():
|
|
key_path = f"{path}.{key}"
|
|
if isinstance(key, str) and CAMEL_KEY.match(key):
|
|
violations.append(key_path)
|
|
_assert_no_camel_keys(value, key_path, violations)
|
|
elif isinstance(node, list):
|
|
for index, item in enumerate(node):
|
|
_assert_no_camel_keys(item, f"{path}[{index}]", violations)
|
|
|
|
|
|
async def _login(client: httpx.AsyncClient) -> str:
|
|
from tests.conftest import TEST_ADMIN_PASSWORD
|
|
|
|
response = await client.post(
|
|
"/admin/login", json={"password": TEST_ADMIN_PASSWORD}
|
|
)
|
|
assert response.status_code == 200, response.text
|
|
return response.json()["detail"]["token"]
|
|
|
|
|
|
def _check_contract(payload: dict, url: str) -> None:
|
|
violations = []
|
|
_assert_no_camel_keys(payload, url, violations)
|
|
assert not violations, f"camelCase keys leaked into {url}: {violations}"
|
|
|
|
|
|
@pytest.mark.asyncio
|
|
class TestApiContractSnakeCase:
|
|
async def test_public_config(self, initialized_client):
|
|
response = await initialized_client.get("/api/v1/config")
|
|
assert response.status_code == 200
|
|
_check_contract(response.json(), "/api/v1/config")
|
|
|
|
async def test_dashboard(self, initialized_client):
|
|
token = await _login(initialized_client)
|
|
response = await initialized_client.get(
|
|
"/admin/dashboard", headers={"Authorization": f"Bearer {token}"}
|
|
)
|
|
assert response.status_code == 200
|
|
_check_contract(response.json(), "/admin/dashboard")
|
|
|
|
async def test_admin_file_list(self, initialized_client):
|
|
token = await _login(initialized_client)
|
|
response = await initialized_client.get(
|
|
"/admin/file/list", headers={"Authorization": f"Bearer {token}"}
|
|
)
|
|
assert response.status_code == 200
|
|
_check_contract(response.json(), "/admin/file/list")
|
|
|
|
async def test_share_metadata(self, initialized_client):
|
|
share = await initialized_client.post(
|
|
"/share/text/", data={"text": "contract guard", "expire_value": 1, "expire_style": "day"}
|
|
)
|
|
assert share.status_code == 200, share.text
|
|
code = share.json()["detail"]["code"]
|
|
response = await initialized_client.get(
|
|
"/share/metadata/", params={"code": code}
|
|
)
|
|
assert response.status_code == 200
|
|
_check_contract(response.json(), "/share/metadata/")
|