cocoindex 0.1.51__cp312-cp312-win_amd64.whl → 0.1.52__cp312-cp312-win_amd64.whl

cocoindex/__init__.py

@@ -2,7 +2,9 @@
 Cocoindex is a framework for building and running indexing pipelines.
 """
 
-from . import functions, sources, storages, cli, utils
+from . import functions, sources, targets, cli, utils
+
+from . import targets as storages  # Deprecated: Use targets instead
 
 from .auth_registry import AuthEntryReference, add_auth_entry, ref_auth_entry
 from .flow import FlowBuilder, DataScope, DataSlice, Flow, transform_flow
@@ -21,6 +23,7 @@ __all__ = [
     "_engine",
     "functions",
     "sources",
+    "targets",
     "storages",
     "cli",
     "utils",

cocoindex/cli.py

@@ -247,8 +247,7 @@ def show(app_flow_specifier: str, color: bool, verbose: bool) -> None:
 )
 def setup(app_target: str, force: bool) -> None:
     """
-    Check and apply backend setup changes for flows, including the internal and target storage
-    (to export).
+    Check and apply backend setup changes for flows, including the internal storage and target (to export to).
 
     APP_TARGET: path/to/app.py or installed_module.
     """

cocoindex/flow.py

@@ -327,7 +327,7 @@ class DataCollector:
     def export(
         self,
         name: str,
-        target_spec: op.StorageSpec,
+        target_spec: op.TargetSpec,
         /,
         *,
         primary_key_fields: Sequence[str],
@@ -340,7 +340,7 @@ class DataCollector:
 
         `vector_index` is for backward compatibility only. Please use `vector_indexes` instead.
         """
-        if not isinstance(target_spec, op.StorageSpec):
+        if not isinstance(target_spec, op.TargetSpec):
             raise ValueError(
                 "export() can only be called on a CocoIndex target storage"
             )

cocoindex/op.py

@@ -19,7 +19,7 @@ class OpCategory(Enum):
 
     FUNCTION = "function"
     SOURCE = "source"
-    STORAGE = "storage"
+    TARGET = "target"
     DECLARATION = "declaration"
 
 
@@ -52,8 +52,8 @@ class FunctionSpec(metaclass=SpecMeta, category=OpCategory.FUNCTION):  # pylint:
     """A function spec. All its subclass can be instantiated similar to a dataclass, i.e. ClassName(field1=value1, field2=value2, ...)"""
 
 
-class StorageSpec(metaclass=SpecMeta, category=OpCategory.STORAGE):  # pylint: disable=too-few-public-methods
-    """A storage spec. All its subclass can be instantiated similar to a dataclass, i.e. ClassName(field1=value1, field2=value2, ...)"""
+class TargetSpec(metaclass=SpecMeta, category=OpCategory.TARGET):  # pylint: disable=too-few-public-methods
+    """A target spec. All its subclass can be instantiated similar to a dataclass, i.e. ClassName(field1=value1, field2=value2, ...)"""
 
 
 class DeclarationSpec(metaclass=SpecMeta, category=OpCategory.DECLARATION):  # pylint: disable=too-few-public-methods

cocoindex/{storages.py → targets.py}

@@ -1,4 +1,4 @@
-"""All builtin storages."""
+"""All builtin targets."""
 
 from dataclasses import dataclass
 from typing import Sequence
@@ -9,8 +9,8 @@ from .auth_registry import AuthEntryReference
 from .setting import DatabaseConnectionSpec
 
 
-class Postgres(op.StorageSpec):
-    """Storage powered by Postgres and pgvector."""
+class Postgres(op.TargetSpec):
+    """Target powered by Postgres and pgvector."""
 
     database: AuthEntryReference[DatabaseConnectionSpec] | None = None
     table_name: str | None = None
@@ -25,8 +25,8 @@ class QdrantConnection:
 
 
 @dataclass
-class Qdrant(op.StorageSpec):
-    """Storage powered by Qdrant - https://qdrant.tech/."""
+class Qdrant(op.TargetSpec):
+    """Target powered by Qdrant - https://qdrant.tech/."""
 
     collection_name: str
     connection: AuthEntryReference[QdrantConnection] | None = None
