Metadata-Version: 2.4
Name: tigrcorn
Version: 0.3.16.dev10
Summary: ASGI3 Python web server with built-in HTTP/1.1, HTTP/2, HTTP/3, QUIC, WebSocket, WebTransport, TLS, and certification tooling.
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: asgi,asgi3,server,http,http1,http2,http3,quic,websocket,webtransport,tls,python-web-server,uvicorn-alternative,hypercorn-alternative
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 :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Networking
Classifier: Typing :: Typed
Requires-Python: <3.15,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tigrcorn-core==0.3.16.dev10
Requires-Dist: tigrcorn-config==0.3.16.dev10
Requires-Dist: tigrcorn-asgi==0.3.16.dev10
Requires-Dist: tigrcorn-contract==0.3.16.dev10
Requires-Dist: tigrcorn-transports==0.3.16.dev10
Requires-Dist: tigrcorn-protocols==0.3.16.dev10
Requires-Dist: tigrcorn-http==0.3.16.dev10
Requires-Dist: tigrcorn-security==0.3.16.dev10
Requires-Dist: tigrcorn-runtime==0.3.16.dev10
Requires-Dist: tigrcorn-static==0.3.16.dev10
Requires-Dist: tigrcorn-observability==0.3.16.dev10
Requires-Dist: tigrcorn-compat==0.3.16.dev10
Requires-Dist: tigrcorn-certification==0.3.16.dev10
Requires-Dist: tigr-asgi-contract>=0.3.2
Provides-Extra: tls-x509
Requires-Dist: cryptography>=46.0.0; extra == "tls-x509"
Provides-Extra: certification
Requires-Dist: cryptography>=46.0.0; extra == "certification"
Requires-Dist: aioquic>=1.3.0; extra == "certification"
Requires-Dist: h11>=0.14.0; extra == "certification"
Requires-Dist: h2>=4.1.0; extra == "certification"
Requires-Dist: websockets>=12.0; extra == "certification"
Requires-Dist: wsproto>=1.3.0; extra == "certification"
Provides-Extra: config-yaml
Requires-Dist: PyYAML>=6.0; extra == "config-yaml"
Provides-Extra: compression
Requires-Dist: brotli>=1.1.0; extra == "compression"
Provides-Extra: runtime-uvloop
Requires-Dist: uvloop>=0.19.0; platform_system != "Windows" and extra == "runtime-uvloop"
Provides-Extra: runtime-trio
Requires-Dist: trio>=0.25.0; extra == "runtime-trio"
Provides-Extra: full-featured
Requires-Dist: cryptography>=46.0.0; extra == "full-featured"
Requires-Dist: PyYAML>=6.0; extra == "full-featured"
Requires-Dist: brotli>=1.1.0; extra == "full-featured"
Requires-Dist: uvloop>=0.19.0; platform_system != "Windows" and extra == "full-featured"
Provides-Extra: dev
Requires-Dist: cryptography>=46.0.0; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: ssot-registry>=0.2.18; extra == "dev"
Requires-Dist: tomli>=2.0.0; python_version < "3.11" and extra == "dev"
Requires-Dist: aioquic>=1.3.0; extra == "dev"
Requires-Dist: h11>=0.14.0; extra == "dev"
Requires-Dist: h2>=4.1.0; extra == "dev"
Requires-Dist: websockets>=12.0; extra == "dev"
Requires-Dist: wsproto>=1.3.0; extra == "dev"
Requires-Dist: PyYAML>=6.0; extra == "dev"
Requires-Dist: brotli>=1.1.0; extra == "dev"
Requires-Dist: uvloop>=0.19.0; platform_system != "Windows" and extra == "dev"
Dynamic: license-file

<div align="center">

<h1>Tigrcorn</h1>

<img
  src="https://raw.githubusercontent.com/Tigrbl/tigrcorn/master/assets/tigrcorn_logo.png"
  alt="Tigrcorn tiger-unicorn logo"
  width="220"
/>

> ASGI3 server with built-in HTTP/1.1, HTTP/2, HTTP/3, QUIC, WebSocket, TLS, static delivery, and release validation.

---
</div>

<p align="center"><a href="https://discord.gg/jzvrbEtTtt"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&amp;logoColor=white"></a></p>


<p align="center"><strong>Release status</strong><br>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/pyproject.toml"><img alt="repo line 0.3.16.dev5" src="https://img.shields.io/badge/repo_line-0.3.16.dev5-2f7ed8"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/state/CURRENT_REPOSITORY_STATE.md"><img alt="current state canonical" src="https://img.shields.io/badge/current_state-canonical-0969da"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md"><img alt="authoritative boundary green" src="https://img.shields.io/badge/authoritative_boundary-green-1f883d"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/STRICT_PROFILE_TARGET.md"><img alt="strict profile green" src="https://img.shields.io/badge/strict_profile-green-1f883d"></a>
<a href="https://github.com/tigrbl/tigrcorn/tree/master/docs/review/conformance/releases/0.3.9/release-0.3.9"><img alt="promotion green" src="https://img.shields.io/badge/promotion-green-1f883d"></a>
</p>

