<!--
~ Licensed to the Apache Software Foundation (ASF) under one or more
~ contributor license agreements. See the NOTICE file distributed with
~ this work for additional information regarding copyright ownership.
~ The ASF licenses this file to You under the Apache License, Version 2.0
~ (the "License"); you may not use this file except in compliance with
~ the License. You may obtain a copy of the License at
~
~ http://www.apache.org/licenses/LICENSE-2.0
~
~ Unless required by applicable law or agreed to in writing, software
~ distributed under the License is distributed on an "AS IS" BASIS,
~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
~ See the License for the specific language governing permissions and
~ limitations under the License.
~
-->
<h1 align="center">
<br>
<img src="https://raw.githubusercontent.com/apache/streampipes/dev/streampipes-client-python/docs/img/streampipes-python.png"
alt="StreamPipes Logo with Python" title="Apache StreamPipes Logo with Python" width="75%"/>
<br>
</h1>
<h4 align="center"><a href="[StreamPipes](https://github.com/apache/streampipes)">StreamPipes</a> is a self-service (Industrial) IoT toolbox to enable non-technical users to connect , analyze and explore IoT data streams.</h4>
<br>
<h3 align="center">Apache StreamPipes for Python</h3>
<p align="center"> Apache StreamPipes meets Python! We are working highly motivated on a Python library to interact with StreamPipes.
In this way, we would like to unite the power of StreamPipes to easily connect to and read different data sources, especially in the IoT domain,
and the amazing universe of data analytics libraries in Python. </p>
<br>
<p align="center">
<a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">
<img src="https://img.shields.io/github/license/apache/streampipes.svg" alt="License Apache 2.0">
</a>
<a href="https://github.com/apache/streampipes/tree/dev/streampipes-client-python" target="_blank">
<img src="https://img.shields.io/pypi/pyversions/streampipes" alt="Supported Python versions">
</a>
<a href="https://pypi.org/project/streampipes/" target="_blank">
<img src="https://img.shields.io/pypi/v/streampipes" alt="Current PyPI version">
</a>
<a href="https://streampipes.apache.org/docs/docs/python/latest/" target="_blank">
<img src="https://github.com/apache/streampipes-website/actions/workflows/update-python-docs.yml/badge.svg" alt="Status Python Docs">
</a>
<a href="https://github.com/psf/black" target="_blank">
<img src="https://img.shields.io/badge/code%20style-black-black" alt="Code Style: Black">
</a>
<a href="https://github.com/python/mypy" target="_blank">
<img src="https://img.shields.io/badge/typed-mypy-blue" alt="Typed: MyPy">
</a>
<a href="https://python-poetry.org" target="_blank">
<img src="https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json" alt="Dependency & Build Management: Poetry">
</a>
<img src="https://raw.githubusercontent.com/apache/streampipes/dev/streampipes-client-python/docs/img/interrogate_badge.svg" alt= “interrogate” height="20">
<a href="https://pypi.org/project/streampipes/" target="_blank">
<img src="https://img.shields.io/pypi/dm/streampipes" alt="Downloads: PyPI/Month">
</a>
</p>
---
<br>
<h4 align="center">💡The current version of this Python client is still a beta version.</h4>
<h4 align="center">This means that it is still under development, which may result in frequent and extensive API changes, unstable behavior, etc.</h4>
<br>
## 📚 Documentation
Please visit our [documentation](https://streampipes.apache.org/docs/docs/python/latest/).
There you can find information about how to [get started](https://streampipes.apache.org/docs/docs/python/latest/getting-started/first-steps/),
follow some [tutorials](https://streampipes.apache.org/docs/docs/python/latest/tutorials/1-introduction-to-streampipes-python-client/),
or discover the library via our [references](https://streampipes.apache.org/docs/docs/python/latest/reference/client/client/).
<br>
In case you want to access the documentation of the current development state, you can go here:
👉 [development docs 🤓](https://streampipes.apache.org/docs/docs/python/dev/)
<br>
## ⚡️ Quickstart
As a quick example, we demonstrate how to set up and configure a StreamPipes client.
You can simply install the StreamPipes library by running the following command
```bash
pip install streampipes
# if you want to have the current development state you can also execute
pip install git+https://github.com/apache/streampipes.git#subdirectory=streampipes-client-python
```
```python
from streampipes.client import StreamPipesClient
from streampipes.client.config import StreamPipesClientConfig
from streampipes.client.credential_provider import StreamPipesApiKeyCredentials
config = StreamPipesClientConfig(
credential_provider = StreamPipesApiKeyCredentials(
username = "test@streampipes.apache.org",
api_key = "DEMO-KEY",
),
host_address = "localhost",
https_disabled = True,
port = 80
)
client = StreamPipesClient(client_config=config)
client.describe()
```
Output:
```
Hi there!
You are connected to a StreamPipes instance running at http://localhost:80.
The following StreamPipes resources are available with this client:
6x DataStreams
1x DataLakeMeasures
```
For more information about how to use the StreamPipes client visit our [introduction tutorial](https://streampipes.apache.org/docs/docs/python/latest/tutorials/1-introduction-to-streampipes-python-client/).
Raw data
{
"_id": null,
"home_page": "https://streampipes.apache.org/docs/docs/python/latest/",
"name": "streampipes",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>3.8.1",
"maintainer_email": null,
"keywords": "streampipes, iot, iiot, analytics, stream-processing, apache",
"author": "Apache Software Foundation",
"author_email": "dev@streampipes.apache.org",
"download_url": "https://files.pythonhosted.org/packages/f5/37/db9c5c456632fc54774a19acc852c700a3a38c8746da03c5534504350aca/streampipes-0.95.0.tar.gz",
"platform": null,
"description": "<!--\n ~ Licensed to the Apache Software Foundation (ASF) under one or more\n ~ contributor license agreements. See the NOTICE file distributed with\n ~ this work for additional information regarding copyright ownership.\n ~ The ASF licenses this file to You under the Apache License, Version 2.0\n ~ (the \"License\"); you may not use this file except in compliance with\n ~ the License. You may obtain a copy of the License at\n ~\n ~ http://www.apache.org/licenses/LICENSE-2.0\n ~\n ~ Unless required by applicable law or agreed to in writing, software\n ~ distributed under the License is distributed on an \"AS IS\" BASIS,\n ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n ~ See the License for the specific language governing permissions and\n ~ limitations under the License.\n ~\n-->\n\n\n<h1 align=\"center\">\n <br>\n <img src=\"https://raw.githubusercontent.com/apache/streampipes/dev/streampipes-client-python/docs/img/streampipes-python.png\"\n alt=\"StreamPipes Logo with Python\" title=\"Apache StreamPipes Logo with Python\" width=\"75%\"/>\n <br>\n</h1>\n<h4 align=\"center\"><a href=\"[StreamPipes](https://github.com/apache/streampipes)\">StreamPipes</a> is a self-service (Industrial) IoT toolbox to enable non-technical users to connect , analyze and explore IoT data streams.</h4>\n\n<br>\n<h3 align=\"center\">Apache StreamPipes for Python</h3>\n\n<p align=\"center\"> Apache StreamPipes meets Python! We are working highly motivated on a Python library to interact with StreamPipes.\nIn this way, we would like to unite the power of StreamPipes to easily connect to and read different data sources, especially in the IoT domain,\nand the amazing universe of data analytics libraries in Python. </p>\n<br>\n\n<p align=\"center\">\n<a href=\"http://www.apache.org/licenses/LICENSE-2.0\" target=\"_blank\">\n <img src=\"https://img.shields.io/github/license/apache/streampipes.svg\" alt=\"License Apache 2.0\">\n</a>\n<a href=\"https://github.com/apache/streampipes/tree/dev/streampipes-client-python\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/pyversions/streampipes\" alt=\"Supported Python versions\">\n</a>\n<a href=\"https://pypi.org/project/streampipes/\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/v/streampipes\" alt=\"Current PyPI version\">\n</a>\n<a href=\"https://streampipes.apache.org/docs/docs/python/latest/\" target=\"_blank\">\n <img src=\"https://github.com/apache/streampipes-website/actions/workflows/update-python-docs.yml/badge.svg\" alt=\"Status Python Docs\">\n</a>\n<a href=\"https://github.com/psf/black\" target=\"_blank\">\n <img src=\"https://img.shields.io/badge/code%20style-black-black\" alt=\"Code Style: Black\">\n</a>\n<a href=\"https://github.com/python/mypy\" target=\"_blank\">\n <img src=\"https://img.shields.io/badge/typed-mypy-blue\" alt=\"Typed: MyPy\">\n</a>\n<a href=\"https://python-poetry.org\" target=\"_blank\">\n <img src=\"https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json\" alt=\"Dependency & Build Management: Poetry\">\n</a>\n<img src=\"https://raw.githubusercontent.com/apache/streampipes/dev/streampipes-client-python/docs/img/interrogate_badge.svg\" alt= \u201cinterrogate\u201d height=\"20\">\n<a href=\"https://pypi.org/project/streampipes/\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/dm/streampipes\" alt=\"Downloads: PyPI/Month\">\n</a>\n</p>\n\n---\n\n<br>\n\n<h4 align=\"center\">\ud83d\udca1The current version of this Python client is still a beta version.</h4>\n<h4 align=\"center\">This means that it is still under development, which may result in frequent and extensive API changes, unstable behavior, etc.</h4>\n\n<br>\n\n\n## \ud83d\udcda Documentation\nPlease visit our [documentation](https://streampipes.apache.org/docs/docs/python/latest/).\nThere you can find information about how to [get started](https://streampipes.apache.org/docs/docs/python/latest/getting-started/first-steps/),\nfollow some [tutorials](https://streampipes.apache.org/docs/docs/python/latest/tutorials/1-introduction-to-streampipes-python-client/),\nor discover the library via our [references](https://streampipes.apache.org/docs/docs/python/latest/reference/client/client/).\n<br>\n\nIn case you want to access the documentation of the current development state, you can go here:\n\n\ud83d\udc49 [development docs \ud83e\udd13](https://streampipes.apache.org/docs/docs/python/dev/)\n\n<br>\n\n## \u26a1\ufe0f Quickstart\n\nAs a quick example, we demonstrate how to set up and configure a StreamPipes client.\n\nYou can simply install the StreamPipes library by running the following command\n```bash\npip install streampipes\n\n# if you want to have the current development state you can also execute\npip install git+https://github.com/apache/streampipes.git#subdirectory=streampipes-client-python\n```\n\n```python\nfrom streampipes.client import StreamPipesClient\nfrom streampipes.client.config import StreamPipesClientConfig\nfrom streampipes.client.credential_provider import StreamPipesApiKeyCredentials\n\nconfig = StreamPipesClientConfig(\n credential_provider = StreamPipesApiKeyCredentials(\n username = \"test@streampipes.apache.org\",\n api_key = \"DEMO-KEY\",\n ),\n host_address = \"localhost\",\n https_disabled = True,\n port = 80\n)\n\nclient = StreamPipesClient(client_config=config)\nclient.describe()\n```\n\nOutput:\n```\nHi there!\nYou are connected to a StreamPipes instance running at http://localhost:80.\nThe following StreamPipes resources are available with this client:\n6x DataStreams\n1x DataLakeMeasures\n```\n\nFor more information about how to use the StreamPipes client visit our [introduction tutorial](https://streampipes.apache.org/docs/docs/python/latest/tutorials/1-introduction-to-streampipes-python-client/).\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Python library for Apache StreamPipes",
"version": "0.95.0",
"project_urls": {
"Documentation": "https://streampipes.apache.org/docs/docs/python/latest/",
"Homepage": "https://streampipes.apache.org/docs/docs/python/latest/",
"Repository": "https://github.com/apache/streampipes"
},
"split_keywords": [
"streampipes",
" iot",
" iiot",
" analytics",
" stream-processing",
" apache"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "552cfcc088fa6c410ebe70735dcbeb81f2ef373abfd7b06408986f80c3fe5765",
"md5": "47149ac4b41a9a8e0d6d0adf59c0c4b3",
"sha256": "7d9d0b70c5341d8adabd97493df9ab23e79a72c64a06279d3a77b227e339e8b4"
},
"downloads": -1,
"filename": "streampipes-0.95.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "47149ac4b41a9a8e0d6d0adf59c0c4b3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>3.8.1",
"size": 79296,
"upload_time": "2024-06-08T10:27:21",
"upload_time_iso_8601": "2024-06-08T10:27:21.481101Z",
"url": "https://files.pythonhosted.org/packages/55/2c/fcc088fa6c410ebe70735dcbeb81f2ef373abfd7b06408986f80c3fe5765/streampipes-0.95.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f537db9c5c456632fc54774a19acc852c700a3a38c8746da03c5534504350aca",
"md5": "cf9061b6b374751fe4244f6ddd0c8da2",
"sha256": "911e661d6b30c26c6bfbc3f64357a6a984559509ccf6905b2daf46afda9717a0"
},
"downloads": -1,
"filename": "streampipes-0.95.0.tar.gz",
"has_sig": false,
"md5_digest": "cf9061b6b374751fe4244f6ddd0c8da2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>3.8.1",
"size": 36287,
"upload_time": "2024-06-08T10:27:22",
"upload_time_iso_8601": "2024-06-08T10:27:22.880463Z",
"url": "https://files.pythonhosted.org/packages/f5/37/db9c5c456632fc54774a19acc852c700a3a38c8746da03c5534504350aca/streampipes-0.95.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-08 10:27:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "apache",
"github_project": "streampipes",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "streampipes"
}
JSON
