tigrcorn-quic-cc 0.3.18.dev3__py3-none-any.whl

tigrcorn_quic_cc/__init__.py

@@ -0,0 +1,60 @@
+from .api import Clock, CongestionController, CongestionControllerFactory
+from .discovery import ProviderRegistry
+from .errors import (
+    CongestionControlError,
+    InvalidControllerOutput,
+    ProviderCompatibilityError,
+    ProviderConfigurationError,
+    ProviderDiscoveryError,
+)
+from .models import (
+    API_VERSION,
+    ENTRY_POINT_GROUP,
+    AckReceived,
+    ControllerContext,
+    ControllerSnapshot,
+    EcnFeedback,
+    MtuUpdated,
+    PacketInfo,
+    PacketSent,
+    PacketsLost,
+    PersistentCongestion,
+    ProviderMetadata,
+    SendLimits,
+)
+from .testing import DeterministicClock, collect_send_limits
+from .validation import (
+    validate_factory,
+    validate_provider_metadata,
+    validate_send_limits,
+)
+
+__all__ = [
+    "API_VERSION",
+    "ENTRY_POINT_GROUP",
+    "AckReceived",
+    "Clock",
+    "CongestionControlError",
+    "CongestionController",
+    "CongestionControllerFactory",
+    "ControllerContext",
+    "ControllerSnapshot",
+    "DeterministicClock",
+    "EcnFeedback",
+    "InvalidControllerOutput",
+    "MtuUpdated",
+    "PacketInfo",
+    "PacketSent",
+    "PacketsLost",
+    "PersistentCongestion",
+    "ProviderCompatibilityError",
+    "ProviderConfigurationError",
+    "ProviderDiscoveryError",
+    "ProviderMetadata",
+    "ProviderRegistry",
+    "SendLimits",
+    "collect_send_limits",
+    "validate_factory",
+    "validate_provider_metadata",
+    "validate_send_limits",
+]

tigrcorn_quic_cc/api.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping
+from typing import Protocol, runtime_checkable
+
+from .models import (
+    AckReceived,
+    ControllerContext,
+    ControllerSnapshot,
+    EcnFeedback,
+    MtuUpdated,
+    PacketSent,
+    PacketsLost,
+    PersistentCongestion,
+    ProviderMetadata,
+    SendLimits,
+)
+
+Clock = Callable[[], float]
+
+
+@runtime_checkable
+class CongestionController(Protocol):
+    def on_packet_sent(self, event: PacketSent) -> None: ...
+
+    def on_ack_received(self, event: AckReceived) -> None: ...
+
+    def on_packets_lost(self, event: PacketsLost) -> None: ...
+
+    def on_persistent_congestion(self, event: PersistentCongestion) -> None: ...
+
+    def on_ecn_feedback(self, event: EcnFeedback) -> None: ...
+
+    def on_mtu_updated(self, event: MtuUpdated) -> None: ...
+
+    def send_limits(self, now: float) -> SendLimits: ...
+
+    def snapshot(self) -> ControllerSnapshot: ...
+
+
+@runtime_checkable
+class CongestionControllerFactory(Protocol):
+    @property
+    def metadata(self) -> ProviderMetadata: ...
+
+    def validate_options(self, options: Mapping[str, object]) -> Mapping[str, object]: ...
+
+    def create(
+        self,
+        context: ControllerContext,
+        options: Mapping[str, object],
+        *,
+        clock: Clock | None = None,
+    ) -> CongestionController: ...

