2015-09-24 77 views
7

JSDoc ile tam olarak belgelenmiş büyük bir JS API'm var ve API'yi bir ağ üzerinde kullanılabilir hale getirmek için havalı tabanlı bir REST hizmeti yapıyorum.JSDoc'tan Swagger YAML Oluşturma?

YAML swagger teknik özelliklerinin bir ilk sürümünü el ile oluşturdum ancak sorun, JS API ile hızlı bir şekilde senkronize edilmemesidir, çünkü söz konusu nesnelerin özelliklerinde özellikle de evrim geçirmektedir.

Yapmak istediğim şey, doğrudan doğruya JSDoc yorumlarından swagger YAML'yi, en azından veri tanımlama bölümünü otomatik olarak oluşturmaktır. Otomatikleştirmeme yardımcı olabilecek herhangi bir araç var mı?

cevap