cmpnd 0.86.1__tar.gz → 0.87.0__tar.gz

{cmpnd-0.86.1 → cmpnd-0.87.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cmpnd
-Version: 0.86.1
+Version: 0.87.0
 Summary: DSPy observability and deployment SDK for cmpnd
 Project-URL: Homepage, https://cmpnd.ai
 Author-email: cmpnd <hello@cmpnd.ai>
@@ -19,7 +19,6 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
 Requires-Dist: dspy>=3.3.0
 Requires-Dist: httpx>=0.27.0
-Requires-Dist: ipython>=8.20
 Requires-Dist: pydantic>=2.0
 Requires-Dist: typing-extensions>=4.1.0
 Requires-Dist: xxhash>=3.0.0
@@ -28,6 +27,7 @@ Requires-Dist: basedpyright>=1.39; extra == 'dev'
 Requires-Dist: boto3>=1.34; extra == 'dev'
 Requires-Dist: gepa; extra == 'dev'
 Requires-Dist: hypothesis>=6.100; extra == 'dev'
+Requires-Dist: ipython>=8.20; extra == 'dev'
 Requires-Dist: jsonschema>=4.0; extra == 'dev'
 Requires-Dist: litellm; extra == 'dev'
 Requires-Dist: litellm<1.102; (python_version >= '3.15') and extra == 'dev'
@@ -47,6 +47,8 @@ Requires-Dist: pillow>=10.0; extra == 'images'
 Provides-Extra: mcp
 Requires-Dist: dspy>=3.3.1; extra == 'mcp'
 Requires-Dist: mcp>=1.9; extra == 'mcp'
+Provides-Extra: shell
+Requires-Dist: ipython>=8.20; extra == 'shell'
 Description-Content-Type: text/markdown
 
 # cmpnd
@@ -61,6 +63,10 @@ deployments and optimization runs under that name.
 uv add cmpnd      # or: pip install cmpnd
 ```
 
+The interactive `cmpnd` shell uses IPython when you install the `shell` extra:
+`uv add 'cmpnd[shell]'` or `pip install 'cmpnd[shell]'`. The plain install
+leaves IPython out, and the shell then runs on the standard Python prompt.
+
 ## Authentication
 
 The `cmpnd` library works with the cmpnd service at

{cmpnd-0.86.1 → cmpnd-0.87.0}/README.md

@@ -10,6 +10,10 @@ deployments and optimization runs under that name.
 uv add cmpnd      # or: pip install cmpnd
 ```
 
+The interactive `cmpnd` shell uses IPython when you install the `shell` extra:
+`uv add 'cmpnd[shell]'` or `pip install 'cmpnd[shell]'`. The plain install
+leaves IPython out, and the shell then runs on the standard Python prompt.
+
 ## Authentication
 
 The `cmpnd` library works with the cmpnd service at

{cmpnd-0.86.1 → cmpnd-0.87.0}/cmpnd/cli/shell.py

@@ -648,28 +648,37 @@ def _enable_readline(namespace: dict[str, Any]) -> None:
     atexit.register(_save_history)
 
 
+_NO_IPYTHON_HINT = "IPython is not installed. For completion and history, run: pip install 'cmpnd[shell]'\n"
+
+
 def _launch_repl(namespace: dict[str, Any], banner: str) -> None:
-    """Prefer IPython (Jedi completion, history, multi-line); fall back to stdlib."""
+    """Prefer IPython (Jedi completion, history, multi-line); fall back to stdlib.
+
+    IPython ships in the optional ``cmpnd[shell]`` extra. Without it, the shell
+    prints one line that names the extra and runs on ``code.interact``.
+    """
     try:
-        from IPython import start_ipython
-        from traitlets.config import Config
+        import IPython
+        import traitlets.config
     except ImportError:
         import code
 
+        sys.stderr.write(_NO_IPYTHON_HINT)
+        sys.stderr.flush()
         _enable_readline(namespace)
         sys.stdout.write(banner)
         sys.stdout.flush()
         code.interact(banner="", local=namespace, exitmsg="")
         return
 
-    cfg = Config()
+    cfg = traitlets.config.Config()
     cfg.TerminalInteractiveShell.banner1 = banner
     cfg.TerminalInteractiveShell.banner2 = ""
     cfg.TerminalInteractiveShell.confirm_exit = False
     # IPython 9.x appends a random "Tip: use %timeit ..." after banner2.
     # Suppress — our own banner already tells users what to type.
     cfg.TerminalInteractiveShell.enable_tip = False
-    start_ipython(argv=[], user_ns=namespace, config=cfg)
+    IPython.start_ipython(argv=[], user_ns=namespace, config=cfg)
 
 
 def launch(api_key: str | None = None, endpoint: str | None = None) -> None:

{cmpnd-0.86.1 → cmpnd-0.87.0}/docs/cli.md

@@ -6,7 +6,11 @@ runs and inspects DSPy programs on the platform. Every command reads
 `--api-key` and `--endpoint`. `cmpnd auth me` prints the resolved identity.
 
 Bare `cmpnd`, with no subcommand, opens an interactive Python shell with the
-platform verbs loaded (`cmpnd.cli.shell`).
+platform verbs loaded (`cmpnd.cli.shell`). The shell runs on IPython when the
+`cmpnd[shell]` extra is installed (`pip install 'cmpnd[shell]'`), which adds
+Jedi completion, multi-line input and history search. Without the extra, the
+shell prints one line that names it and runs on the standard library's
+`code.interact` with readline completion.
 
 ## Program names
 

{cmpnd-0.86.1 → cmpnd-0.87.0}/pyproject.toml

@@ -5,7 +5,7 @@ name = "cmpnd"
 # it's new) — no git tags. Bump with `uv version --bump {minor,patch}` or by
 # hand. Runtime `cmpnd.__version__` reads installed metadata, so it tracks
 # this automatically. See docs/plans/2026-07-02-sdk-pypi-tag-free-publish.md.
-version = "0.86.1"
+version = "0.87.0"
 description = "DSPy observability and deployment SDK for cmpnd"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -45,10 +45,6 @@ dependencies = [
     # basis; the C module is an order of magnitude faster and every ordinary
     # install should have it.
     "xxhash>=3.0.0",
-    # Powers the interactive `cmpnd` shell (Jedi completion, multi-line,
-    # history search, syntax highlighting). No upper cap. The shell falls back
-    # to stdlib `code.interact` + rlcompleter if IPython somehow can't import.
-    "ipython>=8.20",
 ]
 
 [project.optional-dependencies]
@@ -59,6 +55,14 @@ dependencies = [
 images = [
     "pillow>=10.0",
 ]
+# The interactive `cmpnd` shell's IPython front end: Jedi completion, multi-line
+# input, history search and syntax highlighting. Optional, because IPython and its
+# dependency tree would otherwise land in every environment that only traces or
+# deploys programs. Without it, the shell runs on stdlib `code.interact` with
+# rlcompleter and prints one line that names this extra. No upper cap.
+shell = [
+    "ipython>=8.20",
+]
 # The MCP client library, needed only by `cmpnd.mcp_tools` when it connects to a tool
 # server from a notebook. Optional and lazily imported: it pulls a transport stack that
 # an SDK used purely for tracing, deploying and optimizing never touches, and its
@@ -110,6 +114,9 @@ dev = [
     # Exercises the image-thumbnail path (the `images` extra) so the positive
     # branch is covered in CI, not just the Pillow-absent fallback.
     "pillow>=10.0",
+    # Exercises the shell's IPython front end (the `shell` extra) so both REPL
+    # branches are covered in CI.
+    "ipython>=8.20",
     # The metadata validator the release path runs, brought in-tree so sdk-lint
     # can check a freshly built wheel + sdist BEFORE release day. Floor is the
     # first twine whose `packaging` understands `Metadata-Version: 2.5`, which

{cmpnd-0.86.1 → cmpnd-0.87.0}/tests/test_cli/test_shell.py

@@ -708,7 +708,21 @@ class TestDeployHelper:
 class TestReplFallback:
     def test_falls_back_when_ipython_missing(self):
         with mock.patch.dict("sys.modules", {"IPython": None}):
-            with mock.patch("code.interact") as interact:
+            with mock.patch("code.interact", autospec=True) as interact:
                 shell._launch_repl({"x": 1}, "BANNER\n")
         interact.assert_called_once()
         assert interact.call_args.kwargs["local"] == {"x": 1}
+
+    def test_fallback_names_the_shell_extra(self, capsys):
+        with mock.patch.dict("sys.modules", {"IPython": None}):
+            with mock.patch("code.interact", autospec=True):
+                shell._launch_repl({}, "BANNER\n")
+        err = capsys.readouterr().err
+        assert err.count("\n") == 1
+        assert "pip install 'cmpnd[shell]'" in err
+
+    def test_ipython_prints_no_fallback_line(self, capsys):
+        with mock.patch("IPython.start_ipython", autospec=True) as start:
+            shell._launch_repl({}, "BANNER\n")
+        start.assert_called_once()
+        assert "cmpnd[shell]" not in capsys.readouterr().err

{cmpnd-0.86.1 → cmpnd-0.87.0}/uv.lock

@@ -505,7 +505,7 @@ wheels = [
 
 [[package]]
 name = "cmpnd"
-version = "0.86.1"
+version = "0.87.0"
 source = { editable = "." }
 default-groups = ["dspy-3-4-1"]
 dependencies = [
@@ -514,7 +514,6 @@ dependencies = [
     { name = "dspy", version = "3.4.0", source = { registry = "https://pypi.org/simple" }, marker = "extra == 'group-5-cmpnd-dspy-3-4-0' or (extra == 'extra-5-cmpnd-mcp' and extra == 'group-5-cmpnd-dspy-3-3-0') or (extra == 'group-5-cmpnd-dspy-3-3-0' and extra == 'group-5-cmpnd-dspy-3-3-1') or (extra == 'group-5-cmpnd-dspy-3-3-0' and extra == 'group-5-cmpnd-dspy-3-4-1') or (extra == 'group-5-cmpnd-dspy-3-3-1' and extra == 'group-5-cmpnd-dspy-3-4-1')" },
     { name = "dspy", version = "3.4.1", source = { registry = "https://pypi.org/simple" }, marker = "extra == 'group-5-cmpnd-dspy-3-4-1' or (extra == 'group-5-cmpnd-dspy-3-3-0' and extra == 'group-5-cmpnd-dspy-3-3-1') or (extra == 'group-5-cmpnd-dspy-3-3-0' and extra == 'group-5-cmpnd-dspy-3-4-0') or (extra == 'group-5-cmpnd-dspy-3-3-1' and extra == 'group-5-cmpnd-dspy-3-4-0') or (extra == 'extra-5-cmpnd-mcp' and extra != 'group-5-cmpnd-dspy-3-3-1' and extra != 'group-5-cmpnd-dspy-3-4-0') or (extra != 'group-5-cmpnd-dspy-3-3-0' and extra != 'group-5-cmpnd-dspy-3-3-1' and extra != 'group-5-cmpnd-dspy-3-4-0')" },
     { name = "httpx" },
-    { name = "ipython" },
     { name = "pydantic" },
     { name = "typing-extensions" },
     { name = "xxhash" },
@@ -527,6 +526,7 @@ dev = [
     { name = "gepa", version = "0.1.1", source = { registry = "https://pypi.org/simple" }, marker = "extra == 'group-5-cmpnd-dspy-3-3-0' or (extra == 'group-5-cmpnd-dspy-3-3-1' and extra == 'group-5-cmpnd-dspy-3-4-0') or (extra == 'group-5-cmpnd-dspy-3-3-1' and extra == 'group-5-cmpnd-dspy-3-4-1') or (extra == 'group-5-cmpnd-dspy-3-4-0' and extra == 'group-5-cmpnd-dspy-3-4-1')" },
     { name = "gepa", version = "0.1.4", source = { registry = "https://pypi.org/simple" }, marker = "extra == 'extra-5-cmpnd-mcp' or extra != 'group-5-cmpnd-dspy-3-3-0' or extra == 'group-5-cmpnd-dspy-3-3-1' or extra == 'group-5-cmpnd-dspy-3-4-0' or extra == 'group-5-cmpnd-dspy-3-4-1'" },
     { name = "hypothesis" },
+    { name = "ipython" },
     { name = "jsonschema" },
     { name = "litellm" },
     { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.12'" },
@@ -552,6 +552,9 @@ mcp = [
     { name = "dspy", version = "3.4.1", source = { registry = "https://pypi.org/simple" }, marker = "extra == 'group-5-cmpnd-dspy-3-4-1' or (extra == 'group-5-cmpnd-dspy-3-3-0' and extra == 'group-5-cmpnd-dspy-3-3-1') or (extra == 'group-5-cmpnd-dspy-3-3-0' and extra == 'group-5-cmpnd-dspy-3-4-0') or (extra == 'group-5-cmpnd-dspy-3-3-1' and extra == 'group-5-cmpnd-dspy-3-4-0') or (extra == 'extra-5-cmpnd-mcp' and extra != 'group-5-cmpnd-dspy-3-3-1' and extra != 'group-5-cmpnd-dspy-3-4-0') or (extra != 'group-5-cmpnd-dspy-3-3-0' and extra != 'group-5-cmpnd-dspy-3-3-1' and extra != 'group-5-cmpnd-dspy-3-4-0')" },
     { name = "mcp" },
 ]
+shell = [
+    { name = "ipython" },
+]
 
 [package.dev-dependencies]
 dspy-3-3-0 = [
@@ -577,7 +580,8 @@ requires-dist = [
     { name = "gepa", marker = "extra == 'dev'" },
     { name = "httpx", specifier = ">=0.27.0" },
     { name = "hypothesis", marker = "extra == 'dev'", specifier = ">=6.100" },
-    { name = "ipython", specifier = ">=8.20" },
+    { name = "ipython", marker = "extra == 'dev'", specifier = ">=8.20" },
+    { name = "ipython", marker = "extra == 'shell'", specifier = ">=8.20" },
     { name = "jsonschema", marker = "extra == 'dev'", specifier = ">=4.0" },
     { name = "litellm", marker = "python_full_version >= '3.15' and extra == 'dev'", specifier = "<1.102" },
     { name = "litellm", marker = "extra == 'dev'" },
@@ -596,7 +600,7 @@ requires-dist = [
     { name = "typing-extensions", specifier = ">=4.1.0" },
     { name = "xxhash", specifier = ">=3.0.0" },
 ]
-provides-extras = ["images", "mcp", "dev", "fake-provider"]
+provides-extras = ["images", "shell", "mcp", "dev", "fake-provider"]
 
 [package.metadata.requires-dev]
 dspy-3-3-0 = [{ name = "dspy", specifier = "==3.3.0" }]