waylay-sdk-queries


Namewaylay-sdk-queries JSON
Version 0.5.0.20240809 PyPI version JSON
download
home_pageNone
SummaryWaylay Query: timeseries queries (v1 protocol)
upload_time2024-08-09 09:12:09
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseISC License (ISC) Copyright 2024, Waylay Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
keywords waylay query: timeseries queries (v1 protocol)
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Waylay Queries Service

Execute and store queries on the Waylay timeseries.

Protocol version: v1.

This Python package is automatically generated based on the 
Waylay Queries OpenAPI specification (API version: 0.5.0)
For more information, please visit [the openapi specification](https://docs.waylay.io/openapi/public/redocly/queries.html).

It consists of a plugin for the waylay-sdk-core package, and contains the Queries api methods.
Note that the typed model classes for all path params, query params, body params and responses for each of the api methods are contained in a separate package called waylay-sdk-queries-types.

## Requirements.
This package requires Python 3.9+.

## Installation

Normally this package is installed together with support for other services using the [waylay-sdk](https://pypi.org/project/waylay-sdk/) umbrella package:
* `pip install waylay-sdk` will install `waylay-sdk-queries` together with the SDK api packages for other services.
* `pip install waylay-sdk[types-queries]` will additionally install the types package `waylay-sdk-queries-types`.
* `pip install waylay-sdk[types]` will install the types packages for this and all other services.

Alternatively, you can install support for this _queries_ service only, installing or extending an existing [waylay-sdk-core](https://pypi.org/project/waylay-sdk-core/):

- `pip install waylay-sdk-queries` to only install api support for _queries_.
- `pip install waylay-sdk-queries[types]` to additionally install type support for _queries_.

## Usage

```python
from pprint import pprint

# Import the waylay-client from the waylay-sdk-core package
from waylay.sdk.client import WaylayClient
from waylay.sdk.api.api_exceptions import ApiError

# Intialize a waylay client instance
waylay_client = WaylayClient.from_profile()

# Note that the typed model classes for responses/parameters/... are only available when `waylay-sdk-queries-types` is installed
from waylay.services.queries.models.query_input import QueryInput
from waylay.services.queries.models.query_result import QueryResult
try:
    # Execute Query
    # calls `POST /queries/v1/data`
    api_response = await waylay_client.queries.execute.execute(
        # query parameters:
        query = {
            'resource': '13efb488-75ac-4dac-828a-d49c5c2ebbfc'
            'metric': 'temperature'
        },
        # json data: use a generated model or a json-serializable python data structure (dict, list)
        json = waylay.services.queries.QueryInput() # QueryInput | 
        headers = {
            'accept': 'accept_example',
        },
    )
    print("The response of queries.execute.execute:\n")
    pprint(api_response)
except ApiError as e:
    print("Exception when calling queries.execute.execute: %s\n" % e)
```


For more information, please visit the [Waylay API documentation](https://docs.waylay.io/#/api/?id=software-development-kits).

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "waylay-sdk-queries",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "Waylay Query: timeseries queries (v1 protocol)",
    "author": null,
    "author_email": "Waylay <info@waylay.io>",
    "download_url": "https://files.pythonhosted.org/packages/9f/b8/4fdf4e4eec0d5daaf706a9b40a5e6d37022a97d236a89daa83518047600f/waylay_sdk_queries-0.5.0.20240809.tar.gz",
    "platform": null,
    "description": "# Waylay Queries Service\n\nExecute and store queries on the Waylay timeseries.\n\nProtocol version: v1.\n\nThis Python package is automatically generated based on the \nWaylay Queries OpenAPI specification (API version: 0.5.0)\nFor more information, please visit [the openapi specification](https://docs.waylay.io/openapi/public/redocly/queries.html).\n\nIt consists of a plugin for the waylay-sdk-core package, and contains the Queries api methods.\nNote that the typed model classes for all path params, query params, body params and responses for each of the api methods are contained in a separate package called waylay-sdk-queries-types.\n\n## Requirements.\nThis package requires Python 3.9+.\n\n## Installation\n\nNormally this package is installed together with support for other services using the [waylay-sdk](https://pypi.org/project/waylay-sdk/) umbrella package:\n* `pip install waylay-sdk` will install `waylay-sdk-queries` together with the SDK api packages for other services.\n* `pip install waylay-sdk[types-queries]` will additionally install the types package `waylay-sdk-queries-types`.\n* `pip install waylay-sdk[types]` will install the types packages for this and all other services.\n\nAlternatively, you can install support for this _queries_ service only, installing or extending an existing [waylay-sdk-core](https://pypi.org/project/waylay-sdk-core/):\n\n- `pip install waylay-sdk-queries` to only install api support for _queries_.\n- `pip install waylay-sdk-queries[types]` to additionally install type support for _queries_.\n\n## Usage\n\n```python\nfrom pprint import pprint\n\n# Import the waylay-client from the waylay-sdk-core package\nfrom waylay.sdk.client import WaylayClient\nfrom waylay.sdk.api.api_exceptions import ApiError\n\n# Intialize a waylay client instance\nwaylay_client = WaylayClient.from_profile()\n\n# Note that the typed model classes for responses/parameters/... are only available when `waylay-sdk-queries-types` is installed\nfrom waylay.services.queries.models.query_input import QueryInput\nfrom waylay.services.queries.models.query_result import QueryResult\ntry:\n    # Execute Query\n    # calls `POST /queries/v1/data`\n    api_response = await waylay_client.queries.execute.execute(\n        # query parameters:\n        query = {\n            'resource': '13efb488-75ac-4dac-828a-d49c5c2ebbfc'\n            'metric': 'temperature'\n        },\n        # json data: use a generated model or a json-serializable python data structure (dict, list)\n        json = waylay.services.queries.QueryInput() # QueryInput | \n        headers = {\n            'accept': 'accept_example',\n        },\n    )\n    print(\"The response of queries.execute.execute:\\n\")\n    pprint(api_response)\nexcept ApiError as e:\n    print(\"Exception when calling queries.execute.execute: %s\\n\" % e)\n```\n\n\nFor more information, please visit the [Waylay API documentation](https://docs.waylay.io/#/api/?id=software-development-kits).\n",
    "bugtrack_url": null,
    "license": "ISC License (ISC) Copyright 2024, Waylay  Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.  THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.",
    "summary": "Waylay Query: timeseries queries (v1 protocol)",
    "version": "0.5.0.20240809",
    "project_urls": {
        "Documentation": "https://docs.waylay.io/#/api/?id=software-development-kits",
        "Homepage": "https://www.waylay.io/",
        "Openapi Specification": "https://docs.waylay.io/openapi/public/redocly/queries.html",
        "Repository": "https://github.com/waylayio/waylay-sdk-queries-py.git"
    },
    "split_keywords": [
        "waylay",
        "query:",
        "timeseries",
        "queries",
        "(v1",
        "protocol)"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3bb6640544ded9470ae3bc0a645df8f0a9111ea5b358e5d33629cd451757aee7",
                "md5": "4cff97d430a6968cb6b560cbc9255503",
                "sha256": "1c1b1bed2cc752c9112801f9cf7b08149b98095e4acd9f8bb13e4dde13be3177"
            },
            "downloads": -1,
            "filename": "waylay_sdk_queries-0.5.0.20240809-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4cff97d430a6968cb6b560cbc9255503",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 13334,
            "upload_time": "2024-08-09T09:12:08",
            "upload_time_iso_8601": "2024-08-09T09:12:08.922799Z",
            "url": "https://files.pythonhosted.org/packages/3b/b6/640544ded9470ae3bc0a645df8f0a9111ea5b358e5d33629cd451757aee7/waylay_sdk_queries-0.5.0.20240809-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9fb84fdf4e4eec0d5daaf706a9b40a5e6d37022a97d236a89daa83518047600f",
                "md5": "efd4c367638da3c13e12f6f3e99c9336",
                "sha256": "8c9e10f9b439bcfe04aaec3bbbc259788fb25f2754a8cfa8a6c16a414c3fbee6"
            },
            "downloads": -1,
            "filename": "waylay_sdk_queries-0.5.0.20240809.tar.gz",
            "has_sig": false,
            "md5_digest": "efd4c367638da3c13e12f6f3e99c9336",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 10491,
            "upload_time": "2024-08-09T09:12:09",
            "upload_time_iso_8601": "2024-08-09T09:12:09.892722Z",
            "url": "https://files.pythonhosted.org/packages/9f/b8/4fdf4e4eec0d5daaf706a9b40a5e6d37022a97d236a89daa83518047600f/waylay_sdk_queries-0.5.0.20240809.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-09 09:12:09",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "waylayio",
    "github_project": "waylay-sdk-queries-py",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "waylay-sdk-queries"
}
        
Elapsed time: 0.45881s