Merge pull request #31 from bespokelabsai/codex/shared-bespokelabs-namespace

Fix shared namespace packaging for Sandbox

Author: mahesh-bespoke

README.md

@@ -44,6 +44,26 @@ The only required core dependency is Pydantic; provider SDKs are optional.
 pip install bespokelabs-sandbox
 ```
 
+Sandbox can share an environment with Curator:
+
+```bash
+python -m pip install bespokelabs-curator bespokelabs-sandbox
+```
+
+```python
+from bespokelabs import curator, sandbox
+```
+
+Each distribution owns its own subpackage. Sandbox installs only
+`bespokelabs/sandbox`; it does not install `bespokelabs/__init__.py`.
+The separate `bespokelabs` distribution is not needed for these imports.
+The Nimble SDK uses the `bespokelabs-nimble` distribution.
+
+For upgrades from older releases that shared the root file, use a fresh virtual
+environment with namespace-compatible versions of all installed Bespoke packages.
+Use `python -m pip` with the interpreter used by your app or notebook, and check
+for old editable checkouts or a local `bespokelabs.py` if imports fail.
+
 With a specific backend:
 
 ```bash

pyproject.toml

@@ -55,6 +55,8 @@ bespokelabs-sandbox-api = "bespokelabs.sandbox.control_plane.cli:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]
+include = ["bespokelabs.sandbox*"]
+namespaces = true
 
 [tool.setuptools.package-data]
 "bespokelabs.sandbox" = ["pricing.json"]

src/bespokelabs/__init__.py

@@ -0,0 +1,37 @@
+"""Check that a source install can share its namespace with another project."""
+
+import subprocess
+import sys
+from pathlib import Path
+
+import pytest
+
+
+@pytest.mark.parametrize("source_first", [True, False])
+def test_separate_namespace_portions(tmp_path: Path, source_first: bool):
+    source = Path(__file__).resolve().parents[1] / "src"
+    sibling = tmp_path / "other-project"
+    package = sibling / "bespokelabs" / "namespace_probe"
+    package.mkdir(parents=True)
+    (package / "__init__.py").write_text("VALUE = 42\n")
+    paths = [str(source), str(sibling)]
+    if not source_first:
+        paths.reverse()
+    expected = str(source / "bespokelabs/sandbox/__init__.py")
+    code = f"""
+import sys
+from importlib.util import find_spec
+sys.path[:0] = {paths!r}
+from bespokelabs import namespace_probe
+import bespokelabs
+assert namespace_probe.VALUE == 42
+assert bespokelabs.__file__ is None
+assert find_spec('bespokelabs.sandbox').origin == {expected!r}
+"""
+    # Disable site-packages so installed siblings cannot mask the source layout.
+    subprocess.run(
+        [sys.executable, "-I", "-S", "-c", code],
+        check=True,
+        capture_output=True,
+        text=True,
+    )