Локальный сервис для тестирования и отладки HTTP-запросов, реализованный на OneScript с использованием фреймворка WINOW. Проект предоставляет функциональность, аналогичную httpbin.org, поддерживая большинство оригинальных эндпоинтов.

• 1. Установка
• 2. Использование
  • 2.1. CLI приложение
  • 2.2. Тестирование с asserts и 1connector
  • 2.3. Swagger UI
• 3. Совместимость
• 4. Программный интерфейс
• 5. Пользовательские эндпоинты
• 6. Ограничения
• 7. Сравнение с httpbin.org

opm install httpbin

Запустите сервис с помощью команды:

httpbin run

# test.os #Использовать asserts #Использовать 1connector #Использовать httpbin Перем HttpBin; &Инициализация Процедура ПередЗапускомТестов() Экспорт HttpBin = Новый HttpBin(); HttpBin.Запустить(); КонецПроцедуры &Завершение Процедура ПослеЗапускаТестов() Экспорт HttpBin.Остановить(); КонецПроцедуры &Тест Процедура ТестДолжен_ПроверитьПараметрыЗапроса() Экспорт ПараметрыЗапроса = Новый Структура(); ПараметрыЗапроса.Вставить("key", "value"); Ответ = КоннекторHTTP.Get(HttpBin.URL("/get"), ПараметрыЗапроса); Ожидаем.Что(Ответ.КодСостояния).Равно(200); Ожидаем.Что(Ответ.Заголовки["Content-Type"]).Содержит("application/json"); Ожидаем.Что(Ответ.Json()["args"]["key"]).Равно("value"); КонецПроцедуры

На стартовой странице сервиса (по умолчанию: http://127.0.0.1:3333) доступна интерактивная документация API через Swagger UI, а также возможность отправки запросов и получения ответов.

Сервис протестирован и поддерживается на следующих платформах и версиях OneScript:

Класс предназначен для управления локальным HTTP-сервисом. Реализован с использованием текучего интерфейса.

Новый HttpBin(<Хост>, <Порт>)

<Хост> (необязательный)
Тип: Строка.
IP-адрес или имя хоста.
По умолчанию: 127.0.0.1

<Порт> (необязательный)
Тип: Число.
Номер TCP-порта.
По умолчанию: 3333

Сервис поддерживает подключение пользовательских контроллеров для добавления собственных эндпоинтов.

Контроллер реализуется в виде класса OneScript с аннотацией &Контроллер. В нём определяются точки маршрута (эндпоинты) с помощью аннотации &ТочкаМаршрута. Подробнее см. в документации WINOW.

Пример контроллера

&Контроллер("/order") Процедура ПриСозданииОбъекта() КонецПроцедуры &ТочкаМаршрута("add") Процедура Главная(Ответ) Экспорт // Бизнес-логика КонецПроцедуры

Через программный интерфейс

Для подключения кастомных контроллеров используйте метод УстановитьРасположениеКонтроллеров(), указав путь к файлу или каталогу с контроллерами:

HttpBin = Новый HttpBin() .УстановитьРасположениеКонтроллеров("./path/to/routes") .Запустить();

Через CLI

httpbin run --routes-handlers './path/to/routes-handlers'

• Отсутствие поддержки HTTPS: Сервис работает только по протоколу HTTP.