tdfs4ds 0.2.4.30__py3-none-any.whl → 0.2.4.31__py3-none-any.whl

tdfs4ds/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '0.2.4.30'
+__version__ = '0.2.4.31'
 import logging
 # Setup the logger
 logging.basicConfig(

tdfs4ds/feature_store/feature_query_retrieval.py

@@ -251,33 +251,72 @@ def get_list_features(entity_name, domain=None):
 
 def get_feature_versions(entity_name, features, domain=None):
     """
-    Retrieve version UUID(s) for the given features of an entity within a domain.
+    Retrieve version identifiers for one or more features belonging to a given entity.
+
+    The function queries the underlying metadata tables to find the *process*
+    (i.e., feature‑version) records that match the supplied entity and feature
+    names.  It returns a mapping from each requested feature name to either:
+
+    * **None** – if no matching rows were found.
+    * A single UUID string – if exactly one matching row exists for the feature.
+    * A list of dictionaries – if more than one matching row is found; each
+      dictionary contains:
+        ``process_id``          – the UUID of the process that produced the
+                                  version,
+        ``process_view_name``   – the human‑readable view name associated with
+                                  that process.
+
+    Parameters
+    ----------
+    entity_name : str | list[str]
+        The name (or names) of the entity whose features we are querying.
+        If a single string is supplied it is treated as a singleton list.
+
+    features : str | list[str]
+        One or more feature names to look up.  Accepts a single string or
+        an iterable of strings; if a single string is provided it is wrapped in
+        a list internally.
+
+    domain : str, optional
+        The data‑domain partition to filter on.  If omitted the default
+        ``tdfs4ds.DATA_DOMAIN`` constant is used.
+
+    Returns
+    -------
+    dict[str, str | None | list[dict]]
+        A dictionary keyed by feature name.  Each value is either:
+            * ``None`` – no records were found for that feature.
+            * ``str`` – a single UUID string when exactly one row matched.
+            * ``list[dict]`` – multiple matches; each dict has keys
+              ``process_id`` and ``process_view_name``.
+
+    Notes
+    -----
+    * The query joins the feature catalog view with the process catalog
+      (specifically the “feature split” view) on data domain, entity ID,
+      and feature name.
+    * SQL string literals are escaped by doubling single quotes; this is a
+      lightweight escape that suffices for the current use‑case.
+    * The function preserves insertion order of features in the returned
+      dictionary (Python 3.7+ guarantees dict order).
+    * When ``tdfs4ds.DEBUG_MODE`` is true, the generated SQL statement is
+      printed to stdout – useful for troubleshooting.
+
+    Example
+    -------
+    >>> get_feature_versions('user', ['age', 'income'])
+    {'age': 'c1d2e3f4-...', 'income': None}
 
-    Parameters:
-    - entity_name (str): The entity name to which the features belong.
-    - features (str | list[str]): Feature name or list of feature names.
-    - domain (str, optional): Data domain to filter on. If None, defaults to tdfs4ds.DATA_DOMAIN.
-
-    Returns:
-    - dict[str, str | list[dict]]: Maps each requested feature name to either:
-        - a single version UUID string if exactly one row exists, or
-        - a list of dicts if multiple rows exist; each dict has:
-            {
-              "process_id": <FEATURE_VERSION UUID>,
-              "process_view_name": <PROCESS_VIEW_NAME string>
-            }
-      If a requested feature has no entries, it will be present with value None.
-
-    Notes:
-    - Uses {tdfs4ds.SCHEMA}.{tdfs4ds.FEATURE_CATALOG_NAME} as A and
-      {tdfs4ds.SCHEMA}.{tdfs4ds.PROCESS_CATALOG_NAME} as B (must exist) joined on PROCESS_ID.
-    - Respects tdfs4ds.DEBUG_MODE to print the generated SQL.
     """
 
+
     # Normalize inputs
     if isinstance(features, str):
         features = [features]
 
+    if isinstance(entity_name, str):
+        entity_name = [entity_name]
+
     if domain is None:
         domain = tdfs4ds.DATA_DOMAIN
 

{tdfs4ds-0.2.4.30.dist-info → tdfs4ds-0.2.4.31.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tdfs4ds
-Version: 0.2.4.30
+Version: 0.2.4.31
 Summary: A python package to simplify the usage of feature store using Teradata Vantage ...
 Author: Denis Molin
 Requires-Python: >=3.6

{tdfs4ds-0.2.4.30.dist-info → tdfs4ds-0.2.4.31.dist-info}/RECORD

@@ -2,7 +2,7 @@ tdfs/__init__.py,sha256=7AcO7uB1opRCt7t2JOHworKimfAaDeO3boRW7u9Geo8,23
 tdfs/datasets.py,sha256=-b2MPEKGki2V1M8iUcoDR9uc2krIK7u1CK-EhChvihs,985
 tdfs/feature_store.py,sha256=Honu7eOAXxP4Ivz0mRlhuNkfTDzgZl5HB1WlQUwzcZ0,31354
 tdfs/data/curves.csv,sha256=q0Tm-0yu7VMK4lHvHpgi1LMeRq0lO5gJy2Q17brKbEM,112488
-tdfs4ds/__init__.py,sha256=i-bbHzjX6MjTP-WcdZ26Ur-FwB8WT2_ux7GZeCzRQS8,66290
+tdfs4ds/__init__.py,sha256=Al8Ae5dlbMxjwuYgq6VTy6Cjtr9ZxfiRpjhlHguKLRQ,66290
 tdfs4ds/datasets.py,sha256=LE4Gn0muwdyrIrCrbkE92cnafUML63z1lj5bFIIVzmc,3524
 tdfs4ds/feature_engineering.py,sha256=oVnZ2V_XNGE12LKC_fNfkrWSQZLgtYRmaf8Dispi6S4,7081
 tdfs4ds/feature_store.py,sha256=y-oItPZw6nBkBcGAceaATZbkLPTsvpk0OnpzTxYofDs,68576
@@ -18,7 +18,7 @@ tdfs4ds/dataset/dataset_catalog.py,sha256=qxS2thDW2MvsRouSFaX1M0sX2J7IzBAYD8Yf22
 tdfs4ds/feature_store/__init__.py,sha256=a7NPCkpTx40UR5LRErwnskpABG2Vuib7F5wUjaUGCnI,209
 tdfs4ds/feature_store/entity_management.py,sha256=9ltytv3yCTG84NZXBpb1Tlkf9pOxvrNb0MVidU4pwvE,10157
 tdfs4ds/feature_store/feature_data_processing.py,sha256=rvpnFrV6Tmg8C6xcSQLT_lrFYqZsdSzFXmS-4suK9qg,42847
-tdfs4ds/feature_store/feature_query_retrieval.py,sha256=qqnUsg2Iw1nNvTqBZLwEwBNxwDcSZh0QX29mycjdwvU,33780
+tdfs4ds/feature_store/feature_query_retrieval.py,sha256=51c6ZNlLFiBIxNPinS8ot8bjWEIb1QV2eVg69yzVF80,35381
 tdfs4ds/feature_store/feature_store_management.py,sha256=pWM9sjppBgRIg3l1ksoDJsM1fnaZlWtnuE3JuOP_2mY,54736
 tdfs4ds/process_store/__init__.py,sha256=npHR_xju5ecGmWfYHDyteLwiU3x-cL4HD3sFK_th7xY,229
 tdfs4ds/process_store/process_followup.py,sha256=PvLcU7meg3ljBlPfuez3qwTVqpHHhVJxYxGqjgiHE8E,7265
@@ -32,7 +32,7 @@ tdfs4ds/utils/lineage.py,sha256=gy5M42qy5fvdWmlohAY3WPYoqAyp5VakeEmeT1YjrJQ,3783
 tdfs4ds/utils/query_management.py,sha256=nAcE8QY1GWAKgOtb-ubSfDVcnYbU7Ge8CruVRLoPtmY,6356
 tdfs4ds/utils/time_management.py,sha256=1eqGs7rT3SGag0F30R3PzwiC7Aa7DKia2Ud0aSNKcPg,10593
 tdfs4ds/utils/visualization.py,sha256=5S528KoKzzkrAdCxfy7ecyqKvAXBoibNvHwz_u5ISMs,23167
-tdfs4ds-0.2.4.30.dist-info/METADATA,sha256=cRbDpkXQL2aJoRBTES29Hba855N7TjfljM5rGkdtGTQ,14326
-tdfs4ds-0.2.4.30.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
-tdfs4ds-0.2.4.30.dist-info/top_level.txt,sha256=wMyVkMvnBn8RRt1xBveGQxOpWFijPMPkMiE7G2mi8zo,8
-tdfs4ds-0.2.4.30.dist-info/RECORD,,
+tdfs4ds-0.2.4.31.dist-info/METADATA,sha256=LscQTdUHdZfJI8bxxJn3zJoXnAvrphbeemuArdE_9tM,14326
+tdfs4ds-0.2.4.31.dist-info/WHEEL,sha256=R0nc6qTxuoLk7ShA2_Y-UWkN8ZdfDBG2B6Eqpz2WXbs,91
+tdfs4ds-0.2.4.31.dist-info/top_level.txt,sha256=wMyVkMvnBn8RRt1xBveGQxOpWFijPMPkMiE7G2mi8zo,8
+tdfs4ds-0.2.4.31.dist-info/RECORD,,