unstructured-platform-plugins 0.0.41__tar.gz → 0.0.44__tar.gz

{unstructured_platform_plugins-0.0.41 → unstructured_platform_plugins-0.0.44}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unstructured_platform_plugins
-Version: 0.0.41
+Version: 0.0.44
 Summary: Wrapper to convert arbitrary code into a uvicorn/fastapi implementation for Unstructured Platform
 License-File: LICENSE.md
 Classifier: Development Status :: 4 - Beta
@@ -29,6 +29,10 @@ Description-Content-Type: text/markdown
 # Unstructured Platform Plugins
  ![CI](https://github.com/Unstructured-IO/unstructured-platform-plugins/actions/workflows/ci.yml/badge.svg?branch=main)
 
+> **Deprecation notice:** `wrap_in_fastapi` (and the `etl-uvicorn` CLI it backs)
+> is deprecated. New plugins should build a FastAPI app directly with explicit
+> handlers for the plugin contract routes (`/invoke`, `/schema`, `/id`, etc.).
+
 Information about how to build custom plugins to integrate with Unstructured Platform.
 
 ## Plugin Development

{unstructured_platform_plugins-0.0.41 → unstructured_platform_plugins-0.0.44}/README.md

@@ -1,6 +1,10 @@
 # Unstructured Platform Plugins
  ![CI](https://github.com/Unstructured-IO/unstructured-platform-plugins/actions/workflows/ci.yml/badge.svg?branch=main)
 
+> **Deprecation notice:** `wrap_in_fastapi` (and the `etl-uvicorn` CLI it backs)
+> is deprecated. New plugins should build a FastAPI app directly with explicit
+> handlers for the plugin contract routes (`/invoke`, `/schema`, `/id`, etc.).
+
 Information about how to build custom plugins to integrate with Unstructured Platform.
 
 ## Plugin Development

unstructured_platform_plugins-0.0.44/unstructured_platform_plugins/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.0.44"  # pragma: no cover

{unstructured_platform_plugins-0.0.41 → unstructured_platform_plugins-0.0.44}/unstructured_platform_plugins/etl_uvicorn/api_generator.py

@@ -11,6 +11,7 @@ from fastapi.responses import StreamingResponse
 from opentelemetry.instrumentation.fastapi import FastAPIInstrumentor
 from pydantic import BaseModel, Field, create_model
 from starlette.responses import RedirectResponse
+from typing_extensions import deprecated
 from unstructured_ingest.data_types.file_data import BatchFileData, FileData, file_data_from_dict
 from unstructured_ingest.error import UnstructuredIngestError
 from uvicorn.config import LOG_LEVELS
@@ -108,6 +109,10 @@ def update_filedata_model(new_type) -> BaseModel:
     return new_filedata_model
 
 
+@deprecated(
+    "wrap_in_fastapi is deprecated; build a FastAPI app directly with "
+    "explicit handlers for the plugin contract routes."
+)
 def wrap_in_fastapi(
     func: Callable,
     plugin_id: str,

{unstructured_platform_plugins-0.0.41 → unstructured_platform_plugins-0.0.44}/unstructured_platform_plugins/etl_uvicorn/main.py

@@ -1,13 +1,34 @@
+import asyncio
+import signal
+import threading
 from dataclasses import dataclass, field
 from typing import IO, Any, Optional
 
 import click
+import uvicorn
 from uvicorn.config import LOGGING_CONFIG, Config, RawConfigParser
 from uvicorn.main import main, run
 
 from unstructured_platform_plugins.etl_uvicorn.api_generator import generate_fast_api
 
 
+def _install_signal_handlers_ignoring_sigterm(self: uvicorn.Server) -> None:
+    # uvicorn's default load-sheds 504 on SIGTERM, which races with controllers
+    # trying to drain in-flight work during pod shutdown. Plugin webservers are
+    # expected to outlive their controller container so SIGKILL — not SIGTERM —
+    # ends the process. SIGINT is preserved so local Ctrl-C still works.
+    if threading.current_thread() is not threading.main_thread():
+        return
+    try:
+        loop = asyncio.get_event_loop()
+        loop.add_signal_handler(signal.SIGINT, self.handle_exit, signal.SIGINT, None)
+    except NotImplementedError:
+        signal.signal(signal.SIGINT, self.handle_exit)
+
+
+uvicorn.Server.install_signal_handlers = _install_signal_handlers_ignoring_sigterm
+
+
 @dataclass
 class CustomConfig:
     log_config: dict[str, Any] | str | RawConfigParser | IO[Any] | None = field(

{unstructured_platform_plugins-0.0.41 → unstructured_platform_plugins-0.0.44}/unstructured_platform_plugins/etl_uvicorn/otel.py

@@ -30,9 +30,11 @@ def get_settings() -> OtelSettings:
     service_name = os.environ.get(OTEL_SERVICE_NAME, "unknown_service")
     trace_exporters = os.environ.get(OTEL_TRACES_EXPORTER)
     trace_exporters = trace_exporters.split(",") if trace_exporters else []
+    trace_exporters = [e for e in trace_exporters if e != "none"]
 
     metric_exporters = os.environ.get(OTEL_METRICS_EXPORTER)
     metric_exporters = metric_exporters.split(",") if metric_exporters else []
+    metric_exporters = [e for e in metric_exporters if e != "none"]
     return OtelSettings(
         service_name=service_name,
         trace_exporters=trace_exporters,
@@ -40,8 +42,11 @@ def get_settings() -> OtelSettings:
     )
 
 
-def get_trace_provider() -> TracerProvider:
+def get_trace_provider() -> TracerProvider | None:
     settings = get_settings()
+    if not settings["trace_exporters"]:
+        return None
+
     provider = TracerProvider(resource=Resource({SERVICE_NAME: settings["service_name"]}))
 
     for trace_exporter_type in settings["trace_exporters"]:
@@ -50,8 +55,11 @@ def get_trace_provider() -> TracerProvider:
     return provider
 
 
-def get_metric_provider() -> MeterProvider:
+def get_metric_provider() -> MeterProvider | None:
     settings = get_settings()
+    if not settings["metric_exporters"]:
+        return None
+
     readers = []
     for metric_exporter_type in settings["metric_exporters"]:
         readers.append(_get_metrics_reader(exporter_type=metric_exporter_type))

unstructured_platform_plugins-0.0.41/unstructured_platform_plugins/__version__.py

@@ -1 +0,0 @@
-__version__ = "0.0.41"  # pragma: no cover