tigrcorn_quic_cc/discovery.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from collections.abc import Iterable, Mapping
+from importlib import metadata as importlib_metadata
+
+from .api import CongestionControllerFactory
+from .errors import ProviderDiscoveryError
+from .models import ENTRY_POINT_GROUP, ProviderMetadata
+from .validation import validate_factory
+
+
+def _entry_points() -> tuple[importlib_metadata.EntryPoint, ...]:
+    discovered = importlib_metadata.entry_points()
+    selected: Iterable[importlib_metadata.EntryPoint]
+    if hasattr(discovered, "select"):
+        selected = discovered.select(group=ENTRY_POINT_GROUP)
+    else:  # pragma: no cover - Python/importlib compatibility
+        selected = discovered.get(ENTRY_POINT_GROUP, ())
+    return tuple(selected)
+
+
+class ProviderRegistry:
+    """Discover providers without importing algorithms that were not selected."""
+
+    def __init__(
+        self,
+        *,
+        entry_points: Iterable[importlib_metadata.EntryPoint] | None = None,
+        builtins: Mapping[str, CongestionControllerFactory] | None = None,
+    ) -> None:
+        self._entry_points = tuple(_entry_points() if entry_points is None else entry_points)
+        self._builtins = dict(builtins or {})
+
+    def provider_names(self) -> tuple[str, ...]:
+        return tuple(sorted(set(self._builtins) | {item.name for item in self._entry_points}))
+
+    def resolve(self, algorithm_id: str) -> CongestionControllerFactory:
+        builtin = self._builtins.get(algorithm_id)
+        candidates = [item for item in self._entry_points if item.name == algorithm_id]
+        if builtin is not None and candidates:
+            raise ProviderDiscoveryError(
+                f"duplicate congestion-controller provider id: {algorithm_id!r}"
+            )
+        if len(candidates) > 1:
+            raise ProviderDiscoveryError(
+                f"duplicate congestion-controller provider id: {algorithm_id!r}"
+            )
+        if builtin is not None:
+            return validate_factory(builtin)
+        if not candidates:
+            raise ProviderDiscoveryError(
+                f"congestion-controller provider is not installed: {algorithm_id!r}"
+            )
+        loaded = candidates[0].load()
+        factory = loaded() if isinstance(loaded, type) else loaded
+        return validate_factory(factory)
+
+    def metadata(self, algorithm_id: str) -> ProviderMetadata:
+        return self.resolve(algorithm_id).metadata

tigrcorn_quic_cc/errors.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+
+class CongestionControlError(RuntimeError):
+    """Base error for the QUIC congestion-controller extension surface."""
+
+
+class ProviderDiscoveryError(CongestionControlError):
+    """Raised when a selected provider cannot be resolved unambiguously."""
+
+
+class ProviderCompatibilityError(CongestionControlError):
+    """Raised when provider metadata is incompatible with this API major."""
+
+
+class ProviderConfigurationError(CongestionControlError):
+    """Raised when provider options are invalid."""
+
+
+class InvalidControllerOutput(CongestionControlError):
+    """Raised when a provider returns unsafe or malformed send limits."""

tigrcorn_quic_cc/models.py

