SDK v2 - Add beta submodule and update Sandbox list

.changeset/angry-ties-carry.md

@@ -0,0 +1,8 @@
+---
+'@e2b/python-sdk': major
+'e2b': major
+'@e2b/cli': major
+---
+
+- Add beta module (pause and resume)
+- Update list method to allow list paused sandboxes

.github/workflows/generated_files.yml

@@ -48,7 +48,7 @@ jobs:
           cache-to: type=gha,mode=max
 
       - name: Run codegen
-        run: make codegen
+        run: CODEGEN_IMAGE=codegen-env:latest make codegen
 
       - name: Check for uncommitted changes
         run: |

Makefile

@@ -1,7 +1,10 @@
 .PHONY: codegen
 codegen:
 	@echo "Generating SDK code from openapi and envd spec"
-	@docker run -v "$$(pwd):/workspace" $$(docker build -q -t codegen-env . -f codegen.Dockerfile)
+	@CODEGEN_IMAGE=$${CODEGEN_IMAGE:-$$(docker build -q -t codegen-env . -f codegen.Dockerfile)} ; \
+	echo "Using codegen image: $$CODEGEN_IMAGE" \
+	&& docker run -v $$PWD:/workspace $$CODEGEN_IMAGE make generate
+
 generate: generate-js generate-python
 
 generate-js:

README.md

@@ -64,7 +64,7 @@ Python
 ```py
 from e2b_code_interpreter import Sandbox
 
-with Sandbox() as sandbox:
+with Sandbox.create() as sandbox:
     sandbox.run_code("x = 1")
     execution = sandbox.run_code("x+=1; x")
     print(execution.text)  # outputs 2

apps/web/src/app/(docs)/docs/api-key/page.mdx

@@ -16,7 +16,7 @@ const sandbox = await Sandbox.create({ apiKey: 'YOUR_API_KEY' })
 ```python {{ language: 'python' }}
 from e2b_code_interpreter import Sandbox
 
-sbx = Sandbox(api_key="YOUR_API_KEY")
+sbx = Sandbox.create(api_key="YOUR_API_KEY")
 ```
 </CodeGroup>
 

apps/web/src/app/(docs)/docs/code-interpreting/analyze-data-with-ai/page.mdx

@@ -82,7 +82,7 @@ load_dotenv()
 from e2b_code_interpreter import Sandbox
 
 # Create sandbox
-sbx = Sandbox()
+sbx = Sandbox.create()
 
 # Upload the dataset to the sandbox
 dataset_path_in_sandbox = ""
@@ -453,7 +453,7 @@ from e2b_code_interpreter import Sandbox
 from anthropic import Anthropic
 
 # Create sandbox
-sbx = Sandbox()
+sbx = Sandbox.create()
 
 # Upload the dataset to the sandbox
 with open("../dataset.csv", "rb") as f:

apps/web/src/app/(docs)/docs/code-interpreting/create-charts-visualizations/interactive-charts/page.mdx

@@ -68,7 +68,7 @@ plt.tight_layout()
 plt.show()
 """
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 execution = sandbox.run_code(code)
 chart = execution.results[0].chart
 

apps/web/src/app/(docs)/docs/code-interpreting/create-charts-visualizations/static-charts/page.mdx

@@ -47,7 +47,7 @@ plt.ylabel('some numbers')
 plt.show()
 """
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 # Run the code inside the sandbox
 execution = sandbox.run_code(code_to_run)

apps/web/src/app/(docs)/docs/code-interpreting/streaming/page.mdx

@@ -40,7 +40,7 @@ code_to_run = """
   print("This goes last")
 """
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 sandbox.run_code(
   code_to_run,
   # Use `on_error` to handle runtime code errors
@@ -131,7 +131,7 @@ plt.title('Values by Category')
 plt.show()
 """
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 sandbox.run_code(
   code_to_run,
   on_result=lambda result: print('result:', result), # $HighlightLine

apps/web/src/app/(docs)/docs/code-interpreting/supported-languages/bash/page.mdx

@@ -12,7 +12,7 @@ console.log(execution)
 ```python
 from e2b_code_interpreter import Sandbox
 
-sbx = Sandbox()
+sbx = Sandbox.create()
 execution = sbx.run_code("echo 'Hello, world!'", language="bash")
 print(execution)
 ```

apps/web/src/app/(docs)/docs/code-interpreting/supported-languages/java/page.mdx

@@ -12,7 +12,7 @@ console.log(execution)
 ```python
 from e2b_code_interpreter import Sandbox
 
