kumoai 2.8.0.dev202508221830__cp312-cp312-win_amd64.whl → 2.13.0.dev202512041141__cp312-cp312-win_amd64.whl

{kumoai-2.8.0.dev202508221830.dist-info → kumoai-2.13.0.dev202512041141.dist-info}/RECORD

@@ -1,27 +1,27 @@
-kumoai/__init__.py,sha256=7YoN_aogTFbuPKHjwvu8Pr8DqkZGCSUTqXj-yofcUFM,10965
+kumoai/__init__.py,sha256=aDhb7KGetDnOz54u1Fd45zfM2N8oAha6XT2CvJqOvgc,11146
 kumoai/_logging.py,sha256=qL4JbMQwKXri2f-SEJoFB8TY5ALG12S-nobGTNWxW-A,915
 kumoai/_singleton.py,sha256=i2BHWKpccNh5SJGDyU0IXsnYzJAYr8Xb0wz4c6LRbpo,861
-kumoai/_version.py,sha256=mQmXhIWyED2fIOtnDAb23CuCAjzyA3mIXYU3hlF4DvI,38
+kumoai/_version.py,sha256=McPvlMmb6xkSvtMtZU2vb69TZors40shSvLriwqEhBw,39
 kumoai/databricks.py,sha256=ahwJz6DWLXMkndT0XwEDBxF-hoqhidFR8wBUQ4TLZ68,490
 kumoai/exceptions.py,sha256=7TMs0SC8xrU009_Pgd4QXtSF9lxJq8MtRbeX9pcQUy4,859
 kumoai/formatting.py,sha256=o3uCnLwXPhe1KI5WV9sBgRrcU7ed4rgu_pf89GL9Nc0,983
 kumoai/futures.py,sha256=J8rtZMEYFzdn5xF_x-LAiKJz3KGL6PT02f6rq_2bOJk,3836
-kumoai/jobs.py,sha256=u_GJe1kfd8f-HNJ6i7xxJ6JY7Z5CZ2NtKueARAUs_Wo,1622
-kumoai/kumolib.cp312-win_amd64.pyd,sha256=MR6sZl8OTcCfxvezN8cnTnxzl2wdCpGmvhpccnCVhng,198144
+kumoai/jobs.py,sha256=dCi7BAdfm2tCnonYlGU4WJokJWbh3RzFfaOX2EYCIHU,2576
+kumoai/kumolib.cp312-win_amd64.pyd,sha256=c0vnGY_ijKKf7uphRp8HxQs5J6hpJv6vKFekna6zanY,198144
 kumoai/mixin.py,sha256=IaiB8SAI0VqOoMVzzIaUlqMt53-QPUK6OB0HikG-V9E,840
-kumoai/spcs.py,sha256=SWvfkeJvb_7sGkjSqyMBIuPbMTWCP6v0BC9HBXM1uSI,4398
+kumoai/spcs.py,sha256=KWfENrwSLruprlD-QPh63uU0N6npiNrwkeKfBk3EUyQ,4260
 kumoai/artifact_export/__init__.py,sha256=UXAQI5q92ChBzWAk8o3J6pElzYHudAzFZssQXd4o7i8,247
 kumoai/artifact_export/config.py,sha256=PRoUByzu5l-nyBKFR4vnRlq19b53ExGVy8YDCD7zMuI,8233
 kumoai/artifact_export/job.py,sha256=lOFIdPCrvhwdfvvDhQ2yzW8J4qIdYQoHZO1Rz3kJky4,3383
 kumoai/client/__init__.py,sha256=v0ISO1QD8JJhIJS6IzWz5-SL3EhtNCPeX3j1b2HBY0s,69
-kumoai/client/client.py,sha256=5AI-m7MhXgZm68GdX_J4YBoaR0fdFlqgcmA8rq1eYDQ,8416
+kumoai/client/client.py,sha256=T6Kw7-XWuAy5Dh7XU5graBl1-cTARiobycwtgxzaSE8,8731
 kumoai/client/connector.py,sha256=CO2LG5aDpCLxWNYYFRXGZs1AhYH3dRcbqBEUGwHQGzQ,4030
