Added OpenAPI validation from apispec

openflexure_microscope/api/app.py

@@ -258,7 +258,16 @@ def generate_openapi():
             'Use .yml or .yaml for YAML (which is the default'
         )
     )
+    parser.add_argument(
+        "--validate", 
+        action="store_true", 
+        help="Validate the API spec, returning an error code if it does not pass."
+    )
     args = parser.parse_args()
+    if args.validate:
+        import apispec.utils
+        if apispec.utils.validate_spec(labthing.spec):
+            print("OpenAPI specification validated OK.")
     fname = args.output
     if fname.endswith(".json"):
         import json
@@ -268,7 +277,6 @@ def generate_openapi():
         with open(fname, 'w') as fd:
             fd.write(labthing.spec.to_yaml())
 
-
 # Start the app if the module is run directly
 if __name__ == "__main__":
     ofm_serve()

setup.py

@@ -44,6 +44,7 @@ setup(
     # set up the project for development, you use those specific packages, rather than
     # the looser specifications given here.
     install_requires=[
+        "apispec[validation]", # We need the extra to validate the spec
         "Flask ~= 1.0",
         "Pillow ~= 7.2.0",
         "numpy ~= 1.20",