-sbx = Sandbox()
+sbx = Sandbox.create()
 execution = sbx.run_code('System.out.println("Hello, world!");', language="java")
 print(execution)
 ```

apps/web/src/app/(docs)/docs/code-interpreting/supported-languages/javascript/page.mdx

@@ -46,7 +46,7 @@ console.log(execution);
 from e2b_code_interpreter import Sandbox
 
 # Create a new sandbox
-sbx = Sandbox()
+sbx = Sandbox.create()
 
 # Install the axios package
 sbx.commands.run("npm install axios")

apps/web/src/app/(docs)/docs/code-interpreting/supported-languages/python/page.mdx

@@ -11,7 +11,7 @@ console.log(execution)
 ```python
 from e2b_code_interpreter import Sandbox
 
-sbx = Sandbox()
+sbx = Sandbox.create()
 execution = sbx.run_code('print("Hello, world!")')
 print(execution)
 ```

apps/web/src/app/(docs)/docs/code-interpreting/supported-languages/r/page.mdx

@@ -12,7 +12,7 @@ console.log(execution)
 ```python
 from e2b_code_interpreter import Sandbox
 
-sbx = Sandbox()
+sbx = Sandbox.create()
 execution = sbx.run_code('print("Hello, world!")', language="r")
 print(execution)
 ```

apps/web/src/app/(docs)/docs/commands/background/page.mdx

@@ -23,7 +23,7 @@ await command.kill()
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 # Start the command in the background
 command = sandbox.commands.run('echo hello; sleep 10; echo world', background=True)

apps/web/src/app/(docs)/docs/commands/page.mdx

@@ -13,7 +13,7 @@ console.log(result)
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 result = sandbox.commands.run('ls -l')
 print(result)

apps/web/src/app/(docs)/docs/commands/streaming/page.mdx

@@ -21,7 +21,7 @@ console.log(result)
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 result = sandbox.commands.run('echo hello; sleep 1; echo world', on_stdout=lambda data: print(data), on_stderr=lambda data: print(data))
 print(result)

apps/web/src/app/(docs)/docs/filesystem/download/page.mdx

@@ -17,7 +17,7 @@ fs.writeFileSync('/local/path', content)
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 # Read file from sandbox
 content = sandbox.files.read('/path/in/sandbox')
@@ -58,7 +58,7 @@ const content = await res.text()
 from e2b import Sandbox
 
 # Start a secured sandbox (all operations must be authorized by default)
-sandbox = Sandbox(timeout=12_000, secure=True)
+sandbox = Sandbox.create(timeout=12_000, secure=True)
 
 # Create a pre-signed URL for file download with a 10 second expiration
 # The user only has to visit the URL to download the file, this also works in a browser.

apps/web/src/app/(docs)/docs/filesystem/info/page.mdx

@@ -33,7 +33,7 @@ console.log(info)
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 # Create a new file
 sandbox.files.write('test_file', 'Hello, world!')
@@ -88,7 +88,7 @@ console.log(info)
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 # Create a new directory
 sandbox.files.make_dir('test_dir')

apps/web/src/app/(docs)/docs/filesystem/read-write/page.mdx

@@ -13,7 +13,7 @@ const fileContent = await sandbox.files.read('/path/to/file')
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 file_content = sandbox.files.read('/path/to/file')
 ```
 </CodeGroup>
@@ -32,7 +32,7 @@ await sandbox.files.write('/path/to/file', 'file content')
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 await sandbox.files.write('/path/to/file', 'file content')
 ```
@@ -55,7 +55,7 @@ await sandbox.files.write([
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 await sandbox.files.write([
     { "path": "/path/to/a", "data": "file content" },

apps/web/src/app/(docs)/docs/filesystem/upload/page.mdx

@@ -19,7 +19,7 @@ await sandbox.files.write('/path/in/sandbox', content)
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 # Read file from local filesystem
 with open("path/to/local/file", "rb") as file:
@@ -64,7 +64,7 @@ from e2b import Sandbox
 import requests
 
 # Start a secured sandbox (all operations must be authorized by default)
-sandbox = Sandbox(timeout=12_000, secure=True)
+sandbox = Sandbox.create(timeout=12_000, secure=True)
 
 # Create a pre-signed URL for file upload with a 10 second expiration
 signed_url = sbx.upload_url(path="demo.txt", user="user", use_signature_expiration=10_000)
@@ -125,7 +125,7 @@ await sandbox.files.write(files)
 import os
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 
 def read_directory_files(directory_path):
     files = []

apps/web/src/app/(docs)/docs/filesystem/watch/page.mdx

@@ -28,7 +28,7 @@ await sandbox.files.write(`${dirname}/my-file`, 'hello')
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 dirname = '/home/user'
 
 # Watch directory for changes
@@ -77,7 +77,7 @@ await sandbox.files.write(`${dirname}/my-folder/my-file`, 'hello') // $Highlight
 ```python
 from e2b_code_interpreter import Sandbox
 
-sandbox = Sandbox()
+sandbox = Sandbox.create()
 dirname = '/home/user'
 
 # Watch directory for changes