-kumoai/client/endpoints.py,sha256=gyVxVkdlO7FMR_UHof3RWsoTY-87JTD7y1lLIw1kh8A,5464
+kumoai/client/endpoints.py,sha256=DpEKEQ1yvL15iHZadXZKO94t-qXrYLaeV1sknX4IuPg,5532
 kumoai/client/graph.py,sha256=6MFyPYxDPfGTWeAI_84RUgWx9rVvqbLnR0Ourtgj5rg,3951
 kumoai/client/jobs.py,sha256=Y8wKiTk1I5ywc-2cxR72LaBjfhPTCVOezSCTeDpTs8Q,17521
 kumoai/client/online.py,sha256=4s_8Sv8m_k_tty4CO7RuAt0e6BDMkGvsZZ3VX8zyDb8,2798
 kumoai/client/pquery.py,sha256=0pXgQLxjoaFWDif0XRAuC_P-X3OSnXNWsiVrXej9uMk,7094
-kumoai/client/rfm.py,sha256=wr2CXFdtvu5wGJz7iQ2OBzhQRu_EyMESH8KJZ0dsBMo,2965
+kumoai/client/rfm.py,sha256=Gmt_dqoXekBCLiF0eQPgpoJ1cbnhnU8VbINF3U13qbQ,3838
 kumoai/client/source_table.py,sha256=mMHJtQ_yUHRI9LdHLVHxNGt83bbzmC1_d-NmXjbiTuI,2154
 kumoai/client/table.py,sha256=VhjLEMLQS1Z7zjcb2Yt3gZfiVqiD7b1gj-WNux_504A,3336
 kumoai/client/utils.py,sha256=RSD5Ia0lQQDR1drRFBJFdo2KVHfQqhJuk6m6du7Kl4E,3979
@@ -45,54 +45,67 @@ kumoai/connector/__init__.py,sha256=yPE3TVLCKdVKhsqPsYVSA290eIZCOTtHtylxm2I5U6Q,
 kumoai/connector/base.py,sha256=AYCtcYuncLyMl0FLLUMu5z4qFBWury5jhK2D9sZJIgA,5444
 kumoai/connector/bigquery_connector.py,sha256=KMgXEyN6PCM5RV5fvKx0ZPubucf43LEz7KvDtKCHXbM,7282
 kumoai/connector/databricks_connector.py,sha256=oJ2GHp_CFOeMWGPOHqpxmotquAobWV9iGZ-__Rpdr5o,7787
-kumoai/connector/file_upload_connector.py,sha256=cXdbabNGwQX4N4GpK00SJnzF54QUGMSAhFRVTBs-kAc,7078
+kumoai/connector/file_upload_connector.py,sha256=13dWWXd_RNosWNHmZYasHDsVfpDS9qVCIYeST-7zljA,7197
 kumoai/connector/glue_connector.py,sha256=kqT2q53Da7PeeaZrvLVzFXC186E7glh5eGitKL26lYY,4847
 kumoai/connector/s3_connector.py,sha256=AUzENbQ20bYXh3XOXEOsWRKlaGGkm3YrW9JfBLm-LqY,10433
 kumoai/connector/snowflake_connector.py,sha256=tQzIWxC4oDGqxFt0212w5eoIPT4QBP2nuF9SdKRNwNI,9274
 kumoai/connector/source_table.py,sha256=fnqwIKY6qYo4G0EsRzchb6FgZ-dQyU6aRaD9UAxsml0,18010
-kumoai/connector/utils.py,sha256=nR0fSjuu9s7uWJ8aZlTkvA9Rh3fHBecNrEhJuA1w_UI,21636
+kumoai/connector/utils.py,sha256=5K9BMdWiIP3hhdkUc6Xt1e0xv5YyziXtZ4PnBqq0Ehw,66490
 kumoai/encoder/__init__.py,sha256=8FeP6mUyCeXxr1b8kUIi5dxe5vEXQRft9tPoaV1CBqg,186
 kumoai/experimental/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kumoai/experimental/rfm/__init__.py,sha256=miVZCXdMdGxtjSgOcBSUZ79bNZ6CMM0z3LOcv5zlDXs,1706
