deprecate python VectorQuery (#267)

* deprecate python VectorQuery

* remove import
This commit is contained in:
egolearner
2026-05-12 14:55:49 +08:00
committed by GitHub
parent 269c611f78
commit ce468af29b
17 changed files with 210 additions and 134 deletions
+30 -9
View File
@@ -31,6 +31,7 @@ from zvec import (
OptimizeOption,
HnswQueryParam,
IVFQueryParam,
Query,
VectorQuery,
IndexType,
MetricType,
@@ -373,9 +374,9 @@ class TestHnswQueryParam:
# assert param.scale_factor == 40
class TestVectorQuery:
class TestQuery:
def test_init_with_valid_id(self):
vq = VectorQuery(field_name="embedding", id="doc123")
vq = Query(field_name="embedding", id="doc123")
assert vq.field_name == "embedding"
assert vq.id == "doc123"
assert vq.vector is None
@@ -384,32 +385,52 @@ class TestVectorQuery:
def test_init_with_valid_vector(self):
vec = [0.1, 0.2, 0.3]
param = HnswQueryParam(ef=300)
vq = VectorQuery(field_name="embedding", vector=vec, param=param)
vq = Query(field_name="embedding", vector=vec, param=param)
assert vq.field_name == "embedding"
assert vq.vector == vec
assert vq.param == param
def test_init_both_id_and_vector_raises_error(self):
with pytest.raises(ValueError):
VectorQuery(field_name="embedding", id="doc123", vector=[0.1])._validate()
Query(field_name="embedding", id="doc123", vector=[0.1])._validate()
def test_init_without_field_name_raises_error(self):
with pytest.raises(ValueError):
VectorQuery(field_name=None)._validate()
Query(field_name=None)._validate()
def test_has_id_returns_true_when_id_set(self):
vq = VectorQuery(field_name="embedding", id="doc123")
vq = Query(field_name="embedding", id="doc123")
assert vq.has_id()
def test_has_id_returns_false_when_no_id(self):
vq = VectorQuery(field_name="embedding", vector=[0.1])
vq = Query(field_name="embedding", vector=[0.1])
assert not vq.has_id()
def test_has_vector_returns_true_with_non_empty_vector(self):
vq = VectorQuery(field_name="embedding", vector=[0.1])
vq = Query(field_name="embedding", vector=[0.1])
assert vq.has_vector()
def test_validate_fails_on_both_id_and_vector(self):
vq = VectorQuery(field_name="test", id="doc123", vector=[0.1])
vq = Query(field_name="test", id="doc123", vector=[0.1])
with pytest.raises(ValueError):
vq._validate()
class TestVectorQueryDeprecated:
def test_deprecation_warning(self):
import warnings
with warnings.catch_warnings(record=True) as w:
warnings.simplefilter("always")
vq = VectorQuery(field_name="embedding", id="doc123")
assert len(w) == 1
assert issubclass(w[0].category, DeprecationWarning)
assert "Query" in str(w[0].message)
def test_isinstance_compatibility(self):
import warnings
with warnings.catch_warnings(record=True):
warnings.simplefilter("always")
vq = VectorQuery(field_name="embedding", id="doc123")
assert isinstance(vq, Query)