Skip to content

delete

Назначение

Удалить спецификацию (API-сервис) или коллекцию (файл спецификации) из конфигурации. Это обратная операция для add.

Когда использовать

  • API больше не нужен
  • Вы хотите удалить конкретный файл спецификации из спецификации
  • Вы очищаете свою рабочую область

Синтаксис

bash
swag2mcp delete spec [path]
swag2mcp delete collection [path]

Аргументы

АргументПозицияОбязательноОписание
path1НетДиректория рабочей области. Если не указан, разрешается по правилам разрешения пути.

Флаги

Нет. Обе подкоманды полностью интерактивны.

Как это работает

Удаление спецификации

Предлагает выбрать спецификацию из списка, затем запрашивает подтверждение перед удалением.

bash
swag2mcp delete spec

Удаление коллекции

Предлагает выбрать спецификацию, затем коллекцию в этой спецификации, затем запрашивает подтверждение.

bash
swag2mcp delete collection

Поиск ID

Интерактивные подсказки показывают человекочитаемые имена, а не ID. Если вам нужны ID для справки:

bash
# Список всех спецификаций с их ID
swag2mcp ls

# Список коллекций для конкретной спецификации
swag2mcp ls --tags

Проверка после команды

bash
swag2mcp ls [path]
# Удалённая спецификация или коллекция больше не должна отображаться

Нюансы

  • Требуется TTY: Обе команды требуют интерактивного терминала. Они не будут работать в CI/CD пайплайнах, cron-задачах или неинтерактивных скриптах.
  • Нет --force или --yes: Невозможно пропустить запрос подтверждения. Это сделано намеренно для предотвращения случайных удалений.
  • Автоинициализация: Если файл конфигурации не существует, delete автоматически запускает мастер инициализации.
  • Нет YAML-режима: В отличие от add, нет флага --yaml. Удаление всегда интерактивно.