-kumoai/experimental/rfm/authenticate.py,sha256=qDgy_k0LoW5gy46TquQDqHiJa7WOlH-trNCE-BkSYKA,19237
-kumoai/experimental/rfm/local_graph.py,sha256=kXl6mZ1MW_0FadFt_WIRnuK52SfaaLmQAwYIj8kdQYQ,30080
-kumoai/experimental/rfm/local_graph_sampler.py,sha256=fyAAf2L2WZnre8WQw148V2PZN1ASNIR3CPUVAO8MpOg,6371
-kumoai/experimental/rfm/local_graph_store.py,sha256=6cSL52YC9NK6ju5f4_DWKz0eUm4igvxs58m88jsrMEU,13410
-kumoai/experimental/rfm/local_pquery_driver.py,sha256=68Y9TIdoqIK3pgEsRVtrnTBIWctw4WRzba7gk184qV4,15398
-kumoai/experimental/rfm/local_table.py,sha256=F9jxLs5oHFevH5sY-u1JO8qFZy3hS4i-1qg_eoWNmDQ,16283
-kumoai/experimental/rfm/rfm.py,sha256=98RLN0awzqGlQNzGGWIz-VJL7vdnN3iZUQUMj90Ictc,31581
-kumoai/experimental/rfm/utils.py,sha256=aJNoUGApZ-TaRBFzV6AfscsnE-snzpwOvgtlMcbiPfU,11583
-kumoai/experimental/rfm/infer/__init__.py,sha256=fPsdDr4D3hgC8snW0j3pAVpCyR-xrauuogMnTOMrfok,304
+kumoai/experimental/rfm/__init__.py,sha256=EFZz6IvvskmeO85Vig6p1m_6jdimS_BkeREOndHuRsc,6247
+kumoai/experimental/rfm/authenticate.py,sha256=G89_4TMeUpr5fG_0VTzMF5sdNhaciitA1oc2loTlTmo,19321
+kumoai/experimental/rfm/graph.py,sha256=SL3-WinoLnkZC6VVjebYGLuQJJyEVFJdCm6h3FNE0e4,40816
+kumoai/experimental/rfm/local_graph_sampler.py,sha256=dQ3JnuozTNeZyUFRu2h8OTMNmV1RAoaCA0gvkpgOstg,8110
+kumoai/experimental/rfm/local_graph_store.py,sha256=6jY1ciVIlnBBhZCxWwBTl7SKX1fxRIDLszwrftD0Cdk,13485
+kumoai/experimental/rfm/local_pquery_driver.py,sha256=Yd_yHIrvuDj16IC1pvsqiQvZS41vvOOCRMiuDGtN6Fk,26851
+kumoai/experimental/rfm/rfm.py,sha256=vOnL8ecHTo1TX2B8_T8xaWGou8qYYz8DyVENu1H93mM,48834
+kumoai/experimental/rfm/sagemaker.py,sha256=sEJSyfEFBA3-7wKinBEzSooKHEn0BgPjrgRnPhYo79g,5120
+kumoai/experimental/rfm/backend/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kumoai/experimental/rfm/backend/local/__init__.py,sha256=usMh0fuDxKK-aOVT1sU30BQWFS0eSkfUrhUVILisQQI,934
+kumoai/experimental/rfm/backend/local/table.py,sha256=1PqNOROzlnK3SaZHNcU2hyzeifs0N4wssQAS3-Z0Myc,3674
+kumoai/experimental/rfm/backend/snow/__init__.py,sha256=viMeR9VWpB1kjRdSWCTNFMdM7a8Mj_Dtck1twJW8dV8,962
+kumoai/experimental/rfm/backend/snow/table.py,sha256=Rf4hUPOUtsjpaIc9vBKWPZ3yz20OOg6DZqCGeih4KC8,4372
+kumoai/experimental/rfm/backend/sqlite/__init__.py,sha256=xw5NNLrWSvUvRkD49X_9hZYjas5EuP1XDANPy0EEjOg,874
+kumoai/experimental/rfm/backend/sqlite/table.py,sha256=mBiZC21gQwfR4demFrP37GmawMHfIm-G82mLQeBqIZo,3901
+kumoai/experimental/rfm/base/__init__.py,sha256=oXPkeBemtuDxRUK61-0sOT84GZB_oQ6HvaZNU1KFNaw,199
+kumoai/experimental/rfm/base/column.py,sha256=OE-PRQ8HO4uTq0e3_3eHJFfhp5nzw79zd-43g3iMh4g,2385
+kumoai/experimental/rfm/base/source.py,sha256=H5yN9xAwK3i_69EdqOV_x58muPGKQiI8ev5BhHQDZEo,290
+kumoai/experimental/rfm/base/table.py,sha256=AXv25R55TwcPVUcq84c7Zs2z_fWtu8yK3xj7KPOVF0I,20388
+kumoai/experimental/rfm/infer/__init__.py,sha256=qKg8or-SpgTApD6ePw1PJ4aUZPrOLTHLRCmBIJ92hrk,486
 kumoai/experimental/rfm/infer/categorical.py,sha256=bqmfrE5ZCBTcb35lA4SyAkCu3MgttAn29VBJYMBNhVg,893
