boxlite 0.2.0.dev0__cp310-cp310-macosx_14_0_arm64.whl → 0.5.6__cp310-cp310-macosx_14_0_arm64.whl

boxlite/__init__.py

@@ -4,9 +4,7 @@ BoxLite - Lightweight, secure containerization for any environment.
 Following SQLite philosophy: "BoxLite" for branding, "boxlite" for code APIs.
 """
 
-import os
 import warnings
-from pathlib import Path
 
 # Import core Rust API
 try:
@@ -19,6 +17,7 @@ try:
         ExecStdout,
         ExecStderr,
         BoxInfo,
+        BoxStateInfo,
         RuntimeMetrics,
         BoxMetrics,
     )
@@ -33,6 +32,7 @@ try:
         "ExecStdout",
         "ExecStderr",
         "BoxInfo",
+        "BoxStateInfo",
         "RuntimeMetrics",
         "BoxMetrics",
     ]
@@ -40,52 +40,83 @@ except ImportError as e:
     warnings.warn(f"BoxLite native extension not available: {e}", ImportWarning)
     __all__ = []
 
-# Import Python convenience wrappers
+# Import Python convenience wrappers (re-exported via __all__)
 try:
-    from .simplebox import SimpleBox
-    from .exec import ExecResult
-    from .codebox import CodeBox
-    from .errors import BoxliteError, ExecError, TimeoutError, ParseError
-
-    __all__.extend([
-        # Python convenience wrappers
-        "SimpleBox",
-        "CodeBox",
-        "ExecResult",
-        # Error types
-        "BoxliteError",
-        "ExecError",
-        "TimeoutError",
-        "ParseError",
-    ])
+    from .simplebox import SimpleBox  # noqa: F401
+    from .exec import ExecResult  # noqa: F401
+    from .codebox import CodeBox  # noqa: F401
+    from .errors import BoxliteError, ExecError, TimeoutError, ParseError  # noqa: F401
+
+    __all__.extend(
+        [
+            # Python convenience wrappers
+            "SimpleBox",
+            "CodeBox",
+            "ExecResult",
+            # Error types
+            "BoxliteError",
+            "ExecError",
+            "TimeoutError",
+            "ParseError",
+        ]
+    )
 except ImportError:
     pass
 
-# Specialized containers
+# Specialized containers (re-exported via __all__)
 try:
-    from .browserbox import BrowserBox, BrowserBoxOptions
+    from .browserbox import BrowserBox, BrowserBoxOptions  # noqa: F401
 
     __all__.extend(["BrowserBox", "BrowserBoxOptions"])
 except ImportError:
     pass
 
 try:
-    from .computerbox import ComputerBox
+    from .computerbox import ComputerBox  # noqa: F401
 
     __all__.extend(["ComputerBox"])
 except ImportError:
     pass
 
 try:
-    from .interactivebox import InteractiveBox
+    from .interactivebox import InteractiveBox  # noqa: F401
 
     __all__.extend(["InteractiveBox"])
 except ImportError:
     pass
 
+# Sync API (greenlet-based synchronous wrappers, re-exported via __all__)
+# Requires greenlet: pip install boxlite[sync]
+try:
+    from .sync_api import (  # noqa: F401
+        SyncBoxlite,
+        SyncBox,
+        SyncExecution,
+        SyncExecStdout,
+        SyncExecStderr,
+        SyncSimpleBox,
+        SyncCodeBox,
+    )
+
+    __all__.extend(
+        [
+            "SyncBoxlite",
+            "SyncBox",
+            "SyncExecution",
+            "SyncExecStdout",
+            "SyncExecStderr",
+            "SyncSimpleBox",
+            "SyncCodeBox",
+        ]
+    )
+except ImportError:
+    # greenlet not installed - sync API not available
+    pass
+
 # Get version from package metadata
 try:
     from importlib.metadata import version, PackageNotFoundError
+
     __version__ = version("boxlite")
 except PackageNotFoundError:
     # Package not installed (e.g., development mode)

boxlite/browserbox.py

@@ -8,7 +8,7 @@ controlled from outside using standard tools like Puppeteer or Playwright.
 from dataclasses import dataclass
 from typing import Optional, TYPE_CHECKING
 
-from .simplebox import SimpleBox, StreamType
+from .simplebox import SimpleBox
 
 if TYPE_CHECKING:
     from .boxlite import Boxlite
@@ -30,6 +30,7 @@ class BrowserBoxOptions:
         >>> async with BrowserBox(opts) as browser:
         ...     print(browser.endpoint())
     """
+
     browser: str = "chromium"  # chromium, firefox, or webkit
     memory: int = 2048  # Memory in MiB
     cpu: int = 2  # Number of CPU cores
@@ -60,14 +61,19 @@ class BrowserBox(SimpleBox):
     # CDP port for each browser type
     _PORTS = {"chromium": 9222, "firefox": 9223, "webkit": 9224}
 
-    def __init__(self, options: Optional[BrowserBoxOptions] = None,
-                 runtime: Optional['Boxlite'] = None):
+    def __init__(
+        self,
+        options: Optional[BrowserBoxOptions] = None,
+        runtime: Optional["Boxlite"] = None,
+        **kwargs,
+    ):
         """
         Create and auto-start a browser.
 
         Args:
             options: Browser configuration (uses defaults if None)
             runtime: Optional runtime instance (uses global default if None)
+            **kwargs: Additional configuration options (volumes, env, etc.)
         """
         opts = options or BrowserBoxOptions()
 
@@ -80,6 +86,7 @@ class BrowserBox(SimpleBox):
             memory_mib=opts.memory,
             cpus=opts.cpu,
             runtime=runtime,
+            **kwargs,
         )
 
     async def __aenter__(self):

boxlite/codebox.py

@@ -25,12 +25,12 @@ class CodeBox(SimpleBox):
     """
 
     def __init__(
-            self,
-            image: str = "python:slim",
-            memory_mib: Optional[int] = None,
-            cpus: Optional[int] = None,
-            runtime: Optional['Boxlite'] = None,
-            **kwargs
+        self,
+        image: str = "python:slim",
+        memory_mib: Optional[int] = None,
+        cpus: Optional[int] = None,
+        runtime: Optional["Boxlite"] = None,
+        **kwargs,
     ):
         """
         Create a new CodeBox.
@@ -80,7 +80,7 @@ class CodeBox(SimpleBox):
         Returns:
             Execution output as a string
         """
-        with open(script_path, 'r') as f:
+        with open(script_path, "r") as f:
             code = f.read()
         return await self.run(code)