Add method to generate openapi spec file

apiman/base.py

@@ -310,6 +310,14 @@ def parse(self, func: typing.Callable) -> typing.Dict[str, typing.Any]:
         else:
             return specification
 
+    def generate_specification_file(self, filename: str):
+        with open(filename, "w") as f:
+            f.writelines(
+                json.dumps(self.specification)
+                if filename.endswith("json")
+                else yaml.safe_dump(self.specification)
+            )
+
     @staticmethod
     def load_file(file_path: str) -> typing.Dict:
         with open(file_path) as f:

examples/_bottle.py

@@ -1,3 +1,4 @@
+import os
 import pytest
 from bottle import app, request, route, run
 from webtest import TestApp
@@ -101,9 +102,6 @@ def validate(path):
 
 def test_app():
     client = TestApp(app[0])
-    spec = apiman.load_specification(app[0])
-    apiman.validate_specification()
-    assert client.get(apiman.config["specification_url"]).json == spec
     assert client.get(apiman.config["swagger_url"]).status_code == 200
     assert client.get(apiman.config["redoc_url"]).status_code == 200
     # --
@@ -163,6 +161,16 @@ def test_app():
             == 200
         )
 
+    spec = apiman.load_specification(app[0])
+    apiman.validate_specification()
+    apiman.generate_specification_file("test_bottle.yaml")
+    apiman.generate_specification_file("test_bottle.json")
+    assert os.path.exists("test_bottle.yaml")
+    assert os.path.exists("test_bottle.json")
+    os.remove("test_bottle.yaml")
+    os.remove("test_bottle.json")
+    assert client.get(apiman.config["specification_url"]).json == spec
+
 
 if __name__ == "__main__":
     run(host="localhost", port=8080, debug=True)