?hLdZddlmZddlmZddlmZddlm Z GddZ y) z! Contextionary class definition. )ConnectionError) Connection)UnexpectedStatusCodeException)_decode_json_response_dictc FeZdZdZdefdZd dedededdfd Zdede fd Z y) Contextionaryz Contextionary class used to add extend the Weaviate contextionary module or to get vector/s of a specific concept. connectionc||_y)z Initialize a Contextionary class instance. Parameters ---------- connection : weaviate.connect.Connection Connection object to an active and running Weaviate instance. N) _connection)selfr s g/home/chris/cleankitchens-env/lib/python3.12/site-packages/weaviate/contextionary/crud_contextionary.py__init__zContextionary.__init__s &concept definitionweightreturnNct|ts tdt|ts tdt|ts td|dkDs|dkr t d|||d} |j j d| }|jd k(ry td |#t$r}td |d }~wwxYw)a^ Extend the text2vec-contextionary with new concepts Parameters ---------- concept : str The new concept that should be added that is not in the Weaviate or needs to be updated, e.g. an abbreviation. definition : str The definition of the new concept. weight : float, optional The weight of the new definition compared to the old one, must be in-between the interval [0.0; 1.0], by default 1.0 Examples -------- >>> client.contextionary.extend( ... concept = 'palantir', ... definition = 'spherical stone objects used for communication in Middle-earth' ... ) Raises ------ TypeError If an argument is not of an appropriate type. ValueError If 'weight' is outside the interval [0.0; 1.0]. requests.ConnectionError If text2vec-contextionary could not be extended. weaviate.UnexpectedStatusCodeException If the network connection to weaviate fails. zConcept must be stringzDefinition must be stringzWeight must be float?gz)Weight out of limits 0.0 <= weight <= 1.0)rrrz*/modules/text2vec-contextionary/extensions)pathweaviate_objectz-text2vec-contextionary could not be extended.NzExtend text2vec-contextionary) isinstancestr TypeErrorfloat ValueErrorr postRequestsConnectionError status_coder)r rrr extensionresponseconn_errs r extendzContextionary.extendsF'3'45 5*c*78 8&%(23 3 C<6C<HI I 'zVT  '',,A )-H   3 & +,KXVV' )?  s.B'' C0 B<<Ccd|z} |jj|}t|d}|J|S#t$r}td|d}~wwxYw)a Retrieves the vector representation of the given concept. Parameters ---------- concept : str Concept for which the vector should be retrieved. May be camelCase for word combinations. Examples -------- >>> client.contextionary.get_concept_vector('king') { "individualWords": [ { "info": { "nearestNeighbors": [ { "word": "king" }, { "distance": 5.7498446, "word": "kings" }, ..., { "distance": 6.1396513, "word": "queen" } ], "vector": [ -0.68988, ..., -0.561865 ] }, "present": true, "word": "king" } ] } Returns ------- dict A dictionary containing info and the vector/s of the concept. The vector might be empty if the text2vec-contextionary does not contain it. Raises ------ requests.ConnectionError If the network connection to weaviate fails. weaviate.UnexpectedStatusCodeException If weaviate reports a none OK status. z)/modules/text2vec-contextionary/concepts/)rztext2vec-contextionary vectorNz0text2vec-contextionary vector was not retrieved.)r getrr)r rrr"resr#s r get_concept_vectorz Contextionary.get_concept_vectorZspr;WD ''+++6H -X7VWC? "?J' )B  s5 A A  A)r) __name__ __module__ __qualname____doc__rrrrr$dictr(rr rr sP &: &;Wc;Ws;WE;WD;WzC#C$CrrN) r,requests.exceptionsrrweaviate.connectrweaviate.exceptionsr weaviate.utilrrr.rr r3s%K'=4RRr