worqhat 3.10.0__py3-none-any.whl → 4.2.0__py3-none-any.whl

worqhat/resources/db/tables.py

@@ -1,389 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from __future__ import annotations
-
-from typing_extensions import Literal
-
-import httpx
-
-from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
-from ..._utils import maybe_transform, async_maybe_transform
-from ..._compat import cached_property
-from ...types.db import table_list_params, table_get_row_count_params, table_retrieve_schema_params
-from ..._resource import SyncAPIResource, AsyncAPIResource
-from ..._response import (
-    to_raw_response_wrapper,
-    to_streamed_response_wrapper,
-    async_to_raw_response_wrapper,
-    async_to_streamed_response_wrapper,
-)
-from ..._base_client import make_request_options
-from ...types.db.table_list_response import TableListResponse
-from ...types.db.table_get_row_count_response import TableGetRowCountResponse
-from ...types.db.table_retrieve_schema_response import TableRetrieveSchemaResponse
-
-__all__ = ["TablesResource", "AsyncTablesResource"]
-
-
-class TablesResource(SyncAPIResource):
-    @cached_property
-    def with_raw_response(self) -> TablesResourceWithRawResponse:
-        """
-        This property can be used as a prefix for any HTTP method call to return
-        the raw response object instead of the parsed content.
-
-        For more information, see https://www.github.com/WorqHat/worqhat-python-sdk#accessing-raw-response-data-eg-headers
-        """
-        return TablesResourceWithRawResponse(self)
-
-    @cached_property
-    def with_streaming_response(self) -> TablesResourceWithStreamingResponse:
-        """
-        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
-
-        For more information, see https://www.github.com/WorqHat/worqhat-python-sdk#with_streaming_response
-        """
-        return TablesResourceWithStreamingResponse(self)
-
-    def list(
-        self,
-        *,
-        environment: Literal["development", "staging", "production"] | Omit = omit,
-        schema: str | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> TableListResponse:
-        """
-        Returns a list of all tables in the database that are accessible to your
-        organization. Optionally filter by schema and environment.
-
-        Args:
-          environment: Environment to query (development, staging, production)
-
-          schema: Database schema to filter tables
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        return self._get(
-            "/db/tables",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=maybe_transform(
-                    {
-                        "environment": environment,
-                        "schema": schema,
-                    },
-                    table_list_params.TableListParams,
-                ),
-            ),
-            cast_to=TableListResponse,
-        )
-
-    def get_row_count(
-        self,
-        table_name: str,
-        *,
-        environment: Literal["development", "staging", "production"] | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> TableGetRowCountResponse:
-        """
-        Returns the total number of rows in the specified table for your organization.
-
-        Args:
-          environment: Environment to query
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not table_name:
-            raise ValueError(f"Expected a non-empty value for `table_name` but received {table_name!r}")
-        return self._get(
-            f"/db/tables/{table_name}/count",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=maybe_transform({"environment": environment}, table_get_row_count_params.TableGetRowCountParams),
-            ),
-            cast_to=TableGetRowCountResponse,
-        )
-
-    def retrieve_schema(
-        self,
-        table_name: str,
-        *,
-        environment: Literal["development", "staging", "production"] | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> TableRetrieveSchemaResponse:
-        """
-        Returns detailed schema information for a specific table, including column
-        names, types, and constraints.
-
-        Args:
-          environment: Environment to query
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not table_name:
-            raise ValueError(f"Expected a non-empty value for `table_name` but received {table_name!r}")
-        return self._get(
-            f"/db/tables/{table_name}/schema",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=maybe_transform(
-                    {"environment": environment}, table_retrieve_schema_params.TableRetrieveSchemaParams
-                ),
-            ),
-            cast_to=TableRetrieveSchemaResponse,
-        )
-
-
-class AsyncTablesResource(AsyncAPIResource):
-    @cached_property
-    def with_raw_response(self) -> AsyncTablesResourceWithRawResponse:
-        """
-        This property can be used as a prefix for any HTTP method call to return
-        the raw response object instead of the parsed content.
-
-        For more information, see https://www.github.com/WorqHat/worqhat-python-sdk#accessing-raw-response-data-eg-headers
-        """
-        return AsyncTablesResourceWithRawResponse(self)
-
-    @cached_property
-    def with_streaming_response(self) -> AsyncTablesResourceWithStreamingResponse:
-        """
-        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
-
-        For more information, see https://www.github.com/WorqHat/worqhat-python-sdk#with_streaming_response
-        """
-        return AsyncTablesResourceWithStreamingResponse(self)
-
-    async def list(
-        self,
-        *,
-        environment: Literal["development", "staging", "production"] | Omit = omit,
-        schema: str | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> TableListResponse:
-        """
-        Returns a list of all tables in the database that are accessible to your
-        organization. Optionally filter by schema and environment.
-
-        Args:
-          environment: Environment to query (development, staging, production)
-
-          schema: Database schema to filter tables
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        return await self._get(
-            "/db/tables",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=await async_maybe_transform(
-                    {
-                        "environment": environment,
-                        "schema": schema,
-                    },
-                    table_list_params.TableListParams,
-                ),
-            ),
-            cast_to=TableListResponse,
-        )
-
-    async def get_row_count(
-        self,
-        table_name: str,
-        *,
-        environment: Literal["development", "staging", "production"] | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> TableGetRowCountResponse:
-        """
-        Returns the total number of rows in the specified table for your organization.
-
-        Args:
-          environment: Environment to query
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not table_name:
-            raise ValueError(f"Expected a non-empty value for `table_name` but received {table_name!r}")
-        return await self._get(
-            f"/db/tables/{table_name}/count",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=await async_maybe_transform(
-                    {"environment": environment}, table_get_row_count_params.TableGetRowCountParams
-                ),
-            ),
-            cast_to=TableGetRowCountResponse,
-        )
-
-    async def retrieve_schema(
-        self,
-        table_name: str,
-        *,
-        environment: Literal["development", "staging", "production"] | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> TableRetrieveSchemaResponse:
-        """
-        Returns detailed schema information for a specific table, including column
-        names, types, and constraints.
-
-        Args:
-          environment: Environment to query
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not table_name:
-            raise ValueError(f"Expected a non-empty value for `table_name` but received {table_name!r}")
-        return await self._get(
-            f"/db/tables/{table_name}/schema",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=await async_maybe_transform(
-                    {"environment": environment}, table_retrieve_schema_params.TableRetrieveSchemaParams
-                ),
-            ),
-            cast_to=TableRetrieveSchemaResponse,
-        )
-
-
-class TablesResourceWithRawResponse:
-    def __init__(self, tables: TablesResource) -> None:
-        self._tables = tables
-
-        self.list = to_raw_response_wrapper(
-            tables.list,
-        )
-        self.get_row_count = to_raw_response_wrapper(
-            tables.get_row_count,
-        )
-        self.retrieve_schema = to_raw_response_wrapper(
-            tables.retrieve_schema,
-        )
-
-
-class AsyncTablesResourceWithRawResponse:
-    def __init__(self, tables: AsyncTablesResource) -> None:
-        self._tables = tables
-
-        self.list = async_to_raw_response_wrapper(
-            tables.list,
-        )
-        self.get_row_count = async_to_raw_response_wrapper(
-            tables.get_row_count,
-        )
-        self.retrieve_schema = async_to_raw_response_wrapper(
-            tables.retrieve_schema,
-        )
-
-
-class TablesResourceWithStreamingResponse:
-    def __init__(self, tables: TablesResource) -> None:
-        self._tables = tables
-
-        self.list = to_streamed_response_wrapper(
-            tables.list,
-        )
-        self.get_row_count = to_streamed_response_wrapper(
-            tables.get_row_count,
-        )
-        self.retrieve_schema = to_streamed_response_wrapper(
-            tables.retrieve_schema,
-        )
-
-
-class AsyncTablesResourceWithStreamingResponse:
-    def __init__(self, tables: AsyncTablesResource) -> None:
-        self._tables = tables
-
-        self.list = async_to_streamed_response_wrapper(
-            tables.list,
-        )
-        self.get_row_count = async_to_streamed_response_wrapper(
-            tables.get_row_count,
-        )
-        self.retrieve_schema = async_to_streamed_response_wrapper(
-            tables.retrieve_schema,
-        )

