Name | kadi-apy JSON |
Version |
0.38.0
JSON |
| download |
home_page | |
Summary | API wrapper library for Kadi4Mat |
upload_time | 2024-02-26 15:34:14 |
maintainer | |
docs_url | None |
author | Karlsruhe Institute of Technology |
requires_python | <3.13,>=3.8 |
license | Apache-2.0 |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# Kadi-APY
**Kadi-APY** is a library for use in tandem with
[Kadi4Mat](https://gitlab.com/iam-cms/kadi "Kadi4Mat"). The REST-like API of
Kadi4Mat makes it possible to programmatically interact with most of the
resources that can be used through the web interface by sending suitable HTTP
requests to the different endpoints the API provides.
The goal of this library is to make the use of this API as easy as possible. It
offers both an object oriented approach to work with the API in Python as well
as a command line interface (CLI). The library is written in Python 3 and works
under both Linux and Windows.
## Quickstart
### Installation
The library can be installed using pip:
`pip3 install kadi-apy`
Note that Python version **>=3.8** is required to install the latest version.
### Configuration
To connect to an existing Kadi4Mat instance, some further configuration is
required, which can be initialized by running:
`kadi-apy config create`
### Simple Python example
Retrieve an existing record by its ID and upload a file to it:
```python
from kadi_apy import KadiManager
manager = KadiManager()
record = manager.record(id=1)
record.upload_file("/path/to/file.txt")
```
### Simple CLI example
Do the same as in the example above:
```shell
kadi-apy records add-files -r 1 -n /path/to/file.txt
```
## Issues
For any issues regarding the kadi-apy (bugs, suggestions, discussions, etc.)
please use the [issue tracker](https://gitlab.com/iam-cms/kadi-apy/-/issues) of
this project. Before creating an issue, please make sure that no similar issue
is already open and that you are using the latest
[release](https://pypi.org/project/kadi-apy/) or the current version of the
**develop** branch. Note that creating a new issue requires a GitLab account.
For **bugs** in particular, please use the provided `Bug` template when
creating an issue, which also adds the `Bug` label to the issue automatically.
## Contributions
Contributions to the code are always welcome. In order to merge any
contributions back into the main repository, please open a corresponding [merge
request](https://gitlab.com/iam-cms/kadi-apy/-/merge_requests). Please notice
that all merge requests should go to the **develop** branch.
For instructions on how to set up a development environment, please see the
[documentation](https://kadi-apy.readthedocs.io/en/latest) for more details.
## Further links
* Source code: https://gitlab.com/iam-cms/kadi-apy
* Releases: https://pypi.org/project/kadi-apy/
* Documentation:
* Stable (reflecting the latest release): https://kadi-apy.readthedocs.io/en/stable/
* Latest (reflecting the *develop* branch): https://kadi-apy.readthedocs.io/en/latest/
Raw data
{
"_id": null,
"home_page": "",
"name": "kadi-apy",
"maintainer": "",
"docs_url": null,
"requires_python": "<3.13,>=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Karlsruhe Institute of Technology",
"author_email": "",
"download_url": "",
"platform": null,
"description": "# Kadi-APY\n\n**Kadi-APY** is a library for use in tandem with\n[Kadi4Mat](https://gitlab.com/iam-cms/kadi \"Kadi4Mat\"). The REST-like API of\nKadi4Mat makes it possible to programmatically interact with most of the\nresources that can be used through the web interface by sending suitable HTTP\nrequests to the different endpoints the API provides.\n\nThe goal of this library is to make the use of this API as easy as possible. It\noffers both an object oriented approach to work with the API in Python as well\nas a command line interface (CLI). The library is written in Python 3 and works\nunder both Linux and Windows.\n\n## Quickstart\n\n### Installation\n\nThe library can be installed using pip:\n\n`pip3 install kadi-apy`\n\nNote that Python version **>=3.8** is required to install the latest version.\n\n### Configuration\n\nTo connect to an existing Kadi4Mat instance, some further configuration is\nrequired, which can be initialized by running:\n\n`kadi-apy config create`\n\n### Simple Python example\n\nRetrieve an existing record by its ID and upload a file to it:\n\n```python\nfrom kadi_apy import KadiManager\n\nmanager = KadiManager()\n\nrecord = manager.record(id=1)\nrecord.upload_file(\"/path/to/file.txt\")\n```\n\n### Simple CLI example\n\nDo the same as in the example above:\n\n```shell\nkadi-apy records add-files -r 1 -n /path/to/file.txt\n```\n\n## Issues\n\nFor any issues regarding the kadi-apy (bugs, suggestions, discussions, etc.)\nplease use the [issue tracker](https://gitlab.com/iam-cms/kadi-apy/-/issues) of\nthis project. Before creating an issue, please make sure that no similar issue\nis already open and that you are using the latest\n[release](https://pypi.org/project/kadi-apy/) or the current version of the\n**develop** branch. Note that creating a new issue requires a GitLab account.\n\nFor **bugs** in particular, please use the provided `Bug` template when\ncreating an issue, which also adds the `Bug` label to the issue automatically.\n\n## Contributions\n\nContributions to the code are always welcome. In order to merge any\ncontributions back into the main repository, please open a corresponding [merge\nrequest](https://gitlab.com/iam-cms/kadi-apy/-/merge_requests). Please notice\nthat all merge requests should go to the **develop** branch.\n\nFor instructions on how to set up a development environment, please see the\n[documentation](https://kadi-apy.readthedocs.io/en/latest) for more details.\n\n## Further links\n\n* Source code: https://gitlab.com/iam-cms/kadi-apy\n* Releases: https://pypi.org/project/kadi-apy/\n* Documentation:\n * Stable (reflecting the latest release): https://kadi-apy.readthedocs.io/en/stable/\n * Latest (reflecting the *develop* branch): https://kadi-apy.readthedocs.io/en/latest/\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "API wrapper library for Kadi4Mat",
"version": "0.38.0",
"project_urls": {
"Source": "https://gitlab.com/iam-cms/kadi-apy"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5c84059cb5efaf02691bdf063f258094fea1bdc69664c75d8de54a3f82223b2b",
"md5": "3c67cdb06459e3ef9412ee5556f7f4ad",
"sha256": "dac603d85319d3fbe8c8ac54d43535e05ad43fe1b529309c9fd167d5dc2ca031"
},
"downloads": -1,
"filename": "kadi_apy-0.38.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3c67cdb06459e3ef9412ee5556f7f4ad",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.8",
"size": 82922,
"upload_time": "2024-02-26T15:34:14",
"upload_time_iso_8601": "2024-02-26T15:34:14.754973Z",
"url": "https://files.pythonhosted.org/packages/5c/84/059cb5efaf02691bdf063f258094fea1bdc69664c75d8de54a3f82223b2b/kadi_apy-0.38.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-26 15:34:14",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "iam-cms",
"gitlab_project": "kadi-apy",
"lcname": "kadi-apy"
}