# OnedataRESTFS
OnedataRESTFS is a [PyFilesystem](https://www.pyfilesystem.org/) interface to
[Onedata](https://onedata.org) virtual file system based on [Onedata REST API].
As a PyFilesystem concrete class, [OnedataRESTFS](https://github.com/onedata/onedatarestfs/)
allows you to work with Onedata in the same way as any other supported filesystem.
## Installing
You can install OnedataRESTFS from pip as follows:
```
pip install fs.onedatarestfs
```
## Opening a OnedataRESTFS
Open an OnedataRESTFS by explicitly using the constructor:
```python
from fs.onedatarestfs import OnedataRESTFS
onedata_onezone_host = "..."
onedata_access_token = "..."
odfs = OnedataRESTFS(onedata_onezone_host, onedata_access_token)
```
Or with a FS URL:
```python
from fs import open_fs
odfs = open_fs('onedatarestfs://HOST?token=...')
```
## Building and running tests
```bash
virtualenv -p /usr/bin/python3 venv
. venv/bin/activate
# Install tox
pip install coverage tox
# Run flake8 check
tox -c tox.ini -e flake8
# Run mypy typing check
tox -c tox.ini -e mypy
# Run PyFilesystem test suite
tox -c tox.ini -e fstest
```
## Documentation
- [PyFilesystem Wiki](https://www.pyfilesystem.org)
- [OnedataRESTFS Reference](http://onedatarestfs.readthedocs.io/en/latest/)
- [Onedata Homepage](https://onedata.org)
Raw data
{
"_id": null,
"home_page": "https://github.com/onedata/onedatarestfs",
"name": "fs.onedatarestfs",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "pyfilesystem,Onedata",
"author": "Bartek Kryza",
"author_email": "bkryza@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a5/78/be00a20b38d47c628a7a87ff4cb3c955141ec14f150442a324981bfc67cc/fs.onedatarestfs-21.2.5rc1.tar.gz",
"platform": null,
"description": "# OnedataRESTFS\n\nOnedataRESTFS is a [PyFilesystem](https://www.pyfilesystem.org/) interface to\n[Onedata](https://onedata.org) virtual file system based on [Onedata REST API].\n\nAs a PyFilesystem concrete class, [OnedataRESTFS](https://github.com/onedata/onedatarestfs/)\nallows you to work with Onedata in the same way as any other supported filesystem.\n\n## Installing\n\nYou can install OnedataRESTFS from pip as follows:\n\n```\npip install fs.onedatarestfs\n```\n\n## Opening a OnedataRESTFS\n\nOpen an OnedataRESTFS by explicitly using the constructor:\n\n```python\nfrom fs.onedatarestfs import OnedataRESTFS\nonedata_onezone_host = \"...\"\nonedata_access_token = \"...\"\nodfs = OnedataRESTFS(onedata_onezone_host, onedata_access_token)\n```\n\nOr with a FS URL:\n\n```python\n from fs import open_fs\n odfs = open_fs('onedatarestfs://HOST?token=...')\n```\n\n\n## Building and running tests\n\n```bash\nvirtualenv -p /usr/bin/python3 venv\n. venv/bin/activate\n\n# Install tox\npip install coverage tox\n\n# Run flake8 check\ntox -c tox.ini -e flake8\n\n# Run mypy typing check\ntox -c tox.ini -e mypy\n\n# Run PyFilesystem test suite\ntox -c tox.ini -e fstest\n```\n\n## Documentation\n\n- [PyFilesystem Wiki](https://www.pyfilesystem.org)\n- [OnedataRESTFS Reference](http://onedatarestfs.readthedocs.io/en/latest/)\n- [Onedata Homepage](https://onedata.org)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Onedata REST-based filesystem for PyFilesystem",
"version": "21.2.5rc1",
"project_urls": {
"Homepage": "https://github.com/onedata/onedatarestfs"
},
"split_keywords": [
"pyfilesystem",
"onedata"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a18f73463a4785803e9635a65dc8d62d3adfaf00117588cedf66dc15905891f9",
"md5": "4294badcb890b51dfed33af1d350f64c",
"sha256": "fe54a02085864f170ff1f95c7963f261d2ac368671b05743cf030853f1f054bc"
},
"downloads": -1,
"filename": "fs.onedatarestfs-21.2.5rc1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4294badcb890b51dfed33af1d350f64c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 11337,
"upload_time": "2024-03-04T12:21:17",
"upload_time_iso_8601": "2024-03-04T12:21:17.916677Z",
"url": "https://files.pythonhosted.org/packages/a1/8f/73463a4785803e9635a65dc8d62d3adfaf00117588cedf66dc15905891f9/fs.onedatarestfs-21.2.5rc1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a578be00a20b38d47c628a7a87ff4cb3c955141ec14f150442a324981bfc67cc",
"md5": "9a50038e1cd50739ba71567bdc9616e0",
"sha256": "98ff86f86680032e681b7e5787c12afc2fb69bbbc641cab08aa418420d7cfeaa"
},
"downloads": -1,
"filename": "fs.onedatarestfs-21.2.5rc1.tar.gz",
"has_sig": false,
"md5_digest": "9a50038e1cd50739ba71567bdc9616e0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 11098,
"upload_time": "2024-03-04T12:21:19",
"upload_time_iso_8601": "2024-03-04T12:21:19.249723Z",
"url": "https://files.pythonhosted.org/packages/a5/78/be00a20b38d47c628a7a87ff4cb3c955141ec14f150442a324981bfc67cc/fs.onedatarestfs-21.2.5rc1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-04 12:21:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "onedata",
"github_project": "onedatarestfs",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"tox": true,
"lcname": "fs.onedatarestfs"
}