# ASAM ODSBox
The [*ODSBox*](https://peak-solution.github.io/odsbox) is a lightweight Python wrapper on the standardized [ASAM ODS REST API](https://www.asam.net/standards/detail/ods/wiki/).
Using intuitive JAQuel queries and [pandas.DataFrames](https://pandas.pydata.org/) the *ODSBox* makes dealing with ASAM ODS
data in Python more fun.
``` python
from odsbox.con_i import ConI
with ConI(url="https://MY_SERVER/api", auth=("sa", "sa")) as con_i:
measurements = con_i.query_data(
{
"AoMeasurement": {"name": {"$like": "*"}},
"$attributes": {"name": 1, "id": 1},
"$options": {"$rowlimit": 50},
}
)
print(measurements)
```
## Documentation
* [*ODSBox* documentation](https://peak-solution.github.io/odsbox)
* [Work with ASAM ODS server](https://peak-solution.github.io/data_management_learning_path/ods/query-asam-server.html)
## Communication
The ASAM ODS server is called using HTTP calls defined by the [ASAM ODS standard](https://www.asam.net/standards/detail/ods/wiki/#TechnicalContent).
The messages are encode/decoded using ASAM ODS [protobuf](https://protobuf.dev/programming-guides/proto3/) message definitions provided at
[ASAM-ODS-Interfaces](https://github.com/asam-ev/ASAM-ODS-Interfaces). As content type `application/x-asamods+protobuf` is used.
## JAQuel Queries
JAQuel allows you to query your data in a simple and intuitive way inspired
by [MongoDB Query Language (MQL)](https://www.mongodb.com/docs/manual/tutorial/query-documents/).
The definition of query expression as JSON easily integrates with the Python language – a win-win situation.
## Installation
*ODSBox* is available on.
| | |
| :------------ | :----------------------------------------------------------------------------------- |
| github | [https://github.com/peak-solution/odsbox/](https://github.com/peak-solution/odsbox/) |
| PyPI | [https://pypi.org/project/odsbox/](https://pypi.org/project/odsbox/) |
| github docs | [https://peak-solution.github.io/odsbox](https://peak-solution.github.io/odsbox) |
```shell
# access ASAM ODS server
pip install odsbox
# access ASAM ODS EXD-API plugin
pip install odsbox[exd-data]
```
Raw data
{
"_id": null,
"home_page": null,
"name": "odsbox",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10.12",
"maintainer_email": null,
"keywords": "asam, ods, measurement, data access, data science, data analysis",
"author": null,
"author_email": "Andreas Krantz <a.krantz@peak-solution.de>",
"download_url": "https://files.pythonhosted.org/packages/31/7a/82733f243caa539eb25ae8027b1a7e37a9c2c556b987617d9c9818fe84f1/odsbox-1.0.6.tar.gz",
"platform": null,
"description": "# ASAM ODSBox\n\nThe [*ODSBox*](https://peak-solution.github.io/odsbox) is a lightweight Python wrapper on the standardized [ASAM ODS REST API](https://www.asam.net/standards/detail/ods/wiki/).\nUsing intuitive JAQuel queries and [pandas.DataFrames](https://pandas.pydata.org/) the *ODSBox* makes dealing with ASAM ODS\ndata in Python more fun.\n\n``` python\nfrom odsbox.con_i import ConI\n\nwith ConI(url=\"https://MY_SERVER/api\", auth=(\"sa\", \"sa\")) as con_i:\n measurements = con_i.query_data(\n {\n \"AoMeasurement\": {\"name\": {\"$like\": \"*\"}},\n \"$attributes\": {\"name\": 1, \"id\": 1},\n \"$options\": {\"$rowlimit\": 50},\n }\n )\n print(measurements)\n```\n\n## Documentation\n\n* [*ODSBox* documentation](https://peak-solution.github.io/odsbox)\n* [Work with ASAM ODS server](https://peak-solution.github.io/data_management_learning_path/ods/query-asam-server.html)\n\n## Communication\n\nThe ASAM ODS server is called using HTTP calls defined by the [ASAM ODS standard](https://www.asam.net/standards/detail/ods/wiki/#TechnicalContent).\nThe messages are encode/decoded using ASAM ODS [protobuf](https://protobuf.dev/programming-guides/proto3/) message definitions provided at\n[ASAM-ODS-Interfaces](https://github.com/asam-ev/ASAM-ODS-Interfaces). As content type `application/x-asamods+protobuf` is used.\n\n## JAQuel Queries\n\nJAQuel allows you to query your data in a simple and intuitive way inspired\nby [MongoDB Query Language (MQL)](https://www.mongodb.com/docs/manual/tutorial/query-documents/).\nThe definition of query expression as JSON easily integrates with the Python language \u2013 a win-win situation.\n\n## Installation\n\n*ODSBox* is available on.\n\n| | |\n| :------------ | :----------------------------------------------------------------------------------- |\n| github | [https://github.com/peak-solution/odsbox/](https://github.com/peak-solution/odsbox/) |\n| PyPI | [https://pypi.org/project/odsbox/](https://pypi.org/project/odsbox/) |\n| github docs | [https://peak-solution.github.io/odsbox](https://peak-solution.github.io/odsbox) |\n\n\n```shell\n# access ASAM ODS server\npip install odsbox\n# access ASAM ODS EXD-API plugin\npip install odsbox[exd-data]\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Toolbox for accessing ASAM ODS servers using the HTTP API",
"version": "1.0.6",
"project_urls": {
"Documentation": "https://peak-solution.github.io/odsbox",
"Homepage": "https://github.com/peak-solution/odsbox/tree/main#readme",
"Repository": "https://github.com/peak-solution/odsbox",
"Tracker": "https://github.com/peak-solution/odsbox/issues"
},
"split_keywords": [
"asam",
" ods",
" measurement",
" data access",
" data science",
" data analysis"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8f862cbcaaf05f4533986e67f17c4c4e903e0529d8741bfd6301bddac632017c",
"md5": "3394242b03bbd7b6f390d836aa3ef5fc",
"sha256": "10a4a15ee4bb5d08c22e1faeb95ec70ecf1e70629607b37355a792b790b7257d"
},
"downloads": -1,
"filename": "odsbox-1.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3394242b03bbd7b6f390d836aa3ef5fc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10.12",
"size": 49867,
"upload_time": "2025-06-22T11:13:56",
"upload_time_iso_8601": "2025-06-22T11:13:56.361172Z",
"url": "https://files.pythonhosted.org/packages/8f/86/2cbcaaf05f4533986e67f17c4c4e903e0529d8741bfd6301bddac632017c/odsbox-1.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "317a82733f243caa539eb25ae8027b1a7e37a9c2c556b987617d9c9818fe84f1",
"md5": "4da0ad20574556bfe7f7f2d2c93af5bc",
"sha256": "59bbdb61d76e2c17b4f92475edd8e39682e68bde93f14a283d9d9de38649f812"
},
"downloads": -1,
"filename": "odsbox-1.0.6.tar.gz",
"has_sig": false,
"md5_digest": "4da0ad20574556bfe7f7f2d2c93af5bc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10.12",
"size": 97553,
"upload_time": "2025-06-22T11:13:57",
"upload_time_iso_8601": "2025-06-22T11:13:57.743154Z",
"url": "https://files.pythonhosted.org/packages/31/7a/82733f243caa539eb25ae8027b1a7e37a9c2c556b987617d9c9818fe84f1/odsbox-1.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-06-22 11:13:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "peak-solution",
"github_project": "odsbox",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "odsbox"
}
JSON
