docs: def transmute_route(app, fn, context=default_context):
      """
      this is the main interface to transmute. It will handle
      adding converting the python function into the a flask-compatible route,
      and adding it to the application.
      """
      transmute_func = TransmuteFunction(fn)
      routes, handler = create_routes_and_handler(transmute_func, context)
      for r in routes:
          """
          the route being attached is a great place to start building up a
          swagger spec.  the SwaggerSpec object handles creating the
          swagger spec from transmute routes for you.
  
          almost all web frameworks provide some app-specific context
          that one can add values to. It's recommended to attach
          and retrieve the swagger spec from there.
          """
          if not hasattr(app, SWAGGER_ATTR_NAME):
              setattr(app, SWAGGER_ATTR_NAME, SwaggerSpec())
          swagger_obj = getattr(app, SWAGGER_ATTR_NAME)
          swagger_obj.add_func(transmute_func, context)
          app.route(r, methods=transmute_func.methods)(handler)