pg0-embedded 0.1.1__tar.gz

pg0_embedded-0.1.1/.gitignore

@@ -0,0 +1,5 @@
+/target
+Cargo.lock
+.idea/
+node_modules/
+.env

pg0_embedded-0.1.1/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: pg0-embedded
+Version: 0.1.1
+Summary: Python API for pg0 - embedded PostgreSQL
+Project-URL: Homepage, https://github.com/vectorize-io/pg0
+Project-URL: Repository, https://github.com/vectorize-io/pg0
+License-Expression: MIT
+Keywords: database,embedded,pgvector,postgresql
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# pg0 - Embedded PostgreSQL for Python
+
+Zero-config PostgreSQL with pgvector support. Just `pip install` and go.
+
+## Installation
+
+```bash
+pip install pg0-embedded
+```
+
+## Quick Start
+
+```python
+from pg0 import Pg0
+
+# Start PostgreSQL (auto-installs on first run)
+pg = Pg0()
+pg.start()
+
+print(pg.uri)  # postgresql://postgres:postgres@localhost:5432/postgres
+
+pg.stop()
+```
+
+## Context Manager
+
+```python
+from pg0 import Pg0
+
+with Pg0() as pg:
+    print(pg.uri)
+    pg.execute("CREATE EXTENSION IF NOT EXISTS vector")
+    pg.execute("SELECT version()")
+# Automatically stopped
+```
+
+## Custom Configuration
+
+```python
+from pg0 import Pg0
+
+pg = Pg0(
+    port=5433,
+    username="myuser",
+    password="mypass",
+    database="mydb",
+    config={
+        "shared_buffers": "512MB",
+        "maintenance_work_mem": "1GB",
+    }
+)
+
+with pg:
+    print(pg.uri)
+```
+
+## Multiple Instances
+
+```python
+from pg0 import Pg0, list_instances
+
+# Run multiple PostgreSQL instances
+app = Pg0(name="app", port=5432)
+test = Pg0(name="test", port=5433)
+
+app.start()
+test.start()
+
+for instance in list_instances():
+    print(f"{instance.name}: {instance.uri}")
+
+app.stop()
+test.stop()
+```
+
+## API Reference
+
+### Pg0 Class
+
+```python
+pg = Pg0(
+    name="default",      # Instance name
+    port=5432,           # Port
+    username="postgres", # Username
+    password="postgres", # Password
+    database="postgres", # Database
+    data_dir=None,       # Custom data directory
+    config={},           # PostgreSQL config options
+)
+
+pg.start()        # Start PostgreSQL -> InstanceInfo
+pg.stop()         # Stop PostgreSQL
+pg.info()         # Get instance info -> InstanceInfo
+pg.uri            # Connection URI (property)
+pg.running        # Is running (property)
+pg.execute(sql)   # Execute SQL -> str
+pg.psql(*args)    # Run psql command
+```
+
+### Module Functions
+
+```python
+import pg0
+
+pg0.start(port=5432, ...)   # Start instance -> InstanceInfo
+pg0.stop(name="default")    # Stop instance
+pg0.info(name="default")    # Get info -> InstanceInfo
+pg0.list_instances()        # List all -> [InstanceInfo]
+pg0.install(version=None)   # Install pg0 binary
+```
+
+### InstanceInfo
+
+```python
+info.name       # Instance name
+info.running    # Is running
+info.pid        # Process ID
+info.port       # Port
+info.uri        # Connection URI
+info.username   # Username
+info.database   # Database
+info.data_dir   # Data directory
+```

pg0_embedded-0.1.1/README.md

@@ -0,0 +1,123 @@
+# pg0 - Embedded PostgreSQL for Python
+
+Zero-config PostgreSQL with pgvector support. Just `pip install` and go.
+
+## Installation
+
+```bash
+pip install pg0-embedded
+```
+
+## Quick Start
+
+```python
+from pg0 import Pg0
+
+# Start PostgreSQL (auto-installs on first run)
+pg = Pg0()
+pg.start()
+
+print(pg.uri)  # postgresql://postgres:postgres@localhost:5432/postgres
+
+pg.stop()
+```
+
+## Context Manager
+
+```python
+from pg0 import Pg0
+
+with Pg0() as pg:
+    print(pg.uri)
+    pg.execute("CREATE EXTENSION IF NOT EXISTS vector")
+    pg.execute("SELECT version()")
+# Automatically stopped
+```
+
+## Custom Configuration
+
+```python
+from pg0 import Pg0
+
+pg = Pg0(
+    port=5433,
+    username="myuser",
+    password="mypass",
+    database="mydb",
+    config={
+        "shared_buffers": "512MB",
+        "maintenance_work_mem": "1GB",
+    }
+)
+
+with pg:
+    print(pg.uri)
+```
+
+## Multiple Instances
+
+```python
+from pg0 import Pg0, list_instances
+
+# Run multiple PostgreSQL instances
+app = Pg0(name="app", port=5432)
+test = Pg0(name="test", port=5433)
+
+app.start()
+test.start()
+
+for instance in list_instances():
+    print(f"{instance.name}: {instance.uri}")
+
+app.stop()
+test.stop()
+```
+
+## API Reference
+
+### Pg0 Class
+
+```python
+pg = Pg0(
+    name="default",      # Instance name
+    port=5432,           # Port
+    username="postgres", # Username
+    password="postgres", # Password
+    database="postgres", # Database
+    data_dir=None,       # Custom data directory
+    config={},           # PostgreSQL config options
+)
+
+pg.start()        # Start PostgreSQL -> InstanceInfo
+pg.stop()         # Stop PostgreSQL
+pg.info()         # Get instance info -> InstanceInfo
+pg.uri            # Connection URI (property)
+pg.running        # Is running (property)
+pg.execute(sql)   # Execute SQL -> str
+pg.psql(*args)    # Run psql command
+```
+
+### Module Functions
+
+```python
+import pg0
+
+pg0.start(port=5432, ...)   # Start instance -> InstanceInfo
+pg0.stop(name="default")    # Stop instance
+pg0.info(name="default")    # Get info -> InstanceInfo
+pg0.list_instances()        # List all -> [InstanceInfo]
+pg0.install(version=None)   # Install pg0 binary
+```
+
+### InstanceInfo
+
+```python
+info.name       # Instance name
+info.running    # Is running
+info.pid        # Process ID
+info.port       # Port
+info.uri        # Connection URI
+info.username   # Username
+info.database   # Database
+info.data_dir   # Data directory
+```

