# Coscine Python SDK
![python-logo] ![coscine-logo]
[Coscine](https://coscine.de), short for **Co**llaborative **Sc**ientific
**In**tegration **E**nvironment, is a platform for Research Data Management.
The Coscine Python SDK is an open source package that provides
a high-level interface to the Coscine REST API. It enables you
to automate research workflows and offers the usual functionality
available in the Coscine web interface to python programmers.
## Showcase
Uploading a file to a resource:
```python
import coscine
from datetime import datetime
token = "My Coscine API token"
client = coscine.ApiClient(token)
project = client.project("My Project")
resource = project.resource("My Resource")
form = resource.metadata_form()
form["Author"] = "Dr. Akula"
form["Created"] = datetime.now()
form["DAP"] = 3.12
with open("file.csv", "r") as fp:
resource.upload("file.csv", fp, form)
```
## Documentation
Installation instructions and an in-depth guide on using the Python SDK can
be found in the online [documentation]. The source code itself has been
heavily annotated with numpy-style DOCstrings. You can generate a local
copy of the documentation using Sphinx:
```bash
py -m pip install -U requirements.txt
cd docs
set SPHINXBUILD=py -m sphinx.cmd.build
py -m sphinx.ext.apidoc -o . ../src/coscine
make html
```
## Contact
To report bugs, request features or resolve questions open an issue inside
of the current git repository. Contributions and any help on improving this
package are appreciated. To contribute source code you may fork
the repository and open a merge request or simply submit a short
and relevant snippet or fix inside of an issue.
## License
This project is Open Source Software and licensed under the terms of
the [MIT License].
[coscine-logo]: https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk/-/raw/master/docs/_static/coscine_logo_rgb.png
[python-logo]: https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk/-/raw/master/docs/_static/python-powered-w-200x80.png
[documentation]: https://coscine.pages.rwth-aachen.de/community-features/coscine-python-sdk/
[MIT License]: https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk/-/blob/master/LICENSE.txt
Raw data
{
"_id": null,
"home_page": "https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk",
"name": "coscine",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "Coscine, RWTH Aachen, Research Data Management",
"author": "RWTH Aachen University",
"author_email": "coscine@itc.rwth-aachen.de",
"download_url": "https://files.pythonhosted.org/packages/c8/eb/478ea3b13ffd229deb68cea9180fec28bc5a6e08aaacee1ee3e57522d2fa/coscine-0.11.7.tar.gz",
"platform": null,
"description": "# Coscine Python SDK\n![python-logo] ![coscine-logo] \n\n[Coscine](https://coscine.de), short for **Co**llaborative **Sc**ientific\n**In**tegration **E**nvironment, is a platform for Research Data Management.\nThe Coscine Python SDK is an open source package that provides\na high-level interface to the Coscine REST API. It enables you\nto automate research workflows and offers the usual functionality\navailable in the Coscine web interface to python programmers.\n\n## Showcase\nUploading a file to a resource: \n```python\nimport coscine\nfrom datetime import datetime\n\ntoken = \"My Coscine API token\"\nclient = coscine.ApiClient(token)\nproject = client.project(\"My Project\")\nresource = project.resource(\"My Resource\")\nform = resource.metadata_form()\nform[\"Author\"] = \"Dr. Akula\"\nform[\"Created\"] = datetime.now()\nform[\"DAP\"] = 3.12\nwith open(\"file.csv\", \"r\") as fp:\n resource.upload(\"file.csv\", fp, form)\n```\n\n## Documentation\nInstallation instructions and an in-depth guide on using the Python SDK can\nbe found in the online [documentation]. The source code itself has been\nheavily annotated with numpy-style DOCstrings. You can generate a local\ncopy of the documentation using Sphinx: \n\n```bash\npy -m pip install -U requirements.txt\ncd docs\nset SPHINXBUILD=py -m sphinx.cmd.build\npy -m sphinx.ext.apidoc -o . ../src/coscine\nmake html\n```\n\n## Contact\nTo report bugs, request features or resolve questions open an issue inside\nof the current git repository. Contributions and any help on improving this\npackage are appreciated. To contribute source code you may fork\nthe repository and open a merge request or simply submit a short\nand relevant snippet or fix inside of an issue.\n\n## License\nThis project is Open Source Software and licensed under the terms of\nthe [MIT License].\n\n[coscine-logo]: https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk/-/raw/master/docs/_static/coscine_logo_rgb.png\n[python-logo]: https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk/-/raw/master/docs/_static/python-powered-w-200x80.png\n[documentation]: https://coscine.pages.rwth-aachen.de/community-features/coscine-python-sdk/\n[MIT License]: https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk/-/blob/master/LICENSE.txt\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "The Coscine Python SDK provides a pythonic high-level interface to the Coscine REST API.",
"version": "0.11.7",
"project_urls": {
"Documentation": "https://coscine.pages.rwth-aachen.de/community-features/coscine-python-sdk/",
"Homepage": "https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk",
"Issues": "https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk/-/issues"
},
"split_keywords": [
"coscine",
" rwth aachen",
" research data management"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2a5a97c344e0ced31e64a62aff14aec25259e524b9738213ce1d34dbdaf55072",
"md5": "555dae759fc6317367ca75fa8d6145fb",
"sha256": "9c45d148070aef33dccb5a012f003e333bcd0cc9a467225709351aea2278e2b7"
},
"downloads": -1,
"filename": "coscine-0.11.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "555dae759fc6317367ca75fa8d6145fb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 39856,
"upload_time": "2024-11-04T16:06:48",
"upload_time_iso_8601": "2024-11-04T16:06:48.953294Z",
"url": "https://files.pythonhosted.org/packages/2a/5a/97c344e0ced31e64a62aff14aec25259e524b9738213ce1d34dbdaf55072/coscine-0.11.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c8eb478ea3b13ffd229deb68cea9180fec28bc5a6e08aaacee1ee3e57522d2fa",
"md5": "ddc89853fd635cbf6e6657dfa892775a",
"sha256": "64cc28a8db1d7a2d89132fc33682bd9836f3d37a13c12993666602ee2c624079"
},
"downloads": -1,
"filename": "coscine-0.11.7.tar.gz",
"has_sig": false,
"md5_digest": "ddc89853fd635cbf6e6657dfa892775a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 37429,
"upload_time": "2024-11-04T16:06:51",
"upload_time_iso_8601": "2024-11-04T16:06:51.454055Z",
"url": "https://files.pythonhosted.org/packages/c8/eb/478ea3b13ffd229deb68cea9180fec28bc5a6e08aaacee1ee3e57522d2fa/coscine-0.11.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-04 16:06:51",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "coscine"
}
JSON