# DataLad-OSF: Opening up the Open Science Framework for DataLad
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[](#contributors-)
<!-- ALL-CONTRIBUTORS-BADGE:END -->
[](https://GitHub.com/datalad/datalad-osf/releases/) [](https://pypi.python.org/pypi/datalad-osf/) [](https://ci.appveyor.com/project/mih/datalad-osf/branch/master) [](https://codecov.io/github/datalad/datalad-osf?branch=master) [](https://github.com/datalad/datalad-osf/actions?query=workflow%3Adocs) [](http://docs.datalad.org/projects/osf/en/latest/?badge=latest) [](https://zenodo.org/badge/latestdoi/272689400)
Welcome! This repository contains a [DataLad](http://datalad.org) extension that enables DataLad to work with the Open Science Framework (OSF). Use it to share, retrieve and collaborate on DataLad datasets via the OSF.
The development of this tool started at [OHBM Brainhack 2020](https://github.com/ohbm/hackathon2020/issues/156) in June 2020, coordinated in [this repository](https://github.com/adswa/git-annex-remote-osf). See our [documentation](http://docs.datalad.org/projects/osf) for more extensive information.
## Requirements
- Datalad: relies on [git-annex](http://docs.datalad.org/projects/osf/en/latest/git-annex.branchable.com/), [Git](http://docs.datalad.org/projects/osf/en/latest/git-scm.com/) and Python. If you don’t have DataLad installed yet, please follow the instructions [here](http://handbook.datalad.org/en/latest/intro/installation.html).
- Account on the [Open Science Framework (OSF)](https://osf.io/register)
## Installation
```
# create and enter a new virtual environment (optional)
$ virtualenv --python=python3 ~/env/dl-osf
$ . ~/env/dl-osf/bin/activate
# install from PyPi
$ pip install datalad-osf
```
## How to use
See our [documentation](http://docs.datalad.org/projects/osf/) for more info on how to use this tool and a tutorial on major use cases.
## How to contribute
You are very welcome to help out developing this tool further. You can contribute by:
- Creating an issue for bugs or tips for further development
- Making a pull request for any changes suggested by yourself
- Testing out the software and communicating your feedback to us
Please see our contributing guidelines for more information.
## Contributors ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tr>
<td align="center"><a href="http://psychoinformatics.de"><img src="https://avatars1.githubusercontent.com/u/136479?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Michael Hanke</b></sub></a><br /><a href="#maintenance-mih" title="Maintenance">🚧</a> <a href="https://github.com/datalad/datalad-osf/commits?author=mih" title="Code">💻</a> <a href="https://github.com/datalad/datalad-osf/issues?q=author%3Amih" title="Bug reports">🐛</a> <a href="#ideas-mih" title="Ideas, Planning, & Feedback">🤔</a></td>
<td align="center"><a href="https://github.com/DorienHuijser"><img src="https://avatars1.githubusercontent.com/u/58177697?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Dorien Huijser</b></sub></a><br /><a href="https://github.com/datalad/datalad-osf/commits?author=DorienHuijser" title="Documentation">📖</a> <a href="#projectManagement-DorienHuijser" title="Project Management">📆</a> <a href="#ideas-DorienHuijser" title="Ideas, Planning, & Feedback">🤔</a> <a href="#userTesting-DorienHuijser" title="User Testing">📓</a></td>
<td align="center"><a href="https://github.com/TheDragon246"><img src="https://avatars2.githubusercontent.com/u/63247401?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ashish Sahoo</b></sub></a><br /><a href="https://github.com/datalad/datalad-osf/commits?author=TheDragon246" title="Documentation">📖</a> <a href="#maintenance-TheDragon246" title="Maintenance">🚧</a></td>
<td align="center"><a href="https://github.com/SRSteinkamp"><img src="https://avatars2.githubusercontent.com/u/17494653?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Simon Steinkamp</b></sub></a><br /><a href="https://github.com/datalad/datalad-osf/commits?author=SRSteinkamp" title="Tests">⚠️</a> <a href="https://github.com/datalad/datalad-osf/commits?author=SRSteinkamp" title="Documentation">📖</a> <a href="#projectManagement-SRSteinkamp" title="Project Management">📆</a> <a href="#ideas-SRSteinkamp" title="Ideas, Planning, & Feedback">🤔</a> <a href="#userTesting-SRSteinkamp" title="User Testing">📓</a> <a href="#maintenance-SRSteinkamp" title="Maintenance">🚧</a></td>
<td align="center"><a href="https://github.com/bpoldrack"><img src="https://avatars2.githubusercontent.com/u/10498301?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Benjamin Poldrack</b></sub></a><br /><a href="#projectManagement-bpoldrack" title="Project Management">📆</a> <a href="#ideas-bpoldrack" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/datalad/datalad-osf/commits?author=bpoldrack" title="Code">💻</a> <a href="#maintenance-bpoldrack" title="Maintenance">🚧</a></td>
<td align="center"><a href="https://gitlab.com/kousu"><img src="https://avatars2.githubusercontent.com/u/987487?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nick</b></sub></a><br /><a href="#projectManagement-kousu" title="Project Management">📆</a> <a href="#ideas-kousu" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/datalad/datalad-osf/commits?author=kousu" title="Code">💻</a> <a href="#maintenance-kousu" title="Maintenance">🚧</a></td>
<td align="center"><a href="https://github.com/nbeliy"><img src="https://avatars0.githubusercontent.com/u/44231332?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nikita Beliy</b></sub></a><br /><a href="#ideas-nbeliy" title="Ideas, Planning, & Feedback">🤔</a> <a href="#userTesting-nbeliy" title="User Testing">📓</a></td>
</tr>
<tr>
<td align="center"><a href="https://github.com/mjboos"><img src="https://avatars0.githubusercontent.com/u/7125006?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Moritz J. Boos</b></sub></a><br /><a href="https://github.com/datalad/datalad-osf/commits?author=mjboos" title="Code">💻</a> <a href="#userTesting-mjboos" title="User Testing">📓</a> <a href="#ideas-mjboos" title="Ideas, Planning, & Feedback">🤔</a> <a href="#maintenance-mjboos" title="Maintenance">🚧</a></td>
<td align="center"><a href="http://www.adina-wagner.com"><img src="https://avatars1.githubusercontent.com/u/29738718?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Adina Wagner</b></sub></a><br /><a href="#projectManagement-adswa" title="Project Management">📆</a> <a href="#ideas-adswa" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/datalad/datalad-osf/commits?author=adswa" title="Code">💻</a> <a href="https://github.com/datalad/datalad-osf/commits?author=adswa" title="Documentation">📖</a> <a href="#maintenance-adswa" title="Maintenance">🚧</a></td>
<td align="center"><a href="https://www.stefanappelhoff.com"><img src="https://avatars1.githubusercontent.com/u/9084751?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Stefan Appelhoff</b></sub></a><br /><a href="https://github.com/datalad/datalad-osf/commits?author=sappelhoff" title="Documentation">📖</a> <a href="#userTesting-sappelhoff" title="User Testing">📓</a></td>
<td align="center"><a href="https://github.com/thomasrockhu-codecov"><img src="https://avatars.githubusercontent.com/u/88201630?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tom Hu</b></sub></a><br /><a href="#infra-thomasrockhu-codecov" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
</tr>
</table>
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
## Acknowledgements
This DataLad extension was developed with support from the German Federal
Ministry of Education and Research (BMBF 01GQ1905), and the US National Science
Foundation (NSF 1912266).
Raw data
{
"_id": null,
"home_page": "https://github.com/datalad/datalad-osf",
"name": "datalad-osf",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "The DataLad Team and Contributors",
"author_email": "team@datalad.org",
"download_url": "https://files.pythonhosted.org/packages/e3/b3/d31c80c7e845ffaaf34c207482e95bec0258a097f4836f974bc075d526fd/datalad_osf-0.3.0.tar.gz",
"platform": null,
"description": "# DataLad-OSF: Opening up the Open Science Framework for DataLad \n<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->\n[](#contributors-)\n<!-- ALL-CONTRIBUTORS-BADGE:END -->\n\n[](https://GitHub.com/datalad/datalad-osf/releases/) [](https://pypi.python.org/pypi/datalad-osf/) [](https://ci.appveyor.com/project/mih/datalad-osf/branch/master) [](https://codecov.io/github/datalad/datalad-osf?branch=master) [](https://github.com/datalad/datalad-osf/actions?query=workflow%3Adocs) [](http://docs.datalad.org/projects/osf/en/latest/?badge=latest) [](https://zenodo.org/badge/latestdoi/272689400)\n\n\nWelcome! This repository contains a [DataLad](http://datalad.org) extension that enables DataLad to work with the Open Science Framework (OSF). Use it to share, retrieve and collaborate on DataLad datasets via the OSF.\n\nThe development of this tool started at [OHBM Brainhack 2020](https://github.com/ohbm/hackathon2020/issues/156) in June 2020, coordinated in [this repository](https://github.com/adswa/git-annex-remote-osf). See our [documentation](http://docs.datalad.org/projects/osf) for more extensive information.\n\n## Requirements\n\n- Datalad: relies on [git-annex](http://docs.datalad.org/projects/osf/en/latest/git-annex.branchable.com/), [Git](http://docs.datalad.org/projects/osf/en/latest/git-scm.com/) and Python. If you don\u2019t have DataLad installed yet, please follow the instructions [here](http://handbook.datalad.org/en/latest/intro/installation.html).\n- Account on the [Open Science Framework (OSF)](https://osf.io/register)\n\n## Installation\n\n```\n# create and enter a new virtual environment (optional)\n$ virtualenv --python=python3 ~/env/dl-osf\n$ . ~/env/dl-osf/bin/activate\n# install from PyPi\n$ pip install datalad-osf\n```\n\n## How to use\n\nSee our [documentation](http://docs.datalad.org/projects/osf/) for more info on how to use this tool and a tutorial on major use cases.\n\n## How to contribute\nYou are very welcome to help out developing this tool further. You can contribute by:\n\n- Creating an issue for bugs or tips for further development\n- Making a pull request for any changes suggested by yourself\n- Testing out the software and communicating your feedback to us\n\nPlease see our contributing guidelines for more information.\n\n## Contributors \u2728\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n<!-- prettier-ignore-start -->\n<!-- markdownlint-disable -->\n<table>\n <tr>\n <td align=\"center\"><a href=\"http://psychoinformatics.de\"><img src=\"https://avatars1.githubusercontent.com/u/136479?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Michael Hanke</b></sub></a><br /><a href=\"#maintenance-mih\" title=\"Maintenance\">\ud83d\udea7</a> <a href=\"https://github.com/datalad/datalad-osf/commits?author=mih\" title=\"Code\">\ud83d\udcbb</a> <a href=\"https://github.com/datalad/datalad-osf/issues?q=author%3Amih\" title=\"Bug reports\">\ud83d\udc1b</a> <a href=\"#ideas-mih\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a></td>\n <td align=\"center\"><a href=\"https://github.com/DorienHuijser\"><img src=\"https://avatars1.githubusercontent.com/u/58177697?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Dorien Huijser</b></sub></a><br /><a href=\"https://github.com/datalad/datalad-osf/commits?author=DorienHuijser\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"#projectManagement-DorienHuijser\" title=\"Project Management\">\ud83d\udcc6</a> <a href=\"#ideas-DorienHuijser\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"#userTesting-DorienHuijser\" title=\"User Testing\">\ud83d\udcd3</a></td>\n <td align=\"center\"><a href=\"https://github.com/TheDragon246\"><img src=\"https://avatars2.githubusercontent.com/u/63247401?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Ashish Sahoo</b></sub></a><br /><a href=\"https://github.com/datalad/datalad-osf/commits?author=TheDragon246\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"#maintenance-TheDragon246\" title=\"Maintenance\">\ud83d\udea7</a></td>\n <td align=\"center\"><a href=\"https://github.com/SRSteinkamp\"><img src=\"https://avatars2.githubusercontent.com/u/17494653?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Simon Steinkamp</b></sub></a><br /><a href=\"https://github.com/datalad/datalad-osf/commits?author=SRSteinkamp\" title=\"Tests\">\u26a0\ufe0f</a> <a href=\"https://github.com/datalad/datalad-osf/commits?author=SRSteinkamp\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"#projectManagement-SRSteinkamp\" title=\"Project Management\">\ud83d\udcc6</a> <a href=\"#ideas-SRSteinkamp\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"#userTesting-SRSteinkamp\" title=\"User Testing\">\ud83d\udcd3</a> <a href=\"#maintenance-SRSteinkamp\" title=\"Maintenance\">\ud83d\udea7</a></td>\n <td align=\"center\"><a href=\"https://github.com/bpoldrack\"><img src=\"https://avatars2.githubusercontent.com/u/10498301?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Benjamin Poldrack</b></sub></a><br /><a href=\"#projectManagement-bpoldrack\" title=\"Project Management\">\ud83d\udcc6</a> <a href=\"#ideas-bpoldrack\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"https://github.com/datalad/datalad-osf/commits?author=bpoldrack\" title=\"Code\">\ud83d\udcbb</a> <a href=\"#maintenance-bpoldrack\" title=\"Maintenance\">\ud83d\udea7</a></td>\n <td align=\"center\"><a href=\"https://gitlab.com/kousu\"><img src=\"https://avatars2.githubusercontent.com/u/987487?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Nick</b></sub></a><br /><a href=\"#projectManagement-kousu\" title=\"Project Management\">\ud83d\udcc6</a> <a href=\"#ideas-kousu\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"https://github.com/datalad/datalad-osf/commits?author=kousu\" title=\"Code\">\ud83d\udcbb</a> <a href=\"#maintenance-kousu\" title=\"Maintenance\">\ud83d\udea7</a></td>\n <td align=\"center\"><a href=\"https://github.com/nbeliy\"><img src=\"https://avatars0.githubusercontent.com/u/44231332?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Nikita Beliy</b></sub></a><br /><a href=\"#ideas-nbeliy\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"#userTesting-nbeliy\" title=\"User Testing\">\ud83d\udcd3</a></td>\n </tr>\n <tr>\n <td align=\"center\"><a href=\"https://github.com/mjboos\"><img src=\"https://avatars0.githubusercontent.com/u/7125006?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Moritz J. Boos</b></sub></a><br /><a href=\"https://github.com/datalad/datalad-osf/commits?author=mjboos\" title=\"Code\">\ud83d\udcbb</a> <a href=\"#userTesting-mjboos\" title=\"User Testing\">\ud83d\udcd3</a> <a href=\"#ideas-mjboos\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"#maintenance-mjboos\" title=\"Maintenance\">\ud83d\udea7</a></td>\n <td align=\"center\"><a href=\"http://www.adina-wagner.com\"><img src=\"https://avatars1.githubusercontent.com/u/29738718?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Adina Wagner</b></sub></a><br /><a href=\"#projectManagement-adswa\" title=\"Project Management\">\ud83d\udcc6</a> <a href=\"#ideas-adswa\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"https://github.com/datalad/datalad-osf/commits?author=adswa\" title=\"Code\">\ud83d\udcbb</a> <a href=\"https://github.com/datalad/datalad-osf/commits?author=adswa\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"#maintenance-adswa\" title=\"Maintenance\">\ud83d\udea7</a></td>\n <td align=\"center\"><a href=\"https://www.stefanappelhoff.com\"><img src=\"https://avatars1.githubusercontent.com/u/9084751?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Stefan Appelhoff</b></sub></a><br /><a href=\"https://github.com/datalad/datalad-osf/commits?author=sappelhoff\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"#userTesting-sappelhoff\" title=\"User Testing\">\ud83d\udcd3</a></td>\n <td align=\"center\"><a href=\"https://github.com/thomasrockhu-codecov\"><img src=\"https://avatars.githubusercontent.com/u/88201630?v=4?s=100\" width=\"100px;\" alt=\"\"/><br /><sub><b>Tom Hu</b></sub></a><br /><a href=\"#infra-thomasrockhu-codecov\" title=\"Infrastructure (Hosting, Build-Tools, etc)\">\ud83d\ude87</a></td>\n </tr>\n</table>\n\n<!-- markdownlint-restore -->\n<!-- prettier-ignore-end -->\n\n<!-- ALL-CONTRIBUTORS-LIST:END -->\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n\n## Acknowledgements\n\nThis DataLad extension was developed with support from the German Federal\nMinistry of Education and Research (BMBF 01GQ1905), and the US National Science\nFoundation (NSF 1912266).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "DataLad extension to interface with the Open Science Framework (OSF)",
"version": "0.3.0",
"project_urls": {
"Homepage": "https://github.com/datalad/datalad-osf"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "53eee97f37023938022e38d3abb28058191025c7a2cb240210e7e016f21fee72",
"md5": "d92f648128f7163642d7a0fe3ff95f45",
"sha256": "2cdc42ac3015d0734ac1f386a2f09fe2bfd2bad56e2035ebcce87a378b0ec209"
},
"downloads": -1,
"filename": "datalad_osf-0.3.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "d92f648128f7163642d7a0fe3ff95f45",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 26384,
"upload_time": "2023-06-09T09:45:40",
"upload_time_iso_8601": "2023-06-09T09:45:40.014294Z",
"url": "https://files.pythonhosted.org/packages/53/ee/e97f37023938022e38d3abb28058191025c7a2cb240210e7e016f21fee72/datalad_osf-0.3.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e3b3d31c80c7e845ffaaf34c207482e95bec0258a097f4836f974bc075d526fd",
"md5": "f4c7154b412c6fd220844146a9d5da2b",
"sha256": "ce2690a2db78661a3ee5d1f6de30df608ba40f9a35158a436de358c443c0605c"
},
"downloads": -1,
"filename": "datalad_osf-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "f4c7154b412c6fd220844146a9d5da2b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 41563,
"upload_time": "2023-06-09T09:45:42",
"upload_time_iso_8601": "2023-06-09T09:45:42.049162Z",
"url": "https://files.pythonhosted.org/packages/e3/b3/d31c80c7e845ffaaf34c207482e95bec0258a097f4836f974bc075d526fd/datalad_osf-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-09 09:45:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "datalad",
"github_project": "datalad-osf",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"appveyor": true,
"lcname": "datalad-osf"
}
JSON