pg0_embedded-0.1.1/pg0/__init__.py

@@ -0,0 +1,538 @@
+"""
+pg0 - Embedded PostgreSQL for Python
+
+Usage:
+    from pg0 import Pg0
+
+    # Start PostgreSQL
+    pg = Pg0()
+    pg.start()
+    print(pg.uri)
+    pg.stop()
+
+    # Or use context manager
+    with Pg0() as pg:
+        print(pg.uri)
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import platform
+import shutil
+import stat
+import subprocess
+import sys
+import tempfile
+import urllib.request
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Optional
+
+
+__version__ = "0.1.0"
+
+# GitHub repo for pg0 releases
+PG0_REPO = "vectorize-io/pg0"
+
+
+class Pg0Error(Exception):
+    """Base exception for pg0 errors."""
+    pass
+
+
+class Pg0NotFoundError(Pg0Error):
+    """pg0 binary not found and could not be installed."""
+    pass
+
+
+class Pg0NotRunningError(Pg0Error):
+    """PostgreSQL instance is not running."""
+    pass
+
+
+class Pg0AlreadyRunningError(Pg0Error):
+    """PostgreSQL instance is already running."""
+    pass
+
+
+@dataclass
+class InstanceInfo:
+    """Information about a PostgreSQL instance."""
+    name: str
+    running: bool
+    pid: Optional[int] = None
+    port: Optional[int] = None
+    version: Optional[str] = None
+    username: Optional[str] = None
+    database: Optional[str] = None
+    data_dir: Optional[str] = None
+    uri: Optional[str] = None
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "InstanceInfo":
+        return cls(
+            name=data.get("name", "default"),
+            running=data.get("running", False),
+            pid=data.get("pid"),
+            port=data.get("port"),
+            version=data.get("version"),
+            username=data.get("username"),
+            database=data.get("database"),
+            data_dir=data.get("data_dir"),
+            uri=data.get("uri"),
+        )
+
+
+def _get_install_dir() -> Path:
+    """Get the directory where pg0 binary should be installed."""
+    # Use ~/.local/bin on Unix, or a pg0-specific dir
+    if sys.platform == "win32":
+        base = Path(os.environ.get("LOCALAPPDATA", Path.home() / "AppData" / "Local"))
+        return base / "pg0" / "bin"
+    else:
+        return Path.home() / ".local" / "bin"
+
+
+def _get_platform() -> str:
+    """Get the platform string for downloading the correct binary."""
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+
+    if system == "darwin":
+        # macOS - only Apple Silicon supported, Intel uses Rosetta
+        return "darwin-aarch64"
+    elif system == "linux":
+        # Detect architecture
+        if machine in ("x86_64", "amd64"):
+            arch_str = "x86_64"
+        elif machine in ("aarch64", "arm64"):
+            arch_str = "aarch64"
+        else:
+            raise Pg0NotFoundError(f"Unsupported Linux architecture: {machine}")
+
+        # Detect libc (musl vs glibc)
+        # Check for musl by looking for the musl loader
+        import subprocess
+        try:
+            result = subprocess.run(
+                ["ldd", "--version"],
+                capture_output=True,
+                text=True,
+                timeout=5,
+            )
+            output = result.stdout + result.stderr
+            if "musl" in output.lower():
+                return f"linux-{arch_str}-musl"
+        except (FileNotFoundError, subprocess.TimeoutExpired):
+            pass
+
+        # Check for musl loader file
+        musl_loaders = [
+            f"/lib/ld-musl-{arch_str}.so.1",
+            "/lib/ld-musl-x86_64.so.1",
+            "/lib/ld-musl-aarch64.so.1",
+        ]
+        for loader in musl_loaders:
+            if Path(loader).exists():
+                return f"linux-{arch_str}-musl"
+
+        # Default to glibc
+        return f"linux-{arch_str}-gnu"
+    elif system == "windows":
+        return "windows-x86_64"
+    else:
+        raise Pg0NotFoundError(f"Unsupported platform: {system}")
+
+
+def _get_latest_version() -> str:
+    """Get the latest pg0 version from GitHub."""
+    url = f"https://api.github.com/repos/{PG0_REPO}/releases/latest"
+    try:
+        with urllib.request.urlopen(url, timeout=30) as response:
+            data = json.loads(response.read().decode())
+            return data["tag_name"]
+    except Exception as e:
+        raise Pg0NotFoundError(f"Failed to fetch latest version: {e}")
+
+
+def install(version: Optional[str] = None, force: bool = False) -> Path:
+    """
+    Install the pg0 binary.
+
+    Args:
+        version: Version to install (default: latest)
+        force: Force reinstall even if already installed
+
+    Returns:
+        Path to the installed binary
+    """
+    install_dir = _get_install_dir()
+    binary_name = "pg0.exe" if sys.platform == "win32" else "pg0"
+    binary_path = install_dir / binary_name
+
+    # Check if already installed
+    if binary_path.exists() and not force:
+        return binary_path
+
+    # Get version
+    if version is None:
+        version = _get_latest_version()
+
+    # Get platform
+    plat = _get_platform()
+
+    # Build download URL
+    ext = ".exe" if sys.platform == "win32" else ""
+    filename = f"pg0-{plat}{ext}"
+    url = f"https://github.com/{PG0_REPO}/releases/download/{version}/{filename}"
+
+    print(f"Installing pg0 {version}...")
+
+    # Create install directory
+    install_dir.mkdir(parents=True, exist_ok=True)
+
+    # Download binary
+    try:
+        with tempfile.NamedTemporaryFile(delete=False) as tmp:
+            tmp_path = Path(tmp.name)
+
+        with urllib.request.urlopen(url, timeout=120) as response:
+            tmp_path.write_bytes(response.read())
+
+        # Move to install location
+        shutil.move(str(tmp_path), str(binary_path))
+
+        # Make executable on Unix
+        if sys.platform != "win32":
+            binary_path.chmod(binary_path.stat().st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
+
+        print(f"Installed pg0 to {binary_path}")
+        return binary_path
+
+    except Exception as e:
+        # Cleanup
+        if tmp_path.exists():
+            tmp_path.unlink()
+        raise Pg0NotFoundError(f"Failed to install pg0: {e}")
+
+
+def _find_pg0() -> str:
+    """Find the pg0 binary, installing if necessary."""
+    # Check PATH first
+    path = shutil.which("pg0")
+    if path:
+        return path
+
+    # Check our install location
+    install_dir = _get_install_dir()
+    binary_name = "pg0.exe" if sys.platform == "win32" else "pg0"
+    binary_path = install_dir / binary_name
+
+    if binary_path.exists():
+        return str(binary_path)
+
+    # Auto-install
+    installed_path = install(version=None)
+    return str(installed_path)
+
+
+def _run_pg0(*args: str, check: bool = True) -> subprocess.CompletedProcess:
+    """Run a pg0 command."""
+    pg0_path = _find_pg0()
+    try:
+        result = subprocess.run(
+            [pg0_path, *args],
+            capture_output=True,
+            text=True,
+        )
+        if check and result.returncode != 0:
+            stderr = result.stderr.strip()
+            if "already running" in stderr.lower():
+                raise Pg0AlreadyRunningError(stderr)
+            elif "no running instance" in stderr.lower() or "not running" in stderr.lower():
+                raise Pg0NotRunningError(stderr)
+            else:
+                raise Pg0Error(stderr or f"pg0 command failed with code {result.returncode}")
+        return result
+    except FileNotFoundError:
+        raise Pg0NotFoundError("pg0 binary not found")
+
+
+class Pg0:
+    """
+    Embedded PostgreSQL instance.
+
+    Args:
+        name: Instance name (allows multiple instances)
+        port: Port to listen on
+        username: Database username
+        password: Database password
+        database: Database name
+        data_dir: Custom data directory
+        config: Dict of PostgreSQL configuration options
+
+    Example:
+        # Simple usage
+        pg = Pg0()
+        pg.start()
+        print(pg.uri)
+        pg.stop()
+
+        # Context manager
+        with Pg0(port=5433, database="myapp") as pg:
+            print(pg.uri)
+
+        # Custom config
+        pg = Pg0(config={"shared_buffers": "512MB"})
+    """
+
+    def __init__(
+        self,
+        name: str = "default",
+        port: int = 5432,
+        username: str = "postgres",
+        password: str = "postgres",
+        database: str = "postgres",
+        data_dir: Optional[str] = None,
+        config: Optional[dict[str, str]] = None,
+    ):
+        self.name = name
+        self.port = port
+        self.username = username
+        self.password = password
+        self.database = database
+        self.data_dir = data_dir
+        self.config = config or {}
+
+    def start(self) -> InstanceInfo:
+        """
+        Start the PostgreSQL instance.
+
+        Returns:
+            InstanceInfo with connection details
+
+        Raises:
+            Pg0AlreadyRunningError: If instance is already running
+            Pg0Error: If start fails
+        """
+        args = [
+            "start",
+            "--name", self.name,
+            "--port", str(self.port),
+            "--username", self.username,
+            "--password", self.password,
+            "--database", self.database,
+        ]
+
+        if self.data_dir:
+            args.extend(["--data-dir", self.data_dir])
+
+        for key, value in self.config.items():
+            args.extend(["-c", f"{key}={value}"])
+
+        _run_pg0(*args)
+        return self.info()
+
+    def stop(self) -> None:
+        """
+        Stop the PostgreSQL instance.
+
+        Note: Does not raise an error if the instance is not running.
+        """
+        _run_pg0("stop", "--name", self.name, check=False)
+
+    def drop(self, force: bool = True) -> None:
+        """
+        Drop the PostgreSQL instance (stop if running, delete all data).
+
+        Args:
+            force: Skip confirmation prompt (default True for programmatic use)
+
+        Warning:
+            This permanently deletes all data for this instance!
+        """
+        args = ["drop", "--name", self.name]
+        if force:
+            args.append("--force")
+        _run_pg0(*args, check=False)
+
+    def info(self) -> InstanceInfo:
+        """
+        Get information about the PostgreSQL instance.
+
+        Returns:
+            InstanceInfo with current status and connection details
+        """
+        result = _run_pg0("info", "--name", self.name, "-o", "json", check=False)
+        data = json.loads(result.stdout)
+        return InstanceInfo.from_dict(data)
+
+    @property
+    def uri(self) -> Optional[str]:
+        """Get the connection URI if running."""
+        return self.info().uri
+
+    @property
+    def running(self) -> bool:
+        """Check if the instance is running."""
+        return self.info().running
+
+    def psql(self, *args: str) -> subprocess.CompletedProcess:
+        """
+        Run psql with the given arguments.
+
+        Args:
+            *args: Arguments to pass to psql (e.g., "-c", "SELECT 1")
+
+        Returns:
+            CompletedProcess with stdout/stderr
+
+        Example:
+            result = pg.psql("-c", "SELECT version();")
+            print(result.stdout)
+        """
+        return _run_pg0("psql", "--name", self.name, *args)
+
+    def execute(self, sql: str) -> str:
+        """
+        Execute a SQL command and return the output.
+
+        Args:
+            sql: SQL command to execute
+
+        Returns:
+            Command output as string
+
+        Example:
+            output = pg.execute("SELECT version();")
+        """
+        result = self.psql("-c", sql)
+        return result.stdout
+
+    def __enter__(self) -> "Pg0":
+        """Context manager entry - starts PostgreSQL."""
+        self.start()
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb) -> None:
+        """Context manager exit - stops PostgreSQL."""
+        try:
+            self.stop()
+        except Pg0NotRunningError:
+            pass
+
+
+def list_instances() -> list[InstanceInfo]:
+    """
+    List all pg0 instances.
+
+    Returns:
+        List of InstanceInfo for all known instances
+    """
+    result = _run_pg0("list", "-o", "json", check=False)
+    data = json.loads(result.stdout)
+    return [InstanceInfo.from_dict(item) for item in data]
+
+
+def start(
+    name: str = "default",
+    port: int = 5432,
+    username: str = "postgres",
+    password: str = "postgres",
+    database: str = "postgres",
+    **config: str,
+) -> InstanceInfo:
+    """
+    Start a PostgreSQL instance (convenience function).
+
+    Args:
+        name: Instance name
+        port: Port to listen on
+        username: Database username
+        password: Database password
+        database: Database name
+        **config: PostgreSQL configuration options
+
+    Returns:
+        InstanceInfo with connection details
+
+    Example:
+        info = pg0.start(port=5433, shared_buffers="512MB")
+        print(info.uri)
+    """
+    pg = Pg0(
+        name=name,
+        port=port,
+        username=username,
+        password=password,
+        database=database,
+        config=config,
+    )
+    return pg.start()
+
+
+def stop(name: str = "default") -> None:
+    """
+    Stop a PostgreSQL instance (convenience function).
+
+    Args:
+        name: Instance name to stop
+    """
+    _run_pg0("stop", "--name", name, check=False)
+
+
+def drop(name: str = "default", force: bool = True) -> None:
+    """
+    Drop a PostgreSQL instance (convenience function).
+
+    Stops the instance if running and deletes all data.
+
+    Args:
+        name: Instance name to drop
+        force: Skip confirmation prompt (default True for programmatic use)
+
+    Warning:
+        This permanently deletes all data for this instance!
+    """
+    args = ["drop", "--name", name]
+    if force:
+        args.append("--force")
+    _run_pg0(*args, check=False)
+
+
+def info(name: str = "default") -> InstanceInfo:
+    """
+    Get information about a PostgreSQL instance (convenience function).
+
+    Args:
+        name: Instance name
+
+    Returns:
+        InstanceInfo with current status
+    """
+    result = _run_pg0("info", "--name", name, "-o", "json", check=False)
+    data = json.loads(result.stdout)
+    return InstanceInfo.from_dict(data)
+
+
+# Keep PostgreSQL as alias for backwards compatibility
+PostgreSQL = Pg0
+
+
+__all__ = [
+    "Pg0",
+    "PostgreSQL",  # alias
+    "InstanceInfo",
+    "Pg0Error",
+    "Pg0NotFoundError",
+    "Pg0NotRunningError",
+    "Pg0AlreadyRunningError",
+    "install",
+    "list_instances",
+    "start",
+    "stop",
+    "drop",
+    "info",
+]

pg0_embedded-0.1.1/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "pg0-embedded"
+version = "0.1.1"
+description = "Python API for pg0 - embedded PostgreSQL"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+keywords = ["postgresql", "database", "embedded", "pgvector"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[project.urls]
+Homepage = "https://github.com/vectorize-io/pg0"
+Repository = "https://github.com/vectorize-io/pg0"
+
+[dependency-groups]
+dev = ["pytest>=8.0.0"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["pg0"]

pg0_embedded-0.1.1/tests/test_pg0.py

@@ -0,0 +1,195 @@
+"""Tests for pg0 Python client."""
+
+import pytest
+import pg0
+from pg0 import Pg0, InstanceInfo, Pg0NotRunningError, Pg0AlreadyRunningError
+
+
+# Use a unique port to avoid conflicts
+TEST_PORT = 15432
+TEST_NAME = "pytest-test"
+
+
+@pytest.fixture
+def clean_instance():
+    """Ensure test instance is stopped before and after test."""
+    # Cleanup before
+    try:
+        pg0.stop(TEST_NAME)
+    except Pg0NotRunningError:
+        pass
+
+    yield
+
+    # Cleanup after
+    try:
+        pg0.stop(TEST_NAME)
+    except Pg0NotRunningError:
+        pass
+
+
+class TestPg0:
+    """Tests for Pg0 class."""
+
+    def test_start_stop(self, clean_instance):
+        """Test starting and stopping Pg0."""
+        pg = Pg0(name=TEST_NAME, port=TEST_PORT)
+
+        # Start
+        info = pg.start()
+        assert info.running is True
+        assert info.port == TEST_PORT
+        assert info.uri is not None
+        assert f":{TEST_PORT}/" in info.uri
+
+        # Stop
+        pg.stop()
+        info = pg.info()
+        assert info.running is False
+
+    def test_context_manager(self, clean_instance):
+        """Test using Pg0 as context manager."""
+        with Pg0(name=TEST_NAME, port=TEST_PORT) as pg:
+            assert pg.running is True
+            assert pg.uri is not None
+
+        # Should be stopped after exiting context
+        info = pg0.info(TEST_NAME)
+        assert info.running is False
+
+    def test_execute_sql(self, clean_instance):
+        """Test executing SQL commands."""
+        pg = Pg0(name=TEST_NAME, port=TEST_PORT)
+        pg.start()
+
+        try:
+            # Execute a simple query
+            result = pg.execute("SELECT 1 as num;")
+            assert "1" in result
+
+            # Create and query a table
+            pg.execute("CREATE TABLE test_table (id serial, name text);")
+            pg.execute("INSERT INTO test_table (name) VALUES ('hello');")
+            result = pg.execute("SELECT name FROM test_table;")
+            assert "hello" in result
+        finally:
+            pg.stop()
+
+    def test_custom_credentials(self, clean_instance):
+        """Test custom username, password, database."""
+        pg = Pg0(
+            name=TEST_NAME,
+            port=TEST_PORT,
+            username="testuser",
+            password="testpass",
+            database="testdb",
+        )
+        info = pg.start()
+
+        try:
+            assert "testuser" in info.uri
+            assert "testpass" in info.uri
+            assert "testdb" in info.uri
+        finally:
+            pg.stop()
+
+    def test_custom_config(self, clean_instance):
+        """Test custom Pg0 configuration."""
+        pg = Pg0(
+            name=TEST_NAME,
+            port=TEST_PORT,
+            config={"work_mem": "128MB"},
+        )
+        pg.start()
+
+        try:
+            result = pg.execute("SHOW work_mem;")
+            assert "128MB" in result
+        finally:
+            pg.stop()
+
+    def test_already_running_error(self, clean_instance):
+        """Test that starting twice raises error."""
+        pg = Pg0(name=TEST_NAME, port=TEST_PORT)
+        pg.start()
+
+        try:
+            with pytest.raises(Pg0AlreadyRunningError):
+                pg.start()
+        finally:
+            pg.stop()
+
+    def test_not_running_error(self, clean_instance):
+        """Test that stopping when not running raises error."""
+        pg = Pg0(name=TEST_NAME, port=TEST_PORT)
+
+        with pytest.raises(Pg0NotRunningError):
+            pg.stop()
+
+    def test_info_when_not_running(self, clean_instance):
+        """Test getting info when not running."""
+        pg = Pg0(name=TEST_NAME, port=TEST_PORT)
+        info = pg.info()
+
+        assert info.running is False
+        assert info.uri is None
+
+
+class TestConvenienceFunctions:
+    """Tests for module-level convenience functions."""
+
+    def test_start_stop_info(self, clean_instance):
+        """Test start, stop, info functions."""
+        info = pg0.start(name=TEST_NAME, port=TEST_PORT)
+        assert info.running is True
+
+        info = pg0.info(TEST_NAME)
+        assert info.running is True
+        assert info.port == TEST_PORT
+
+        pg0.stop(TEST_NAME)
+        info = pg0.info(TEST_NAME)
+        assert info.running is False
+
+    def test_list_instances(self, clean_instance):
+        """Test listing instances."""
+        # Start an instance
+        pg0.start(name=TEST_NAME, port=TEST_PORT)
+
+        try:
+            instances = pg0.list_instances()
+            names = [i.name for i in instances]
+            assert TEST_NAME in names
+        finally:
+            pg0.stop(TEST_NAME)
+
+
+class TestInstanceInfo:
+    """Tests for InstanceInfo dataclass."""
+
+    def test_from_dict(self):
+        """Test creating InstanceInfo from dict."""
+        data = {
+            "name": "test",
+            "running": True,
+            "pid": 1234,
+            "port": 5432,
+            "uri": "postgresql://localhost:5432/test",
+        }
+        info = InstanceInfo.from_dict(data)
+
+        assert info.name == "test"
+        assert info.running is True
+        assert info.pid == 1234
+        assert info.port == 5432
+        assert info.uri == "postgresql://localhost:5432/test"
+
+    def test_from_dict_minimal(self):
+        """Test creating InstanceInfo from minimal dict."""
+        data = {"running": False}
+        info = InstanceInfo.from_dict(data)
+
+        assert info.name == "default"
+        assert info.running is False
+        assert info.pid is None
+        assert info.uri is None

pg0_embedded-0.1.1/uv.lock

@@ -0,0 +1,251 @@
+version = 1
+revision = 1
+requires-python = ">=3.8"
+resolution-markers = [
+    "python_full_version >= '3.10'",
+    "python_full_version == '3.9.*'",
+    "python_full_version < '3.9'",
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335 },
+]
+
+[[package]]
+name = "exceptiongroup"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", version = "4.13.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
+    { name = "typing-extensions", version = "4.15.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.9' and python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/0e/97c33bf5009bdbac74fd2beace167cab3f978feb69cc36f1ef79360d6c4e/exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598", size = 16740 },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version == '3.9.*'",
+    "python_full_version < '3.9'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f2/97/ebf4da567aa6827c909642694d71c9fcf53e5b504f2d96afea02718862f3/iniconfig-2.1.0.tar.gz", hash = "sha256:3abbd2e30b36733fee78f9c7f7308f2d0050e88f0087fd25c2645f63c773e1c7", size = 4793 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/e1/e6716421ea10d38022b952c159d5161ca1193197fb744506875fbb87ea7b/iniconfig-2.1.0-py3-none-any.whl", hash = "sha256:9deba5723312380e77435581c6bf4935c94cbfab9b1ed33ef8d238ea168eb760", size = 6050 },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484 },
+]
+
+[[package]]
+name = "packaging"
+version = "25.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a1/d4/1fc4078c65507b51b96ca8f8c3ba19e6a61c8253c72794544580a7b6c24d/packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f", size = 165727 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484", size = 66469 },
+]
+
+[[package]]
+name = "pg0"
+version = "0.1.0"
+source = { editable = "." }
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest", version = "8.3.5", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
+    { name = "pytest", version = "8.4.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.9.*'" },
+    { name = "pytest", version = "9.0.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
+]
+
+[package.metadata]
+
+[package.metadata.requires-dev]
+dev = [{ name = "pytest", specifier = ">=8.0.0" }]
+
+[[package]]
+name = "pluggy"
+version = "1.5.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.9'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/96/2d/02d4312c973c6050a18b314a5ad0b3210edb65a906f868e31c111dede4a6/pluggy-1.5.0.tar.gz", hash = "sha256:2cffa88e94fdc978c4c574f15f9e59b7f4201d439195c3715ca9e2486f1d0cf1", size = 67955 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/88/5f/e351af9a41f866ac3f1fac4ca0613908d9a41741cfcf2228f4ad853b697d/pluggy-1.5.0-py3-none-any.whl", hash = "sha256:44e1ad92c8ca002de6377e165f3e0f1be63266ab4d554740532335b9d75ea669", size = 20556 },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+    "python_full_version == '3.9.*'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538 },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217 },
+]
+
+[[package]]
+name = "pytest"
+version = "8.3.5"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.9'",
+]
+dependencies = [
+    { name = "colorama", marker = "python_full_version < '3.9' and sys_platform == 'win32'" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.9'" },
+    { name = "iniconfig", version = "2.1.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
+    { name = "packaging", marker = "python_full_version < '3.9'" },
+    { name = "pluggy", version = "1.5.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },
+    { name = "tomli", marker = "python_full_version < '3.9'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ae/3c/c9d525a414d506893f0cd8a8d0de7706446213181570cdbd766691164e40/pytest-8.3.5.tar.gz", hash = "sha256:f4efe70cc14e511565ac476b57c279e12a855b11f48f212af1080ef2263d3845", size = 1450891 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/30/3d/64ad57c803f1fa1e963a7946b6e0fea4a70df53c1a7fed304586539c2bac/pytest-8.3.5-py3-none-any.whl", hash = "sha256:c69214aa47deac29fad6c2a4f590b9c4a9fdb16a403176fe154b79c0b4d4d820", size = 343634 },
+]
+
+[[package]]
+name = "pytest"
+version = "8.4.2"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version == '3.9.*'",
+]
+dependencies = [
+    { name = "colorama", marker = "python_full_version == '3.9.*' and sys_platform == 'win32'" },
+    { name = "exceptiongroup", marker = "python_full_version == '3.9.*'" },
+    { name = "iniconfig", version = "2.1.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.9.*'" },
+    { name = "packaging", marker = "python_full_version == '3.9.*'" },
+    { name = "pluggy", version = "1.6.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version == '3.9.*'" },
+    { name = "pygments", marker = "python_full_version == '3.9.*'" },
+    { name = "tomli", marker = "python_full_version == '3.9.*'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a3/5c/00a0e072241553e1a7496d638deababa67c5058571567b92a7eaa258397c/pytest-8.4.2.tar.gz", hash = "sha256:86c0d0b93306b961d58d62a4db4879f27fe25513d4b969df351abdddb3c30e01", size = 1519618 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a8/a4/20da314d277121d6534b3a980b29035dcd51e6744bd79075a6ce8fa4eb8d/pytest-8.4.2-py3-none-any.whl", hash = "sha256:872f880de3fc3a5bdc88a11b39c9710c3497a547cfa9320bc3c5e62fbf272e79", size = 365750 },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.1"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+]
+dependencies = [
+    { name = "colorama", marker = "python_full_version >= '3.10' and sys_platform == 'win32'" },
+    { name = "exceptiongroup", marker = "python_full_version == '3.10.*'" },
+    { name = "iniconfig", version = "2.3.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
+    { name = "packaging", marker = "python_full_version >= '3.10'" },
+    { name = "pluggy", version = "1.6.0", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.10'" },
+    { name = "pygments", marker = "python_full_version >= '3.10'" },
+    { name = "tomli", marker = "python_full_version == '3.10.*'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/07/56/f013048ac4bc4c1d9be45afd4ab209ea62822fb1598f40687e6bf45dcea4/pytest-9.0.1.tar.gz", hash = "sha256:3e9c069ea73583e255c3b21cf46b8d3c56f6e3a1a8f6da94ccb0fcf57b9d73c8", size = 1564125 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0b/8b/6300fb80f858cda1c51ffa17075df5d846757081d11ab4aa35cef9e6258b/pytest-9.0.1-py3-none-any.whl", hash = "sha256:67be0030d194df2dfa7b556f2e56fb3c3315bd5c8822c6951162b92b32ce7dad", size = 373668 },
+]
+
+[[package]]
+name = "tomli"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/52/ed/3f73f72945444548f33eba9a87fc7a6e969915e7b1acc8260b30e1f76a2f/tomli-2.3.0.tar.gz", hash = "sha256:64be704a875d2a59753d80ee8a533c3fe183e3f06807ff7dc2232938ccb01549", size = 17392 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/2e/299f62b401438d5fe1624119c723f5d877acc86a4c2492da405626665f12/tomli-2.3.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:88bd15eb972f3664f5ed4b57c1634a97153b4bac4479dcb6a495f41921eb7f45", size = 153236 },
+    { url = "https://files.pythonhosted.org/packages/86/7f/d8fffe6a7aefdb61bced88fcb5e280cfd71e08939da5894161bd71bea022/tomli-2.3.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:883b1c0d6398a6a9d29b508c331fa56adbcdff647f6ace4dfca0f50e90dfd0ba", size = 148084 },
+    { url = "https://files.pythonhosted.org/packages/47/5c/24935fb6a2ee63e86d80e4d3b58b222dafaf438c416752c8b58537c8b89a/tomli-2.3.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d1381caf13ab9f300e30dd8feadb3de072aeb86f1d34a8569453ff32a7dea4bf", size = 234832 },
+    { url = "https://files.pythonhosted.org/packages/89/da/75dfd804fc11e6612846758a23f13271b76d577e299592b4371a4ca4cd09/tomli-2.3.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a0e285d2649b78c0d9027570d4da3425bdb49830a6156121360b3f8511ea3441", size = 242052 },
+    { url = "https://files.pythonhosted.org/packages/70/8c/f48ac899f7b3ca7eb13af73bacbc93aec37f9c954df3c08ad96991c8c373/tomli-2.3.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:0a154a9ae14bfcf5d8917a59b51ffd5a3ac1fd149b71b47a3a104ca4edcfa845", size = 239555 },
+    { url = "https://files.pythonhosted.org/packages/ba/28/72f8afd73f1d0e7829bfc093f4cb98ce0a40ffc0cc997009ee1ed94ba705/tomli-2.3.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:74bf8464ff93e413514fefd2be591c3b0b23231a77f901db1eb30d6f712fc42c", size = 245128 },
+    { url = "https://files.pythonhosted.org/packages/b6/eb/a7679c8ac85208706d27436e8d421dfa39d4c914dcf5fa8083a9305f58d9/tomli-2.3.0-cp311-cp311-win32.whl", hash = "sha256:00b5f5d95bbfc7d12f91ad8c593a1659b6387b43f054104cda404be6bda62456", size = 96445 },
+    { url = "https://files.pythonhosted.org/packages/0a/fe/3d3420c4cb1ad9cb462fb52967080575f15898da97e21cb6f1361d505383/tomli-2.3.0-cp311-cp311-win_amd64.whl", hash = "sha256:4dc4ce8483a5d429ab602f111a93a6ab1ed425eae3122032db7e9acf449451be", size = 107165 },
+    { url = "https://files.pythonhosted.org/packages/ff/b7/40f36368fcabc518bb11c8f06379a0fd631985046c038aca08c6d6a43c6e/tomli-2.3.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d7d86942e56ded512a594786a5ba0a5e521d02529b3826e7761a05138341a2ac", size = 154891 },
+    { url = "https://files.pythonhosted.org/packages/f9/3f/d9dd692199e3b3aab2e4e4dd948abd0f790d9ded8cd10cbaae276a898434/tomli-2.3.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:73ee0b47d4dad1c5e996e3cd33b8a76a50167ae5f96a2607cbe8cc773506ab22", size = 148796 },
+    { url = "https://files.pythonhosted.org/packages/60/83/59bff4996c2cf9f9387a0f5a3394629c7efa5ef16142076a23a90f1955fa/tomli-2.3.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:792262b94d5d0a466afb5bc63c7daa9d75520110971ee269152083270998316f", size = 242121 },
+    { url = "https://files.pythonhosted.org/packages/45/e5/7c5119ff39de8693d6baab6c0b6dcb556d192c165596e9fc231ea1052041/tomli-2.3.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4f195fe57ecceac95a66a75ac24d9d5fbc98ef0962e09b2eddec5d39375aae52", size = 250070 },
+    { url = "https://files.pythonhosted.org/packages/45/12/ad5126d3a278f27e6701abde51d342aa78d06e27ce2bb596a01f7709a5a2/tomli-2.3.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:e31d432427dcbf4d86958c184b9bfd1e96b5b71f8eb17e6d02531f434fd335b8", size = 245859 },
+    { url = "https://files.pythonhosted.org/packages/fb/a1/4d6865da6a71c603cfe6ad0e6556c73c76548557a8d658f9e3b142df245f/tomli-2.3.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:7b0882799624980785240ab732537fcfc372601015c00f7fc367c55308c186f6", size = 250296 },
+    { url = "https://files.pythonhosted.org/packages/a0/b7/a7a7042715d55c9ba6e8b196d65d2cb662578b4d8cd17d882d45322b0d78/tomli-2.3.0-cp312-cp312-win32.whl", hash = "sha256:ff72b71b5d10d22ecb084d345fc26f42b5143c5533db5e2eaba7d2d335358876", size = 97124 },
+    { url = "https://files.pythonhosted.org/packages/06/1e/f22f100db15a68b520664eb3328fb0ae4e90530887928558112c8d1f4515/tomli-2.3.0-cp312-cp312-win_amd64.whl", hash = "sha256:1cb4ed918939151a03f33d4242ccd0aa5f11b3547d0cf30f7c74a408a5b99878", size = 107698 },
+    { url = "https://files.pythonhosted.org/packages/89/48/06ee6eabe4fdd9ecd48bf488f4ac783844fd777f547b8d1b61c11939974e/tomli-2.3.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:5192f562738228945d7b13d4930baffda67b69425a7f0da96d360b0a3888136b", size = 154819 },
+    { url = "https://files.pythonhosted.org/packages/f1/01/88793757d54d8937015c75dcdfb673c65471945f6be98e6a0410fba167ed/tomli-2.3.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:be71c93a63d738597996be9528f4abe628d1adf5e6eb11607bc8fe1a510b5dae", size = 148766 },
+    { url = "https://files.pythonhosted.org/packages/42/17/5e2c956f0144b812e7e107f94f1cc54af734eb17b5191c0bbfb72de5e93e/tomli-2.3.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c4665508bcbac83a31ff8ab08f424b665200c0e1e645d2bd9ab3d3e557b6185b", size = 240771 },
+    { url = "https://files.pythonhosted.org/packages/d5/f4/0fbd014909748706c01d16824eadb0307115f9562a15cbb012cd9b3512c5/tomli-2.3.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4021923f97266babc6ccab9f5068642a0095faa0a51a246a6a02fccbb3514eaf", size = 248586 },
+    { url = "https://files.pythonhosted.org/packages/30/77/fed85e114bde5e81ecf9bc5da0cc69f2914b38f4708c80ae67d0c10180c5/tomli-2.3.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4ea38c40145a357d513bffad0ed869f13c1773716cf71ccaa83b0fa0cc4e42f", size = 244792 },
+    { url = "https://files.pythonhosted.org/packages/55/92/afed3d497f7c186dc71e6ee6d4fcb0acfa5f7d0a1a2878f8beae379ae0cc/tomli-2.3.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:ad805ea85eda330dbad64c7ea7a4556259665bdf9d2672f5dccc740eb9d3ca05", size = 248909 },
+    { url = "https://files.pythonhosted.org/packages/f8/84/ef50c51b5a9472e7265ce1ffc7f24cd4023d289e109f669bdb1553f6a7c2/tomli-2.3.0-cp313-cp313-win32.whl", hash = "sha256:97d5eec30149fd3294270e889b4234023f2c69747e555a27bd708828353ab606", size = 96946 },
+    { url = "https://files.pythonhosted.org/packages/b2/b7/718cd1da0884f281f95ccfa3a6cc572d30053cba64603f79d431d3c9b61b/tomli-2.3.0-cp313-cp313-win_amd64.whl", hash = "sha256:0c95ca56fbe89e065c6ead5b593ee64b84a26fca063b5d71a1122bf26e533999", size = 107705 },
+    { url = "https://files.pythonhosted.org/packages/19/94/aeafa14a52e16163008060506fcb6aa1949d13548d13752171a755c65611/tomli-2.3.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:cebc6fe843e0733ee827a282aca4999b596241195f43b4cc371d64fc6639da9e", size = 154244 },
+    { url = "https://files.pythonhosted.org/packages/db/e4/1e58409aa78eefa47ccd19779fc6f36787edbe7d4cd330eeeedb33a4515b/tomli-2.3.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:4c2ef0244c75aba9355561272009d934953817c49f47d768070c3c94355c2aa3", size = 148637 },
+    { url = "https://files.pythonhosted.org/packages/26/b6/d1eccb62f665e44359226811064596dd6a366ea1f985839c566cd61525ae/tomli-2.3.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c22a8bf253bacc0cf11f35ad9808b6cb75ada2631c2d97c971122583b129afbc", size = 241925 },
+    { url = "https://files.pythonhosted.org/packages/70/91/7cdab9a03e6d3d2bb11beae108da5bdc1c34bdeb06e21163482544ddcc90/tomli-2.3.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0eea8cc5c5e9f89c9b90c4896a8deefc74f518db5927d0e0e8d4a80953d774d0", size = 249045 },
+    { url = "https://files.pythonhosted.org/packages/15/1b/8c26874ed1f6e4f1fcfeb868db8a794cbe9f227299402db58cfcc858766c/tomli-2.3.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b74a0e59ec5d15127acdabd75ea17726ac4c5178ae51b85bfe39c4f8a278e879", size = 245835 },
+    { url = "https://files.pythonhosted.org/packages/fd/42/8e3c6a9a4b1a1360c1a2a39f0b972cef2cc9ebd56025168c4137192a9321/tomli-2.3.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:b5870b50c9db823c595983571d1296a6ff3e1b88f734a4c8f6fc6188397de005", size = 253109 },
+    { url = "https://files.pythonhosted.org/packages/22/0c/b4da635000a71b5f80130937eeac12e686eefb376b8dee113b4a582bba42/tomli-2.3.0-cp314-cp314-win32.whl", hash = "sha256:feb0dacc61170ed7ab602d3d972a58f14ee3ee60494292d384649a3dc38ef463", size = 97930 },
+    { url = "https://files.pythonhosted.org/packages/b9/74/cb1abc870a418ae99cd5c9547d6bce30701a954e0e721821df483ef7223c/tomli-2.3.0-cp314-cp314-win_amd64.whl", hash = "sha256:b273fcbd7fc64dc3600c098e39136522650c49bca95df2d11cf3b626422392c8", size = 107964 },
+    { url = "https://files.pythonhosted.org/packages/54/78/5c46fff6432a712af9f792944f4fcd7067d8823157949f4e40c56b8b3c83/tomli-2.3.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:940d56ee0410fa17ee1f12b817b37a4d4e4dc4d27340863cc67236c74f582e77", size = 163065 },
+    { url = "https://files.pythonhosted.org/packages/39/67/f85d9bd23182f45eca8939cd2bc7050e1f90c41f4a2ecbbd5963a1d1c486/tomli-2.3.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:f85209946d1fe94416debbb88d00eb92ce9cd5266775424ff81bc959e001acaf", size = 159088 },
+    { url = "https://files.pythonhosted.org/packages/26/5a/4b546a0405b9cc0659b399f12b6adb750757baf04250b148d3c5059fc4eb/tomli-2.3.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a56212bdcce682e56b0aaf79e869ba5d15a6163f88d5451cbde388d48b13f530", size = 268193 },
+    { url = "https://files.pythonhosted.org/packages/42/4f/2c12a72ae22cf7b59a7fe75b3465b7aba40ea9145d026ba41cb382075b0e/tomli-2.3.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c5f3ffd1e098dfc032d4d3af5c0ac64f6d286d98bc148698356847b80fa4de1b", size = 275488 },
+    { url = "https://files.pythonhosted.org/packages/92/04/a038d65dbe160c3aa5a624e93ad98111090f6804027d474ba9c37c8ae186/tomli-2.3.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5e01decd096b1530d97d5d85cb4dff4af2d8347bd35686654a004f8dea20fc67", size = 272669 },
+    { url = "https://files.pythonhosted.org/packages/be/2f/8b7c60a9d1612a7cbc39ffcca4f21a73bf368a80fc25bccf8253e2563267/tomli-2.3.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:8a35dd0e643bb2610f156cca8db95d213a90015c11fee76c946aa62b7ae7e02f", size = 279709 },
+    { url = "https://files.pythonhosted.org/packages/7e/46/cc36c679f09f27ded940281c38607716c86cf8ba4a518d524e349c8b4874/tomli-2.3.0-cp314-cp314t-win32.whl", hash = "sha256:a1f7f282fe248311650081faafa5f4732bdbfef5d45fe3f2e702fbc6f2d496e0", size = 107563 },
+    { url = "https://files.pythonhosted.org/packages/84/ff/426ca8683cf7b753614480484f6437f568fd2fda2edbdf57a2d3d8b27a0b/tomli-2.3.0-cp314-cp314t-win_amd64.whl", hash = "sha256:70a251f8d4ba2d9ac2542eecf008b3c8a9fc5c3f9f02c56a9d7952612be2fdba", size = 119756 },
+    { url = "https://files.pythonhosted.org/packages/77/b8/0135fadc89e73be292b473cb820b4f5a08197779206b33191e801feeae40/tomli-2.3.0-py3-none-any.whl", hash = "sha256:e95b1af3c5b07d9e643909b5abbec77cd9f1217e6d0bca72b0234736b9fb1f1b", size = 14408 },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.13.2"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version < '3.9'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f6/37/23083fcd6e35492953e8d2aaaa68b860eb422b34627b13f2ce3eb6106061/typing_extensions-4.13.2.tar.gz", hash = "sha256:e6c81219bd689f51865d9e372991c540bda33a0379d5573cddb9a3a23f7caaef", size = 106967 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8b/54/b1ae86c0973cc6f0210b53d508ca3641fb6d0c56823f288d108bc7ab3cc8/typing_extensions-4.13.2-py3-none-any.whl", hash = "sha256:a439e7c04b49fec3e5d3e2beaa21755cadbbdc391694e28ccdd36ca4a1408f8c", size = 45806 },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+resolution-markers = [
+    "python_full_version >= '3.10'",
+    "python_full_version == '3.9.*'",
+]
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614 },
+]