export

Назначение

Создать портативный ZIP-архив рабочей области. Архив содержит файл конфигурации, все файлы спецификаций и скрипты аутентификации — всё необходимое для восстановления рабочей области на другой машине.

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

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

Синтаксис

swag2mcp export [path] [output] [flags]

Аргументы

Аргумент	Позиция	Обязательно	Описание
path	1	Нет	Директория рабочей области. Если не указан, разрешается по правилам разрешения пути.
output	2	Нет	Полный путь для выходного ZIP-файла. Если не указан, по умолчанию ./swag2mcp-backup-<timestamp>.zip.

Флаги

Флаг	Сокращение	Тип	По умолчанию	Описание
--spec	-s	stringSlice	nil	Экспортировать только указанные спецификации (через запятую)

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

Экспорт по умолчанию

Создаёт ZIP в текущей директории с именем, содержащим временную метку:

swag2mcp export
# Создаёт ./swag2mcp-backup-2026-07-22-143022.zip

Пользовательский путь вывода

swag2mcp export /path/to/workspace /path/to/backup.zip

Экспорт определённых спецификаций

swag2mcp export --spec meteo
swag2mcp export --spec meteo,store

Что входит в ZIP

Элемент	Описание
swag2mcp.meta	Метаданные об экспорте
swag2mcp.yaml	Файл конфигурации
specs/	Все файлы спецификаций (OpenAPI/Swagger/Postman)
auth_scripts/	Скрипты аутентификации
cache/	Пусто (кэш не экспортируется)
responses/	Пусто (ответы не экспортируются)

Восстановление

Используйте import для восстановления из резервной копии:

swag2mcp import --from-zip /path/to/backup.zip

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

Всегда проверяйте, что ZIP-файл был создан:

ls -la swag2mcp-backup-*.zip
# или для пользовательского пути:
ls -la /path/to/backup.zip

Нюансы

• Вывод должен быть путём к файлу: Аргумент [output] должен быть полным путём к файлу, заканчивающимся на .zip. Не передавайте директорию — команда не создаст ZIP, если ей передать путь к директории.
• Имя файла по умолчанию: swag2mcp-backup-<YYYY-MM-DD-HHMMSS>.zip с использованием UTC-времени.
• Фильтр --spec: Если указан, в архив включаются только указанные спецификации. Остальные исключаются.
• Конфиг не требуется: export работает даже без валидного файла конфигурации. Он экспортирует всё, что существует в рабочей области.
• Кэш и ответы исключены: Это временные данные, которые будут устаревшими при восстановлении. Сохраняются только конфиг, спецификации и скрипты аутентификации.