вторник, 23 июня 2020 г.

Мелочь, а приятно

      Давным давно я писал генератор swagger спецификации по аннотациям - https://github.com/yvasiyarov/swagger. То есть ты пишешь API, а перед хендлером в комментарии пишешь аннотацию этого метода. Потом вызываешь генератор и он автоматом генерирует swagger спецификацию API и поднимает рядом веб клиента. 
                   Потом я его забросил, так как появились более продвинутые реализации. И тут недавно мне снова понадобился swagger генератор и я начал смотреть что же есть из актуального. Самым продвинутым на текущий момент является https://github.com/go-swagger/go-swagger. Каково же было мое удивление когда в его документации я обнаружил: 
      
The toolkit has a command that will let you generate a swagger spec document from your code. The command integrates with go doc comments, and makes use of structs when it needs to know of types.
Based on the work from https://github.com/yvasiyarov/swagger.
В общем мелочь, но приятно когда не забывают сказать спасибо :-)