+kumoai/experimental/rfm/infer/dtype.py,sha256=Hf_drluYNuN59lTSe-8GuXalg20Pv93kCktB6Hb9f74,2686
 kumoai/experimental/rfm/infer/id.py,sha256=xaJBETLZa8ttzZCsDwFSwfyCi3VYsLc_kDWT_t_6Ih4,954
 kumoai/experimental/rfm/infer/multicategorical.py,sha256=D-1KwYRkOSkBrOJr4Xa3eTCoAF9O9hPGa7Vg67V5_HU,1150
-kumoai/experimental/rfm/infer/timestamp.py,sha256=36SKjRNhyjNnfYd4_9_7vbzFxSx4z7GIbEt5tKVWszQ,954
-kumoai/experimental/rfm/pquery/__init__.py,sha256=XMpRh6-fahTU8XMXSxn8zbJQvYD1HkELh2su_YJvSmU,153
-kumoai/experimental/rfm/pquery/backend.py,sha256=iprPBozsEdmcCWJ9DRg4nHujkxNPuXbP2fksbWt06BU,3291
-kumoai/experimental/rfm/pquery/pandas_backend.py,sha256=Vrxba7vG9S6AiMLtxTvbTFHr6pQQtqAHUAEEprVQ-ho,14317
+kumoai/experimental/rfm/infer/pkey.py,sha256=Hvztcircd4iGdsnFU9Xi1kq_A5ONMnkAdnrpQT5svSs,4519
+kumoai/experimental/rfm/infer/time_col.py,sha256=G98Cgz1m9G9VA-ApnCmGYnJxEFwp1jfaPf3nCMOz_N0,1882
+kumoai/experimental/rfm/infer/timestamp.py,sha256=L2VxjtYTSyUBYAo4M-L08xSQlPpqnHMAVF5_vxjh3Y0,1135
+kumoai/experimental/rfm/pquery/__init__.py,sha256=RkTn0I74uXOUuOiBpa6S-_QEYctMutkUnBEfF9ztQzI,159
+kumoai/experimental/rfm/pquery/executor.py,sha256=S8wwXbAkH-YSnmEVYB8d6wyJF4JJ003mH_0zFTvOp_I,2843
+kumoai/experimental/rfm/pquery/pandas_executor.py,sha256=QQpOZ_ArH3eSAkenaY3J-gW1Wn5A7f85RiqZxaO5u1Q,19019
 kumoai/graph/__init__.py,sha256=QGk3OMwRzQJSGESdcc7hcQH6UDmNVJYTdqnRren4c7Q,240
 kumoai/graph/column.py,sha256=cQhioibTbIKIBZ-bf8-Bt4F4Iblhidps-CYWrkxRPnE,4295
 kumoai/graph/graph.py,sha256=Pq-dxi4MwoDtrrwm3xeyUB9Hl7ryNfHq4rMHuvyNB3c,39239
 kumoai/graph/table.py,sha256=BB-4ezyd7hrrj6QZwRBa80ySH0trwYb4fmhRn3xoK-k,34726
 kumoai/pquery/__init__.py,sha256=FF6QUTG_xrz2ic1I8NcIa8O993Ae98eZ9gkvQ4rapgo,558
-kumoai/pquery/prediction_table.py,sha256=i6uOMiS24MuiJKnpzHyS8h0Vd4h1vOe0Wp-ufG6rPVQ,11098
+kumoai/pquery/prediction_table.py,sha256=hWG4L_ze4PLgUoxCXNKk8_nkYxVXELQs8_X8KGOE9yk,11063
 kumoai/pquery/predictive_query.py,sha256=GWhQpQxf6apyyu-bvE3z63mX6NLd8lKbyu_jzj7rNms,25608
-kumoai/pquery/training_table.py,sha256=mM4H6jQtR1FSuPPOeQV8zAyTsKjig8X2qpJNIgRaXNQ,16263
+kumoai/pquery/training_table.py,sha256=L1QjaVlY4SAPD8OUmTaH6YjZzBbPOnS9mnAT69znWv0,16233
 kumoai/testing/__init__.py,sha256=XBQ_Sa3WnOYlpXZ3gUn8w6nVfZt-nfPhytfIBeiPt4w,178
-kumoai/testing/decorators.py,sha256=yznguzsdkL0UaZtBbnO6oaUrXisJvziaiO3dmN41UXE,1648
+kumoai/testing/decorators.py,sha256=p79ZCQqPY_MHWy0_l7-xQ6wUIqFTn4AbrGWTHLvpbQY,1664
 kumoai/trainer/__init__.py,sha256=uCFXy9bw_byn_wYd3M-BTZCHTVvv4XXr8qRlh-QOvag,981
 kumoai/trainer/baseline_trainer.py,sha256=oXweh8j1sar6KhQfr3A7gmQxcDq7SG0Bx3jIenbtyC4,4117
 kumoai/trainer/config.py,sha256=7_Jv1w1mqaokCQwQdJkqCSgVpmh8GqE3fL1Ky_vvttI,100
