| Name | ibridges JSON |
| Version |
0.1.5
JSON |
| download |
| home_page | None |
| Summary | Package for accessing data and metadata on iRods servers. |
| upload_time | 2024-05-03 10:03:16 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | MIT License Copyright (c) 2024 Utrecht University Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
irods
data management
storage
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# iBridges
[](https://badge.fury.io/py/ibridges)
[](https://github.com/UtrechtUniversity/iBridges/actions/workflows/integration-tests-irods.yml) [](https://github.com/UtrechtUniversity/iBridges/actions/workflows/main.yml)
[](https://github.com/UtrechtUniversity/iBridges/actions/workflows/integration-tests-yoda.yml) 
iBridges is library for scientific programmers who are working with data in iRODS. We provide a wrapper around the [python-irodsclient](https://pypi.org/project/python-irodsclient/) to facilitate easy interaction with the iRODS server. iBridges is currently still in very active development.
## Highlights
- Works on Windows, Mac OS and Linux
- Runs on Python 3.8 or higher.
- Supported iRODS server versions: 4.2.11 or higher and 4.3.0 or higher.
- **Interactive connection** to your iRods server.
- **Upload** and **Download** your data.
- Manipulate the **metadata** on the iRODS server.
- **Synchronize** your data between your local computer and the iRODS server.
- Create and manipulate **Tickets** to temporarily grant access to outside users.
- **Search** through all metadata for your dataset or collection.
- Small number of dependencies (`python-irodsclient` and `tqdm`)
- Safe default options when working with your data.
<p align="center">
<a href="https://github.com/UtrechtUniversity/iBridges/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=%5BBUG%5D">Report Bug</a>
.
<a href="https://github.com/UtrechtUniversity/iBridges/issues/new?assignees=&labels=&projects=&template=feature_request.md&title=%5BFEATURE%5D">Request Feature</a>
.
<a href="https://github.com/UtrechtUniversity/iBridges/discussions/categories/ideas">Share an idea</a>
.
<a href="https://github.com/UtrechtUniversity/iBridges/discussions/categories/general">Leave some feedback</a>
.
<a href="https://github.com/UtrechtUniversity/iBridges/discussions/categories/q-a">Ask a question</a>
</p>
</p>
## Installation
There are two main ways to install iBridges. The recommended way is to use the stable version that is available on PyPi:
```bash
pip install ibridges
```
If you want to install the unstable version to test out new features, you can install the development branch:
```bash
pip install git+https://github.com/UtrechtUniversity/iBridges.git@develop
```
## Usage
Below are some basic examples of the features in iBridges.
```py
# Create an iRODS session
from ibridges import Session
session = Session(irods_env_path="~/.irods/irods_environment.json", password="mypassword")
# Upload data
from ibridges import upload
upload(session, "/your/local/path", "/irods/path")
# Download data
from ibridges import download
download(session, "/irods/path", "/other/local/path")
```
## Commandline interface
To simply upload or download data you do not need to write full python program, we offer a Commandline interface
- Establish a connection
```bash
ibridges init
```
- List a colletion
```bash
# list your home collection
ibridges list
# list a different collection in your home
ibridges list irods:~/<collection>
# list a collection on a different path than your home
ibridges. list irods:<full_irods_path>
```
- Upload data
```bash
ibridges upload my_file.json irods:~/some_collection
```
- Download data
```bash
ibridges download irods:~/some_collection/some_object download_dir
```
- Synchronise data
```bash
ibridges sync some_local_directory irods:~/some_collection
```
## Tutorials
### Documentation
- **[ReadTheDocs](https://ibridges.readthedocs.io/en/latest/)**
### Guides
- [QuickStart](tutorials/QuickStart.ipynb)
- [iRODS Paths](tutorials/iRODS_paths.ipynb)
- [Data synchronisation](tutorials/Data_sync.ipynb)
### Beginners tutorials
- [Setup client configuration](tutorials/01-Setup-and-connect.ipynb)
- [Working with data](tutorials/02-Working-with-data.ipynb)
- [iRODS and local Paths](tutorials/03-iRODS-Paths.ipynb)
- [Metadata](tutorials/04-Metadata.ipynb)
- [Sharing data](tutorials/05-Data-Sharing.ipynb)
## Authors
**Christine Staiger (Maintainer) [ORCID](https://orcid.org/0000-0002-6754-7647)**
- *Wageningen University & Research* 2021 - 2022
- *Utrecht University* 2022
**Tim van Daalen**, *Wageningen University & Research* 2021
**Maarten Schermer (Maintainer) [ORCID](https://orcid.org/my-orcid?orcid=0000-0001-6770-3155)**, *Utrecht University* 2023
**Raoul Schram (Maintainer) [ORCID](https://orcid.org/my-orcid?orcid=0000-0001-6616-230X)**.
*Utrecht University* 2023
## Contributors
**J.P. Mc Farland**,
*University of Groningen, Center for Information Technology*, 2022
## License
This project is licensed under the MIT license.
The full license can be found in [LICENSE](LICENSE).
Raw data
{
"_id": null,
"home_page": null,
"name": "ibridges",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "irods, data management, storage",
"author": null,
"author_email": "Christine Staiger <c.staiger@uu.nl>",
"download_url": "https://files.pythonhosted.org/packages/3b/d8/77fe2038318a847c7d236a6292a38cfe9e3b49cbd4e8158eefa6bc6071b1/ibridges-0.1.5.tar.gz",
"platform": null,
"description": "# iBridges\n[](https://badge.fury.io/py/ibridges)\n[](https://github.com/UtrechtUniversity/iBridges/actions/workflows/integration-tests-irods.yml) [](https://github.com/UtrechtUniversity/iBridges/actions/workflows/main.yml) \n[](https://github.com/UtrechtUniversity/iBridges/actions/workflows/integration-tests-yoda.yml) \n\niBridges is library for scientific programmers who are working with data in iRODS. We provide a wrapper around the [python-irodsclient](https://pypi.org/project/python-irodsclient/) to facilitate easy interaction with the iRODS server. iBridges is currently still in very active development.\n\n## Highlights\n\n- Works on Windows, Mac OS and Linux\n- Runs on Python 3.8 or higher.\n- Supported iRODS server versions: 4.2.11 or higher and 4.3.0 or higher.\n- **Interactive connection** to your iRods server.\n- **Upload** and **Download** your data.\n- Manipulate the **metadata** on the iRODS server.\n- **Synchronize** your data between your local computer and the iRODS server.\n- Create and manipulate **Tickets** to temporarily grant access to outside users.\n- **Search** through all metadata for your dataset or collection.\n- Small number of dependencies (`python-irodsclient` and `tqdm`)\n- Safe default options when working with your data.\n\n\n <p align=\"center\">\n <a href=\"https://github.com/UtrechtUniversity/iBridges/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=%5BBUG%5D\">Report Bug</a>\n .\n <a href=\"https://github.com/UtrechtUniversity/iBridges/issues/new?assignees=&labels=&projects=&template=feature_request.md&title=%5BFEATURE%5D\">Request Feature</a>\n .\n <a href=\"https://github.com/UtrechtUniversity/iBridges/discussions/categories/ideas\">Share an idea</a>\n .\n <a href=\"https://github.com/UtrechtUniversity/iBridges/discussions/categories/general\">Leave some feedback</a>\n .\n <a href=\"https://github.com/UtrechtUniversity/iBridges/discussions/categories/q-a\">Ask a question</a>\n </p>\n</p>\n\n## Installation\n\nThere are two main ways to install iBridges. The recommended way is to use the stable version that is available on PyPi:\n\n```bash\npip install ibridges\n```\n\nIf you want to install the unstable version to test out new features, you can install the development branch:\n\n```bash\npip install git+https://github.com/UtrechtUniversity/iBridges.git@develop\n```\n\n## Usage\n\nBelow are some basic examples of the features in iBridges.\n\n```py\n# Create an iRODS session\nfrom ibridges import Session\n\nsession = Session(irods_env_path=\"~/.irods/irods_environment.json\", password=\"mypassword\")\n\n# Upload data\nfrom ibridges import upload\n\nupload(session, \"/your/local/path\", \"/irods/path\")\n\n# Download data\nfrom ibridges import download\n\ndownload(session, \"/irods/path\", \"/other/local/path\")\n\n```\n\n## Commandline interface\nTo simply upload or download data you do not need to write full python program, we offer a Commandline interface\n\n- Establish a connection\n\n ```bash\n ibridges init\n ```\n\n- List a colletion\n \n ```bash\n # list your home collection\n ibridges list\n \n # list a different collection in your home\n ibridges list irods:~/<collection>\n \n # list a collection on a different path than your home\n ibridges. list irods:<full_irods_path>\n ```\n\n- Upload data\n\n ```bash\n ibridges upload my_file.json irods:~/some_collection\n ```\n\n- Download data\n\n ```bash\n ibridges download irods:~/some_collection/some_object download_dir\n ```\n\n- Synchronise data\n\n ```bash\n ibridges sync some_local_directory irods:~/some_collection\n ```\n\n## Tutorials\n### Documentation\n- **[ReadTheDocs](https://ibridges.readthedocs.io/en/latest/)**\n\n### Guides\n- [QuickStart](tutorials/QuickStart.ipynb)\n- [iRODS Paths](tutorials/iRODS_paths.ipynb)\n- [Data synchronisation](tutorials/Data_sync.ipynb)\n\n### Beginners tutorials\n- [Setup client configuration](tutorials/01-Setup-and-connect.ipynb)\n- [Working with data](tutorials/02-Working-with-data.ipynb)\n- [iRODS and local Paths](tutorials/03-iRODS-Paths.ipynb)\n- [Metadata](tutorials/04-Metadata.ipynb)\n- [Sharing data](tutorials/05-Data-Sharing.ipynb)\n\n## Authors\n\n**Christine Staiger (Maintainer) [ORCID](https://orcid.org/0000-0002-6754-7647)**\n\n- *Wageningen University & Research* 2021 - 2022\n- *Utrecht University* 2022\n\n**Tim van Daalen**, *Wageningen University & Research* 2021\n\n**Maarten Schermer (Maintainer) [ORCID](https://orcid.org/my-orcid?orcid=0000-0001-6770-3155)**, *Utrecht University* 2023\n\n**Raoul Schram (Maintainer) [ORCID](https://orcid.org/my-orcid?orcid=0000-0001-6616-230X)**. \n*Utrecht University* 2023\n\n## Contributors\n\n**J.P. Mc Farland**,\n*University of Groningen, Center for Information Technology*, 2022\n\n## License\nThis project is licensed under the MIT license.\nThe full license can be found in [LICENSE](LICENSE).\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2024 Utrecht University Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "Package for accessing data and metadata on iRods servers.",
"version": "0.1.5",
"project_urls": {
"GitHub": "https://github.com/UtrechtUniversity/iBridges",
"documentation": "https://github.com/UtrechtUniversity/iBridges"
},
"split_keywords": [
"irods",
" data management",
" storage"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2b5b905bdc55d9264c1cf4c9975c48e0a35bfcdbe308e696cbc217dcad5d68fe",
"md5": "42b7e710dbfad9780cb05a5d2c0f4b52",
"sha256": "dcfd26c90016e784bebde2f0bc9a81af043b95fc70ff99a2e42c26504d990fc1"
},
"downloads": -1,
"filename": "ibridges-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "42b7e710dbfad9780cb05a5d2c0f4b52",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 33938,
"upload_time": "2024-05-03T10:03:14",
"upload_time_iso_8601": "2024-05-03T10:03:14.719278Z",
"url": "https://files.pythonhosted.org/packages/2b/5b/905bdc55d9264c1cf4c9975c48e0a35bfcdbe308e696cbc217dcad5d68fe/ibridges-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3bd877fe2038318a847c7d236a6292a38cfe9e3b49cbd4e8158eefa6bc6071b1",
"md5": "d1a1c7f40837e0094451c802518cbc4e",
"sha256": "1082530d78b98a7923dae1ebcb688125997599adc57be0098c226149de204c0d"
},
"downloads": -1,
"filename": "ibridges-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "d1a1c7f40837e0094451c802518cbc4e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 1262081,
"upload_time": "2024-05-03T10:03:16",
"upload_time_iso_8601": "2024-05-03T10:03:16.503396Z",
"url": "https://files.pythonhosted.org/packages/3b/d8/77fe2038318a847c7d236a6292a38cfe9e3b49cbd4e8158eefa6bc6071b1/ibridges-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-03 10:03:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "UtrechtUniversity",
"github_project": "iBridges",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ibridges"
}
