osgeo.gdal_fsspec module
Module exposing GDAL Virtual File Systems (VSI) as a "gdalvsi" fsspec implementation.
Importing "osgeo.gdal_fsspec" requires the Python "fsspec" (https://filesystem-spec.readthedocs.io/en/latest/) module to be available.
A generic "gdalvsi" fsspec protocol is available. All GDAL VSI file names must be simply prefixed with "gdalvsi://". For example:
"gdalvsi://data/byte.tif" to access relative file "data/byte.tif"
"gdalvsi:///home/user/byte.tif" to access absolute file "/home/user/byte.tif"
"gdalvsi:///vsimem/byte.tif" (note the 3 slashes) to access VSIMem file "/vsimem/byte.tif"
"gdalvsi:///vsicurl/https://example.com/byte.tif (note the 3 slashes) to access "https://example.com/byte.tif" through /vsicurl/
- since:
GDAL 3.11
- class osgeo.gdal_fsspec.VSIFileSystem(*args, **kwargs)
Bases:
AbstractFileSystem
Implementation of AbstractFileSystem for a GDAL Virtual File System
- copy(path1, path2, recursive=False, maxdepth=None, on_error=None, **kwargs)
Implements AbstractFileSystem.copy()
- info(path, **kwargs)
Implements AbstractFileSystem.info()
- ls(path, detail=True, **kwargs)
Implements AbstractFileSystem.ls()
- makedirs(path, exist_ok=False)
Implements AbstractFileSystem.makedirs()
- mkdir(path, create_parents=True, **kwargs)
Implements AbstractFileSystem.mkdir()
- modified(path)
Implements AbstractFileSystem.modified()
- mv(path1, path2, recursive=False, maxdepth=None, **kwargs)
Implements AbstractFileSystem.mv()
- rmdir(path)
Implements AbstractFileSystem.rmdir()
- osgeo.gdal_fsspec.register_vsi_implementations()
Register a generic "gdalvsi" protocol. This method is automatically called on osgeo.gdal_fsspec import.