<p align="center"><strong>Package</strong><br>
<a href="https://pypi.org/project/tigrcorn/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/tigrcorn?label=PyPI"></a>
<a href="https://pepy.tech/project/tigrcorn"><img alt="Downloads for tigrcorn" src="https://static.pepy.tech/badge/tigrcorn"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/README.md"><img alt="Hits for tigrcorn README" src="https://hits.sh/github.com/tigrbl/tigrcorn/blob/master/README.md.svg?label=hits"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/LICENSE"><img alt="license Apache 2.0" src="https://img.shields.io/badge/license-Apache%202.0-525252"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/pyproject.toml"><img alt="Python 3.10 | 3.11 | 3.12 | 3.13 | 3.14 supported" 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>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/OPTIONAL_DEPENDENCY_SURFACE.md"><img alt="runtime auto supported" src="https://img.shields.io/badge/runtime-auto-0a7f5a"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/OPTIONAL_DEPENDENCY_SURFACE.md"><img alt="runtime asyncio supported" src="https://img.shields.io/badge/runtime-asyncio-0a7f5a"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/OPTIONAL_DEPENDENCY_SURFACE.md"><img alt="runtime uvloop supported" src="https://img.shields.io/badge/runtime-uvloop-0a7f5a"></a>
</p>

<p align="center"><strong>Protocol status</strong><br>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/http1.md"><img alt="HTTP/1.1 C-RFC" src="https://img.shields.io/badge/HTTP%2F1.1-C--RFC-1f883d"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/http2.md"><img alt="HTTP/2 C-RFC" src="https://img.shields.io/badge/HTTP%2F2-C--RFC-1f883d"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/http3.md"><img alt="HTTP/3 C-RFC" src="https://img.shields.io/badge/HTTP%2F3-C--RFC-1f883d"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/quic.md"><img alt="QUIC C-RFC" src="https://img.shields.io/badge/QUIC-C--RFC-1f883d"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/websocket.md"><img alt="WebSocket C-RFC" src="https://img.shields.io/badge/WebSocket-C--RFC-1f883d"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/websocket.md"><img alt="RFC 8441 C-RFC" src="https://img.shields.io/badge/RFC8441-C--RFC-1f883d"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/websocket.md"><img alt="RFC 9220 C-RFC" src="https://img.shields.io/badge/RFC9220-C--RFC-1f883d"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md"><img alt="TLS 1.3 X.509 OCSP C-RFC" src="https://img.shields.io/badge/TLS1.3_X.509_OCSP-C--RFC-1f883d"></a>
</p>

<p align="center"><strong>Operator and API surface status</strong><br>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md"><img alt="CLI C-OP" src="https://img.shields.io/badge/CLI-C--OP-0a7f5a"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/LIFECYCLE_AND_EMBEDDED_SERVER.md"><img alt="EmbeddedServer C-OP" src="https://img.shields.io/badge/EmbeddedServer-C--OP-0a7f5a"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/LIFECYCLE_AND_EMBEDDED_SERVER.md"><img alt="Lifecycle hooks C-OP" src="https://img.shields.io/badge/Lifecycle_hooks-C--OP-0a7f5a"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md"><img alt="StaticFilesApp C-OP" src="https://img.shields.io/badge/StaticFilesApp-C--OP-0a7f5a"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md"><img alt="Workers and reload C-OP" src="https://img.shields.io/badge/Workers_reload-C--OP-0a7f5a"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md"><img alt="Metrics and logging C-OP" src="https://img.shields.io/badge/Metrics_logging-C--OP-0a7f5a"></a>
<a href="https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md"><img alt="Release gates C-OP" src="https://img.shields.io/badge/Release_gates-C--OP-0a7f5a"></a>
</p>


---

Tigrcorn is an ASGI3 server for Python teams building APIs, edge services, internal platforms, and protocol-heavy applications that need modern transport support without giving up operational control. It implements HTTP/1.1, HTTP/2, HTTP/3, QUIC, WebSockets, TLS handling, static delivery, and release checks inside the project, with operator docs and current-state material kept alongside the code.

Most users should start with **Quick start**, **Protocol and feature map**, and **CLI usage**. Maintainers should use the SSOT, governance, and conformance links when changing claimed support, release boundaries, or certification evidence.


## Table of contents

