Foreword

What is swapy?

Swapy is a python microframework for building web APIs and web applications. It is primarily intended to create REST APIs. However, it is also suitable to create normal HTML websites.

Why another framework?

I love developing modular applications. I started using Flask a while ago to create websites and REST APIs, but it wasn't perfectly suited for me. Trying to have a separate file for each resource and struggling with circular imports are examples of issues that really bothered me. You might say "Just use Blueprints", then I'd return "Ugh! Blueprints!"

Another problem I faced was the optimization for REST APIs. Yes, there are a bunch of Flask extensions and other frameworks such as Falcon or Hug that promise this optimization, but I wanted to combine the best properties in one solution: Ease and modularity.

That's how I came up with swapy.

Philosophy behind swapy

As mentioned above swapy's primary goal is easy and modular development. Another goal is providing a good documentation, comparable to that of other frameworks such as Flask. This helps beginners to be able to understand and build APIs without deep knowledge of web development and APIs. In addition, the core features such as auto documentations, middlewares and database ORMs are part of the standard library rather than extensions.