api-platform-tests — скилл для Claude Code: тесты API Platform
Скилл api-platform-tests помогает писать функциональные тесты ресурсов API Platform на Symfony: проверять ответы, фильтры, схемы JSON и доступ. Пригодится при добавлении или изменении API-эндпоинтов.
MIT ★ 234 обновлён 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill api-platform-tests -a claude-codeЧто делает api-platform-tests
Скилл задаёт процесс тестирования эндпоинтов API Platform через ApiTestCase: подготовить данные фабриками Foundry, отправить запрос и проверить статус, тип содержимого и JSON. Он охватывает коллекции и отдельные ресурсы, создание, обновление и удаление, а также ошибки валидации и доступа.
В тестах предлагается сбрасывать состояние через #[ResetDatabase] и использовать Factories. Для проверки аутентификации предусмотрен auth_bearer; фильтры и пагинация проверяются по member и totalItems, а форму ответа — по JSON-схеме ресурса. Для PATCH нужен тип содержимого application/merge-patch+json.
Есть ограничение по версиям: #[ResetDatabase] требует PHPUnit 10+ и Foundry 2.9; с PHPUnit 9 нужно использовать трейт ResetDatabase. Ошибка типа свойства с ограничением даёт статус 422 в API Platform 5.0, но 400 в 4.4 и более ранних версиях. Это важно учесть в ожидаемом статусе теста.
Какие задачи решает
- проверить ответы коллекции и отдельного ресурса
- покрыть создание, обновление и удаление API-ресурсов
- проверить ошибки валидации и запреты доступа
- протестировать фильтры и пагинацию
- сверить ответы с JSON-схемой ресурса
Примеры запросов агенту
- Напиши функциональные тесты коллекции и отдельного ресурса API Platform через
ApiTestCase. - Добавь тесты для фильтра и пагинации, проверяя
memberиtotalItems. - Покрой анонимный запрос, владельца и другого пользователя, включая ошибки доступа.
Как установить api-platform-tests
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill api-platform-tests -a claude-code2Вручную: положить файлы
~/.claude/skills/api-platform-tests/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/api-platform-tests/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill api-platform-tests -a codex2Вручную: положить файлы
.agents/skills/api-platform-tests/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill api-platform-tests -a cursor2Вручную: положить файлы
.cursor/skills/api-platform-tests/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/api-platform-tests2Вручную: положить файлы
.github/skills/api-platform-tests/SKILL.md1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill api-platform-tests -a gemini-cli2Командой платформы
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/api-platform-testsВручную: положить файлы
.devin/skills/api-platform-tests/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об api-platform-tests
Как установить api-platform-tests в Claude Code?
Выполните npx skills add dev-toolings/superpowers-symfony --skill api-platform-tests -a claude-code. Скилл доступен по пути ~/.claude/skills/api-platform-tests/SKILL.md.
Что делает api-platform-tests?
Помогает создавать функциональные тесты API Platform на Symfony: проверять эндпоинты, фильтры, пагинацию, JSON-схемы, аутентификацию и ошибки.
Какие версии нужны для #[ResetDatabase]?
Атрибут требует PHPUnit 10+ и Foundry 2.9. Для PHPUnit 9 скилл советует использовать трейт ResetDatabase.
Исходный текст
SKILL.md · MIT
--- name: api-platform-tests description: Test API Platform resources with ApiTestCase; assert collections, items, filters, JSON schema, and authentication capabilities: [read, search, edit, shell] tags: [api-platform, testing] # projected by `bun run build` — do not edit by hand allowed-tools: - Read - Glob - Grep - Write - Edit - Bash --- # Api Platform Tests (Symfony) ## Use when - Writing functional tests for API Platform endpoints: collection, item, create, update, delete. - Asserting validation errors (422) and access control (401, 403). - Checking filters, pagination, or the JSON schema of responses. - Setting up a clean database and test data for API tests. ## Default workflow 1. Extend `ApiTestCase` and seed data with Foundry factories (`createOne`, `createMany`). 2. Reset state with `#[ResetDatabase]` and the `Factories` trait, with DAMA rolling back each test. 3. Call `static::createClient()->request()` and assert the status code, content type, and `assertJsonContains()`. 4. Authenticate with `auth_bearer` and cover the anonymous, owner, and other-user cases. 5. Assert `member` and `totalItems` for filters and pagination (`hydra:`-prefixed only with `hydra_prefix: true`). 6. Assert the shape with `assertMatchesResourceItemJsonSchema()` and `assertMatchesResourceCollectionJsonSchema()`. ## Guardrails - Send `PATCH` with the `application/merge-patch+json` content type. - `#[ResetDatabase]` needs PHPUnit 10+ and Foundry 2.9: use the `ResetDatabase` trait on PHPUnit 9. - Cover the failure paths too: 404, 422, 401, 403. A type error on a constrained property is 422 in 5.0 but 400 in 4.4 and earlier. - Read the configured items per page rather than hardcoding a page size in assertions. ## Progressive disclosure - Use this file for execution posture and risk controls. - Open references when deep implementation details are needed. ## Output contract - The test classes added and the endpoints they cover. - Factories and reset strategy used. - Test run output, including the failure paths. ## References - `reference.md`
© dev-toolings · MIT · dev-toolings/superpowers-symfony