У ternJS их несколько. Файлы JSON defs, содержащие определения библиотек. Может ли кто-нибудь объяснить мне, как мне лучше всего сгенерировать свои собственные библиотеки javascript/или только объекты определения?
Я не вижу, что нет общей процедуры для этого?
В Tern есть инструмент для этого. См. condense на странице http://ternjs.net/doc/manual.html#utils. Он запускает Tern в вашем файле и пытается вывести типы, которые он находит. Он далеко не безупречен, но для простых программ работает хорошо. Для файлов со сложной структурой или интерфейсом вам часто придется писать определения вручную.
Есть три способа, о которых я думал, чтобы решить вашу проблему:
Один из способов решить вашу проблему — использовать анализатор абстрактного синтаксического дерева и посетитель, чтобы автоматизировать задачу сканирования кода и его документирования.
Ресурсы здесь будут полезны:
-http://ramkulkarni.com/blog/understanding-ast-created-by-mozilla-rhino-parser/ -Что такое JavaScript AST, как с ним работать?
Обычно вы используете синтаксический анализатор для извлечения дерева, а затем используете посетителя для посещения всех узлов и выполнения там своей работы.
По сути, у вас будет дерево, представляющее конкретную библиотеку, а затем вы должны написать код для его хранения в формате def, на который вы ссылаетесь.
Другая идея — загрузить исходный код для генератора документации, например. https://github.com/yui/yuidoc/
Изменив стиль/формат вывода, вы можете создать «документацию» в соответствующем формате json.
Вы можете создать синтаксический анализатор, который принимает стандартный формат документации (я уверен, что Javadoc подходит для java, должен быть один и для javascript), и написать преобразователь, который извлекает соответствующую информацию и сохраняет ее в определении JSON.