@@ -0,0 +1,110 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from dataclasses import dataclass, field
+from types import MappingProxyType
+
+API_VERSION = "1"
+ENTRY_POINT_GROUP = "tigrcorn.quic_cc.v1"
+
+
+@dataclass(frozen=True, slots=True)
+class PacketInfo:
+    packet_number: int
+    sent_time: float
+    bytes_sent: int
+    ack_eliciting: bool = True
+    packet_space: str = "application"
+
+
+@dataclass(frozen=True, slots=True)
+class ControllerContext:
+    max_datagram_size: int
+    initial_rtt: float = 0.333
+    max_ack_delay: float = 0.025
+
+
+@dataclass(frozen=True, slots=True)
+class PacketSent:
+    now: float
+    packet: PacketInfo
+    bytes_in_flight: int
+    application_limited: bool = False
+
+
+@dataclass(frozen=True, slots=True)
+class AckReceived:
+    now: float
+    packets: tuple[PacketInfo, ...]
+    bytes_acked: int
+    bytes_in_flight: int
+    latest_rtt: float
+    min_rtt: float
+    smoothed_rtt: float
+    rttvar: float
+    application_limited: bool = False
+    delivery_rate: float | None = None
+    ecn_counts: tuple[int, int, int] | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class PacketsLost:
+    now: float
+    packets: tuple[PacketInfo, ...]
+    bytes_lost: int
+    bytes_in_flight: int
+    packet_space: str
+
+
+@dataclass(frozen=True, slots=True)
+class PersistentCongestion:
+    now: float
+    packet_space: str
+    duration: float
+
+
+@dataclass(frozen=True, slots=True)
+class EcnFeedback:
+    now: float
+    ect0: int
+    ect1: int
+    ce: int
+    bytes_in_flight: int
+
+
+@dataclass(frozen=True, slots=True)
+class MtuUpdated:
+    now: float
+    max_datagram_size: int
+
+
+@dataclass(frozen=True, slots=True)
+class SendLimits:
+    congestion_window: int
+    pacing_rate: float
+    send_quantum: int
+
+
+@dataclass(frozen=True, slots=True)
+class ControllerSnapshot:
+    algorithm: str
+    mode: str
+    congestion_window: int
+    pacing_rate: float
+    send_quantum: int
+    measurements: Mapping[str, int | float | str | bool | None] = field(
+        default_factory=dict
+    )
+
+    def __post_init__(self) -> None:
+        object.__setattr__(self, "measurements", MappingProxyType(dict(self.measurements)))
+
+
+@dataclass(frozen=True, slots=True)
+class ProviderMetadata:
+    algorithm_id: str
+    display_name: str
+    distribution: str
+    distribution_version: str
+    api_version: str = API_VERSION
+    capabilities: tuple[str, ...] = ()

tigrcorn_quic_cc/py.typed

@@ -0,0 +1 @@
+

tigrcorn_quic_cc/testing.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+
+from collections.abc import Iterable
+from dataclasses import dataclass
+
+from .api import CongestionController
+from .models import SendLimits
+from .validation import validate_send_limits
+
+
+@dataclass(slots=True)
+class DeterministicClock:
+    value: float = 0.0
+
+    def __call__(self) -> float:
+        return self.value
+
+    def advance(self, seconds: float) -> float:
+        if seconds < 0:
+            raise ValueError("clock cannot move backwards")
+        self.value += seconds
+        return self.value
+
+
+def collect_send_limits(
+    controller: CongestionController,
+    timestamps: Iterable[float],
+    *,
+    max_datagram_size: int,
+) -> tuple[SendLimits, ...]:
+    return tuple(
+        validate_send_limits(
+            controller.send_limits(timestamp),
+            max_datagram_size=max_datagram_size,
+        )
+        for timestamp in timestamps
+    )

tigrcorn_quic_cc/validation.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+import math
+import re
+
+from .api import CongestionControllerFactory
+from .errors import InvalidControllerOutput, ProviderCompatibilityError
+from .models import API_VERSION, ProviderMetadata, SendLimits
+
+_ALGORITHM_ID = re.compile(r"^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$")
+
+
+def validate_provider_metadata(metadata: ProviderMetadata) -> ProviderMetadata:
+    if not _ALGORITHM_ID.fullmatch(metadata.algorithm_id):
+        raise ProviderCompatibilityError(
+            f"invalid congestion-controller algorithm id: {metadata.algorithm_id!r}"
+        )
+    if metadata.api_version != API_VERSION:
+        raise ProviderCompatibilityError(
+            f"provider {metadata.algorithm_id!r} targets API {metadata.api_version!r}; "
+            f"expected {API_VERSION!r}"
+        )
+    if not metadata.distribution or not metadata.distribution_version:
+        raise ProviderCompatibilityError("provider distribution metadata is incomplete")
+    return metadata
+
+
+def validate_factory(factory: CongestionControllerFactory) -> CongestionControllerFactory:
+    validate_provider_metadata(factory.metadata)
+    return factory
+
+
+def validate_send_limits(
+    limits: SendLimits,
+    *,
+    max_datagram_size: int,
+) -> SendLimits:
+    minimum_window = 2 * max_datagram_size
+    if isinstance(limits.congestion_window, bool) or limits.congestion_window < minimum_window:
+        raise InvalidControllerOutput(
+            f"congestion window must be at least {minimum_window} bytes"
+        )
+    if not math.isfinite(limits.pacing_rate) or limits.pacing_rate <= 0:
+        raise InvalidControllerOutput("pacing rate must be finite and positive")
+    if isinstance(limits.send_quantum, bool) or not 0 < limits.send_quantum <= limits.congestion_window:
+        raise InvalidControllerOutput(
+            "send quantum must be positive and no larger than congestion window"
+        )
+    return limits

