OnedataFS is a PyFilesystem interface to Onedata virtual file system.
As a PyFilesystem concrete class, OnedataFS allows you to work with Onedata in the same way as any other supported filesystem.
OnedataFS contains all C++ storage drivers for direct data access, a.k.a. DirectIO. Because of that, it cannot be installed using pip. If you are using ProxyIO (data access through a Oneprovider), consider using a lightweight cousin of OnedataFS - OnedataRESTFS. It has identical functionality, can be installed using pip, and has minimal dependencies. OnedataRESTFS uses the Onedata REST API behind the scenes, yielding comparable performance for ProxyIO data access mode.
See the docs.
Open an OnedataFS by explicitly using the constructor:
from fs.onedatafs import OnedataFS
onedata_provider_host = "..."
onedata_access_token = "..."
odfs = OnedataFS(onedata_provider_host, onedata_access_token)Or with a FS URL:
from fs import open_fs
odfs = open_fs('onedatafs://HOST?token=...')Consult the docs for further information.
Onedata FS supports in addition to standard PyFilesystem API operations on metadata via POSIX compatible extended attributes API.