-kumoai/trainer/job.py,sha256=ErQ-dAYpOq0s1yKu-2LKuKXgcrtBiJ8BcsJOZ4XF5vg,47009
+kumoai/trainer/job.py,sha256=IBP2SeIk21XpRK1Um1NIs2dEKid319cHu6UkCjKO6jc,46130
 kumoai/trainer/online_serving.py,sha256=T1jicl-qXiiWGQWUCwlfQsyxWUODybj_975gx9yglH4,9824
-kumoai/trainer/trainer.py,sha256=J3PrMBqh5B1sarpJ0FXaC26hrAQWycmOfWwKmpPqkgI,19972
+kumoai/trainer/trainer.py,sha256=AKumc3X2Vm3qxZSA85Dv_fSLC4JQ3rM7P0ixOWbEex0,20608
 kumoai/trainer/util.py,sha256=LCXkY5MNl6NbEVd2OZ0aVqF6fvr3KiCFh6pH0igAi_g,4165
-kumoai/utils/__init__.py,sha256=rWH6YhGmjIQv2Lip_lAYoDaxk9SUVBdzIB3bLOFj9J4,217
+kumoai/utils/__init__.py,sha256=wAKgmwtMIGuiauW9D_GGKH95K-24Kgwmld27mm4nsro,278
 kumoai/utils/datasets.py,sha256=UyAII-oAn7x3ombuvpbSQ41aVF9SYKBjQthTD-vcT2A,3011
 kumoai/utils/forecasting.py,sha256=ZgKeUCbWLOot0giAkoigwU5du8LkrwAicFOi5hVn6wg,7624
-kumoai/utils/progress_logger.py,sha256=Nqz_1joFyLa535PPSYYq7C3pupK1GwCRlyGvroumP24,2726
-kumoai-2.8.0.dev202508221830.dist-info/licenses/LICENSE,sha256=ZUilBDp--4vbhsEr6f_Upw9rnIx09zQ3K9fXQ0rfd6w,1111
-kumoai-2.8.0.dev202508221830.dist-info/METADATA,sha256=h5rtvNOmFzjNuyC_4IDVhMSKja89dXdoc37tseg1M54,2160
-kumoai-2.8.0.dev202508221830.dist-info/WHEEL,sha256=8UP9x9puWI0P1V_d7K2oMTBqfeLNm21CTzZ_Ptr0NXU,101
-kumoai-2.8.0.dev202508221830.dist-info/top_level.txt,sha256=YjU6UcmomoDx30vEXLsOU784ED7VztQOsFApk1SFwvs,7
-kumoai-2.8.0.dev202508221830.dist-info/RECORD,,
+kumoai/utils/progress_logger.py,sha256=MZsWgHd4UZQKCXiJZgQeW-Emi_BmzlCKPLPXOL_HqBo,5239
+kumoai-2.13.0.dev202512041141.dist-info/licenses/LICENSE,sha256=ZUilBDp--4vbhsEr6f_Upw9rnIx09zQ3K9fXQ0rfd6w,1111
+kumoai-2.13.0.dev202512041141.dist-info/METADATA,sha256=u_gUSAP3qQqL1DJdsjHmcNaxsYCrgbVgRQ5SSAV-kEU,2580
+kumoai-2.13.0.dev202512041141.dist-info/WHEEL,sha256=8UP9x9puWI0P1V_d7K2oMTBqfeLNm21CTzZ_Ptr0NXU,101
+kumoai-2.13.0.dev202512041141.dist-info/top_level.txt,sha256=YjU6UcmomoDx30vEXLsOU784ED7VztQOsFApk1SFwvs,7
+kumoai-2.13.0.dev202512041141.dist-info/RECORD,,

kumoai/experimental/rfm/local_table.py

