tigrcorn-config 0.3.18.dev2__tar.gz → 0.3.18.dev3__tar.gz

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrcorn-config
-Version: 0.3.18.dev2
+Version: 0.3.18.dev3
 Summary: Typed configuration models, profiles, environment loading, and validation for the Tigrcorn ASGI/HTTP server stack.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License: Apache License
@@ -186,7 +186,7 @@ Classifier: Typing :: Typed
 Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: tigrcorn-core==0.3.18.dev2
+Requires-Dist: tigrcorn-core==0.3.18.dev3
 Provides-Extra: yaml
 Requires-Dist: PyYAML>=6.0; extra == "yaml"
 Dynamic: license-file
@@ -280,7 +280,7 @@ The package exposes its supported public surface through the <code>tigrcorn_conf
 
 ## Package Graph
 
-[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-quic-cc](https://pypi.org/project/tigrcorn-quic-cc/) | [tigrcorn-quic-cc-reno](https://pypi.org/project/tigrcorn-quic-cc-reno/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
 
 ## Best Practices
 

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/README.md

@@ -87,7 +87,7 @@ The package exposes its supported public surface through the <code>tigrcorn_conf
 
 ## Package Graph
 
-[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-quic-cc](https://pypi.org/project/tigrcorn-quic-cc/) | [tigrcorn-quic-cc-reno](https://pypi.org/project/tigrcorn-quic-cc-reno/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
 
 ## Best Practices
 

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tigrcorn-config"
-version = "0.3.18.dev2"
+version = "0.3.18.dev3"
 description = "Typed configuration models, profiles, environment loading, and validation for the Tigrcorn ASGI/HTTP server stack."
 readme = "README.md"
 requires-python = ">=3.10,<3.15"
@@ -28,7 +28,7 @@ classifiers = [
   "Topic :: Software Development :: Libraries :: Python Modules",
   "Typing :: Typed",
 ]
-dependencies = ["tigrcorn-core==0.3.18.dev2"]
+dependencies = ["tigrcorn-core==0.3.18.dev3"]
 
 [project.optional-dependencies]
 yaml = ["PyYAML>=6.0"]

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/env.py

@@ -76,11 +76,17 @@ _FLAT_ENV_MAP = {
     "QUIC_MAX_DATAGRAM_SIZE": ("quic", "max_datagram_size"),
     "QUIC_IDLE_TIMEOUT": ("quic", "idle_timeout"),
     "QUIC_EARLY_DATA_POLICY": ("quic", "early_data_policy"),
+    "QUIC_CONGESTION_CONTROL": ("quic", "congestion_control", "algorithm"),
+    "QUIC_CONGESTION_CONTROL_OPTIONS": ("quic", "congestion_control", "options"),
     "WEBTRANSPORT_MAX_SESSIONS": ("webtransport", "max_sessions"),
     "WEBTRANSPORT_MAX_STREAMS": ("webtransport", "max_streams"),
     "WEBTRANSPORT_MAX_DATAGRAM_SIZE": ("webtransport", "max_datagram_size"),
+    "WEBTRANSPORT_STREAM_RECEIVE_COALESCE_BYTES": ("webtransport", "stream_receive_coalesce_bytes"),
+    "WEBTRANSPORT_STREAM_RECEIVE_MAX_DELAY_MS": ("webtransport", "stream_receive_max_delay_ms"),
     "WEBTRANSPORT_ORIGIN": ("webtransport", "origins"),
     "WEBTRANSPORT_PATH": ("webtransport", "path"),
+    "WEBTRANSPORT_PROFILES": ("webtransport", "profiles"),
+    "WEBTRANSPORT_PREFERRED_PROFILE": ("webtransport", "preferred_profile"),
     "TIMEOUT_KEEP_ALIVE": ("http", "keep_alive_timeout"),
     "READ_TIMEOUT": ("http", "read_timeout"),
     "WRITE_TIMEOUT": ("http", "write_timeout"),

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/governance_surface.py

@@ -223,8 +223,6 @@ APPROVED_LEGACY_UNITTEST_FILES = (
     'tests/test_stream_probe_fixtures.py',
     'tests/test_websocket_uix_demo.py',
     'tests/test_webtransport_bidi_stream_context.py',
-    'tests/test_webtransport_feature_demo_app.py',
-    'tests/test_webtransport_feature_coverage.py',
     'tests/test_webtransport_mtls_demo.py',
     'tests/test_webtransport_mtls_demo_cleanup.py',
     'tests/test_webtransport_mtls_demo_runtime.py',
@@ -241,7 +239,9 @@ def scan_legacy_unittest_files(root: Path) -> list[str]:
     detected: list[str] = []
     for path in sorted(tests_root.glob('test_*.py')):
         text = path.read_text(encoding='utf-8')
-        if 'import unittest' in text or 'from unittest' in text:
+        # unittest.mock is a standalone mock utility and does not make a
+        # pytest module a legacy unittest test module.
+        if 'import unittest' in text or 'from unittest import' in text:
             detected.append(path.as_posix().split(root.as_posix() + '/', 1)[-1])
     return detected
 

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/load/listeners.py

@@ -120,3 +120,7 @@ def _apply_listener_quic_fields(ns: Namespace, listener: dict[str, Any]) -> None
         listener["max_datagram_size"] = ns.quic_max_datagram_size
     if ns.quic_secret is not None:
         listener["quic_secret"] = ns.quic_secret.encode("utf-8") if isinstance(ns.quic_secret, str) else ns.quic_secret
+    if getattr(ns, "quic_congestion_control", None) is not None:
+        listener.setdefault("congestion_control", {})["algorithm"] = ns.quic_congestion_control
+    if getattr(ns, "quic_congestion_control_options", None) is not None:
+        listener.setdefault("congestion_control", {})["options"] = dict(ns.quic_congestion_control_options)

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/load/mapping.py

@@ -7,7 +7,7 @@ from typing import Any, Mapping
 from tigrcorn_config.defaults import default_config
 from tigrcorn_config.files import load_config_source
 from tigrcorn_config.merge import merge_config_dicts
-from tigrcorn_config.model import ListenerConfig, ServerConfig
+from tigrcorn_config.model import CongestionControlConfig, ListenerConfig, ServerConfig
 from tigrcorn_config.normalize import normalize_config
 from tigrcorn_config.profiles import resolve_effective_profile_mapping, resolve_requested_profile
 from tigrcorn_config.validate import validate_config
@@ -40,6 +40,10 @@ def _apply_mapping(target: Any, data: Mapping[str, Any]) -> None:
                     _apply_mapping(listener, entry)
                     listeners.append(listener)
             setattr(target, key, listeners)
+        elif key == "congestion_control" and isinstance(value, Mapping):
+            congestion_control = CongestionControlConfig()
+            _apply_mapping(congestion_control, value)
+            setattr(target, key, congestion_control)
         elif dataclasses.is_dataclass(current) and isinstance(value, Mapping):
             _apply_mapping(current, value)
         else:

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/load/namespace.py

@@ -116,6 +116,10 @@ def _populate_special_blocks(
         blocks["websocket"]["enabled"] = not ns.disable_websocket
     if ns.quic_secret is not None:
         blocks["quic"]["quic_secret"] = ns.quic_secret.encode("utf-8") if isinstance(ns.quic_secret, str) else ns.quic_secret
+    if getattr(ns, "quic_congestion_control", None) is not None:
+        blocks["quic"].setdefault("congestion_control", {})["algorithm"] = ns.quic_congestion_control
+    if getattr(ns, "quic_congestion_control_options", None) is not None:
+        blocks["quic"].setdefault("congestion_control", {})["options"] = dict(ns.quic_congestion_control_options)
     if getattr(ns, "webtransport_origin", None):
         blocks["webtransport"]["origins"] = listify(ns.webtransport_origin)
 
@@ -195,7 +199,11 @@ _NAMESPACE_MAPPING: dict[str, tuple[str, str]] = {
     "webtransport_max_sessions": ("webtransport", "max_sessions"),
     "webtransport_max_streams": ("webtransport", "max_streams"),
     "webtransport_max_datagram_size": ("webtransport", "max_datagram_size"),
+    "webtransport_stream_receive_coalesce_bytes": ("webtransport", "stream_receive_coalesce_bytes"),
+    "webtransport_stream_receive_max_delay_ms": ("webtransport", "stream_receive_max_delay_ms"),
     "webtransport_path": ("webtransport", "path"),
+    "webtransport_profiles": ("webtransport", "profiles"),
+    "webtransport_preferred_profile": ("webtransport", "preferred_profile"),
     "log_level": ("logging", "level"),
     "access_log": ("logging", "access_log"),
     "access_log_file": ("logging", "access_log_file"),

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/load/public_api.py

@@ -62,8 +62,12 @@ def build_config(
     webtransport_max_sessions: int | None = None,
     webtransport_max_streams: int | None = None,
     webtransport_max_datagram_size: int | None = None,
+    webtransport_stream_receive_coalesce_bytes: int | None = None,
+    webtransport_stream_receive_max_delay_ms: int | None = None,
     webtransport_origins: list[str] | None = None,
     webtransport_path: str | None = None,
+    webtransport_profiles: list[str] | None = None,
+    webtransport_preferred_profile: str | None = None,
     pipe_mode: str = "rawframed",
     config: Mapping[str, Any] | None = None,
     default_headers: list[str] | list[tuple[str, str]] | None = None,
@@ -99,8 +103,12 @@ def build_config(
         webtransport_max_sessions=webtransport_max_sessions,
         webtransport_max_streams=webtransport_max_streams,
         webtransport_max_datagram_size=webtransport_max_datagram_size,
+        webtransport_stream_receive_coalesce_bytes=webtransport_stream_receive_coalesce_bytes,
+        webtransport_stream_receive_max_delay_ms=webtransport_stream_receive_max_delay_ms,
         webtransport_origins=webtransport_origins,
         webtransport_path=webtransport_path,
+        webtransport_profiles=webtransport_profiles,
+        webtransport_preferred_profile=webtransport_preferred_profile,
     )
     effective_websocket_enabled = True if websocket is None and direct_runtime_customized else bool(websocket)
     effective_h2c_enabled = _effective_h2c_enabled(enable_h2c, requested_http_versions)
@@ -156,8 +164,12 @@ def build_config(
         webtransport_max_sessions=webtransport_max_sessions,
         webtransport_max_streams=webtransport_max_streams,
         webtransport_max_datagram_size=webtransport_max_datagram_size,
+        webtransport_stream_receive_coalesce_bytes=webtransport_stream_receive_coalesce_bytes,
+        webtransport_stream_receive_max_delay_ms=webtransport_stream_receive_max_delay_ms,
         webtransport_origins=webtransport_origins,
         webtransport_path=webtransport_path,
+        webtransport_profiles=webtransport_profiles,
+        webtransport_preferred_profile=webtransport_preferred_profile,
     )
     _apply_listener_override_if_needed(
         overrides,
@@ -184,8 +196,12 @@ def build_config(
         webtransport_max_sessions=webtransport_max_sessions,
         webtransport_max_streams=webtransport_max_streams,
         webtransport_max_datagram_size=webtransport_max_datagram_size,
+        webtransport_stream_receive_coalesce_bytes=webtransport_stream_receive_coalesce_bytes,
+        webtransport_stream_receive_max_delay_ms=webtransport_stream_receive_max_delay_ms,
         webtransport_origins=webtransport_origins,
         webtransport_path=webtransport_path,
+        webtransport_profiles=webtransport_profiles,
+        webtransport_preferred_profile=webtransport_preferred_profile,
     )
     _apply_optional_http_overrides(
         overrides,
@@ -227,8 +243,12 @@ def _direct_runtime_customized(**values: Any) -> bool:
         or values["webtransport_max_sessions"] is not None
         or values["webtransport_max_streams"] is not None
         or values["webtransport_max_datagram_size"] is not None
+        or values["webtransport_stream_receive_coalesce_bytes"] is not None
+        or values["webtransport_stream_receive_max_delay_ms"] is not None
         or values["webtransport_origins"] is not None
         or values["webtransport_path"] is not None
+        or values["webtransport_profiles"] is not None
+        or values["webtransport_preferred_profile"] is not None
     )
 
 

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/load/public_helpers.py

@@ -56,8 +56,12 @@ def apply_webtransport_overrides(
     webtransport_max_sessions: int | None,
     webtransport_max_streams: int | None,
     webtransport_max_datagram_size: int | None,
+    webtransport_stream_receive_coalesce_bytes: int | None,
+    webtransport_stream_receive_max_delay_ms: int | None,
     webtransport_origins: list[str] | None,
     webtransport_path: str | None,
+    webtransport_profiles: list[str] | None,
+    webtransport_preferred_profile: str | None,
 ) -> None:
     if any(
         value is not None
@@ -65,16 +69,32 @@ def apply_webtransport_overrides(
             webtransport_max_sessions,
             webtransport_max_streams,
             webtransport_max_datagram_size,
+            webtransport_stream_receive_coalesce_bytes,
+            webtransport_stream_receive_max_delay_ms,
             webtransport_origins,
             webtransport_path,
+            webtransport_profiles,
+            webtransport_preferred_profile,
         )
     ):
         overrides["webtransport"] = {
             "max_sessions": webtransport_max_sessions,
             "max_streams": webtransport_max_streams,
             "max_datagram_size": webtransport_max_datagram_size,
+            **(
+                {"stream_receive_coalesce_bytes": webtransport_stream_receive_coalesce_bytes}
+                if webtransport_stream_receive_coalesce_bytes is not None
+                else {}
+            ),
+            **(
+                {"stream_receive_max_delay_ms": webtransport_stream_receive_max_delay_ms}
+                if webtransport_stream_receive_max_delay_ms is not None
+                else {}
+            ),
             "origins": webtransport_origins or [],
             "path": webtransport_path,
+            "profiles": webtransport_profiles or [],
+            "preferred_profile": webtransport_preferred_profile,
         }
 
 
@@ -94,8 +114,12 @@ def apply_listener_override_if_needed(overrides: dict[str, Any], **values: Any)
         or values["webtransport_max_sessions"] is not None
         or values["webtransport_max_streams"] is not None
         or values["webtransport_max_datagram_size"] is not None
+        or values["webtransport_stream_receive_coalesce_bytes"] is not None
+        or values["webtransport_stream_receive_max_delay_ms"] is not None
         or values["webtransport_origins"] is not None
         or values["webtransport_path"] is not None
+        or values["webtransport_profiles"] is not None
+        or values["webtransport_preferred_profile"] is not None
     )
     if not listener_customized:
         return

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/model/__init__.py

@@ -6,13 +6,14 @@ from .observability import LoggingConfig, MetricsConfig
 from .scheduler import SchedulerConfig
 from .security import ProxyConfig, TLSConfig
 from .server import ServerConfig
-from .transports import ListenerConfig, QUICConfig, WebTransportConfig
+from .transports import CongestionControlConfig, ListenerConfig, QUICConfig, WebTransportConfig
 from .types import AppInterface, ClaimClass, ListenerKind, ProtocolName
 
 __all__ = [
     "AppConfig",
     "AppInterface",
     "ClaimClass",
+    "CongestionControlConfig",
     "HTTPConfig",
     "HooksConfig",
     "ListenerConfig",

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/model/transports.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass, field
-from typing import Literal
+from typing import Any, Literal
 
 from tigrcorn_core.constants import (
     DEFAULT_BACKLOG,
@@ -15,6 +15,12 @@ from tigrcorn_core.constants import (
 from .types import ListenerKind
 
 
+@dataclass(slots=True)
+class CongestionControlConfig:
+    algorithm: str | None = None
+    options: dict[str, Any] = field(default_factory=dict)
+
+
 @dataclass(slots=True)
 class QUICConfig:
     quic_secret: bytes | None = None
@@ -22,13 +28,22 @@ class QUICConfig:
     max_datagram_size: int = DEFAULT_MAX_DATAGRAM_SIZE
     idle_timeout: float = DEFAULT_IDLE_TIMEOUT
     early_data_policy: Literal["allow", "deny", "require"] = "deny"
+    congestion_control: CongestionControlConfig = field(
+        default_factory=lambda: CongestionControlConfig(algorithm="reno")
+    )
 
 
 @dataclass(slots=True)
 class WebTransportConfig:
+    enabled: bool = False
+    compatibility: Literal["current", "draft13"] = "current"
+    profiles: list[str] = field(default_factory=list)
+    preferred_profile: str | None = None
     max_sessions: int | None = None
     max_streams: int | None = None
     max_datagram_size: int | None = None
+    stream_receive_coalesce_bytes: int = 16 * 1024
+    stream_receive_max_delay_ms: int = 5
     origins: list[str] = field(default_factory=list)
     path: str | None = None
 
@@ -69,6 +84,7 @@ class ListenerConfig:
     quic_secret: bytes | None = None
     quic_require_retry: bool = False
     max_datagram_size: int = DEFAULT_MAX_DATAGRAM_SIZE
+    congestion_control: CongestionControlConfig | None = None
     pipe_mode: Literal["rawframed", "stream"] = DEFAULT_PIPE_MODE
     user: str | int | None = None
     group: str | int | None = None

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/normalize.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import secrets
 
-from tigrcorn_config.model import ListenerConfig, ServerConfig
+from tigrcorn_config.model import CongestionControlConfig, ListenerConfig, ServerConfig
 from tigrcorn_core.constants import (
     DEFAULT_HTTP2_INITIAL_CONNECTION_WINDOW_SIZE,
     DEFAULT_HTTP2_INITIAL_STREAM_WINDOW_SIZE,
@@ -90,6 +90,55 @@ def normalize_config(config: ServerConfig) -> None:
         config.webtransport.max_streams = int(config.webtransport.max_streams)
     if config.webtransport.max_datagram_size is not None:
         config.webtransport.max_datagram_size = int(config.webtransport.max_datagram_size)
+    config.webtransport.stream_receive_coalesce_bytes = int(
+        config.webtransport.stream_receive_coalesce_bytes
+    )
+    config.webtransport.stream_receive_max_delay_ms = int(
+        config.webtransport.stream_receive_max_delay_ms
+    )
+    config.webtransport.enabled = bool(config.webtransport.enabled)
+    config.quic.congestion_control.algorithm = str(
+        config.quic.congestion_control.algorithm or "reno"
+    ).strip().lower()
+    config.quic.congestion_control.options = dict(
+        config.quic.congestion_control.options or {}
+    )
+    config.webtransport.compatibility = str(config.webtransport.compatibility or 'current').strip().lower()
+    aliases = {'current': 'ietf-current', 'chromium': 'draft02'}
+    configured_profiles = [
+        aliases.get(str(value).strip().lower(), str(value).strip().lower())
+        for value in _ensure_list(config.webtransport.profiles)
+        if str(value).strip()
+    ]
+    if (
+        config.webtransport.compatibility == 'draft13'
+        and configured_profiles in (
+            ['ietf-current'],
+            ['draft02', 'draft13', 'ietf-current'],
+        )
+        and config.webtransport.preferred_profile in {None, 'ietf-current', 'current'}
+    ):
+        configured_profiles = ['draft13']
+        config.webtransport.preferred_profile = 'draft13'
+    if not configured_profiles:
+        configured_profiles = (
+            ['draft13']
+            if config.webtransport.compatibility == 'draft13'
+            else ['draft02', 'draft13', 'ietf-current']
+        )
+    config.webtransport.profiles = list(dict.fromkeys(configured_profiles))
+    preferred = str(config.webtransport.preferred_profile or '').strip().lower()
+    if preferred:
+        preferred = aliases.get(preferred, preferred)
+    else:
+        preferred = (
+            'ietf-current'
+            if 'ietf-current' in config.webtransport.profiles
+            else config.webtransport.profiles[0]
+        )
+    config.webtransport.preferred_profile = preferred
+    if preferred in {'ietf-current', 'draft13'}:
+        config.webtransport.compatibility = 'draft13' if preferred == 'draft13' else 'current'
     config.webtransport.origins = [str(v).strip() for v in _ensure_list(config.webtransport.origins) if str(v).strip()]
     if config.webtransport.path is not None:
         path = str(config.webtransport.path).strip()
@@ -218,7 +267,10 @@ def normalize_config(config: ServerConfig) -> None:
                     listener.protocols.append("websocket")
         listener.websocket = config.websocket.enabled if listener.websocket else listener.websocket
         if listener.kind == "udp":
+            if config.webtransport.enabled and "webtransport" not in listener.protocols:
+                listener.protocols.append("webtransport")
             if "webtransport" in listener.protocols:
+                config.webtransport.enabled = True
                 if "quic" not in listener.protocols:
                     listener.protocols.insert(0, "quic")
                 if "http3" not in listener.protocols:
@@ -229,6 +281,16 @@ def normalize_config(config: ServerConfig) -> None:
             if "http3" in listener.protocols and "quic" not in listener.protocols:
                 listener.protocols.insert(0, "quic")
             listener.max_datagram_size = int(config.quic.max_datagram_size or listener.max_datagram_size)
+            listener_cc = listener.congestion_control or CongestionControlConfig()
+            listener.congestion_control = CongestionControlConfig(
+                algorithm=str(
+                    listener_cc.algorithm or config.quic.congestion_control.algorithm
+                ).strip().lower(),
+                options={
+                    **config.quic.congestion_control.options,
+                    **dict(listener_cc.options or {}),
+                },
+            )
             listener.quic_require_retry = bool(config.quic.require_retry or listener.quic_require_retry)
             listener.quic_secret = listener.quic_secret or config.quic.quic_secret or secrets.token_bytes(32)
         if not listener.scheme:

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/observability_surface.py

@@ -28,10 +28,22 @@ METRICS_SCHEMA = {
         'loss': [
             'quic_packets_lost',
             'quic_pto_expirations',
+            'quic_pto_probes',
+            'quic_stream_bytes_retransmitted',
+            'quic_crypto_bytes_retransmitted',
+            'quic_datagram_frames_abandoned',
+            'quic_frames_regenerated',
             'quic_path_challenges',
             'quic_path_responses',
             'quic_path_migrations',
         ],
+        'congestion': [
+            'quic_bytes_in_flight',
+            'quic_congestion_window_bytes',
+            'quic_smoothed_rtt_seconds',
+            'quic_pacing_rate_bytes_per_second',
+            'quic_pending_outbound_datagrams',
+        ],
         'http3': [
             'http3_requests_served',
             'http3_stream_resets',
@@ -45,6 +57,11 @@ METRICS_SCHEMA = {
         'active_connections',
         'active_websocket_connections',
         'active_quic_sessions',
+        'quic_bytes_in_flight',
+        'quic_congestion_window_bytes',
+        'quic_smoothed_rtt_seconds',
+        'quic_pacing_rate_bytes_per_second',
+        'quic_pending_outbound_datagrams',
     ],
     'notes': {
         'aggregation': 'Counters are monotonic totals; gauges report current in-process state.',

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/quic_surface.py

@@ -94,6 +94,8 @@ QUIC_FLAG_HELP: dict[str, str] = {
     '--quic-max-datagram-size': 'Maximum QUIC UDP payload size advertised and accepted by package-owned QUIC listeners',
     '--quic-idle-timeout': 'QUIC idle timeout in seconds for package-owned UDP listeners',
     '--quic-early-data-policy': 'QUIC early-data policy: deny, allow, or require with 425 downgrade handling',
+    '--quic-congestion-control': 'Installed QUIC congestion-control provider id (default: reno)',
+    '--quic-congestion-control-options': 'JSON object passed to the selected QUIC congestion-control provider at listener startup',
 }
 
 

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config/validate.py

@@ -11,6 +11,7 @@ from tigrcorn_observability.metrics import parse_statsd_host
 from tigrcorn_observability.tracing import validate_otel_endpoint
 from tigrcorn_core.errors import ConfigError
 from tigrcorn_config.profiles import list_blessed_profiles
+from tigrcorn_protocols.webtransport.profiles import profile_registry
 
 _ALLOWED_PROTOCOLS = {"http1", "http2", "http3", "quic", "websocket", "webtransport", "rawframed", "custom"}
 _ALLOWED_WORKER_CLASSES = {"local", "process", *SUPPORTED_WORKER_CLASS_ALIASES}
@@ -23,7 +24,20 @@ def _require_positive(name: str, value: int | float | None) -> None:
 
 
 def validate_config(config: ServerConfig) -> None:
+    if config.webtransport.compatibility not in {'current', 'draft13'}:
+        raise ConfigError("webtransport.compatibility must be 'current' or 'draft13'")
     normalize_config(config)
+    registry = profile_registry()
+    if config.webtransport.enabled and not config.webtransport.profiles:
+        raise ConfigError('webtransport.profiles must not be empty when WebTransport is enabled')
+    unknown_profiles = [name for name in config.webtransport.profiles if name not in registry]
+    if unknown_profiles:
+        raise ConfigError(f"unsupported WebTransport profiles: {', '.join(unknown_profiles)}")
+    if config.webtransport.preferred_profile not in config.webtransport.profiles:
+        raise ConfigError('webtransport.preferred_profile must be included in webtransport.profiles')
+    unavailable = [name for name in config.webtransport.profiles if not registry[name].implemented]
+    if unavailable:
+        raise ConfigError(f"WebTransport profiles are not implemented: {', '.join(unavailable)}")
     if config.app.profile is not None and config.app.profile not in set(list_blessed_profiles()):
         raise ConfigError(f"unsupported app.profile: {config.app.profile!r}")
     if config.app.interface not in {"auto", "tigr-asgi-contract", "asgi3"}:
@@ -88,6 +102,7 @@ def validate_config(config: ServerConfig) -> None:
         "webtransport.max_sessions": config.webtransport.max_sessions,
         "webtransport.max_streams": config.webtransport.max_streams,
         "webtransport.max_datagram_size": config.webtransport.max_datagram_size,
+        "webtransport.stream_receive_coalesce_bytes": config.webtransport.stream_receive_coalesce_bytes,
         "tls.ocsp_cache_size": config.tls.ocsp_cache_size,
         "scheduler.limit_concurrency": config.scheduler.limit_concurrency,
         "scheduler.max_connections": config.scheduler.max_connections,
@@ -97,6 +112,11 @@ def validate_config(config: ServerConfig) -> None:
     }.items():
         _require_positive(field_name, value)
 
+    if config.webtransport.stream_receive_max_delay_ms < 0:
+        raise ConfigError(
+            "webtransport.stream_receive_max_delay_ms must be nonnegative"
+        )
+
     if config.http.alt_svc_max_age < 0:
         raise ConfigError('http.alt_svc_max_age must be non-negative')
     if not (16_384 <= config.http.http2_max_frame_size <= 16_777_215):
@@ -119,6 +139,8 @@ def validate_config(config: ServerConfig) -> None:
         raise ConfigError(f"unsupported websocket compression mode: {config.websocket.compression!r}")
     if config.quic.early_data_policy not in {"allow", "deny", "require"}:
         raise ConfigError(f"unsupported quic early data policy: {config.quic.early_data_policy!r}")
+    if not config.quic.congestion_control.algorithm:
+        raise ConfigError("quic.congestion_control.algorithm must not be empty")
     if config.quic.quic_secret is not None and len(config.quic.quic_secret) == 0:
         raise ConfigError('quic.quic_secret must not be empty when provided')
     if config.webtransport.path is not None and not config.webtransport.path.startswith('/'):
@@ -213,6 +235,8 @@ def validate_config(config: ServerConfig) -> None:
                 raise ConfigError("max_datagram_size must be positive for udp listeners")
             if listener.quic_secret is not None and len(listener.quic_secret) == 0:
                 raise ConfigError('udp listener quic_secret must not be empty when provided')
+            if listener.congestion_control is None or not listener.congestion_control.algorithm:
+                raise ConfigError("udp listener congestion_control.algorithm must not be empty")
             if "http3" in listener.enabled_protocols and "quic" not in listener.enabled_protocols:
                 raise ConfigError("http3 requires quic on udp listeners")
             if "webtransport" in listener.enabled_protocols:
@@ -220,6 +244,8 @@ def validate_config(config: ServerConfig) -> None:
                     raise ConfigError("webtransport requires quic and http3 on udp listeners")
                 if "3" not in listener.http_versions:
                     raise ConfigError("webtransport requires HTTP/3 on udp listeners")
+                if listener.alpn_protocols and 'h3' not in listener.alpn_protocols:
+                    raise ConfigError("webtransport requires h3 ALPN on udp listeners")
             if listener.ssl_ca_certs and not listener.ssl_enabled:
                 raise ConfigError("ssl_ca_certs requires ssl_certfile and ssl_keyfile on udp listeners")
             if listener.ssl_require_client_cert:

{tigrcorn_config-0.3.18.dev2 → tigrcorn_config-0.3.18.dev3}/src/tigrcorn_config.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrcorn-config
-Version: 0.3.18.dev2
+Version: 0.3.18.dev3
 Summary: Typed configuration models, profiles, environment loading, and validation for the Tigrcorn ASGI/HTTP server stack.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License: Apache License
@@ -186,7 +186,7 @@ Classifier: Typing :: Typed
 Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: tigrcorn-core==0.3.18.dev2
+Requires-Dist: tigrcorn-core==0.3.18.dev3
 Provides-Extra: yaml
 Requires-Dist: PyYAML>=6.0; extra == "yaml"
 Dynamic: license-file
@@ -280,7 +280,7 @@ The package exposes its supported public surface through the <code>tigrcorn_conf
 
 ## Package Graph
 
-[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-quic-cc](https://pypi.org/project/tigrcorn-quic-cc/) | [tigrcorn-quic-cc-reno](https://pypi.org/project/tigrcorn-quic-cc-reno/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
 
 ## Best Practices
 

tigrcorn_config-0.3.18.dev3/src/tigrcorn_config.egg-info/requires.txt

@@ -0,0 +1,4 @@
+tigrcorn-core==0.3.18.dev3
+
+[yaml]
+PyYAML>=6.0

tigrcorn_config-0.3.18.dev2/src/tigrcorn_config.egg-info/requires.txt

@@ -1,4 +0,0 @@
-tigrcorn-core==0.3.18.dev2
-
-[yaml]
-PyYAML>=6.0