tigrcorn_quic_cc-0.3.18.dev3.dist-info/METADATA

@@ -0,0 +1,269 @@
+Metadata-Version: 2.4
+Name: tigrcorn-quic-cc
+Version: 0.3.18.dev3
+Summary: Versioned congestion-controller contracts and provider discovery for Tigrcorn QUIC transports.
+Author-email: Jacob Stewart <jacob@swarmauri.com>
+License: Apache License
+        Version 2.0, January 2004
+        http://www.apache.org/licenses/
+        
+        TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+        
+        1. Definitions.
+        
+           "License" shall mean the terms and conditions for use, reproduction, and
+           distribution as defined by Sections 1 through 9 of this document.
+        
+           "Licensor" shall mean the copyright owner or entity authorized by the
+           copyright owner that is granting the License.
+        
+           "Legal Entity" shall mean the union of the acting entity and all other
+           entities that control, are controlled by, or are under common control with
+           that entity. For the purposes of this definition, "control" means (i) the
+           power, direct or indirect, to cause the direction or management of such
+           entity, whether by contract or otherwise, or (ii) ownership of fifty percent
+           (50%) or more of the outstanding shares, or (iii) beneficial ownership of
+           such entity.
+        
+           "You" (or "Your") shall mean an individual or Legal Entity exercising
+           permissions granted by this License.
+        
+           "Source" form shall mean the preferred form for making modifications,
+           including but not limited to software source code, documentation source, and
+           configuration files.
+        
+           "Object" form shall mean any form resulting from mechanical transformation
+           or translation of a Source form, including but not limited to compiled object
+           code, generated documentation, and conversions to other media types.
+        
+           "Work" shall mean the work of authorship, whether in Source or Object form,
+           made available under the License, as indicated by a copyright notice that is
+           included in or attached to the work (an example is provided in the Appendix
+           below).
+        
+           "Derivative Works" shall mean any work, whether in Source or Object form,
+           that is based on (or derived from) the Work and for which the editorial
+           revisions, annotations, elaborations, or other modifications represent, as a
+           whole, an original work of authorship. For the purposes of this License,
+           Derivative Works shall not include works that remain separable from, or
+           merely link (or bind by name) to the interfaces of, the Work and Derivative
+           Works thereof.
+        
+           "Contribution" shall mean any work of authorship, including the original
+           version of the Work and any modifications or additions to that Work or
+           Derivative Works thereof, that is intentionally submitted to Licensor for
+           inclusion in the Work by the copyright owner or by an individual or Legal
+           Entity authorized to submit on behalf of the copyright owner. For the
+           purposes of this definition, "submitted" means any form of electronic,
+           verbal, or written communication sent to the Licensor or its representatives,
+           including but not limited to communication on electronic mailing lists,
+           source code control systems, and issue tracking systems that are managed by,
+           or on behalf of, the Licensor for the purpose of discussing and improving the
+           Work, but excluding communication that is conspicuously marked or otherwise
+           designated in writing by the copyright owner as "Not a Contribution."
+        
+           "Contributor" shall mean Licensor and any individual or Legal Entity on
+           behalf of whom a Contribution has been received by Licensor and subsequently
+           incorporated within the Work.
+        
+        2. Grant of Copyright License. Subject to the terms and conditions of this
+           License, each Contributor hereby grants to You a perpetual, worldwide,
+           non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+           reproduce, prepare Derivative Works of, publicly display, publicly perform,
+           sublicense, and distribute the Work and such Derivative Works in Source or
+           Object form.
+        
+        3. Grant of Patent License. Subject to the terms and conditions of this
+           License, each Contributor hereby grants to You a perpetual, worldwide,
+           non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this
+           section) patent license to make, have made, use, offer to sell, sell, import,
+           and otherwise transfer the Work, where such license applies only to those
+           patent claims licensable by such Contributor that are necessarily infringed by
+           their Contribution(s) alone or by combination of their Contribution(s) with
+           the Work to which such Contribution(s) was submitted. If You institute patent
+           litigation against any entity (including a cross-claim or counterclaim in a
+           lawsuit) alleging that the Work or a Contribution incorporated within the Work
+           constitutes direct or contributory patent infringement, then any patent
+           licenses granted to You under this License for that Work shall terminate as of
+           the date such litigation is filed.
+        
+        4. Redistribution. You may reproduce and distribute copies of the Work or
+           Derivative Works thereof in any medium, with or without modifications, and in
+           Source or Object form, provided that You meet the following conditions:
+        
+           (a) You must give any other recipients of the Work or Derivative Works a copy
+               of this License; and
+        
+           (b) You must cause any modified files to carry prominent notices stating that
+               You changed the files; and
+        
+           (c) You must retain, in the Source form of any Derivative Works that You
+               distribute, all copyright, patent, trademark, and attribution notices
+               from the Source form of the Work, excluding those notices that do not
+               pertain to any part of the Derivative Works; and
+        
+           (d) If the Work includes a "NOTICE" text file as part of its distribution,
+               then any Derivative Works that You distribute must include a readable copy
+               of the attribution notices contained within such NOTICE file, excluding
+               those notices that do not pertain to any part of the Derivative Works, in
+               at least one of the following places: within a NOTICE text file distributed
+               as part of the Derivative Works; within the Source form or documentation,
+               if provided along with the Derivative Works; or, within a display generated
+               by the Derivative Works, if and wherever such third-party notices normally
+               appear. The contents of the NOTICE file are for informational purposes only
+               and do not modify the License. You may add Your own attribution notices
+               within Derivative Works that You distribute, alongside or as an addendum to
+               the NOTICE text from the Work, provided that such additional attribution
+               notices cannot be construed as modifying the License.
+        
+           You may add Your own copyright statement to Your modifications and may provide
+           additional or different license terms and conditions for use, reproduction, or
+           distribution of Your modifications, or for any such Derivative Works as a
+           whole, provided Your use, reproduction, and distribution of the Work otherwise
+           complies with the conditions stated in this License.
+        
+        5. Submission of Contributions. Unless You explicitly state otherwise, any
+           Contribution intentionally submitted for inclusion in the Work by You to the
+           Licensor shall be under the terms and conditions of this License, without any
+           additional terms or conditions. Notwithstanding the above, nothing herein
+           shall supersede or modify the terms of any separate license agreement you may
+           have executed with Licensor regarding such Contributions.
+        
+        6. Trademarks. This License does not grant permission to use the trade names,
+           trademarks, service marks, or product names of the Licensor, except as
+           required for reasonable and customary use in describing the origin of the Work
+           and reproducing the content of the NOTICE file.
+        
+        7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+           writing, Licensor provides the Work (and each Contributor provides its
+           Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied, including, without limitation, any warranties
+           or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+           PARTICULAR PURPOSE. You are solely responsible for determining the
+           appropriateness of using or redistributing the Work and assume any risks
+           associated with Your exercise of permissions under this License.
+        
+        8. Limitation of Liability. In no event and under no legal theory, whether in
+           tort (including negligence), contract, or otherwise, unless required by
+           applicable law (such as deliberate and grossly negligent acts) or agreed to in
+           writing, shall any Contributor be liable to You for damages, including any
+           direct, indirect, special, incidental, or consequential damages of any
+           character arising as a result of this License or out of the use or inability
+           to use the Work (including but not limited to damages for loss of goodwill,
+           work stoppage, computer failure or malfunction, or any and all other
+           commercial damages or losses), even if such Contributor has been advised of
+           the possibility of such damages.
+        
+        9. Accepting Warranty or Additional Liability. While redistributing the Work or
+           Derivative Works thereof, You may choose to offer, and charge a fee for,
+           acceptance of support, warranty, indemnity, or other liability obligations
+           and/or rights consistent with this License. However, in accepting such
+           obligations, You may act only on Your own behalf and on Your sole
+           responsibility, not on behalf of any other Contributor, and only if You agree
+           to indemnify, defend, and hold each Contributor harmless for any liability
+           incurred by, or claims asserted against, such Contributor by reason of your
+           accepting any such warranty or additional liability.
+        
+        END OF TERMS AND CONDITIONS
+        
+        
+Keywords: tigrcorn,quic,congestion-control,provider,networking,http3
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<div align="center">
+<h1>tigrcorn-quic-cc</h1>
+
+<p><strong>Versioned congestion-controller contracts and provider discovery for Tigrcorn QUIC transports.</strong></p>
+
+<a href="https://pypi.org/project/tigrcorn-quic-cc/"><img alt="PyPI version for tigrcorn-quic-cc" src="https://img.shields.io/pypi/v/tigrcorn-quic-cc?label=PyPI"></a>
+<a href="https://pepy.tech/project/tigrcorn-quic-cc"><img alt="Downloads" src="https://static.pepy.tech/badge/tigrcorn-quic-cc"></a>
+<a href="https://github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-quic-cc/README.md"><img alt="Hits" src="https://hits.sh/github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-quic-cc/README.md.svg?label=hits"></a>
+<a href="LICENSE"><img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache%202.0-525252"></a>
+<a href="pyproject.toml"><img alt="Python versions" src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab"></a>
+</div>
+
+## Install
+
+```bash
+pip install tigrcorn-quic-cc
+```
+
+## What It Owns
+
+This dependency-light package owns the public QUIC congestion-control API,
+immutable event and decision models, entry-point discovery, validation, and
+provider compliance helpers. It does not own sockets, packet encoding, loss
+detection, retransmission, flow control, pacing enforcement, or wire ordering.
+
+## Use It When
+
+Use this package when authoring a standalone Tigrcorn congestion-control
+provider or embedding a provider factory into a controlled QUIC integration.
+
+## Import Surface
+
+```python
+import tigrcorn_quic_cc
+
+print(tigrcorn_quic_cc.API_VERSION)
+```
+
+Providers implement `CongestionControllerFactory`, validate their options, and
+create one controller per QUIC network path. Controllers receive immutable
+events and return validated `SendLimits` values.
+
+## Provider Discovery
+
+Publish factories through the `tigrcorn.quic_cc.v1` entry-point group. The
+registry imports only the explicitly selected provider and rejects missing,
+duplicate, or incompatible providers.
+
+## Compliance Helpers
+
+`DeterministicClock`, `collect_send_limits`, and the public validators support
+repeatable trace and invariant tests without importing Tigrcorn transports.
+
+## Related Packages
+
+- [tigrcorn](https://pypi.org/project/tigrcorn/)
+- [tigrcorn-core](https://pypi.org/project/tigrcorn-core/)
+- [tigrcorn-config](https://pypi.org/project/tigrcorn-config/)
+- [tigrcorn-quic-cc-reno](https://pypi.org/project/tigrcorn-quic-cc-reno/)
+- [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/)
+- [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/)
+
+## Package Graph
+
+[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/)
+
+`tigrcorn-quic-cc` is a layer-zero contract. Algorithm packages depend on it;
+the transport depends on the contract and its default provider; runtime and
+protocol packages consume the transport-owned enforcement surface.
+
+## Best Practices
+
+- Keep controller state path-local.
+- Treat event times as monotonic seconds and rates as bytes per second.
+- Return finite, positive pacing rates and safe congestion windows.
+- Keep packet loss detection, retransmission, and wire scheduling in Tigrcorn.
+
+## License
+
+Apache-2.0

tigrcorn_quic_cc-0.3.18.dev3.dist-info/RECORD

@@ -0,0 +1,13 @@
+tigrcorn_quic_cc/__init__.py,sha256=BGwn4TUmRS41cAxyiWaKwZcppRIRC9eSdxXiFLEGr78,1419
+tigrcorn_quic_cc/api.py,sha256=GxcvcGeR7jUo-M0Bn7AIjXFe1w7ReqxvaJZuSOinA_0,1350
+tigrcorn_quic_cc/discovery.py,sha256=iBCUf72EICgloYC3j8Aiv0vGPlpfTWVpAXUxtCtX3gE,2417
+tigrcorn_quic_cc/errors.py,sha256=aMVrtsgKaI965XlhFbgRshLhDNYAb8pS2j3RV2oGrvs,668
+tigrcorn_quic_cc/models.py,sha256=gC4qkZHdPU3X9DKiV2PexWmq0K90OfZN6w2TZAzhGOQ,2374
+tigrcorn_quic_cc/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+tigrcorn_quic_cc/testing.py,sha256=lutwdY9uX_xxZfdvvHzIbtZjxW3CM5xYr8a_jQgY3bs,903
+tigrcorn_quic_cc/validation.py,sha256=q5uhqMs55qXuzYdSTIcRuOXL7vceQ-tuO-9Pdyxj2Cc,1921
+tigrcorn_quic_cc-0.3.18.dev3.dist-info/licenses/LICENSE,sha256=xhBSirl227aDQNeQ8tk2v_yiU9nbQpJ4EZp6OtATX-s,9591
+tigrcorn_quic_cc-0.3.18.dev3.dist-info/METADATA,sha256=8S9evNwu8A1Ds-j8PhNSgRREecKA-5o8RMIwdscp3GU,16149
+tigrcorn_quic_cc-0.3.18.dev3.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+tigrcorn_quic_cc-0.3.18.dev3.dist-info/top_level.txt,sha256=cp56KdV6lGEk3LXBl1GFl-EiqoQJTaimDFHoPheQ0Dw,17
+tigrcorn_quic_cc-0.3.18.dev3.dist-info/RECORD,,

tigrcorn_quic_cc-0.3.18.dev3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tigrcorn_quic_cc-0.3.18.dev3.dist-info/licenses/LICENSE

@@ -0,0 +1,163 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction, and
+   distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by the
+   copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all other
+   entities that control, are controlled by, or are under common control with
+   that entity. For the purposes of this definition, "control" means (i) the
+   power, direct or indirect, to cause the direction or management of such
+   entity, whether by contract or otherwise, or (ii) ownership of fifty percent
+   (50%) or more of the outstanding shares, or (iii) beneficial ownership of
+   such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity exercising
+   permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation source, and
+   configuration files.
+
+   "Object" form shall mean any form resulting from mechanical transformation
+   or translation of a Source form, including but not limited to compiled object
+   code, generated documentation, and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or Object form,
+   made available under the License, as indicated by a copyright notice that is
+   included in or attached to the work (an example is provided in the Appendix
+   below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object form,
+   that is based on (or derived from) the Work and for which the editorial
+   revisions, annotations, elaborations, or other modifications represent, as a
+   whole, an original work of authorship. For the purposes of this License,
+   Derivative Works shall not include works that remain separable from, or
+   merely link (or bind by name) to the interfaces of, the Work and Derivative
+   Works thereof.
+
+   "Contribution" shall mean any work of authorship, including the original
+   version of the Work and any modifications or additions to that Work or
+   Derivative Works thereof, that is intentionally submitted to Licensor for
+   inclusion in the Work by the copyright owner or by an individual or Legal
+   Entity authorized to submit on behalf of the copyright owner. For the
+   purposes of this definition, "submitted" means any form of electronic,
+   verbal, or written communication sent to the Licensor or its representatives,
+   including but not limited to communication on electronic mailing lists,
+   source code control systems, and issue tracking systems that are managed by,
+   or on behalf of, the Licensor for the purpose of discussing and improving the
+   Work, but excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity on
+   behalf of whom a Contribution has been received by Licensor and subsequently
+   incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+   License, each Contributor hereby grants to You a perpetual, worldwide,
+   non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+   reproduce, prepare Derivative Works of, publicly display, publicly perform,
+   sublicense, and distribute the Work and such Derivative Works in Source or
+   Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this
+   License, each Contributor hereby grants to You a perpetual, worldwide,
+   non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this
+   section) patent license to make, have made, use, offer to sell, sell, import,
+   and otherwise transfer the Work, where such license applies only to those
+   patent claims licensable by such Contributor that are necessarily infringed by
+   their Contribution(s) alone or by combination of their Contribution(s) with
+   the Work to which such Contribution(s) was submitted. If You institute patent
+   litigation against any entity (including a cross-claim or counterclaim in a
+   lawsuit) alleging that the Work or a Contribution incorporated within the Work
+   constitutes direct or contributory patent infringement, then any patent
+   licenses granted to You under this License for that Work shall terminate as of
+   the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+   Derivative Works thereof in any medium, with or without modifications, and in
+   Source or Object form, provided that You meet the following conditions:
+
+   (a) You must give any other recipients of the Work or Derivative Works a copy
+       of this License; and
+
+   (b) You must cause any modified files to carry prominent notices stating that
+       You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works that You
+       distribute, all copyright, patent, trademark, and attribution notices
+       from the Source form of the Work, excluding those notices that do not
+       pertain to any part of the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its distribution,
+       then any Derivative Works that You distribute must include a readable copy
+       of the attribution notices contained within such NOTICE file, excluding
+       those notices that do not pertain to any part of the Derivative Works, in
+       at least one of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or documentation,
+       if provided along with the Derivative Works; or, within a display generated
+       by the Derivative Works, if and wherever such third-party notices normally
+       appear. The contents of the NOTICE file are for informational purposes only
+       and do not modify the License. You may add Your own attribution notices
+       within Derivative Works that You distribute, alongside or as an addendum to
+       the NOTICE text from the Work, provided that such additional attribution
+       notices cannot be construed as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and may provide
+   additional or different license terms and conditions for use, reproduction, or
+   distribution of Your modifications, or for any such Derivative Works as a
+   whole, provided Your use, reproduction, and distribution of the Work otherwise
+   complies with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+   Contribution intentionally submitted for inclusion in the Work by You to the
+   Licensor shall be under the terms and conditions of this License, without any
+   additional terms or conditions. Notwithstanding the above, nothing herein
+   shall supersede or modify the terms of any separate license agreement you may
+   have executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+   trademarks, service marks, or product names of the Licensor, except as
+   required for reasonable and customary use in describing the origin of the Work
+   and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+   writing, Licensor provides the Work (and each Contributor provides its
+   Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied, including, without limitation, any warranties
+   or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any risks
+   associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in
+   tort (including negligence), contract, or otherwise, unless required by
+   applicable law (such as deliberate and grossly negligent acts) or agreed to in
+   writing, shall any Contributor be liable to You for damages, including any
+   direct, indirect, special, incidental, or consequential damages of any
+   character arising as a result of this License or out of the use or inability
+   to use the Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all other
+   commercial damages or losses), even if such Contributor has been advised of
+   the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or
+   Derivative Works thereof, You may choose to offer, and charge a fee for,
+   acceptance of support, warranty, indemnity, or other liability obligations
+   and/or rights consistent with this License. However, in accepting such
+   obligations, You may act only on Your own behalf and on Your sole
+   responsibility, not on behalf of any other Contributor, and only if You agree
+   to indemnify, defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason of your
+   accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+

tigrcorn_quic_cc-0.3.18.dev3.dist-info/top_level.txt

@@ -0,0 +1 @@
+tigrcorn_quic_cc