@@ -1,448 +0,0 @@
-from dataclasses import dataclass
-from typing import Any, Dict, List, Optional
-
-import pandas as pd
-from kumoapi.source_table import UnavailableSourceTable
-from kumoapi.table import Column as ColumnDefinition
-from kumoapi.table import TableDefinition
-from kumoapi.typing import Dtype, Stype
-from typing_extensions import Self
-
-from kumoai import in_notebook
-from kumoai.experimental.rfm import utils
-
-
-@dataclass(init=False, repr=False, eq=False)
-class Column:
-    stype: Stype
-
-    def __init__(
-        self,
-        name: str,
-        dtype: Dtype,
-        stype: Stype,
-        is_primary_key: bool = False,
-        is_time_column: bool = False,
-    ) -> None:
-        self._name = name
-        self._dtype = Dtype(dtype)
-        self._is_primary_key = is_primary_key
-        self._is_time_column = is_time_column
-        self.stype = Stype(stype)
-
-    @property
-    def name(self) -> str:
-        return self._name
-
-    @property
-    def dtype(self) -> Dtype:
-        return self._dtype
-
-    def __setattr__(self, key: str, val: Any) -> None:
-        if key == 'stype':
-            if isinstance(val, str):
-                val = Stype(val)
-            assert isinstance(val, Stype)
-            if not val.supports_dtype(self.dtype):
-                raise ValueError(f"Column '{self.name}' received an "
-                                 f"incompatible semantic type (got "
-                                 f"dtype='{self.dtype}' and stype='{val}')")
-            if self._is_primary_key and val != Stype.ID:
-                raise ValueError(f"Primary key '{self.name}' must have 'ID' "
-                                 f"semantic type (got '{val}')")
-            if self.name == self._is_time_column and val != Stype.timestamp:
-                raise ValueError(f"Time column '{self.name}' must have "
-                                 f"'timestamp' semantic type (got '{val}')")
-
-        super().__setattr__(key, val)
-
-    def __hash__(self) -> int:
-        return hash((self.name, self.stype, self.dtype))
-
-    def __eq__(self, other: Any) -> bool:
-        if not isinstance(other, Column):
-            return False
-        return hash(self) == hash(other)
-
-    def __repr__(self) -> str:
-        return (f'{self.__class__.__name__}(name={self.name}, '
-                f'stype={self.stype}, dtype={self.dtype})')
-
-
-class LocalTable:
-    r"""A table backed by a :class:`pandas.DataFrame`.
-
-    A :class:`LocalTable` fully specifies the relevant metadata, *i.e.*
-    selected columns, column semantic types, primary keys and time columns.
-    :class:`LocalTable` is used to create a :class:`LocalGraph`.
-
-    .. code-block:: python
-
-        import pandas as pd
-        import kumoai.experimental.rfm as rfm
-
-        # Load data from a CSV file:
-        df = pd.read_csv("data.csv")
-
-        # Create a table from a `pandas.DataFrame` and infer its metadata ...
-        table = rfm.LocalTable(df, name="my_table").infer_metadata()
-
-        # ... or create a table explicitly:
-        table = rfm.LocalTable(
-            df=df,
-            name="my_table",
-            primary_key="id",
-            time_column="time",
-        )
-
-        # Verify metadata:
-        table.print_metadata()
-
-        # Change the semantic type of a column:
-        table[column].stype = "text"
-
-    Args:
-        df: The data frame to create the table from.
-        name: The name of the table.
-        primary_key: The name of the primary key of this table, if it exists.
-        time_column: The name of the time column of this table, if it exists.
-    """
-    def __init__(
-        self,
-        df: pd.DataFrame,
-        name: str,
-        primary_key: Optional[str] = None,
-        time_column: Optional[str] = None,
-    ) -> None:
-
-        if df.empty:
-            raise ValueError("Data frame must have at least one row")
-        if isinstance(df.columns, pd.MultiIndex):
-            raise ValueError("Data frame must not have a multi-index")
-        if not df.columns.is_unique:
-            raise ValueError("Data frame must have unique column names")
-        if any(col == '' for col in df.columns):
-            raise ValueError("Data frame must have non-empty column names")
-
-        df = df.copy(deep=False)
-        df.columns = df.columns.str.replace(r'\s+', '_', regex=True)
-
-        self._data = df
-        self._name = name
-        self._primary_key: Optional[str] = None
-        self._time_column: Optional[str] = None
-
-        self._columns: Dict[str, Column] = {}
-        for column_name in df.columns:
-            try:
-                dtype = utils.to_dtype(df[column_name])
-            except Exception as e:
-                raise RuntimeError(f"Data type inference for column "
-                                   f"'{column_name}' in table '{name}' "
-                                   f"failed. Consider changing the data type "
-                                   f"of the column or removing it from the "
-                                   f"table.") from e
-            try:
-                stype = utils.infer_stype(df[column_name], column_name, dtype)
-            except Exception as e:
-                raise RuntimeError(f"Semantic type inference for column "
-                                   f"'{column_name}' in table '{name}' "
-                                   f"failed. Consider changing the data type "
-                                   f"of the column or removing it from the "
-                                   f"table.") from e
-            self._columns[column_name] = Column(
-                name=column_name,
-                dtype=dtype,
-                stype=stype,
-            )
-
-        if primary_key is not None:
-            self.primary_key = primary_key
-
-        if time_column is not None:
-            self.time_column = time_column
-
-    @property
-    def name(self) -> str:
-        r"""The name of the table."""
-        return self._name
-
-    # Data column #############################################################
-
-    def has_column(self, name: str) -> bool:
-        r"""Returns ``True`` if this table holds a column with name ``name``;
-        ``False`` otherwise.
-        """
-        return name in self._columns
-
-    def column(self, name: str) -> Column:
-        r"""Returns the data column named with name ``name`` in this table.
-
-        Args:
-            name: The name of the column.
-
-        Raises:
-            KeyError: If ``name`` is not present in this table.
-        """
-        if not self.has_column(name):
-            raise KeyError(f"Column '{name}' not found in table '{self.name}'")
-        return self._columns[name]
-
-    @property
-    def columns(self) -> List[Column]:
-        r"""Returns a list of :class:`Column` objects that represent the
-        columns in this table.
-        """
-        return list(self._columns.values())
-
-    def remove_column(self, name: str) -> Self:
-        r"""Removes a column from this table.
-
-        Args:
-            name: The name of the column.
-
-        Raises:
-            KeyError: If ``name`` is not present in this table.
-        """
-        if not self.has_column(name):
-            raise KeyError(f"Column '{name}' not found in table '{self.name}'")
-
-        if self._primary_key == name:
-            self.primary_key = None
-        if self._time_column == name:
-            self.time_column = None
-        del self._columns[name]
-
-        return self
-
-    # Primary key #############################################################
-
-    def has_primary_key(self) -> bool:
-        r"""Returns ``True``` if this table has a primary key; ``False``
-        otherwise.
-        """
-        return self._primary_key is not None
-
-    @property
-    def primary_key(self) -> Optional[Column]:
-        r"""The primary key column of this table.
-
-        The getter returns the primary key column of this table, or ``None`` if
-        no such primary key is present.
-
-        The setter sets a column as a primary key on this table, and raises a
-        :class:`ValueError` if the primary key has a non-ID semantic type or
-        if the column name does not match a column in the data frame.
-        """
-        if not self.has_primary_key():
-            return None
-        assert self._primary_key is not None
-        return self[self._primary_key]
-
-    @primary_key.setter
-    def primary_key(self, name: Optional[str]) -> None:
-        if name is not None and name == self._time_column:
-            raise ValueError(f"Cannot specify column '{name}' as a primary "
-                             f"key since it is already defined to be a time "
-                             f"column")
-
-        if self.primary_key is not None:
-            self.primary_key._is_primary_key = False
-
-        if name is None:
-            self._primary_key = None
-            return
-
-        self[name].stype = Stype.ID
-        self[name]._is_primary_key = True
-        self._primary_key = name
-
-    # Time column #############################################################
-
-    def has_time_column(self) -> bool:
-        r"""Returns ``True`` if this table has a time column; ``False``
-        otherwise.
-        """
-        return self._time_column is not None
-
-    @property
-    def time_column(self) -> Optional[Column]:
-        r"""The time column of this table.
-
-        The getter returns the time column of this table, or ``None`` if no
-        such time column is present.
-
-        The setter sets a column as a time column on this table, and raises a
-        :class:`ValueError` if the time column has a non-timestamp semantic
-        type or if the column name does not match a column in the data frame.
-        """
-        if not self.has_time_column():
-            return None
-        assert self._time_column is not None
-        return self[self._time_column]
-
-    @time_column.setter
-    def time_column(self, name: Optional[str]) -> None:
-        if name is not None and name == self._primary_key:
-            raise ValueError(f"Cannot specify column '{name}' as a time "
-                             f"column since it is already defined to be a "
-                             f"primary key")
-
-        if self.time_column is not None:
-            self.time_column._is_time_column = False
-
-        if name is None:
-            self._time_column = None
-            return
-
-        self[name].stype = Stype.timestamp
-        self[name]._is_time_column = True
-        self._time_column = name
-
-    # Metadata ################################################################
-
-    @property
-    def metadata(self) -> pd.DataFrame:
-        r"""Returns a :class:`pandas.DataFrame` object containing metadata
-        information about the columns in this table.
-
-        The returned dataframe has columns ``name``, ``dtype``, ``stype``,
-        ``is_primary_key``, and ``is_time_column``, which provide an aggregate
-        view of the properties of the columns of this table.
-
-        Example:
-            >>> import kumoai.experimental.rfm as rfm
-            >>> table = rfm.LocalTable(df=..., name=...).infer_metadata()
-            >>> table.metadata
-                name        dtype       stype    is_primary_key is_time_column
-            0   CustomerID  float64     ID       True            False
-        """
-        cols = self.columns
-
-        return pd.DataFrame({
-            'name':
-            pd.Series(dtype=str, data=[c.name for c in cols]),
-            'dtype':
-            pd.Series(dtype=str, data=[c.dtype for c in cols]),
-            'stype':
-            pd.Series(dtype=str, data=[c.stype for c in cols]),
-            'is_primary_key':
-            pd.Series(
-                dtype=bool,
-                data=[self._primary_key == c.name for c in cols],
-            ),
-            'is_time_column':
-            pd.Series(
-                dtype=bool,
-                data=[self._time_column == c.name for c in cols],
-            ),
-        })
-
-    def print_metadata(self) -> None:
-        r"""Prints the :meth:`~LocalTable.metadata` of the table."""
-        if in_notebook():
-            from IPython.display import Markdown, display
-            display(
-                Markdown(f"### 🏷️ Metadata of Table `{self.name}` "
-                         f"({len(self._data):,} rows)"))
-            df = self.metadata
-            try:
-                if hasattr(df.style, 'hide'):
-                    display(df.style.hide(axis='index'))  # pandas=2
-                else:
-                    display(df.style.hide_index())  # pandas<1.3
-            except ImportError:
-                print(df.to_string(index=False))  # missing jinja2
-        else:
-            print(f"🏷️ Metadata of Table '{self.name}' "
-                  f"({len(self._data):,} rows):")
-            print(self.metadata.to_string(index=False))
-
-    def infer_metadata(self, verbose: bool = True) -> Self:
-        r"""Infers metadata, *i.e.*, primary keys and time columns, in the
-        table.
-
-        Args:
-            verbose: Whether to print verbose output.
-        """
-        logs = []
-
-        # Try to detect primary key if not set:
-        if not self.has_primary_key():
-
-            def is_candidate(column: Column) -> bool:
-                if column.stype == Stype.ID:
-                    return True
-                if all(column.stype != Stype.ID for column in self.columns):
-                    if self.name == column.name:
-                        return True
-                    if (self.name.endswith('s')
-                            and self.name[:-1] == column.name):
-                        return True
-                return False
-
-            candidates = [
-                column.name for column in self.columns if is_candidate(column)
-            ]
-
-            if primary_key := utils.detect_primary_key(
-                    table_name=self.name,
-                    df=self._data,
-                    candidates=candidates,
-            ):
-                self.primary_key = primary_key
-                logs.append(f"primary key '{primary_key}'")
-
-        # Try to detect time column if not set:
-        if not self.has_time_column():
-            candidates = [
-                column.name for column in self.columns
-                if column.stype == Stype.timestamp
-            ]
-            if time_column := utils.detect_time_column(self._data, candidates):
-                self.time_column = time_column
-                logs.append(f"time column '{time_column}'")
-
-        if verbose and len(logs) > 0:
-            print(f"Detected {' and '.join(logs)} in table '{self.name}'")
-
-        return self
-
-    # Helpers #################################################################
-
-    def _to_api_table_definition(self) -> TableDefinition:
-        cols: List[ColumnDefinition] = []
-        for col in self.columns:
-            cols.append(ColumnDefinition(col.name, col.stype, col.dtype))
-        pkey = self._primary_key
-        time_col = self._time_column
-        source_table = UnavailableSourceTable(table=self.name)
-
-        return TableDefinition(
-            cols=cols,
-            source_table=source_table,
-            pkey=pkey,
-            time_col=time_col,
-        )
-
-    # Python builtins #########################################################
-
-    def __hash__(self) -> int:
-        return hash(tuple(self.columns + [self.primary_key, self.time_column]))
-
-    def __contains__(self, name: str) -> bool:
-        return self.has_column(name)
-
-    def __getitem__(self, name: str) -> Column:
-        return self.column(name)
-
-    def __delitem__(self, name: str) -> None:
-        self.remove_column(name)
-
-    def __repr__(self) -> str:
-        return (f'{self.__class__.__name__}(\n'
-                f'  name={self.name},\n'
-                f'  num_columns={len(self.columns)},\n'
-                f'  primary_key={self._primary_key},\n'
-                f'  time_column={self._time_column},\n'
-                f')')