More Marshmallow argument updates

docs/source/extensions/example_extension/02_adding_views.py

@@ -46,7 +46,7 @@ class ExampleIdentifyView(View):
 class ExampleRenameView(View):
     # Expect a request parameter called "name", which is a string.
     # Passed to the argument "args".
-    args = fields.String(required=True, example="My Example Microscope")
+    args = fields.String(required=True, metadata={"example": "My Example Microscope"})
 
     def post(self, args):
         # Look for our new name in the request body

docs/source/extensions/example_extension/03_marshaling_data.py

@@ -49,7 +49,7 @@ class ExampleRenameView(View):
     # Format our returned object using MicroscopeIdentifySchema
     schema = MicroscopeIdentifySchema()
     # Expect a request parameter called "name", which is a string. Pass to argument "args".
-    args = {"name": fields.String(required=True, example="My Example Microscope")}
+    args = {"name": fields.String(required=True, metadata={"example": "My Example Microscope"})}
 
     def post(self, args):
         # Look for our "name" parameter in the request arguments

docs/source/extensions/example_extension/04_properties.py

@@ -53,7 +53,7 @@ class ExampleIdentifyView(PropertyView):
 # We can use a single schema as the input and output will be formatted identically
 # Eg. We always expect a "name" string argument, and always return a "name" string attribute
 class ExampleRenameView(PropertyView):
-    schema = {"name": fields.String(required=True, example="My Example Microscope")}
+    schema = {"name": fields.String(required=True, metadata={"example": "My Example Microscope"})}
 
     def get(self):
         """

docs/source/extensions/example_extension/05_actions.py

@@ -56,7 +56,7 @@ class ExampleIdentifyView(PropertyView):
 # We can use a single schema as the input and output will be formatted identically
 # Eg. We always expect a "name" string argument, and always return a "name" string attribute
 class ExampleRenameView(PropertyView):
-    schema = {"name": fields.String(required=True, example="My Example Microscope")}
+    schema = {"name": fields.String(required=True, metadata={"example": "My Example Microscope"})}
 
     def get(self):
         """

docs/source/extensions/example_extension/06_tasks_locks.py

@@ -66,10 +66,10 @@ class TimelapseAPIView(ActionView):
 
     args = {
         "n_images": fields.Integer(
-            required=True, example=5, description="Number of images"
+            required=True, metadata={"example": 5, "description": "Number of images"}
         ),
         "t_between": fields.Number(
-            load_default=1, example=1, description="Time (seconds) between images"
+            load_default=1, metadata={"example": 1, "description": "Time (seconds) between images"}
         ),
     }
 

docs/source/extensions/example_extension/07_ev_gui.py

@@ -99,10 +99,10 @@ class TimelapseAPIView(ActionView):
 
     args = {
         "n_images": fields.Integer(
-            required=True, example=5, description="Number of images"
+            required=True, metadata={"example": 5, "description": "Number of images"}
         ),
         "t_between": fields.Number(
-            load_default=1, example=1, description="Time (seconds) between images"
+            load_default=1, metadata={"example": 1, "description": "Time (seconds) between images"}
         ),
     }