█▀     █ █ █     ▄▀█     █▀▀     ▄▀█    
 ▄█     ▀▄▀▄▀     █▀█     █▄█     █▀█    

 █▄▄     █▀█     █▄ █     █▀▄
 █▄█     █▄█     █ ▀█     █▄▀

Important

This project is still a prototype. A lot of functionality isn't there yet.

Swagabond is a catch-all solution for generating code or text output from an OpenAPI spec.

How it works

• You write your own templates alongside an "Instruction Set" (yaml file) that tells Swagabond how to process them
• You configure Swagabond in your build pipeline to automatically pull down your openAPI spec and process your templates
• That's it.

Swagabond vs OpenAPI Generator

Swagabond is like a glass of plain Jack Daniels, OpenAPI Generator is like a whiskey old fashioned. Sometimes you just don't have time to muddle the cherries, and just want to get drunk.

	Swagabond	OpenAPI Generator
Overall Vibe	Dumb, simple, easy to work with	Smart, powerful, higher learning curve
Best for	Prototyping, Simple APIs, Microservices, Internal tools, people with ADHD	Enterprise-scale applications, More nuanced OpenAPI Specs, People with lots of time
Learning Curve	Tiny, Can start writing a template instantly	Complicated, lots to learn
Template writing	Fewer options and features	Complex, more fully featured
Template syntax	Scriban, with more planned later	Mustache by default, but can write custom template engines
Object model	Every template gets the same exact object model	Varies based on each generator
Code-Gen Logic	Template driven	Varies, but each code generator exposes more code-specific nuances specific to the programming language

Getting started

Check out the wiki for a full in-depth tutorial!

Author

Swagabond was written originally by Jordan Bleu