code-sandboxes 0.0.2__py3-none-any.whl

code_sandboxes-0.0.2.dist-info/METADATA

@@ -0,0 +1,299 @@
+Metadata-Version: 2.4
+Name: code_sandboxes
+Version: 0.0.2
+Project-URL: Home, https://github.com/datalayer/code-sandboxes
+Author-email: Datalayer <info@datalayer.io>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2025, Datalayer
+        All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice, this
+           list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+License-File: LICENSE
+Keywords: AI,AI Agent,Code Sandboxes
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Provides-Extra: all
+Requires-Dist: datalayer-core; extra == 'all'
+Requires-Dist: docker>=6.0; extra == 'all'
+Provides-Extra: datalayer
+Requires-Dist: datalayer-core; extra == 'datalayer'
+Provides-Extra: docker
+Requires-Dist: docker>=6.0; extra == 'docker'
+Provides-Extra: lint
+Requires-Dist: mdformat-gfm>=0.3.5; extra == 'lint'
+Requires-Dist: mdformat>0.7; extra == 'lint'
+Requires-Dist: ruff; extra == 'lint'
+Provides-Extra: test
+Requires-Dist: ipykernel; extra == 'test'
+Requires-Dist: jupyter-server<3,>=1.6; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'test'
+Requires-Dist: pytest>=7.0; extra == 'test'
+Provides-Extra: typing
+Requires-Dist: mypy>=0.990; extra == 'typing'
+Description-Content-Type: text/markdown
+
+<!--
+  ~ Copyright (c) 2025-2026 Datalayer, Inc.
+  ~
+  ~ BSD 3-Clause License
+-->
+
+[![Datalayer](https://assets.datalayer.tech/datalayer-25.svg)](https://datalayer.io)
+
+[![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)
+
+# { } Code Sandboxes
+
+[![Github Actions Status](https://github.com/datalayer/code-sandboxes/workflows/Build/badge.svg)](https://github.com/datalayer/code-sandboxes/actions/workflows/build.yml)
+[![PyPI - Version](https://img.shields.io/pypi/v/code-sandboxes)](https://pypi.org/project/code-sandboxes)
+
+Code Sandboxes `code_sandboxes` is a Python package for safe, isolated environments where an AI system can write, run, and test code without affecting the real world or the user's device.
+
+This package provides a unified API for code execution with features like:
+
+- **Code Execution**: Execute Python code with streaming output and rich results
+- **Filesystem Operations**: Read, write, list, upload, and download files
+- **Command Execution**: Run shell commands with streaming support
+- **Context Management**: Maintain state across multiple executions
+- **Snapshots**: Save and restore sandbox state (Datalayer runtime)
+- **GPU Support**: Access GPU compute for ML workloads (Datalayer runtime)
+
+## Sandbox Variants
+
+Three variants are available:
+
+| Variant | Isolation | Use Case |
+|---------|-----------|----------|
+| `local-eval` | None (Python exec) | Development, testing |
+| `local-docker` | Container | Local isolated execution |
+| `datalayer-runtime` | Cloud VM | Production, GPU workloads |
+
+## Installation
+
+```bash
+# Basic installation
+pip install code-sandboxes
+
+# With Datalayer runtime support
+pip install code-sandboxes[datalayer]
+
+# With Docker support
+pip install code-sandboxes[docker]
+
+# All features
+pip install code-sandboxes[all]
+```
+
+## Quick Start
+
+### Simple Code Execution
+
+```python
+from code_sandboxes import Sandbox
+
+# Create a sandbox with timeout
+with Sandbox.create(variant="local-eval", timeout=60) as sandbox:
+    # Execute code
+    result = sandbox.run_code("x = 1 + 1")
+    result = sandbox.run_code("print(x)")  # prints 2
+    
+    # Access results
+    print(result.stdout)  # "2"
+```
+
+### Cloud Execution with GPU
+
+```python
+from code_sandboxes import Sandbox
+
+# Create a cloud sandbox with GPU
+with Sandbox.create(
+    variant="datalayer-runtime",
+    gpu="T4",
+    environment="python-gpu-env",
+    timeout=300,
+) as sandbox:
+    sandbox.run_code("import torch")
+    result = sandbox.run_code("print(torch.cuda.is_available())")
+```
+
+### Filesystem Operations
+
+```python
+with Sandbox.create() as sandbox:
+    # Write files
+    sandbox.files.write("/data/test.txt", "Hello World")
+    
+    # Read files
+    content = sandbox.files.read("/data/test.txt")
+    
+    # List directory
+    for f in sandbox.files.list("/data"):
+        print(f.name, f.size)
+    
+    # Upload/download
+    sandbox.files.upload("local_file.txt", "/remote/file.txt")
+    sandbox.files.download("/remote/file.txt", "downloaded.txt")
+```
+
+### Command Execution
+
+```python
+with Sandbox.create() as sandbox:
+    # Run a command and wait for completion
+    result = sandbox.commands.run("ls -la")
+    print(result.stdout)
+    
+    # Execute with streaming output
+    process = sandbox.commands.exec("python", "-c", "print('hello')")
+    for line in process.stdout:
+        print(line, end="")
+    
+    # Install system packages
+    sandbox.commands.install_system_packages(["curl", "wget"])
+```
+
+### Snapshots (Datalayer Runtime)
+
+```python
+with Sandbox.create(variant="datalayer-runtime") as sandbox:
+    # Set up environment
+    sandbox.install_packages(["pandas", "numpy"])
+    sandbox.run_code("import pandas as pd; df = pd.DataFrame({'a': [1,2,3]})")
+    
+    # Create snapshot
+    snapshot = sandbox.create_snapshot("my-setup")
+    print(f"Snapshot created: {snapshot.id}")
+
+# Later: restore from snapshot
+with Sandbox.create(variant="datalayer-runtime", snapshot_name="my-setup") as sandbox:
+    # State is restored
+    result = sandbox.run_code("print(df)")
+```
+
+### Streaming Output
+
+```python
+from code_sandboxes import Sandbox, OutputMessage
+
+def handle_stdout(msg: OutputMessage):
+    print(f"[stdout] {msg.line}")
+
+def handle_stderr(msg: OutputMessage):
+    print(f"[stderr] {msg.line}")
+
+with Sandbox.create() as sandbox:
+    result = sandbox.run_code(
+        "for i in range(5): print(f'Step {i}')",
+        on_stdout=handle_stdout,
+        on_stderr=handle_stderr,
+    )
+```
+
+## API Reference
+
+### Sandbox.create()
+
+Factory method to create sandboxes:
+
+```python
+sandbox = Sandbox.create(
+    variant="datalayer-runtime",  # Sandbox type
+    timeout=60,                   # Execution timeout (seconds)
+    environment="python-simple-env",  # Runtime environment
+    gpu="T4",                     # GPU type (T4, A100, H100, etc.)
+    cpu=2.0,                      # CPU cores
+    memory=4096,                  # Memory in MB
+    env={"MY_VAR": "value"},      # Environment variables
+    tags={"project": "demo"},     # Metadata tags
+)
+```
+
+### Execution Result
+
+```python
+result = sandbox.run_code("print('hello')")
+
+result.success    # bool: Whether execution succeeded
+result.stdout     # str: Standard output
+result.stderr     # str: Standard error
+result.text       # str: Main result text
+result.results    # list[Result]: Rich results (HTML, images, etc.)
+result.error      # ExecutionError: Error details if failed
+```
+
+### Core Methods
+
+| Method | Description |
+|--------|-------------|
+| `Sandbox.create()` | Create a new sandbox |
+| `Sandbox.from_id(id)` | Reconnect to an existing sandbox |
+| `Sandbox.list()` | List all sandboxes |
+| `sandbox.run_code(code)` | Execute Python code |
+| `sandbox.files.read(path)` | Read file contents |
+| `sandbox.files.write(path, content)` | Write file contents |
+| `sandbox.files.list(path)` | List directory contents |
+| `sandbox.commands.run(cmd)` | Run shell command |
+| `sandbox.commands.exec(*args)` | Execute with streaming output |
+| `sandbox.set_timeout(seconds)` | Update timeout |
+| `sandbox.create_snapshot(name)` | Save sandbox state |
+| `sandbox.terminate()` / `sandbox.kill()` | Stop sandbox |
+
+## Configuration
+
+### Environment Variables
+
+- `DATALAYER_API_KEY`: API key for Datalayer runtime authentication
+
+### SandboxConfig
+
+```python
+from code_sandboxes import SandboxConfig
+
+config = SandboxConfig(
+    timeout=30.0,              # Default execution timeout
+    environment="python-simple-env",
+    memory_limit=4 * 1024**3,  # 4GB
+    cpu_limit=2.0,
+    gpu="T4",
+    working_dir="/workspace",
+    env_vars={"DEBUG": "1"},
+    max_lifetime=3600,         # 1 hour
+)
+
+sandbox = Sandbox.create(config=config)
+```
+
+## License
+
+Copyright (c) 2025-2026 Datalayer, Inc.
+
+BSD 3-Clause License

code_sandboxes-0.0.2.dist-info/RECORD

@@ -0,0 +1,15 @@
+code_sandboxes/__init__.py,sha256=EOTezFV0i_LjMNPQToEXBIxMjTvt81GHcec96VF5CaM,3643
+code_sandboxes/__version__.py,sha256=6xxbUamNY9MkCJdDf9ToVcvXsaNhGLQeJgGS_M1Vwks,71
+code_sandboxes/base.py,sha256=VWim-WTwga_dLZHnezUAoR59BGdHprZz-ygwVsqtLm8,19116
+code_sandboxes/commands.py,sha256=AHXLMv8aCDZjs_meI8PSptLo_u9QBZlwfziUP35LvVc,12278
+code_sandboxes/exceptions.py,sha256=ztF2d5IdEwX0E974_8mWf4iVrII8rZJewolfFV_6sLo,3130
+code_sandboxes/filesystem.py,sha256=e2aeyg471b9Xv2AXhabuUEEATy_1_sInNorGmhPv6rU,12931
+code_sandboxes/models.py,sha256=dZBk_AztlHTGR9xsilzjD0guEFvdbxCMduUTdrkhJlA,11542
+code_sandboxes/local/__init__.py,sha256=ilanyZR7xhuPyUPHrnjwxRAZiiGFIl9SdS0fYthXFYo,181
+code_sandboxes/local/eval_sandbox.py,sha256=C5yzBT2Q1URGMhvJM85yyAISfrnjUDwP_flRGkgGhwo,10157
+code_sandboxes/remote/__init__.py,sha256=BQzFMhNuXjOnyUNTUmE5dxoq2xVAiw6YsHKtLBXjT-c,187
+code_sandboxes/remote/datalayer_sandbox.py,sha256=7EdvBgbMXx5nyBj3d8ndRoIOirGKf8yH_2YLRM5_76I,20672
+code_sandboxes-0.0.2.dist-info/METADATA,sha256=XDn-nsCDPNdW1R4YUuUC6FvEqePj6eZD8QUrc5HbrKw,9804
+code_sandboxes-0.0.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+code_sandboxes-0.0.2.dist-info/licenses/LICENSE,sha256=kW62dan-1HEplL1Cmfooudf8dRqCPGQZGD6APtrlZa8,1516
+code_sandboxes-0.0.2.dist-info/RECORD,,

code_sandboxes-0.0.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

code_sandboxes-0.0.2.dist-info/licenses/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Datalayer
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.