Merge pull request #932 from NCAS-CMS/copilot/add-filesystem-parameter-cf-read

Add `filesystem` parameter to `cf.read` as pass-through to `cfdm.read`

Author: davidhassell

Changelog.rst

@@ -3,6 +3,8 @@ Version NEXTVERSION
 
 **2026-??-??**
 
+* New keyword to `cf.read`: ``filesystem``
+  (https://github.com/NCAS-CMS/cf-python/issues/931)
 * New keyword parameter to `cf.Data.compute`: ``persist``
   (https://github.com/NCAS-CMS/cf-python/issues/929)
 * New function to control the persistence of computed data:

cf/read_write/read.py

@@ -336,6 +336,10 @@ class read(cfdm.read):
 
             .. versionadded:: 3.19.0
 
+        {{read filesystem: optional}}
+
+            .. versionadded:: NEXTVERSION
+
         umversion: deprecated at version 3.0.0
             Use the *um* parameter instead.
 
@@ -455,6 +459,7 @@ def __new__(
         fmt=None,
         file_type=None,
         group_dimension_search="closest_ancestor",
+        filesystem=None,
     ):
         """Read field or domain constructs from a dataset."""
         kwargs = locals()