Fix the return type of cf.example_fields

Changelog.rst

@@ -7,6 +7,8 @@ version 3.15.1
   (https://github.com/NCAS-CMS/cf-python/issues/577)
 * Fix bug when using the ``-d`` option to the `cfa` script 
   (https://github.com/NCAS-CMS/cf-python/issues/649)
+* Fix the return type of `cf.example_fields`
+  (https://github.com/NCAS-CMS/cf-python/pull/654)
 
 ----
 

cf/examplefield.py

@@ -1,6 +1,7 @@
 import cfdm
 
 from .cfimplementation import implementation
+from .fieldlist import FieldList
 
 _implementation = implementation()
 
@@ -13,7 +14,7 @@ def example_field(n, _implementation=_implementation):
 
 
 def example_fields(*n, _func=example_field):
-    return cfdm.example_fields(*n, _func=_func)
+    return FieldList(cfdm.example_fields(*n, _func=_func))
 
 
 example_fields.__doc__ = cfdm.example_fields.__doc__.replace("cfdm.", "cf.")

cf/test/test_functions.py

@@ -18,7 +18,12 @@ def setUp(self):
         self.test_only = ()
 
     def test_example_field(self):
-        for f in cf.example_fields():
+        """Test cf.example_field and cf.example_fields"""
+        fields = cf.example_fields()
+        self.assertIsInstance(fields, cf.FieldList)
+
+        for f in fields:
+            self.assertIsInstance(f, cf.Field)
             f.dump(display=False)
 
         with self.assertRaises(ValueError):