worqhat/resources/health.py

@@ -1,143 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from __future__ import annotations
-
-import httpx
-
-from .._types import Body, Query, Headers, NotGiven, not_given
-from .._compat import cached_property
-from .._resource import SyncAPIResource, AsyncAPIResource
-from .._response import (
-    to_raw_response_wrapper,
-    to_streamed_response_wrapper,
-    async_to_raw_response_wrapper,
-    async_to_streamed_response_wrapper,
-)
-from .._base_client import make_request_options
-from ..types.health_check_response import HealthCheckResponse
-
-__all__ = ["HealthResource", "AsyncHealthResource"]
-
-
-class HealthResource(SyncAPIResource):
-    @cached_property
-    def with_raw_response(self) -> HealthResourceWithRawResponse:
-        """
-        This property can be used as a prefix for any HTTP method call to return
-        the raw response object instead of the parsed content.
-
-        For more information, see https://www.github.com/WorqHat/worqhat-python-sdk#accessing-raw-response-data-eg-headers
-        """
-        return HealthResourceWithRawResponse(self)
-
-    @cached_property
-    def with_streaming_response(self) -> HealthResourceWithStreamingResponse:
-        """
-        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
-
-        For more information, see https://www.github.com/WorqHat/worqhat-python-sdk#with_streaming_response
-        """
-        return HealthResourceWithStreamingResponse(self)
-
-    def check(
-        self,
-        *,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> HealthCheckResponse:
-        """Check if the server is running and get uptime information.
-
-        This endpoint can be
-        used for monitoring and alerting systems.
-        """
-        return self._get(
-            "/health",
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=HealthCheckResponse,
-        )
-
-
-class AsyncHealthResource(AsyncAPIResource):
-    @cached_property
-    def with_raw_response(self) -> AsyncHealthResourceWithRawResponse:
-        """
-        This property can be used as a prefix for any HTTP method call to return
-        the raw response object instead of the parsed content.
-
-        For more information, see https://www.github.com/WorqHat/worqhat-python-sdk#accessing-raw-response-data-eg-headers
-        """
-        return AsyncHealthResourceWithRawResponse(self)
-
-    @cached_property
-    def with_streaming_response(self) -> AsyncHealthResourceWithStreamingResponse:
-        """
-        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
-
-        For more information, see https://www.github.com/WorqHat/worqhat-python-sdk#with_streaming_response
-        """
-        return AsyncHealthResourceWithStreamingResponse(self)
-
-    async def check(
-        self,
-        *,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> HealthCheckResponse:
-        """Check if the server is running and get uptime information.
-
-        This endpoint can be
-        used for monitoring and alerting systems.
-        """
-        return await self._get(
-            "/health",
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=HealthCheckResponse,
-        )
-
-
-class HealthResourceWithRawResponse:
-    def __init__(self, health: HealthResource) -> None:
-        self._health = health
-
-        self.check = to_raw_response_wrapper(
-            health.check,
-        )
-
-
-class AsyncHealthResourceWithRawResponse:
-    def __init__(self, health: AsyncHealthResource) -> None:
-        self._health = health
-
-        self.check = async_to_raw_response_wrapper(
-            health.check,
-        )
-
-
-class HealthResourceWithStreamingResponse:
-    def __init__(self, health: HealthResource) -> None:
-        self._health = health
-
-        self.check = to_streamed_response_wrapper(
-            health.check,
-        )
-
-
-class AsyncHealthResourceWithStreamingResponse:
-    def __init__(self, health: AsyncHealthResource) -> None:
-        self._health = health
-
-        self.check = async_to_streamed_response_wrapper(
-            health.check,
-        )

worqhat/types/__init__.py

@@ -1,44 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from __future__ import annotations
-
-from .db_cluster_params import DBClusterParams as DBClusterParams
-from .db_cluster_response import DBClusterResponse as DBClusterResponse
-from .db_recommend_params import DBRecommendParams as DBRecommendParams
-from .db_recommend_response import DBRecommendResponse as DBRecommendResponse
-from .health_check_response import HealthCheckResponse as HealthCheckResponse
-from .db_find_similar_params import DBFindSimilarParams as DBFindSimilarParams
-from .db_execute_batch_params import DBExecuteBatchParams as DBExecuteBatchParams
-from .db_execute_query_params import DBExecuteQueryParams as DBExecuteQueryParams
-from .db_hybrid_search_params import DBHybridSearchParams as DBHybridSearchParams
-from .db_insert_record_params import DBInsertRecordParams as DBInsertRecordParams
-from .flow_get_metrics_params import FlowGetMetricsParams as FlowGetMetricsParams
-from .db_delete_records_params import DBDeleteRecordsParams as DBDeleteRecordsParams
-from .db_find_similar_response import DBFindSimilarResponse as DBFindSimilarResponse
-from .db_update_records_params import DBUpdateRecordsParams as DBUpdateRecordsParams
-from .get_server_info_response import GetServerInfoResponse as GetServerInfoResponse
-from .db_execute_batch_response import DBExecuteBatchResponse as DBExecuteBatchResponse
-from .db_execute_query_response import DBExecuteQueryResponse as DBExecuteQueryResponse
-from .db_hybrid_search_response import DBHybridSearchResponse as DBHybridSearchResponse
-from .db_insert_record_response import DBInsertRecordResponse as DBInsertRecordResponse
-from .db_semantic_search_params import DBSemanticSearchParams as DBSemanticSearchParams
-from .flow_get_metrics_response import FlowGetMetricsResponse as FlowGetMetricsResponse
-from .db_delete_records_response import DBDeleteRecordsResponse as DBDeleteRecordsResponse
-from .db_detect_anomalies_params import DBDetectAnomaliesParams as DBDetectAnomaliesParams
-from .db_process_nl_query_params import DBProcessNlQueryParams as DBProcessNlQueryParams
-from .db_update_records_response import DBUpdateRecordsResponse as DBUpdateRecordsResponse
-from .storage_upload_file_params import StorageUploadFileParams as StorageUploadFileParams
-from .db_semantic_search_response import DBSemanticSearchResponse as DBSemanticSearchResponse
-from .db_detect_anomalies_response import DBDetectAnomaliesResponse as DBDetectAnomaliesResponse
-from .db_process_nl_query_response import DBProcessNlQueryResponse as DBProcessNlQueryResponse
-from .storage_upload_file_response import StorageUploadFileResponse as StorageUploadFileResponse
-from .flow_trigger_with_file_params import FlowTriggerWithFileParams as FlowTriggerWithFileParams
-from .flow_trigger_with_file_response import FlowTriggerWithFileResponse as FlowTriggerWithFileResponse
-from .flow_trigger_with_payload_params import FlowTriggerWithPayloadParams as FlowTriggerWithPayloadParams
-from .flow_trigger_with_payload_response import FlowTriggerWithPayloadResponse as FlowTriggerWithPayloadResponse
-from .storage_delete_file_by_id_response import StorageDeleteFileByIDResponse as StorageDeleteFileByIDResponse
-from .storage_retrieve_file_by_id_response import StorageRetrieveFileByIDResponse as StorageRetrieveFileByIDResponse
-from .storage_retrieve_file_by_path_params import StorageRetrieveFileByPathParams as StorageRetrieveFileByPathParams
-from .storage_retrieve_file_by_path_response import (
-    StorageRetrieveFileByPathResponse as StorageRetrieveFileByPathResponse,
-)

worqhat/types/db/__init__.py

@@ -1,10 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from __future__ import annotations
-
-from .table_list_params import TableListParams as TableListParams
-from .table_list_response import TableListResponse as TableListResponse
-from .table_get_row_count_params import TableGetRowCountParams as TableGetRowCountParams
-from .table_get_row_count_response import TableGetRowCountResponse as TableGetRowCountResponse
-from .table_retrieve_schema_params import TableRetrieveSchemaParams as TableRetrieveSchemaParams
-from .table_retrieve_schema_response import TableRetrieveSchemaResponse as TableRetrieveSchemaResponse

worqhat/types/db/table_get_row_count_params.py

@@ -1,12 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from __future__ import annotations
-
-from typing_extensions import Literal, TypedDict
-
-__all__ = ["TableGetRowCountParams"]
-
-
-class TableGetRowCountParams(TypedDict, total=False):
-    environment: Literal["development", "staging", "production"]
-    """Environment to query"""

worqhat/types/db/table_get_row_count_response.py

@@ -1,15 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from typing import Optional
-
-from ..._models import BaseModel
-
-__all__ = ["TableGetRowCountResponse"]
-
-
-class TableGetRowCountResponse(BaseModel):
-    count: Optional[int] = None
-
-    success: Optional[bool] = None
-
-    table: Optional[str] = None

worqhat/types/db/table_list_params.py

@@ -1,15 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from __future__ import annotations
-
-from typing_extensions import Literal, TypedDict
-
-__all__ = ["TableListParams"]
-
-
-class TableListParams(TypedDict, total=False):
-    environment: Literal["development", "staging", "production"]
-    """Environment to query (development, staging, production)"""
-
-    schema: str
-    """Database schema to filter tables"""

worqhat/types/db/table_list_response.py

@@ -1,26 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from typing import List, Optional
-
-from pydantic import Field as FieldInfo
-
-from ..._models import BaseModel
-
-__all__ = ["TableListResponse", "Table"]
-
-
-class Table(BaseModel):
-    name: Optional[str] = None
-
-    schema_: Optional[str] = FieldInfo(alias="schema", default=None)
-
-    type: Optional[str] = None
-
-
-class TableListResponse(BaseModel):
-    count: Optional[int] = None
-    """Total number of tables"""
-
-    success: Optional[bool] = None
-
-    tables: Optional[List[Table]] = None

worqhat/types/db/table_retrieve_schema_params.py

@@ -1,12 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from __future__ import annotations
-
-from typing_extensions import Literal, TypedDict
-
-__all__ = ["TableRetrieveSchemaParams"]
-
-
-class TableRetrieveSchemaParams(TypedDict, total=False):
-    environment: Literal["development", "staging", "production"]
-    """Environment to query"""