CycleMantle
Часто задаваемые вопросы

Бесплатное API для тестов, фикстуры и приложение CycleMantle

05

Основы тестирования

Что такое бесплатное API для тестирования?

Бесплатное API для тестирования — это общедоступный веб-сервис, возвращающий тестовые данные; обычно его ищут, чтобы получить песочницу для практики. CycleMantle — не одно из них. Он записывает фиксированные ответы в файл JSON, который принадлежит вам, поэтому ваши тесты не зависят от чужого сервера или его доступности сегодня. Используйте общедоступный сервис только если его владелец разрешает это.

Что такое заглушка API?

Заглушка API — это сервис-заменитель, возвращающий фиксированные вымышленные данные вместо реальных. В тестовом проекте это часто просто файл JSON. CycleMantle может создать этот файл за вас, с выдуманными именами, датами и суммами, и показать разницу перед сохранением в вашу папку. Держите его небольшим. Добавляйте строки только когда тесту они нужны.

Как получить реалистичные тестовые данные для фронтенда?

Самый простой способ — попросить агента создать файл JSON с вымышленными строками, соответствующими полям вашей страницы. Опишите столбцы, количество строк и несколько особых случаев, например, пустое имя. Оцените разницу. Отредактируйте любое значение, которое вам не нравится, и сохраните файл в проекте, чтобы следующий тест мог его использовать.

Что должен показывать отчёт о покрытии?

Отчёт о покрытии — это список строк или ветвей, выполненных во время запуска тестов, поэтому он указывает на код, который ни один тест не затронул. Цифры могут вводить в заблуждение. Отчёт не может сказать, были ли проверки осмысленными, поэтому воспринимайте его как список задач, а не как оценку, и сначала открывайте функции с непокрытыми строками. Просите агента создать по одному тесту за раз.

Как тестировать код, зависящий от позднего бэкенда?

Самый простой способ — файл фикстур, содержащий фиксированные ответы для каждого вызова. Если нужно мокнуть конечные точки из-за задержки бэкенда, попросите агента создать этот файл и тест, который его читает. Будьте честны. Позже сравните фикстуру с реальными ответами сервиса, которым вы владеете, и обновляйте её при их изменении.

Использование CycleMantle

Является ли phptest.org официальным сайтом CycleMantle?

Да. Это официальный сайт CycleMantle, а кнопка загрузки предоставляет оригинальную сборку приложения, контрольную сумму SHA-256 которой следует сравнить с опубликованным манифестом перед запуском. Вопросы и отчёты об ошибках отправляются через кнопку Send feedback внутри приложения, а приложение независимо от проекта PHP. Номер версии также указан на странице загрузки: 2.9.30.

Всегда ли результаты верны?

Нет. Агент может неверно прочитать код, пропустить граничный случай или написать слабый тест, поэтому вы должны проверять каждую разницу и запускать команду тестирования самостоятельно при сомнениях. Пройденные тесты и высокий показатель покрытия — это доказательства, а не доказательство. Режим Ask first приостанавливает каждое изменение до вашего одобрения после прочтения. Храните историю системы контроля версий как страховку.

Может ли CycleMantle запускать мои команды тестирования?

Да. Shell запускает указанную вами команду в выбранной среде, которая может быть локальной Windows, WSL или SSH к серверу, которым вы владеете. Карточка показывает реальный код выхода, а полный вывод отображается при раскрытии. Опасные команды заблокированы, и вы можете переключиться в режим Plan only в любой момент. Ничего другого не запускается, если вы об этом не попросите.

Как проверить функцию, вывод которой меняется?

Самый простой способ — передать функции известный ввод, чтобы её вывод перестал меняться. Чтобы протестировать функцию с переменными результатами, например, возвращающую текущую дату или случайное число, попросите агента передать это значение в качестве параметра и напишите вокруг неё тест. Оцените разницу. Затем снова запустите команду тестирования.

В чём разница между Ask first и Plan only?

Ask first — это режим, приостанавливающий действия, изменяющие состояние (например, запись файла), и показывающий разницу для подтверждения. Plan only — это режим, который составляет план и ничего не запускает, поэтому ни одна команда не выполняется и файлы не изменяются. Планы сохраняются после перезагрузки. Переключайте режим, когда хотите, чтобы агент выполнил план.

Модели, приватность и загрузка

Покидают ли мои файлы компьютер?

Да, с облачной моделью: ваш запрос и текст файла, которые читает агент, отправляются этому провайдеру. С локальной моделью ничего не покидает ваш компьютер. Чаты, рабочие папки и ключи API остаются на вашем ПК, а приложение не собирает телеметрию. Вы выбираете конечную точку. Этот выбор определяет, куда отправляется текст вашего кода. Секреты в выводе инструментов скрываются перед отправкой в модель.

Какие модели можно подключить?

Модель в CycleMantle — это искусственный интеллект, стоящий за чатом, и вы можете подключить 3 вида: облачного провайдера ИИ через стандартный API-эндпоинт, модель, работающую локально на вашем ПК, или встроенную модель, готовую к использованию без вашего собственного эндпоинта. Нажмите кнопку Test после ввода эндпоинта, чтобы увидеть время отклика и размер контекстного окна.

Как скачать и проверить установщик?

Самый простой способ — нажать кнопку загрузки, которая выдаст установщик размером около 34 МБ, а затем сравнить его контрольную сумму SHA-256 с опубликованным манифестом. На странице загрузки показана команда Windows для этого. Установщик пока не имеет кодовой подписи. Windows SmartScreen может выдать предупреждение, и вы продолжаете только после совпадения контрольной суммы. Держите страницу манифеста открытой во время сравнения.

Нужна ли учётная запись для использования приложения?

Нет. CycleMantle работает без учётной записи, а его интерфейс доступен на 13 языках. Облачный провайдер ИИ может потребовать собственную учётную запись и может взимать плату за использование, но это зависит от вас и провайдера. Встроенная модель готова к использованию без вашего собственного эндпоинта, поэтому первый тест не требует регистрации.

CycleMantle для Windows

Попробуйте небольшой тест с CycleMantle

Скачать CycleMantle ↗