cleanup: remove deprecated @cocoindex.main_fn (#695)

Author: badmonster0

docs/docs/core/cli.mdx

@@ -47,12 +47,6 @@ CocoIndex CLI supports the following global options:
 * `--version`: Show the CocoIndex version and exit.
 * `--help`: Show the main help message and exit.
 
-:::caution Deprecated Usage
-
-The old method of invoking the CLI using `python main.py cocoindex ...` via the `@cocoindex.main_fn()` decorator is now deprecated. Please remove `@cocoindex.main_fn()` from your scripts and use the standalone cocoindex command as described.
-
-:::
-
 ## Subcommands
 
 The following subcommands are available:

python/cocoindex/__init__.py

@@ -12,7 +12,7 @@
 from .flow import EvaluateAndDumpOptions, GeneratedField
 from .flow import FlowLiveUpdater, FlowLiveUpdaterOptions
 from .flow import update_all_flows_async, setup_all_flows, drop_all_flows
-from .lib import init, start_server, stop, main_fn
+from .lib import init, start_server, stop
 from .llm import LlmSpec, LlmApiType
 from .index import VectorSimilarityMetric, VectorIndexDef, IndexOptions
 from .setting import DatabaseConnectionSpec, Settings, ServerSettings
@@ -59,7 +59,6 @@
     "init",
     "start_server",
     "stop",
-    "main_fn",
     # LLM
     "LlmSpec",
     "LlmApiType",

python/cocoindex/lib.py

@@ -30,46 +30,3 @@ def start_server(settings: setting.ServerSettings) -> None:
 def stop() -> None:
     """Stop the cocoindex library."""
     _engine.stop()
-
-
-def main_fn(
-    settings: Any | None = None,
-    cocoindex_cmd: str | None = None,
-) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
-    """
-    DEPRECATED: The @cocoindex.main_fn() decorator is obsolete and has no effect.
-    It will be removed in a future version, which will cause an AttributeError.
-
-    Please remove this decorator from your code and use the standalone 'cocoindex' CLI.
-    See the updated CLI usage examples in the warning message.
-    """
-    warnings.warn(
-        "\n\n"
-        "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n"
-        "CRITICAL DEPRECATION NOTICE from CocoIndex:\n"
-        "The @cocoindex.main_fn() decorator in your script is DEPRECATED and IGNORED.\n"
-        "It provides NO functionality and will be REMOVED entirely in a future version.\n"
-        "If not removed, your script will FAIL with an AttributeError in the future.\n\n"
-        "ACTION REQUIRED: Please REMOVE @cocoindex.main_fn() from your Python script.\n\n"
-        "To use CocoIndex, invoke the standalone 'cocoindex' CLI."
-        " Examples of new CLI usage:\n\n"
-        "  To list flows from 'main.py' (previously 'python main.py cocoindex ls'):\n"
-        "    cocoindex ls main.py\n\n"
-        "  To list all persisted flows (previously 'python main.py cocoindex ls --all'):\n"
-        "    cocoindex ls\n\n"
-        "  To show 'MyFlow' defined in 'main.py' (previously 'python main.py cocoindex show MyFlow'):\n"
-        "    cocoindex show main.py:MyFlow\n\n"
-        "  To update all flows in 'my_package.flows_module':\n"
-        "    cocoindex update my_package.flows_module\n\n"
-        "  To update 'SpecificFlow' in 'my_package.flows_module':\n"
-        "    cocoindex update my_package.flows_module:SpecificFlow\n\n"
-        "See cocoindex <command> --help for more details.\n"
-        "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n",
-        DeprecationWarning,
-        stacklevel=2,
-    )
-
-    def _main_wrapper(fn: Callable[..., Any]) -> Callable[..., Any]:
-        return fn
-
-    return _main_wrapper