Что означает включение в файлах API Blueprint?

Question

Я не вижу никаких упоминаний об этом в спецификации API Blueprint, хотя есть дополнительный запрос на добавление директивы include для включения других файлов.

Answer 1

Include не следует путать с нестандартной директивой с тем же именем для включения других файлов (хотя инструмент aglio для API Blueprint поддерживает последний).

Include определен в the MSON specification, на который ссылается спецификация API Blueprint. Например, в разделе «Структуры данных» файла Blueprint API определенные типы имен, определенные в нем, определяются с помощью MSON.

Include is like extends в Java - он задает тип, который в настоящее время определяется, наследует все поля указанного «супертипа». Ключевое слово Include может сопровождаться именем именованного типа (его обычно использования) или, как-то странно, с помощью определения встроенного типа:

MSON определяет подмешать тип, который поддерживает множественное наследование от другого именованного типа. Именованный тип, наследуемый, ДОЛЖЕН быть структурой Тип или его подтип.

Вложенные элементы, определенные в и унаследованные от смешанного типа Named , добавляются с одинаковым уровнем отступов типа Mixin.

Mixin Type → - Include Type Name | - Включить определение типа