@@ -52,7 +52,7 @@ class NodeFromFields:
 
 @dataclass
 class ReferencedNode:
-    """Storage spec for a graph node."""
+    """Target spec for a graph node."""
 
     label: str
     primary_key_fields: Sequence[str]
@@ -95,7 +95,7 @@ class Neo4jConnection:
     db: str | None = None
 
 
-class Neo4j(op.StorageSpec):
+class Neo4j(op.TargetSpec):
     """Graph storage powered by Neo4j."""
 
     connection: AuthEntryReference[Neo4jConnection]
@@ -119,7 +119,7 @@ class KuzuConnection:
     api_server_url: str
 
 
-class Kuzu(op.StorageSpec):
+class Kuzu(op.TargetSpec):
     """Graph storage powered by Kuzu."""
 
     connection: AuthEntryReference[KuzuConnection]

cocoindex/utils.py

@@ -2,12 +2,10 @@ from .flow import Flow
 from .setting import get_app_namespace
 
 
-def get_target_storage_default_name(
-    flow: Flow, target_name: str, delimiter: str = "__"
-) -> str:
+def get_target_default_name(flow: Flow, target_name: str, delimiter: str = "__") -> str:
     """
     Get the default name for a target.
-    It's used as the underlying storage name (e.g. a table, a collection, etc.) followed by most storage backends, if not explicitly specified.
+    It's used as the underlying target name (e.g. a table, a collection, etc.) followed by most targets, if not explicitly specified.
     """
     return (
         get_app_namespace(trailing_delimiter=delimiter)
@@ -15,3 +13,8 @@ def get_target_storage_default_name(
         + delimiter
         + target_name
     )
+
+
+get_target_storage_default_name = (
+    get_target_default_name  # Deprecated: Use get_target_default_name instead
+)

{cocoindex-0.1.51.dist-info → cocoindex-0.1.52.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cocoindex
-Version: 0.1.51
+Version: 0.1.52
 Requires-Dist: sentence-transformers>=3.3.1
 Requires-Dist: click>=8.1.8
 Requires-Dist: rich>=14.0.0
@@ -130,7 +130,7 @@ def text_embedding_flow(flow_builder: cocoindex.FlowBuilder, data_scope: cocoind
     # Export collected data to a vector index.
     doc_embeddings.export(
         "doc_embeddings",
-        cocoindex.storages.Postgres(),
+        cocoindex.targets.Postgres(),
         primary_key_fields=["filename", "location"],
         vector_indexes=[
             cocoindex.VectorIndexDef(

{cocoindex-0.1.51.dist-info → cocoindex-0.1.52.dist-info}/RECORD

@@ -1,28 +1,28 @@
-cocoindex-0.1.51.dist-info/METADATA,sha256=VWHNukHF17O5re8ldifAS_BV1WTtfh4Iv8HDP_6ADIo,10040
-cocoindex-0.1.51.dist-info/WHEEL,sha256=2Rq0eWWH7u9Ffm_ZQEcE2_DVE8if9XSfMophnE-xWmc,96
-cocoindex-0.1.51.dist-info/entry_points.txt,sha256=_NretjYVzBdNTn7dK-zgwr7YfG2afz1u1uSE-5bZXF8,46
-cocoindex-0.1.51.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
-cocoindex/__init__.py,sha256=1-ymMFyNmEMpYyWfpOTsh84C4pYnNVeVHfrzusaINdk,1766
-cocoindex/_engine.cp312-win_amd64.pyd,sha256=P0AnfNs1uowQRJAOB0qDEfc3MzXuLPcVC7VI8syrOvM,61389312
+cocoindex-0.1.52.dist-info/METADATA,sha256=w1y1PEmcaZ6TQ9zqEPUmEkONXE55pMJRLK_5q5fPI6c,10039
+cocoindex-0.1.52.dist-info/WHEEL,sha256=2Rq0eWWH7u9Ffm_ZQEcE2_DVE8if9XSfMophnE-xWmc,96
+cocoindex-0.1.52.dist-info/entry_points.txt,sha256=_NretjYVzBdNTn7dK-zgwr7YfG2afz1u1uSE-5bZXF8,46
+cocoindex-0.1.52.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+cocoindex/__init__.py,sha256=0cJBLw3MQX7MeuurZ49TV96zdKkSCva9atqxJZG0U2M,1853
+cocoindex/_engine.cp312-win_amd64.pyd,sha256=tjGnONsEDLHnbh8a7DHQNu19gI4yB-RJqlBN3GPr1-A,61389312
 cocoindex/auth_registry.py,sha256=LojDKoX0ccO-G3bboFMlAti50_t5GK9BS0ouPJZfyUs,745
-cocoindex/cli.py,sha256=Sp_Hq3hyLU1JtQNHwlKEhReoGqNjJoAWhIGt_Q9kZDk,18800
+cocoindex/cli.py,sha256=G69aDjYiT6wWJIG2l-VQAslfdxVE_OmkWQzZdR3KXiw,18798
 cocoindex/convert.py,sha256=3OInFkmwi8RxdyAJsCLEdMa8tmmnX0Q1I0JFsInXDLo,9037
-cocoindex/flow.py,sha256=ElTNrp9cxUZiKSvLMRwjU9rNQUn2d9zxryJzCxCFx4I,30985
+cocoindex/flow.py,sha256=Dt6lzzhZgnnNbFOZ0smeDy6SlBCBofneoCBZ-T3rtIg,30983
 cocoindex/functions.py,sha256=3l7POrvuk5DVIwGUgCODAi-JNFJ1_WLTOg6Yn-uZ0IE,2471
 cocoindex/index.py,sha256=GrqTm1rLwICQ8hadtNvJAxVg7GWMvtMmFcbiNtNzmP0,569
 cocoindex/lib.py,sha256=o2UGq3eWsZbK5nusZEU7Y0R6NTbT0i03G2ye8N6ATNg,3015
 cocoindex/llm.py,sha256=sI46pXpTmOLOBOBpqCB2pnwDHz4PdVyEPBKZuIxObpU,372
-cocoindex/op.py,sha256=qSf2-zGd77YVXDC8UWUyAtDIHklNrRaFn1ZvLK5T64g,12148
+cocoindex/op.py,sha256=Jk1KfRNBY4TEsbbhWHB5pEzNcMo_2T-FQR1Y75OUVhU,12143
 cocoindex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cocoindex/runtime.py,sha256=saKEZntVwUVQNASRhiO9bHRVIFmQccemq2f9mo4mo1A,1090
 cocoindex/setting.py,sha256=dRNdX-rPBn321zGx6GGoSMggS4F2879A6EBLOUbX8R4,3717
 cocoindex/setup.py,sha256=nqJAEGQH-5yTulEy3aCAa9khbuiaqD81ZZUdeM3K_lo,799
 cocoindex/sources.py,sha256=4hxsntuyClp_jKH4oZbx3iE3UM4P2bZTpWy28dqdyFY,1375
-cocoindex/storages.py,sha256=WrfpGcOImFXH0DTEdBPRmL4GwyO62lfANMd6rTejxuQ,2939
+cocoindex/targets.py,sha256=7FfG9kuEf5KTXtLwXMFaPFIut3PsIbpb3XIEjjeF7Bg,2931
 cocoindex/tests/__init__.py,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
 cocoindex/tests/test_convert.py,sha256=tIOFqF2LzHvW7v5Ny-JWAUhzvpskDOedHKmOTrQpEUw,29774
 cocoindex/tests/test_optional_database.py,sha256=dnzmTgaJf37D3q8fQsjP5UDER6FYETaUokDnFBMLtIk,8755
 cocoindex/tests/test_typing.py,sha256=9Fc_GALPinF9PdVlaO1_fFLi12dc7cNaV8XJma0f-2s,12818
 cocoindex/typing.py,sha256=geA2nOq_frf9NGB_XpNDOHTviAitRbgYH5OWQ59VOgQ,12780
-cocoindex/utils.py,sha256=RLyawj_M4ZDL-gwJ16e5p2AcFYIL50DlMkfZyKaNB2o,520
-cocoindex-0.1.51.dist-info/RECORD,,
+cocoindex/utils.py,sha256=U3W39zD2uZpXX8v84tJD7sRmbC5ar3z_ljAP1cJrYXI,618
+cocoindex-0.1.52.dist-info/RECORD,,