Add YAML version of openapi docs

Author: rwb27

src/labthings/default_views/docs/__init__.py

@@ -1,4 +1,4 @@
-from flask import Blueprint, make_response, render_template
+from flask import Blueprint, make_response, render_template, Response
 
 from ...find import current_labthing
 from ...views import View
@@ -7,10 +7,32 @@
 class APISpecView(View):
     """OpenAPI v3 documentation"""
 
+    responses = {
+        "200": {
+            "description": "OpenAPI v3 description of this API",
+            "content": {"application/json": {}},
+        }
+    }
+
     def get(self):
         """OpenAPI v3 documentation"""
         return current_labthing().spec.to_dict()
 
+class APISpecYAMLView(View):
+    """OpenAPI v3 documentation
+    
+    A YAML document containing an API description in OpenAPI format
+    """
+
+    responses = {
+        "200": {
+            "description": "OpenAPI v3 description of this API",
+            "content": {"text/yaml": {}},
+        }
+    }
+
+    def get(self):
+        return Response(current_labthing().spec.to_yaml(), mimetype="text/yaml")
 
 class SwaggerUIView(View):
     """Swagger UI documentation"""
@@ -25,6 +47,9 @@ def get(self):
 )
 
 docs_blueprint.add_url_rule("/swagger", view_func=APISpecView.as_view("swagger_json"))
+docs_blueprint.add_url_rule("/openapi", view_func=APISpecView.as_view("swagger_json"))
+docs_blueprint.add_url_rule("/swagger.yaml", view_func=APISpecYAMLView.as_view("swagger_yaml"))
+docs_blueprint.add_url_rule("/openapi.yaml", view_func=APISpecYAMLView.as_view("swagger_yaml"))
 docs_blueprint.add_url_rule(
     "/swagger-ui", view_func=SwaggerUIView.as_view("swagger_ui")
 )