cocoindex 0.1.51__cp312-cp312-macosx_10_12_x86_64.whl → 0.1.52__cp312-cp312-macosx_10_12_x86_64.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=A88vlfjkMZq9o0uB23j60uueJrzBs7RPf38zSHP6MuY,9875
-cocoindex-0.1.51.dist-info/WHEEL,sha256=l1vhwtWCYEW2jwRYHpKxbN3fl_lgdUpY7Hrp_A4sC3c,106
-cocoindex-0.1.51.dist-info/entry_points.txt,sha256=_NretjYVzBdNTn7dK-zgwr7YfG2afz1u1uSE-5bZXF8,46
-cocoindex-0.1.51.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-cocoindex/__init__.py,sha256=H0YmqZaLBNLtY4PWYM1w9lM_HbiGGh2xEwo1_NMDOOE,1698
-cocoindex/_engine.cpython-312-darwin.so,sha256=e7ubtPd1Y6ppVTsUaxuhzuJtdgcpFISfIqpr9Jd8_mU,59681300
+cocoindex-0.1.52.dist-info/METADATA,sha256=8psE6rLZFYrw7cBEU-rVD1JGf4ezIIHMn-Yk2ZVNEKY,9874
+cocoindex-0.1.52.dist-info/WHEEL,sha256=l1vhwtWCYEW2jwRYHpKxbN3fl_lgdUpY7Hrp_A4sC3c,106
+cocoindex-0.1.52.dist-info/entry_points.txt,sha256=_NretjYVzBdNTn7dK-zgwr7YfG2afz1u1uSE-5bZXF8,46
+cocoindex-0.1.52.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+cocoindex/__init__.py,sha256=3potlGouaGAznMTEqU5QKuB934qpD1xR6ZH6EL3YMWw,1782
+cocoindex/_engine.cpython-312-darwin.so,sha256=LG1dO26uT5wut_6VyPWYX6KklzfZ4GGZOwBlXoUul3w,59680900
 cocoindex/auth_registry.py,sha256=1XqO7ibjmBBd8i11XSJTvTgdz8p1ptW-ZpuSgo_5zzk,716
-cocoindex/cli.py,sha256=mlHIgH8vgf4PuTYifAOtn2ywcbVCOT452pIg376uPLs,18224
+cocoindex/cli.py,sha256=joSucqLibjZHs27fwNPzuMPGLeVJJZqaUbeSM-OnEyA,18223
 cocoindex/convert.py,sha256=s5T2IQ1tMBT9JKTzqQtQ-I0sUrfjBGKAnMjDjY6LdrI,8785
-cocoindex/flow.py,sha256=sC7eg0L9MkZuo7MlvGA4eYe-mEReIyPjKIILFtkWm-Y,30017
+cocoindex/flow.py,sha256=uQKvIyWSysSdhNFI87QD6f2kbF-2R6zFMLZWBEk4rZU,30015
 cocoindex/functions.py,sha256=9A61Jj5a3vQoI2MIAhjXvJrDxSzDhe6VncQWbiVtwcg,2393
 cocoindex/index.py,sha256=j93B9jEvvLXHtpzKWL88SY6wCGEoPgpsQhEGHlyYGFg,540
 cocoindex/lib.py,sha256=BeRUn3RqE_wSsVtsgCzbFFKe1LXgRyRmMOcmwWBuEXo,2940
 cocoindex/llm.py,sha256=KO-R4mrAWtxXD82-Yv5ixpkKMVfkwpbdWwqPVZygLu4,352
-cocoindex/op.py,sha256=hOJoHC8elhLHMNVRTGTBWNSK5uYrQb-FfRV-qt08j8g,11815
+cocoindex/op.py,sha256=Z7V9Fdz4qeTeozzKmp1Dk1lPUP0GBgVgD_vBEhTJS5Y,11810
 cocoindex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cocoindex/runtime.py,sha256=bAdHYaXFWiiUWyAgzmKTeaAaRR0D_AmaqVCIdPO-v00,1056
 cocoindex/setting.py,sha256=Zl8K86r8RVvG9c3pCsH0Ot8BHhDAQAQCjoBp7TnXMLQ,3590
 cocoindex/setup.py,sha256=u5dYZFKfz4yZLiGHD0guNaR0s4zY9JAoZWrWHpAHw_0,773
 cocoindex/sources.py,sha256=JCnOhv1w4o28e03i7yvo4ESicWYAhckkBg5bQlxNH4U,1330
-cocoindex/storages.py,sha256=i9cPzj5LbLJVHjskEWyltUXF9kqCyc6ftMEqll6FDwI,2804
+cocoindex/targets.py,sha256=Nfh_tpFd1goTnS_cxBjIs4j9zl3Z4Z1JomAQ1dl3Sic,2796
 cocoindex/tests/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 cocoindex/tests/test_convert.py,sha256=mlCJ1U_T7sPDk1Dw78V1BKaYbfqjDjGAaOZT0zMYOwg,28960
 cocoindex/tests/test_optional_database.py,sha256=snAmkNa6wtOSaxoZE1HgjvL5v_ylitt3Jt_9df4Cgdc,8506
 cocoindex/tests/test_typing.py,sha256=4cy_6kPyGxsM6qX-O8K-jXhsgDr_FXePplERgky22qI,12313
 cocoindex/typing.py,sha256=PEV_ds7AGHAHkZmX_fWg-2mFiEXDx-V-Rlhv11_8rtk,12387
-cocoindex/utils.py,sha256=5a3ubVzDowJUJyUl8ecd75Th_OzON3G-MV2vXf0dQSk,503
-cocoindex-0.1.51.dist-info/RECORD,,
+cocoindex/utils.py,sha256=hUhX-XV6XGCtJSEIpBOuDv6VvqImwPlgBxztBTw7u0U,598
+cocoindex-0.1.52.dist-info/RECORD,,