- [Legend](#legend)
- [Choose your path](#choose-your-path)
- [Quick start](#quick-start)
- [Why teams pick Tigrcorn](#why-teams-pick-tigrcorn)
- [What Tigrcorn provides](#what-tigrcorn-provides)
- [Published packages](#published-packages)
- [Installation and extras](#installation-and-extras)
- [Protocol and feature map](#protocol-and-feature-map)
- [CLI usage](#cli-usage)
- [Public API and embedding usage](#public-api-and-embedding-usage)
- [Current scope](#current-scope)
- [Status at a glance](#status-at-a-glance)
- [Validation and promotion](#validation-and-promotion)
- [Where to look](#where-to-look)
- [Contributing, conduct, and community norms](#contributing-conduct-and-community-norms)
- [Footnotes](#footnotes)

## Legend

Use this legend for the badges, status tables, and scope markers in this README.

| Marker | Meaning |
|---|---|
| `C-RFC` | included in Tigrcorn's current certified RFC boundary |
| `C-OP` | included in Tigrcorn's current public operator/API surface |
| `OOB` | outside Tigrcorn's current documented boundary and shipped surface |
| `green` | the referenced repo contract or evaluation target is currently passing |
| `canonical` | the referenced document is the current mutable source of truth |
| `repo_line` | the active repository release line represented by this checkout |
| `runtime-auto`, `runtime-asyncio`, `runtime-uvloop` | documented runtime modes in the current public surface |

The top badge groups use plain language labels where possible. The protocol and feature tables use `C-RFC`, `C-OP`, and `OOB` as compact scope markers.

## Choose your path

| Goal | Start with | Then use |
|---|---|---|
| Run Tigrcorn as an ASGI server | [Quick start](#quick-start) | [CLI docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md), [deployment profiles](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/profiles.md) |
| Configure production behavior | [CLI docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md) | [defaults](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/defaults.md), [observability](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/observability.md), [policies](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/policies.md) |
| Build on Tigrcorn from Python | [Public API and embedding usage](#public-api-and-embedding-usage) | [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md), [lifecycle and embedded server guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/LIFECYCLE_AND_EMBEDDED_SERVER.md) |
| Understand protocol and feature support | [Protocol and feature map](#protocol-and-feature-map) | [protocol docs](https://github.com/tigrbl/tigrcorn/tree/master/docs/protocols/), [certification boundary](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md), [`.ssot/registry.json`](https://github.com/tigrbl/tigrcorn/blob/master/.ssot/registry.json) |
| Review release and conformance status | [Status at a glance](#status-at-a-glance) | [Validation and promotion](#validation-and-promotion), [conformance docs](https://github.com/tigrbl/tigrcorn/tree/master/docs/review/conformance/) |

## Quick start

### Install

```bash
python -m pip install tigrcorn
```

### Run an HTTP server

```bash
tigrcorn examples.echo_http.app:app --host 127.0.0.1 --port 8000
```

### Run HTTP/3 + QUIC

```bash
tigrcorn examples.echo_http.app:app \
  --quic-bind 127.0.0.1:8443 \
  --http 3 \
  --protocol http3 \
  --protocol quic \
  --ssl-certfile ./certs/server.pem \
  --ssl-keyfile ./certs/server.key
```

### Run from Python

```python
from tigrcorn import run

run("examples.echo_http.app:app", host="127.0.0.1", port=8000)
```

For complete operator recipes, use [CLI docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md). For public imports and lifecycle details, use [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md) and [lifecycle and embedded server guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/LIFECYCLE_AND_EMBEDDED_SERVER.md).
For the blessed safe deployment profiles, use [deployment profiles](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/profiles.md) and the [packaged profile artifacts](https://github.com/tigrbl/tigrcorn/tree/master/src/tigrcorn/profiles/).

## Why teams pick Tigrcorn

- **Modern protocol stack in the server itself.** HTTP/1.1, HTTP/2, HTTP/3, QUIC, WebSockets, TLS 1.3, ALPN, X.509 validation, OCSP, and CRL handling are first-class documented surfaces.
- **Operator features that matter in deployment.** Listener binding, TLS and QUIC controls, workers, reload, structured logging, metrics, proxy normalization, content-coding policy, CONNECT policy, Early Hints, Alt-Svc, and static delivery are part of the public surface.
- **A public Python API for applications and hosts.** `run`, `serve`, `serve_import_string`, `EmbeddedServer`, `StaticFilesApp`, and the config helpers are documented as importable entrypoints.
- **Static delivery and entity semantics built into the package.** Static mounting, precompressed sidecars, conditional requests, range requests, and response-path helpers are available without a separate static server wrapper.
- **Release and promotion checks in the repo.** `evaluate_release_gates` and `evaluate_promotion_target` are shipped APIs, and the repo preserves current-state and promoted-release material under [conformance docs](https://github.com/tigrbl/tigrcorn/tree/master/docs/review/conformance/).

## What Tigrcorn provides

| Area | What you get | Primary docs |
|---|---|---|
| Server runtime | ASGI3 execution over HTTP/1.1, HTTP/2, HTTP/3, QUIC, and WebSockets | [protocol docs](https://github.com/tigrbl/tigrcorn/tree/master/docs/protocols/), [examples](https://github.com/tigrbl/tigrcorn/tree/master/examples/) |
| Security | TLS 1.3 controls, ALPN, certificate validation, OCSP, CRL handling | [certification boundary](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md) |
| Delivery | static files, ETag/conditional handling, range support, content coding, Early Hints, Alt-Svc | [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md), [deployment profiles reference](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/DEPLOYMENT_PROFILES.md) |
| Operations | listeners, workers, reload, metrics, logging, proxy normalization, timeouts and resource controls | [CLI docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md) |
| Embedding | `run`, `serve`, `serve_import_string`, `EmbeddedServer`, lifecycle hooks | [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md), [lifecycle and embedded server guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/LIFECYCLE_AND_EMBEDDED_SERVER.md) |
| Config | typed config model, config-file loading, env loading, merge from CLI/env/file/defaults | [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md), [CLI docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md) |
| Blessed profiles | generated safe deployment profiles plus profile conformance bundles | [deployment profiles](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/profiles.md), [profile bundles JSON](https://github.com/tigrbl/tigrcorn/blob/master/docs/conformance/profile_bundles.json) |
| Release checks | release-gate and promotion-target evaluators | [release workflow guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/release.md), [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md) |
| Current-state and release records | canonical current-state docs plus frozen promoted roots | [state docs index](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/state/README.md), [release roots](https://github.com/tigrbl/tigrcorn/tree/master/docs/review/conformance/releases/) |

## Published packages

### Python package family

| Package | Owns |
| --- | --- |
| [`tigrcorn`](https://pypi.org/project/tigrcorn/) | aggregate distribution and compatibility umbrella |
| [`tigrcorn-core`](https://pypi.org/project/tigrcorn-core/) | constants, errors, types, and shared utils |
| [`tigrcorn-config`](https://pypi.org/project/tigrcorn-config/) | config models, validation, profiles, env and file loading |
| [`tigrcorn-http`](https://pypi.org/project/tigrcorn-http/) | entity tags, headers, conditional requests, ranges, and HTTP helpers |
| [`tigrcorn-asgi`](https://pypi.org/project/tigrcorn-asgi/) | ASGI send and receive adapters and response materialization |
| [`tigrcorn-contract`](https://pypi.org/project/tigrcorn-contract/) | event ordering, scope validation, and ASGI contract helpers |
| [`tigrcorn-transports`](https://pypi.org/project/tigrcorn-transports/) | TCP, UDP, Unix, pipe, and transport machinery |
| [`tigrcorn-security`](https://pypi.org/project/tigrcorn-security/) | TLS, ALPN, X.509, OCSP, and CRL handling |
| [`tigrcorn-protocols`](https://pypi.org/project/tigrcorn-protocols/) | HTTP/1.1, HTTP/2, HTTP/3, QUIC, sessions, streams, and schedulers |
| [`tigrcorn-static`](https://pypi.org/project/tigrcorn-static/) | static delivery and route mounting |
| [`tigrcorn-observability`](https://pypi.org/project/tigrcorn-observability/) | metrics and logging surfaces |
| [`tigrcorn-runtime`](https://pypi.org/project/tigrcorn-runtime/) | app loading, runner, workers, reload, embedding, and CLI |
| [`tigrcorn-compat`](https://pypi.org/project/tigrcorn-compat/) | root-namespace shims and promotion helpers |
| [`tigrcorn-certification`](https://pypi.org/project/tigrcorn-certification/) | release gates, strict promotion checks, and external evidence rails |

### npm package

| Package | Owns |
| --- | --- |
| [`@tigrcorn/wt-peer-probes`](https://www.npmjs.com/package/@tigrcorn/wt-peer-probes) | browser-side WebTransport probe execution and Playwright peer validation |

## Installation and extras

### Base install

```bash
python -m pip install tigrcorn
```

### Certification / development install

```bash
python -m pip install -e ".[certification,dev]"
```

### Optional extras

| Extra | Status | Use it for |
|---|---|---|
| `tls-x509` | supported | package-owned TLS/X.509 validation, certificate handling, and revocation helpers |
| `config-yaml` | supported | `.yaml` / `.yml` config loading |
| `compression` | supported | Brotli content coding and `.br` sidecars |
| `runtime-uvloop` | supported | `--runtime uvloop` on supported platforms |
| `runtime-trio` | declared, not supported | reserved dependency path only |
| `full-featured` | supported | current aggregate optional operator feature surface |
| `certification` | supported | interop and certification tooling |
| `dev` | supported | local development and validation |

### Practical install examples

```bash
# TLS/X.509 validation and certificate-material helpers
python -m pip install -e ".[tls-x509]"

# YAML config support
python -m pip install -e ".[config-yaml]"

# Brotli + precompressed static sidecars
python -m pip install -e ".[compression]"

# uvloop runtime option (non-Windows)
python -m pip install -e ".[runtime-uvloop]"

# current aggregate optional feature surface
python -m pip install -e ".[full-featured]"
```

The authoritative optional dependency reference is [optional dependency surface](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/OPTIONAL_DEPENDENCY_SURFACE.md). TLS/X.509 operations rely on the optional `tigrcorn[tls-x509]` extra.

## Protocol and feature map

This section is a public support snapshot. It keeps protocol and feature details visible in the README while making Tigrcorn's depth, feature surface, and domain coverage explicit. Use `C-RFC` for current certified protocol claims, `C-OP` for current operator/API surfaces, and `OOB` for intentionally out-of-boundary behavior.

> **Legend:** `C-RFC` = inside the current certified RFC boundary Â· `C-OP` = inside the public/operator surface Â· `OOB` = outside the current scope

### Core protocol, transport, and delivery

| Category | Surface | Status | Primary docs |
|---|---|---|---|
| HTTP | HTTP/1.1 (`RFC 9112`) | `C-RFC` | [HTTP/1.1 docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/http1.md) |
| HTTP | HTTP/2 (`RFC 9113`) | `C-RFC` | [HTTP/2 docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/http2.md) |
| HTTP | HTTP/3 (`RFC 9114`) | `C-RFC` | [HTTP/3 docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/http3.md) |
| QUIC | QUIC transport (`RFC 9000`, `RFC 9001`, `RFC 9002`) | `C-RFC` | [QUIC docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/quic.md) |
| WebSocket | RFC 6455 / RFC 8441 / RFC 9220 carriers | `C-RFC` | [WebSocket docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/websocket.md) |
| Delivery | CONNECT relay, trailer fields, content coding | `C-RFC` | [deployment profiles reference](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/DEPLOYMENT_PROFILES.md) |
| Delivery | Conditional requests, range requests, Early Hints, bounded Alt-Svc | `C-RFC` | [RFC applicability and competitor status](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/RFC_APPLICABILITY_AND_COMPETITOR_STATUS.md) |
| Security | TLS 1.3, ALPN, X.509, OCSP, CRL | `C-RFC` | [certification boundary](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md) |

### Operator and public API surface

| Category | Surface | Status | Primary docs |
|---|---|---|---|
| CLI | `tigrcorn`, `python -m tigrcorn`, `tigrcorn-interop` | `C-OP` | [CLI docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md) |
| Config | `build_config`, `build_config_from_namespace`, `build_config_from_sources` | `C-OP` | [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md) |
| Embedding | `EmbeddedServer`, lifecycle hooks, public lifecycle contract | `C-OP` | [lifecycle and embedded server guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/LIFECYCLE_AND_EMBEDDED_SERVER.md) |
| Static | `StaticFilesApp`, `mount_static_app`, static route flags | `C-OP` | [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md) |
| Operations | reload, workers, runtime selection, metrics, logging, proxy normalization | `C-OP` | [CLI docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md) |
| Release | `evaluate_release_gates`, `evaluate_promotion_target` | `C-OP` | [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md), [release workflow guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/release.md) |
| Custom transports | pipe / inproc / rawframed / custom | `C-OP` with boundary notes | [custom transport docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/protocols/custom-transports.md), [boundary non-goals](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/BOUNDARY_NON_GOALS.md) |

## CLI usage

The main command is `tigrcorn`. The public module entrypoint is `python -m tigrcorn`. The interoperability runner is `tigrcorn-interop`.

For complete operator coverage, use:

- [CLI docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md)
- [CLI flag surface](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CLI_FLAG_SURFACE.md)
- [CLI flag surface JSON](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/cli_flag_surface.json)
- [deployment profiles reference](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/DEPLOYMENT_PROFILES.md)
- [current CLI help snapshot](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/cli_help.current.txt)
- [current interop help snapshot](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/tigrcorn_interop_help.current.txt)

### Config precedence

```text
CLI > env > config file > defaults
```

That precedence is implemented by `build_config_from_sources` and documented in [code governance](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/code.md).

### Common launch patterns

#### Minimal HTTP/1.1 + HTTP/2

```bash
tigrcorn examples.echo_http.app:app --host 127.0.0.1 --port 8000
```

#### App factory loading

```bash
tigrcorn examples.echo_http.app:create_app --factory --host 127.0.0.1 --port 8000
```

#### Config file + environment merge

```bash
tigrcorn examples.echo_http.app:app \
  --config ./tigrcorn.toml \
  --env-file ./.env \
  --env-prefix TIGRCORN
```

#### HTTP/2 over TLS

```bash
tigrcorn examples.echo_http.app:app \
  --bind 127.0.0.1:8443 \
  --http 2 \
  --ssl-certfile ./certs/server.pem \
  --ssl-keyfile ./certs/server.key
```

#### HTTP/3 / QUIC

```bash
tigrcorn examples.echo_http.app:app \
  --quic-bind 127.0.0.1:8443 \
  --http 3 \
  --protocol http3 \
  --protocol quic \
  --ssl-certfile ./certs/server.pem \
  --ssl-keyfile ./certs/server.key
```

#### WebSocket compression

```bash
tigrcorn examples.websocket_echo.app:app \
  --host 127.0.0.1 \
  --port 9000 \
  --websocket-compression permessage-deflate
```

#### Static route mounting

```bash
tigrcorn examples.http_entity_static.app:app \
  --static-path-route /assets \
  --static-path-mount ./public \
  --static-path-dir-to-file \
  --static-path-index-file index.html \
  --static-path-expires 3600
```

#### CONNECT, trailer, and content-coding policy

```bash
tigrcorn examples.echo_http.app:app \
  --connect-policy allowlist \
  --connect-allow 127.0.0.1:5432 \
  --trailer-policy strict \
  --content-coding-policy allowlist \
  --content-codings br,gzip,deflate
```

#### Automatic Alt-Svc advertisement

```bash
tigrcorn examples.advanced_protocol_delivery.alt_svc_app:app \
  --bind 127.0.0.1:8080 \
  --quic-bind 127.0.0.1:8443 \
  --http 1.1 --http 2 --http 3 \
  --alt-svc-auto \
  --alt-svc-ma 86400 \
  --alt-svc-persist
```

#### Metrics, logging, reload, and workers

```bash
tigrcorn examples.echo_http.app:app \
  --log-level info \
  --structured-log \
  --metrics \
  --metrics-bind 127.0.0.1:9100 \
  --workers 4 \
  --runtime auto \
  --reload \
  --reload-dir ./src
```

#### Unix sockets and custom transports

```bash
tigrcorn examples.echo_http.app:app \
  --transport unix \
  --uds /tmp/tigrcorn.sock
```

```bash
tigrcorn examples.echo_http.app:app \
  --transport pipe \
  --pipe-mode rawframed \
  --protocol rawframed
```

#### Interoperability matrices

```bash
tigrcorn-interop \
  --matrix docs/review/conformance/external_matrix.release.json \
  --output ./artifacts/interop
```

Use [current-release external matrix](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/external_matrix.current_release.json) for the current-release bundle contract and [same-stack replay matrix](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/external_matrix.same_stack_replay.json) for same-stack replay coverage.

## Public API and embedding usage

The public import surface is documented in full in [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md). Lifecycle guarantees for embedded use live in [lifecycle and embedded server guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/LIFECYCLE_AND_EMBEDDED_SERVER.md).

### Public import map

| Import surface | What it is for |
|---|---|
| `tigrcorn.run` | sync convenience entrypoint |
| `tigrcorn.serve` | async entrypoint for an in-memory ASGI app |
| `tigrcorn.serve_import_string` | async entrypoint for an import string |
| `tigrcorn.EmbeddedServer` | explicit embedding and lifecycle control |
| `tigrcorn.StaticFilesApp` | standalone static ASGI app |
| `tigrcorn.static.mount_static_app` | mount static delivery into another ASGI app |
| `tigrcorn.static.normalize_static_route` | normalize public static route input |
| `tigrcorn.config.build_config` | build `ServerConfig` from explicit keyword args |
| `tigrcorn.config.build_config_from_namespace` | convert argparse namespace into config |
| `tigrcorn.config.build_config_from_sources` | merge CLI overrides, config file, and environment |
| `tigrcorn.config.config_to_dict` | inspect or serialize config |
| `tigrcorn.config.load_env_config` | load prefixed environment config |
| `tigrcorn.config.load_config_file` | load TOML / JSON / optional YAML config |
| `tigrcorn.compat.release_gates.evaluate_release_gates` | evaluate release-gate readiness |
| `tigrcorn.compat.release_gates.evaluate_promotion_target` | evaluate promotion-target readiness |
| `tigrcorn.compat.release_gates.assert_release_ready` | fail fast if release gates are not satisfied |
| `tigrcorn.compat.release_gates.assert_promotion_target_ready` | fail fast if promotion target is not satisfied |

### Usage snippets

#### Run from sync code

```python
from tigrcorn import run

run(
    "examples.echo_http.app:app",
    host="127.0.0.1",
    port=8000,
    http_versions=["1.1", "2"],
)
```

#### Run inside an existing event loop

```python
from tigrcorn import serve

async def app(scope, receive, send):
    ...

await serve(app, host="127.0.0.1", port=8000)
```

#### Load an import string inside async code

```python
from tigrcorn import serve_import_string

await serve_import_string(
    "examples.websocket_echo.app:app",
    host="127.0.0.1",
    port=9000,
)
```

#### Embed the server and control lifecycle directly

```python
from tigrcorn import EmbeddedServer
from tigrcorn.config import build_config

config = build_config(host="127.0.0.1", port=0, lifespan="on")

async with EmbeddedServer(app, config) as embedded:
    print(embedded.listeners)
    print(embedded.bound_endpoints())
```

#### Mount static delivery

```python
from tigrcorn.static import mount_static_app

app = mount_static_app(
    app,
    route="/assets",
    directory="./public",
    apply_content_coding=True,
    content_coding_policy="allowlist",
)
```

#### Build config from sources

```python
from tigrcorn.config import build_config_from_sources

config = build_config_from_sources(
    config_path="./tigrcorn.toml",
    env_prefix="TIGRCORN",
    env_file=".env",
    cli_overrides={
        "app": {"target": "examples.echo_http.app:app"},
        "logging": {"level": "debug"},
    },
)
```

#### Evaluate release and promotion state

```python
from tigrcorn.compat.release_gates import evaluate_promotion_target, evaluate_release_gates

release_report = evaluate_release_gates(".")
promotion_report = evaluate_promotion_target(".")

print(release_report.passed)
print(promotion_report.passed)
```

## Current scope

### Current supported runtime surface

| Runtime | Status | Source |
|---|---|---|
| `auto` | supported | [certification boundary](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md) |
| `asyncio` | supported | [certification boundary](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md) |
| `uvloop` | supported | [certification boundary](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md), [optional dependency surface](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/OPTIONAL_DEPENDENCY_SURFACE.md) |
| `trio` | reserved dependency path, not supported | [boundary non-goals](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/BOUNDARY_NON_GOALS.md) |

### Out-of-boundary families

| Family | Current location |
|---|---|
| Trio as a supported runtime family | [boundary non-goals](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/BOUNDARY_NON_GOALS.md) |
| WSGI / ASGI2 / RSGI compatibility layers | [boundary non-goals](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/BOUNDARY_NON_GOALS.md) |
| Parser pluggability | [boundary non-goals](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/BOUNDARY_NON_GOALS.md) |
| WebSocket engine pluggability | [boundary non-goals](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/BOUNDARY_NON_GOALS.md) |
| RFC 9111 caching | [RFC applicability and competitor status](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/RFC_APPLICABILITY_AND_COMPETITOR_STATUS.md) |
| RFC 9530 digest fields | [RFC applicability and competitor status](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/RFC_APPLICABILITY_AND_COMPETITOR_STATUS.md) |
| RFC 9421 message signatures | [RFC applicability and competitor status](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/RFC_APPLICABILITY_AND_COMPETITOR_STATUS.md) |
| JOSE / COSE layers | [RFC applicability and competitor status](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/RFC_APPLICABILITY_AND_COMPETITOR_STATUS.md) |

## Status at a glance

| Topic | Current source of truth |
|---|---|
| Repo line | `0.3.16.dev5` in `pyproject.toml` and the shipped facade import surface |
| Current state | [current repository state](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/state/CURRENT_REPOSITORY_STATE.md) |
| Canonical machine-readable registry | [`.ssot/registry.json`](https://github.com/tigrbl/tigrcorn/blob/master/.ssot/registry.json) |
| Current-state chain | [current-state chain](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CURRENT_STATE_CHAIN.md), [current-state chain JSON](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/current_state_chain.current.json) |
| Authoritative boundary | [certification boundary](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md) |
| Strict profile | [strict profile target](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/STRICT_PROFILE_TARGET.md) |
| Canonical promoted root | [canonical promoted root](https://github.com/tigrbl/tigrcorn/tree/master/docs/review/conformance/releases/0.3.9/release-0.3.9/) |
| Operator docs | [operator docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/README.md), [CLI docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md), [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md) |
| Lifecycle and embedding contract | [lifecycle and embedded server guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/LIFECYCLE_AND_EMBEDDED_SERVER.md) |
| Optional dependency truth | [optional dependency surface](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/OPTIONAL_DEPENDENCY_SURFACE.md), [optional dependency surface JSON](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/optional_dependency_surface.current.json) |
| External evidence inputs | [same-stack replay matrix](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/external_matrix.same_stack_replay.json), [release external matrix](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/external_matrix.release.json), [current-release external matrix](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/external_matrix.current_release.json) |
| Planning and promotion checkpoints | [Phase 9 implementation plan](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/PHASE9_IMPLEMENTATION_PLAN.md), [Phase 9A promotion contract freeze](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/PHASE9A_PROMOTION_CONTRACT_FREEZE.md) |

### Current repository claim

Under [certification boundary](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md), the package is **certifiably fully RFC compliant under the authoritative certification boundary**. The canonical promoted root at [canonical promoted root](https://github.com/tigrbl/tigrcorn/tree/master/docs/review/conformance/releases/0.3.9/release-0.3.9/) is **strict-target certifiably fully RFC compliant** and **certifiably fully featured**.[^boundary]

## Validation and promotion

A practical maintainer validation pass looks like this:

```bash
python tools/govchk.py scan
PYTHONPATH=src python -m compileall -q src benchmarks tools
PYTHONPATH=src pytest -q
```

Promotion-facing evaluators:

```bash
PYTHONPATH=src python - <<'PY'
from tigrcorn.compat.release_gates import evaluate_release_gates, evaluate_promotion_target

print(evaluate_release_gates('.').passed)
print(
    evaluate_release_gates(
        '.',
        boundary_path='docs/review/conformance/certification_boundary.strict_target.json',
    ).passed
)
print(evaluate_promotion_target('.').passed)
PY
```

Read next:

- [release workflow guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/release.md)
- [release gate status](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/RELEASE_GATE_STATUS.md)
- [strict profile target](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/STRICT_PROFILE_TARGET.md)
- [flag certification target](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/FLAG_CERTIFICATION_TARGET.md)
- [Phase 9A promotion contract freeze](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/PHASE9A_PROMOTION_CONTRACT_FREEZE.md)

## Where to look

| If you are... | Start here | Then go to |
|---|---|---|
| Launching Tigrcorn as an operator | [CLI docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/cli.md) | [deployment profiles reference](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/DEPLOYMENT_PROFILES.md) |
| Embedding Tigrcorn in another process | [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md) | [lifecycle and embedded server guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/LIFECYCLE_AND_EMBEDDED_SERVER.md) |
| Working on static or delivery behavior | [public API docs](https://github.com/tigrbl/tigrcorn/blob/master/docs/ops/public.md) | [static delivery example](https://github.com/tigrbl/tigrcorn/blob/master/examples/http_entity_static/app.py) |
| Reviewing current repository truth | [current repository state](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/state/CURRENT_REPOSITORY_STATE.md) | [current-state chain JSON](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/current_state_chain.current.json) |
| Reviewing the promoted release root | [canonical promoted root](https://github.com/tigrbl/tigrcorn/tree/master/docs/review/conformance/releases/0.3.9/release-0.3.9/) | [release notes 0.3.9](https://github.com/tigrbl/tigrcorn/blob/master/docs/release-notes/RELEASE_NOTES_0.3.9.md) |
| Reviewing the boundary or current scope | [certification boundary](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md) | [boundary non-goals](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/BOUNDARY_NON_GOALS.md) |
| Comparing Tigrcorn with peer servers | [RFC comparison](https://github.com/tigrbl/tigrcorn/blob/master/docs/comp/rfc.md) | [CLI comparison](https://github.com/tigrbl/tigrcorn/blob/master/docs/comp/cli.md), [operations comparison](https://github.com/tigrbl/tigrcorn/blob/master/docs/comp/ops.md), [out-of-bound comparison](https://github.com/tigrbl/tigrcorn/blob/master/docs/comp/oob.md) |
| Writing or maintaining docs | [authoring guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/authoring.md) | [`CONTRIBUTING.md`](https://github.com/tigrbl/tigrcorn/blob/master/CONTRIBUTING.md), [tree rules](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/tree.md), [mutability rules](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/mut.md) |
| Working on release or promotion | [release workflow guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/release.md) | [Phase 9A promotion contract freeze](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/PHASE9A_PROMOTION_CONTRACT_FREEZE.md) |

## Contributing, conduct, and community norms

- [`CONTRIBUTING.md`](https://github.com/tigrbl/tigrcorn/blob/master/CONTRIBUTING.md) explains how to make changes without drifting from the boundary, tests, current-state chain, or release evidence.
- [`CODE_OF_CONDUCT.md`](https://github.com/tigrbl/tigrcorn/blob/master/CODE_OF_CONDUCT.md) defines participation expectations and reporting guidance.
- [authoring guide](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/authoring.md) explains how maintainers and authors should update the repository without creating truth conflicts.
- [tree rules](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/tree.md) and [mutability rules](https://github.com/tigrbl/tigrcorn/blob/master/docs/gov/mut.md) explain where new files belong and which trees are frozen.

## Footnotes

[^boundary]: Certification language in this repository is scoped by [certification boundary](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/CERTIFICATION_BOUNDARY.md) and [current repository state](https://github.com/tigrbl/tigrcorn/blob/master/docs/review/conformance/state/CURRENT_REPOSITORY_STATE.md). The current package claim and the promoted-root claim are related, but they are not the same statement.

[^freeze]: The freeze preserves the release-workflow contract even when the local working environment is missing a certification dependency such as `aioquic`.
