dory-sdk 2.1.0__py3-none-any.whl → 2.1.4__py3-none-any.whl

{dory_sdk-2.1.0.dist-info → dory_sdk-2.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dory-sdk
-Version: 2.1.0
+Version: 2.1.4
 Summary: Python SDK for building stateful processors with zero-downtime migration, auto-initialization, and smart instrumentation
 Author-email: Dory Team <dory@example.com>
 License: Apache-2.0
@@ -43,9 +43,22 @@ Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Provides-Extra: production
-Requires-Dist: dory-sdk[kubernetes,tracing]; extra == "production"
+Requires-Dist: kubernetes>=28.0.0; extra == "production"
+Requires-Dist: opentelemetry-api>=1.20.0; extra == "production"
+Requires-Dist: opentelemetry-sdk>=1.20.0; extra == "production"
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.20.0; extra == "production"
 Provides-Extra: all
-Requires-Dist: dory-sdk[dev,kubernetes,monitoring,resilience,s3,tracing]; extra == "all"
+Requires-Dist: kubernetes>=28.0.0; extra == "all"
+Requires-Dist: boto3>=1.28.0; extra == "all"
+Requires-Dist: opentelemetry-api>=1.20.0; extra == "all"
+Requires-Dist: opentelemetry-sdk>=1.20.0; extra == "all"
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.20.0; extra == "all"
+Requires-Dist: pytest>=7.0.0; extra == "all"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "all"
+Requires-Dist: pytest-cov>=4.0.0; extra == "all"
+Requires-Dist: mypy>=1.0.0; extra == "all"
+Requires-Dist: ruff>=0.1.0; extra == "all"
+Requires-Dist: black>=23.0.0; extra == "all"
 
 # Dory SDK for Python
 
@@ -129,7 +142,7 @@ if __name__ == "__main__":
 ## Installation
 
 ```bash
-pip install dory-sdk[kubernetes]
+pip install dory-sdk[production]
 ```
 
 ---
@@ -175,17 +188,7 @@ With values file:
 helm install my-app ./helm/dory-processor -f values.yaml
 ```
 
-### Option 2: Kustomize
-
-```bash
-# Deploy to dev
-kubectl apply -k kustomize/overlays/dev
-
-# Deploy to production
-kubectl apply -k kustomize/overlays/production
-```
-
-### Option 3: CLI Generated Manifests
+### Option 2: CLI Generated Manifests
 
 ```bash
 dory init my-app --image my-app:latest
@@ -197,8 +200,8 @@ kubectl apply -f k8s/
 | Choose | When |
 |--------|------|
 | **Helm** | Need release management, rollback, existing Helm workflow |
-| **Kustomize** | GitOps (ArgoCD/Flux), prefer patch-based config |
 | **CLI** | Quick start, simple deployments |
+| **Orchestrator** | Production deployments with dynamic pod management |
 
 ---
 
@@ -225,10 +228,9 @@ helm install my-app ./helm/dory-processor \
   --set sidecar.enabled=true
 ```
 
-**Using Kustomize:**
-```bash
-kubectl apply -k kustomize/overlays/sidecar
-```
+**Using Orchestrator:**
+
+Configure `use_sidecar: true` in your `runtime_config_template` - the orchestrator automatically injects the sidecar container.
 
 ### How It Works
 
@@ -262,8 +264,11 @@ The sidecar:
 
 ### Build the Sidecar Image
 
+The sidecar is maintained in the [orchestrator repository](../orchestrator/sidecar/). See the sidecar README for build and push instructions.
+
 ```bash
-docker build -f Dockerfile.sidecar -t dory-sidecar:1.0.0 .
+cd ../orchestrator/sidecar
+docker build --platform linux/amd64 -t dory-sidecar:latest .
 ```
 
 ---
@@ -273,7 +278,7 @@ docker build -f Dockerfile.sidecar -t dory-sidecar:1.0.0 .
 ### Step 1: Install SDK
 
 ```bash
-pip install dory-sdk[kubernetes]
+pip install dory-sdk[production]
 ```
 
 ### Step 2: Write Your Processor
@@ -314,13 +319,7 @@ kubectl apply -f k8s/
 helm install my-app ./helm/dory-processor --set image.repository=my-app
 ```
 
-**Option C: Use Kustomize**
-```bash
-# Edit kustomize/overlays/dev/kustomization.yaml to set your image
-kubectl apply -k kustomize/overlays/dev
-```
-
-**Option D: Manual Setup**
+**Option C: Manual Setup**
 
 1. Create RBAC:
 ```yaml
@@ -646,17 +645,23 @@ if __name__ == "__main__":
 
 ## Documentation
 
-- [Developer Guide](docs/DEVELOPER_GUIDE.md) - Advanced topics
+| Guide | Description |
+|-------|-------------|
+| [Quick Reference](docs/QUICK_REFERENCE.md) | 15-minute quick start |
+| [Configuration Guide](docs/CONFIGURATION_GUIDE.md) | Configuration and presets |
+| [Stateful Guide](docs/STATEFUL_GUIDE.md) | Stateful processing patterns |
+| [Developer Guide](docs/DEVELOPER_GUIDE.md) | Advanced topics |
 
 ## Examples
 
 | Example | Description | Pattern |
 |---------|-------------|---------|
+| [`dory-cloud-processor-py`](examples/dory-cloud-processor-py/) | **Complete SDK demo for cloud/managed nodes** | All SDK features: @stateful, CircuitBreaker, retry, OpenTelemetry, recovery |
+| [`dory-edge-processor-py`](examples/dory-edge-processor-py/) | **Complete SDK demo for edge nodes** | Edge features: FencingManager, HeartbeatManager, RoleManager, failover |
 | [`minimal-processor-py`](../examples/minimal-processor-py/) | Simplest possible processor (~95 lines) | `@stateful` + `run_loop()` |
 | [`dory-info-logger-py`](../examples/dory-info-logger-py/) | Full demo with HTTP dashboard | `@stateful` + fault hooks |
-| [`dory-edge-logger-py`](../examples/dory-edge-logger-py/) | Edge workload with DB logging | Manual state management |
 
-**Start here**: Use `minimal-processor-py` as a template for new processors.
+**Start here**: Use `dory-cloud-processor-py` for cloud deployments or `dory-edge-processor-py` for edge deployments. Both demonstrate ALL SDK capabilities.
 
 ## License
 

{dory_sdk-2.1.0.dist-info → dory_sdk-2.1.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-dory/__init__.py,sha256=n7CwUZzXdXvgax6kcNz3GHpOC5bCZab40PWkoLvkep0,1599
+dory/__init__.py,sha256=uVblQcWaULMmrqpOduepDwljKYlw5xJedP0r8vVGRkQ,2267
 dory/auto_instrument.py,sha256=8vKhOi0nXFuG0DN7KIFC20rzfNOZtbl0oAMxFvXd3hA,4689
 dory/decorators.py,sha256=q2eCjlP4LaTjpmJZt30pzx1J1mhuoQvpm4JrHkq8IsY,4384
 dory/py.typed,sha256=emnf6qe_Z56R1XIXFqsN16wUecXbya2eYibnwMfH2Ng,93
@@ -8,10 +8,10 @@ dory/cli/__init__.py,sha256=gz5g4VP5enbVTadWqqS_1Ys8-xMqPEmGB8AerouysVc,78
 dory/cli/main.py,sha256=c2bXolTE8wLs9PU4t9bg9SNPu4RojQ3M_0W54TWQvI4,7676
 dory/cli/templates.py,sha256=TvBUobvYwh20rTsMb3zbUvdXB57gH_OyA5KonWdD_Go,7820
 dory/config/__init__.py,sha256=mGgsgkFclIVyKs69kKZzRYe2FjC3JtzD9etIQvzLLRI,530
-dory/config/defaults.py,sha256=Ydh-2pEZbiUPpNfSrNviGPooYsZfirnKbF1iyYP-MJ8,1136
+dory/config/defaults.py,sha256=IFK5JfQtTr27duPLTQGT8WJhNUkBUIoqt0uAQDZbrSY,1510
 dory/config/loader.py,sha256=hQO37Sk1EYWbVD1E_Mb0FIjHRNupjiNoTf83CrhIe6I,11783
 dory/config/presets.py,sha256=SIGFLjfE4R39RLcX4PxH6eW7ewtnC5vlP3DO8y6bVsk,7848
-dory/config/schema.py,sha256=Ou4wythmd69t4XXZmooIHLDonx0xTVF7fMySfcJ1A2Y,4586
+dory/config/schema.py,sha256=npSD9qXC9WMDPhh2s8rx25c2AXrPUVJ462psVbB6NqE,5610
 dory/core/__init__.py,sha256=qN3cpZT2yqCbo_D7dcJYsLErY4LI-v1Na2ULq_wLt1g,614
 dory/core/app.py,sha256=SVTqVgtCYx629cmwh8nebBACKekX3sJJHQarza0YXBw,14173
 dory/core/context.py,sha256=92tIPIG4qCYRAyk0i-bFw2tZxY_1E1rFAJ82cSNIIhQ,7186
@@ -20,15 +20,22 @@ dory/core/meta.py,sha256=AkTzGrnClY75BIYPYTn7IpZKTvg5MV5-rprHjYC9Xu0,3827
 dory/core/modes.py,sha256=KpJioN170NyUfrKhyHPhAnNx4GP5inf57xetYBQeKLg,16658
 dory/core/processor.py,sha256=rjHRk-uSfmypKp0XbRrJLPVHo06QwdPaMRyvQs3Z_VM,24180
 dory/core/signals.py,sha256=cwsjvbKPT_-iyx6I2cKM8XedreEULfpUpfVoV1LTBx0,4205
+dory/edge/__init__.py,sha256=3EbWFzvaAbXRTboTynMiN9mh_D2pgqdIwNloOl7PwOI,1927
+dory/edge/adaptive.py,sha256=Dc4aRNEfe7fi37hJHeZ5HtmOcidItZXXMBsIxGg9BAw,22693
+dory/edge/detector.py,sha256=qcg4EghVRNdELa-d29ryDs48Otxp23pkW9Ed5DvMp5E,17602
+dory/edge/fencing.py,sha256=1hfeV8bPvsqF-9LJ-ZVOkVL_n_2Li1dpRllnJSXIsIc,15557
+dory/edge/heartbeat.py,sha256=74JR-RzQOv6Ok_F4h3HXMGo0YmJ_VcZtjYxkncnFklk,20227
+dory/edge/role.py,sha256=RrJ1wUCOb5XkobHTs_SYuH_UWqI1NX5ZVaBWDkblLU0,12850
 dory/errors/__init__.py,sha256=GgQfZ5XIrUvcbcOMq3iCQbO0S9SktV-t6lTRwLrvPzw,2440
 dory/errors/classification.py,sha256=WDXBKisd6rIkvXx13uo7G8PL7pf--6F07f7pELmvQyI,10826
 dory/errors/codes.py,sha256=0FIPSeBC-D0grMWMyPi5zCoojCTOVrIHuFFLNKi2dJw,14922
 dory/health/__init__.py,sha256=qBkKWmQrWAP7gIMlcYG2Rpu91BAZDDfS_rNCeOh8D0Y,228
 dory/health/probes.py,sha256=x4eLqj56Pm1RdqUEAwYlafA_UkjICFuoRPAtKAmj1Gg,6355
-dory/health/server.py,sha256=17vfNVRmkAcKKNF_LbOJOiMTzpe6pBAhOCf4D_konbk,10525
-dory/k8s/__init__.py,sha256=LpIiEV3yPmi9yeUsC0HAmWiFw0ih1XvN8NlAZb_Z0iU,259
+dory/health/server.py,sha256=6qYqA1OaNcIL7UwI5zUryqOV26dhsz5u7JZXXveE6Cw,21349
+dory/k8s/__init__.py,sha256=q1tshZhemvo-9Yx3vrjsjuwAFDpZAfiVMRwHtvkSxMQ,1804
 dory/k8s/annotation_watcher.py,sha256=jokUaU1sXMEHG1OO6E6IvoE_9nU9F9fPgbACskiv7b8,6019
 dory/k8s/client.py,sha256=5qeortOayciLGYkM1eqNLYDt1nZBDMrvLfRvtHfEKy0,6682
+dory/k8s/labels.py,sha256=kykB9oFhpOHCZECnR6wsjg24pfo4SqbtA40k_NRhL7E,16480
 dory/k8s/pod_metadata.py,sha256=GdbKwftBeJ7lRA69s8qjs1Qrz0Mx5dRpgdN3lhgl2pk,5487
 dory/logging/__init__.py,sha256=rvb6Gdc2KzhwtEOSiKz8_kgzW2oztMLX4zHivkm2fkQ,193
 dory/logging/logger.py,sha256=L7gYdgZQgJBscQWneIm7g4Rk742ImxpISWCfD7Pl7X4,4942
@@ -38,10 +45,13 @@ dory/middleware/__init__.py,sha256=LyklxfNSIWMDnayLLykU7IBkp5rAXD5UV2XPEZlfjNY,7
 dory/middleware/connection_tracker.py,sha256=gHadUF9EP3_sGt1Pp8rerytoLaDpEjIoQq50ZJb-s3U,19154
 dory/middleware/request_id.py,sha256=yfj92c87pJEO1p00_5xM_O4ShQPAQHvM_X7-Kmq87c0,9038
 dory/middleware/request_tracker.py,sha256=h9NqPQXcIgRUPMZC4amn4wJCxgyrq-bAqd3viY0wy1w,16004
-dory/migration/__init__.py,sha256=cUdZG-aWQj40ZaPqG7-ooREivFOrFrEbyvGbc_IlnRo,313
+dory/migration/__init__.py,sha256=Ig9wVbLIFnFklQPzsN-xR_1wqtSSw2W0owA0gTxjHgs,1549
 dory/migration/configmap.py,sha256=lNjbgURPuNnNiyBaRHQHBfmuwOLte7JRMeJyqNEpd1k,7680
+dory/migration/s3_store.py,sha256=4u_HXl7rbuo3e9_gSIGgT7icqsmBW6StmBG8I-LlQms,21596
 dory/migration/serialization.py,sha256=REMTknL_efjBt-YKY8DvSt-dDBZdkEfrVaAIn_wtPTk,4773
-dory/migration/state_manager.py,sha256=XqbLPbuRnMkOy3hXF_30yt9oqyKKM8nlneAoOnz9J0g,10710
+dory/migration/state_manager.py,sha256=YseDpzHS7sUfWAO9bqzB-cPBnEBz7DYZ6GVNTyc24-I,12507
+dory/migration/transfer.py,sha256=WDw02y4N50-j8tpJhSp1wR6hVCa9vg1i6nHLQSuq4HI,11906
+dory/migration/versioning.py,sha256=V-T7xKpXdPI0KqknwmWrnhGqm7sfDxGUyi0AhBFKMPM,24396
 dory/monitoring/__init__.py,sha256=q1MNgYySwpjBvdJnE8BFPdagit_zCdKNplyj6N5TTYU,432
 dory/monitoring/opentelemetry.py,sha256=mdbqPaLVTUItOOhbSTKExyUFwfxi8CtjEkYtzjALyhA,13614
 dory/recovery/__init__.py,sha256=PsSrR8kM1hAzVtb6aFw0ub1jMxd-TXxaEwJf3MhXNWc,1641
@@ -55,15 +65,12 @@ dory/recovery/state_validator.py,sha256=hE2M6buciiTctUVbV7acE11zXGrXSg2gHPIGOUvG
 dory/resilience/__init__.py,sha256=5SxTG4SGEMImLu4_PTjAk1ZY_kaisbkhq0g6speDdzU,945
 dory/resilience/circuit_breaker.py,sha256=blSUfUqyNLWcFNuB1dwQKQMzEWLjujs7qNVaaZidgjc,14920
 dory/resilience/retry.py,sha256=c5Gcg7koRAmMVWYxpHftxNqsOprkfzaZamxnTVZLoA0,12994
-dory/sidecar/__init__.py,sha256=eyAvtD5suu-4TlLrJy5wfC42wtAKFTVKeBQMZKp40Z0,197
-dory/sidecar/main.py,sha256=QXNqa3ulbaZ2qpVQnDCFZ845DgrCxQbH6PbrvzxWnDs,2028
-dory/sidecar/server.py,sha256=eAizFIJp9aRpN_uwt9ylWd5uuISmEaDslSrDm9SGHk8,12054
 dory/utils/__init__.py,sha256=44QY6SZdUq3Ht27k7e8LMpEArcWAoixPfchH0aRROgc,530
 dory/utils/errors.py,sha256=K3ofXRoTmGpXQ1WN836ut-WpvmT70obxRkNiYCk3EO0,1312
 dory/utils/retry.py,sha256=WVrEEkSF2NW8RM1oRv3sKWSJkwVdh4BPXvu7jUPcPHo,3055
 dory/utils/timeout.py,sha256=pDHpO1OfH9hfi8_-gUK2mEXTXb1outsTdAobO3jxbzs,2059
-dory_sdk-2.1.0.dist-info/METADATA,sha256=yTsEqHrg3PwI3VswHrPnFLDXyYZ4zkeXo6sYqK8jdzo,16699
-dory_sdk-2.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-dory_sdk-2.1.0.dist-info/entry_points.txt,sha256=9r2K0MclUnqanWdzbR-jlyXVNJYuE8ZvwuADiozi3Rw,89
-dory_sdk-2.1.0.dist-info/top_level.txt,sha256=lbgLxVkyGEP63BrBq53S9m0Mv7t-ZP-B0WHKTmOpOz0,5
-dory_sdk-2.1.0.dist-info/RECORD,,
+dory_sdk-2.1.4.dist-info/METADATA,sha256=5w2ObfxKEQUcjvMDmKMymz6tkE4vOYn1y-u71n5B7w0,17930
+dory_sdk-2.1.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+dory_sdk-2.1.4.dist-info/entry_points.txt,sha256=JtdjTIlmVvGH9F2TIPwQGtdxZOyv8xkxJSF9KeDT5UU,44
+dory_sdk-2.1.4.dist-info/top_level.txt,sha256=lbgLxVkyGEP63BrBq53S9m0Mv7t-ZP-B0WHKTmOpOz0,5
+dory_sdk-2.1.4.dist-info/RECORD,,

dory_sdk-2.1.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dory = dory.cli.main:main

dory/sidecar/__init__.py

@@ -1,6 +0,0 @@
-"""Dory Sidecar - Lightweight health proxy for non-SDK apps."""
-
-from dory.sidecar.server import SidecarServer
-from dory.sidecar.main import run_sidecar
-
-__all__ = ["SidecarServer", "run_sidecar"]

dory/sidecar/main.py

@@ -1,75 +0,0 @@
-"""Entry point for the Dory sidecar."""
-
-import asyncio
-import logging
-import os
-import signal
-import sys
-
-from dory.sidecar.server import SidecarServer, SidecarConfig
-
-
-def setup_logging() -> None:
-    """Configure logging for the sidecar."""
-    log_level = os.getenv("DORY_LOG_LEVEL", "INFO").upper()
-    log_format = os.getenv("DORY_LOG_FORMAT", "text")
-
-    if log_format == "json":
-        import json
-
-        class JsonFormatter(logging.Formatter):
-            def format(self, record):
-                return json.dumps({
-                    "timestamp": self.formatTime(record),
-                    "level": record.levelname,
-                    "logger": record.name,
-                    "message": record.getMessage(),
-                })
-
-        formatter = JsonFormatter()
-    else:
-        formatter = logging.Formatter(
-            "%(asctime)s [%(levelname)s] %(name)s: %(message)s"
-        )
-
-    handler = logging.StreamHandler(sys.stdout)
-    handler.setFormatter(formatter)
-
-    root_logger = logging.getLogger()
-    root_logger.addHandler(handler)
-    root_logger.setLevel(getattr(logging, log_level, logging.INFO))
-
-
-def run_sidecar() -> None:
-    """Run the sidecar server (CLI entry point)."""
-    setup_logging()
-    logger = logging.getLogger("dory.sidecar")
-
-    config = SidecarConfig.from_env()
-    server = SidecarServer(config)
-
-    loop = asyncio.new_event_loop()
-    asyncio.set_event_loop(loop)
-
-    # Handle shutdown signals
-    def handle_signal(sig):
-        logger.info(f"Received signal {sig}, shutting down...")
-        for task in asyncio.all_tasks(loop):
-            task.cancel()
-
-    for sig in (signal.SIGTERM, signal.SIGINT):
-        loop.add_signal_handler(sig, lambda s=sig: handle_signal(s))
-
-    try:
-        loop.run_until_complete(server.run_forever())
-    except asyncio.CancelledError:
-        pass
-    finally:
-        loop.run_until_complete(server.stop())
-        loop.close()
-
-    logger.info("Sidecar shutdown complete")
-
-
-if __name__ == "__main__":
-    run_sidecar()

dory/sidecar/server.py

@@ -1,329 +0,0 @@
-"""Sidecar health server that proxies health checks for non-SDK apps."""
-
-import asyncio
-import logging
-import os
-import time
-from dataclasses import dataclass, field
-from typing import Optional
-
-import aiohttp
-from aiohttp import web
-
-logger = logging.getLogger("dory.sidecar")
-
-
-@dataclass
-class SidecarConfig:
-    """Configuration for the sidecar server."""
-
-    # Sidecar health server port
-    health_port: int = 8080
-
-    # Main app configuration (optional - for health forwarding)
-    app_port: Optional[int] = None
-    app_host: str = "localhost"
-    app_health_path: Optional[str] = None  # e.g., "/health"
-    app_ready_path: Optional[str] = None   # e.g., "/ready"
-    app_prestop_path: Optional[str] = None # e.g., "/shutdown"
-
-    # Timeouts
-    app_check_timeout: float = 2.0
-    prestop_timeout: float = 25.0
-
-    # Behavior
-    ready_requires_app: bool = False  # If True, /ready fails if app doesn't respond
-
-    @classmethod
-    def from_env(cls) -> "SidecarConfig":
-        """Load configuration from environment variables."""
-        return cls(
-            health_port=int(os.getenv("DORY_HEALTH_PORT", "8080")),
-            app_port=int(os.getenv("DORY_APP_PORT")) if os.getenv("DORY_APP_PORT") else None,
-            app_host=os.getenv("DORY_APP_HOST", "localhost"),
-            app_health_path=os.getenv("DORY_APP_HEALTH_PATH"),
-            app_ready_path=os.getenv("DORY_APP_READY_PATH"),
-            app_prestop_path=os.getenv("DORY_APP_PRESTOP_PATH"),
-            app_check_timeout=float(os.getenv("DORY_APP_CHECK_TIMEOUT", "2.0")),
-            prestop_timeout=float(os.getenv("DORY_PRESTOP_TIMEOUT", "25.0")),
-            ready_requires_app=os.getenv("DORY_READY_REQUIRES_APP", "false").lower() == "true",
-        )
-
-
-class SidecarServer:
-    """
-    Lightweight sidecar server that provides Kubernetes health endpoints.
-
-    This allows apps without SDK integration to run in Dory by providing
-    the required health endpoints. Apps won't get state migration benefits,
-    but they will run normally.
-
-    Features:
-    - Always responds to /healthz (sidecar is alive)
-    - Optionally checks main app for /ready
-    - Optionally calls main app on /prestop
-    - Exposes basic /metrics
-    """
-
-    def __init__(self, config: Optional[SidecarConfig] = None):
-        self.config = config or SidecarConfig.from_env()
-        self._app: Optional[web.Application] = None
-        self._runner: Optional[web.AppRunner] = None
-        self._start_time = time.time()
-        self._ready = True
-        self._shutting_down = False
-        self._request_count = 0
-        self._app_check_failures = 0
-
-    async def _check_app_endpoint(self, path: str) -> tuple[bool, str]:
-        """Check if the main app responds on the given path."""
-        if not self.config.app_port:
-            return True, "No app port configured"
-
-        url = f"http://{self.config.app_host}:{self.config.app_port}{path}"
-
-        try:
-            timeout = aiohttp.ClientTimeout(total=self.config.app_check_timeout)
-            async with aiohttp.ClientSession(timeout=timeout) as session:
-                async with session.get(url) as response:
-                    if response.status < 400:
-                        return True, f"App responded with {response.status}"
-                    else:
-                        return False, f"App responded with {response.status}"
-        except asyncio.TimeoutError:
-            return False, "App health check timed out"
-        except aiohttp.ClientError as e:
-            return False, f"App connection failed: {e}"
-        except Exception as e:
-            return False, f"App check error: {e}"
-
-    async def _call_app_prestop(self) -> tuple[bool, str]:
-        """Call the main app's prestop endpoint if configured."""
-        if not self.config.app_port or not self.config.app_prestop_path:
-            return True, "No app prestop path configured"
-
-        url = f"http://{self.config.app_host}:{self.config.app_port}{self.config.app_prestop_path}"
-
-        try:
-            timeout = aiohttp.ClientTimeout(total=self.config.prestop_timeout)
-            async with aiohttp.ClientSession(timeout=timeout) as session:
-                async with session.get(url) as response:
-                    body = await response.text()
-                    return response.status < 400, f"App prestop returned {response.status}: {body}"
-        except Exception as e:
-            return False, f"App prestop failed: {e}"
-
-    async def handle_healthz(self, request: web.Request) -> web.Response:
-        """
-        Liveness probe - returns 200 if sidecar is running.
-
-        This always succeeds because if we can respond, we're alive.
-        The main app's health is checked separately via /ready if configured.
-        """
-        self._request_count += 1
-
-        return web.json_response({
-            "status": "healthy",
-            "sidecar": True,
-            "uptime_seconds": int(time.time() - self._start_time),
-        })
-
-    async def handle_ready(self, request: web.Request) -> web.Response:
-        """
-        Readiness probe - optionally checks main app health.
-
-        Behavior depends on configuration:
-        - If app_ready_path is set, checks that endpoint
-        - If app_health_path is set (and ready_path not), checks health endpoint
-        - If app_port is set (no paths), checks if port is accepting connections
-        - If ready_requires_app=true, fails if app check fails
-        - Otherwise, always returns ready
-        """
-        self._request_count += 1
-
-        if self._shutting_down:
-            return web.json_response(
-                {"status": "shutting_down", "ready": False},
-                status=503
-            )
-
-        # Determine which path to check
-        check_path = self.config.app_ready_path or self.config.app_health_path
-
-        app_ok = True
-        app_message = "No app check configured"
-
-        if self.config.app_port:
-            if check_path:
-                app_ok, app_message = await self._check_app_endpoint(check_path)
-            else:
-                # Just check if port is open
-                try:
-                    _, writer = await asyncio.wait_for(
-                        asyncio.open_connection(self.config.app_host, self.config.app_port),
-                        timeout=self.config.app_check_timeout
-                    )
-                    writer.close()
-                    await writer.wait_closed()
-                    app_ok = True
-                    app_message = "App port is accepting connections"
-                except Exception as e:
-                    app_ok = False
-                    app_message = f"App port not responding: {e}"
-
-        if not app_ok:
-            self._app_check_failures += 1
-
-        # Decide if we should report not ready
-        if not app_ok and self.config.ready_requires_app:
-            return web.json_response(
-                {
-                    "status": "not_ready",
-                    "ready": False,
-                    "app_status": app_message,
-                    "sidecar": True,
-                },
-                status=503
-            )
-
-        return web.json_response({
-            "status": "ready",
-            "ready": True,
-            "app_status": app_message,
-            "app_ok": app_ok,
-            "sidecar": True,
-        })
-
-    async def handle_prestop(self, request: web.Request) -> web.Response:
-        """
-        PreStop hook handler - signals graceful shutdown.
-
-        If app_prestop_path is configured, calls that endpoint to give
-        the main app a chance to clean up. Otherwise just marks as shutting down.
-
-        Note: Without SDK integration, no state will be saved.
-        """
-        self._request_count += 1
-        self._shutting_down = True
-        self._ready = False
-
-        logger.info("PreStop hook called - beginning graceful shutdown")
-
-        # Call app's prestop if configured
-        app_prestop_ok, app_prestop_message = await self._call_app_prestop()
-
-        if not app_prestop_ok:
-            logger.warning(f"App prestop failed: {app_prestop_message}")
-
-        return web.json_response({
-            "status": "shutting_down",
-            "app_prestop": app_prestop_message,
-            "state_saved": False,  # No state save without SDK
-            "sidecar": True,
-        })
-
-    async def handle_metrics(self, request: web.Request) -> web.Response:
-        """Prometheus metrics endpoint."""
-        self._request_count += 1
-
-        uptime = time.time() - self._start_time
-
-        metrics = f"""# HELP dory_sidecar_up Sidecar is running
-# TYPE dory_sidecar_up gauge
-dory_sidecar_up 1
-
-# HELP dory_sidecar_uptime_seconds Sidecar uptime in seconds
-# TYPE dory_sidecar_uptime_seconds gauge
-dory_sidecar_uptime_seconds {uptime:.2f}
-
-# HELP dory_sidecar_requests_total Total requests handled
-# TYPE dory_sidecar_requests_total counter
-dory_sidecar_requests_total {self._request_count}
-
-# HELP dory_sidecar_app_check_failures_total App health check failures
-# TYPE dory_sidecar_app_check_failures_total counter
-dory_sidecar_app_check_failures_total {self._app_check_failures}
-
-# HELP dory_sidecar_shutting_down Sidecar is shutting down
-# TYPE dory_sidecar_shutting_down gauge
-dory_sidecar_shutting_down {1 if self._shutting_down else 0}
-
-# HELP dory_sidecar_ready Sidecar ready status
-# TYPE dory_sidecar_ready gauge
-dory_sidecar_ready {1 if self._ready and not self._shutting_down else 0}
-"""
-        return web.Response(text=metrics, content_type="text/plain")
-
-    async def handle_state(self, request: web.Request) -> web.Response:
-        """
-        State endpoint - returns empty state for non-SDK apps.
-
-        This endpoint exists for compatibility but returns no state
-        since the app doesn't use the SDK for state management.
-        """
-        self._request_count += 1
-
-        if request.method == "GET":
-            return web.json_response({
-                "state": None,
-                "message": "No state available - app does not use Dory SDK",
-                "sidecar": True,
-            })
-        elif request.method == "POST":
-            return web.json_response({
-                "restored": False,
-                "message": "Cannot restore state - app does not use Dory SDK",
-                "sidecar": True,
-            })
-        else:
-            return web.json_response(
-                {"error": "Method not allowed"},
-                status=405
-            )
-
-    def _create_app(self) -> web.Application:
-        """Create the aiohttp application."""
-        app = web.Application()
-
-        app.router.add_get("/healthz", self.handle_healthz)
-        app.router.add_get("/ready", self.handle_ready)
-        app.router.add_get("/prestop", self.handle_prestop)
-        app.router.add_get("/metrics", self.handle_metrics)
-        app.router.add_get("/state", self.handle_state)
-        app.router.add_post("/state", self.handle_state)
-
-        return app
-
-    async def start(self) -> None:
-        """Start the sidecar server."""
-        self._app = self._create_app()
-        self._runner = web.AppRunner(self._app)
-        await self._runner.setup()
-
-        site = web.TCPSite(self._runner, "0.0.0.0", self.config.health_port)
-        await site.start()
-
-        logger.info(f"Dory sidecar started on port {self.config.health_port}")
-
-        if self.config.app_port:
-            logger.info(f"Monitoring app on {self.config.app_host}:{self.config.app_port}")
-        else:
-            logger.info("No app port configured - running in standalone mode")
-
-    async def stop(self) -> None:
-        """Stop the sidecar server."""
-        if self._runner:
-            await self._runner.cleanup()
-            logger.info("Dory sidecar stopped")
-
-    async def run_forever(self) -> None:
-        """Run the sidecar server until interrupted."""
-        await self.start()
-
-        try:
-            while True:
-                await asyncio.sleep(3600)
-        except asyncio.CancelledError:
-            pass
-        finally:
-            await self.stop()

dory_sdk-2.1.0.dist-info/entry_points.txt

@@ -1,3 +0,0 @@
-[console_scripts]
-dory = dory.cli.main:main
-dory-sidecar = dory.sidecar.main:run_sidecar