mkdocs-owl-api 0.1.0__py3-none-any.whl

mkdocs_owl_api/render/openapi.py

@@ -0,0 +1,293 @@
+"""
+OpenAPI 3.x page renderer.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .common import (
+    _anchor,
+    _build_description_block,
+    _demote_headings,
+    _format_type,
+    _heading,
+    _md_to_html,
+    _pill,
+    _ref_link,
+    _render_downloads_table,
+    _render_schema,
+    _render_security_inline,
+    _schema_depth,
+)
+
+_HTTP_METHODS = ("get", "post", "put", "delete", "patch", "head", "options", "trace")
+
+
+def _openapi_method_pill(method: str) -> str:
+    return _pill(method.upper(), kind=f"http-{method}")
+
+
+def _openapi_render_parameters(params: list[dict[str, Any]]) -> str:
+    if not params:
+        return ""
+    parts: list[str] = [
+        '<table>',
+        '<thead>',
+        '<tr><th>Name</th><th>In</th><th>Type</th><th>Description</th></tr>',
+        '</thead>',
+        '<tbody>',
+    ]
+    for p in params:
+        if not isinstance(p, dict):
+            continue
+        name = p.get("name", "")
+        in_ = p.get("in", "")
+        schema = p.get("schema") or {}
+        type_str = _format_type(schema)
+
+        name_md = f"`{name}`"
+        pills: list[str] = []
+        if p.get("required"):
+            pills.append(_pill("required", kind="required"))
+        if p.get("deprecated") or schema.get("deprecated"):
+            pills.append(_pill("deprecated", kind="deprecated"))
+        if pills:
+            name_md += "<br>" + " ".join(pills)
+        name_html = _md_to_html(name_md, inline=True)
+
+        type_html = _md_to_html(type_str, inline=True)
+
+        merged = dict(schema)
+        pdesc = (p.get("description") or "").strip()
+        if pdesc:
+            merged["description"] = pdesc
+        if p.get("example") is not None and "example" not in merged:
+            merged["example"] = p["example"]
+        desc_block = _build_description_block(merged)
+        desc_html = _md_to_html(desc_block) if desc_block else "&mdash;"
+
+        in_html = _md_to_html(f"`{in_}`", inline=True)
+        parts.append(f"<tr><td>{name_html}</td><td>{in_html}</td><td>{type_html}</td><td>{desc_html}</td></tr>")
+    parts.append('</tbody>')
+    parts.append('</table>')
+    parts.append("")
+    return "\n".join(parts)
+
+
+def _openapi_render_request_body(rb: dict[str, Any], spec: dict[str, Any], *, hide_internal: bool) -> str:
+    if not rb:
+        return ""
+    parts: list[str] = []
+    desc = (rb.get("description") or "").strip()
+    if desc:
+        parts.append(desc)
+        parts.append("")
+    content = rb.get("content") or {}
+    for media_type, media_obj in content.items():
+        parts.append(f"*Content type:* {_pill(media_type, kind='contenttype')}")
+        parts.append("")
+        schema = (media_obj or {}).get("schema") or {}
+        if "$ref" in schema:
+            parts.append(f"*Schema:* {_ref_link(schema['$ref'])}")
+            parts.append("")
+        elif schema.get("type"):
+            parts.append(f"*Schema:* {_format_type(schema)}")
+            parts.append("")
+    return "\n".join(parts)
+
+
+def _openapi_render_responses(responses: dict[str, Any], spec: dict[str, Any]) -> str:
+    if not responses:
+        return ""
+    parts: list[str] = [
+        "**Responses**",
+        "",
+        '<table>',
+        '<thead>',
+        '<tr><th>Status</th><th>Description</th><th>Schema</th></tr>',
+        '</thead>',
+        '<tbody>',
+    ]
+    for code, resp in responses.items():
+        if not isinstance(resp, dict):
+            continue
+        desc = (resp.get("description") or "").strip()
+        desc_html = _md_to_html(desc, inline=True) if desc else "&mdash;"
+        schema_html = "&mdash;"
+        content = resp.get("content") or {}
+        bits: list[tuple[str, str]] = []
+        for mt, media_obj in content.items():
+            schema = (media_obj or {}).get("schema") or {}
+            if "$ref" in schema:
+                bits.append((mt, _ref_link(schema["$ref"])))
+            elif schema.get("type"):
+                bits.append((mt, _format_type(schema)))
+            else:
+                bits.append((mt, "`object`"))
+        if len(bits) == 1:
+            schema_html = _md_to_html(bits[0][1], inline=True)
+        elif bits:
+            schema_html = _md_to_html(
+                "<br>".join(f"`{mt}`: {sch}" for mt, sch in bits), inline=True,
+            )
+        code_html = _md_to_html(f"`{code}`", inline=True)
+        parts.append(f"<tr><td>{code_html}</td><td>{desc_html}</td><td>{schema_html}</td></tr>")
+    parts.append('</tbody>')
+    parts.append('</table>')
+    parts.append("")
+    return "\n".join(parts)
+
+
+def _render_openapi_page(
+    spec: dict[str, Any],
+    opts: dict[str, Any],
+    *,
+    spec_url: str = "",
+    attachments: list[dict[str, Any]] | None = None,
+) -> str:
+    info = spec.get("info") or {}
+    title = (opts.get("title") or info.get("title") or "API Reference").strip()
+    intro = (opts.get("intro") or "").strip()
+    hide_version = bool(opts.get("hide_version"))
+    hide_internal = bool(opts.get("hide_internal"))
+    hide_download = bool(opts.get("hide_download_link"))
+
+    parts: list[str] = [f"# {title}", ""]
+
+    if intro:
+        parts.append(intro)
+        parts.append("")
+
+    version = (info.get("version") or "").strip()
+    if version and not hide_version:
+        parts.append(f"**Version:** `{version}`")
+        parts.append("")
+
+    downloads = _render_downloads_table(spec_url, attachments or [], hide_download=hide_download)
+    if downloads:
+        parts.append(downloads)
+
+    description = (info.get("description") or "").strip()
+    if description:
+        parts.append(_demote_headings(description))
+        parts.append("")
+
+    servers = spec.get("servers")
+    if isinstance(servers, list) and servers:
+        parts.append("## Servers")
+        parts.append("")
+        for srv in servers:
+            if not isinstance(srv, dict):
+                continue
+            url = srv.get("url", "")
+            desc = (srv.get("description") or "").strip()
+            parts.append(f"- `{url}`" + (f" — {desc}" if desc else ""))
+            variables = srv.get("variables")
+            if isinstance(variables, dict) and variables:
+                for vname, v in variables.items():
+                    if not isinstance(v, dict):
+                        continue
+                    bits: list[str] = []
+                    if v.get("default") is not None:
+                        bits.append(f"default `{v['default']}`")
+                    enum = v.get("enum")
+                    if isinstance(enum, list) and enum:
+                        bits.append("one of " + ", ".join(f"`{e}`" for e in enum))
+                    vdesc = (v.get("description") or "").strip()
+                    if vdesc:
+                        bits.append(vdesc)
+                    suffix = (" — " + "; ".join(bits)) if bits else ""
+                    parts.append(f"    - `{{{vname}}}`{suffix}")
+        parts.append("")
+
+    paths = spec.get("paths") or {}
+    if paths:
+        tag_descriptions: dict[str, str] = {}
+        for t in (spec.get("tags") or []):
+            if isinstance(t, dict) and t.get("name"):
+                tag_descriptions[t["name"]] = (t.get("description") or "").strip()
+
+        _DEFAULT_TAG = "Endpoints"
+        grouped: dict[str, list[tuple[str, str, dict, list]]] = {}
+        for path, path_obj in paths.items():
+            if not isinstance(path_obj, dict):
+                continue
+            path_params = path_obj.get("parameters") or []
+            for method in _HTTP_METHODS:
+                op = path_obj.get(method)
+                if not isinstance(op, dict):
+                    continue
+                tags = op.get("tags") or [_DEFAULT_TAG]
+                for tag in tags:
+                    grouped.setdefault(tag, []).append((path, method, op, path_params))
+
+        for tag_name, ops in grouped.items():
+            parts.append(_heading(2, tag_name, anchor=_anchor("tag", tag_name)))
+            parts.append("")
+            tag_desc = tag_descriptions.get(tag_name, "")
+            if tag_desc:
+                parts.append(_demote_headings(tag_desc))
+                parts.append("")
+
+            for path, method, op, path_params in ops:
+                summary = (op.get("summary") or "").strip()
+                heading_text = summary or f"`{path}`"
+                anchor = _anchor("endpoints", f"{tag_name}-{method}-{path}")
+                parts.append(_heading(3, heading_text, anchor=anchor))
+                parts.append("")
+                method_line = f"{_openapi_method_pill(method)} `{path}`"
+                if op.get("deprecated"):
+                    method_line += " " + _pill("deprecated", kind="deprecated")
+                parts.append(method_line)
+                parts.append("")
+
+                desc = (op.get("description") or "").strip()
+                if desc:
+                    parts.append(_demote_headings(desc))
+                    parts.append("")
+
+                op_params = op.get("parameters") or []
+                all_params = path_params + op_params
+                if all_params:
+                    parts.append("**Parameters**")
+                    parts.append("")
+                    parts.append(_openapi_render_parameters(all_params))
+
+                rb = op.get("requestBody") or {}
+                if rb:
+                    parts.append("**Request body**")
+                    parts.append("")
+                    parts.append(_openapi_render_request_body(rb, spec, hide_internal=hide_internal))
+
+                responses = op.get("responses") or {}
+                if responses:
+                    parts.append(_openapi_render_responses(responses, spec))
+
+                security = op.get("security")
+                if isinstance(security, list) and security:
+                    blocks = [b for b in (_render_security_inline(spec, e) for e in security) if b]
+                    if blocks:
+                        parts.append("**Security**")
+                        parts.append("")
+                        for b in blocks:
+                            parts.append(b)
+                            parts.append("")
+
+    schemas = (spec.get("components") or {}).get("schemas") or {}
+    if schemas:
+        max_depth = _schema_depth(opts)
+        parts.append("## Schemas")
+        parts.append("")
+        for sname, sch in schemas.items():
+            if not isinstance(sch, dict):
+                continue
+            parts.append(_heading(3, sname, anchor=_anchor("schemas", sname)))
+            parts.append("")
+            parts.append(_render_schema(sch, hide_internal=hide_internal, max_depth=max_depth))
+            parts.append("")
+
+    while parts and parts[-1] in ("", "---"):
+        parts.pop()
+
+    return "\n".join(parts)

mkdocs_owl_api/static/techdocs-owl-api.css

@@ -0,0 +1,109 @@
+.techdocs-owl-api-pill {
+  display: inline-block;
+  padding: 0.05em 0.55em;
+  margin: 0 0.15em 0.15em 0;
+  border-radius: 999px;
+  background: var(--md-default-fg-color--lightest);
+  color: var(--md-default-fg-color);
+  font-size: 0.78em;
+  font-family: var(--md-code-font-family, monospace);
+  font-weight: 500;
+  line-height: 1.5;
+  white-space: nowrap;
+  vertical-align: 0.05em;
+  cursor: default;
+}
+
+.techdocs-owl-api-pill--action-send {
+  background: hsla(200, 80%, 55%, 0.12);
+  color: hsl(200, 80%, 55%);
+  border: 1px solid hsl(200, 80%, 55%);
+}
+.techdocs-owl-api-pill--action-receive {
+  background: hsla(160, 60%, 45%, 0.12);
+  color: hsl(160, 60%, 45%);
+  border: 1px solid hsl(160, 60%, 45%);
+}
+.techdocs-owl-api-pill--action-publish {
+  background: hsla(200, 80%, 55%, 0.12);
+  color: hsl(200, 80%, 55%);
+  border: 1px solid hsl(200, 80%, 55%);
+}
+.techdocs-owl-api-pill--action-subscribe {
+  background: hsla(160, 60%, 45%, 0.12);
+  color: hsl(160, 60%, 45%);
+  border: 1px solid hsl(160, 60%, 45%);
+}
+
+.techdocs-owl-api-pill--required {
+  background: hsla(350, 80%, 55%, 0.12);
+  color: hsl(350, 80%, 55%);
+  border: 1px solid hsl(350, 80%, 55%);
+}
+.techdocs-owl-api-pill--internal {
+  background: hsla(40, 90%, 50%, 0.12);
+  color: hsl(40, 90%, 50%);
+  border: 1px solid hsl(40, 90%, 50%);
+}
+.techdocs-owl-api-pill--deprecated {
+  background: hsla(0, 0%, 55%, 0.12);
+  color: hsl(0, 0%, 55%);
+  border: 1px solid hsl(0, 0%, 55%);
+  text-decoration: line-through;
+}
+
+.techdocs-owl-api-pill--protocol {
+  background: hsla(270, 60%, 60%, 0.12);
+  color: hsl(270, 60%, 60%);
+  border: 1px solid hsl(270, 60%, 60%);
+}
+.techdocs-owl-api-pill--contenttype {
+  background: hsla(30, 80%, 55%, 0.12);
+  color: hsl(30, 80%, 55%);
+  border: 1px solid hsl(30, 80%, 55%);
+}
+.techdocs-owl-api-pill--scheme {
+  background: hsla(180, 60%, 45%, 0.12);
+  color: hsl(180, 60%, 45%);
+  border: 1px solid hsl(180, 60%, 45%);
+}
+
+.techdocs-owl-api-pill--tag {
+  background: hsla(220, 50%, 55%, 0.12);
+  color: hsl(220, 50%, 55%);
+  border: 1px solid hsl(220, 50%, 55%);
+  cursor: help;
+}
+
+.techdocs-owl-api-pill--http-get {
+  background: hsla(140, 60%, 45%, 0.12);
+  color: hsl(140, 60%, 45%);
+  border: 1px solid hsl(140, 60%, 45%);
+}
+.techdocs-owl-api-pill--http-post {
+  background: hsla(210, 70%, 55%, 0.12);
+  color: hsl(210, 70%, 55%);
+  border: 1px solid hsl(210, 70%, 55%);
+}
+.techdocs-owl-api-pill--http-put {
+  background: hsla(30, 80%, 55%, 0.12);
+  color: hsl(30, 80%, 55%);
+  border: 1px solid hsl(30, 80%, 55%);
+}
+.techdocs-owl-api-pill--http-delete {
+  background: hsla(0, 70%, 55%, 0.12);
+  color: hsl(0, 70%, 55%);
+  border: 1px solid hsl(0, 70%, 55%);
+}
+.techdocs-owl-api-pill--http-patch {
+  background: hsla(280, 60%, 55%, 0.12);
+  color: hsl(280, 60%, 55%);
+  border: 1px solid hsl(280, 60%, 55%);
+}
+.techdocs-owl-api-pill--http-head,
+.techdocs-owl-api-pill--http-options,
+.techdocs-owl-api-pill--http-trace {
+  background: hsla(0, 0%, 55%, 0.12);
+  color: hsl(0, 0%, 55%);
+  border: 1px solid hsl(0, 0%, 55%);
+}

mkdocs_owl_api-0.1.0.dist-info/METADATA

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: mkdocs-owl-api
+Version: 0.1.0
+Summary: MkDocs plugin from TechDocs Owl, renders AsyncAPI and OpenAPI specs into reference pages
+Project-URL: Homepage, https://github.com/techdocs-owl/mkdocs-owl-api
+Project-URL: Repository, https://github.com/techdocs-owl/mkdocs-owl-api
+Project-URL: Issues, https://github.com/techdocs-owl/mkdocs-owl-api/issues
+Author-email: Dima Patserkovskyi <dmtwngtech@pm.me>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api-reference,asyncapi,documentation,mkdocs,mkdocs-plugin,openapi
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: MkDocs
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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: Topic :: Documentation
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.9
+Requires-Dist: markdown>=3.4
+Requires-Dist: mkdocs>=1.5
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+# techdocs-owl-api
+
+MkDocs plugin that renders AsyncAPI and OpenAPI specs into reference pages
+at build time.
+
+## Install
+
+```bash
+pip install mkdocs-owl-api
+```
+
+```yaml
+# mkdocs.yml
+plugins:
+  - search
+  - owl-api
+```
+
+Add a page with a `techdocs-owl-asyncapi:` or `techdocs-owl-openapi:`
+frontmatter key and an empty body — the plugin fills it in at build time.
+
+```markdown
+---
+techdocs-owl-asyncapi: ../specs/asyncapi.yml
+---
+```
+
+Supports AsyncAPI 2.x/3.0 and OpenAPI 3.x (YAML or JSON), local paths or
+HTTP(S) URLs, recursive `$ref` resolution, and a bundled stylesheet
+(auto-injected, no `extra_css` setup needed).
+
+## Site-wide defaults
+
+```yaml
+plugins:
+  - owl-api:
+      schema_depth: 3
+      hide_internal: false
+      hide_bindings: false
+      hide_traits: false
+      hide_security: false
+      hide_version: false
+      hide_download_link: false
+```
+
+Page frontmatter overrides these per-page.
+
+## AsyncAPI pages
+
+```markdown
+---
+techdocs-owl-asyncapi:
+  spec: https://schema.example.com/my-service-asyncapi
+  title: My Service Events
+  intro: One-paragraph intro shown above the spec body.
+  schema_depth: 3
+---
+```
+
+| Key | Type | Default | Effect |
+|---|---|---|---|
+| `spec` | string | — | **Required.** Path or URL to the spec file. |
+| `title` | string | `info.title` | Page H1. |
+| `intro` | markdown | — | Shown between the title and metadata block. |
+| `hide_version` | bool | `false` | Hide the version line. |
+| `hide_internal` | bool | `false` | Drop properties marked `x-internal-only: true`. |
+| `hide_bindings` | bool | `false` | Skip bindings on servers/channels/operations/messages. |
+| `hide_traits` | bool | `false` | Skip trait sections and references. |
+| `hide_security` | bool | `false` | Skip security admonitions. |
+| `hide_download_link` | bool | `false` | Hide the spec download link. |
+| `schema_depth` | int | `3` | Depth of dot-path flattening for nested object properties. |
+| `attachments` | list | — | Extra files to copy and list in the downloads table. |
+
+Renders, in order: info, Servers, Operations (operation-centric across
+both AsyncAPI versions), Messages, Schemas, Parameters, Traits — sections
+absent from the spec are skipped.
+
+## OpenAPI pages
+
+```markdown
+---
+techdocs-owl-openapi: https://petstore3.swagger.io/api/v3/openapi.json
+---
+```
+
+| Key | Type | Default | Effect |
+|---|---|---|---|
+| `spec` | string | — | **Required.** Path or URL to the spec file. |
+| `title` | string | `info.title` | Page H1. |
+| `intro` | markdown | — | Shown between the title and metadata block. |
+| `hide_version` | bool | `false` | Hide the version line. |
+| `hide_internal` | bool | `false` | Drop `x-internal-only` properties. |
+| `hide_download_link` | bool | `false` | Hide the spec download link. |
+| `schema_depth` | int | `3` | Depth of dot-path flattening for nested object properties. |
+| `attachments` | list | — | Extra files to copy and list in the downloads table. |
+
+Renders: info, Servers, endpoints grouped by tag (parameters, request
+body, responses, security), Schemas.
+
+## Downloads & attachments
+
+The resolved spec (external `$ref`s inlined) is written to
+`assets/techdocs-owl-api/<page-slug>.json` and linked from a Downloads
+table. Add extra files (e.g. `.proto` schemas) with `attachments`:
+
+```markdown
+---
+techdocs-owl-asyncapi:
+  spec: ../specs/asyncapi.yml
+  attachments:
+    - path: ../schemas/customer.proto
+      title: Customer Protobuf Schema
+    - ../schemas/order.proto   # shorthand: path only, title = filename
+---
+```
+
+## Error handling
+
+Errors (missing/unreadable spec, network failures, parse errors, bad
+frontmatter) render as a `!!! danger` admonition instead of failing the
+build.
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+```

mkdocs_owl_api-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+mkdocs_owl_api/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+mkdocs_owl_api/loader.py,sha256=Q6imBzhVS-drOG1mBIsW0QA_ZRLkKEG5OSQW_kYuOx4,7782
+mkdocs_owl_api/plugin.py,sha256=ikgqN-zL6DMdaPIQ657qlH490ujeB9zQsTTAfc0v18o,3374
+mkdocs_owl_api/render/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mkdocs_owl_api/render/asyncapi.py,sha256=vF13OxbkMUjSHqNFrIyh7zEgXLZHEN8QfrIotJBlOfk,17788
+mkdocs_owl_api/render/common.py,sha256=mH9tNRghEH3RzW99UndbRVpbuun8-RhpO-5fps01zpI,18771
+mkdocs_owl_api/render/openapi.py,sha256=VH9y-lb9V5rN7G9KcmVF2gLM-FouEoKVuJYfoMWitDI,10720
+mkdocs_owl_api/static/techdocs-owl-api.css,sha256=DEZ4Id-kfBcC6yFCjRxupVZsa9decjoS2GyIsvsNXA0,3025
+mkdocs_owl_api-0.1.0.dist-info/METADATA,sha256=JatLxKyfeCXF4Qqtzew78MUxc4d50qEorNcVJioEYcg,4994
+mkdocs_owl_api-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+mkdocs_owl_api-0.1.0.dist-info/entry_points.txt,sha256=QqZ4GwAVPpKIzpUBqT4-ByK6xWlbSkZXimeJO1z9z-Q,62
+mkdocs_owl_api-0.1.0.dist-info/licenses/LICENSE,sha256=rX9oWAHzz3SB6uV6FA9MTTwQ5iggOo9A5WpiskJFGUM,1069
+mkdocs_owl_api-0.1.0.dist-info/RECORD,,

mkdocs_owl_api-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

mkdocs_owl_api-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[mkdocs.plugins]
+owl-api = mkdocs_owl_api.plugin:OwlApiPlugin

mkdocs_owl_api-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TechDocs Owl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.