kadi-apy


Namekadi-apy JSON
Version 0.38.0 PyPI version JSON
download
home_page
SummaryAPI wrapper library for Kadi4Mat
upload_time2024-02-26 15:34:14
maintainer
docs_urlNone
authorKarlsruhe Institute of Technology
requires_python<3.13,>=3.8
licenseApache-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"
}
        
Elapsed time: 0.20300s