Metadata-Version: 2.1
Name: coscine
Version: 0.10.1
Summary: The Coscine Python SDK provides a pythonic high-level interface to the Coscine REST API.
Home-page: https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk
Author: RWTH Aachen University
Author-email: coscine@itc.rwth-aachen.de
License: MIT License
Project-URL: Issues, https://git.rwth-aachen.de/coscine/community-features/coscine-python-sdk/-/issues
Project-URL: Documentation, https://coscine.pages.rwth-aachen.de/community-features/coscine-python-sdk/
Keywords: Coscine,RWTH Aachen,Research Data Management
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 5 - Production/Stable
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: boto3
Requires-Dist: pyshacl
Requires-Dist: python-dateutil
Requires-Dist: rdflib
Requires-Dist: requests
Requires-Dist: requests-cache
Requires-Dist: requests-toolbelt
Requires-Dist: tabulate
Requires-Dist: tqdm

# 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
resource.upload("file.csv", "C:/research/file.csv", 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
