?h)dZddlmZmZmZmZddlmZddl m Z ddl m Z ddl mZmZddlmZd d lmZGd d Zy )z GraphQL query module. )ListAnyDictOptional)ConnectionError) Connection)AggregateBuilder) GetBuilder PROPERTIES)MultiGetBuilder)_decode_json_response_dictczeZdZdZdefdZ ddedeede fdZ d e e de fd Z dedefd Zd edeeeffd Zy)QueryzL Query class used to make `get` and/or `aggregate` GraphQL queries. connectionc||_y)z Initialize a Classification class instance. Parameters ---------- connection : weaviate.connect.Connection Connection object to an active and running Weaviate instance. N) _connection)selfrs P/home/chris/cleankitchens-env/lib/python3.12/site-packages/weaviate/gql/query.py__init__zQuery.__init__s &N class_name propertiesreturnc0t|||jS)a Instantiate a GetBuilder for GraphQL `get` requests. Parameters ---------- class_name : str Class name of the objects to interact with. properties : list of str and ReferenceProperty, str or None Properties of the objects to get, by default None Returns ------- GetBuilder A GetBuilder to make GraphQL `get` requests from weaviate. )r r)rrrs rgetz Query.get s(*j$2B2BCCr get_builderc.t||jS)a Instantiate a MultiGetBuilder for GraphQL `multi_get` requests. Bundles multiple get requests into one. Parameters ---------- get_builder : list of GetBuilder List of GetBuilder objects for a single request each. Returns ------- MultiGetBuilder A MultiGetBuilder to make GraphQL `get` multiple requests from weaviate. )r r)rrs r multi_getzQuery.multi_get6s&{D,<,<==rc.t||jS)aY Instantiate an AggregateBuilder for GraphQL `aggregate` requests. Parameters ---------- class_name : str Class name of the objects to be aggregated. Returns ------- AggregateBuilder An AggregateBuilder to make GraphQL `aggregate` requests from weaviate. )r r)rrs r aggregatezQuery.aggregateKs D,<,<==r gql_queryct|ts tdd|i} |jj d|}t |d}|J|S#t $r}t d|d}~wwxYw)u Allows to send simple graph QL string queries. Be cautious of injection risks when generating query strings. Parameters ---------- gql_query : str GraphQL query as a string. Returns ------- dict Data response of the query. Examples -------- >>> query = """ ... { ... Get { ... Article(limit: 2) { ... title ... hasAuthors { ... ... on Author { ... name ... } ... } ... } ... } ... } ... """ >>> client.query.raw(query) { "data": { "Get": { "Article": [ { "hasAuthors": [ { "name": "Jonathan Wilson" } ], "title": "Sergio Agüero has been far more than a great goalscorer for Manchester City" }, { "hasAuthors": [ { "name": "Emma Elwick-Bates" } ], "title": "At Swarovski, Giovanna Engelbert Is Crafting Jewels As Exuberantly Joyful As She Is" } ] } }, "errors": null } Raises ------ TypeError If 'gql_query' is not of type str. requests.ConnectionError If the network connection to weaviate fails. weaviate.UnexpectedStatusCodeException If weaviate reports a none OK status. z Query is expected to be a stringqueryz/graphql)pathweaviate_objectzQuery not executed.NzGQL query failed) isinstancestr TypeErrorrpostRequestsConnectionErrorr)rr# json_queryresponseconn_errress rrawz Query.raw\sL)S)>? ?y)  O'',,*j,YH)3EF ' O)*?@h N OsA A* A%%A*)N)__name__ __module__ __qualname____doc__rrr)rr r rrr r r r"rrr1rrrrs &: &,0DDZ(D  D,>*%> >*>C>,<>"RSRT#s(^RrrN)r5typingrrrrrequests.exceptionsrr,weaviate.connectrr"r rr r r r utilrrr6rrr;s0-,J'''&-__r