[
{
"path": ".dockerignore",
"content": "*.pyc\n.venv*\n.vscode\n.mypy_cache\n.coverage\nhtmlcov\n\ndist\ntest.py\n\n"
},
{
"path": ".github/FUNDING.yml",
"content": "# polar: django-ninja\ncustom: [\"https://www.buymeacoffee.com/djangoninja\"]\n"
},
{
"path": ".github/ISSUE_TEMPLATE/bug_report.md",
"content": "---\nname: Bug report\nabout: Create a report to help us improve\ntitle: \"[BUG] \"\nlabels: ''\nassignees: ''\n\n---\n\n**Describe the bug**\nA clear and concise description of what the bug is.\n\n**Versions (please complete the following information):**\n - Python version: [e.g. 3.6]\n - Django version: [e.g. 4.0]\n - Django-Ninja version: [e.g. 0.16.2]\n - Pydantic version: [e.g. 1.9.0]\n\nNote you can quickly get this by runninng in `./manage.py shell` this line:\n```\nimport django; import pydantic; import ninja; django.__version__; ninja.__version__; pydantic.__version__\n```\n"
},
{
"path": ".github/ISSUE_TEMPLATE/feature_request.md",
"content": "---\nname: Feature request\nabout: Suggest an idea for this project\ntitle: ''\nlabels: ''\nassignees: ''\n\n---\n\n**Is your feature request related to a problem? Please describe.**\nA clear and concise description of what the problem is. Ex. I'm always frustrated when [...]\n\n**Describe the solution you'd like**\nA clear and concise description of what you want to happen.\n"
},
{
"path": ".github/ISSUE_TEMPLATE/question.md",
"content": "---\nname: Question\nabout: Having troubles implementing something ?\ntitle: ''\nlabels: ''\nassignees: ''\n\n---\n\nPlease describe what you are trying to achieve\n\nPlease include code examples (like models code, schemes code, view function) to help understand the issue\n"
},
{
"path": ".github/dependabot.yml",
"content": "version: 2\n\nupdates:\n - package-ecosystem: \"github-actions\"\n directory: \"/\"\n schedule:\n interval: monthly\n"
},
{
"path": ".github/workflows/close-old-issues.yml",
"content": "name: Close Old Issues\n\non:\n workflow_dispatch:\n inputs:\n days_old:\n description: 'Close issues older than N days'\n required: true\n default: '365'\n type: number\n dry_run:\n description: 'Dry run mode (preview only, do not close)'\n required: true\n default: true\n type: boolean\n comment_on_close:\n description: 'Add comment when closing issues'\n required: true\n default: true\n type: boolean\n\njobs:\n close-old-issues:\n runs-on: ubuntu-latest\n permissions:\n issues: write\n\n steps:\n - name: Close or list old issues\n uses: actions/github-script@v8\n with:\n script: |\n const daysOld = ${{ inputs.days_old }};\n const dryRun = ${{ inputs.dry_run }};\n const addComment = ${{ inputs.comment_on_close }};\n const cutoffDate = new Date();\n cutoffDate.setDate(cutoffDate.getDate() - daysOld);\n\n console.log(`Looking for issues older than ${daysOld} days (before ${cutoffDate.toISOString()})`);\n console.log(`Dry run mode: ${dryRun ? 'YES (no changes will be made)' : 'NO (issues will be closed)'}`);\n console.log('---');\n\n let page = 1;\n let issuesClosed = 0;\n let issuesToClose = [];\n\n while (true) {\n const issues = await github.rest.issues.listForRepo({\n owner: context.repo.owner,\n repo: context.repo.repo,\n state: 'open',\n sort: 'created',\n direction: 'asc',\n per_page: 100,\n page: page\n });\n\n if (issues.data.length === 0) {\n break;\n }\n\n for (const issue of issues.data) {\n // Skip pull requests\n if (issue.pull_request) {\n continue;\n }\n\n const createdAt = new Date(issue.created_at);\n const updatedAt = new Date(issue.updated_at);\n\n // Check if issue is old enough based on last update\n if (updatedAt < cutoffDate) {\n const daysOldCalculated = Math.floor((Date.now() - updatedAt.getTime()) / (1000 * 60 * 60 * 24));\n\n issuesToClose.push({\n number: issue.number,\n title: issue.title,\n created_at: createdAt.toISOString().split('T')[0],\n updated_at: updatedAt.toISOString().split('T')[0],\n days_old: daysOldCalculated,\n url: issue.html_url\n });\n }\n }\n\n page++;\n }\n\n console.log(`\\nFound ${issuesToClose.length} issue(s) to close:\\n`);\n\n for (const issue of issuesToClose) {\n console.log(`#${issue.number}: ${issue.title}`);\n console.log(` Created: ${issue.created_at}`);\n console.log(` Last updated: ${issue.updated_at} (${issue.days_old} days ago)`);\n console.log(` URL: ${issue.url}`);\n console.log('');\n\n if (!dryRun) {\n try {\n // Add a comment before closing (if enabled)\n if (addComment) {\n await github.rest.issues.createComment({\n owner: context.repo.owner,\n repo: context.repo.repo,\n issue_number: issue.number,\n body: `This issue has been automatically closed due to inactivity (no updates for ${issue.days_old} days). If you believe this issue is still relevant, please feel free to reopen it or create a new issue.`\n });\n }\n\n // Close the issue\n await github.rest.issues.update({\n owner: context.repo.owner,\n repo: context.repo.repo,\n issue_number: issue.number,\n state: 'closed',\n state_reason: 'not_planned'\n });\n\n issuesClosed++;\n console.log(` ✓ Closed issue #${issue.number}`);\n } catch (error) {\n console.error(` ✗ Failed to close issue #${issue.number}: ${error.message}`);\n }\n }\n }\n\n console.log('\\n---');\n if (dryRun) {\n console.log(`DRY RUN: Would close ${issuesToClose.length} issue(s)`);\n console.log('To actually close these issues, run this workflow again with dry_run set to false');\n } else {\n console.log(`Successfully closed ${issuesClosed} out of ${issuesToClose.length} issue(s)`);\n }\n\n // Set output for summary\n core.summary\n .addHeading(dryRun ? 'Dry Run Results' : 'Close Old Issues Results')\n .addRaw(`**Mode:** ${dryRun ? '🔍 Dry Run (Preview Only)' : '✅ Live Run'}\\n`)\n .addRaw(`**Cutoff Date:** Issues last updated before ${cutoffDate.toISOString().split('T')[0]}\\n`)\n .addRaw(`**Days Old Threshold:** ${daysOld} days\\n`)\n .addRaw(`**Issues ${dryRun ? 'Found' : 'Closed'}:** ${dryRun ? issuesToClose.length : issuesClosed}\\n\\n`);\n\n if (issuesToClose.length > 0) {\n core.summary.addHeading('Issues', 3);\n const tableData = issuesToClose.map(issue => [\n `#${issue.number}`,\n issue.title.substring(0, 80) + (issue.title.length > 80 ? '...' : ''),\n issue.updated_at,\n `${issue.days_old} days`,\n `[View](${issue.url})`\n ]);\n\n core.summary.addTable([\n ['Issue', 'Title', 'Last Updated', 'Age', 'Link'],\n ...tableData\n ]);\n } else {\n core.summary.addRaw('\\nNo issues found matching the criteria.');\n }\n\n await core.summary.write();\n"
},
{
"path": ".github/workflows/docs.yml",
"content": "name: Docs\n\non:\n workflow_dispatch:\n\njobs:\n docs:\n runs-on: ubuntu-latest\n \n steps:\n - uses: actions/checkout@v6\n with:\n fetch-depth: 0\n - name: Docs update\n run: git push origin master:docs\n"
},
{
"path": ".github/workflows/publish.yml",
"content": "name: Publish\n\non:\n release:\n types: [published]\n workflow_dispatch:\n\njobs:\n publish:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - name: Set up Python\n uses: actions/setup-python@v5\n - name: Install Flit\n run: pip install flit\n - name: Install Dependencies\n run: flit install --symlink\n - name: Publish\n env:\n # FLIT_USERNAME: ${{ secrets.FLIT_USERNAME }}\n # FLIT_PASSWORD: ${{ secrets.FLIT_PASSWORD }}\n FLIT_USERNAME: __token__\n FLIT_PASSWORD: ${{ secrets.PYPI_TOKEN }}\n run: flit publish\n"
},
{
"path": ".github/workflows/test.yml",
"content": "name: Test Coverage\n\non:\n push:\n branches:\n - master\n\njobs:\n test_coverage:\n runs-on: ubuntu-latest\n \n steps:\n - uses: actions/checkout@v6\n - name: Set up Python\n uses: actions/setup-python@v5\n with:\n python-version: '3.12'\n - name: Install Flit\n run: pip install flit \"django>=5.1\"\n - name: Install Dependencies\n run: flit install --symlink\n - name: Test\n run: pytest --cov=ninja --cov-report=xml tests\n - name: Coverage\n uses: codecov/codecov-action@v4.4.1\n"
},
{
"path": ".github/workflows/test_full.yml",
"content": "name: Full Test\n\non:\n push:\n workflow_dispatch:\n pull_request:\n types: [assigned, opened, synchronize, reopened]\n\njobs:\n test:\n runs-on: ubuntu-22.04\n strategy:\n matrix:\n python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', '3.12', '3.13', '3.14']\n django-version: ['<3.2', '<3.3', '<4.2', '<4.3', '<5.1', '<5.2', '<5.3', '<6.1']\n exclude:\n - python-version: '3.7'\n django-version: '<5.1'\n \n - python-version: '3.8'\n django-version: '<5.1'\n \n - python-version: '3.9'\n django-version: '<5.1'\n \n - python-version: '3.12'\n django-version: '<3.2'\n - python-version: '3.12'\n django-version: '<3.3'\n \n - python-version: '3.13'\n django-version: '<3.2'\n - python-version: '3.13'\n django-version: '<3.3'\n \n # as of oct 2025 looks like django < 5.2 does not support python 3.14\n - python-version: '3.14'\n django-version: '<3.2'\n - python-version: '3.14'\n django-version: '<3.3'\n - python-version: '3.14'\n django-version: '<4.2'\n - python-version: '3.14'\n django-version: '<4.3'\n - python-version: '3.14'\n django-version: '<5.1'\n - python-version: '3.14'\n django-version: '<5.2'\n \n steps:\n - uses: actions/checkout@v6\n - name: Set up Python\n uses: actions/setup-python@v5\n with:\n python-version: ${{ matrix.python-version }}\n - name: Install core\n run: pip install \"Django${{ matrix.django-version }}\" \"pydantic<3\"\n - name: Install tests\n run: pip install pytest pytest-asyncio pytest-django psycopg2-binary\n - name: Test\n run: pytest\n\n coverage:\n runs-on: ubuntu-latest\n \n steps:\n - uses: actions/checkout@v6\n - name: Set up Python\n uses: actions/setup-python@v5\n with:\n python-version: 3.12\n - name: Install Flit\n run: pip install flit \"django>=5.2\"\n - name: Install Dependencies\n run: flit install --symlink\n - name: Test\n run: pytest --cov=ninja\n\n codestyle:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - name: Set up Python\n uses: actions/setup-python@v5\n with:\n python-version: 3.12\n - name: Install Flit\n run: pip install flit\n - name: Install Dependencies\n run: flit install --symlink\n - name: Ruff format\n run: ruff format --check ninja tests\n - name: Ruff lint\n run: ruff check ninja tests\n - name: mypy\n run: mypy ninja tests/mypy_test.py\n"
},
{
"path": ".gitignore",
"content": "*.pyc\n.venv*\n.vscode\n.mypy_cache\n.coverage\nhtmlcov\n/coverage.xml\n\ndist\ntest.py\n\ndocs/site\n\n.DS_Store\n.idea\n.python-version\n*.local.md\n"
},
{
"path": ".pre-commit-config.yaml",
"content": "repos:\n - repo: https://github.com/pre-commit/pre-commit-hooks\n rev: v4.2.0\n hooks:\n - id: check-yaml\n # - id: end-of-file-fixer\n # - id: trailing-whitespace\n - repo: https://github.com/pre-commit/mirrors-mypy\n rev: v1.7.1\n hooks:\n - id: mypy\n additional_dependencies: [\"django-stubs\", \"pydantic\"]\n exclude: (tests|docs)/\n - repo: https://github.com/astral-sh/ruff-pre-commit\n rev: v0.4.2\n hooks:\n - id: ruff-format\n - id: ruff\n args: [--fix, --exit-non-zero-on-fix]\n"
},
{
"path": "CONTRIBUTING.md",
"content": "# Contributing\n\nDjango Ninja uses Flit to build, package and publish the project.\n\nto install it use:\n\n```\npip install flit\n```\n\nOnce you have it - to install all dependencies required for development and testing use this command:\n\n\n```\nflit install --deps develop --symlink\n```\n\nOnce done you can check if all works with \n\n```\npytest .\n```\n\nor using Makefile:\n\n```\nmake test\n```\n\nNow you are ready to make your contribution\n\n\nWhen you're done please make sure you to test your functionality \nand check the coverage of your contribution.\n\n```\npytest --cov=ninja --cov-report term-missing tests\n```\n\nor using Makefile:\n\n```\nmake test-cov\n```\n \n## Code style\n\nDjango Ninja uses `ruff`, and `mypy` for style checks.\n\nRun `pre-commit install` to create a git hook to fix your styles before you commit.\n\nAlternatively, manually check your code with:\n\n```\nruff format --check ninja tests\nruff check ninja tests\nmypy ninja\n```\n\nor using Makefile:\n\n```\nmake lint\n```\n\nOr reformat your code with:\n\n```\nruff format ninja tests\nruff check ninja tests --fix\n```\n\nor using Makefile:\n\n```\nmake fmt\n```\n \n## Docs\nPlease do not forget to document your contribution\n\nDjango Ninja uses `mkdocs`:\n\n```\ncd docs/\nmkdocs serve\n```\nand go to browser to see changes in real time\n\n"
},
{
"path": "LICENSE",
"content": "The MIT License (MIT)\n\nCopyright (c) 2025 Vitaliy Kucheryaviy\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n"
},
{
"path": "Makefile",
"content": ".DEFAULT_GOAL := help\n\n.PHONY: help\nhelp:\n\t@fgrep -h \"##\" $(MAKEFILE_LIST) | fgrep -v fgrep | sort | awk 'BEGIN {FS = \":.*?## \"}; {printf \"\\033[36m%-30s\\033[0m %s\\n\", $$1, $$2}'\n\n.PHONY: install\ninstall: ## Install dependencies\n\tflit install --deps develop --symlink\n\n.PHONY: lint\nlint: ## Run code linters\n\truff format --check ninja tests\n\truff check ninja tests\n\tmypy ninja\n\n.PHONY: fmt format\nfmt format: ## Run code formatters\n\truff format ninja tests\n\truff check --fix ninja tests\n\n.PHONY: test\ntest: ## Run tests\n\tpytest .\n\n.PHONY: test-cov\ntest-cov: ## Run tests with coverage\n\tpytest --cov=ninja --cov-report term-missing tests\n\n.PHONY: docs\ndocs: ## Serve documentation locally\n\tpip install -r docs/requirements.txt\n\tcd docs && mkdocs serve -a localhost:8090\n"
},
{
"path": "README.md",
"content": "^ Please read ^ \n\n\n\n\n\n
\n\n Fast to learn, fast to code, fast to run \n
\n\n\n\n\n[](https://badge.fury.io/py/django-ninja)\n[](https://pepy.tech/project/django-ninja)\n\n# Django Ninja - Fast Django REST Framework\n\n**Django Ninja** is a web framework for building APIs with **Django** and Python 3.6+ **type hints**.\n\n\n **Key features:**\n\n - **Easy**: Designed to be easy to use and intuitive.\n - **FAST execution**: Very high performance thanks to **Pydantic ** and **async support **.\n - **Fast to code**: Type hints and automatic docs lets you focus only on business logic.\n - **Standards-based**: Based on the open standards for APIs: **OpenAPI** (previously known as Swagger) and **JSON Schema**.\n - **Django friendly**: (obviously) has good integration with the Django core and ORM.\n - **Production ready**: Used by multiple companies on live projects (If you use django-ninja and would like to publish your feedback, please email ppr.vitaly@gmail.com).\n\n\n\n\n\n**Documentation**: https://django-ninja.dev\n\n---\n\n## Installation\n\n```\npip install django-ninja\n```\n\n\n\n## Usage\n\n\nIn your django project next to urls.py create new `api.py` file:\n\n```Python\nfrom ninja import NinjaAPI\n\napi = NinjaAPI()\n\n\n@api.get(\"/add\")\ndef add(request, a: int, b: int):\n return {\"result\": a + b}\n```\n\n\nNow go to `urls.py` and add the following:\n\n\n```Python hl_lines=\"3 7\"\n...\nfrom .api import api\n\nurlpatterns = [\n path(\"admin/\", admin.site.urls),\n path(\"api/\", api.urls), # <---------- !\n]\n```\n\n**That's it !**\n\nNow you've just created an API that:\n\n - receives an HTTP GET request at `/api/add`\n - takes, validates and type-casts GET parameters `a` and `b`\n - decodes the result to JSON\n - generates an OpenAPI schema for defined operation\n\n### Interactive API docs\n\nNow go to http://127.0.0.1:8000/api/docs \n\nYou will see the automatic interactive API documentation (provided by Swagger UI or Redoc ):\n\n\n\n\n## Sponsors\n\nBecome a sponsor \n\n\n\n## What next?\n\n - Read the full documentation here - https://django-ninja.dev\n - To support this project, please give star it on Github. \n - Share it [via Twitter](https://twitter.com/intent/tweet?text=Check%20out%20Django%20Ninja%20-%20Fast%20Django%20REST%20Framework%20-%20https%3A%2F%2Fdjango-ninja.dev)\n - If you already using django-ninja, please share your feedback to ppr.vitaly@gmail.com\n"
},
{
"path": "docs/docs/chat.md",
"content": "# Ask AI\n\nPlease feel free to share any questions or describe any problems you're encountering. Simply enter your text in the chat, and I'll be happy to assist you.\n\n\n\n
\n\n\n\n"
},
{
"path": "docs/docs/extra.css",
"content": ".doc-module code {\n white-space: nowrap;\n}\n\n/* Ask AI Button Styles */\n.ask-ai-button-container {\n display: flex;\n align-items: center;\n margin-left: auto;\n margin-right: 1rem;\n}\n\n.ask-ai-button {\n background-color: white !important;\n color: #4caf50 !important; /* Material green-500 */\n padding: 0.4rem 0.5rem !important;\n border-radius: 0.25rem;\n font-weight: 500;\n text-decoration: none;\n font-size: 0.9rem;\n border: 2px solid #4caf50;\n transition: all 0.2s ease-in-out;\n white-space: nowrap;\n margin-left: 8px;\n}\n\n.ask-ai-button:hover {\n background-color: #4caf50 !important;\n color: white !important;\n box-shadow: 0 2px 4px rgba(0,0,0,0.2);\n}\n\n/* Dark mode support */\n[data-md-color-scheme=\"slate\"] .ask-ai-button {\n background-color: white !important;\n color: #4caf50 !important;\n}\n\n[data-md-color-scheme=\"slate\"] .ask-ai-button:hover {\n background-color: #4caf50 !important;\n color: white !important;\n}\n\n/* Responsive adjustments */\n@media screen and (max-width: 76.1875em) {\n .ask-ai-button-container {\n margin-right: 0.5rem;\n }\n .ask-ai-button {\n padding: 0.4rem 0.8rem !important;\n font-size: 0.85rem;\n }\n}\n\n@media screen and (max-width: 60em) {\n .ask-ai-button-container {\n display: none; /* Hide on mobile to save space */\n }\n}\n"
},
{
"path": "docs/docs/guides/api-docs.md",
"content": "# API Docs\n\n## OpenAPI docs\n\nOnce you configured your Ninja API and started runserver - go to http://127.0.0.1:8000/api/docs \n\nYou will see the automatic, interactive API documentation (provided by the OpenAPI / Swagger UI \n\n\n## CDN vs staticfiles\n\nYou are not required to put django ninja to `INSTALLED_APPS`. In that case the interactive UI is hosted by CDN.\n\nTo host docs (Js/css) from your own server - just put \"ninja\" to INSTALLED_APPS - in that case standard django staticfiles mechanics will host it.\n\n## Switch to Redoc\n\n\n```python\nfrom ninja import Redoc\n\napi = NinjaAPI(docs=Redoc())\n\n```\n\nThen you will see the alternative automatic documentation (provided by Redoc ).\n\n## Changing docs display settings\n\nTo set some custom settings for Swagger or Redocs you can use `settings` param on the docs class\n\n```python\nfrom ninja import Redoc, Swagger\n\napi = NinjaAPI(docs=Swagger(settings={\"persistAuthorization\": True}))\n...\napi = NinjaAPI(docs=Redoc(settings={\"disableSearch\": True}))\n\n```\n\nSettings reference:\n\n - [Swagger configuration](https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/)\n - [Redoc configuration](https://redocly.com/docs/api-reference-docs/configuration/functionality/)\n\n\n\n## Hiding docs\n\n### Hiding the interactive docs viewer\n\nTo hide only the interactive documentation UI (Swagger or Redoc) while keeping the OpenAPI schema accessible, set `docs_url` to `None`:\n\n```python\napi = NinjaAPI(docs_url=None)\n```\n\nThis disables the `/docs` endpoint but the OpenAPI schema remains available at `/openapi.json`. This is useful when you want to:\n\n- Disable the interactive UI but keep the schema for API clients or code generators\n- Use external documentation tools that consume the OpenAPI spec\n\n### Disabling the OpenAPI schema endpoint\n\nTo disable the OpenAPI schema endpoint, set `openapi_url` to `None`:\n\n```python\napi = NinjaAPI(openapi_url=None)\n```\n\nThis disables the `/openapi.json` endpoint. Since the docs viewer depends on the OpenAPI schema, this also disables the docs viewer - no documentation URLs will be registered.\n\n### Summary\n\n| Configuration | `/openapi.json` | `/docs` | Use Case |\n|---------------|-----------------|---------|----------|\n| Default | Available | Available | Development |\n| `docs_url=None` | Available | Hidden | Hide UI, keep schema for clients |\n| `openapi_url=None` | Hidden | Hidden | Completely hide all documentation |\n\n## Protecting docs\n\nTo protect docs with authentication (or decorate for some other use case) use `docs_decorator` argument:\n\n```python\nfrom django.contrib.admin.views.decorators import staff_member_required\n\napi = NinjaAPI(docs_decorator=staff_member_required)\n```\n\n## Extending OpenAPI Spec with custom attributes\n\nYou can extend OpenAPI spec with custom attributes, for example to add `termsOfService`\n\n```python\napi = NinjaAPI(\n openapi_extra={\n \"info\": {\n \"termsOfService\": \"https://example.com/terms/\",\n }\n },\n title=\"Demo API\",\n description=\"This is a demo API with dynamic OpenAPI info section\"\n)\n```\n\n## Resolving the doc's url\n\nThe url for the api's documentation view can be reversed by referencing the view's name `openapi-view`.\n\nIn Python code, for example:\n```python\nfrom django.urls import reverse\n\nreverse('api-1.0.0:openapi-view')\n\n>>> '/api/docs'\n```\n\nIn a Django template, for example:\n```Html\nAPI Docs \n\nAPI Docs \n```\n\n## Creating custom docs viewer\n\nTo create your own view for OpenAPI - create a class inherited from DocsBase and overwrite `render_page` method:\n\n```python\nfrom ninja.openapi.docs import DocsBase\n\nclass MyDocsViewer(DocsBase):\n def render_page(self, request, api):\n ... # return http response\n\n...\n\napi = NinjaAPI(docs=MyDocsViewer())\n\n```\n\n## Using a custom favicon\n\nThe django-ninja OpenAPI docs contain a default favicon, the ninja star.\nTo use your own, overwrite the `ninja/favicon.html` django template.\n\n```html\n\n{% load static %}\n\n{% block favicons %}\n Uvicorn or Daphne . Let's use Uvicorn for, example:\n\nTo install Uvicorn, use:\n\n```\npip install uvicorn\n```\n\nThen start the server:\n\n```\nuvicorn your_project.asgi:application --reload\n```\n\n> \n> *Note: replace `your_project` with your project package name* \n\n!!! note\n You can run async views with `manage.py runserver`, but it does not work well with some libraries, so at this time (July 2020) it is recommended to use ASGI servers like Uvicorn or Daphne.\n\n### Test\n\nGo to your browser and open http://127.0.0.1:8000/api/say-after?delay=3&word=hello (**delay=3**)\nAfter a 3-second wait you should see the \"hello\" message.\n\nNow let's flood this operation with **100 parallel requests**:\n\n```\nab -c 100 -n 100 \"http://127.0.0.1:8000/api/say-after?delay=3&word=hello\"\n```\n\nwhich will result in something like this:\n\n```\nConnection Times (ms)\n min mean[+/-sd] median max\nConnect: 0 1 1.1 1 4\nProcessing: 3008 3063 16.2 3069 3082\nWaiting: 3008 3062 15.7 3068 3079\nTotal: 3008 3065 16.3 3070 3083\n\nPercentage of the requests served within a certain time (ms)\n 50% 3070\n 66% 3072\n 75% 3075\n 80% 3076\n 90% 3081\n 95% 3082\n 98% 3083\n 99% 3083\n 100% 3083 (longest request)\n```\n\nBased on the numbers, our service was able to handle each of the 100 concurrent requests with just a little overhead.\n\nTo achieve the same concurrency with WSGI and sync operations you would need to spin up about 10 workers with 10 threads each!\n\n## Mixing sync and async operations\n\nKeep in mind that you can use **both sync and async operations** in your project, and **Django Ninja** will route it automatically:\n\n```python hl_lines=\"2 7\"\n\n@api.get(\"/say-sync\")\ndef say_after_sync(request, delay: int, word: str):\n time.sleep(delay)\n return {\"saying\": word}\n\n@api.get(\"/say-async\")\nasync def say_after_async(request, delay: int, word: str):\n await asyncio.sleep(delay)\n return {\"saying\": word}\n```\n\n## Elasticsearch example\n\nLet's take a real world use case. For this example, let's use the latest version of Elasticsearch that now comes with async support:\n\n```\npip install elasticsearch>=7.8.0\n```\n\nAnd now instead of the `Elasticsearch` class, use the `AsyncElasticsearch` class and `await` the results:\n\n```python hl_lines=\"2 7 11 12\"\nfrom ninja import NinjaAPI\nfrom elasticsearch import AsyncElasticsearch\n\n\napi = NinjaAPI()\n\nes = AsyncElasticsearch()\n\n\n@api.get(\"/search\")\nasync def search(request, q: str):\n resp = await es.search(\n index=\"documents\", \n body={\"query\": {\"query_string\": {\"query\": q}}},\n size=20,\n )\n return resp[\"hits\"]\n```\n\n## Using ORM\n\nCurrently, certain key parts of Django are not able to operate safely in an async environment, as they have global state that is not coroutine-aware. These parts of Django are classified as “async-unsafe”, and are protected from execution in an async environment. **The ORM** is the main example, but there are other parts that are also protected in this way.\n\nLearn more about async safety here in the official Django docs .\n\nSo, if you do this:\n\n```python hl_lines=\"3\"\n@api.get(\"/blog/{post_id}\")\nasync def search(request, post_id: int):\n blog = Blog.objects.get(pk=post_id)\n ...\n```\n\nit throws an error. Until the async ORM is implemented, you can use the `sync_to_async()` adapter:\n\n```python hl_lines=\"1 3 9\"\nfrom asgiref.sync import sync_to_async\n\n@sync_to_async\ndef get_blog(post_id):\n return Blog.objects.get(pk=post_id)\n\n@api.get(\"/blog/{post_id}\")\nasync def search(request, post_id: int):\n blog = await get_blog(post_id)\n ...\n```\n\nor even shorter:\n\n```python hl_lines=\"3\"\n@api.get(\"/blog/{post_id}\")\nasync def search(request, post_id: int):\n blog = await sync_to_async(Blog.objects.get)(pk=post_id)\n ...\n```\n\nThere is a common **GOTCHA**: Django querysets are lazily evaluated (database query happens only when you start iterating), so this will **not** work:\n\n```python\nall_blogs = await sync_to_async(Blog.objects.all)()\n# it will throw an error later when you try to iterate over all_blogs\n...\n```\n\nInstead, use evaluation (with `list`):\n\n```python\nall_blogs = await sync_to_async(list)(Blog.objects.all())\n...\n```\n\nSince Django **version 4.1**, Django comes with asynchronous versions of ORM operations.\nThese eliminate the need to use `sync_to_async` in most cases.\nThe async operations have the same names as their sync counterparts but are prepended with *a*. So using\nthe example above, you can rewrite it as:\n\n```python hl_lines=\"3\"\n@api.get(\"/blog/{post_id}\")\nasync def search(request, post_id: int):\n blog = await Blog.objects.aget(pk=post_id)\n ...\n```\n\nWhen working with querysets, use `async for` paired with list comprehension:\n\n```python\nall_blogs = [blog async for blog in Blog.objects.all()]\n...\n```\n\nLearn more about the async ORM interface in the official Django docs .\n"
},
{
"path": "docs/docs/guides/authentication.md",
"content": "# Authentication\n\n## Intro\n\n**Django Ninja** provides several tools to help you deal with authentication and authorization easily, rapidly, in a standard way, and without having to study and learn all the security specifications .\n\nThe core concept is that when you describe an API operation, you can define an authentication object.\n\n```python hl_lines=\"2 7\"\n{!./src/tutorial/authentication/code001.py!}\n```\n\nIn this example, the client will only be able to call the `pets` method if it uses Django session authentication (the default is cookie based), otherwise an HTTP-401 error will be returned.\n\nIf you need to authorize only a superuser, you can use `from ninja.security import django_auth_superuser` instead.\n\n## Automatic OpenAPI schema\n\nHere's an example where the client, in order to authenticate, needs to pass a header:\n\n`Authorization: Bearer supersecret`\n\n```python hl_lines=\"4 5 6 7 10\"\n{!./src/tutorial/authentication/bearer01.py!}\n```\n\nNow go to the docs at http://localhost:8000/api/docs .\n\n\n\n\nNow, when you click the **Authorize** button, you will get a prompt to input your authentication token.\n\n\n\nWhen you do test calls, the Authorization header will be passed for every request.\n\n\n## Global authentication\n\nIn case you need to secure **all** methods of your API, you can pass the `auth` argument to the `NinjaAPI` constructor:\n\n\n```python hl_lines=\"11 19\"\nfrom ninja import NinjaAPI, Form\nfrom ninja.security import HttpBearer\n\n\nclass GlobalAuth(HttpBearer):\n def authenticate(self, request, token):\n if token == \"supersecret\":\n return token\n\n\napi = NinjaAPI(auth=GlobalAuth())\n\n# @api.get(...)\n# def ...\n\n# @api.post(...)\n# def ...\n```\n\nAnd, if you need to overrule some of those methods, you can do that on the operation level again by passing the `auth` argument. In this example, authentication will be disabled for the `/token` operation:\n\n```python hl_lines=\"19\"\n{!./src/tutorial/authentication/global01.py!}\n```\n\n## Available auth options\n\n### Custom function\n\n\nThe \"`auth=`\" argument accepts any Callable object. **NinjaAPI** passes authentication only if the callable object returns a value that can be **converted to boolean `True`**. This return value will be assigned to the `request.auth` attribute.\n\n```python hl_lines=\"1 2 3 6\"\n{!./src/tutorial/authentication/code002.py!}\n```\n\n\n### API Key\n\nSome API's use API keys for authorization. An API key is a token that a client provides when making API calls to identify itself. The key can be sent in the query string:\n```\nGET /something?api_key=abcdef12345\n```\n\nor as a request header:\n\n```\nGET /something HTTP/1.1\nX-API-Key: abcdef12345\n```\n\nor as a cookie:\n\n```\nGET /something HTTP/1.1\nCookie: X-API-KEY=abcdef12345\n```\n\n**Django Ninja** comes with built-in classes to help you handle these cases.\n\n\n#### in Query\n\n```python hl_lines=\"1 2 5 6 7 8 9 10 11 12\"\n{!./src/tutorial/authentication/apikey01.py!}\n```\n\nIn this example we take a token from `GET['api_key']` and find a `Client` in the database that corresponds to this key. The Client instance will be set to the `request.auth` attribute.\n\nNote: **`param_name`** is the name of the GET parameter that will be checked for. If not set, the default of \"`key`\" will be used.\n\n\n#### in Header\n\n```python hl_lines=\"1 4\"\n{!./src/tutorial/authentication/apikey02.py!}\n```\n\n#### in Cookie\n\n```python hl_lines=\"1 4\"\n{!./src/tutorial/authentication/apikey03.py!}\n```\n\n### Django Session Authentication\n\n**Django Ninja** provides built-in session authentication classes that leverage Django's existing session framework:\n\n#### SessionAuth\n\nUses Django's default session authentication - authenticates any logged-in user:\n\n```python\nfrom ninja.security import SessionAuth\n\n@api.get(\"/protected\", auth=SessionAuth())\ndef protected_view(request):\n return {\"user\": request.auth.username}\n```\n\n#### SessionAuthSuperUser\n\nAuthenticates only users with superuser privileges:\n\n```python\nfrom ninja.security import SessionAuthSuperUser\n\n@api.get(\"/admin-only\", auth=SessionAuthSuperUser())\ndef admin_view(request):\n return {\"message\": \"Hello superuser!\"}\n```\n\n#### SessionAuthIsStaff\n\nAuthenticates users who are either superusers or staff members:\n\n```python\nfrom ninja.security import SessionAuthIsStaff\n\n@api.get(\"/staff-area\", auth=SessionAuthIsStaff())\ndef staff_view(request):\n return {\"message\": \"Hello staff member!\"}\n```\n\nThese authentication classes automatically use Django's `SESSION_COOKIE_NAME` setting and check the user's authentication status through the standard Django session framework.\n\n\n\n### HTTP Bearer\n\n```python hl_lines=\"1 4 5 6 7\"\n{!./src/tutorial/authentication/bearer01.py!}\n```\n\n### HTTP Basic Auth\n\n```python hl_lines=\"1 4 5 6 7\"\n{!./src/tutorial/authentication/basic01.py!}\n```\n\n\n## Multiple authenticators\n\nThe **`auth`** argument also allows you to pass multiple authenticators:\n\n```python hl_lines=\"18\"\n{!./src/tutorial/authentication/multiple01.py!}\n```\n\nIn this case **Django Ninja** will first check the API key `GET`, and if not set or invalid will check the `header` key.\nIf both are invalid, it will raise an authentication error to the response.\n\n\n## Router authentication\n\nUse `auth` argument on Router to apply authenticator to all operations declared in it:\n\n```python\napi.add_router(\"/events/\", events_router, auth=BasicAuth())\n```\n\nor using router constructor\n```python\nrouter = Router(auth=BasicAuth())\n```\n\nThis overrides any API level authentication. To allow router operations to not use the API-level authentication by default, you can explicitly set the router's `auth=None`.\n\n\n## Custom exceptions\n\nRaising an exception that has an exception handler will return the response from that handler in\nthe same way an operation would:\n\n```python hl_lines=\"1 4\"\n{!./src/tutorial/authentication/bearer02.py!}\n```\n\n\n## Async authentication\n\n**Django Ninja** has basic support for asynchronous authentication. While the default authentication classes are not async-compatible, you can still define your custom asynchronous authentication callables and pass them in using `auth`.\n\n```python\nasync def async_auth(request):\n ...\n\n\n@api.get(\"/pets\", auth=async_auth)\ndef pets(request):\n ...\n```\n\n\nSee [Handling errors](errors.md) for more information.\n"
},
{
"path": "docs/docs/guides/decorators.md",
"content": "# Decorators\n\nDjango Ninja provides flexible decorator support to wrap your API operations with additional functionality like caching, logging, authentication checks, or any custom logic.\n\n## Understanding Decorator Modes\n\nDjango Ninja supports two modes for applying decorators:\n\n\n### OPERATION Mode (Default)\n- Applied **after** Django Ninja's validation\n- Wraps the operation function with validated data\n- Has access to parsed and validated parameters\n- Useful for: business logic, logging with validated data, post-validation checks\n\n### VIEW Mode\n- Applied **before** Django Ninja's validation\n- Wraps the entire Django view function\n- Has access to the raw Django request\n- Useful for: caching, rate limiting, Django middleware-like functionality\n- Similar to Django's standard view decorators\n\n\n## Using `@decorate_view`\n\nThe `@decorate_view` decorator allows you to apply Django view decorators to individual endpoints.\nThese decorators are always executed in VIEW mode:\n\n```python\nfrom django.views.decorators.cache import cache_page\nfrom ninja import NinjaAPI\nfrom ninja.decorators import decorate_view\n\napi = NinjaAPI()\n\n@api.get(\"/cached\")\n@decorate_view(cache_page(60 * 15)) # Cache for 15 minutes\ndef cached_endpoint(request):\n return {\"data\": \"This response is cached\"}\n```\n\nYou can apply multiple decorators:\n\n```python\nfrom django.views.decorators.cache import cache_page\nfrom django.views.decorators.vary import vary_on_headers\n\n@api.get(\"/multi\")\n@decorate_view(cache_page(300), vary_on_headers(\"User-Agent\"))\ndef multi_decorated(request):\n return {\"data\": \"Multiple decorators applied\"}\n```\n\n## Using `add_decorator`\n\nThe `add_decorator` method allows you to apply decorators to multiple endpoints at once.\nBy default, they are executed in OPERATION mode; however, you can switch them to VIEW mode.\n\n### Router-Level Decorators\n\nApply decorators to all endpoints in a router:\n\n```python\nfrom ninja import Router\n\nrouter = Router()\n\n# Add logging to all operations in this router\ndef log_operation(func):\n def wrapper(request, *args, **kwargs):\n print(f\"Calling {func.__name__}\")\n result = func(request, *args, **kwargs)\n print(f\"Result: {result}\")\n return result\n return wrapper\n\nrouter.add_decorator(log_operation) # OPERATION mode by default\n\n@router.get(\"/users\")\ndef list_users(request):\n return {\"users\": [\"Alice\", \"Bob\"]}\n\n@router.get(\"/users/{user_id}\")\ndef get_user(request, user_id: int):\n return {\"user_id\": user_id}\n```\n\n### API-Level Decorators\n\nApply decorators to all endpoints in your entire API:\n\n```python\nfrom ninja import NinjaAPI\n\napi = NinjaAPI()\n\n# Add CORS headers to all responses (VIEW mode)\ndef cors_headers(func):\n def wrapper(request, *args, **kwargs):\n response = func(request, *args, **kwargs)\n response[\"Access-Control-Allow-Origin\"] = \"*\"\n return response\n return wrapper\n\napi.add_decorator(cors_headers, mode=\"view\")\n\n# Now all endpoints will have CORS headers\n@api.get(\"/data\")\ndef get_data(request):\n return {\"data\": \"example\"}\n```\n\n## Practical Examples\n\n### Example 1: Request Timing\n\n```python\nimport time\nfrom functools import wraps\n\ndef timing_decorator(func):\n @wraps(func)\n def wrapper(request, *args, **kwargs):\n start = time.time()\n result = func(request, *args, **kwargs)\n duration = time.time() - start\n if isinstance(result, dict):\n result[\"_timing\"] = f\"{duration:.3f}s\"\n return result\n return wrapper\n\nrouter = Router()\nrouter.add_decorator(timing_decorator)\n\n@router.get(\"/slow\")\ndef slow_endpoint(request):\n time.sleep(1)\n return {\"message\": \"done\"}\n# Returns: {\"message\": \"done\", \"_timing\": \"1.001s\"}\n```\n\n### Example 2: Authentication Check (OPERATION mode)\n\n```python\nfrom functools import wraps\n\ndef require_feature_flag(flag_name):\n def decorator(func):\n @wraps(func)\n def wrapper(request, *args, **kwargs):\n if not request.user.has_feature(flag_name):\n return {\"error\": f\"Feature {flag_name} not enabled\"}\n return func(request, *args, **kwargs)\n return wrapper\n return decorator\n\nrouter = Router()\nrouter.add_decorator(require_feature_flag(\"new_api\"))\n\n@router.get(\"/new-feature\")\ndef new_feature(request):\n return {\"feature\": \"enabled\"}\n```\n\n### Example 3: Response Caching (VIEW mode)\n\n```python\nfrom django.core.cache import cache\nfrom functools import wraps\nimport hashlib\n\ndef cache_response(timeout=300):\n def decorator(func):\n @wraps(func)\n def wrapper(request, *args, **kwargs):\n # Create cache key from request\n cache_key = hashlib.md5(\n f\"{request.path}{request.GET.urlencode()}\".encode()\n ).hexdigest()\n \n # Try to get from cache\n cached = cache.get(cache_key)\n if cached:\n return cached\n \n # Call the view\n response = func(request, *args, **kwargs)\n \n # Cache the response\n cache.set(cache_key, response, timeout)\n return response\n return wrapper\n return decorator\n\nrouter = Router()\nrouter.add_decorator(cache_response(600), mode=\"view\")\n```\n\n## Decorator Execution Order\n\nWhen multiple decorators are applied, they execute in this order:\n\n1. API-level decorators (outermost)\n2. Parent router decorators\n3. Child router decorators\n4. Individual endpoint decorators (innermost)\n\nBe aware that VIEW mode decorators are executed before OPERATION mode decorators.\n\n```python\napi = NinjaAPI()\nparent_router = Router()\nchild_router = Router()\n\napi.add_decorator(api_decorator)\nparent_router.add_decorator(parent_decorator)\nchild_router.add_decorator(child_decorator)\n\n@child_router.get(\"/test\")\n@decorate_view(endpoint_decorator)\ndef endpoint(request):\n return {\"result\": \"ok\"}\n\nparent_router.add_router(\"/child\", child_router)\napi.add_router(\"/parent\", parent_router)\n\n# Execution order:\n# 1. endpoint_decorator (view)\n# 1. api_decorator (operational)\n# 2. parent_decorator (operational)\n# 3. child_decorator (operational)\n# 5. endpoint function\n```\n\n## Async Support\n\nDecorators work with both sync and async views. When you have mixed sync/async endpoints in the same router, you need to create universal decorators that handle both cases.\n\n### Universal Decorators for Mixed Sync/Async Routers\n\nWhen you have a router with both sync and async endpoints, use `asyncio.iscoroutinefunction()` to detect the function type:\n\n```python\nimport asyncio\nfrom functools import wraps\n\ndef universal_decorator(func):\n if asyncio.iscoroutinefunction(func):\n # Handle async functions\n @wraps(func)\n async def async_wrapper(request, *args, **kwargs):\n # Your async logic here\n result = await func(request, *args, **kwargs)\n if isinstance(result, dict):\n result[\"decorated\"] = True\n result[\"type\"] = \"async\"\n return result\n return async_wrapper\n else:\n # Handle sync functions \n @wraps(func)\n def sync_wrapper(request, *args, **kwargs):\n # Your sync logic here\n result = func(request, *args, **kwargs)\n if isinstance(result, dict):\n result[\"decorated\"] = True\n result[\"type\"] = \"sync\"\n return result\n return sync_wrapper\n\nrouter = Router()\nrouter.add_decorator(universal_decorator)\n\n@router.get(\"/async\")\nasync def async_endpoint(request):\n await asyncio.sleep(0.1)\n return {\"endpoint\": \"async\"}\n\n@router.get(\"/sync\") \ndef sync_endpoint(request):\n return {\"endpoint\": \"sync\"}\n```\n\n### Async-Only Decorators\n\nFor routers with only async endpoints, you can use async decorators directly:\n\n```python\ndef async_timing_decorator(func):\n @wraps(func)\n async def wrapper(request, *args, **kwargs):\n start = time.time()\n result = await func(request, *args, **kwargs)\n duration = time.time() - start\n if isinstance(result, dict):\n result[\"_timing\"] = f\"{duration:.3f}s\"\n return result\n return wrapper\n\nrouter = Router()\nrouter.add_decorator(async_timing_decorator)\n\n@router.get(\"/async\")\nasync def async_endpoint(request):\n await asyncio.sleep(1)\n return {\"message\": \"async done\"}\n```\n\n### Sync Decorators on Async Views\n\nYou can also use sync decorators on async views by handling coroutines:\n\n```python\ndef sync_decorator(func):\n @wraps(func)\n def wrapper(request, *args, **kwargs):\n result = func(request, *args, **kwargs)\n \n if asyncio.iscoroutine(result):\n # Handle async functions\n async def async_wrapper():\n actual_result = await result\n if isinstance(actual_result, dict):\n actual_result[\"sync_decorated\"] = True\n return actual_result\n return async_wrapper()\n else:\n # Handle sync functions\n if isinstance(result, dict):\n result[\"sync_decorated\"] = True\n return result\n return wrapper\n```\n\n## When to Use Each Mode\n\n### Use VIEW Mode When:\n- You need access to the raw Django request\n- Implementing caching at the HTTP level\n- Adding/modifying HTTP headers\n- Implementing rate limiting\n- Working with Django middleware patterns\n\n### Use OPERATION Mode When:\n- You need access to validated/parsed data\n- Implementing business logic decorators\n- Adding data to responses\n- Logging with type-safe parameters\n- Post-validation security checks\n\n## Best Practices\n\n1. **Use `functools.wraps`**: Always use `@wraps(func)` to preserve function metadata\n\n2. **Handle mixed sync/async routers**: When your router has both sync and async endpoints, use `asyncio.iscoroutinefunction(func)` to create universal decorators\n\n3. **Choose the right approach for async**:\n - **Universal decorators**: Best for mixed routers (detect with `iscoroutinefunction`)\n - **Async-only decorators**: Best for async-only routers (simpler, cleaner) \n - **Sync decorators with coroutine handling**: Useful for legacy decorators\n\n4. **Be mindful of performance**: Decorators add overhead, especially in VIEW mode\n\n5. **Document side effects**: Clearly document what your decorators modify\n\n6. **Keep decorators focused**: Each decorator should have a single responsibility\n\n7. **Test both sync and async**: When using universal decorators, test both sync and async endpoints\n"
},
{
"path": "docs/docs/guides/errors.md",
"content": "# Handling errors\n\n**Django Ninja** allows you to install custom exception handlers to deal with how you return responses when errors or handled exceptions occur.\n\n## Custom exception handlers\n\nLet's say you are making API that depends on some external service that is designed to be unavailable at some moments. Instead of throwing default 500 error upon exception - you can handle the error and give some friendly response back to the client (to come back later)\n\nTo achieve that you need:\n\n1. create some exception (or use existing one)\n2. use api.exception_handler decorator\n\n\nExample:\n\n\n```python hl_lines=\"9 10\"\napi = NinjaAPI()\n\nclass ServiceUnavailableError(Exception):\n pass\n\n\n# initializing handler\n\n@api.exception_handler(ServiceUnavailableError)\ndef service_unavailable(request, exc):\n return api.create_response(\n request,\n {\"message\": \"Please retry later\"},\n status=503,\n )\n\n\n# some logic that throws exception\n\n@api.get(\"/service\")\ndef some_operation(request):\n if random.choice([True, False]):\n raise ServiceUnavailableError()\n return {\"message\": \"Hello\"}\n\n```\n\nException handler function takes 2 arguments:\n\n - **request** - Django http request\n - **exc** - actual exception\n\nfunction must return http response\n\n## Override the default exception handlers\n\n**Django Ninja** registers default exception handlers for the types shown below.\nYou can register your own handlers with `@api.exception_handler` to override the default handlers.\n\n#### `ninja.errors.AuthenticationError`\n\nRaised when authentication data is not valid\n\n#### `ninja.errors.AuthorizationError`\n\nRaised when authentication data is valid, but doesn't allow you to access the resource\n\n#### `ninja.errors.ValidationError`\n\nRaised when request data does not validate\n\n#### `ninja.errors.HttpError`\n\nUsed to throw http error with status code from any place of the code\n\n#### `django.http.Http404`\n \n Django's default 404 exception (can be returned f.e. with `get_object_or_404`)\n\n#### `Exception`\n \nAny other unhandled exception by application.\n\nDefault behavior \n \n - **if `settings.DEBUG` is `True`** - returns a traceback in plain text (useful when debugging in console or swagger UI)\n - **else** - default django exception handler mechanism is used (error logging, email to ADMINS)\n\n\n## Customizing request validation errors\n\nRequests that fail validation raise `ninja.errors.ValidationError` (not to be confused with `pydantic.ValidationError`).\n`ValidationError`s have a default exception handler that returns a 422 (Unprocessable Content) JSON response of the form:\n```json\n{\n \"detail\": [ ... ]\n}\n```\n\nYou can change this behavior by overriding the default handler for `ValidationError`s:\n\n```python hl_lines=\"1 4\"\nfrom ninja.errors import ValidationError\n...\n\n@api.exception_handler(ValidationError)\ndef validation_errors(request, exc):\n return HttpResponse(\"Invalid input\", status=422)\n```\n\nIf you need even more control over validation errors (for example, if you need to reference the schema associated with\nthe model that failed validation), you can supply your own `validation_error_from_error_contexts` in a `NinjaAPI` subclass:\n\n```python hl_lines=\"4\"\nfrom ninja.errors import ValidationError, ValidationErrorContext\nfrom typing import Any, Dict, List\n\nclass CustomNinjaAPI(NinjaAPI):\n def validation_error_from_error_contexts(\n self, error_contexts: List[ValidationErrorContext],\n ) -> ValidationError:\n custom_error_infos: List[Dict[str, Any]] = []\n for context in error_contexts:\n model = context.model\n pydantic_schema = model.__pydantic_core_schema__\n param_source = model.__ninja_param_source__\n for e in context.pydantic_validation_error.errors(\n include_url=False, include_context=False, include_input=False\n ):\n custom_error_info = {\n # TODO: use `e`, `param_source`, and `pydantic_schema` as desired\n }\n custom_error_infos.append(custom_error_info)\n return ValidationError(custom_error_infos)\n\napi = CustomNinjaAPI()\n```\n\nNow each `ValidationError` raised during request validation will contain data from your `validation_error_from_error_contexts`.\n\n\n## Throwing HTTP responses with exceptions\n\nAs an alternative to custom exceptions and writing handlers for it - you can as well throw http exception that will lead to returning a http response with desired code\n\n\n```python\nfrom ninja.errors import HttpError\n\n@api.get(\"/some/resource\")\ndef some_operation(request):\n if True:\n raise HttpError(503, \"Service Unavailable. Please retry later.\")\n\n```\n"
},
{
"path": "docs/docs/guides/input/body.md",
"content": "# Request Body\n\nRequest bodies are typically used with “create” and “update” operations (POST, PUT, PATCH).\nFor example, when creating a resource using POST or PUT, the request body usually contains the representation of the resource to be created.\n\nTo declare a **request body**, you need to use **Django Ninja `Schema`**.\n\n!!! info\n Under the hood **Django Ninja** uses Pydantic models with all their power and benefits.\n The alias `Schema` was chosen to avoid confusion in code when using Django models, as Pydantic's model class is called Model by default, and conflicts with Django's Model class.\n\n## Import Schema\n\nFirst, you need to import `Schema` from `ninja`:\n\n```python hl_lines=\"2\"\n{!./src/tutorial/body/code01.py!}\n```\n\n## Create your data model\n\nThen you declare your data model as a class that inherits from `Schema`.\n\nUse standard Python types for all the attributes:\n\n```python hl_lines=\"5 6 7 8 9\"\n{!./src/tutorial/body/code01.py!}\n```\n\nNote: if you use **`None`** as the default value for an attribute, it will become optional in the request body.\nFor example, this model above declares a JSON \"`object`\" (or Python `dict`) like:\n\n```JSON\n{\n \"name\": \"Katana\",\n \"description\": \"An optional description\",\n \"price\": 299.00,\n \"quantity\": 10\n}\n```\n\n...as `description` is optional (with a default value of `None`), this JSON \"`object`\" would also be valid:\n\n```JSON\n{\n \"name\": \"Katana\",\n \"price\": 299.00,\n \"quantity\": 10\n}\n```\n\n## Declare it as a parameter\n\nTo add it to your *path operation*, declare it the same way you declared the path and query parameters:\n\n```python hl_lines=\"13\"\n{!./src/tutorial/body/code01.py!}\n```\n\n... and declare its type as the model you created, `Item`.\n\n## Results\n\nWith just that Python type declaration, **Django Ninja** will:\n\n* Read the body of the request as JSON.\n* Convert the corresponding types (if needed).\n* Validate the data.\n * If the data is invalid, it will return a nice and meaningful error, indicating exactly where and what the incorrect data was.\n* Give you the received data in the parameter `item`.\n * Because you declared it in the function to be of type `Item`, you will also have all the editor support\n (completion, etc.) for all the attributes and their types.\n* Generate JSON Schema definitions for\n your models, and you can also use them anywhere else you like if it makes sense for your project.\n* Those schemas will be part of the generated OpenAPI schema, and used by the automatic documentation UI's .\n\n## Automatic docs\n\nThe JSON Schemas of your models will be part of your OpenAPI generated schema, and will be shown in the interactive API docs:\n\n\n\n... and they will be also used in the API docs inside each *path operation* that needs them:\n\n\n\n## Editor support\n\nIn your editor, inside your function you will get type hints and completion everywhere (this wouldn't happen if you received a `dict` instead of a Schema object):\n\n\n\n\nThe previous screenshots were taken with Visual Studio Code .\n\nYou would get the same editor support with PyCharm and most of the other Python editors.\n\n\n## Request body + path parameters\n\nYou can declare path parameters **and** body requests at the same time.\n\n**Django Ninja** will recognize that the function parameters that match path parameters should be **taken from the path**, and that function parameters that are declared with `Schema` should be **taken from the request body**.\n\n```python hl_lines=\"11 12\"\n{!./src/tutorial/body/code02.py!}\n```\n\n## Request body + path + query parameters\n\nYou can also declare **body**, **path** and **query** parameters, all at the same time.\n\n**Django Ninja** will recognize each of them and take the data from the correct place.\n\n```python hl_lines=\"11 12\"\n{!./src/tutorial/body/code03.py!}\n```\n\nThe function parameters will be recognized as follows:\n\n* If the parameter is also declared in the **path**, it will be used as a path parameter.\n* If the parameter is of a **singular type** (like `int`, `float`, `str`, `bool`, etc.), it will be interpreted as a **query** parameter.\n* If the parameter is declared to be of the type of **Schema** (or Pydantic `BaseModel`), it will be interpreted as a request **body**.\n"
},
{
"path": "docs/docs/guides/input/file-params.md",
"content": "# File uploads\n\nHandling files are no different from other parameters.\n\n```python hl_lines=\"1 2 5\"\nfrom ninja import NinjaAPI, File\nfrom ninja.files import UploadedFile\n\n@api.post(\"/upload\")\ndef upload(request, file: File[UploadedFile]):\n data = file.read()\n return {'name': file.name, 'len': len(data)}\n```\n\n\n`UploadedFile` is an alias to [Django's UploadFile](https://docs.djangoproject.com/en/stable/ref/files/uploads/#django.core.files.uploadedfile.UploadedFile) and has all the methods and attributes to access the uploaded file:\n\n - read()\n - multiple_chunks(chunk_size=None)\n - chunks(chunk_size=None)\n - name\n - size\n - content_type\n - content_type_extra\n - charset\n - etc.\n\n## Uploading array of files\n\nTo **upload several files** at the same time, just declare a `List` of `UploadedFile`:\n\n\n```python hl_lines=\"1 6\"\nfrom typing import List\nfrom ninja import NinjaAPI, File\nfrom ninja.files import UploadedFile\n\n@api.post(\"/upload-many\")\ndef upload_many(request, files: File[List[UploadedFile]]):\n return [f.name for f in files]\n```\n\n## Uploading files with extra fields\n\nNote: The HTTP protocol does not allow you to send files in `application/json` format by default (unless you encode it somehow to JSON on client side)\n\nTo send files along with some extra attributes, you need to send bodies with `multipart/form-data` encoding. You can do it by simply marking fields with `Form`:\n\n```python hl_lines=\"14\"\nfrom ninja import NinjaAPI, Schema, UploadedFile, Form, File\nfrom datetime import date\n\napi = NinjaAPI()\n\n\nclass UserDetails(Schema):\n first_name: str\n last_name: str\n birthdate: date\n\n\n@api.post('/users')\ndef create_user(request, details: Form[UserDetails], file: File[UploadedFile]):\n return [details.dict(), file.name]\n\n```\n\nNote: in this case all fields should be send as form fields\n\nYou can as well send payload in single field as JSON - just remove the Form mark from:\n\n```python\n@api.post('/users')\ndef create_user(request, details: UserDetails, file: File[UploadedFile]):\n return [details.dict(), file.name]\n\n```\n\nthis will expect from the client side to send data as `multipart/form-data with 2 fields:\n \n - details: JSON as string\n - file: file\n\n\n### List of files with extra info\n\n```python\n@api.post('/users')\ndef create_user(request, details: Form[UserDetails], files: File[list[UploadedFile]]):\n return [details.dict(), [f.name for f in files]]\n```\n\n### Optional file input\n\nIf you would like the file input to be optional, all that you have to do is to pass `None` to the `File` type, like so:\n\n```python\n@api.post('/users')\ndef create_user(request, details: Form[UserDetails], avatar: File[UploadedFile] = None):\n user = add_user_to_database(details)\n if avatar is not None:\n set_user_avatar(user)\n```\n\n\n## Handling request.FILES in PUT/PATCH Requests\n\n**Problem**\n\n```python\n@api.put(\"/upload\") # !!!!\ndef upload(request, file: File[UploadedFile]):\n ...\n```\n\nFor some [historical reasons Django’s](https://groups.google.com/g/django-users/c/BeBKj_6qNsc) `request.FILES` is populated only for POST requests by default. When using HTTP PUT or PATCH methods with file uploads (e.g., multipart/form-data), request.FILES will not contain uploaded files. This is a known Django behavior, not specific to Django Ninja.\n\nAs a result, views expecting files in PUT or PATCH requests may not behave correctly, since request.FILES will be empty.\n\n**Solution**\n\nDjango Ninja provides a built-in middleware to automatically fix this behavior:\n`ninja.compatibility.files.fix_request_files_middleware`\n\nThis middleware will manually parse multipart/form-data for PUT and PATCH requests and populate request.FILES, making file uploads work as expected across all HTTP methods.\n\n**Usage**\n\nTo enable the middleware, add the following to your Django settings:\n\n```python\nMIDDLEWARE = [\n # ... your existing middleware ...\n \"ninja.compatibility.files.fix_request_files_middleware\",\n]\n```\n\n**Auto-detection**\n\nWhen Django Ninja detects a PUT or PATCH etc methods with multipart/form-data and expected FILES - it will throw an error message suggesting you install the compatibility middleware:\n\n\nNote: This middleware does not interfere with normal POST behavior or any other methods.\n\n\n"
},
{
"path": "docs/docs/guides/input/filtering.md",
"content": "# Filtering\n\nIf you want to allow the user to filter your querysets by a number of different attributes, it makes sense\nto encapsulate your filters into a `FilterSchema` class. `FilterSchema` is a regular `Schema`, so it's using all the\nnecessary features of Pydantic, but it also adds some bells and whistles that ease the translation of the user-facing filtering\nparameters into database queries. \n\nStart off with defining a subclass of `FilterSchema`:\n\n```python hl_lines=\"6 7 8 9\"\nfrom ninja import FilterSchema\nfrom typing import Optional\nfrom datetime import datetime\n\n\nclass BookFilterSchema(FilterSchema):\n name: Optional[str] = None\n author: Optional[str] = None\n created_after: Optional[datetime] = None\n```\n\n\nNext, use this schema in conjunction with `Query` in your API handler:\n```python hl_lines=\"2\"\n@api.get(\"/books\")\ndef list_books(request, filters: BookFilterSchema = Query(...)):\n books = Book.objects.all()\n books = filters.filter(books)\n return books\n```\n\nJust like described in [defining query params using schema](./query-params.md#using-schema), Django Ninja converts the fields\ndefined in `BookFilterSchema` into query parameters.\n\nYou can use a shorthand one-liner `.filter()` to apply those filters to your queryset:\n```python hl_lines=\"4\"\n@api.get(\"/books\")\ndef list_books(request, filters: Query[BookFilterSchema]):\n books = Book.objects.all()\n books = filters.filter(books)\n return books\n```\n\nUnder the hood, `FilterSchema` converts its fields into [Q expressions](https://docs.djangoproject.com/en/3.1/topics/db/queries/#complex-lookups-with-q-objects) which it then combines and uses to filter your queryset.\n\n\nAlternatively to using the `.filter` method, you can get the prepared `Q`-expression and perform the filtering yourself.\nThat can be useful, when you have some additional queryset filtering on top of what you expose to the user through the API:\n```python hl_lines=\"5 8\"\n@api.get(\"/books\")\ndef list_books(request, filters: Query[BookFilterSchema]):\n\n # Never serve books from inactive publishers and authors\n q = Q(author__is_active=True) | Q(publisher__is_active=True)\n \n # But allow filtering the rest of the books\n q &= filters.get_filter_expression()\n return Book.objects.filter(q)\n```\n\nBy default, the filters will behave the following way:\n\n* `None` values will be ignored and not filtered against;\n* Every non-`None` field will be converted into a `Q`-expression based on the `Field` definition of each field;\n* All `Q`-expressions will be merged into one using `AND` logical operator;\n* The resulting `Q`-expression is used to filter the queryset and return you a queryset with a `.filter` clause applied.\n\n## Customizing Fields\nBy default, `FilterSet` will use the field names to generate Q expressions:\n```python\nclass BookFilterSchema(FilterSchema):\n name: Optional[str] = None\n```\nThe `name` field will be converted into `Q(name=...)` expression.\n\nWhen your database lookups are more complicated than that, you can annotate your fields with an instance of `FilterLookup` where you specify how you wish your field to be looked up for filtering:\n```python hl_lines=\"5\"\nfrom ninja import FilterSchema, FilterLookup\nfrom typing import Annotated\n\nclass BookFilterSchema(FilterSchema):\n name: Annotated[Optional[str], FilterLookup(\"name__icontains\")] = None\n```\n\nYou can even specify multiple lookups as a list:\n```python hl_lines=\"3 4 5\"\nclass BookFilterSchema(FilterSchema):\n search: Annotated[Optional[str], FilterLookup(\n [\"name__icontains\",\n \"author__name__icontains\",\n \"publisher__name__icontains\"]\n )]\n```\n\nBy default, field-level expressions are combined using `\"OR\"` connector, so with the above setup, a query parameter `?search=foobar` will search for books that have \"foobar\" in either of their name, author or publisher.\n\nAnd to make generic fields, you can make the field name implicit by skipping it:\n```python hl_lines=\"1 4\"\nIContainsField = Annotated[Optional[str], FilterLookup('__icontains')]\n\nclass BookFilterSchema(FilterSchema):\n name: IContainsField = None\n```\n\n??? note \"Deprecated syntax\"\n\n In previous versions, database lookups were specified using `Field(q=...)` syntax:\n ```python\n from ninja import FilterSchema, Field\n \n class BookFilterSchema(FilterSchema):\n name: Optional[str] = Field(None, q=\"name__icontains\")\n ```\n \n This approach is still supported, but it is considered **deprecated** and **not recommended** for new code because:\n \n - Poor IDE support (IDEs don't recognize custom `Field` arguments)\n - Uses deprecated Pydantic features (`**extra`)\n - Less type-safe and harder to maintain\n \n The new `FilterLookup` annotation provides better developer experience with full IDE support and type safety. Prefer using `FilterLookup` for new projects.\n\n\n## Combining expressions\nBy default,\n\n* Field-level expressions are joined together using `OR` operator.\n* The fields themselves are joined together using `AND` operator.\n\nSo, with the following `FilterSchema`...\n```python\nclass BookFilterSchema(FilterSchema):\n search: Annotated[\n Optional[str],\n FilterLookup([\"name__icontains\", \"author__name__icontains\"])] = None\n popular: Optional[bool] = None\n```\n...and the following query parameters from the user\n```\nhttp://localhost:8000/api/books?search=harry&popular=true\n```\nthe `FilterSchema` instance will look for popular books that have `harry` in the book's _or_ author's name. \n\n\nYou can customize this behavior using an `expression_connector` argument in field-level and class-level definition:\n```python hl_lines=\"12\"\nfrom ninja import FilterConfigDict, FilterLookup, FilterSchema\n\nclass BookFilterSchema(FilterSchema):\n active: Annotated[\n Optional[bool],\n FilterLookup(\n [\"is_active\", \"publisher__is_active\"],\n expression_connector=\"AND\"\n )] = None\n name: Annotated[Optional[str], FilterLookup(\"name__icontains\")] = None\n \n model_config = FilterConfigDict(expression_connector=\"OR\")\n```\n\nAn expression connector can take the values of `\"OR\"`, `\"AND\"` and `\"XOR\"`, but the latter is only [supported](https://docs.djangoproject.com/en/4.1/ref/models/querysets/#xor) in Django starting with 4.1.\n\nNow, a request with these query parameters \n```\nhttp://localhost:8000/api/books?name=harry&active=true\n```\n...shall search for books that have `harry` in their name _or_ are active themselves _and_ are published by active publishers.\n\n\n## Filtering by Nones\nYou can make the `FilterSchema` treat `None` as a valid value that should be filtered against.\n\nThis can be done on a field level with a `ignore_none` kwarg:\n```python hl_lines=\"3\"\nclass BookFilterSchema(FilterSchema):\n name: Annotated[Optional[str], FilterLookup(\"name__icontains\")] = None\n tag: Annotated[Optional[str], FilterLookup(\"tag\", ignore_none=False)] = None\n```\n\nThis way when no other value for `\"tag\"` is provided by the user, the filtering will always include a condition `tag=None`.\n\nYou can also specify this setting for all fields at the same time in `model_config`:\n```python hl_lines=\"5\"\nclass BookFilterSchema(FilterSchema):\n name: Annotated[Optional[str], FilterLookup(\"name__icontains\")] = None\n tag: Optional[str] = None\n \n model_config = FilterConfigDict(ignore_none=False)\n```\n\n\n## Custom expressions\nSometimes you might want to have complex filtering scenarios that cannot be handled by individual Field annotations.\nFor such cases you can implement your field filtering logic as a custom method. Simply define a method called `filter_` which takes a filter value and returns a Q expression:\n\n```python hl_lines=\"5\"\nclass BookFilterSchema(FilterSchema):\n tag: Optional[str] = None\n popular: Optional[bool] = None\n \n def filter_popular(self, value: bool) -> Q:\n return Q(view_count__gt=1000) | Q(download_count__gt=100) if value else Q()\n```\nSuch field methods take precedence over what is specified in the `Field()` definition of the corresponding fields.\n\nIf that is not enough, you can implement your own custom filtering logic for the entire `FilterSet` class in a `custom_expression` method:\n\n```python hl_lines=\"5\"\nclass BookFilterSchema(FilterSchema):\n name: Optional[str] = None\n popular: Optional[bool] = None\n\n def custom_expression(self) -> Q:\n q = Q()\n if self.name:\n q &= Q(name__icontains=self.name)\n if self.popular:\n q &= (\n Q(view_count__gt=1000) |\n Q(downloads__gt=100) |\n Q(tag='popular')\n )\n return q\n```\nThe `custom_expression` method takes precedence over any other definitions described earlier, including `filter_` methods.\n"
},
{
"path": "docs/docs/guides/input/form-params.md",
"content": "# Form data\n\n**Django Ninja** also allows you to parse and validate `request.POST` data\n(aka `application/x-www-form-urlencoded` or `multipart/form-data`).\n\n## Form Data as params \n\n```python hl_lines=\"1 4\"\nfrom ninja import NinjaAPI, Form\n\n@api.post(\"/login\")\ndef login(request, username: Form[str], password: Form[str]):\n return {'username': username, 'password': '*****'}\n```\n\nNote the following:\n\n1) You need to import the `Form` class from `ninja`\n```python\nfrom ninja import Form\n```\n\n2) Use `Form` as default value for your parameter:\n```python\nusername: Form[str]\n```\n\n## Using a Schema\n\nIn a similar manner to [Body](body.md#declare-it-as-a-parameter), you can use\na Schema to organize your parameters.\n\n```python hl_lines=\"12\"\n{!./src/tutorial/form/code01.py!}\n```\n\n## Request form + path + query parameters\n\nIn a similar manner to [Body](body.md#request-body-path-query-parameters), you can use\nForm data in combination with other parameter sources.\n\nYou can declare query **and** path **and** form field, **and** etc... parameters at the same time.\n\n**Django Ninja** will recognize that the function parameters that match path\nparameters should be **taken from the path**, and that function parameters that\nare declared with `Form(...)` should be **taken from the request form fields**, etc.\n\n```python hl_lines=\"12\"\n{!./src/tutorial/form/code02.py!}\n```\n## Mapping Empty Form Field to Default\n\nForm fields that are optional, are often sent with an empty value. This value is\ninterpreted as an empty string, and thus may fail validation for fields such as `int` or `bool`.\n\nThis can be fixed, as described in the Pydantic docs, by using\n[Generic Classes as Types](https://pydantic-docs.helpmanual.io/usage/types/#generic-classes-as-types).\n\n```python hl_lines=\"15 16 23-25\"\n{!./src/tutorial/form/code03.py!}\n```\n"
},
{
"path": "docs/docs/guides/input/operations.md",
"content": "# HTTP Methods\n\n## Defining operations\n\nAn `operation` can be one of the following [HTTP methods](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods):\n\n- GET\n- POST\n- PUT\n- DELETE\n- PATCH\n\n**Django Ninja** comes with a decorator for each operation:\n\n```python hl_lines=\"1 5 9 13 17\"\n@api.get(\"/path\")\ndef get_operation(request):\n ...\n\n@api.post(\"/path\")\ndef post_operation(request):\n ...\n\n@api.put(\"/path\")\ndef put_operation(request):\n ...\n\n@api.delete(\"/path\")\ndef delete_operation(request):\n ...\n\n@api.patch(\"/path\")\ndef patch_operation(request):\n ...\n```\n\nSee the [operations parameters](../../reference/operations-parameters.md)\nreference docs for information on what you can pass to any of these decorators.\n\n## Handling multiple methods\n\nIf you need to handle multiple methods with a single function for a given path,\nyou can use the `api_operation` decorator:\n\n```python hl_lines=\"1\"\n@api.api_operation([\"POST\", \"PATCH\"], \"/path\")\ndef mixed_operation(request):\n ...\n```\n\nThis feature can also be used to implement other HTTP methods that don't have\ncorresponding **Django Ninja** methods, such as `HEAD` or `OPTIONS`.\n\n```python hl_lines=\"1\"\n@api.api_operation([\"HEAD\", \"OPTIONS\"], \"/path\")\ndef mixed_operation(request):\n ...\n```\n"
},
{
"path": "docs/docs/guides/input/path-params.md",
"content": "# Path parameters\nYou can declare path \"parameters\" with the same syntax used by Python format-strings (which luckily also matches the OpenAPI path parameters ):\n\n```python hl_lines=\"1 2\"\n{!./src/tutorial/path/code01.py!}\n```\n\nThe value of the path parameter `item_id` will be passed to your function as the argument `item_id`.\n\nSo, if you run this example and go to http://localhost:8000/api/items/foo , you will see this response:\n\n```JSON\n{\"item_id\":\"foo\"}\n```\n\n\n### Path parameters with types\nYou can declare the type of path parameter in the function using standard Python type annotations:\n\n```python hl_lines=\"2\"\n{!./src/tutorial/path/code02.py!}\n```\n\nIn this case,`item_id` is declared to be an **`int`**. This will give you editor and linter support for error checks, completion, etc.\n\nIf you run this in your browser with http://localhost:8000/api/items/3 , you will see this response:\n```JSON\n{\"item_id\":3}\n```\n\n!!! tip\n Notice that the value your function received (and returned) is **3**, as a Python `int` - not a string `\"3\"`.\n So, with just that type declaration, **Django Ninja** gives you automatic request \"parsing\" and validation.\n\n\n\n### Data validation\nOn the other hand, if you go to the browser at http://localhost:8000/api/items/foo *(`\"foo\"` is not int)* , you will see an HTTP error like this:\n\n```JSON hl_lines=\"8\"\n{\n \"detail\": [\n {\n \"loc\": [\n \"path\",\n \"item_id\"\n ],\n \"msg\": \"value is not a valid integer\",\n \"type\": \"type_error.integer\"\n }\n ]\n}\n```\n\n\n### Django Path Converters\n\nYou can use [Django Path Converters](https://docs.djangoproject.com/en/stable/topics/http/urls/#path-converters)\nto help parse the path:\n\n```python hl_lines=\"1\"\n@api.get(\"/items/{int:item_id}\")\ndef read_item(request, item_id):\n return {\"item_id\": item_id}\n```\n\nIn this case,`item_id` will be parsed as an **`int`**. If `item_id` is not a valid `int`, the url will not\nmatch. (e.g. if no other path matches, a *404 Not Found* will be returned)\n\n!!! tip\n Notice that, since **Django Ninja** uses a default type of `str` for unannotated parameters, the value the\n function above received (and returned) is `\"3\"`, as a Python `str` - not an integer **3**. To receive\n an `int`, simply declare `item_id` as an `int` type annotation in the function definition as normal:\n\n ```python hl_lines=\"2\"\n @api.get(\"/items/{int:item_id}\")\n def read_item(request, item_id:int):\n return {\"item_id\": item_id}\n ```\n \n#### Path params with slashes\n\nDjango's `path` converter allows you to handle path-like parameters:\n\n```python hl_lines=\"1\"\n@api.get('/dir/{path:value}')\ndef someview(request, value: str):\n return value\n```\nyou can query this operation with `/dir/some/path/with-slashes` and your `value` will be equal to `some/path/with-slashes`\n\n### Multiple parameters\n\nYou can pass as many variables as you want into `path`, just remember to have unique names and don't forget to use the same names in the function arguments.\n\n```python\n@api.get(\"/events/{year}/{month}/{day}\")\ndef events(request, year: int, month: int, day: int):\n return {\"date\": [year, month, day]}\n```\n\n\n### Using Schema\n\nYou can also use Schema to encapsulate path parameters that depend on each other (and validate them as a group):\n\n\n```python hl_lines=\"1 2 5 6 7 8 9 10 11 15\"\n{!./src/tutorial/path/code010.py!}\n```\n\n!!! note\n Notice that here we used a `Path` source hint to let **Django Ninja** know that this schema will be applied to path parameters.\n\n### Documentation\nNow, when you open your browser at http://localhost:8000/api/docs , you will see the automatic, interactive, API documentation.\n\n"
},
{
"path": "docs/docs/guides/input/query-params.md",
"content": "# Query parameters\n\nWhen you declare other function parameters that are not part of the path parameters, they are automatically interpreted as \"query\" parameters.\n\n```python hl_lines=\"5\"\n{!./src/tutorial/query/code01.py!}\n```\n\nTo query this operation, you use a URL like:\n\n```\nhttp://localhost:8000/api/weapons?offset=0&limit=10\n```\nBy default, all GET parameters are strings, and when you annotate your function arguments with types, they are converted to that type and validated against it.\n\nThe same benefits that apply to path parameters also apply to query parameters:\n\n- Editor support (obviously)\n- Data \"parsing\"\n- Data validation\n- Automatic documentation\n\n\n!!! Note\n if you do not annotate your arguments, they will be treated as `str` types\n\n```python hl_lines=\"2\"\n@api.get(\"/weapons\")\ndef list_weapons(request, limit, offset):\n # type(limit) == str\n # type(offset) == str\n```\n\n### Defaults\n\nAs query parameters are not a fixed part of a path, they are optional and can have default values:\n\n```python hl_lines=\"2\"\n@api.get(\"/weapons\")\ndef list_weapons(request, limit: int = 10, offset: int = 0):\n return weapons[offset : offset + limit]\n```\n\nIn the example above we set default values of `offset=0` and `limit=10`.\n\nSo, going to the URL:\n```\nhttp://localhost:8000/api/weapons\n```\nwould be the same as going to:\n```\nhttp://localhost:8000/api/weapons?offset=0&limit=10\n```\nIf you go to, for example:\n```\nhttp://localhost:8000/api/weapons?offset=20\n```\n\nthe parameter values in your function will be:\n\n - `offset=20` (because you set it in the URL)\n - `limit=10` (because that was the default value)\n\n\n### Required and optional parameters\n\nYou can declare required or optional GET parameters in the same way as declaring Python function arguments:\n\n```python hl_lines=\"5\"\n{!./src/tutorial/query/code02.py!}\n```\n\nIn this case, **Django Ninja** will always validate that you pass the `q` param in the GET, and the `offset` param is an optional integer.\n\n### GET parameters type conversion\n\nLet's declare multiple type arguments:\n```python hl_lines=\"5\"\n{!./src/tutorial/query/code03.py!}\n```\nThe `str` type is passed as is.\n\nFor the `bool` type, all the following:\n```\nhttp://localhost:8000/api/example?b=1\nhttp://localhost:8000/api/example?b=True\nhttp://localhost:8000/api/example?b=true\nhttp://localhost:8000/api/example?b=on\nhttp://localhost:8000/api/example?b=yes\n```\nor any other case variation (uppercase, first letter in uppercase, etc.), your function will see\nthe parameter `b` with a `bool` value of `True`, otherwise as `False`.\n\nDate can be both date string and integer (unix timestamp):\n\n\nhttp://localhost:8000/api/example?d=1577836800 # same as 2020-01-01\nhttp://localhost:8000/api/example?d=2020-01-01 \n \n\n\n### Using Schema\n\nYou can also use Schema to encapsulate GET parameters:\n\n```python hl_lines=\"1 2 5 6 7 8\"\n{!./src/tutorial/query/code010.py!}\n```\n\nFor more complex filtering scenarios please refer to [filtering](./filtering.md).\n"
},
{
"path": "docs/docs/guides/input/request-parsers.md",
"content": "# Request parsers\n\nIn most cases, the default content type for REST API's is JSON, but in case you need to work with\nother content types (like YAML, XML, CSV) or use faster JSON parsers, **Django Ninja** provides a `parser` configuration.\n\n```python\napi = NinjaAPI(parser=MyYamlParser())\n```\n\nTo create your own parser, you need to extend the `ninja.parser.Parser` class, and override the `parse_body` method.\n\n\n## Example YAML Parser\n\nLet's create our custom YAML parser:\n\n```python hl_lines=\"4 8 9\"\nimport yaml\nfrom typing import List\nfrom ninja import NinjaAPI\nfrom ninja.parser import Parser\n\n\nclass MyYamlParser(Parser):\n def parse_body(self, request):\n return yaml.safe_load(request.body)\n\n\napi = NinjaAPI(parser=MyYamlParser())\n\n\nclass Payload(Schema):\n ints: List[int]\n string: str\n f: float\n\n\n@api.post('/yaml')\ndef operation(request, payload: Payload):\n return payload.dict()\n\n\n```\n\nIf you now send YAML like this as the request body:\n\n```YAML\nints:\n - 0\n - 1\nstring: hello\nf: 3.14\n```\n\nit will be correctly parsed, and you should have JSON output like this:\n\n\n```JSON\n{\n \"ints\": [\n 0,\n 1\n ],\n \"string\": \"hello\",\n \"f\": 3.14\n}\n```\n\n\n## Example ORJSON Parser\n\n[orjson](https://github.com/ijl/orjson#orjson) is a fast, accurate JSON library for Python. It benchmarks as the fastest Python library for JSON and is more accurate than the standard `json` library or other third-party libraries.\n\n```\npip install orjson\n```\n\nParser code:\n\n```python hl_lines=\"1 8 9\"\nimport orjson\nfrom ninja import NinjaAPI\nfrom ninja.parser import Parser\n\n\nclass ORJSONParser(Parser):\n def parse_body(self, request):\n return orjson.loads(request.body)\n\n\napi = NinjaAPI(parser=ORJSONParser())\n```\n\n"
},
{
"path": "docs/docs/guides/response/config-pydantic.md",
"content": "# Overriding Pydantic Config\n\nThere are many customizations available for a **Django Ninja `Schema`**, via the schema's\n[Pydantic `model_config`](https://docs.pydantic.dev/latest/api/config/). \n\n!!! info\n Under the hood **Django Ninja** uses [Pydantic Models](https://pydantic-docs.helpmanual.io/usage/models/)\n with all their power and benefits. The alias `Schema` was chosen to avoid confusion in code\n when using Django models, as Pydantic's model class is called Model by default, and conflicts with\n Django's Model class.\n\n## Example Camel Case mode\n\nOne interesting config attribute is [`alias_generator`](https://docs.pydantic.dev/latest/api/config/?query=alias_generator#pydantic.config.ConfigDict.alias_generator).\nUsing Pydantic's example in **Django Ninja** can look something like:\n\n```python hl_lines=\"10\"\nfrom pydantic import ConfigDict\nfrom ninja import Schema\n\n\ndef to_camel(string: str) -> str:\n words = string.split('_')\n return words[0].lower() + ''.join(word.capitalize() for word in words[1:])\n\nclass CamelModelSchema(Schema):\n model_config = ConfigDict(alias_generator=to_camel)\n str_field_name: str\n float_field_name: float\n```\n\nKeep in mind that when you want modify output for field names (like camel case) - you need to set as well `populate_by_name` and `by_alias`\n\n```python hl_lines=\"6 14\"\nfrom pydantic import ConfigDict\n\nclass UserSchema(ModelSchema):\n model_config = ConfigDict(\n alias_generator = to_camel\n populate_by_name = True, # !!!!!! <--------\n )\n class Meta:\n model = User\n fields = [\"id\", \"email\", \"is_staff\"]\n\n\n\n@api.get(\"/users\", response=list[UserSchema], by_alias=True) # !!!!!! <-------- by_alias\ndef get_users(request):\n return User.objects.all()\n\n```\n\nresults:\n\n```JSON\n[\n {\n \"id\": 1,\n \"email\": \"tim@apple.com\",\n \"isStaff\": true\n },\n {\n \"id\": 2,\n \"email\": \"sarah@smith.com\",\n \"isStaff\": false\n }\n ...\n]\n\n```\n\n\n"
},
{
"path": "docs/docs/guides/response/django-pydantic-create-schema.md",
"content": "# Using create_schema\n\nUnder the hood, [`ModelSchema`](django-pydantic.md#modelschema) uses the `create_schema` function.\nThis is a more advanced (and less safe) method - please use it carefully.\n\n## `create_schema`\n\n**Django Ninja** comes with a helper function `create_schema`:\n\n```python\ndef create_schema(\n model, # django model\n name = \"\", # name for the generated class, if empty model names is used\n depth = 0, # if > 0 schema will also be created for the nested ForeignKeys and Many2Many (with the provided depth of lookup)\n fields: list[str] = None, # if passed - ONLY these fields will added to schema\n exclude: list[str] = None, # if passed - these fields will be excluded from schema\n optional_fields: list[str] | str = None, # if passed - these fields will not be required on schema (use '__all__' to mark ALL fields required)\n custom_fields: list[tuple(str, Any, Any)] = None, # if passed - this will override default field types (or add new fields)\n)\n```\n\n\nTake this example:\n\n```python hl_lines=\"2 4\"\nfrom django.contrib.auth.models import User\nfrom ninja.orm import create_schema\n\nUserSchema = create_schema(User)\n\n# Will create schema like this:\n# \n# class UserSchema(Schema):\n# id: int\n# username: str\n# first_name: str\n# last_name: str\n# password: str\n# last_login: datetime\n# is_superuser: bool\n# email: str\n# ... and the rest\n\n```\n\n!!! Warning\n By default `create_schema` builds a schema with ALL model fields.\n This can lead to accidental unwanted data exposure (like hashed password, in the above example).\n star on github  \n\nor share this URL on social media: \n```\nhttps://django-ninja.dev\n```\nFollow updates on twitter @django_ninja \n\n## Do you want to help us?\n\nPull requests are always welcome.\n\nYou can inspect our docs for typos and spelling mistakes, and create pull requests or open an issue .\n\nIf you have any suggestions to improve **Django Ninja**, please create them as issues on GitHub.\n\n\n## Do you need help?\n\nDo not hesitate. Go to GitHub issues and describe your question or problem. We'll attempt to address them quickly.\n\nJoin the chat at our Discord server.\n\n[Code-on the webdesign and web development company](https://code-on.be/) gives commercial consulting for Django-Ninja. If you are looking for support please contact Code-on and we will be in touch with you soon.\n"
},
{
"path": "docs/docs/index.md",
"content": "# Django Ninja - Fast Django REST Framework\n\n\n\n\n\n\nDjango Ninja is a web framework for building APIs with Django and Python 3.6+ type hints.\n\nKey features:\n\n - **Easy**: Designed to be easy to use and intuitive.\n - **FAST execution**: Very high performance thanks to **Pydantic ** and **async support **. \n - **Fast to code**: Type hints and automatic docs lets you focus only on business logic.\n - **Standards-based**: Based on the open standards for APIs: **OpenAPI** (previously known as Swagger) and **JSON Schema**.\n - **Django friendly**: (obviously) has good integration with the Django core and ORM.\n - **Production ready**: Used by multiple companies on live projects (If you use Django Ninja and would like to publish your feedback, please email ppr.vitaly@gmail.com).\n\nBenchmarks :\n\n\n\n## Installation\n\n```\npip install django-ninja\n```\n\n## Quick Example\n\nStart a new Django project (or use an existing one)\n```\ndjango-admin startproject apidemo\n```\n\nin `urls.py`\n\n```python hl_lines=\"3 5 8 9 10 15\"\n{!./src/index001.py!}\n```\n\nNow, run it as usual:\n```\n./manage.py runserver\n```\n\nNote: You don't have to add Django Ninja to your installed apps for it to work.\n\n## Check it\n\nOpen your browser at http://127.0.0.1:8000/api/add?a=1&b=2 \n\nYou will see the JSON response as:\n```JSON\n{\"result\": 3}\n```\nNow you've just created an API that:\n\n - receives an HTTP GET request at `/api/add`\n - takes, validates and type-casts GET parameters `a` and `b`\n - decodes the result to JSON\n - generates an OpenAPI schema for defined operation\n\n## Interactive API docs\n\nNow go to http://127.0.0.1:8000/api/docs \n\nYou will see the automatic, interactive API documentation (provided by the OpenAPI / Swagger UI or Redoc ):\n\n\n\n\n## Recap\n\nIn summary, you declare the types of parameters, body, etc. **once only**, as function parameters. \n\nYou do that with standard modern Python types.\n\nYou don't have to learn a new syntax, the methods or classes of a specific library, etc.\n\nJust standard **Python 3.6+**.\n\nFor example, for an `int`:\n\n```python\na: int\n```\n\nor, for a more complex `Item` model:\n\n```python\nclass Item(Schema):\n foo: str\n bar: float\n\ndef operation(a: Item):\n ...\n```\n\n... and with that single declaration you get:\n\n* Editor support, including:\n * Completion\n * Type checks\n* Validation of data:\n * Automatic and clear errors when the data is invalid\n * Validation, even for deeply nested JSON objects\n* Conversion of input data coming from the network, to Python data and types, and reading from:\n * JSON\n * Path parameters\n * Query parameters\n * Cookies\n * Headers\n * Forms\n * Files\n* Automatic, interactive API documentation\n\nThis project was heavily inspired by FastAPI (developed by Sebastián Ramírez )\n\n"
},
{
"path": "docs/docs/javascripts/ask-ai-button.js",
"content": "// Add \"Ask AI\" button to the Material for MkDocs navbar\ndocument.addEventListener('DOMContentLoaded', function() {\n // Find the header navigation actions (right side of navbar)\n const headerActions = document.querySelector('.md-header__topic + .md-header__option');\n const headerTitle = document.querySelector('.md-header__title');\n\n if (headerTitle) {\n // Create the Ask AI button\n const askAiButton = document.createElement('a');\n askAiButton.href = '/chat'; // Update this URL to your desired destination\n askAiButton.className = 'md-button ask-ai-button';\n askAiButton.textContent = 'Ask AI';\n askAiButton.title = 'Ask AI about Django Ninja';\n\n // Create a container for the button\n const buttonContainer = document.createElement('div');\n buttonContainer.className = 'ask-ai-button-container';\n buttonContainer.appendChild(askAiButton);\n\n // Insert the button after the header title\n const header = document.querySelector('.md-header__inner');\n if (header) {\n // Find the right spot - after title, before search/repo buttons\n const source = document.querySelector('.md-header__source');\n if (source) {\n header.insertBefore(buttonContainer, source);\n } else {\n header.appendChild(buttonContainer);\n }\n }\n }\n});\n"
},
{
"path": "docs/docs/motivation.md",
"content": "# Motivation\n\n!!! quote\n **Django Ninja** looks basically the same as **FastAPI**, so why not just use FastAPI?\n\nIndeed, **Django Ninja** is heavily inspired by FastAPI (developed by Sebastián Ramírez )\n\nThat said, there are few issues when it comes to getting FastAPI and Django to work together properly:\n\n1) **FastAPI** declares to be ORM agnostic (meaning you can use it with SQLAlchemy or the Django ORM), but in reality the Django ORM is not yet ready for async use (it may be in version 4.0 or 4.1), and if you use it in sync mode, you can have a [closed connection issue](https://github.com/tiangolo/fastapi/issues/716) which you will have to overcome with a **lot** of effort.\n\n2) The dependency injection with arguments makes your code too verbose when you rely on authentication and database sessions in your operations (which for some projects is about 99% of all operations).\n\n```python hl_lines=\"25 26\"\n...\n\napp = FastAPI()\n\n\n# Dependency\ndef get_db():\n db = SessionLocal()\n try:\n yield db\n finally:\n db.close()\n\n\nasync def get_current_user(token: str = Depends(oauth2_scheme)):\n user = decode(token)\n if not user:\n raise HTTPException(...)\n return user\n\n\n@app.get(\"/task/{task_id}\", response_model=Task)\ndef read_user(\n task_id: int,\n db: Session = Depends(get_db), \n current_user: User = Depends(get_current_user),\n ):\n ... use db with current_user ....\n```\n\n3) Since the word `model` in Django is \"reserved\" for use by the ORM, it becomes very confusing when you mix the Django ORM with Pydantic/FastAPI model naming conventions. \n\n### Django Ninja\n\nDjango Ninja addresses all those issues, and integrates very well with Django (ORM, urls, views, auth and more)\n\nWorking at [Code-on a Django webdesign webedevelopment studio](https://code-on.be/) I get all sorts of challenges and to solve these I started Django-Ninja in 2020.\n\nNote: **Django Ninja is a production ready project** - my estimation is at this time already 100+ companies using it in production and 500 new developers joining every month. \n\nSome companies are already looking for developers with django ninja experience.\n\n#### Main Features\n\n1) Since you can have multiple Django Ninja API instances - you can run [multiple API versions](guides/versioning.md) inside one Django project.\n\n```python\napi_v1 = NinjaAPI(version='1.0', auth=token_auth)\n...\napi_v2 = NinjaAPI(version='2.0', auth=token_auth)\n...\napi_private = NinjaAPI(auth=session_auth, urls_namespace='private_api')\n...\n\n\nurlpatterns = [\n ...\n path('api/v1/', api_v1.urls),\n path('api/v2/', api_v2.urls),\n path('internal-api/', api_private.urls),\n]\n```\n\n2) The Django Ninja 'Schema' class is integrated with the ORM, so you can [serialize querysets](guides/response/index.md#returning-querysets) or ORM objects:\n\n```python\n@api.get(\"/tasks\", response=List[TaskSchema])\ndef tasks(request):\n return Task.objects.all()\n\n\n@api.get(\"/tasks\", response=TaskSchema)\ndef tasks_details(request):\n task = Task.objects.first()\n return task\n```\n3) [Create Schema's from Django Models](guides/response/django-pydantic.md).\n\n4) Instead of dependency arguments, **Django Ninja** uses `request` instance attributes (in the same way as regular Django views) - more detail at [Authentication](guides/authentication.md).\n"
},
{
"path": "docs/docs/proposals/cbv.md",
"content": "# Class Based Operations\n\n\n!!! warning \"\"\n This is just a proposal and it is **not present in library code**, but eventually this can be a part of Django Ninja.\n\n Please consider adding likes/dislikes or comments in [github issue](https://github.com/vitalik/django-ninja/issues/15) to express your feeling about this proposal\n\n\n## Problem\n\nAn API operation is a callable which takes a request and parameters and returns a response, but it is often a case in real world when you need to reuse the same pieces of code in multiple operations.\n\nLet's take the following example:\n\n - we have a Todo application with Projects and Tasks\n - each project has multiple tasks\n - each project may also have an owner (user)\n - users should not be able to access projects they do not own\n\nModel structure is something like this:\n\n```python\nclass Project(models.Model):\n title = models.CharField(max_length=100)\n owner = models.ForeignKey('auth.User', on_delete=models.CASCADE)\n\nclass Task(models.Model):\n project = models.ForeignKey(Project, on_delete=models.CASCADE)\n title = models.CharField(max_length=100)\n completed = models.BooleanField()\n```\n\n\nNow, let's create a few API operations for it:\n\n - a list of tasks for the project\n - some task details\n - a 'complete task' action\n\nThe code should validate that a user can only access his/her own project's tasks (otherwise, return 404)\n\nIt can be something like this:\n\n\n```python\nrouter = Router()\n\n@router.get('/project/{project_id}/tasks/', response=List[TaskOut])\ndef task_list(request):\n user_projects = request.user.project_set\n project = get_object_or_404(user_projects, id=project_id))\n return project.task_set.all()\n\n@router.get('/project/{project_id}/tasks/{task_id}/', response=TaskOut)\ndef details(request, task_id: int):\n user_projects = request.user.project_set\n project = get_object_or_404(user_projects, id=project_id))\n user_tasks = project.task_set.all()\n return get_object_or_404(user_tasks, id=task_id)\n\n\n@router.post('/project/{project_id}/tasks/{task_id}/complete', response=TaskOut)\ndef complete(request, task_id: int):\n user_projects = request.user.project_set\n project = get_object_or_404(user_projects, id=project_id))\n user_tasks = project.task_set.all()\n task = get_object_or_404(user_tasks, id=task_id)\n task.completed = True\n task.save()\n return task\n```\n\n\nAs you can see, these lines are getting repeated pretty often to check permission:\n\n```python hl_lines=\"1 2\"\nuser_projects = request.user.project_set\nproject = get_object_or_404(user_projects, id=project_id))\n```\n\nYou can extract it to a function, but it will just make it 3 lines smaller, and it will still be pretty polluted ...\n\n\n## Solution\n\nThe proposal is to have alternative called \"Class Based Operation\" where you can decorate the entire class with a `path` decorator:\n\n\n```python hl_lines=\"7 8\"\nfrom ninja import Router\n\n\nrouter = Router()\n\n\n@router.path('/project/{project_id}/tasks')\nclass Tasks:\n def __init__(self, request, project_id=int):\n user_projects = request.user.project_set\n self.project = get_object_or_404(user_projects, id=project_id))\n self.tasks = self.project.task_set.all()\n \n @router.get('/', response=List[TaskOut])\n def task_list(self, request):\n return self.tasks\n\n @router.get('/{task_id}/', response=TaskOut)\n def details(self, request, task_id: int):\n return get_object_or_404(self.tasks, id=task_id)\n\n @router.post('/{task_id}/complete', response=TaskOut)\n def complete(self, request, task_id: int):\n task = get_object_or_404(self.tasks, id=task_id)\n task.completed = True\n task.save()\n return task\n```\n\nAll common initiation and permission checks are placed in the constructor:\n\n```python hl_lines=\"4 5 6\"\n@router.path('/project/{project_id}/tasks')\nclass Tasks:\n def __init__(self, request, project_id=int):\n user_projects = request.user.project_set\n self.project = get_object_or_404(user_projects, id=project_id))\n self.tasks = self.project.task_set.all()\n```\n\nThis makes the main business operation focus only on tasks (exposed as the `self.tasks` attribute)\n\nYou can use both `api` and `router` instances to support class paths.\n\n## Issue\n\nThe `__init__` method:\n\n```def __init__(self, request, project_id=int):```\n\nPython doesn't support the `async` keyword for `__init__`, so to support async operations we need some other method for initialization, but `__init__` sounds the most logical.\n\n\n## Your thoughts/proposals\n\nPlease give you thoughts/likes/dislikes about this proposal in the [github issue](https://github.com/vitalik/django-ninja/issues/15)\n"
},
{
"path": "docs/docs/proposals/index.md",
"content": "# Enhancement Proposals\n\nEnhancement Proposals are a formal way of proposing large feature additions to the **Django Ninja Framework**.\n\nYou can create a proposal by making a pull request with a new page under [`docs/proposals`](https://github.com/vitalik/django-ninja/tree/master/docs/docs/proposals), or by creating an [issue on github](https://github.com/vitalik/django-ninja/issues).\n\nPlease see the current proposals:\n\n - [Class Based Operations](cbv.md)\n"
},
{
"path": "docs/docs/proposals/v1.md",
"content": "# Potential v1 changes\n\nDjango Ninja is already used by tens of companies and by the visitors and downloads stats it's growing.\n\nAt this point introducing changes that will force current users to change their code (or break it) is not \nacceptable.\n\nOn the other hand some decisions that where initially made does not work well. These breaking changes will be \nintroduced in version 1.0.0\n\n## Changes that most likely be in v1\n\n - **auth** will be class interface instead of callable (to support async authenticators)\n - **responses** to support **codes/headers/content** (like general Response class)\n - **routers paths** currently automatically **joined with \"/\"** - which might not needed on some cases where router prefix will act like a prefix and not subfolder\n\n## Your thoughts/proposals\n\nPlease give you thoughts/likes/dislikes in the [github issue](https://github.com/vitalik/django-ninja/issues/146).\n\n"
},
{
"path": "docs/docs/reference/api.md",
"content": "# NinjaAPI\n\n::: ninja.main.NinjaAPI\n rendering:\n show_signature: False\n group_by_category: False\n"
},
{
"path": "docs/docs/reference/csrf.md",
"content": "# CSRF\n\n## What is CSRF?\n> [Cross Site Request Forgery](https://en.wikipedia.org/wiki/Cross-site_request_forgery) occurs when a malicious website contains a link, a form button or some JavaScript that is intended to perform some action on your website, using the credentials (or location on the network, not covered by this documentation) of a logged-in user who visits the malicious site in their browser.\n\n\n## How to protect against CSRF with Django Ninja\n### Use an authentication method not automatically embedded in the request\nCSRF attacks rely on authentication methods that are automatically included in requests started from another site, like [cookies](https://en.wikipedia.org/wiki/HTTP_cookie) or [Basic access authentication](https://en.wikipedia.org/wiki/Basic_access_authentication).\nUsing an authentication method that does not automatically gets embedded, such as the `Authorization: Bearer` header for exemple, mitigates this attack.\n\n\n### Use Django's built-in CSRF protection\nIn case you are using the default Django authentication, which uses cookies, you must also use the default [Django CSRF protection](https://docs.djangoproject.com/en/4.2/ref/csrf/).\n\n\nBy default, **Django Ninja** has CSRF protection turned **OFF** for all operations, but will automatically enable csrf **for Cookie based** authentication:\n\n\n```python hl_lines=\"8\"\nfrom ninja import NinjaAPI\nfrom ninja.security import APIKeyCookie\n\nclass CookieAuth(APIKeyCookie):\n def authenticate(self, request, key):\n return key == \"test\"\n\napi = NinjaAPI(auth=CookieAuth())\n\n```\n\n\nor django-auth based (which is inherited from cookie based auth):\n\n```python hl_lines=\"4\"\nfrom ninja import NinjaAPI\nfrom ninja.security import django_auth\n\napi = NinjaAPI(auth=django_auth)\n```\n\n\n#### Django `ensure_csrf_cookie` decorator\nYou can use the Django [ensure_csrf_cookie](https://docs.djangoproject.com/en/4.2/ref/csrf/#django.views.decorators.csrf.ensure_csrf_cookie) decorator on an unprotected route to make it include a `Set-Cookie` header for the CSRF token. Note that:\n\n- The route decorator must be executed before (i.e. above) the [ensure_csrf_cookie](https://docs.djangoproject.com/en/4.2/ref/csrf/#django.views.decorators.csrf.ensure_csrf_cookie) decorator).\n- You must `csrf_exempt` that route.\n- The `ensure_csrf_cookie` decorator works only on a Django `HttpResponse` (and subclasses like `JsonResponse`) and not on a dict like most Django Ninja decorators.\n- If you [set a Cookie based authentication (which includes `django_auth`) globally to your API](../guides/authentication.md), you'll have to specifically disable auth on that route (with `auth=None` in the route decorator) as Cookie based authentication would raise an Exception when applied to an unprotected route (for security reasons).\n\n```python hl_lines=\"4\"\nfrom django.http import HttpResponse\nfrom django.views.decorators.csrf import csrf_exempt, ensure_csrf_cookie\n\n@api.post(\"/csrf\")\n@ensure_csrf_cookie\n@csrf_exempt\ndef get_csrf_token(request):\n return HttpResponse()\n```\nA request to that route triggers a response with the adequate `Set-Cookie` header from Django.\n\n\n#### Frontend code\nYou may use the [Using CSRF protection with AJAX](https://docs.djangoproject.com/en/4.2/howto/csrf/#using-csrf-protection-with-ajax) and [Setting the token on the AJAX request](https://docs.djangoproject.com/en/4.2/howto/csrf/#setting-the-token-on-the-ajax-request) part of the [How to use Django’s CSRF protection](https://docs.djangoproject.com/en/4.2/howto/csrf/) to know how to handle that CSRF protection token in your frontend code.\n\n\n## A word about CORS\nYou may want to set-up your frontend and API on different sites (in that case, you may check [django-cors-headers](https://github.com/adamchainz/django-cors-headers)).\nWhile not directly related to CSRF, CORS (Cross-Origin Resource Sharing) may help in case you are defining the CSRF cookie on another site than the frontend consuming it, as this is not allowed by default by the [Same-origin policy](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy).\nYou may check the [django-cors-headers README](https://github.com/adamchainz/django-cors-headers#readme) then.\n"
},
{
"path": "docs/docs/reference/management-commands.md",
"content": "# Management Commands\n\nManagement commands require **Django Ninja** to be installed in Django's\n`INSTALLED_APPS` setting:\n\n```python\nINSTALLED_APPS = [\n ...\n 'ninja',\n]\n```\n\n::: ninja.management.commands\n selection:\n filters:\n - \"![A-Z]\"\n rendering:\n show_root_toc_entry: False\n"
},
{
"path": "docs/docs/reference/operations-parameters.md",
"content": "# Operations parameters\n\n## OpenAPI Schema related\n\nThe following parameters interact with how the OpenAPI schema (and docs) are generated.\n\n### `tags`\n\nYou can group your API operations using the `tags` argument (`list[str]`). \n```python hl_lines=\"6\"\n@api.get(\"/hello/\")\ndef hello(request, name: str):\n return {\"hello\": name}\n\n\n@api.post(\"/orders/\", tags=[\"orders\"])\ndef create_order(request, order: Order):\n return {\"success\": True}\n```\n\nTagged operations may be handled differently by various tools and libraries. For example, the Swagger UI uses tags to group the displayed operations.\n\n\n\n#### Router tags\n\nYou can use `tags` argument to apply tags to all operations declared by router:\n\n```python\napi.add_router(\"/events/\", events_router, tags=[\"events\"])\n\n# or using constructor: \n\nrouter = Router(tags=[\"events\"])\n```\n\n\n### `summary`\n\nA human-readable name for your operation.\n\nBy default, it's generated by capitalizing your operation function name:\n\n```python hl_lines=\"2\"\n@api.get(\"/hello/\")\ndef hello(request, name: str):\n return {\"hello\": name}\n```\n\n\n\nIf you want to override it or translate it to other language, use the `summary` argument in the `api` decorator.\n\n```python hl_lines=\"1\"\n@api.get(\"/hello/\", summary=\"Say Hello\")\ndef hello(request, name: str):\n return {\"hello\": name}\n```\n\n\n\n### `description`\n\nTo provide more information about your operation, use either the `description` argument or normal Python docstrings:\n\n\n```python hl_lines=\"1\"\n@api.post(\"/orders/\", description=\"Creates an order and updates stock\")\ndef create_order(request, order: Order):\n return {\"success\": True}\n```\n\n\n\nWhen you need to provide a long multi line description, you can use Python `docstrings` for the function definition:\n\n```python hl_lines=\"4 5 6 7\"\n@api.post(\"/orders/\")\ndef create_order(request, order: Order):\n \"\"\"\n To create an order please provide:\n - **first_name**\n - **last_name**\n - and **list of Items** *(product + amount)*\n \"\"\"\n return {\"success\": True}\n\n```\n\n\n\n\n### `operation_id`\n\nThe OpenAPI `operationId` is an optional unique string used to identify an operation. If provided, these IDs must be unique among all operations described in your API.\n\nBy default, **Django Ninja** sets it to `module name` + `function name`.\n\nIf you want to set it individually for each operation, use the `operation_id` argument:\n\n```python hl_lines=\"2\"\n...\n@api.post(\"/tasks\", operation_id=\"create_task\")\ndef new_task(request):\n ...\n```\n\nIf you want to override global behavior, you can inherit the NinjaAPI instance and override the `get_openapi_operation_id` method.\n\nIt will be called for each operation that you defined, so you can set your custom naming logic like this:\n\n```python hl_lines=\"5 6 7 9\"\nfrom ninja import NinjaAPI\n\nclass MySuperApi(NinjaAPI):\n\n def get_openapi_operation_id(self, operation):\n # here you can access operation ( .path , .view_func, etc) \n return ...\n\napi = MySuperApi()\n\n@api.get(...)\n...\n```\n\n### `deprecated`\n\nMark an operation as deprecated without removing it by using the `deprecated` argument:\n\n```python hl_lines=\"1\"\n@api.post(\"/make-order/\", deprecated=True)\ndef some_old_method(request, order: str):\n return {\"success\": True}\n```\n\nIt will be marked as deprecated in the JSON Schema and also in the interactive OpenAPI docs:\n\n\n\n### `include_in_schema`\n\nIf you need to include/exclude some operation from OpenAPI schema use `include_in_schema` argument:\n\n```python hl_lines=\"1\"\n@api.post(\"/hidden\", include_in_schema=False)\ndef some_hidden_operation(request):\n pass\n```\n\n## openapi_extra\nYou can customize your OpenAPI schema for specific endpoint (detail [OpenAPI Customize Options](https://swagger.io/docs/specification/about/))\n```python hl_lines=\"1 26\"\n# You can set requestBody from openapi_extra\n@api.get(\n \"/tasks\",\n openapi_extra={\n \"requestBody\": {\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"required\": [\"email\"],\n \"type\": \"object\",\n \"properties\": {\n \"name\": {\"type\": \"string\"},\n \"phone\": {\"type\": \"number\"},\n \"email\": {\"type\": \"string\"},\n },\n }\n }\n },\n \"required\": True,\n }\n },\n)\ndef some_operation(request):\n pass\n \n# You can add additional responses to the automatically generated schema\n@api.post(\n \"/tasks\",\n openapi_extra={\n \"responses\": {\n 400: {\n \"description\": \"Error Response\",\n },\n 404: {\n \"description\": \"Not Found Response\",\n },\n },\n },\n)\ndef some_operation_2(request):\n pass\n\n```\n\n\n## Response output options\n\nThere are a few arguments that lets you tune response's output:\n\n### `by_alias`\n\nWhether field aliases should be used as keys in the response (defaults to `False`).\n\n### `exclude_unset`\n\nWhether fields that were not set when creating the schema, and have their default values, should be excluded from the response (defaults to `False`).\n\n### `exclude_defaults`\n\nWhether fields which are equal to their default values (whether set or otherwise) should be excluded from the response (defaults to `False`).\n\n### `exclude_none`\n\nWhether fields which are equal to `None` should be excluded from the response (defaults to `False`).\n\n\n## url_name\nAllows you to set api endpoint url name (using [django path's naming](https://docs.djangoproject.com/en/stable/topics/http/urls/#reversing-namespaced-urls))\n```python hl_lines=\"1 7\"\n@api.post(\"/tasks\", url_name='tasks')\ndef some_operation(request):\n pass\n\n# then you can get the url with\n\nreverse('api-1.0.0:tasks')\n```\n\nSee the [Reverse Resolution of URLs](../guides/urls.md) guide for more details.\n\n\n## Specifying servers\nIf you want to specify single or multiple servers for OpenAPI specification `servers` can be used when initializing NinjaAPI instance:\n```python hl_lines=\"4 5 6 7\"\nfrom ninja import NinjaAPI\n\napi = NinjaAPI(\n servers=[\n {\"url\": \"https://stag.example.com\", \"description\": \"Staging env\"},\n {\"url\": \"https://prod.example.com\", \"description\": \"Production env\"},\n ]\n)\n```\nThis will allow switching between environments when using interactive OpenAPI docs:\n\n"
},
{
"path": "docs/docs/reference/settings.md",
"content": "# Django Settings\n\n::: ninja.conf.Settings\n rendering:\n show_source: False\n show_root_toc_entry: False"
},
{
"path": "docs/docs/releases.md",
"content": "# Release Notes\n\nFollow and subscribe for new releases on GitHub:\n\n\n\n"
},
{
"path": "docs/docs/tutorial/index.md",
"content": "# Tutorial - First Steps\n\nThis tutorial shows you how to use **Django Ninja** with most of its features.\n\nThis tutorial assumes that you know at least some basics of the Django Framework , like how to create a project and run it.\n\n## Installation\n\n```console\npip install django-ninja\n```\n\n!!! note\n\n It is not required, but you can also put `ninja` to `INSTALLED_APPS`.\n In that case the OpenAPI/Swagger UI (or Redoc) will be loaded (faster) from the included JavaScript bundle (otherwise the JavaScript bundle comes from a CDN).\n\n## Create a Django project\n\nStart a new Django project (or if you already have an existing Django project, skip to the next step).\n\n```\ndjango-admin startproject myproject\n```\n\n## Create the API\n\nLet's create a module for our API. Create an `api.py` file in the same directory location as your Django project's root `urls.py`:\n\n```python\nfrom ninja import NinjaAPI\n\napi = NinjaAPI()\n```\n\nNow go to `urls.py` and add the following:\n\n```python hl_lines=\"3 7\"\nfrom django.contrib import admin\nfrom django.urls import path\nfrom .api import api\n\nurlpatterns = [\n path(\"admin/\", admin.site.urls),\n path(\"api/\", api.urls),\n]\n```\n\n## Our first operation\n\n**Django Ninja** comes with a decorator for each HTTP method (`GET`, `POST`,\n`PUT`, etc). In our `api.py` file, let's add in a simple \"hello world\"\noperation.\n\n```python hl_lines=\"5-7\"\nfrom ninja import NinjaAPI\n\napi = NinjaAPI()\n\n@api.get(\"/hello\")\ndef hello(request):\n return \"Hello world\"\n```\n\nNow browsing to localhost:8000/api/hello will return a simple JSON\nresponse:\n```json\n\"Hello world\"\n```\n\n!!! success\n\n Continue on to **[Parsing input](step2.md)**."
},
{
"path": "docs/docs/tutorial/other/crud.md",
"content": "# CRUD example\n\n\n**CRUD** - **C**reate, **R**etrieve, **U**pdate, **D**elete are the four basic functions of persistent storage.\n\nThis example will show you how to implement these functions with **Django Ninja**.\n\nLet's say you have the following Django models that you need to perform these operations on:\n\n\n```python\n\nclass Department(models.Model):\n title = models.CharField(max_length=100)\n\nclass Employee(models.Model):\n first_name = models.CharField(max_length=100)\n last_name = models.CharField(max_length=100)\n department = models.ForeignKey(Department, on_delete=models.CASCADE)\n birthdate = models.DateField(null=True, blank=True)\n cv = models.FileField(null=True, blank=True)\n```\n\nNow let's create CRUD operations for the Employee model.\n\n## Create\n\nTo create an employee lets define an INPUT schema:\n\n```python\nfrom datetime import date\nfrom ninja import Schema\n\nclass EmployeeIn(Schema):\n first_name: str\n last_name: str\n department_id: int = None\n birthdate: date = None\n\n```\n\nThis schema will be our input payload:\n\n```python hl_lines=\"2\"\n@api.post(\"/employees\")\ndef create_employee(request, payload: EmployeeIn):\n employee = Employee.objects.create(**payload.dict())\n return {\"id\": employee.id}\n```\n\n!!! tip\n `Schema` objects have `.dict()` method with all the schema attributes represented as a dict.\n\n You can pass it as `**kwargs` to the Django model's `create` method (or model `__init__`).\n\nSee the recipe below for handling the file upload (when using Django models):\n\n```python hl_lines=\"2\"\nfrom ninja import UploadedFile, File\n\n@api.post(\"/employees\")\ndef create_employee(request, payload: EmployeeIn, cv: File[UploadedFile]):\n payload_dict = payload.dict()\n employee = Employee(**payload_dict)\n employee.cv.save(cv.name, cv) # will save model instance as well\n return {\"id\": employee.id}\n```\n\nIf you just need to handle a file upload:\n\n```python hl_lines=\"2\"\nfrom django.core.files.storage import FileSystemStorage\nfrom ninja import UploadedFile, File\n\nSTORAGE = FileSystemStorage()\n\n@api.post(\"/upload\")\ndef create_upload(request, cv: File[UploadedFile]):\n filename = STORAGE.save(cv.name, cv)\n # Handle things further\n```\n\n## Retrieve\n\n### Single object\n\nNow to get employee we will define a schema that will describe what our responses will look like. Here we will basically use the same schema as `EmployeeIn`, but will add an extra attribute `id`:\n\n\n```python hl_lines=\"2\"\nclass EmployeeOut(Schema):\n id: int\n first_name: str\n last_name: str\n department_id: int = None\n birthdate: date = None\n```\n\n!!! note\n Defining response schemas are not really required, but when you do define it you will get results validation, documentation and automatic ORM objects to JSON conversions.\n\nWe will use this schema as the `response` type for our `GET` employee view:\n\n\n```python hl_lines=\"1\"\n@api.get(\"/employees/{employee_id}\", response=EmployeeOut)\ndef get_employee(request, employee_id: int):\n employee = get_object_or_404(Employee, id=employee_id)\n return employee\n```\n\nNotice that we simply returned an employee ORM object, without a need to convert it to a dict. The `response` schema does automatic result validation and conversion to JSON:\n```python hl_lines=\"4\"\n@api.get(\"/employees/{employee_id}\", response=EmployeeOut)\ndef get_employee(request, employee_id: int):\n employee = get_object_or_404(Employee, id=employee_id)\n return employee\n```\n\n### List of objects\n\nTo output a list of employees, we can reuse the same `EmployeeOut` schema. We will just set the `response` schema to a *List* of `EmployeeOut`.\n```python hl_lines=\"3\"\nfrom typing import List\n\n@api.get(\"/employees\", response=List[EmployeeOut])\ndef list_employees(request):\n qs = Employee.objects.all()\n return qs\n```\n\nAnother cool trick - notice we just returned a Django ORM queryset:\n\n```python hl_lines=\"4\"\n@api.get(\"/employees\", response=List[EmployeeOut])\ndef list_employees(request):\n qs = Employee.objects.all()\n return qs\n```\nIt automatically gets evaluated, validated and converted to a JSON list!\n\n\n\n## Update\n\nUpdate is pretty trivial. We just use the `PUT` method and also pass `employee_id`:\n\n```python hl_lines=\"1\"\n@api.put(\"/employees/{employee_id}\")\ndef update_employee(request, employee_id: int, payload: EmployeeIn):\n employee = get_object_or_404(Employee, id=employee_id)\n for attr, value in payload.dict().items():\n setattr(employee, attr, value)\n employee.save()\n return {\"success\": True}\n```\n\n**Note**\n\nHere we used the `payload.dict` method to set all object attributes:\n\n`for attr, value in payload.dict().items()`\n\nYou can also do this more explicit:\n\n```python\nemployee.first_name = payload.first_name\nemployee.last_name = payload.last_name\nemployee.department_id = payload.department_id\nemployee.birthdate = payload.birthdate\n```\n\n**Partial updates**\n\nTo allow the user to make partial updates, use `payload.dict(exclude_unset=True).items()`. This ensures that only the specified fields get updated.\n\n**Enforcing strict field validation**\n\nBy default, any provided fields that don't exist in the schema will be silently ignored. To raise an error for these invalid fields, you can set `extra = \"forbid\"` in the model_config. For example:\n\n```python hl_lines=\"5\"\nfrom pydantic import ConfigDict\nclass EmployeeIn(Schema):\n # your fields here...\n\n model_config = ConfigDict(extra=\"forbid\")\n```\n\n## Delete\n\nDelete is also pretty simple. We just get employee by `id` and delete it from the DB:\n\n\n```python hl_lines=\"1 2 4\"\n@api.delete(\"/employees/{employee_id}\")\ndef delete_employee(request, employee_id: int):\n employee = get_object_or_404(Employee, id=employee_id)\n employee.delete()\n return {\"success\": True}\n```\n\n## Final code\n\nHere's a full CRUD example:\n\n\n```python\nfrom datetime import date\nfrom typing import List\nfrom ninja import NinjaAPI, Schema\nfrom django.shortcuts import get_object_or_404\nfrom employees.models import Employee\n\n\napi = NinjaAPI()\n\n\nclass EmployeeIn(Schema):\n first_name: str\n last_name: str\n department_id: int = None\n birthdate: date = None\n\n\nclass EmployeeOut(Schema):\n id: int\n first_name: str\n last_name: str\n department_id: int = None\n birthdate: date = None\n\n\n@api.post(\"/employees\")\ndef create_employee(request, payload: EmployeeIn):\n employee = Employee.objects.create(**payload.dict())\n return {\"id\": employee.id}\n\n\n@api.get(\"/employees/{employee_id}\", response=EmployeeOut)\ndef get_employee(request, employee_id: int):\n employee = get_object_or_404(Employee, id=employee_id)\n return employee\n\n\n@api.get(\"/employees\", response=List[EmployeeOut])\ndef list_employees(request):\n qs = Employee.objects.all()\n return qs\n\n\n@api.put(\"/employees/{employee_id}\")\ndef update_employee(request, employee_id: int, payload: EmployeeIn):\n employee = get_object_or_404(Employee, id=employee_id)\n for attr, value in payload.dict().items():\n setattr(employee, attr, value)\n employee.save()\n return {\"success\": True}\n\n\n@api.delete(\"/employees/{employee_id}\")\ndef delete_employee(request, employee_id: int):\n employee = get_object_or_404(Employee, id=employee_id)\n employee.delete()\n return {\"success\": True}\n```\n"
},
{
"path": "docs/docs/tutorial/other/video.md",
"content": "# Video Tutorials\n\n## Sneaky REST APIs With Django Ninja\n\n[realpython.com/lessons/sneaky-rest-apis-with-django-ninja-overview/](https://realpython.com/lessons/sneaky-rest-apis-with-django-ninja-overview/)\n\n\n## Creating a CRUD API with Django-Ninja by BugBytes (English)\nVIDEO \n"
},
{
"path": "docs/docs/tutorial/step2.md",
"content": "# Tutorial - Parsing Input\n\n## Input from the query string\n\nLet's change our operation to accept a name from the URL's query string. To do that, just add a `name` argument to our function.\n\n```python\n@api.get(\"/hello\")\ndef hello(request, name):\n return f\"Hello {name}\"\n```\n\nWhen we provide a name argument, we get the expected (HTTP 200) response.\n\nlocalhost:8000/api/hello?name=you :\n\n```json\n\"Hello you\"\n```\n\n### Defaults\n\nNot providing the argument will return an HTTP 422 error response.\n\n*[HTTP 422]: Unprocessable Entity\n\nlocalhost:8000/api/hello :\n\n```json\n{\n \"detail\": [\n {\n \"loc\": [\"query\", \"name\"],\n \"msg\": \"field required\",\n \"type\": \"value_error.missing\"\n }\n ]\n}\n```\n\nWe can specify a default for the `name` argument in case it isn't provided:\n\n```python hl_lines=\"2\"\n@api.get(\"/hello\")\ndef hello(request, name=\"world\"):\n return f\"Hello {name}\"\n```\n\n## Input types\n\n**Django Ninja** uses standard [Python type hints](https://docs.python.org/3/library/typing.html) to format the input types. If no type is provided then a string is assumed (but it is good practice to provide type hints for all your arguments).\n\nLet's add a second operation that does some basic math with integers.\n\n```python hl_lines=\"5-7\"\n@api.get(\"/hello\")\ndef hello(request, name: str = \"world\"):\n return f\"Hello {name}\"\n\n@api.get(\"/math\")\ndef math(request, a: int, b: int):\n return {\"add\": a + b, \"multiply\": a * b}\n```\n\nlocalhost:8000/api/math?a=2&b=3 :\n\n```json\n{\n \"add\": 5,\n \"multiply\": 6\n}\n```\n\n## Input from the path\n\nYou can declare path \"parameters\" with the same syntax used by Python format-strings.\n\nAny parameters found in the path string will be passed to your function as arguments, rather than expecting them from the query string.\n\n```python hl_lines=\"1\"\n@api.get(\"/math/{a}and{b}\")\ndef math(request, a: int, b: int):\n return {\"add\": a + b, \"multiply\": a * b}\n```\n\nNow we access the math operation from localhost:8000/api/math/2and3 .\n\n\n## Input from the request body\n\nWe are going to change our `hello` operation to use HTTP `POST` instead, and take arguments from the request body.\n\nTo specify that arguments come from the body, we need to declare a Schema.\n\n*[Schema]: An extension of a Pydantic \"Model\"\n\n```python hl_lines=\"1 5-6 8-10\"\nfrom ninja import NinjaAPI, Schema\n\napi = NinjaAPI()\n\nclass HelloSchema(Schema):\n name: str = \"world\"\n\n@api.post(\"/hello\")\ndef hello(request, data: HelloSchema):\n return f\"Hello {data.name}\"\n```\n\n### Self-documenting API\n\nAccessing localhost:8000/api/hello now results in a HTTP 405 error response, since we need to POST to this URL instead.\n\n*[HTTP 405]: Method Not Allowed\n\nAn easy way to do this is to use the Swagger documentation that is automatically created for us, at default URL of \"/docs\" (appended to our API url root).\n\n1. Visit localhost:8000/api/docs to see the operations we have created\n1. Open the `/api/hello` operation\n2. Click \"Try it out\"\n3. Change the request body\n4. Click \"Execute\"\n\n!!! success\n\n Continue on to **[Handling responses](step3.md)**"
},
{
"path": "docs/docs/tutorial/step3.md",
"content": "# Tutorial - Handling Responses\n\n## Define a response Schema\n\n**Django Ninja** allows you to define the schema of your responses both for validation and documentation purposes.\n\nWe'll create a third operation that will return information about the current Django user.\n\n```python\nfrom ninja import Schema\n\nclass UserSchema(Schema):\n username: str\n is_authenticated: bool\n # Unauthenticated users don't have the following fields, so provide defaults.\n email: str = None\n first_name: str = None\n last_name: str = None\n\n@api.get(\"/me\", response=UserSchema)\ndef me(request):\n return request.user\n```\n\nThis will convert the Django `User` object into a dictionary of only the defined fields.\n\n### Multiple response types\n\nLet's return a different response if the current user is not authenticated.\n\n```python hl_lines=\"2-5 7-8 10 12-13\"\nclass UserSchema(Schema):\n username: str\n email: str\n first_name: str\n last_name: str\n\nclass Error(Schema):\n message: str\n\n@api.get(\"/me\", response={200: UserSchema, 403: Error})\ndef me(request):\n if not request.user.is_authenticated:\n return 403, {\"message\": \"Please sign in first\"}\n return request.user \n```\n\nAs you see, you can return a 2-part tuple which will be interpreted as the HTTP response code and the data.\n\n!!! success\n\n That concludes the tutorial! Check out the **Other Tutorials** or the **How-to Guides** for more information."
},
{
"path": "docs/docs/whatsnew_v1.md",
"content": "# Welcome to Django Ninja 1.0\n\n\nTo get started install latest version with\n```\npip install -U django-ninja\n```\n\ndjango-ninja v1 is compatible with Python 3.7 and above.\n\n\nDjango ninja series 0.x is still supported but will receive only security updates and critical bug fixes\n\n\n\n# What's new in Django Ninja 1.0\n\n## Support for Pydantic2\n\nPydantic version 2 is re-written in Rust and includes a lot of improvements and features like:\n\n - Safer types.\n - Better extensibility.\n - Better performance \n\nBy our tests average project can gain some 10% performance increase on average, while some edge parsing/serializing cases can give you 4x boost.\n\nOn the other hand it introduces breaking changes and pydantic 1 and 2 are not very compatible - but we tried or best to make this transition easy as possible. So if you used 'Schema' class migration to ninja v1 should be easy. Otherwise follow [pydantic migration guide](https://docs.pydantic.dev/latest/migration/)\n\n\nSome features that are made possible with pydantic2\n\n### pydantic context\n\nPydantic now supports context during validation and serialization and Django ninja passes \"request\" object during request and response work\n\n```Python hl_lines=\"6 7\"\nclass Payload(Schema):\n id: int\n name: str\n request_path: str\n\n @staticmethod\n def resolve_request_path(data, context):\n request = context[\"request\"]\n return request.get_full_path()\n\n```\n\nDuring response a \"response_code\" is also passed to context\n\n## Schema.Meta\n\nPydantic now deprecates BaseModel.Config class. But to keep things consistent with all other django parts we introduce \"Meta\" class for ModelSchema - which works in a similar way as django's ModelForms:\n\n```Python hl_lines=\"2 4\"\nclass TxItem(ModelSchema):\n class Meta:\n model = Transaction\n fields = [\"id\", \"account\", \"amount\", \"timestamp\"]\n\n```\n\n(The \"Config\" class is still supported, but deprecated)\n\n\n## Shorter / cleaner parameters syntax\n\n```python\n@api.post('/some')\ndef some_form(request, username: Form[str], password: Form[str]):\n return True\n```\n\ninstead of\n\n```python\n@api.post('/some')\ndef some_form(request, username: str = Form(...), password: str = Form(...)):\n return True\n```\n\nor \n\n```python\n@api.post('/some')\ndef some_form(request, data: Form[AuthSchema]):\n return True\n```\n\n\ninstead of\n\n```python\n@api.post('/some')\ndef some_form(request, data: AuthSchema = Form(...)):\n return True\n```\n\n\n\nwith all the autocompletion in editors\n\n\nOn the other hand the **old syntax is still supported** so you can easily port your project to a newer django-ninja version without much haste \n\n\n#### + Annotated\n\ntyping.Annotated is also supported:\n\n```Python\n@api.get(\"/annotated\")\ndef annotated(request, data: Annotated[SomeData, Form()]):\n return {\"data\": data.dict()}\n\n```\n\n\n## Async auth support\n\nThe async authenticators are finally supported. All you have to do is just add `async` to your `authenticate` method:\n\n```Python\nclass Auth(HttpBearer):\n async def authenticate(self, request, token):\n await asyncio.sleep(1)\n if token == \"secret\":\n return token\n\n```\n\n\n## Changed CSRF Behavior\n\n\n`csrf=True` requirement is no longer required if you use cookie based authentication. Instead CSRF protection is enabled automatically. This also allow you to mix csrf-protected authenticators and other methods that does not require cookies:\n\n```Python\napi = NinjaAPI(auth=[django_auth, Auth()])\n```\n\n\n## Docs\n\nDoc viewer are now configurable and plugable. By default django ninja comes with Swagger and Redoc:\n\n```Python\nfrom ninja import NinjaAPI, Redoc, Swagger\n\n\n# use redoc\napi = NinjaAPI(docs=Redoc()))\n\n# use swagger:\napi = NinjaAPI(docs=Swagger())\n\n# set configuration for swagger:\napi = NinjaAPI(docs=Swagger({\"persistAuthorization\": True}))\n```\n\nUsers now able to create custom docs viewer by inheriting `DocsBase` class\n\n## Router\n\nadd_router supports string paths:\n\n```Python\napi = NinjaAPI()\n\n\napi.add_router('/app1', 'myproject.app1.router')\napi.add_router('/app2', 'myproject.app2.router')\napi.add_router('/app3', 'myproject.app3.router')\napi.add_router('/app4', 'myproject.app4.router')\napi.add_router('/app5', 'myproject.app5.router')\n```\n\n\n## Decorators\n\nWhen django ninja decorates a view with .get/.post etc. - it wraps the result of the function (which in most cases are not HttpResponse - but some serializable object) so it's not really possible to use some built-in or 3rd-party decorators like:\n\n```python hl_lines=\"4\"\nfrom django.views.decorators.cache import cache_page\n\n@api.get(\"/test\")\n@cache_page(5) # <----- will not work\ndef test_view(request):\n return {\"some\": \"Complex data\"}\n```\nThis example does not work.\n\nNow django ninja introduces a decorator decorate_view that allows inject decorators that work with http response:\n\n```python hl_lines=\"1 4\"\nfrom ninja.decorators import decorate_view\n\n@api.get(\"/test\")\n@decorate_view(cache_page(5))\ndef test_view(request):\n return str(datetime.now())\n```\n\n\n## Paginations\n\n`paginate_queryset` method now takes `request` object\n\n\n#### Backwards incompatible stuff\n - resolve_xxx(self, ...) - support resolve with (self) is dropped in favor of pydantic build-in functionality\n - pydantic v1 is no longer supported\n - python 3.6 is no longer supported\n\nBTW - if you like this project and still did not give it a github start - please do so \n"
},
{
"path": "docs/mkdocs.yml",
"content": "site_name: Django Ninja\nsite_description: Django Ninja - Django REST framework with high performance, easy to learn, fast to code.\nsite_url: https://django-ninja.dev\nrepo_name: vitalik/django-ninja\nrepo_url: https://github.com/vitalik/django-ninja\nedit_uri: \"\"\nextra:\n analytics:\n provider: google\n property: G-0E3XZ663ZR\nextra_css:\n - extra.css\nextra_javascript:\n - javascripts/ask-ai-button.js\ntheme:\n name: material\n palette:\n - media: \"(prefers-color-scheme)\"\n primary: green\n toggle:\n icon: material/brightness-auto\n name: Switch to light mode\n - media: \"(prefers-color-scheme: light)\"\n scheme: default\n primary: green\n toggle:\n icon: material/weather-night\n name: Switch to dark mode\n - media: \"(prefers-color-scheme: dark)\" \n scheme: slate\n primary: green\n toggle:\n icon: material/weather-sunny\n name: Switch to light mode\n logo: img/docs-logo.png\n favicon: img/favicon.svg\n language: en\n features:\n - navigation.expand\n - search.highlight\n - search.suggest\n icon:\n repo: fontawesome/brands/github-alt\nnav:\n - Intro: index.md\n - motivation.md\n - Tutorial:\n - \"First Steps\": tutorial/index.md\n - \"Parsing Input\": tutorial/step2.md\n - \"Handling Responses\": tutorial/step3.md\n - Other Tutorials:\n - tutorial/other/video.md\n - tutorial/other/crud.md\n - How-to Guides:\n - Parsing input:\n - guides/input/operations.md\n - guides/input/path-params.md\n - guides/input/query-params.md\n - guides/input/body.md\n - guides/input/form-params.md\n - guides/input/file-params.md\n - guides/input/request-parsers.md\n - guides/input/filtering.md\n - Handling responses:\n - Defining a Schema: guides/response/index.md\n - guides/response/temporal_response.md\n - Generating a Schema from Django models: guides/response/django-pydantic.md\n - Generating a Schema dynamically: guides/response/django-pydantic-create-schema.md\n - guides/response/config-pydantic.md\n - guides/response/pagination.md\n - guides/response/response-renderers.md\n - Splitting your API with Routers: guides/routers.md\n - guides/decorators.md\n - guides/authentication.md\n - guides/throttling.md\n - guides/testing.md\n - guides/api-docs.md\n - guides/errors.md\n - guides/urls.md\n - guides/async-support.md\n - guides/versioning.md\n - Reference:\n - NinjaAPI class: reference/api.md\n - reference/csrf.md\n - reference/operations-parameters.md\n - reference/management-commands.md\n - reference/settings.md\n - releases.md\n - help.md\n - Enhancement Proposals:\n - Intro: proposals/index.md\n - proposals/cbv.md\n - proposals/v1.md\n - What's new in V1: whatsnew_v1.md\nmarkdown_extensions:\n - markdown_include.include\n - markdown.extensions.codehilite:\n guess_lang: false\n # Uncomment these 2 lines during development to more easily add highlights\n #- pymdownx.highlight:\n # linenums: true\n - abbr\n - codehilite\n - admonition\n - pymdownx.details\n - pymdownx.superfences\nplugins:\n - search\n - mkdocstrings:\n handlers:\n python:\n setup_commands:\n - from django.conf import settings\n - settings.configure()\n"
},
{
"path": "docs/requirements.txt",
"content": "mkdocs==1.5.3\nmkdocs-autorefs==1.0.1\nmkdocs-material==9.5.4\nmkdocs-material-extensions==1.3.1\nmarkdown-include==0.8.1\nmkdocstrings[python]==0.24.0\ngriffe==0.47.0\n"
},
{
"path": "docs/src/index001.py",
"content": "from django.contrib import admin\nfrom django.urls import path\nfrom ninja import NinjaAPI\n\napi = NinjaAPI()\n\n\n@api.get(\"/add\")\ndef add(request, a: int, b: int):\n return {\"result\": a + b}\n\n\nurlpatterns = [\n path(\"admin/\", admin.site.urls),\n path(\"api/\", api.urls),\n]\n"
},
{
"path": "docs/src/tutorial/authentication/apikey01.py",
"content": "from ninja.security import APIKeyQuery\nfrom someapp.models import Client\n\n\nclass ApiKey(APIKeyQuery):\n param_name = \"api_key\"\n\n def authenticate(self, request, key):\n try:\n return Client.objects.get(key=key)\n except Client.DoesNotExist:\n pass\n\n\napi_key = ApiKey()\n\n\n@api.get(\"/apikey\", auth=api_key)\ndef apikey(request):\n assert isinstance(request.auth, Client)\n return f\"Hello {request.auth}\"\n"
},
{
"path": "docs/src/tutorial/authentication/apikey02.py",
"content": "from ninja.security import APIKeyHeader\n\n\nclass ApiKey(APIKeyHeader):\n param_name = \"X-API-Key\"\n\n def authenticate(self, request, key):\n if key == \"supersecret\":\n return key\n\n\nheader_key = ApiKey()\n\n\n@api.get(\"/headerkey\", auth=header_key)\ndef apikey(request):\n return f\"Token = {request.auth}\"\n"
},
{
"path": "docs/src/tutorial/authentication/apikey03.py",
"content": "from ninja.security import APIKeyCookie\n\n\nclass CookieKey(APIKeyCookie):\n def authenticate(self, request, key):\n if key == \"supersecret\":\n return key\n\n\ncookie_key = CookieKey()\n\n\n@api.get(\"/cookiekey\", auth=cookie_key)\ndef apikey(request):\n return f\"Token = {request.auth}\"\n"
},
{
"path": "docs/src/tutorial/authentication/basic01.py",
"content": "from ninja.security import HttpBasicAuth\n\n\nclass BasicAuth(HttpBasicAuth):\n def authenticate(self, request, username, password):\n if username == \"admin\" and password == \"secret\":\n return username\n\n\n@api.get(\"/basic\", auth=BasicAuth())\ndef basic(request):\n return {\"httpuser\": request.auth}\n"
},
{
"path": "docs/src/tutorial/authentication/bearer01.py",
"content": "from ninja.security import HttpBearer\n\n\nclass AuthBearer(HttpBearer):\n def authenticate(self, request, token):\n if token == \"supersecret\":\n return token\n\n\n@api.get(\"/bearer\", auth=AuthBearer())\ndef bearer(request):\n return {\"token\": request.auth}\n"
},
{
"path": "docs/src/tutorial/authentication/bearer02.py",
"content": "from ninja import NinjaAPI\nfrom ninja.security import HttpBearer\n\napi = NinjaAPI()\n\nclass InvalidToken(Exception):\n pass\n\n@api.exception_handler(InvalidToken)\ndef on_invalid_token(request, exc):\n return api.create_response(request, {\"detail\": \"Invalid token supplied\"}, status=401)\n\nclass AuthBearer(HttpBearer):\n def authenticate(self, request, token):\n if token == \"supersecret\":\n return token\n raise InvalidToken\n\n\n@api.get(\"/bearer\", auth=AuthBearer())\ndef bearer(request):\n return {\"token\": request.auth}\n"
},
{
"path": "docs/src/tutorial/authentication/code001.py",
"content": "from ninja import NinjaAPI\nfrom ninja.security import django_auth\n\napi = NinjaAPI()\n\n\n@api.get(\"/pets\", auth=django_auth)\ndef pets(request):\n return f\"Authenticated user {request.auth}\"\n"
},
{
"path": "docs/src/tutorial/authentication/code002.py",
"content": "def ip_whitelist(request):\n if request.META[\"REMOTE_ADDR\"] == \"8.8.8.8\":\n return \"8.8.8.8\"\n\n\n@api.get(\"/ipwhitelist\", auth=ip_whitelist)\ndef ipwhitelist(request):\n return f\"Authenticated client, IP = {request.auth}\"\n"
},
{
"path": "docs/src/tutorial/authentication/global01.py",
"content": "from ninja import NinjaAPI, Form\nfrom ninja.security import HttpBearer\n\n\nclass GlobalAuth(HttpBearer):\n def authenticate(self, request, token):\n if token == \"supersecret\":\n return token\n\n\napi = NinjaAPI(auth=GlobalAuth())\n\n# @api.get(...)\n# def ...\n# @api.post(...)\n# def ...\n\n\n@api.post(\"/token\", auth=None) # < overriding global auth\ndef get_token(request, username: str = Form(...), password: str = Form(...)):\n if username == \"admin\" and password == \"giraffethinnknslong\":\n return {\"token\": \"supersecret\"}\n"
},
{
"path": "docs/src/tutorial/authentication/multiple01.py",
"content": "from ninja.security import APIKeyQuery, APIKeyHeader\n\n\nclass AuthCheck:\n def authenticate(self, request, key):\n if key == \"supersecret\":\n return key\n\n\nclass QueryKey(AuthCheck, APIKeyQuery):\n pass\n\n\nclass HeaderKey(AuthCheck, APIKeyHeader):\n pass\n\n\n@api.get(\"/multiple\", auth=[QueryKey(), HeaderKey()])\ndef multiple(request):\n return f\"Token = {request.auth}\"\n"
},
{
"path": "docs/src/tutorial/authentication/schema01.py",
"content": ""
},
{
"path": "docs/src/tutorial/body/code01.py",
"content": "from typing import Optional\nfrom ninja import Schema\n\n\nclass Item(Schema):\n name: str\n description: Optional[str] = None\n price: float\n quantity: int\n\n\n@api.post(\"/items\")\ndef create(request, item: Item):\n return item\n"
},
{
"path": "docs/src/tutorial/body/code02.py",
"content": "from ninja import Schema\n\n\nclass Item(Schema):\n name: str\n description: str = None\n price: float\n quantity: int\n\n\n@api.put(\"/items/{item_id}\")\ndef update(request, item_id: int, item: Item):\n return {\"item_id\": item_id, \"item\": item.dict()}\n"
},
{
"path": "docs/src/tutorial/body/code03.py",
"content": "from ninja import Schema\n\n\nclass Item(Schema):\n name: str\n description: str = None\n price: float\n quantity: int\n\n\n@api.post(\"/items/{item_id}\")\ndef update(request, item_id: int, item: Item, q: str):\n return {\"item_id\": item_id, \"item\": item.dict(), \"q\": q}\n"
},
{
"path": "docs/src/tutorial/form/code01.py",
"content": "from ninja import Form, Schema\n\n\nclass Item(Schema):\n name: str\n description: str = None\n price: float\n quantity: int\n\n\n@api.post(\"/items\")\ndef create(request, item: Form[Item]):\n return item\n"
},
{
"path": "docs/src/tutorial/form/code02.py",
"content": "from ninja import Form, Schema\n\n\nclass Item(Schema):\n name: str\n description: str = None\n price: float\n quantity: int\n\n\n@api.post(\"/items/{item_id}\")\ndef update(request, item_id: int, q: str, item: Form[Item]):\n return {\"item_id\": item_id, \"item\": item.dict(), \"q\": q}\n"
},
{
"path": "docs/src/tutorial/form/code03.py",
"content": "from ninja import Form, Schema\nfrom typing import Annotated, TypeVar\nfrom pydantic import WrapValidator\nfrom pydantic_core import PydanticUseDefault\n\n\ndef _empty_str_to_default(v, handler, info):\n if isinstance(v, str) and v == '':\n raise PydanticUseDefault\n return handler(v)\n\n\nT = TypeVar('T')\nEmptyStrToDefault = Annotated[T, WrapValidator(_empty_str_to_default)]\n\n\nclass Item(Schema):\n name: str\n description: str = None\n price: EmptyStrToDefault[float] = 0.0\n quantity: EmptyStrToDefault[int] = 0\n in_stock: EmptyStrToDefault[bool] = True\n\n\n@api.post(\"/items-blank-default\")\ndef update(request, item: Form[Item]):\n return item.dict()\n"
},
{
"path": "docs/src/tutorial/path/code01.py",
"content": "@api.get(\"/items/{item_id}\")\ndef read_item(request, item_id):\n return {\"item_id\": item_id}\n"
},
{
"path": "docs/src/tutorial/path/code010.py",
"content": "import datetime\nfrom ninja import Schema, Path\n\n\nclass PathDate(Schema):\n year: int\n month: int\n day: int\n\n def value(self):\n return datetime.date(self.year, self.month, self.day)\n\n\n@api.get(\"/events/{year}/{month}/{day}\")\ndef events(request, date: Path[PathDate]):\n return {\"date\": date.value()}\n"
},
{
"path": "docs/src/tutorial/path/code02.py",
"content": "@api.get(\"/items/{item_id}\")\ndef read_item(request, item_id: int):\n return {\"item_id\": item_id}\n"
},
{
"path": "docs/src/tutorial/query/code01.py",
"content": "weapons = [\"Ninjato\", \"Shuriken\", \"Katana\", \"Kama\", \"Kunai\", \"Naginata\", \"Yari\"]\n\n\n@api.get(\"/weapons\")\ndef list_weapons(request, limit: int = 10, offset: int = 0):\n return weapons[offset: offset + limit]\n"
},
{
"path": "docs/src/tutorial/query/code010.py",
"content": "import datetime\nfrom typing import List\n\nfrom pydantic import Field\n\nfrom ninja import Query, Schema\n\n\nclass Filters(Schema):\n limit: int = 100\n offset: int = None\n query: str = None\n category__in: List[str] = Field(None, alias=\"categories\")\n\n\n@api.get(\"/filter\")\ndef events(request, filters: Query[Filters]):\n return {\"filters\": filters.dict()}\n"
},
{
"path": "docs/src/tutorial/query/code02.py",
"content": "weapons = [\"Ninjato\", \"Shuriken\", \"Katana\", \"Kama\", \"Kunai\", \"Naginata\", \"Yari\"]\n\n\n@api.get(\"/weapons/search\")\ndef search_weapons(request, q: str, offset: int = 0):\n results = [w for w in weapons if q in w.lower()]\n return results[offset : offset + 10]\n"
},
{
"path": "docs/src/tutorial/query/code03.py",
"content": "from datetime import date\n\n\n@api.get(\"/example\")\ndef example(request, s: str = None, b: bool = None, d: date = None, i: int = None):\n return [s, b, d, i]\n"
},
{
"path": "mypy.ini",
"content": "[mypy]\npython_version = 3.12\n\nshow_column_numbers = True\nshow_error_codes = True\n\nfollow_imports = normal\nignore_missing_imports = True\n\n# Exclude directories\nexclude = ^(\\.venv|venv|env)/\n\n# be strict\ndisallow_untyped_calls = True\nwarn_return_any = True\nstrict_optional = True\nwarn_no_return = True\nwarn_redundant_casts = True\nwarn_unused_ignores = True\n\ndisallow_untyped_defs = True\ncheck_untyped_defs = True\nno_implicit_reexport = True\n\n[mypy-ninja.compatibility.*]\nignore_errors = True\n"
},
{
"path": "ninja/__init__.py",
"content": "\"\"\"Django Ninja - Fast Django REST framework\"\"\"\n\n__version__ = \"1.6.2\"\n\nfrom pydantic import Field\n\nfrom ninja.files import UploadedFile\nfrom ninja.filter_schema import FilterConfigDict, FilterLookup, FilterSchema\nfrom ninja.main import NinjaAPI\nfrom ninja.openapi.docs import Redoc, Swagger\nfrom ninja.orm import ModelSchema\nfrom ninja.params import (\n Body,\n BodyEx,\n Cookie,\n CookieEx,\n File,\n FileEx,\n Form,\n FormEx,\n Header,\n HeaderEx,\n P,\n Path,\n PathEx,\n Query,\n QueryEx,\n)\nfrom ninja.patch_dict import PatchDict\nfrom ninja.responses import Status\nfrom ninja.router import Router\nfrom ninja.schema import Schema\nfrom ninja.streaming import JSONL, SSE\n\n__all__ = [\n \"Field\",\n \"UploadedFile\",\n \"NinjaAPI\",\n \"Body\",\n \"Cookie\",\n \"File\",\n \"Form\",\n \"Header\",\n \"Path\",\n \"Query\",\n \"BodyEx\",\n \"CookieEx\",\n \"FileEx\",\n \"FormEx\",\n \"HeaderEx\",\n \"PathEx\",\n \"QueryEx\",\n \"Router\",\n \"P\",\n \"Schema\",\n \"ModelSchema\",\n \"FilterSchema\",\n \"FilterLookup\",\n \"FilterConfigDict\",\n \"Swagger\",\n \"Redoc\",\n \"PatchDict\",\n \"SSE\",\n \"JSONL\",\n \"Status\",\n]\n"
},
{
"path": "ninja/compatibility/__init__.py",
"content": ""
},
{
"path": "ninja/compatibility/files.py",
"content": "from typing import Any, List\n\nfrom asgiref.sync import iscoroutinefunction, sync_to_async\nfrom django.conf import settings\nfrom django.http import HttpRequest\nfrom django.utils.decorators import sync_and_async_middleware\n\nfrom ninja.conf import settings as ninja_settings\nfrom ninja.params.models import FileModel\n\nFIX_MIDDLEWARE_PATH: str = \"ninja.compatibility.files.fix_request_files_middleware\"\nFIX_METHODS = ninja_settings.FIX_REQUEST_FILES_METHODS\n\n\ndef need_to_fix_request_files(methods: List[str], params_models: List[Any]) -> bool:\n has_files_params = any(\n issubclass(model_class, FileModel) for model_class in params_models\n )\n method_needs_fix = bool(set(methods) & FIX_METHODS)\n middleware_installed = FIX_MIDDLEWARE_PATH in settings.MIDDLEWARE\n return has_files_params and method_needs_fix and not middleware_installed\n\n\n@sync_and_async_middleware\ndef fix_request_files_middleware(get_response: Any) -> Any:\n \"\"\"\n This middleware fixes long historical Django behavior where request.FILES is only\n populated for POST requests.\n https://code.djangoproject.com/ticket/12635\n \"\"\"\n if iscoroutinefunction(get_response):\n\n async def async_middleware(request: HttpRequest) -> Any:\n if (\n request.method in FIX_METHODS\n and request.content_type != \"application/json\"\n ):\n initial_method = request.method\n request.method = \"POST\"\n request.META[\"REQUEST_METHOD\"] = \"POST\"\n await sync_to_async(request._load_post_and_files)()\n request.META[\"REQUEST_METHOD\"] = initial_method\n request.method = initial_method\n\n return await get_response(request)\n\n return async_middleware\n else:\n\n def sync_middleware(request: HttpRequest) -> Any:\n if (\n request.method in FIX_METHODS\n and request.content_type != \"application/json\"\n ):\n initial_method = request.method\n request.method = \"POST\"\n request.META[\"REQUEST_METHOD\"] = \"POST\"\n request._load_post_and_files()\n request.META[\"REQUEST_METHOD\"] = initial_method\n request.method = initial_method\n\n return get_response(request)\n\n return sync_middleware\n"
},
{
"path": "ninja/compatibility/streaming.py",
"content": "\"\"\"Compatibility layer for async streaming responses.\n\nDjango 4.2+ supports passing async iterators to StreamingHttpResponse.\nOn older versions, async generators must be eagerly consumed into a list.\n\nTODO: When dropping Django < 4.2 support:\n 1. Remove this module entirely.\n 2. In AsyncOperation._async_stream_response (ninja/operation.py),\n pass the async content generator directly to StreamingHttpResponse\n and copy temporal_response headers lazily inside the generator:\n\n async def content_iter():\n async for chunk in content_gen:\n yield chunk\n for key, value in temporal_response.items():\n if key.lower() != \"content-type\":\n response[key] = value\n for cookie_name, cookie in temporal_response.cookies.items():\n response.cookies[cookie_name] = cookie\n\n response = StreamingHttpResponse(\n content_iter(), content_type=..., status=...,\n )\n\"\"\"\n\nfrom typing import Any, Dict\n\nimport django\nfrom django.http import HttpResponse, StreamingHttpResponse\n\nASYNC_STREAMING = django.VERSION >= (4, 2)\n\n\ndef _copy_temporal_headers(\n temporal_response: HttpResponse, response: StreamingHttpResponse\n) -> None:\n \"\"\"Copy headers and cookies from temporal response, skipping Content-Type.\"\"\"\n for key, value in temporal_response.items():\n if key.lower() != \"content-type\":\n response[key] = value\n for cookie_name, cookie in temporal_response.cookies.items():\n response.cookies[cookie_name] = cookie\n\n\nif ASYNC_STREAMING:\n\n async def create_streaming_response(\n content_gen: Any,\n *,\n content_type: str,\n status: int,\n temporal_response: HttpResponse,\n extra_headers: Dict[str, str],\n ) -> StreamingHttpResponse:\n \"\"\"Create a StreamingHttpResponse from an async content generator.\n\n Django 4.2+: passes the async generator directly and copies\n temporal response headers/cookies lazily after the generator is exhausted.\n \"\"\"\n\n async def with_lazy_headers() -> Any:\n async for chunk in content_gen:\n yield chunk\n _copy_temporal_headers(temporal_response, response)\n\n response = StreamingHttpResponse(\n with_lazy_headers(),\n content_type=content_type,\n status=status,\n )\n for key, value in extra_headers.items():\n response[key] = value\n return response\n\nelse:\n\n async def create_streaming_response(\n content_gen: Any,\n *,\n content_type: str,\n status: int,\n temporal_response: HttpResponse,\n extra_headers: Dict[str, str],\n ) -> StreamingHttpResponse:\n \"\"\"Create a StreamingHttpResponse from an async content generator.\n\n Django < 4.2: eagerly consumes the async generator into a list\n since StreamingHttpResponse does not support async iterators.\n \"\"\"\n chunks = []\n async for chunk in content_gen:\n chunks.append(chunk)\n response = StreamingHttpResponse(\n iter(chunks),\n content_type=content_type,\n status=status,\n )\n _copy_temporal_headers(temporal_response, response)\n for key, value in extra_headers.items():\n response[key] = value\n return response\n"
},
{
"path": "ninja/compatibility/util.py",
"content": "import sys\nfrom typing import Union\n\n__all__ = [\"UNION_TYPES\", \"get_annotations_from_namespace\"]\n\n\n# python3.10+ syntax of creating a union or optional type (with str | int)\n# UNION_TYPES allows to check both universes if types are a union\ntry:\n from types import UnionType\n\n UNION_TYPES = (Union, UnionType)\nexcept ImportError:\n UNION_TYPES = (Union,)\n\n\n# python3.14+ no longer puts __annotations__ in the class namespace dict\n# during metaclass __new__; instead an __annotate__ function is used (PEP 749)\nif sys.version_info >= (3, 14):\n import annotationlib\n\n def get_annotations_from_namespace(namespace: dict) -> dict:\n ann = annotationlib.get_annotate_from_class_namespace(namespace)\n if ann is not None:\n return annotationlib.call_annotate_function(\n ann, format=annotationlib.Format.VALUE\n )\n return namespace.get(\"__annotations__\", {})\n\nelse:\n\n def get_annotations_from_namespace(namespace: dict) -> dict:\n return namespace.get(\"__annotations__\", {})\n"
},
{
"path": "ninja/conf.py",
"content": "from math import inf\nfrom typing import Dict, Optional, Set, Tuple\n\nfrom django.conf import settings as django_settings\nfrom pydantic import BaseModel, ConfigDict, Field\n\n\nclass Settings(BaseModel):\n model_config = ConfigDict(from_attributes=True)\n # Pagination\n PAGINATION_CLASS: str = Field(\n \"ninja.pagination.LimitOffsetPagination\", alias=\"NINJA_PAGINATION_CLASS\"\n )\n PAGINATION_DEFAULT_ORDERING: Tuple[str, ...] = Field(\n (\"-pk\",), alias=\"NINJA_PAGINATION_DEFAULT_ORDERING\"\n )\n PAGINATION_MAX_OFFSET: int = Field(100, alias=\"NINJA_PAGINATION_MAX_OFFSET\")\n PAGINATION_PER_PAGE: int = Field(100, alias=\"NINJA_PAGINATION_PER_PAGE\")\n PAGINATION_MAX_PER_PAGE_SIZE: int = Field(100, alias=\"NINJA_MAX_PER_PAGE_SIZE\")\n PAGINATION_MAX_LIMIT: int = Field(inf, alias=\"NINJA_PAGINATION_MAX_LIMIT\") # type: ignore\n\n # Throttling\n NUM_PROXIES: Optional[int] = Field(None, alias=\"NINJA_NUM_PROXIES\")\n DEFAULT_THROTTLE_RATES: Dict[str, Optional[str]] = Field(\n {\n \"auth\": \"10000/day\",\n \"user\": \"10000/day\",\n \"anon\": \"1000/day\",\n },\n alias=\"NINJA_DEFAULT_THROTTLE_RATES\",\n )\n\n FIX_REQUEST_FILES_METHODS: Set[str] = Field(\n {\"PUT\", \"PATCH\", \"DELETE\"}, alias=\"NINJA_FIX_REQUEST_FILES_METHODS\"\n )\n\n\nsettings = Settings.model_validate(django_settings)\n\nif hasattr(django_settings, \"NINJA_DOCS_VIEW\"):\n raise Exception(\n \"NINJA_DOCS_VIEW is removed. Use NinjaAPI(docs=...) instead\"\n ) # pragma: no cover\n"
},
{
"path": "ninja/constants.py",
"content": "from typing import Any, Dict, Optional\n\n__all__ = [\"NOT_SET\"]\n\n\nclass NOT_SET_TYPE:\n def __repr__(self) -> str: # pragma: no cover\n return f\"{__name__}.{self.__class__.__name__}\"\n\n def __copy__(self) -> Any:\n return NOT_SET\n\n def __deepcopy__(self, memodict: Optional[Dict] = None) -> Any:\n return NOT_SET\n\n\nNOT_SET = NOT_SET_TYPE()\n"
},
{
"path": "ninja/decorators.py",
"content": "from functools import partial\nfrom typing import Any, Callable, Tuple\n\nfrom typing_extensions import Literal\n\nfrom ninja.operation import Operation\nfrom ninja.types import TCallable\nfrom ninja.utils import contribute_operation_callback\n\n# Type for decorator modes\nDecoratorMode = Literal[\"operation\", \"view\"]\n\n# Since @api.method decorator is applied to function\n# that is not always returns a HttpResponse object\n# there is no way to apply some standard decorators form\n# django stdlib or public plugins\n#\n# @decorate_view allows to apply any view decorator to Ninja api operation\n#\n# @api.get(\"/some\")\n# @decorate_view(cache_page(60 * 15)) # <-------\n# def some(request):\n# ...\n#\n\n\ndef decorate_view(*decorators: Callable[..., Any]) -> Callable[[TCallable], TCallable]:\n def outer_wrapper(op_func: TCallable) -> TCallable:\n if hasattr(op_func, \"_ninja_operation\"):\n # Means user used decorate_view on top of @api.method\n _apply_decorators(decorators, op_func._ninja_operation) # type: ignore\n else:\n # Means user used decorate_view after(bottom) of @api.method\n contribute_operation_callback(\n op_func, partial(_apply_decorators, decorators)\n )\n\n return op_func\n\n return outer_wrapper\n\n\ndef _apply_decorators(\n decorators: Tuple[Callable[..., Any]], operation: Operation\n) -> None:\n # Track decorators for cloning support\n if not hasattr(operation, \"_run_decorators\"):\n operation._run_decorators = [] # type: ignore\n for deco in decorators:\n operation.run = deco(operation.run) # type: ignore\n operation._run_decorators.append(deco) # type: ignore\n"
},
{
"path": "ninja/errors.py",
"content": "import logging\nimport traceback\nfrom functools import partial\nfrom typing import TYPE_CHECKING, Generic, List, Optional, TypeVar\n\nimport pydantic\nfrom django.conf import settings\nfrom django.http import Http404, HttpRequest, HttpResponse\n\nfrom ninja.types import DictStrAny\n\nif TYPE_CHECKING:\n from ninja import NinjaAPI # pragma: no cover\n from ninja.params.models import ParamModel # pragma: no cover\n\n__all__ = [\n \"ConfigError\",\n \"AuthenticationError\",\n \"AuthorizationError\",\n \"ValidationError\",\n \"HttpError\",\n \"set_default_exc_handlers\",\n]\n\n\nlogger = logging.getLogger(\"django\")\n\n\nclass ConfigError(Exception):\n pass\n\n\nTModel = TypeVar(\"TModel\", bound=\"ParamModel\")\n\n\nclass ValidationErrorContext(Generic[TModel]):\n \"\"\"\n The full context of a `pydantic.ValidationError`, including all information\n needed to produce a `ninja.errors.ValidationError`.\n \"\"\"\n\n def __init__(\n self, pydantic_validation_error: pydantic.ValidationError, model: TModel\n ):\n self.pydantic_validation_error = pydantic_validation_error\n self.model = model\n\n\nclass ValidationError(Exception):\n \"\"\"\n This exception raised when operation params do not validate\n Note: this is not the same as pydantic.ValidationError\n the errors attribute as well holds the location of the error(body, form, query, etc.)\n \"\"\"\n\n def __init__(self, errors: List[DictStrAny]) -> None:\n self.errors = errors\n super().__init__(errors)\n\n\nclass HttpError(Exception):\n def __init__(self, status_code: int, message: str) -> None:\n self.status_code = status_code\n self.message = message\n super().__init__(status_code, message)\n\n def __str__(self) -> str:\n return self.message\n\n\nclass AuthenticationError(HttpError):\n def __init__(self, status_code: int = 401, message: str = \"Unauthorized\") -> None:\n super().__init__(status_code=status_code, message=message)\n\n\nclass AuthorizationError(HttpError):\n def __init__(self, status_code: int = 403, message: str = \"Forbidden\") -> None:\n super().__init__(status_code=status_code, message=message)\n\n\nclass Throttled(HttpError):\n def __init__(self, wait: Optional[int]) -> None:\n self.wait = wait\n super().__init__(status_code=429, message=\"Too many requests.\")\n\n\ndef set_default_exc_handlers(api: \"NinjaAPI\") -> None:\n api.add_exception_handler(\n Exception,\n partial(_default_exception, api=api),\n )\n api.add_exception_handler(\n Http404,\n partial(_default_404, api=api),\n )\n api.add_exception_handler(\n HttpError,\n partial(_default_http_error, api=api),\n )\n api.add_exception_handler(\n ValidationError,\n partial(_default_validation_error, api=api),\n )\n\n\ndef _default_404(request: HttpRequest, exc: Exception, api: \"NinjaAPI\") -> HttpResponse:\n msg = \"Not Found\"\n if settings.DEBUG:\n msg += f\": {exc}\"\n return api.create_response(request, {\"detail\": msg}, status=404)\n\n\ndef _default_http_error(\n request: HttpRequest, exc: HttpError, api: \"NinjaAPI\"\n) -> HttpResponse:\n return api.create_response(request, {\"detail\": str(exc)}, status=exc.status_code)\n\n\ndef _default_validation_error(\n request: HttpRequest, exc: ValidationError, api: \"NinjaAPI\"\n) -> HttpResponse:\n return api.create_response(request, {\"detail\": exc.errors}, status=422)\n\n\ndef _default_exception(\n request: HttpRequest, exc: Exception, api: \"NinjaAPI\"\n) -> HttpResponse:\n if not settings.DEBUG:\n raise exc # let django deal with it\n\n logger.exception(exc)\n tb = traceback.format_exc()\n return HttpResponse(tb, status=500, content_type=\"text/plain\")\n"
},
{
"path": "ninja/files.py",
"content": "from typing import Any, Callable, Dict\n\nfrom django.core.files.uploadedfile import UploadedFile as DjangoUploadedFile\nfrom pydantic_core import core_schema\n\n__all__ = [\"UploadedFile\"]\n\n\nclass UploadedFile(DjangoUploadedFile):\n @classmethod\n def __get_pydantic_json_schema__(\n cls, core_schema: Any, handler: Callable[..., Any]\n ) -> Dict:\n # calling handler(core_schema) here raises an exception\n json_schema: Dict[str, str] = {}\n json_schema.update(type=\"string\", format=\"binary\")\n return json_schema\n\n @classmethod\n def _validate(cls, v: Any, _: Any) -> Any:\n if not isinstance(v, DjangoUploadedFile):\n raise ValueError(f\"Expected UploadFile, received: {type(v)}\")\n return v\n\n @classmethod\n def __get_pydantic_core_schema__(\n cls, source: Any, handler: Callable[..., Any]\n ) -> Any:\n return core_schema.with_info_plain_validator_function(cls._validate)\n"
},
{
"path": "ninja/filter_schema.py",
"content": "import warnings\nfrom typing import Any, List, Optional, TypeVar, Union, cast\n\nfrom django.core.exceptions import ImproperlyConfigured\nfrom django.db.models import Q, QuerySet\nfrom pydantic import ConfigDict\nfrom pydantic.fields import FieldInfo\nfrom typing_extensions import Literal\n\nfrom .constants import NOT_SET\nfrom .schema import Schema\n\n# XOR is available only in Django 4.1+: https://docs.djangoproject.com/en/4.1/ref/models/querysets/#xor\nExpressionConnector = Literal[\"AND\", \"OR\", \"XOR\"]\n\nDEFAULT_IGNORE_NONE: bool = True\nDEFAULT_CLASS_LEVEL_EXPRESSION_CONNECTOR: ExpressionConnector = \"AND\"\nDEFAULT_FIELD_LEVEL_EXPRESSION_CONNECTOR: ExpressionConnector = \"OR\"\n\n\nclass FilterLookup:\n \"\"\"\n Annotation class for specifying database query lookups in FilterSchema fields.\n\n Example usage:\n class MyFilterSchema(FilterSchema):\n name: Annotated[Union[str, None], FilterLookup(\"name__icontains\")] = None\n search: Annotated[Union[str, None], FilterLookup([\"name__icontains\", \"email__icontains\"])] = None\n \"\"\"\n\n def __init__(\n self,\n q: Union[str, List[str], None],\n *,\n expression_connector: ExpressionConnector = DEFAULT_FIELD_LEVEL_EXPRESSION_CONNECTOR,\n ignore_none: bool = DEFAULT_IGNORE_NONE,\n ):\n \"\"\"\n Args:\n q: Database lookup expression(s). Can be:\n - A string like \"name__icontains\"\n - A list of strings like [\"name__icontains\", \"email__icontains\"]\n - Use \"__\" prefix for implicit field name: \"__icontains\" becomes \"fieldname__icontains\"\n expression_connector: How to combine multiple field-level expressions (\"OR\", \"AND\", \"XOR\"). Default is \"OR\".\n ignore_none: Whether to ignore None values for this field specifically. Default is True.\n \"\"\"\n self.q = q\n self.expression_connector = expression_connector\n self.ignore_none = ignore_none\n\n\nT = TypeVar(\"T\", bound=QuerySet)\n\n\nclass FilterConfigDict(ConfigDict, total=False):\n ignore_none: bool\n expression_connector: ExpressionConnector\n\n\nclass FilterSchema(Schema):\n model_config = FilterConfigDict(\n ignore_none=DEFAULT_IGNORE_NONE,\n expression_connector=DEFAULT_CLASS_LEVEL_EXPRESSION_CONNECTOR,\n )\n\n def custom_expression(self) -> Q:\n \"\"\"\n Implement this method to return a combination of filters that will be used\n \"\"\"\n raise NotImplementedError\n\n def get_filter_expression(self) -> Q:\n \"\"\"\n Returns a Q expression based on the current filters\n \"\"\"\n try:\n return self.custom_expression()\n except NotImplementedError:\n return self._connect_fields()\n\n def filter(self, queryset: T) -> T:\n return queryset.filter(self.get_filter_expression())\n\n def _get_filter_lookup(\n self, field_name: str, field_info: FieldInfo\n ) -> Optional[FilterLookup]:\n if not hasattr(field_info, \"metadata\") or not field_info.metadata:\n return None\n\n filter_lookups = [\n metadata_item\n for metadata_item in field_info.metadata\n if isinstance(metadata_item, FilterLookup)\n ]\n\n if len(filter_lookups) == 0:\n return None\n elif len(filter_lookups) == 1:\n return filter_lookups[0]\n else:\n raise ImproperlyConfigured(\n f\"Multiple FilterLookup instances found in metadata of {self.__class__.__name__}.{field_name}.\\n\"\n f\"Use at most one FilterLookup instance per field.\\n\"\n f\"If you need multiple lookups, specify them as a list in a single FilterLookup:\\n\"\n f\"{field_name}: Annotated[{field_info.annotation}, FilterLookup(['lookup1', 'lookup2', ...])]\"\n )\n\n def _get_field_q_expression(\n self,\n field_name: str,\n field_info: FieldInfo,\n ) -> Union[str, List[str], None]:\n filter_lookup = self._get_filter_lookup(field_name, field_info)\n if filter_lookup:\n return filter_lookup.q\n\n # Legacy approach, consider removing in future versions\n return cast(\n Union[str, List[str], None],\n self._get_from_deprecated_field_extra(field_name, field_info, \"q\"),\n )\n\n def _get_field_expression_connector(\n self,\n field_name: str,\n field_info: FieldInfo,\n ) -> Union[ExpressionConnector, None]:\n filter_lookup = self._get_filter_lookup(field_name, field_info)\n if filter_lookup:\n return filter_lookup.expression_connector\n\n # Legacy approach, consider removing in future versions\n return cast(\n Union[ExpressionConnector, None],\n self._get_from_deprecated_field_extra(\n field_name, field_info, \"expression_connector\"\n ),\n )\n\n def _get_field_ignore_none(\n self, field_name: str, field_info: FieldInfo\n ) -> Union[bool, None]:\n filter_lookup = self._get_filter_lookup(field_name, field_info)\n if filter_lookup:\n return filter_lookup.ignore_none\n\n # Legacy approach, consider removing in future versions\n return cast(\n Union[bool, None],\n self._get_from_deprecated_field_extra(\n field_name, field_info, \"ignore_none\"\n ),\n )\n\n def _resolve_field_expression(\n self, field_name: str, field_value: Any, field_info: FieldInfo\n ) -> Q:\n func = getattr(self, f\"filter_{field_name}\", None)\n if callable(func):\n return cast(Q, func(field_value))\n\n q_expression = self._get_field_q_expression(field_name, field_info)\n expression_connector = (\n self._get_field_expression_connector(field_name, field_info)\n or DEFAULT_FIELD_LEVEL_EXPRESSION_CONNECTOR\n )\n\n if not q_expression:\n return Q(**{field_name: field_value})\n elif isinstance(q_expression, str):\n if q_expression.startswith(\"__\"):\n q_expression = f\"{field_name}{q_expression}\"\n return Q(**{q_expression: field_value})\n elif isinstance(q_expression, list) and all(\n isinstance(item, str) for item in q_expression\n ):\n q = Q()\n for q_expression_part in q_expression:\n if q_expression_part.startswith(\"__\"):\n q_expression_part = f\"{field_name}{q_expression_part}\"\n q = q._combine( # type: ignore[attr-defined]\n Q(**{q_expression_part: field_value}),\n expression_connector,\n )\n return q\n else:\n raise ImproperlyConfigured(\n f\"Field {field_name} of {self.__class__.__name__} defines an invalid value for 'q'.\\n\"\n f\"Use FilterLookup annotation: {field_name}: Annotated[{field_info.annotation}, FilterLookup('lookup')]\\n\"\n f\"Alternatively, you can implement {self.__class__.__name__}.filter_{field_name} that must return a Q expression for that field\"\n )\n\n def _connect_fields(self) -> Q:\n q = Q()\n class_ignore_none = self.model_config.get(\"ignore_none\", DEFAULT_IGNORE_NONE)\n for field_name, field_info in self.__class__.model_fields.items():\n filter_value = getattr(self, field_name)\n\n # class-level ignore_none set to False (non-default) takes precedence over field-level ignore_none\n if class_ignore_none is False:\n ignore_none = False\n else:\n field_ignore_none = self._get_field_ignore_none(field_name, field_info)\n if field_ignore_none is not None:\n ignore_none = field_ignore_none\n else:\n ignore_none = DEFAULT_IGNORE_NONE\n\n # Resolve Q expression for a field even if we skip it due to None value\n # So that improperly configured fields are easier to detect\n field_q = self._resolve_field_expression(\n field_name, filter_value, field_info\n )\n if filter_value is None and ignore_none:\n continue\n q = q._combine( # type: ignore[attr-defined]\n field_q,\n self.model_config.get(\n \"expression_connector\", DEFAULT_CLASS_LEVEL_EXPRESSION_CONNECTOR\n ),\n )\n\n return q\n\n def _get_from_deprecated_field_extra(\n self, field_name: str, field_info: FieldInfo, attr: str\n ) -> Union[Any, None]:\n \"\"\"\n Backward-compatible shim which looks up filtering parameters in the Field's **extra kwargs.\n Consider removing this method in favor of FilterLookup annotation class.\n \"\"\"\n field_extra = cast(dict, field_info.json_schema_extra) or {}\n value = field_extra.get(attr, NOT_SET)\n\n if value is not NOT_SET:\n warnings.warn(\n f\"Using Pydantic Field with extra keyword arguments ('{attr}') \"\n f\"in field {self.__class__.__name__}.{field_name} is deprecated. Please use ninja.FilterLookup instead:\\n\"\n f\" from typing import Annotated\\n\"\n f\" from ninja import FilterLookup, FilterSchema\\n\\n\"\n f\" class {self.__class__.__name__}(FilterSchema):\\n\"\n f\" {field_name}: Annotated[Optional[...], FilterLookup(q='...', ...)] = None\",\n DeprecationWarning,\n stacklevel=4,\n )\n return value\n return None\n"
},
{
"path": "ninja/main.py",
"content": "from typing import (\n TYPE_CHECKING,\n Any,\n Callable,\n Dict,\n List,\n Optional,\n Sequence,\n Tuple,\n Type,\n TypeVar,\n Union,\n)\n\nfrom django.http import HttpRequest, HttpResponse\nfrom django.urls import URLPattern, URLResolver, reverse\nfrom django.utils.module_loading import import_string\n\nfrom ninja.constants import NOT_SET, NOT_SET_TYPE\nfrom ninja.decorators import DecoratorMode\nfrom ninja.errors import (\n ConfigError,\n ValidationError,\n ValidationErrorContext,\n set_default_exc_handlers,\n)\nfrom ninja.openapi import get_schema\nfrom ninja.openapi.docs import DocsBase, Swagger\nfrom ninja.openapi.schema import OpenAPISchema\nfrom ninja.openapi.urls import get_openapi_urls, get_root_url\nfrom ninja.parser import Parser\nfrom ninja.renderers import BaseRenderer, JSONRenderer\nfrom ninja.router import BoundRouter, Router, RouterMount\nfrom ninja.throttling import BaseThrottle\nfrom ninja.types import DictStrAny, TCallable\n\nif TYPE_CHECKING:\n from .operation import Operation # pragma: no cover\n\n__all__ = [\"NinjaAPI\"]\n\n_E = TypeVar(\"_E\", bound=Exception)\nExc = Union[_E, Type[_E]]\nExcHandler = Callable[[HttpRequest, Exc[_E]], HttpResponse]\n\n\nclass NinjaAPI:\n \"\"\"\n Ninja API\n \"\"\"\n\n def __init__(\n self,\n *,\n title: str = \"NinjaAPI\",\n version: str = \"1.0.0\",\n description: str = \"\",\n openapi_url: Optional[str] = \"/openapi.json\",\n docs: DocsBase = Swagger(),\n docs_url: Optional[str] = \"/docs\",\n docs_decorator: Optional[Callable[[TCallable], TCallable]] = None,\n servers: Optional[List[DictStrAny]] = None,\n urls_namespace: Optional[str] = None,\n auth: Optional[Union[Sequence[Callable], Callable, NOT_SET_TYPE]] = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n renderer: Optional[BaseRenderer] = None,\n parser: Optional[Parser] = None,\n default_router: Optional[Router] = None,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ):\n \"\"\"\n Args:\n title: A title for the api.\n description: A description for the api.\n version: The API version.\n urls_namespace: The Django URL namespace for the API. If not provided, the namespace will be ``\"api-\" + self.version``.\n openapi_url: The relative URL to serve the openAPI spec.\n openapi_extra: Additional attributes for the openAPI spec.\n docs_url: The relative URL to serve the API docs.\n servers: List of target hosts used in openAPI spec.\n auth (Callable | Sequence[Callable] | NOT_SET | None): Authentication class\n renderer: Default response renderer\n parser: Default request parser\n \"\"\"\n self.title = title\n self.version = version\n self.description = description\n self.openapi_url = openapi_url\n self.docs = docs\n self.docs_url = docs_url\n self.docs_decorator = docs_decorator\n self.servers = servers or []\n self.urls_namespace = urls_namespace or f\"api-{self.version}\"\n self.renderer = renderer or JSONRenderer()\n self.parser = parser or Parser()\n self.openapi_extra = openapi_extra or {}\n\n self._exception_handlers: Dict[Exc, ExcHandler] = {}\n self.set_default_exception_handlers()\n\n self.auth: Optional[Union[Sequence[Callable], NOT_SET_TYPE]]\n\n if callable(auth):\n self.auth = [auth]\n else:\n self.auth = auth\n\n self.throttle = throttle\n\n # Top-level router registrations (new architecture)\n # Stores (prefix, router, auth, throttle, tags, url_name_prefix) for each add_router call\n self._router_registrations: List[\n Tuple[str, Router, Any, Any, Optional[List[str]], Optional[str]]\n ] = []\n self._bound_routers_cache: Optional[List[BoundRouter]] = None\n\n # Backward compat: keep _routers list populated\n self._routers: List[Tuple[str, Router]] = []\n\n self.default_router = default_router or Router()\n self.add_router(\"\", self.default_router)\n\n def get(\n self,\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n \"\"\"\n `GET` operation. See operations\n parameters reference.\n \"\"\"\n return self.default_router.get(\n path,\n auth=auth is NOT_SET and self.auth or auth,\n throttle=throttle is NOT_SET and self.throttle or throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def post(\n self,\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n \"\"\"\n `POST` operation. See operations\n parameters reference.\n \"\"\"\n return self.default_router.post(\n path,\n auth=auth is NOT_SET and self.auth or auth,\n throttle=throttle is NOT_SET and self.throttle or throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def delete(\n self,\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n \"\"\"\n `DELETE` operation. See operations\n parameters reference.\n \"\"\"\n return self.default_router.delete(\n path,\n auth=auth is NOT_SET and self.auth or auth,\n throttle=throttle is NOT_SET and self.throttle or throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def patch(\n self,\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n \"\"\"\n `PATCH` operation. See operations\n parameters reference.\n \"\"\"\n return self.default_router.patch(\n path,\n auth=auth is NOT_SET and self.auth or auth,\n throttle=throttle is NOT_SET and self.throttle or throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def put(\n self,\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n \"\"\"\n `PUT` operation. See operations\n parameters reference.\n \"\"\"\n return self.default_router.put(\n path,\n auth=auth is NOT_SET and self.auth or auth,\n throttle=throttle is NOT_SET and self.throttle or throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def api_operation(\n self,\n methods: List[str],\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n return self.default_router.api_operation(\n methods,\n path,\n auth=auth is NOT_SET and self.auth or auth,\n throttle=throttle is NOT_SET and self.throttle or throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def add_decorator(\n self,\n decorator: Callable,\n mode: DecoratorMode = \"operation\",\n ) -> None:\n \"\"\"\n Add a decorator to be applied to all operations in the entire API.\n\n Args:\n decorator: The decorator function to apply\n mode: \"operation\" (default) applies after validation,\n \"view\" applies before validation\n \"\"\"\n # Store decorator on default router - will be inherited by all routers during build\n self.default_router.add_decorator(decorator, mode)\n\n def add_router(\n self,\n prefix: str,\n router: Union[Router, str],\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n tags: Optional[List[str]] = None,\n url_name_prefix: Optional[str] = None,\n parent_router: Optional[Router] = None,\n ) -> None:\n \"\"\"\n Add a router to this API.\n\n Args:\n prefix: URL prefix for all routes in the router\n router: Router instance or import path string\n auth: Authentication override for this router\n throttle: Throttle override for this router\n tags: Tags override for this router\n url_name_prefix: Prefix for URL names (required when mounting same router multiple times)\n parent_router: Internal use - parent router for nested routers\n \"\"\"\n # Prevent adding routers after URLs have been generated\n if self._bound_routers_cache is not None:\n raise ConfigError(\n \"Cannot add routers after URLs have been generated. \"\n \"Add all routers before accessing api.urls\"\n )\n\n if isinstance(router, str):\n router = import_string(router)\n assert isinstance(router, Router)\n\n # Check for duplicate router template - require url_name_prefix\n existing_templates = {reg[1] for reg in self._router_registrations}\n if router in existing_templates and url_name_prefix is None:\n raise ConfigError(\n \"Router is already mounted to this API. When mounting the same router \"\n \"multiple times, you must provide unique url_name_prefix for each mount.\"\n )\n\n # Store registration for later processing during URL generation\n # This allows child routers to be added after add_router() is called\n self._router_registrations.append((\n prefix,\n router,\n auth,\n throttle,\n tags,\n url_name_prefix,\n ))\n\n # Backward compat: keep _routers list updated (just the top-level router)\n self._routers.append((prefix, router))\n\n @property\n def urls(self) -> Tuple[List[Union[URLResolver, URLPattern]], str, str]:\n \"\"\"\n str: URL configuration\n\n Returns:\n\n Django URL configuration\n \"\"\"\n self._validate()\n return (\n self._get_urls(),\n \"ninja\",\n self.urls_namespace.split(\":\")[-1],\n # ^ if api included into nested urls, we only care about last bit here\n )\n\n def _get_bound_routers(self) -> List[BoundRouter]:\n \"\"\"Get or create bound router instances.\"\"\"\n if self._bound_routers_cache is None:\n # Build mounts from registrations (delayed to capture all child routers)\n all_mounts: List[RouterMount] = []\n\n for (\n prefix,\n router,\n auth,\n throttle,\n tags,\n url_name_prefix,\n ) in self._router_registrations:\n # Get API-level decorators from default router\n api_decorators = (\n self.default_router._decorators\n if router is not self.default_router\n else []\n )\n\n # Build mount configurations (non-mutating)\n # Pass auth/throttle/tags so they can be inherited by children\n mounts = router.build_routers(\n prefix,\n api_decorators,\n inherited_auth=auth,\n inherited_throttle=throttle,\n inherited_tags=tags,\n )\n\n # Apply mount-level overrides to the first (parent) mount\n # build_routers() always returns at least one mount (the router itself)\n first_mount = mounts[0]\n if auth is not NOT_SET:\n first_mount.auth = auth\n if throttle is not NOT_SET:\n first_mount.throttle = throttle\n if tags is not None:\n first_mount.tags = tags\n\n # Apply url_name_prefix to all mounts\n if url_name_prefix is not None:\n for mount in mounts:\n mount.url_name_prefix = url_name_prefix\n\n all_mounts.extend(mounts)\n\n # Create bound routers from mounts\n self._bound_routers_cache = [\n BoundRouter(mount, self) for mount in all_mounts\n ]\n\n # Freeze all templates after binding\n for mount in all_mounts:\n mount.template._freeze()\n\n # Update _routers for backward compat (include all nested routers)\n self._routers = [(m.prefix, m.template) for m in all_mounts]\n\n return self._bound_routers_cache\n\n def _get_urls(self) -> List[Union[URLResolver, URLPattern]]:\n result = get_openapi_urls(self)\n\n for bound_router in self._get_bound_routers():\n result.extend(bound_router.urls_paths(bound_router.prefix))\n\n result.append(get_root_url(self))\n return result\n\n def get_root_path(self, path_params: DictStrAny) -> str:\n name = f\"{self.urls_namespace}:api-root\"\n return reverse(name, kwargs=path_params)\n\n def create_response(\n self,\n request: HttpRequest,\n data: Any,\n *,\n status: Optional[int] = None,\n temporal_response: Optional[HttpResponse] = None,\n ) -> HttpResponse:\n if temporal_response:\n status = temporal_response.status_code\n assert status\n\n content = self.renderer.render(request, data, response_status=status)\n\n if temporal_response:\n response = temporal_response\n response.content = content\n else:\n response = HttpResponse(\n content, status=status, content_type=self.get_content_type()\n )\n\n return response\n\n def create_temporal_response(self, request: HttpRequest) -> HttpResponse:\n return HttpResponse(\"\", content_type=self.get_content_type())\n\n def get_content_type(self) -> str:\n return f\"{self.renderer.media_type}; charset={self.renderer.charset}\"\n\n def get_openapi_schema(\n self,\n *,\n path_prefix: Optional[str] = None,\n path_params: Optional[DictStrAny] = None,\n ) -> OpenAPISchema:\n if path_prefix is None:\n path_prefix = self.get_root_path(path_params or {})\n return get_schema(api=self, path_prefix=path_prefix)\n\n def get_openapi_operation_id(self, operation: \"Operation\") -> str:\n name = operation.view_func.__name__\n module = operation.view_func.__module__\n return (module + \"_\" + name).replace(\".\", \"_\")\n\n def get_operation_url_name(self, operation: \"Operation\", router: Router) -> str:\n \"\"\"\n Get the default URL name to use for an operation if it wasn't\n explicitly provided.\n \"\"\"\n return operation.view_func.__name__\n\n def add_exception_handler(\n self, exc_class: Type[_E], handler: ExcHandler[_E]\n ) -> None:\n assert issubclass(exc_class, Exception)\n self._exception_handlers[exc_class] = handler\n\n def exception_handler(\n self, exc_class: Type[Exception]\n ) -> Callable[[TCallable], TCallable]:\n def decorator(func: TCallable) -> TCallable:\n self.add_exception_handler(exc_class, func)\n return func\n\n return decorator\n\n def set_default_exception_handlers(self) -> None:\n set_default_exc_handlers(self)\n\n def on_exception(self, request: HttpRequest, exc: Exc[_E]) -> HttpResponse:\n handler = self._lookup_exception_handler(exc)\n if handler is None:\n raise exc\n return handler(request, exc)\n\n def validation_error_from_error_contexts(\n self, error_contexts: List[ValidationErrorContext]\n ) -> ValidationError:\n errors: List[Dict[str, Any]] = []\n for context in error_contexts:\n model = context.model\n e = context.pydantic_validation_error\n for i in e.errors(include_url=False):\n i[\"loc\"] = (\n model.__ninja_param_source__,\n ) + model.__ninja_flatten_map_reverse__.get(i[\"loc\"], i[\"loc\"])\n # removing pydantic hints\n del i[\"input\"] # type: ignore\n if (\n \"ctx\" in i\n and \"error\" in i[\"ctx\"]\n and isinstance(i[\"ctx\"][\"error\"], Exception)\n ):\n i[\"ctx\"][\"error\"] = str(i[\"ctx\"][\"error\"])\n errors.append(dict(i))\n return ValidationError(errors)\n\n def _lookup_exception_handler(self, exc: Exc[_E]) -> Optional[ExcHandler[_E]]:\n for cls in type(exc).__mro__:\n if cls in self._exception_handlers:\n return self._exception_handlers[cls]\n\n return None\n\n def _validate(self) -> None:\n # Registry check no longer needed - routers are independent templates\n # and can be reused across multiple APIs without conflicts\n pass\n"
},
{
"path": "ninja/management/__init__.py",
"content": ""
},
{
"path": "ninja/management/commands/__init__.py",
"content": ""
},
{
"path": "ninja/management/commands/export_openapi_schema.py",
"content": "import json\nfrom pathlib import Path\nfrom typing import Any, Optional\n\nfrom django.core.management.base import BaseCommand, CommandError, CommandParser\nfrom django.urls.base import resolve\nfrom django.utils.module_loading import import_string\n\nfrom ninja.main import NinjaAPI\nfrom ninja.management.utils import command_docstring\nfrom ninja.responses import NinjaJSONEncoder\n\n\nclass Command(BaseCommand):\n \"\"\"\n Example:\n\n ```terminal\n python manage.py export_openapi_schema\n ```\n\n ```terminal\n python manage.py export_openapi_schema --api project.urls.api\n ```\n \"\"\"\n\n help = \"Exports Open API schema\"\n\n def _get_api_instance(self, api_path: Optional[str] = None) -> NinjaAPI:\n if not api_path:\n try:\n return resolve(\"/api/\").func.keywords[\"api\"] # type: ignore\n except AttributeError:\n raise CommandError(\n \"No NinjaAPI instance found; please specify one with --api\"\n ) from None\n\n try:\n api = import_string(api_path)\n except ImportError:\n raise CommandError(\n f\"Module or attribute for {api_path} not found!\"\n ) from None\n\n if not isinstance(api, NinjaAPI):\n raise CommandError(f\"{api_path} is not instance of NinjaAPI!\")\n\n return api\n\n def add_arguments(self, parser: CommandParser) -> None:\n parser.add_argument(\n \"--api\",\n dest=\"api\",\n default=None,\n type=str,\n help=\"Specify api instance module\",\n )\n parser.add_argument(\n \"--output\",\n dest=\"output\",\n default=None,\n type=str,\n help=\"Output schema to a file (outputs to stdout if omitted).\",\n )\n parser.add_argument(\n \"--indent\", dest=\"indent\", default=None, type=int, help=\"JSON indent\"\n )\n parser.add_argument(\n \"--sorted\",\n dest=\"sort_keys\",\n default=False,\n action=\"store_true\",\n help=\"Sort Json keys\",\n )\n parser.add_argument(\n \"--ensure-ascii\",\n dest=\"ensure_ascii\",\n default=False,\n action=\"store_true\",\n help=\"ensure_ascii for JSON output\",\n )\n\n def handle(self, *args: Any, **options: Any) -> None:\n api = self._get_api_instance(options[\"api\"])\n schema = api.get_openapi_schema()\n result = json.dumps(\n schema,\n cls=NinjaJSONEncoder,\n indent=options[\"indent\"],\n sort_keys=options[\"sort_keys\"],\n ensure_ascii=options[\"ensure_ascii\"],\n )\n\n if options[\"output\"]:\n with Path(options[\"output\"]).open(\"wb\") as f:\n f.write(result.encode())\n else:\n self.stdout.write(result)\n\n\n__doc__ = command_docstring(Command)\n"
},
{
"path": "ninja/management/utils.py",
"content": "import textwrap\nfrom typing import Type\n\nfrom django.core.management.base import BaseCommand\n\n\ndef command_docstring(cmd: Type[BaseCommand]) -> str:\n base_args = []\n if cmd is not BaseCommand: # pragma: no branch\n base_parser = cmd().create_parser(\"base\", \"\")\n for group in base_parser._action_groups:\n for action in group._group_actions:\n base_args.append(\",\".join(action.option_strings))\n parser = cmd().create_parser(\"command\", \"\")\n doc = parser.description or \"\"\n\n if cmd.__doc__: # pragma: no branch\n if doc: # pragma: no branch\n doc += \"\\n\\n\"\n doc += textwrap.dedent(cmd.__doc__)\n args = []\n for group in parser._action_groups:\n for action in group._group_actions:\n if \"--help\" in action.option_strings:\n continue\n name = \",\".join(action.option_strings)\n action_type = action.type\n if not action_type and action.nargs != 0:\n action_type = str\n if action_type:\n if isinstance(action_type, type): # pragma: no branch\n action_type = action_type.__name__\n name += f\" ({action_type})\"\n help = action.help or \"\"\n if help and not action.required and action.nargs != 0:\n if not help.endswith(\".\"):\n help += \".\"\n if action.default is not None:\n help += f\" Defaults to {action.default}.\"\n else:\n help += \" Optional.\"\n args.append((name, help))\n # Sort args from this class first, then base args.\n args.sort(key=lambda o: (o[0] in base_args, o[0]))\n if args: # pragma: no branch\n doc += \"\\n\\nAttributes:\"\n for name, description in args:\n doc += f\"\\n {name}: {description}\"\n return doc\n"
},
{
"path": "ninja/openapi/__init__.py",
"content": "from ninja.openapi.schema import get_schema\n\n__all__ = [\"get_schema\"]\n"
},
{
"path": "ninja/openapi/docs.py",
"content": "import json\nfrom abc import ABC, abstractmethod\nfrom pathlib import Path\nfrom typing import TYPE_CHECKING, Any, Optional\n\nfrom django.conf import settings\nfrom django.http import HttpRequest, HttpResponse\nfrom django.shortcuts import render\nfrom django.urls import reverse\n\nfrom ninja.constants import NOT_SET\nfrom ninja.types import DictStrAny\n\nif TYPE_CHECKING:\n # if anyone knows a cleaner way to make mypy happy - welcome\n from ninja import NinjaAPI # pragma: no cover\n\nABS_TPL_PATH = Path(__file__).parent.parent / \"templates/ninja/\"\n\n\nclass DocsBase(ABC):\n @abstractmethod\n def render_page(\n self, request: HttpRequest, api: \"NinjaAPI\", **kwargs: Any\n ) -> HttpResponse:\n pass # pragma: no cover\n\n def get_openapi_url(self, api: \"NinjaAPI\", path_params: DictStrAny) -> str:\n return reverse(f\"{api.urls_namespace}:openapi-json\", kwargs=path_params)\n\n\nclass Swagger(DocsBase):\n template = \"ninja/swagger.html\"\n template_cdn = str(ABS_TPL_PATH / \"swagger_cdn.html\")\n default_settings = {\n \"layout\": \"BaseLayout\",\n \"deepLinking\": True,\n }\n\n def __init__(self, settings: Optional[DictStrAny] = None):\n self.settings = {}\n self.settings.update(self.default_settings)\n if settings:\n self.settings.update(settings)\n\n def render_page(\n self, request: HttpRequest, api: \"NinjaAPI\", **kwargs: Any\n ) -> HttpResponse:\n self.settings[\"url\"] = self.get_openapi_url(api, kwargs)\n context = {\n \"swagger_settings\": json.dumps(self.settings, indent=1),\n \"api\": api,\n \"add_csrf\": _csrf_needed(api),\n }\n return render_template(request, self.template, self.template_cdn, context)\n\n\nclass Redoc(DocsBase):\n template = \"ninja/redoc.html\"\n template_cdn = str(ABS_TPL_PATH / \"redoc_cdn.html\")\n default_settings: DictStrAny = {}\n\n def __init__(self, settings: Optional[DictStrAny] = None):\n self.settings = {}\n self.settings.update(self.default_settings)\n if settings:\n self.settings.update(settings)\n\n def render_page(\n self, request: HttpRequest, api: \"NinjaAPI\", **kwargs: Any\n ) -> HttpResponse:\n context = {\n \"redoc_settings\": json.dumps(self.settings, indent=1),\n \"openapi_json_url\": self.get_openapi_url(api, kwargs),\n \"api\": api,\n }\n return render_template(request, self.template, self.template_cdn, context)\n\n\ndef render_template(\n request: HttpRequest, template: str, template_cdn: str, context: DictStrAny\n) -> HttpResponse:\n \"\"\"\n I do not really want ninja to be required in INSTALLED_APPS to ease installation\n so it automatically detects - if ninja is in INSTALLED_APPS - then we render with django.shortcuts.render\n otherwise - rendering custom html with swagger js from cdn\n \"\"\"\n if \"ninja\" in settings.INSTALLED_APPS:\n return render(request, template, context)\n else:\n return _render_cdn_template(request, template_cdn, context)\n\n\ndef _render_cdn_template(\n request: HttpRequest, template_path: str, context: Optional[DictStrAny] = None\n) -> HttpResponse:\n \"this is helper to find and render html template when ninja is not in INSTALLED_APPS\"\n from django.template import RequestContext, Template\n\n tpl = Template(Path(template_path).read_text())\n html = tpl.render(RequestContext(request, context))\n return HttpResponse(html)\n\n\ndef _csrf_needed(api: \"NinjaAPI\") -> bool:\n \"\"\"\n Check if any of the API's auth handlers require CSRF protection.\n \"\"\"\n if not api.auth or api.auth == NOT_SET:\n return False\n\n return any(getattr(a, \"csrf\", False) for a in api.auth) # type: ignore\n"
},
{
"path": "ninja/openapi/schema.py",
"content": "import itertools\nimport re\nfrom http.client import responses\nfrom typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Set, Tuple\n\nfrom django.utils.termcolors import make_style\nfrom pydantic.json_schema import JsonSchemaMode\n\nfrom ninja.constants import NOT_SET\nfrom ninja.operation import Operation\nfrom ninja.params.models import TModel, TModels\nfrom ninja.schema import NinjaGenerateJsonSchema\nfrom ninja.types import DictStrAny\nfrom ninja.utils import normalize_path\n\nif TYPE_CHECKING:\n from ninja import NinjaAPI # pragma: no cover\n\nREF_TEMPLATE: str = \"#/components/schemas/{model}\"\n\nBODY_CONTENT_TYPES: Dict[str, str] = {\n \"body\": \"application/json\",\n \"form\": \"application/x-www-form-urlencoded\",\n \"file\": \"multipart/form-data\",\n}\n\n\ndef get_schema(api: \"NinjaAPI\", path_prefix: str = \"\") -> \"OpenAPISchema\":\n openapi = OpenAPISchema(api, path_prefix)\n return openapi\n\n\nbold_red_style = make_style(opts=(\"bold\",), fg=\"red\")\n\n\nclass OpenAPISchema(dict):\n def __init__(self, api: \"NinjaAPI\", path_prefix: str) -> None:\n self.api = api\n self.path_prefix = path_prefix\n self.schemas: DictStrAny = {}\n self.securitySchemes: DictStrAny = {}\n self.all_operation_ids: Set = set()\n extra_info = api.openapi_extra.get(\"info\", {})\n super().__init__([\n (\"openapi\", \"3.1.0\"),\n (\n \"info\",\n {\n \"title\": api.title,\n \"version\": api.version,\n \"description\": api.description,\n **extra_info,\n },\n ),\n (\"paths\", self.get_paths()),\n (\"components\", self.get_components()),\n (\"servers\", api.servers),\n ])\n for k, v in api.openapi_extra.items():\n if k not in self:\n self[k] = v\n\n def get_paths(self) -> DictStrAny:\n result: DictStrAny = {}\n # Use bound routers to ensure operations have correct auth/throttle/tags\n for bound_router in self.api._get_bound_routers():\n for path, path_view in bound_router.path_operations.items():\n full_path = \"/\".join([i for i in (bound_router.prefix, path) if i])\n full_path = \"/\" + self.path_prefix + full_path\n full_path = normalize_path(full_path)\n full_path = re.sub(\n r\"{[^}:]+:\", \"{\", full_path\n ) # remove path converters\n path_methods = self.methods(path_view.operations)\n if path_methods:\n try:\n result[full_path].update(path_methods)\n except KeyError:\n result[full_path] = path_methods\n\n return result\n\n def methods(self, operations: list) -> DictStrAny:\n result = {}\n for op in operations:\n if op.include_in_schema:\n operation_details = self.operation_details(op)\n for method in op.methods:\n result[method.lower()] = operation_details\n return result\n\n def deep_dict_update(\n self, main_dict: Dict[Any, Any], update_dict: Dict[Any, Any]\n ) -> None:\n for key in update_dict:\n if (\n key in main_dict\n and isinstance(main_dict[key], dict)\n and isinstance(update_dict[key], dict)\n ):\n self.deep_dict_update(\n main_dict[key], update_dict[key]\n ) # pragma: no cover\n elif (\n key in main_dict\n and isinstance(main_dict[key], list)\n and isinstance(update_dict[key], list)\n ):\n main_dict[key].extend(update_dict[key])\n else:\n main_dict[key] = update_dict[key]\n\n def operation_details(self, operation: Operation) -> DictStrAny:\n op_id = operation.operation_id or self.api.get_openapi_operation_id(operation)\n if op_id in self.all_operation_ids:\n print(\n bold_red_style(\n f'Warning: operation_id \"{op_id}\" is already used (Try giving a different name to: {operation.view_func.__module__}.{operation.view_func.__name__})'\n )\n )\n self.all_operation_ids.add(op_id)\n result = {\n \"operationId\": op_id,\n \"summary\": operation.summary,\n \"parameters\": self.operation_parameters(operation),\n \"responses\": self.responses(operation),\n }\n\n if operation.description:\n result[\"description\"] = operation.description\n\n if operation.tags:\n result[\"tags\"] = operation.tags\n\n if operation.deprecated:\n result[\"deprecated\"] = operation.deprecated # type: ignore\n\n body = self.request_body(operation)\n if body:\n result[\"requestBody\"] = body\n\n security = self.operation_security(operation)\n if security:\n result[\"security\"] = security\n\n if operation.openapi_extra:\n self.deep_dict_update(result, operation.openapi_extra)\n\n return result\n\n def operation_parameters(self, operation: Operation) -> List[DictStrAny]:\n result = []\n for model in operation.models:\n if model.__ninja_param_source__ not in BODY_CONTENT_TYPES:\n result.extend(self._extract_parameters(model))\n return result\n\n def _extract_parameters(self, model: TModel) -> List[DictStrAny]:\n result = []\n\n schema = model.model_json_schema(\n ref_template=REF_TEMPLATE,\n schema_generator=NinjaGenerateJsonSchema,\n )\n\n required = set(schema.get(\"required\", []))\n properties = schema[\"properties\"]\n\n if \"$defs\" in schema:\n self.add_schema_definitions(schema[\"$defs\"])\n\n for name, details in properties.items():\n is_required = name in required\n p_name: str\n p_schema: DictStrAny\n p_required: bool\n for p_name, p_schema, p_required in flatten_properties(\n name, details, is_required, schema.get(\"$defs\", {})\n ):\n if not p_schema.get(\"include_in_schema\", True):\n continue\n\n param = {\n \"in\": model.__ninja_param_source__,\n \"name\": p_name,\n \"schema\": p_schema,\n \"required\": p_required,\n }\n\n # copy description from schema description to param description\n if \"description\" in p_schema:\n param[\"description\"] = p_schema[\"description\"]\n if \"examples\" in p_schema:\n param[\"examples\"] = p_schema[\"examples\"]\n elif \"example\" in p_schema:\n param[\"example\"] = p_schema[\"example\"]\n if \"deprecated\" in p_schema:\n param[\"deprecated\"] = p_schema[\"deprecated\"]\n\n result.append(param)\n\n return result\n\n def _flatten_schema(self, model: TModel) -> DictStrAny:\n params = self._extract_parameters(model)\n flattened = {\n \"title\": model.__name__, # type: ignore\n \"type\": \"object\",\n \"properties\": {p[\"name\"]: p[\"schema\"] for p in params},\n }\n required = [p[\"name\"] for p in params if p[\"required\"]]\n if required:\n flattened[\"required\"] = required\n return flattened\n\n def _create_schema_from_model(\n self,\n model: TModel,\n by_alias: bool = True,\n remove_level: bool = True,\n mode: JsonSchemaMode = \"validation\",\n ) -> Tuple[DictStrAny, bool]:\n if hasattr(model, \"__ninja_flatten_map__\"):\n schema = self._flatten_schema(model)\n else:\n schema = model.model_json_schema(\n ref_template=REF_TEMPLATE,\n by_alias=by_alias,\n schema_generator=NinjaGenerateJsonSchema,\n mode=mode,\n ).copy()\n\n # move Schemas from definitions\n if schema.get(\"$defs\"):\n self.add_schema_definitions(schema.pop(\"$defs\"))\n\n if remove_level and len(schema[\"properties\"]) == 1:\n name, details = list(schema[\"properties\"].items())[0]\n\n # ref = details[\"$ref\"]\n required = name in schema.get(\"required\", {})\n return details, required\n else:\n return schema, True\n\n def _create_multipart_schema_from_models(\n self,\n models: TModels,\n mode: JsonSchemaMode = \"validation\",\n ) -> Tuple[DictStrAny, str]:\n # We have File and Form or Body, so we need to use multipart (File)\n content_type = BODY_CONTENT_TYPES[\"file\"]\n\n # get the various schemas\n result = merge_schemas([\n self._create_schema_from_model(model, remove_level=False)[0]\n for model in models\n ])\n result[\"title\"] = \"MultiPartBodyParams\"\n\n return result, content_type\n\n def request_body(self, operation: Operation) -> DictStrAny:\n models = [\n m\n for m in operation.models\n if m.__ninja_param_source__ in BODY_CONTENT_TYPES\n ]\n if not models:\n return {}\n\n if len(models) == 1:\n model = models[0]\n content_type = BODY_CONTENT_TYPES[model.__ninja_param_source__]\n schema, required = self._create_schema_from_model(\n model,\n remove_level=model.__ninja_param_source__ == \"body\",\n mode=\"validation\",\n )\n else:\n schema, content_type = self._create_multipart_schema_from_models(\n models, mode=\"validation\"\n )\n required = True\n\n return {\n \"content\": {content_type: {\"schema\": schema}},\n \"required\": required,\n }\n\n def responses(self, operation: Operation) -> Dict[int, DictStrAny]:\n assert bool(operation.response_models), f\"{operation.response_models} empty\"\n\n result = {}\n for status, model in operation.response_models.items():\n if status == Ellipsis:\n continue # it's not yet clear what it means if user wants to output any other code\n\n description = responses.get(status, \"Unknown Status Code\")\n details: Dict[int, Any] = {status: {\"description\": description}}\n if model not in [None, NOT_SET]:\n # ::TODO:: test this: by_alias == True\n schema = self._create_schema_from_model(\n model, by_alias=operation.by_alias, mode=\"serialization\"\n )[0]\n if operation.stream_format is not None:\n details[status][\"content\"] = (\n operation.stream_format.openapi_content_schema(schema)\n )\n else:\n details[status][\"content\"] = {\n self.api.renderer.media_type: {\"schema\": schema}\n }\n result.update(details)\n\n return result\n\n def operation_security(self, operation: Operation) -> Optional[List[DictStrAny]]:\n if not operation.auth_callbacks:\n return None\n result = []\n for auth in operation.auth_callbacks:\n if hasattr(auth, \"openapi_security_schema\"):\n scopes: List[DictStrAny] = [] # TODO: scopes\n name = auth.__class__.__name__\n result.append({name: scopes}) # TODO: check if unique\n self.securitySchemes[name] = auth.openapi_security_schema\n return result\n\n def get_components(self) -> DictStrAny:\n result = {\"schemas\": self.schemas}\n if self.securitySchemes:\n result[\"securitySchemes\"] = self.securitySchemes\n return result\n\n def add_schema_definitions(self, definitions: dict) -> None:\n # TODO: check if schema[\"definitions\"] are unique\n # if not - workaround (maybe use pydantic.schema.schema(models)) to process list of models\n # assert set(definitions.keys()) - set(self.schemas.keys()) == set()\n # ::TODO:: this is broken in interesting ways for by_alias,\n # because same schema (name) can have different values\n self.schemas.update(definitions)\n\n\ndef flatten_properties(\n prop_name: str,\n prop_details: DictStrAny,\n prop_required: bool,\n definitions: DictStrAny,\n) -> Generator[Tuple[str, DictStrAny, bool], None, None]:\n \"\"\"\n extracts all nested model's properties into flat properties\n (used f.e. in GET params with multiple arguments and models)\n \"\"\"\n if \"allOf\" in prop_details:\n resolve_allOf(prop_details, definitions)\n if len(prop_details[\"allOf\"]) == 1 and \"enum\" in prop_details[\"allOf\"][0]:\n # is_required = \"default\" not in prop_details\n yield prop_name, prop_details, prop_required\n else: # pragma: no cover\n # TODO: this code was for pydanitc 1.7+ ... <2.9 - check if this is still needed\n for item in prop_details[\"allOf\"]:\n yield from flatten_properties(\"\", item, True, definitions)\n\n elif \"items\" in prop_details and \"$ref\" in prop_details[\"items\"]:\n def_name = prop_details[\"items\"][\"$ref\"].rsplit(\"/\", 1)[-1]\n prop_details[\"items\"].update(definitions[def_name])\n del prop_details[\"items\"][\"$ref\"] # seems num data is there so ref not needed\n yield prop_name, prop_details, prop_required\n\n elif \"$ref\" in prop_details:\n def_name = prop_details[\"$ref\"].split(\"/\")[-1]\n definition = definitions[def_name]\n yield from flatten_properties(prop_name, definition, prop_required, definitions)\n\n elif \"properties\" in prop_details:\n required = set(prop_details.get(\"required\", []))\n for k, v in prop_details[\"properties\"].items():\n is_required = k in required\n yield from flatten_properties(k, v, is_required, definitions)\n else:\n yield prop_name, prop_details, prop_required\n\n\ndef resolve_allOf(details: DictStrAny, definitions: DictStrAny) -> None:\n \"\"\"\n resolves all $ref's in 'allOf' section\n \"\"\"\n for item in details[\"allOf\"]:\n if \"$ref\" in item:\n def_name = item[\"$ref\"].rsplit(\"/\", 1)[-1]\n item.update(definitions[def_name])\n del item[\"$ref\"]\n\n\ndef merge_schemas(schemas: List[DictStrAny]) -> DictStrAny:\n result = schemas[0]\n for scm in schemas[1:]:\n result[\"properties\"].update(scm[\"properties\"])\n\n required_list = result.get(\"required\", [])\n required_list.extend(\n itertools.chain.from_iterable(\n schema.get(\"required\", ()) for schema in schemas[1:]\n )\n )\n if required_list:\n result[\"required\"] = required_list\n return result\n"
},
{
"path": "ninja/openapi/urls.py",
"content": "from functools import partial\nfrom typing import TYPE_CHECKING, Any, List\n\nfrom django.urls import path\n\nfrom .views import default_home, openapi_json, openapi_view\n\nif TYPE_CHECKING:\n from ninja import NinjaAPI # pragma: no cover\n\n__all__ = [\"get_openapi_urls\", \"get_root_url\"]\n\n\ndef get_openapi_urls(api: \"NinjaAPI\") -> List[Any]:\n result = []\n\n if api.openapi_url:\n view = partial(openapi_json, api=api)\n if api.docs_decorator:\n view = api.docs_decorator(view) # type: ignore\n result.append(\n path(api.openapi_url.lstrip(\"/\"), view, name=\"openapi-json\"),\n )\n\n assert (\n api.openapi_url != api.docs_url\n ), \"Please use different urls for openapi_url and docs_url\"\n\n if api.docs_url:\n view = partial(openapi_view, api=api)\n if api.docs_decorator:\n view = api.docs_decorator(view) # type: ignore\n result.append(\n path(api.docs_url.lstrip(\"/\"), view, name=\"openapi-view\"),\n )\n\n return result\n\n\ndef get_root_url(api: \"NinjaAPI\") -> Any:\n return path(\"\", partial(default_home, api=api), name=\"api-root\")\n"
},
{
"path": "ninja/openapi/views.py",
"content": "from typing import TYPE_CHECKING, Any, NoReturn\n\nfrom django.http import Http404, HttpRequest, HttpResponse\n\nfrom ninja.openapi.docs import DocsBase\nfrom ninja.responses import Response\n\nif TYPE_CHECKING:\n # if anyone knows a cleaner way to make mypy happy - welcome\n from ninja import NinjaAPI # pragma: no cover\n\n\ndef default_home(request: HttpRequest, api: \"NinjaAPI\", **kwargs: Any) -> NoReturn:\n \"This view is mainly needed to determine the full path for API operations\"\n docs_url = f\"{request.path}{api.docs_url}\".replace(\"//\", \"/\")\n raise Http404(f\"docs_url = {docs_url}\")\n\n\ndef openapi_json(request: HttpRequest, api: \"NinjaAPI\", **kwargs: Any) -> HttpResponse:\n schema = api.get_openapi_schema(path_params=kwargs)\n return Response(schema)\n\n\ndef openapi_view(request: HttpRequest, api: \"NinjaAPI\", **kwargs: Any) -> HttpResponse:\n docs: DocsBase = api.docs\n return docs.render_page(request, api, **kwargs)\n"
},
{
"path": "ninja/operation.py",
"content": "import inspect\nimport warnings\nfrom typing import (\n TYPE_CHECKING,\n Any,\n Callable,\n Coroutine,\n Dict,\n Iterable,\n List,\n Optional,\n Sequence,\n Type,\n Union,\n cast,\n)\n\nimport pydantic\nfrom asgiref.sync import async_to_sync, sync_to_async\nfrom django.http import (\n HttpRequest,\n HttpResponse,\n HttpResponseNotAllowed,\n StreamingHttpResponse,\n)\nfrom django.http.response import HttpResponseBase\nfrom pydantic import BaseModel\n\nfrom ninja.compatibility.files import FIX_MIDDLEWARE_PATH, need_to_fix_request_files\nfrom ninja.compatibility.streaming import create_streaming_response\nfrom ninja.constants import NOT_SET, NOT_SET_TYPE\nfrom ninja.errors import (\n AuthenticationError,\n ConfigError,\n Throttled,\n ValidationErrorContext,\n)\nfrom ninja.params.models import TModels\nfrom ninja.responses import Status\nfrom ninja.schema import Schema, pydantic_version\nfrom ninja.signature import ViewSignature, is_async\nfrom ninja.streaming import StreamFormat, _serialize_item, _StreamAlias\nfrom ninja.throttling import BaseThrottle\nfrom ninja.types import DictStrAny\nfrom ninja.utils import is_async_callable\n\nif TYPE_CHECKING:\n from ninja import NinjaAPI # pragma: no cover\n\n__all__ = [\"Operation\", \"PathView\", \"ResponseObject\"]\n\n\nclass Operation:\n def __init__(\n self,\n path: str,\n methods: List[str],\n view_func: Callable,\n *,\n auth: Optional[Union[Sequence[Callable], Callable, NOT_SET_TYPE]] = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n include_in_schema: bool = True,\n url_name: Optional[str] = None,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> None:\n self.is_async = False\n self.path: str = path\n self.methods: List[str] = methods\n self.view_func: Callable = view_func\n self.api: NinjaAPI = cast(\"NinjaAPI\", None)\n self.csrf_exempt: bool = getattr(view_func, \"csrf_exempt\", False)\n if url_name is not None:\n self.url_name = url_name\n\n self.auth_param: Optional[Union[Sequence[Callable], Callable, object]] = auth\n self.auth_callbacks: Sequence[Callable] = []\n self._set_auth(auth)\n\n if isinstance(throttle, BaseThrottle):\n throttle = [throttle]\n self.throttle_param = throttle\n self.throttle_objects: List[BaseThrottle] = []\n if throttle is not NOT_SET:\n for th in throttle: # type: ignore\n assert isinstance(\n th, BaseThrottle\n ), \"Throttle should be an instance of BaseThrottle\"\n self.throttle_objects.append(th)\n\n self.signature = ViewSignature(self.path, self.view_func)\n self.models: TModels = self.signature.models\n\n self.stream_format: Optional[Type[StreamFormat]] = None\n self.stream_item_model: Optional[Type[Schema]] = None\n self.response_models: Dict[Any, Any]\n if isinstance(response, _StreamAlias):\n self.stream_format = response.format_cls\n self.stream_item_model = self._create_response_model(response.item_type)\n self.response_models = {200: self.stream_item_model}\n elif response is NOT_SET:\n self.response_models = {200: NOT_SET}\n elif isinstance(response, dict):\n self.response_models = self._create_response_model_multiple(response)\n else:\n self.response_models = {200: self._create_response_model(response)}\n\n if need_to_fix_request_files(methods, self.models):\n raise ConfigError(\n f\"Router '{path}' has method(s) {methods} that require fixing request.FILES. \"\n f\"Please add '{FIX_MIDDLEWARE_PATH}' to settings.MIDDLEWARE\"\n )\n\n self.operation_id = operation_id\n self.summary = summary or self.view_func.__name__.title().replace(\"_\", \" \")\n self.description = description or self.signature.docstring\n self.tags = tags\n self.deprecated = deprecated\n self.include_in_schema = include_in_schema\n self.openapi_extra = openapi_extra\n\n # Exporting models params\n self.by_alias = by_alias or False\n self.exclude_unset = exclude_unset or False\n self.exclude_defaults = exclude_defaults or False\n self.exclude_none = exclude_none or False\n\n if hasattr(view_func, \"_ninja_contribute_to_operation\"):\n # Allow 3rd party code to contribute to the operation behavior\n callbacks: List[Callable] = view_func._ninja_contribute_to_operation\n for callback in callbacks:\n callback(self)\n\n def clone(self) -> \"Operation\":\n \"\"\"\n Create a fresh copy of this operation for binding to an API.\n\n This method is used when mounting the same router multiple times\n to ensure each mount has independent operation instances.\n \"\"\"\n # Create instance without calling __init__ to avoid expensive processing\n cloned = object.__new__(self.__class__)\n\n # Copy all essential attributes\n cloned.is_async = self.is_async\n cloned.path = self.path\n cloned.methods = list(self.methods)\n cloned.view_func = self.view_func\n cloned.api = cast(\"NinjaAPI\", None) # Will be set during binding\n cloned.csrf_exempt = self.csrf_exempt\n\n # Copy url_name if it exists\n if hasattr(self, \"url_name\"):\n cloned.url_name = self.url_name\n\n # Copy auth settings\n cloned.auth_param = self.auth_param\n cloned.auth_callbacks = list(self.auth_callbacks)\n\n # Copy throttle settings\n cloned.throttle_param = self.throttle_param\n cloned.throttle_objects = list(self.throttle_objects)\n\n # Copy signature and models (immutable after creation, safe to share)\n cloned.signature = self.signature\n cloned.models = self.models\n\n # Copy streaming attributes\n cloned.stream_format = self.stream_format\n cloned.stream_item_model = self.stream_item_model\n\n # Copy response models (dict copy for isolation)\n cloned.response_models = dict(self.response_models)\n\n # Copy metadata\n cloned.operation_id = self.operation_id\n cloned.summary = self.summary\n cloned.description = self.description\n cloned.tags = list(self.tags) if self.tags else None\n cloned.deprecated = self.deprecated\n cloned.include_in_schema = self.include_in_schema\n cloned.openapi_extra = dict(self.openapi_extra) if self.openapi_extra else None\n\n # Copy export model params\n cloned.by_alias = self.by_alias\n cloned.exclude_unset = self.exclude_unset\n cloned.exclude_defaults = self.exclude_defaults\n cloned.exclude_none = self.exclude_none\n\n # Re-apply run decorators (from decorate_view) to the clone's run method\n # We can't just copy the decorated run because it's bound to the original instance\n if hasattr(self, \"_run_decorators\") and self._run_decorators:\n cloned._run_decorators = [] # type: ignore[attr-defined]\n for deco in self._run_decorators:\n cloned.run = deco(cloned.run) # type: ignore\n cloned._run_decorators.append(deco) # type: ignore[attr-defined]\n\n return cloned\n\n def run(self, request: HttpRequest, **kw: Any) -> HttpResponseBase:\n error = self._run_checks(request)\n if error:\n return error\n try:\n temporal_response = self.api.create_temporal_response(request)\n values = self._get_values(request, kw, temporal_response)\n result = self.view_func(request, **values)\n if self.stream_format:\n return self._stream_response(request, result, temporal_response)\n return self._result_to_response(request, result, temporal_response)\n except Exception as e:\n if isinstance(e, TypeError) and \"required positional argument\" in str(e):\n msg = \"Did you fail to use functools.wraps() in a decorator?\"\n msg = f\"{e.args[0]}: {msg}\" if e.args else msg\n e.args = (msg,) + e.args[1:]\n return self.api.on_exception(request, e)\n\n def _validate_stream_item(self, item: Any, request: HttpRequest) -> str:\n \"\"\"Validate a single stream item and return serialized JSON string.\"\"\"\n assert self.stream_item_model is not None\n resp_object = ResponseObject(item)\n validated = self.stream_item_model.model_validate(\n resp_object, context={\"request\": request, \"response_status\": 200}\n )\n\n model_dump_kwargs: Dict[str, Any] = {}\n if pydantic_version >= [2, 7]: # pragma: no branch\n # pydantic added support for serialization context at 2.7\n model_dump_kwargs.update(\n context={\"request\": request, \"response_status\": 200}\n )\n\n result = validated.model_dump(\n by_alias=self.by_alias,\n exclude_unset=self.exclude_unset,\n exclude_defaults=self.exclude_defaults,\n exclude_none=self.exclude_none,\n **model_dump_kwargs,\n )[\"response\"]\n return _serialize_item(result)\n\n def _stream_response(\n self,\n request: HttpRequest,\n generator: Any,\n temporal_response: HttpResponse,\n ) -> StreamingHttpResponse:\n \"\"\"Create a StreamingHttpResponse from a sync generator.\"\"\"\n assert self.stream_format is not None\n fmt = self.stream_format\n\n def content_iter() -> Any:\n for item in generator:\n data = self._validate_stream_item(item, request)\n yield fmt.format_chunk(data)\n # Copy headers/cookies after generator completes (user may set them inside)\n for key, value in temporal_response.items():\n if key.lower() != \"content-type\":\n response[key] = value\n for cookie_name, cookie in temporal_response.cookies.items():\n response.cookies[cookie_name] = cookie\n\n response = StreamingHttpResponse(\n content_iter(),\n content_type=fmt.media_type,\n status=temporal_response.status_code,\n )\n # Add format-specific headers\n for key, value in fmt.response_headers().items():\n response[key] = value\n return response\n\n def _set_auth(\n self, auth: Optional[Union[Sequence[Callable], Callable, object]]\n ) -> None:\n if auth is not None and auth is not NOT_SET:\n self.auth_callbacks = isinstance(auth, Sequence) and auth or [auth]\n\n def _run_checks(self, request: HttpRequest) -> Optional[HttpResponse]:\n \"Runs security/throttle checks for each operation\"\n # NOTE: if you change anything in this function - do this also in AsyncOperation\n\n # Set CSRF exempt status on request so auth handlers can check it\n if self.csrf_exempt:\n # _ninja_csrf_exempt is a special flag that tells auth handler to skip CSRF checks\n request._ninja_csrf_exempt = True # type: ignore\n\n # auth:\n if self.auth_callbacks:\n error = self._run_authentication(request)\n if error:\n return error\n\n # Throttling:\n if self.throttle_objects:\n error = self._check_throttles(request)\n if error:\n return error\n\n return None\n\n def _run_authentication(self, request: HttpRequest) -> Optional[HttpResponse]:\n for callback in self.auth_callbacks:\n try:\n if is_async_callable(callback) or getattr(callback, \"is_async\", False):\n result = callback(request)\n if inspect.iscoroutine(result):\n result = async_to_sync(callback)(request)\n else:\n result = callback(request)\n except Exception as exc:\n return self.api.on_exception(request, exc)\n\n if result:\n request.auth = result # type: ignore\n return None\n return self.api.on_exception(request, AuthenticationError())\n\n def _check_throttles(self, request: HttpRequest) -> Optional[HttpResponse]:\n throttle_durations = []\n for throttle in self.throttle_objects:\n if not throttle.allow_request(request):\n throttle_durations.append(throttle.wait())\n\n if throttle_durations:\n # Filter out `None` values which may happen in case of config / rate\n durations = [\n duration for duration in throttle_durations if duration is not None\n ]\n\n duration = max(durations, default=None)\n return self.api.on_exception(request, Throttled(wait=duration)) # type: ignore\n return None\n\n def _model_dump_kwargs(self, request: HttpRequest, status: int) -> Dict[str, Any]:\n kwargs: Dict[str, Any] = {}\n if pydantic_version >= [2, 7]:\n kwargs[\"context\"] = {\"request\": request, \"response_status\": status}\n return kwargs\n\n def _result_to_response(\n self, request: HttpRequest, result: Any, temporal_response: HttpResponse\n ) -> HttpResponseBase:\n \"\"\"\n The protocol for results\n - if HttpResponse - returns as is\n - if Status object - uses status code + body\n - if tuple with 2 elements - means http_code + body (deprecated)\n - otherwise it's a body\n \"\"\"\n if isinstance(result, HttpResponseBase):\n return result\n\n status: int = 200\n if len(self.response_models) == 1:\n status = next(iter(self.response_models))\n\n if isinstance(result, Status):\n status = result.status_code\n result = result.value\n elif isinstance(result, tuple) and len(result) == 2:\n warnings.warn(\n \"Returning tuple (status_code, response) is deprecated. \"\n \"Use Status(status_code, response) instead.\",\n DeprecationWarning,\n stacklevel=2,\n )\n status, result = result\n\n if status in self.response_models:\n response_model = self.response_models[status]\n elif Ellipsis in self.response_models:\n response_model = self.response_models[Ellipsis]\n else:\n raise ConfigError(\n f\"Schema for status {status} is not set in response\"\n f\" {self.response_models.keys()}\"\n )\n\n temporal_response.status_code = status\n\n if response_model is NOT_SET:\n return self.api.create_response(\n request, result, temporal_response=temporal_response\n )\n\n if response_model is None:\n # Empty response.\n return temporal_response\n\n model_dump_kwargs = self._model_dump_kwargs(request, status)\n\n # Skip re-validation for pydantic model instances matching the response type\n resp_annotation = response_model.model_fields[\"response\"].annotation\n if (\n isinstance(resp_annotation, type)\n and isinstance(result, BaseModel)\n and isinstance(result, resp_annotation)\n ):\n result = cast(BaseModel, result).model_dump(\n by_alias=self.by_alias,\n exclude_unset=self.exclude_unset,\n exclude_defaults=self.exclude_defaults,\n exclude_none=self.exclude_none,\n **model_dump_kwargs,\n )\n return self.api.create_response(\n request, result, temporal_response=temporal_response\n )\n\n resp_object = ResponseObject(result)\n # ^ we need object because getter_dict seems work only with model_validate\n validated_object = response_model.model_validate(\n resp_object, context={\"request\": request, \"response_status\": status}\n )\n\n result = validated_object.model_dump(\n by_alias=self.by_alias,\n exclude_unset=self.exclude_unset,\n exclude_defaults=self.exclude_defaults,\n exclude_none=self.exclude_none,\n **model_dump_kwargs,\n )[\"response\"]\n return self.api.create_response(\n request, result, temporal_response=temporal_response\n )\n\n def _get_values(\n self, request: HttpRequest, path_params: Any, temporal_response: HttpResponse\n ) -> DictStrAny:\n values = {}\n error_contexts: List[ValidationErrorContext] = []\n for model in self.models:\n try:\n data = model.resolve(request, self.api, path_params)\n values.update(data)\n except pydantic.ValidationError as e:\n error_contexts.append(\n ValidationErrorContext(pydantic_validation_error=e, model=model)\n )\n if error_contexts:\n validation_error = self.api.validation_error_from_error_contexts(\n error_contexts\n )\n raise validation_error\n if self.signature.response_arg:\n values[self.signature.response_arg] = temporal_response\n return values\n\n def _create_response_model_multiple(\n self, response_param: DictStrAny\n ) -> Dict[str, Optional[Type[Schema]]]:\n result = {}\n for key, model in response_param.items():\n status_codes = isinstance(key, Iterable) and key or [key]\n for code in status_codes:\n result[code] = self._create_response_model(model)\n return result\n\n def _create_response_model(self, response_param: Any) -> Optional[Type[Schema]]:\n if response_param is None:\n return None\n attrs = {\"__annotations__\": {\"response\": response_param}}\n return type(\"NinjaResponseSchema\", (Schema,), attrs)\n\n\nclass AsyncOperation(Operation):\n def __init__(self, *args: Any, **kwargs: Any) -> None:\n super().__init__(*args, **kwargs)\n self.is_async = True\n\n async def run(self, request: HttpRequest, **kw: Any) -> HttpResponseBase: # type: ignore\n error = await self._run_checks(request)\n if error:\n return error\n try:\n temporal_response = self.api.create_temporal_response(request)\n values = self._get_values(request, kw, temporal_response)\n if self.stream_format:\n result = self.view_func(request, **values)\n return await self._async_stream_response(\n request, result, temporal_response\n )\n result = await self.view_func(request, **values)\n return self._result_to_response(request, result, temporal_response)\n except Exception as e:\n return self.api.on_exception(request, e)\n\n async def _async_stream_response(\n self,\n request: HttpRequest,\n generator: Any,\n temporal_response: HttpResponse,\n ) -> StreamingHttpResponse:\n \"\"\"Create a StreamingHttpResponse from an async generator.\"\"\"\n assert self.stream_format is not None\n fmt = self.stream_format\n\n async def content_gen() -> Any:\n async for item in generator:\n data = self._validate_stream_item(item, request)\n yield fmt.format_chunk(data)\n\n return await create_streaming_response(\n content_gen(),\n content_type=fmt.media_type,\n status=temporal_response.status_code,\n temporal_response=temporal_response,\n extra_headers=fmt.response_headers(),\n )\n\n async def _run_checks(self, request: HttpRequest) -> Optional[HttpResponse]: # type: ignore\n \"Runs security/throttle checks for each operation\"\n # NOTE: if you change anything in this function - do this also in Sync Operation\n\n # Set CSRF exempt status on request so auth handlers can check it\n if self.csrf_exempt:\n request._ninja_csrf_exempt = True # type: ignore\n\n # auth:\n if self.auth_callbacks:\n error = await self._run_authentication(request)\n if error:\n return error\n\n # Throttling:\n if self.throttle_objects:\n error = self._check_throttles(request)\n if error:\n return error\n\n return None\n\n async def _run_authentication(self, request: HttpRequest) -> Optional[HttpResponse]: # type: ignore\n for callback in self.auth_callbacks:\n try:\n if is_async_callable(callback) or getattr(callback, \"is_async\", False):\n cor: Optional[Coroutine] = callback(request)\n if cor is None:\n result = None\n else:\n result = await cor\n else:\n result = await sync_to_async(callback)(request)\n except Exception as exc:\n return self.api.on_exception(request, exc)\n\n if result:\n request.auth = result # type: ignore\n return None\n return self.api.on_exception(request, AuthenticationError())\n\n\nclass PathView:\n def __init__(self) -> None:\n self.operations: List[Operation] = []\n self.is_async = False # if at least one operation is async - will become True\n self.url_name: Optional[str] = None\n\n def add_operation(\n self,\n path: str,\n methods: List[str],\n view_func: Callable,\n *,\n auth: Optional[Union[Sequence[Callable], Callable, NOT_SET_TYPE]] = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Operation:\n if url_name:\n self.url_name = url_name\n\n OperationClass = Operation\n is_streaming = isinstance(response, _StreamAlias)\n if is_async(view_func) or (\n is_streaming and inspect.isasyncgenfunction(view_func)\n ):\n self.is_async = True\n OperationClass = AsyncOperation\n\n operation = OperationClass(\n path,\n methods,\n view_func,\n auth=auth,\n throttle=throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n include_in_schema=include_in_schema,\n url_name=url_name,\n openapi_extra=openapi_extra,\n )\n\n self.operations.append(operation)\n view_func._ninja_operation = operation # type: ignore\n\n return operation\n\n def clone(self) -> \"PathView\":\n \"\"\"\n Create a fresh copy of this PathView with cloned operations.\n\n This method is used when mounting the same router multiple times\n to ensure each mount has independent PathView and Operation instances.\n \"\"\"\n cloned = PathView()\n cloned.is_async = self.is_async\n cloned.url_name = self.url_name\n cloned.operations = [op.clone() for op in self.operations]\n return cloned\n\n def get_view(self) -> Callable:\n # Create a unique view function for this PathView\n\n if self.is_async:\n # Create a wrapper for async view\n async def async_view_wrapper(\n request: HttpRequest, *args: Any, **kwargs: Any\n ) -> HttpResponseBase:\n return await self._async_view(request, *args, **kwargs)\n\n # All django-ninja views are CSRF exempt at Django middleware level\n # Cookie-based auth (APIKeyCookie) handles CSRF checking separately\n async_view_wrapper.csrf_exempt = True # type: ignore\n\n return async_view_wrapper\n else:\n # Create a wrapper for sync view\n def sync_view_wrapper(\n request: HttpRequest, *args: Any, **kwargs: Any\n ) -> HttpResponseBase:\n return self._sync_view(request, *args, **kwargs)\n\n # All django-ninja views are CSRF exempt at Django middleware level\n # Cookie-based auth (APIKeyCookie) handles CSRF checking separately\n sync_view_wrapper.csrf_exempt = True # type: ignore\n\n return sync_view_wrapper\n\n def _sync_view(self, request: HttpRequest, *a: Any, **kw: Any) -> HttpResponseBase:\n operation = self._find_operation(request)\n if operation is None:\n return self._not_allowed()\n return operation.run(request, *a, **kw)\n\n async def _async_view(\n self, request: HttpRequest, *a: Any, **kw: Any\n ) -> HttpResponseBase:\n operation = self._find_operation(request)\n if operation is None:\n return self._not_allowed()\n if operation.is_async:\n return await cast(AsyncOperation, operation).run(request, *a, **kw)\n return await sync_to_async(operation.run)(request, *a, **kw)\n\n def _find_operation(self, request: HttpRequest) -> Optional[Operation]:\n for op in self.operations:\n if request.method in op.methods:\n return op\n return None\n\n def _not_allowed(self) -> HttpResponse:\n allowed_methods = set()\n for op in self.operations:\n allowed_methods.update(op.methods)\n return HttpResponseNotAllowed(allowed_methods, content=b\"Method not allowed\")\n\n\nclass ResponseObject:\n \"Basically this is just a helper to be able to pass response to pydantic's model_validate\"\n\n def __init__(self, response: HttpResponse) -> None:\n self.response = response\n"
},
{
"path": "ninja/orm/__init__.py",
"content": "from ninja.orm.factory import create_schema\nfrom ninja.orm.fields import register_field\nfrom ninja.orm.metaclass import ModelSchema\n\n__all__ = [\"create_schema\", \"register_field\", \"ModelSchema\"]\n"
},
{
"path": "ninja/orm/factory.py",
"content": "import itertools\nfrom typing import Any, Dict, Iterator, List, Optional, Set, Tuple, Type, Union, cast\n\nfrom django.db.models import Field as DjangoField\nfrom django.db.models import ManyToManyRel, ManyToOneRel, Model\nfrom pydantic import create_model as create_pydantic_model\n\nfrom ninja.errors import ConfigError\nfrom ninja.orm.fields import get_schema_field\nfrom ninja.schema import Schema\n\n# MAYBE:\n# Schema = create_schema(Model, exclude=['id'])\n#\n# @api.post\n# def operation_create(request, payload: Schema):\n# orm_instance = payload.orm.apply(Model())\n# orm_instance.save()\n#\n# @api.post(\"/{id}\")\n# def operation_edit(request, id: int, payload: Schema):\n# orm_instance = payload.orm.apply(Model.objects.get(id=id))\n# orm_instance.save()\n\n__all__ = [\"SchemaFactory\", \"factory\", \"create_schema\"]\n\nSchemaKey = Tuple[Type[Model], str, int, str, str, str, str]\n\n\nclass SchemaFactory:\n def __init__(self) -> None:\n self.schemas: Dict[SchemaKey, Type[Schema]] = {}\n self.schema_names: Set[str] = set()\n\n def create_schema(\n self,\n model: Type[Model],\n *,\n name: str = \"\",\n depth: int = 0,\n fields: Optional[List[str]] = None,\n exclude: Optional[List[str]] = None,\n optional_fields: Optional[List[str]] = None,\n custom_fields: Optional[List[Tuple[str, Any, Any]]] = None,\n base_class: Type[Schema] = Schema,\n ) -> Type[Schema]:\n name = name or model.__name__\n\n if fields and exclude:\n raise ConfigError(\"Only one of 'fields' or 'exclude' should be set.\")\n\n key = self.get_key(\n model, name, depth, fields, exclude, optional_fields, custom_fields\n )\n if key in self.schemas:\n return self.schemas[key]\n\n model_fields_list = list(self._selected_model_fields(model, fields, exclude))\n if optional_fields:\n if optional_fields == \"__all__\":\n optional_fields = [f.name for f in model_fields_list]\n\n definitions = {}\n for fld in model_fields_list:\n python_type, field_info = get_schema_field(\n fld,\n depth=depth,\n optional=optional_fields and (fld.name in optional_fields),\n )\n definitions[fld.name] = (python_type, field_info)\n\n if custom_fields:\n for fld_name, python_type, field_info in custom_fields:\n # if not isinstance(field_info, FieldInfo):\n # field_info = Field(field_info)\n definitions[fld_name] = (python_type, field_info)\n\n if name in self.schema_names:\n name = self._get_unique_name(name)\n\n schema: Type[Schema] = create_pydantic_model(\n name,\n __config__=None,\n __base__=base_class,\n __module__=base_class.__module__,\n __validators__={},\n **definitions,\n ) # type: ignore\n # __model_name: str,\n # *,\n # __config__: ConfigDict | None = None,\n # __base__: None = None,\n # __module__: str = __name__,\n # __validators__: dict[str, AnyClassMethod] | None = None,\n # __cls_kwargs__: dict[str, Any] | None = None,\n # **field_definitions: Any,\n self.schemas[key] = schema\n self.schema_names.add(name)\n return schema\n\n def get_key(\n self,\n model: Type[Model],\n name: str,\n depth: int,\n fields: Union[str, List[str], None],\n exclude: Optional[List[str]],\n optional_fields: Optional[Union[List[str], str]],\n custom_fields: Optional[List[Tuple[str, str, Any]]],\n ) -> SchemaKey:\n \"returns a hashable value for all given parameters\"\n # TODO: must be a test that compares all kwargs from init to get_key\n return (\n model,\n name,\n depth,\n str(fields),\n str(exclude),\n str(optional_fields),\n str(custom_fields),\n )\n\n def _get_unique_name(self, name: str) -> str:\n \"Returns a unique name by adding counter suffix\"\n for num in itertools.count(start=2): # pragma: no branch\n result = f\"{name}{num}\"\n if result not in self.schema_names:\n break\n return result\n\n def _selected_model_fields(\n self,\n model: Type[Model],\n fields: Optional[List[str]] = None,\n exclude: Optional[List[str]] = None,\n ) -> Iterator[DjangoField]:\n \"Returns iterator for model fields based on `exclude` or `fields` arguments\"\n all_fields = {f.name: f for f in self._model_fields(model)}\n\n if not fields and not exclude:\n for f in all_fields.values():\n yield f\n\n invalid_fields = (set(fields or []) | set(exclude or [])) - all_fields.keys()\n if invalid_fields:\n raise ConfigError(\n f\"DjangoField(s) {invalid_fields} are not in model {model}\"\n )\n\n if fields:\n for name in fields:\n yield all_fields[name]\n if exclude:\n for f in all_fields.values():\n if f.name not in exclude:\n yield f\n\n def _model_fields(self, model: Type[Model]) -> Iterator[DjangoField]:\n \"returns iterator with all the fields that can be part of schema\"\n for fld in model._meta.get_fields():\n if isinstance(fld, (ManyToOneRel, ManyToManyRel)):\n # skipping relations\n continue\n yield cast(DjangoField, fld)\n\n\nfactory = SchemaFactory()\n\ncreate_schema = factory.create_schema\n"
},
{
"path": "ninja/orm/fields.py",
"content": "import datetime\nfrom decimal import Decimal\nfrom typing import Any, Callable, Dict, List, Tuple, Type, TypeVar, Union, no_type_check\nfrom uuid import UUID\n\nfrom django.db.models import ManyToManyField\nfrom django.db.models.fields import Field as DjangoField\nfrom pydantic import IPvAnyAddress\nfrom pydantic.fields import FieldInfo\nfrom pydantic_core import PydanticUndefined, core_schema\n\nfrom ninja.errors import ConfigError\nfrom ninja.openapi.schema import OpenAPISchema\nfrom ninja.types import DictStrAny\n\n__all__ = [\"create_m2m_link_type\", \"get_schema_field\", \"get_related_field_schema\"]\n\n\n# keep_lazy seems not needed as .title forces translation anyway\n# https://github.com/vitalik/django-ninja/issues/774\n# @keep_lazy_text\ndef title_if_lower(s: str) -> str:\n if s == s.lower():\n return s.title()\n return s\n\n\nclass AnyObject:\n @classmethod\n def __get_pydantic_core_schema__(\n cls, source: Any, handler: Callable[..., Any]\n ) -> Any:\n return core_schema.with_info_plain_validator_function(cls.validate)\n\n @classmethod\n def __get_pydantic_json_schema__(\n cls, schema: Any, handler: Callable[..., Any]\n ) -> DictStrAny:\n return {\"type\": \"object\"}\n\n @classmethod\n def validate(cls, value: Any, _: Any) -> Any:\n return value\n\n\nTYPES = {\n \"AutoField\": int,\n \"BigAutoField\": int,\n \"BigIntegerField\": int,\n \"BinaryField\": bytes,\n \"BooleanField\": bool,\n \"CharField\": str,\n \"DateField\": datetime.date,\n \"DateTimeField\": datetime.datetime,\n \"DecimalField\": Decimal,\n \"DurationField\": datetime.timedelta,\n \"FileField\": str,\n \"FilePathField\": str,\n \"FloatField\": float,\n \"GenericIPAddressField\": IPvAnyAddress,\n \"IPAddressField\": IPvAnyAddress,\n \"IntegerField\": int,\n \"JSONField\": AnyObject,\n \"NullBooleanField\": bool,\n \"PositiveBigIntegerField\": int,\n \"PositiveIntegerField\": int,\n \"PositiveSmallIntegerField\": int,\n \"SlugField\": str,\n \"SmallAutoField\": int,\n \"SmallIntegerField\": int,\n \"TextField\": str,\n \"TimeField\": datetime.time,\n \"UUIDField\": UUID,\n # postgres fields:\n \"ArrayField\": List,\n \"CICharField\": str,\n \"CIEmailField\": str,\n \"CITextField\": str,\n \"HStoreField\": Dict,\n}\n\nTModel = TypeVar(\"TModel\")\n\n\ndef register_field(django_field: str, python_type: Any) -> None:\n TYPES[django_field] = python_type\n\n\n@no_type_check\ndef create_m2m_link_type(type_: Type[TModel]) -> Type[TModel]:\n class M2MLink(type_): # type: ignore\n @classmethod\n def __get_pydantic_core_schema__(cls, source, handler):\n return core_schema.with_info_plain_validator_function(cls._validate)\n\n @classmethod\n def __get_pydantic_json_schema__(cls, schema, handler):\n json_type = {\n int: \"integer\",\n str: \"string\",\n float: \"number\",\n UUID: \"string\",\n }[type_]\n return {\"type\": json_type}\n\n @classmethod\n def _validate(cls, v: Any, _):\n try:\n return v.pk # when we output queryset - we have db instances\n except AttributeError:\n return type_(v) # when we read payloads we have primakey keys\n\n return M2MLink\n\n\n@no_type_check\ndef get_schema_field(\n field: DjangoField, *, depth: int = 0, optional: bool = False\n) -> Tuple:\n \"Returns pydantic field from django's model field\"\n alias = None\n default = ...\n default_factory = None\n description = None\n title = None\n max_length = None\n nullable = False\n python_type = None\n\n if field.is_relation:\n if depth > 0:\n return get_related_field_schema(field, depth=depth)\n\n internal_type = field.related_model._meta.pk.get_internal_type()\n\n if not field.concrete and field.auto_created or field.null or optional:\n default = None\n nullable = True\n\n alias = getattr(field, \"get_attname\", None) and field.get_attname()\n\n pk_type = TYPES.get(internal_type, int)\n if field.one_to_many or field.many_to_many:\n m2m_type = create_m2m_link_type(pk_type)\n python_type = List[m2m_type] # type: ignore\n else:\n python_type = pk_type\n\n else:\n _f_name, _f_path, _f_pos, field_options = field.deconstruct()\n blank = field_options.get(\"blank\", False)\n null = field_options.get(\"null\", False)\n max_length = field_options.get(\"max_length\")\n\n internal_type = field.get_internal_type()\n try:\n python_type = TYPES[internal_type]\n except KeyError as e:\n msg = [\n f\"Do not know how to convert django field '{internal_type}'.\",\n \"Try from ninja.orm import register_field\",\n f\"register_field('{internal_type}', )\",\n ]\n raise ConfigError(\"\\n\".join(msg)) from e\n\n if field.primary_key or blank or null or optional:\n default = None\n nullable = True\n\n if field.has_default():\n if callable(field.default):\n default_factory = field.default\n else:\n default = field.default\n\n if default_factory:\n default = PydanticUndefined\n\n if nullable:\n python_type = Union[python_type, None] # aka Optional in 3.7+\n\n description = field.help_text or None\n title = title_if_lower(field.verbose_name)\n\n return (\n python_type,\n FieldInfo(\n default=default,\n alias=alias,\n validation_alias=alias,\n serialization_alias=alias,\n default_factory=default_factory,\n title=title,\n description=description,\n max_length=max_length,\n ),\n )\n\n\n@no_type_check\ndef get_related_field_schema(field: DjangoField, *, depth: int) -> Tuple[OpenAPISchema]:\n from ninja.orm import create_schema\n\n model = field.related_model\n schema = create_schema(model, depth=depth - 1)\n default = ...\n if not field.concrete and field.auto_created or field.null:\n default = None\n if isinstance(field, ManyToManyField):\n schema = List[schema] # type: ignore\n\n return (\n schema,\n FieldInfo(\n default=default,\n description=field.help_text,\n title=title_if_lower(field.verbose_name),\n ),\n )\n"
},
{
"path": "ninja/orm/metaclass.py",
"content": "from typing import Any, List, Optional, Union, no_type_check\n\nfrom django.apps import apps\nfrom django.db.models import Model as DjangoModel\nfrom pydantic.dataclasses import dataclass\n\nfrom ninja.compatibility.util import get_annotations_from_namespace\nfrom ninja.errors import ConfigError\nfrom ninja.orm.factory import create_schema\nfrom ninja.schema import ResolverMetaclass, Schema\n\n_is_modelschema_class_defined = False\n\n\n@dataclass\nclass MetaConf:\n model: Any\n fields: Optional[List[str]] = None\n exclude: Union[List[str], str, None] = None\n fields_optional: Union[List[str], str, None] = None\n\n @staticmethod\n def from_schema_class(name: str, namespace: dict) -> \"MetaConf\":\n if \"Config\" in namespace:\n raise ConfigError( # pragma: no cover\n \"The use of `Config` class is removed for ModelSchema, use 'Meta' instead\",\n )\n if \"Meta\" in namespace:\n meta = namespace[\"Meta\"]\n model = meta.model\n if isinstance(model, str):\n try:\n app_label, model_name = model.split(\".\")\n except ValueError as e:\n raise ValueError(\n f\"Model string must be in format 'app_label.ModelName', got: {model}\"\n ) from e\n model = apps.get_model(app_label, model_name)\n fields = getattr(meta, \"fields\", None)\n exclude = getattr(meta, \"exclude\", None)\n optional_fields = getattr(meta, \"fields_optional\", None)\n\n else:\n raise ConfigError(f\"ModelSchema class '{name}' requires a 'Meta' subclass\")\n\n assert issubclass(model, DjangoModel)\n\n if not fields and not exclude:\n raise ConfigError(\n \"Creating a ModelSchema without either the 'fields' attribute\"\n \" or the 'exclude' attribute is prohibited\"\n )\n\n if fields == \"__all__\":\n fields = None\n # ^ when None is passed to create_schema - all fields are selected\n\n return MetaConf(\n model=model,\n fields=fields,\n exclude=exclude,\n fields_optional=optional_fields,\n )\n\n\nclass ModelSchemaMetaclass(ResolverMetaclass):\n @no_type_check\n def __new__(\n mcs,\n name: str,\n bases: tuple,\n namespace: dict,\n **kwargs,\n ):\n cls = super().__new__(\n mcs,\n name,\n bases,\n namespace,\n **kwargs,\n )\n for base in reversed(bases):\n if (\n _is_modelschema_class_defined\n and issubclass(base, ModelSchema)\n and base == ModelSchema\n ):\n meta_conf = MetaConf.from_schema_class(name, namespace)\n\n custom_fields = []\n annotations = get_annotations_from_namespace(namespace)\n for attr_name, type in annotations.items():\n if attr_name.startswith(\"_\"):\n continue\n default = namespace.get(attr_name, ...)\n custom_fields.append((attr_name, type, default))\n\n # # cls.__doc__ = namespace.get(\"__doc__\", config.model.__doc__)\n # cls.__fields__ = {} # forcing pydantic recreate\n # # assert False, \"!! cls.model_fields\"\n\n # print(config.model, name, fields, exclude, \"!!\")\n\n model_schema = create_schema(\n meta_conf.model,\n name=name,\n fields=meta_conf.fields,\n exclude=meta_conf.exclude,\n optional_fields=meta_conf.fields_optional,\n custom_fields=custom_fields,\n base_class=cls,\n )\n model_schema.__doc__ = cls.__doc__\n return model_schema\n\n return cls\n\n\nclass ModelSchema(Schema, metaclass=ModelSchemaMetaclass):\n pass\n\n\n_is_modelschema_class_defined = True\n"
},
{
"path": "ninja/orm/shortcuts.py",
"content": "from typing import Any, List, Type\n\nfrom ninja import Schema\nfrom ninja.orm.factory import create_schema\n\n__all__ = [\"S\", \"L\"]\n\n\n# GOAL:\n# from ninja.orm import S, L\n# S(Job) -> JobSchema? Job?\n# S(Job) -> should reuse already created schema\n# S(Job, fields='xxx') -> new schema ? how to name Job1 , 2, 3 and so on ?\n# L(Job) -> List[Job]\n\n\ndef S(model: Any, **kwargs: Any) -> Type[Schema]:\n return create_schema(model, **kwargs)\n\n\ndef L(model: Any, **kwargs: Any) -> List[Any]:\n schema = S(model, **kwargs)\n return List[schema] # type: ignore\n"
},
{
"path": "ninja/pagination.py",
"content": "import binascii\nimport inspect\nfrom abc import ABC, abstractmethod\nfrom base64 import b64decode, b64encode\nfrom functools import partial, wraps\nfrom math import inf\nfrom typing import (\n Any,\n AsyncGenerator,\n Callable,\n List,\n Optional,\n Tuple,\n Type,\n Union,\n)\nfrom urllib import parse\n\nfrom django.db.models import QuerySet\nfrom django.http import HttpRequest\nfrom django.utils.module_loading import import_string\nfrom pydantic import BaseModel, field_validator\nfrom typing_extensions import get_args as get_collection_args\n\nfrom ninja import Field, Query, Router, Schema\nfrom ninja.conf import settings\nfrom ninja.constants import NOT_SET\nfrom ninja.errors import ConfigError, ValidationError\nfrom ninja.operation import Operation\nfrom ninja.responses import Status\nfrom ninja.signature.details import is_collection_type\nfrom ninja.utils import (\n contribute_operation_args,\n contribute_operation_callback,\n is_async_callable,\n)\n\n\nclass PaginationBase(ABC):\n class Input(Schema):\n pass\n\n InputSource = Query(...)\n\n class Output(Schema):\n items: List[Any]\n count: int\n\n items_attribute: str = \"items\"\n\n def __init__(self, *, pass_parameter: Optional[str] = None, **kwargs: Any) -> None:\n self.pass_parameter = pass_parameter\n\n @abstractmethod\n def paginate_queryset(\n self,\n queryset: QuerySet,\n pagination: Any,\n request: HttpRequest,\n **params: Any,\n ) -> Any:\n pass # pragma: no cover\n\n def _items_count(self, queryset: QuerySet) -> int:\n \"\"\"\n Since lists are mainly compatible with QuerySets and can be passed to paginator.\n We will first to try to use .count - and if not there will use a len\n \"\"\"\n try:\n # forcing to find queryset.count instead of list.count:\n return queryset.all().count()\n except AttributeError:\n return len(queryset)\n\n\nclass AsyncPaginationBase(PaginationBase):\n @abstractmethod\n async def apaginate_queryset(\n self,\n queryset: QuerySet,\n pagination: Any,\n request: HttpRequest,\n **params: Any,\n ) -> Any:\n pass # pragma: no cover\n\n async def _aitems_count(self, queryset: QuerySet) -> int:\n try:\n return await queryset.all().acount()\n except AttributeError:\n return len(queryset)\n\n\nclass LimitOffsetPagination(AsyncPaginationBase):\n class Input(Schema):\n limit: int = Field(\n settings.PAGINATION_PER_PAGE,\n ge=1,\n le=(\n settings.PAGINATION_MAX_LIMIT\n if settings.PAGINATION_MAX_LIMIT != inf\n else None\n ),\n )\n offset: int = Field(0, ge=0)\n\n def paginate_queryset(\n self,\n queryset: QuerySet,\n pagination: Input,\n request: HttpRequest,\n **params: Any,\n ) -> Any:\n offset = pagination.offset\n limit: int = min(pagination.limit, settings.PAGINATION_MAX_LIMIT)\n return {\n self.items_attribute: queryset[offset : offset + limit],\n \"count\": self._items_count(queryset),\n } # noqa: E203\n\n async def apaginate_queryset(\n self,\n queryset: QuerySet,\n pagination: Input,\n request: HttpRequest,\n **params: Any,\n ) -> Any:\n offset = pagination.offset\n limit: int = min(pagination.limit, settings.PAGINATION_MAX_LIMIT)\n if isinstance(queryset, QuerySet):\n items = [obj async for obj in queryset[offset : offset + limit]]\n else:\n items = queryset[offset : offset + limit]\n return {\n self.items_attribute: items,\n \"count\": await self._aitems_count(queryset),\n } # noqa: E203\n\n\nclass PageNumberPagination(AsyncPaginationBase):\n class Input(Schema):\n page: int = Field(1, ge=1)\n page_size: Optional[int] = Field(None, ge=1)\n\n def __init__(\n self,\n page_size: int = settings.PAGINATION_PER_PAGE,\n max_page_size: int = settings.PAGINATION_MAX_PER_PAGE_SIZE,\n **kwargs: Any,\n ) -> None:\n self.page_size = page_size\n self.max_page_size = max_page_size\n super().__init__(**kwargs)\n\n def _get_page_size(self, requested_page_size: Optional[int]) -> int:\n if requested_page_size is None:\n return self.page_size\n\n return min(requested_page_size, self.max_page_size)\n\n def paginate_queryset(\n self,\n queryset: QuerySet,\n pagination: Input,\n request: HttpRequest,\n **params: Any,\n ) -> Any:\n page_size = self._get_page_size(pagination.page_size)\n offset = (pagination.page - 1) * page_size\n return {\n self.items_attribute: queryset[offset : offset + page_size],\n \"count\": self._items_count(queryset),\n } # noqa: E203\n\n async def apaginate_queryset(\n self,\n queryset: QuerySet,\n pagination: Input,\n request: HttpRequest,\n **params: Any,\n ) -> Any:\n page_size = self._get_page_size(pagination.page_size)\n offset = (pagination.page - 1) * page_size\n\n if isinstance(queryset, QuerySet):\n items = [obj async for obj in queryset[offset : offset + page_size]]\n else:\n items = queryset[offset : offset + page_size]\n\n return {\n self.items_attribute: items,\n \"count\": await self._aitems_count(queryset),\n } # noqa: E203\n\n\nclass CursorPagination(AsyncPaginationBase):\n max_page_size: int\n page_size: int\n\n items_attribute: str = \"results\"\n\n def __init__(\n self,\n *,\n ordering: Tuple[str, ...] = settings.PAGINATION_DEFAULT_ORDERING,\n page_size: int = settings.PAGINATION_PER_PAGE,\n max_page_size: int = settings.PAGINATION_MAX_PER_PAGE_SIZE,\n **kwargs: Any,\n ) -> None:\n self.ordering = ordering\n # take the first ordering parameter as the attribute for establishing\n # position\n self._order_attribute = (\n ordering[0][1:] if ordering[0].startswith(\"-\") else ordering[0]\n )\n self._order_attribute_reversed = ordering[0].startswith(\"-\")\n\n self.page_size = page_size\n self.max_page_size = max_page_size\n\n super().__init__(**kwargs)\n\n class Input(Schema):\n page_size: Optional[int] = None\n cursor: Optional[str] = None\n\n class Output(Schema):\n previous: Optional[str]\n next: Optional[str]\n results: List[Any]\n\n class Cursor(BaseModel):\n \"\"\"\n Represents pagination state.\n\n This is encoded in a base64 query parameter.\n\n \"\"\"\n\n p: Optional[str] = Field(\n default=None,\n title=\"position\",\n description=\"String identifier for the current position in the dataset\",\n )\n\n r: bool = Field(\n default=False,\n title=\"reverse\",\n description=\"Whether to reverse the ordering direction\",\n )\n\n # offset enables the use of a non-unique ordering field\n # e.g. if created time of two items is exactly the same, we can use the offset\n # to figure out the position exactly\n o: int = Field(\n default=0,\n ge=0,\n lt=settings.PAGINATION_MAX_OFFSET,\n title=\"offset\",\n description=\"Number of items to skip from the current position\",\n )\n\n @field_validator(\"*\", mode=\"before\")\n @classmethod\n def validate_individual_queryparam(cls, value: Any) -> Any:\n \"\"\"\n Handle query string parsing quirks where single values become lists.\n\n URL parsing libraries wrap single query parameters in lists, we only\n care about a single value\n \"\"\"\n if isinstance(value, list):\n return value[0]\n return value\n\n @classmethod\n def from_encoded_param(\n cls, encoded_param: Optional[str], context: Any = None\n ) -> \"CursorPagination.Cursor\":\n \"\"\"\n Deserialize cursor from URL-safe base64 token.\n \"\"\"\n if not encoded_param:\n return cls()\n try:\n decoded = b64decode(\n encoded_param.encode(\"ascii\"), validate=True\n ).decode(\"ascii\")\n except (ValueError, binascii.Error) as e:\n raise ValidationError([{\"cursor\": \"Invalid Cursor\"}]) from e\n\n parsed_querystring = parse.parse_qs(decoded, keep_blank_values=True)\n return cls.model_validate(parsed_querystring, context=context)\n\n def encode_as_param(self) -> str:\n \"\"\"\n Serialize cursor to URL-safe base64 token.\n \"\"\"\n data = self.model_dump(\n exclude_defaults=True, exclude_none=True, exclude_unset=True\n )\n query_string = parse.urlencode(data, doseq=True)\n return b64encode(query_string.encode(\"ascii\")).decode(\"ascii\")\n\n @staticmethod\n def _reverse_order(order: Tuple[str, ...]) -> Tuple[str, ...]:\n \"\"\"\n Flip ordering direction for backward pagination.\n\n Example:\n (\"-created\", \"pk\") becomes (\"created\", \"-pk\")\n (\"name\", \"-updated\") becomes (\"-name\", \"updated\")\n \"\"\"\n return tuple(\n marker[1:] if marker.startswith(\"-\") else f\"-{marker}\" for marker in order\n )\n\n def _get_position(self, item: Any) -> str:\n \"\"\"\n Extract the string representation of the attribute value used for ordering,\n which serves as the position identifier.\n\n \"\"\"\n return str(getattr(item, self._order_attribute))\n\n def _get_page_size(self, requested_page_size: Optional[int]) -> int:\n \"\"\"\n Determine the actual page size to use, respecting configured limits.\n\n Uses the default page size when no specific size is requested, otherwise\n clamps the requested size within the allowed range to prevent resource\n exhaustion attacks.\n \"\"\"\n if requested_page_size is None:\n return self.page_size\n return min(self.max_page_size, max(1, requested_page_size))\n\n def _build_next_cursor(\n self,\n current_cursor: Cursor,\n results: List[Any],\n additional_position: Optional[str] = None,\n ) -> Optional[Cursor]:\n \"\"\"\n Build cursor for next page\n \"\"\"\n if (additional_position is None and not current_cursor.r) or not results:\n return None\n\n if not current_cursor.r:\n # next position is provided by the additional position in a forward cursor\n next_position = additional_position\n else:\n # default to the last item\n # this will result in this item being included in the next set of results\n # when flipping from a reversed cursor query to a forward cursor query\n next_position = self._get_position(results[-1])\n\n offset = 0\n\n if current_cursor.p == next_position and not current_cursor.r:\n offset += current_cursor.o + len(results)\n else:\n # Count duplicates at page end to find the offset\n for item in reversed(results):\n item_position_value = self._get_position(item)\n if item_position_value != next_position:\n break\n offset += 1\n\n return self.Cursor(o=offset, r=False, p=next_position)\n\n def _build_previous_cursor(\n self,\n current_cursor: Cursor,\n results: List[Any],\n additional_position: Optional[str] = None,\n ) -> Optional[Cursor]:\n \"\"\"\n Build cursor for previous page\n \"\"\"\n if (\n current_cursor.r and additional_position is None\n ) or current_cursor.p is None:\n return None\n\n if not results:\n # End of dataset - create reverse cursor to go backward\n return self.Cursor(o=0, r=True, p=current_cursor.p)\n\n if current_cursor.r:\n # previous position is provided by the additional position in a\n # reversed cursor\n previous_position = additional_position\n\n else:\n # default to the first item\n # this will result in this item being included in the previous set of\n # results when flipping from a forward cursor query to a reversed\n # cursor query\n previous_position = self._get_position(results[0])\n\n offset = 0\n\n if current_cursor.p == previous_position and current_cursor.r:\n offset += current_cursor.o + len(results)\n else:\n # Count duplicates at page end to find the offset\n for item in results:\n item_position_value = self._get_position(item)\n if item_position_value != previous_position:\n break\n offset += 1\n\n return self.Cursor(o=offset, r=True, p=previous_position)\n\n @staticmethod\n def _add_cursor_to_URL(url: str, cursor: Optional[Cursor]) -> Optional[str]:\n \"\"\"\n Build pagination URLs with an encoded cursor.\n\n Ignore any previous cursors but preserve any other query parameters\n\n Example:\n Given URL \"https://api.example.com/pages?tag=hiring\" and a cursor\n with position \"2024-01-01T10:00:00Z\", returns:\n \"https://api.example.com/pages?cursor=cD0yMDI0LTAxLTAxVDEwJTNBMDA%3D&tag=hiring\"\n \"\"\"\n\n if cursor is None:\n return None\n (scheme, netloc, path, query, fragment) = parse.urlsplit(url)\n query_dict = parse.parse_qs(query, keep_blank_values=True)\n query_dict[\"cursor\"] = [cursor.encode_as_param()]\n query = parse.urlencode(sorted(query_dict.items()), doseq=True)\n return parse.urlunsplit((scheme, netloc, path, query, fragment))\n\n def _order_queryset(self, queryset: QuerySet, cursor: Cursor) -> QuerySet:\n \"\"\"\n Apply ordering to queryset based on cursor direction.\n\n For backward pagination (cursor.r=True), flips the ordering direction\n to traverse the dataset in reverse.\n \"\"\"\n if cursor.r:\n return queryset.order_by(*self._reverse_order(self.ordering))\n\n return queryset.order_by(*self.ordering)\n\n def _find_position(self, queryset: QuerySet, cursor: Cursor) -> QuerySet:\n \"\"\"\n Filter queryset to start from the cursor position.\n \"\"\"\n if cursor.p is None:\n return queryset\n\n cmp = \"gte\" if cursor.r == self._order_attribute_reversed else \"lte\"\n filters = {f\"{self._order_attribute}__{cmp}\": cursor.p}\n return queryset.filter(**filters)\n\n def paginate_queryset(\n self, queryset: QuerySet, pagination: Input, request: HttpRequest, **params: Any\n ) -> Any:\n \"\"\"\n Execute cursor-based pagination with stable positioning.\n\n We fetch page_size + 1 items to detect whether more pages exist without\n requiring a separate count query. The extra item is discarded from results\n but used for next/previous cursor generation.\n \"\"\"\n page_size = self._get_page_size(pagination.page_size)\n cursor = self.Cursor.from_encoded_param(pagination.cursor)\n\n queryset = self._order_queryset(queryset, cursor)\n queryset = self._find_position(queryset, cursor)\n\n # fetch results here and turn into a list\n results_plus_one = list(queryset[cursor.o : cursor.o + page_size + 1])\n additional_position = (\n self._get_position(results_plus_one[-1])\n if len(results_plus_one) > page_size\n else None\n )\n\n if cursor.r:\n results = list(reversed(results_plus_one[:page_size]))\n else:\n results = results_plus_one[:page_size]\n\n next_cursor = self._build_next_cursor(\n current_cursor=cursor,\n results=results,\n additional_position=additional_position,\n )\n\n previous_cursor = self._build_previous_cursor(\n current_cursor=cursor,\n results=results,\n additional_position=additional_position,\n )\n\n base_url = request.build_absolute_uri()\n\n return {\n \"next\": self._add_cursor_to_URL(base_url, next_cursor),\n \"previous\": self._add_cursor_to_URL(base_url, previous_cursor),\n self.items_attribute: results,\n }\n\n async def apaginate_queryset(\n self,\n queryset: QuerySet,\n pagination: Input,\n request: HttpRequest,\n **params: Any,\n ) -> Any:\n \"\"\"\n Execute async cursor-based pagination with stable positioning.\n\n We fetch page_size + 1 items to detect whether more pages exist without\n requiring a separate count query. The extra item is discarded from results\n but used for next/previous cursor generation.\n \"\"\"\n page_size = self._get_page_size(pagination.page_size)\n cursor = self.Cursor.from_encoded_param(pagination.cursor)\n\n queryset = self._order_queryset(queryset, cursor)\n queryset = self._find_position(queryset, cursor)\n\n # fetch results here and turn into a list\n results_plus_one = [\n obj async for obj in queryset[cursor.o : cursor.o + page_size + 1]\n ]\n additional_position = (\n self._get_position(results_plus_one[-1])\n if len(results_plus_one) > page_size\n else None\n )\n\n if cursor.r:\n results = list(reversed(results_plus_one[:page_size]))\n else:\n results = results_plus_one[:page_size]\n\n next_cursor = self._build_next_cursor(\n current_cursor=cursor,\n results=results,\n additional_position=additional_position,\n )\n\n previous_cursor = self._build_previous_cursor(\n current_cursor=cursor,\n results=results,\n additional_position=additional_position,\n )\n\n base_url = request.build_absolute_uri()\n\n return {\n \"next\": self._add_cursor_to_URL(base_url, next_cursor),\n \"previous\": self._add_cursor_to_URL(base_url, previous_cursor),\n self.items_attribute: results,\n }\n\n\ndef paginate(\n func_or_pgn_class: Any = NOT_SET, **paginator_params: Any\n) -> Callable[..., Any]:\n \"\"\"\n @api.get(...\n @paginate\n def my_view(request):\n\n or\n\n @api.get(...\n @paginate(PageNumberPagination)\n def my_view(request):\n\n \"\"\"\n\n isfunction = inspect.isfunction(func_or_pgn_class)\n isnotset = func_or_pgn_class == NOT_SET\n\n pagination_class: Type[Union[PaginationBase, AsyncPaginationBase]] = import_string(\n settings.PAGINATION_CLASS\n )\n\n if isfunction:\n return _inject_pagination(func_or_pgn_class, pagination_class)\n\n if not isnotset:\n pagination_class = func_or_pgn_class\n\n def wrapper(func: Callable[..., Any]) -> Any:\n return _inject_pagination(func, pagination_class, **paginator_params)\n\n return wrapper\n\n\ndef _inject_pagination(\n func: Callable[..., Any],\n paginator_class: Type[Union[PaginationBase, AsyncPaginationBase]],\n **paginator_params: Any,\n) -> Callable[..., Any]:\n if getattr(func, \"_ninja_is_paginated\", False):\n return func # ^ user changed pagination manually on function already\n\n paginator = paginator_class(**paginator_params)\n\n # Check if Input schema has any fields\n # If it has no fields, we should make it optional to support Pydantic 2.12+\n has_input_fields = bool(paginator.Input.model_fields)\n\n if is_async_callable(func):\n if not hasattr(paginator, \"apaginate_queryset\"):\n raise ConfigError(\"Pagination class not configured for async requests\")\n\n @wraps(func)\n async def view_with_pagination(request: HttpRequest, **kwargs: Any) -> Any:\n pagination_params = kwargs.pop(\"ninja_pagination\", None)\n if pagination_params is None:\n pagination_params = paginator.Input()\n if paginator.pass_parameter:\n kwargs[paginator.pass_parameter] = pagination_params\n\n items = await func(request, **kwargs)\n\n status_code = None\n if isinstance(items, Status):\n status_code = items.status_code\n items = items.value\n\n result = await paginator.apaginate_queryset(\n items, pagination=pagination_params, request=request, **kwargs\n )\n\n async def evaluate(results: Union[List, QuerySet]) -> AsyncGenerator:\n for result in results:\n yield result\n\n if paginator.Output: # type: ignore\n result[paginator.items_attribute] = [\n result\n async for result in evaluate(result[paginator.items_attribute])\n ]\n\n if status_code is not None:\n return Status(status_code, result)\n return result\n\n else:\n\n @wraps(func)\n def view_with_pagination(request: HttpRequest, **kwargs: Any) -> Any:\n pagination_params = kwargs.pop(\"ninja_pagination\", None)\n if pagination_params is None:\n pagination_params = paginator.Input()\n if paginator.pass_parameter:\n kwargs[paginator.pass_parameter] = pagination_params\n\n items = func(request, **kwargs)\n\n status_code = None\n if isinstance(items, Status):\n status_code = items.status_code\n items = items.value\n\n result = paginator.paginate_queryset(\n items, pagination=pagination_params, request=request, **kwargs\n )\n if paginator.Output: # type: ignore\n result[paginator.items_attribute] = list(\n result[paginator.items_attribute]\n )\n # ^ forcing queryset evaluation #TODO: check why pydantic did not do it here\n\n if status_code is not None:\n return Status(status_code, result)\n return result\n\n # Only contribute args if Input has fields\n # For empty Input schemas, don't add the parameter at all to support Pydantic 2.12+\n if has_input_fields:\n contribute_operation_args(\n view_with_pagination,\n \"ninja_pagination\",\n paginator.Input,\n paginator.InputSource,\n )\n\n if paginator.Output: # type: ignore\n contribute_operation_callback(\n view_with_pagination,\n partial(make_response_paginated, paginator),\n )\n\n view_with_pagination._ninja_is_paginated = True # type: ignore\n return view_with_pagination\n\n\nclass RouterPaginated(Router):\n def __init__(self, *args: Any, **kwargs: Any) -> None:\n super().__init__(*args, **kwargs)\n self.pagination_class = import_string(settings.PAGINATION_CLASS)\n\n def add_api_operation(\n self,\n path: str,\n methods: List[str],\n view_func: Callable[..., Any],\n **kwargs: Any,\n ) -> None:\n response = kwargs[\"response\"]\n if is_collection_type(response):\n view_func = _inject_pagination(view_func, self.pagination_class)\n return super().add_api_operation(path, methods, view_func, **kwargs)\n\n\ndef make_response_paginated(paginator: PaginationBase, op: Operation) -> None:\n \"\"\"\n Takes operation response and changes it to the paginated response\n for example:\n response=List[Some]\n will be changed to:\n response=PagedSome\n where Paged some will be a subclass of paginator.Output:\n class PagedSome:\n items: List[Some]\n count: int\n \"\"\"\n status_code, item_schema = _find_collection_response(op)\n\n # Switching schema to Output schema\n try:\n new_name = f\"Paged{item_schema.__name__}\"\n except AttributeError: # pragma: no cover\n # special case for `typing.Any`, only raised for Python < 3.10\n new_name = f\"Paged{str(item_schema).replace('.', '_')}\" # pragma: no cover\n new_schema = type(\n new_name,\n (paginator.Output,),\n {\n \"__annotations__\": {paginator.items_attribute: List[item_schema]}, # type: ignore\n },\n ) # typing: ignore\n\n response = op._create_response_model(new_schema)\n\n # Changing response model to newly created one\n op.response_models[status_code] = response\n\n\ndef _find_collection_response(op: Operation) -> Tuple[int, Any]:\n \"\"\"\n Walks through defined operation responses and finds the first\n that is of a collection type (e.g. List[SomeSchema])\n \"\"\"\n for code, resp_model in op.response_models.items():\n if resp_model is None or resp_model is NOT_SET:\n continue\n\n model = resp_model.__annotations__[\"response\"]\n if is_collection_type(model):\n item_schema = get_collection_args(model)[0]\n return code, item_schema\n\n raise ConfigError(\n f'\"{op.view_func}\" has no collection response (e.g. response=List[SomeSchema])'\n )\n"
},
{
"path": "ninja/params/__init__.py",
"content": "from typing import TYPE_CHECKING, Any, Callable, Dict, Optional, Pattern, TypeVar, Union\n\nfrom typing_extensions import Annotated\n\nfrom ninja.params import functions as param_functions\n\n__all__ = [\n \"Body\",\n \"Cookie\",\n \"File\",\n \"Form\",\n \"Header\",\n \"Path\",\n \"Query\",\n \"BodyEx\",\n \"CookieEx\",\n \"FileEx\",\n \"FormEx\",\n \"HeaderEx\",\n \"PathEx\",\n \"QueryEx\",\n \"P\",\n]\n\n\nclass ParamShortcut:\n def __init__(self, base_func: Callable[..., Any]) -> None:\n self._base_func = base_func\n\n def __call__(self, *args: Any, **kwargs: Any) -> Any:\n return self._base_func(*args, **kwargs)\n\n def __getitem__(self, args: Any) -> Any:\n if isinstance(args, tuple):\n return Annotated[args[0], self._base_func(**args[1])]\n return Annotated[args, self._base_func()]\n\n\nif TYPE_CHECKING: # pragma: nocover\n # mypy cheats\n T = TypeVar(\"T\")\n Body = Annotated[T, param_functions.Body()]\n Cookie = Annotated[T, param_functions.Cookie()]\n File = Annotated[T, param_functions.File()]\n Form = Annotated[T, param_functions.Form()]\n Header = Annotated[T, param_functions.Header()]\n Path = Annotated[T, param_functions.Path()]\n Query = Annotated[T, param_functions.Query()]\n # mypy does not like to extend already annotated params\n # with extra annotation (so need to cheat with these XXX-Ex types):\n from typing_extensions import Annotated as BodyEx\n from typing_extensions import Annotated as CookieEx\n from typing_extensions import Annotated as FileEx\n from typing_extensions import Annotated as FormEx\n from typing_extensions import Annotated as HeaderEx\n from typing_extensions import Annotated as PathEx\n from typing_extensions import Annotated as QueryEx\nelse:\n Body = ParamShortcut(param_functions.Body)\n Cookie = ParamShortcut(param_functions.Cookie)\n File = ParamShortcut(param_functions.File)\n Form = ParamShortcut(param_functions.Form)\n Header = ParamShortcut(param_functions.Header)\n Path = ParamShortcut(param_functions.Path)\n Query = ParamShortcut(param_functions.Query)\n # mypy does not like to extend already annotated params\n # with extra annotation (so need to cheat with these XXX-Ex types):\n BodyEx = Body\n CookieEx = Cookie\n FileEx = File\n FormEx = Form\n HeaderEx = Header\n PathEx = Path\n QueryEx = Query\n\n\ndef P(\n *,\n alias: Optional[str] = None,\n title: Optional[str] = None,\n description: Optional[str] = None,\n gt: Optional[float] = None,\n ge: Optional[float] = None,\n lt: Optional[float] = None,\n le: Optional[float] = None,\n min_length: Optional[int] = None,\n max_length: Optional[int] = None,\n pattern: Union[str, Pattern[str], None] = None,\n example: Any = None,\n examples: Optional[Dict[str, Any]] = None,\n deprecated: Optional[bool] = None,\n include_in_schema: bool = True,\n **extra: Any,\n) -> Dict[str, Any]:\n \"Arguments for BodyEx, QueryEx, etc.\"\n return dict(\n alias=alias,\n title=title,\n description=description,\n gt=gt,\n ge=ge,\n lt=lt,\n le=le,\n min_length=min_length,\n max_length=max_length,\n pattern=pattern,\n example=example,\n examples=examples,\n deprecated=deprecated,\n include_in_schema=include_in_schema,\n **extra,\n )\n"
},
{
"path": "ninja/params/functions.py",
"content": "# Yeah, this is a bit strange\n# but the whole point of this module is to make mypy and typehints happy\n# what it basically does makes function XXX that create instance of models.XXX\n# and annotates function with result = Any\n# idea from https://github.com/tiangolo/fastapi/blob/master/fastapi/param_functions.py\nfrom typing import Any, Dict, Optional, Pattern, Union\n\nfrom ninja.params import models\n\n\ndef Path( # noqa: N802\n default: Any = ...,\n *,\n alias: Optional[str] = None,\n title: Optional[str] = None,\n description: Optional[str] = None,\n gt: Optional[float] = None,\n ge: Optional[float] = None,\n lt: Optional[float] = None,\n le: Optional[float] = None,\n min_length: Optional[int] = None,\n max_length: Optional[int] = None,\n pattern: Union[str, Pattern[str], None] = None,\n example: Any = None,\n examples: Optional[Dict[str, Any]] = None,\n deprecated: Optional[bool] = None,\n include_in_schema: bool = True,\n **extra: Any,\n) -> Any:\n return models.Path(\n default,\n alias=alias,\n title=title,\n description=description,\n gt=gt,\n ge=ge,\n lt=lt,\n le=le,\n min_length=min_length,\n max_length=max_length,\n pattern=pattern,\n example=example,\n examples=examples,\n deprecated=deprecated,\n include_in_schema=include_in_schema,\n **extra,\n )\n\n\ndef Query( # noqa: N802\n default: Any = ...,\n *,\n alias: Optional[str] = None,\n title: Optional[str] = None,\n description: Optional[str] = None,\n gt: Optional[float] = None,\n ge: Optional[float] = None,\n lt: Optional[float] = None,\n le: Optional[float] = None,\n min_length: Optional[int] = None,\n max_length: Optional[int] = None,\n pattern: Union[str, Pattern[str], None] = None,\n example: Any = None,\n examples: Optional[Dict[str, Any]] = None,\n deprecated: Optional[bool] = None,\n include_in_schema: bool = True,\n **extra: Any,\n) -> Any:\n return models.Query(\n default,\n alias=alias,\n title=title,\n description=description,\n gt=gt,\n ge=ge,\n lt=lt,\n le=le,\n min_length=min_length,\n max_length=max_length,\n pattern=pattern,\n example=example,\n examples=examples,\n deprecated=deprecated,\n include_in_schema=include_in_schema,\n **extra,\n )\n\n\ndef Header( # noqa: N802\n default: Any = ...,\n *,\n alias: Optional[str] = None,\n title: Optional[str] = None,\n description: Optional[str] = None,\n gt: Optional[float] = None,\n ge: Optional[float] = None,\n lt: Optional[float] = None,\n le: Optional[float] = None,\n min_length: Optional[int] = None,\n max_length: Optional[int] = None,\n pattern: Union[str, Pattern[str], None] = None,\n example: Any = None,\n examples: Optional[Dict[str, Any]] = None,\n deprecated: Optional[bool] = None,\n include_in_schema: bool = True,\n **extra: Any,\n) -> Any:\n return models.Header(\n default,\n alias=alias,\n title=title,\n description=description,\n gt=gt,\n ge=ge,\n lt=lt,\n le=le,\n min_length=min_length,\n max_length=max_length,\n pattern=pattern,\n example=example,\n examples=examples,\n deprecated=deprecated,\n include_in_schema=include_in_schema,\n **extra,\n )\n\n\ndef Cookie( # noqa: N802\n default: Any = ...,\n *,\n alias: Optional[str] = None,\n title: Optional[str] = None,\n description: Optional[str] = None,\n gt: Optional[float] = None,\n ge: Optional[float] = None,\n lt: Optional[float] = None,\n le: Optional[float] = None,\n min_length: Optional[int] = None,\n max_length: Optional[int] = None,\n pattern: Union[str, Pattern[str], None] = None,\n example: Any = None,\n examples: Optional[Dict[str, Any]] = None,\n deprecated: Optional[bool] = None,\n include_in_schema: bool = True,\n **extra: Any,\n) -> Any:\n return models.Cookie(\n default,\n alias=alias,\n title=title,\n description=description,\n gt=gt,\n ge=ge,\n lt=lt,\n le=le,\n min_length=min_length,\n max_length=max_length,\n pattern=pattern,\n example=example,\n examples=examples,\n deprecated=deprecated,\n include_in_schema=include_in_schema,\n **extra,\n )\n\n\ndef Body( # noqa: N802\n default: Any = ...,\n *,\n alias: Optional[str] = None,\n title: Optional[str] = None,\n description: Optional[str] = None,\n gt: Optional[float] = None,\n ge: Optional[float] = None,\n lt: Optional[float] = None,\n le: Optional[float] = None,\n min_length: Optional[int] = None,\n max_length: Optional[int] = None,\n pattern: Union[str, Pattern[str], None] = None,\n example: Any = None,\n examples: Optional[Dict[str, Any]] = None,\n deprecated: Optional[bool] = None,\n include_in_schema: bool = True,\n **extra: Any,\n) -> Any:\n return models.Body(\n default,\n alias=alias,\n title=title,\n description=description,\n gt=gt,\n ge=ge,\n lt=lt,\n le=le,\n min_length=min_length,\n max_length=max_length,\n pattern=pattern,\n example=example,\n examples=examples,\n deprecated=deprecated,\n include_in_schema=include_in_schema,\n **extra,\n )\n\n\ndef Form( # noqa: N802\n default: Any = ...,\n *,\n alias: Optional[str] = None,\n title: Optional[str] = None,\n description: Optional[str] = None,\n gt: Optional[float] = None,\n ge: Optional[float] = None,\n lt: Optional[float] = None,\n le: Optional[float] = None,\n min_length: Optional[int] = None,\n max_length: Optional[int] = None,\n pattern: Union[str, Pattern[str], None] = None,\n example: Any = None,\n examples: Optional[Dict[str, Any]] = None,\n deprecated: Optional[bool] = None,\n include_in_schema: bool = True,\n **extra: Any,\n) -> Any:\n return models.Form(\n default,\n alias=alias,\n title=title,\n description=description,\n gt=gt,\n ge=ge,\n lt=lt,\n le=le,\n min_length=min_length,\n max_length=max_length,\n pattern=pattern,\n example=example,\n examples=examples,\n deprecated=deprecated,\n include_in_schema=include_in_schema,\n **extra,\n )\n\n\ndef File( # noqa: N802\n default: Any = ...,\n *,\n alias: Optional[str] = None,\n title: Optional[str] = None,\n description: Optional[str] = None,\n gt: Optional[float] = None,\n ge: Optional[float] = None,\n lt: Optional[float] = None,\n le: Optional[float] = None,\n min_length: Optional[int] = None,\n max_length: Optional[int] = None,\n pattern: Union[str, Pattern[str], None] = None,\n example: Any = None,\n examples: Optional[Dict[str, Any]] = None,\n deprecated: Optional[bool] = None,\n include_in_schema: bool = True,\n **extra: Any,\n) -> Any:\n return models.File(\n default,\n alias=alias,\n title=title,\n description=description,\n gt=gt,\n ge=ge,\n lt=lt,\n le=le,\n min_length=min_length,\n max_length=max_length,\n pattern=pattern,\n example=example,\n examples=examples,\n deprecated=deprecated,\n include_in_schema=include_in_schema,\n **extra,\n )\n"
},
{
"path": "ninja/params/models.py",
"content": "from abc import ABC, abstractmethod\nfrom typing import (\n TYPE_CHECKING,\n Any,\n Dict,\n List,\n Optional,\n Pattern,\n Tuple,\n Type,\n TypeVar,\n Union,\n)\n\nfrom django.conf import settings\nfrom django.http import HttpRequest\nfrom pydantic import BaseModel\nfrom pydantic.fields import FieldInfo\n\nfrom ninja.errors import HttpError\nfrom ninja.types import DictStrAny\n\nif TYPE_CHECKING:\n from ninja import NinjaAPI # pragma: no cover\n\n__all__ = [\n \"ParamModel\",\n \"QueryModel\",\n \"PathModel\",\n \"HeaderModel\",\n \"CookieModel\",\n \"BodyModel\",\n \"FormModel\",\n \"FileModel\",\n]\n\nTModel = TypeVar(\"TModel\", bound=\"ParamModel\")\nTModels = List[TModel]\n\n\nclass ParamModel(BaseModel, ABC):\n __ninja_param_source__ = None\n\n @classmethod\n @abstractmethod\n def get_request_data(\n cls, request: HttpRequest, api: \"NinjaAPI\", path_params: DictStrAny\n ) -> Optional[DictStrAny]:\n pass # pragma: no cover\n\n @classmethod\n def resolve(\n cls: Type[TModel],\n request: HttpRequest,\n api: \"NinjaAPI\",\n path_params: DictStrAny,\n ) -> TModel:\n data = cls.get_request_data(request, api, path_params)\n if data is None:\n return cls()\n\n data = cls._map_data_paths(data)\n return cls.model_validate(data, context={\"request\": request})\n\n @classmethod\n def _map_data_paths(cls, data: DictStrAny) -> DictStrAny:\n flatten_map = getattr(cls, \"__ninja_flatten_map__\", None)\n if not flatten_map:\n return data\n\n mapped_data: DictStrAny = {}\n for key, path in flatten_map.items():\n cls._map_data_path(mapped_data, data.get(key), path)\n return mapped_data\n\n @classmethod\n def _map_data_path(\n cls, data: DictStrAny, value: Any, path: Tuple[str, ...]\n ) -> None:\n current = data\n for key in path[:-1]:\n current = current.setdefault(key, {})\n if value is not None:\n current[path[-1]] = value\n\n\nclass QueryModel(ParamModel):\n @classmethod\n def get_request_data(\n cls, request: HttpRequest, api: \"NinjaAPI\", path_params: DictStrAny\n ) -> Optional[DictStrAny]:\n list_fields = getattr(cls, \"__ninja_collection_fields__\", [])\n return api.parser.parse_querydict(request.GET, list_fields, request)\n\n\nclass PathModel(ParamModel):\n @classmethod\n def get_request_data(\n cls, request: HttpRequest, api: \"NinjaAPI\", path_params: DictStrAny\n ) -> Optional[DictStrAny]:\n return path_params\n\n\nclass HeaderModel(ParamModel):\n __ninja_flatten_map__: DictStrAny\n\n @classmethod\n def get_request_data(\n cls, request: HttpRequest, api: \"NinjaAPI\", path_params: DictStrAny\n ) -> Optional[DictStrAny]:\n data = {}\n headers = request.headers\n for name in cls.__ninja_flatten_map__:\n if name in headers:\n data[name] = headers[name]\n return data\n\n\nclass CookieModel(ParamModel):\n @classmethod\n def get_request_data(\n cls, request: HttpRequest, api: \"NinjaAPI\", path_params: DictStrAny\n ) -> Optional[DictStrAny]:\n return request.COOKIES\n\n\nclass BodyModel(ParamModel):\n __read_from_single_attr__: str\n\n @classmethod\n def get_request_data(\n cls, request: HttpRequest, api: \"NinjaAPI\", path_params: DictStrAny\n ) -> Optional[DictStrAny]:\n if request.body:\n try:\n data = api.parser.parse_body(request)\n except Exception as e:\n msg = \"Cannot parse request body\"\n if settings.DEBUG:\n msg += f\" ({e})\"\n raise HttpError(400, msg) from e\n\n varname = getattr(cls, \"__read_from_single_attr__\", None)\n if varname:\n data = {varname: data}\n return data\n\n return None\n\n\nclass FormModel(ParamModel):\n @classmethod\n def get_request_data(\n cls, request: HttpRequest, api: \"NinjaAPI\", path_params: DictStrAny\n ) -> Optional[DictStrAny]:\n list_fields = getattr(cls, \"__ninja_collection_fields__\", [])\n return api.parser.parse_querydict(request.POST, list_fields, request)\n\n\nclass FileModel(ParamModel):\n @classmethod\n def get_request_data(\n cls, request: HttpRequest, api: \"NinjaAPI\", path_params: DictStrAny\n ) -> Optional[DictStrAny]:\n list_fields = getattr(cls, \"__ninja_collection_fields__\", [])\n return api.parser.parse_querydict(request.FILES, list_fields, request)\n\n\nclass _HttpRequest(HttpRequest):\n body: bytes = b\"\"\n\n\nclass _MultiPartBodyModel(BodyModel):\n __ninja_body_params__: DictStrAny\n\n @classmethod\n def get_request_data(\n cls, request: HttpRequest, api: \"NinjaAPI\", path_params: DictStrAny\n ) -> Optional[DictStrAny]:\n req = _HttpRequest()\n get_request_data = super().get_request_data\n results: DictStrAny = {}\n for name, annotation in cls.__ninja_body_params__.items():\n if name in request.POST:\n data = request.POST[name]\n if annotation is str and data[0] != '\"' and data[-1] != '\"':\n data = f'\"{data}\"'\n req.body = data.encode()\n results[name] = get_request_data(req, api, path_params)\n return results\n\n\nclass Param(FieldInfo): # type: ignore[misc]\n def __init__(\n self,\n default: Any,\n *,\n alias: Optional[str] = None,\n title: Optional[str] = None,\n description: Optional[str] = None,\n gt: Optional[float] = None,\n ge: Optional[float] = None,\n lt: Optional[float] = None,\n le: Optional[float] = None,\n min_length: Optional[int] = None,\n max_length: Optional[int] = None,\n example: Optional[Any] = None,\n examples: Optional[Dict[str, Any]] = None,\n deprecated: Optional[bool] = None,\n include_in_schema: Optional[bool] = True,\n pattern: Union[str, Pattern[str], None] = None,\n # param_name: str = None,\n # param_type: Any = None,\n **extra: Any,\n ):\n self.deprecated = deprecated\n # self.param_name: str = None\n # self.param_type: Any = None\n self.model_field: Optional[FieldInfo] = None\n json_schema_extra = {}\n if example:\n json_schema_extra[\"example\"] = example\n if examples:\n json_schema_extra[\"examples\"] = examples\n if deprecated:\n json_schema_extra[\"deprecated\"] = deprecated\n if not include_in_schema:\n json_schema_extra[\"include_in_schema\"] = include_in_schema\n if alias and not extra.get(\"validation_alias\"):\n extra[\"validation_alias\"] = alias\n if alias and not extra.get(\"serialization_alias\"):\n extra[\"serialization_alias\"] = alias\n\n super().__init__(\n default=default,\n alias=alias,\n title=title,\n description=description,\n gt=gt,\n ge=ge,\n lt=lt,\n le=le,\n min_length=min_length,\n max_length=max_length,\n pattern=pattern,\n json_schema_extra=json_schema_extra,\n **extra,\n )\n\n @classmethod\n def _param_source(cls) -> str:\n \"Openapi param.in value or body type\"\n return cls.__name__.lower()\n\n\nclass Path(Param): # type: ignore[misc]\n _model = PathModel\n\n\nclass Query(Param): # type: ignore[misc]\n _model = QueryModel\n\n\nclass Header(Param): # type: ignore[misc]\n _model = HeaderModel\n\n\nclass Cookie(Param): # type: ignore[misc]\n _model = CookieModel\n\n\nclass Body(Param): # type: ignore[misc]\n _model = BodyModel\n\n\nclass Form(Param): # type: ignore[misc]\n _model = FormModel\n\n\nclass File(Param): # type: ignore[misc]\n _model = FileModel\n\n\nclass _MultiPartBody(Param): # type: ignore[misc]\n _model = _MultiPartBodyModel\n\n @classmethod\n def _param_source(cls) -> str:\n return \"body\"\n"
},
{
"path": "ninja/parser.py",
"content": "import json\nfrom typing import List, cast\n\nfrom django.http import HttpRequest\nfrom django.utils.datastructures import MultiValueDict\n\nfrom ninja.types import DictStrAny\n\n__all__ = [\"Parser\"]\n\n\nclass Parser:\n \"Default json parser\"\n\n def parse_body(self, request: HttpRequest) -> DictStrAny:\n return cast(DictStrAny, json.loads(request.body))\n\n def parse_querydict(\n self, data: MultiValueDict, list_fields: List[str], request: HttpRequest\n ) -> DictStrAny:\n result: DictStrAny = {}\n for key in data.keys():\n if key in list_fields:\n result[key] = data.getlist(key)\n else:\n result[key] = data[key]\n return result\n"
},
{
"path": "ninja/patch_dict.py",
"content": "from typing import (\n TYPE_CHECKING,\n Any,\n Dict,\n Generic,\n Optional,\n Type,\n TypeVar,\n)\n\nfrom pydantic import BaseModel\nfrom pydantic_core import core_schema\n\nfrom ninja import Body\nfrom ninja.orm import ModelSchema\nfrom ninja.schema import Schema\nfrom ninja.utils import is_optional_type\n\n\nclass ModelToDict(dict):\n _wrapped_model: Any = None\n _wrapped_model_dump_params: Dict[str, Any] = {}\n\n @classmethod\n def __get_pydantic_core_schema__(cls, _source: Any, _handler: Any) -> Any:\n return core_schema.no_info_after_validator_function(\n cls._validate,\n cls._wrapped_model.__pydantic_core_schema__,\n )\n\n @classmethod\n def _validate(cls, input_value: Any) -> Any:\n return input_value.model_dump(**cls._wrapped_model_dump_params)\n\n\ndef get_schema_annotations(schema_cls: Type[Any]) -> Dict[str, Any]:\n annotations: Dict[str, Any] = {}\n excluded_bases = {Schema, ModelSchema, BaseModel}\n bases = schema_cls.mro()[:-1]\n final_bases = reversed([b for b in bases if b not in excluded_bases])\n\n for base in final_bases:\n annotations.update(getattr(base, \"__annotations__\", {}))\n\n return annotations\n\n\ndef create_patch_schema(schema_cls: Type[Any]) -> Type[ModelToDict]:\n schema_annotations = get_schema_annotations(schema_cls)\n values, annotations = {}, {}\n # assert False, f\"{schema_cls} - {schema_cls.model_fields}\"\n for f in schema_cls.model_fields.keys():\n t = schema_annotations[f]\n if not is_optional_type(t):\n values[f] = getattr(schema_cls, f, None)\n annotations[f] = Optional[t]\n values[\"__annotations__\"] = annotations\n OptionalSchema = type(f\"{schema_cls.__name__}Patch\", (schema_cls,), values)\n\n class OptionalDictSchema(ModelToDict):\n _wrapped_model = OptionalSchema\n _wrapped_model_dump_params = {\"exclude_unset\": True}\n\n return OptionalDictSchema\n\n\nclass PatchDictUtil:\n def __getitem__(self, schema_cls: Any) -> Any:\n new_cls = create_patch_schema(schema_cls)\n return Body[new_cls] # type: ignore\n\n\nif TYPE_CHECKING: # pragma: nocover\n T = TypeVar(\"T\")\n\n class PatchDict(Dict[Any, Any], Generic[T]):\n pass\n\nelse:\n PatchDict = PatchDictUtil()\n"
},
{
"path": "ninja/py.typed",
"content": "\n"
},
{
"path": "ninja/renderers.py",
"content": "import json\nfrom typing import Any, Mapping, Optional, Type\n\nfrom django.http import HttpRequest\n\nfrom ninja.responses import NinjaJSONEncoder\n\n__all__ = [\"BaseRenderer\", \"JSONRenderer\"]\n\n\nclass BaseRenderer:\n media_type: Optional[str] = None\n charset: str = \"utf-8\"\n\n def render(self, request: HttpRequest, data: Any, *, response_status: int) -> Any:\n raise NotImplementedError(\"Please implement .render() method\")\n\n\nclass JSONRenderer(BaseRenderer):\n media_type = \"application/json\"\n encoder_class: Type[json.JSONEncoder] = NinjaJSONEncoder\n json_dumps_params: Mapping[str, Any] = {}\n\n def render(self, request: HttpRequest, data: Any, *, response_status: int) -> Any:\n return json.dumps(data, cls=self.encoder_class, **self.json_dumps_params)\n"
},
{
"path": "ninja/responses.py",
"content": "from enum import Enum\nfrom ipaddress import IPv4Address, IPv4Network, IPv6Address, IPv6Network\nfrom typing import Any, FrozenSet, Generic, TypeVar\n\nfrom django.core.serializers.json import DjangoJSONEncoder\nfrom django.http import JsonResponse\nfrom pydantic import AnyUrl, BaseModel\nfrom pydantic_core import Url\n\n__all__ = [\n \"NinjaJSONEncoder\",\n \"Response\",\n \"Status\",\n \"codes_1xx\",\n \"codes_2xx\",\n \"codes_3xx\",\n \"codes_4xx\",\n \"codes_5xx\",\n]\n\n\nT = TypeVar(\"T\")\n\n\nclass Status(Generic[T]):\n \"\"\"Return a response with an explicit HTTP status code.\n\n Usage:\n return Status(200, {\"key\": \"value\"})\n return Status(204, None)\n \"\"\"\n\n __slots__ = (\"status_code\", \"value\")\n\n def __init__(self, status_code: int, value: T):\n self.status_code = status_code\n self.value = value\n\n\nclass NinjaJSONEncoder(DjangoJSONEncoder):\n def default(self, o: Any) -> Any:\n if isinstance(o, BaseModel):\n return o.model_dump()\n if isinstance(o, (Url, AnyUrl)):\n return str(o)\n if isinstance(o, (IPv4Address, IPv4Network, IPv6Address, IPv6Network)):\n return str(o)\n if isinstance(o, Enum):\n return str(o)\n return super().default(o)\n\n\nclass Response(JsonResponse):\n def __init__(self, data: Any, **kwargs: Any) -> None:\n super().__init__(data, encoder=NinjaJSONEncoder, safe=False, **kwargs)\n\n\ndef resp_codes(from_code: int, to_code: int) -> FrozenSet[int]:\n return frozenset(range(from_code, to_code + 1))\n\n\n# most common http status codes\ncodes_1xx = resp_codes(100, 101)\ncodes_2xx = resp_codes(200, 206)\ncodes_3xx = resp_codes(300, 308)\ncodes_4xx = resp_codes(400, 412) | frozenset({416, 418, 425, 429, 451})\ncodes_5xx = resp_codes(500, 504)\n"
},
{
"path": "ninja/router.py",
"content": "import re\nfrom dataclasses import dataclass, field\nfrom typing import (\n TYPE_CHECKING,\n Any,\n Callable,\n Dict,\n Iterator,\n List,\n Optional,\n Tuple,\n Union,\n)\n\nfrom django.urls import URLPattern\nfrom django.urls import path as django_path\nfrom django.utils.module_loading import import_string\n\nfrom ninja.constants import NOT_SET, NOT_SET_TYPE\nfrom ninja.decorators import DecoratorMode\nfrom ninja.errors import ConfigError\nfrom ninja.operation import PathView\nfrom ninja.throttling import BaseThrottle\nfrom ninja.types import TCallable\nfrom ninja.utils import normalize_path, replace_path_param_notation\n\nif TYPE_CHECKING:\n from ninja import NinjaAPI # pragma: no cover\n\n\n__all__ = [\"Router\", \"RouterMount\", \"BoundRouter\"]\n\n\n@dataclass\nclass RouterMount:\n \"\"\"\n Configuration for how a Router template is mounted to an API.\n\n This class stores the mount-time configuration without mutating the\n original Router template, enabling router reuse across multiple APIs\n or multiple mount points within the same API.\n \"\"\"\n\n template: \"Router\"\n prefix: str\n url_name_prefix: Optional[str] = None\n auth: Any = NOT_SET\n throttle: Any = NOT_SET\n tags: Optional[List[str]] = None\n inherited_decorators: List[Tuple[Callable, DecoratorMode]] = field(\n default_factory=list\n )\n # Inherited auth/throttle/tags from parent routers (for nested router inheritance)\n inherited_auth: Any = NOT_SET\n inherited_throttle: Any = NOT_SET\n inherited_tags: Optional[List[str]] = None\n\n\nclass BoundRouter:\n \"\"\"\n A Router template bound to a specific API instance.\n\n Contains cloned operations with decorators applied. Each mount of a router\n creates a new BoundRouter instance, ensuring complete isolation between mounts.\n \"\"\"\n\n def __init__(self, mount: RouterMount, api: \"NinjaAPI\") -> None:\n self.mount = mount\n self.template = mount.template\n self.api = api\n self.prefix = mount.prefix\n self.url_name_prefix = mount.url_name_prefix\n\n # Effective settings priority:\n # 1. mount override (from api.add_router auth/throttle/tags params on this specific mount)\n # 2. template's own settings (set on the Router itself)\n # 3. inherited from parent (for nested routers where parent has auth)\n if mount.auth is not NOT_SET:\n self.auth = mount.auth\n elif mount.template.auth is not NOT_SET:\n self.auth = mount.template.auth\n elif mount.inherited_auth is not NOT_SET:\n self.auth = mount.inherited_auth\n else:\n self.auth = NOT_SET\n\n if mount.throttle is not NOT_SET:\n self.throttle = mount.throttle\n elif mount.template.throttle is not NOT_SET:\n self.throttle = mount.template.throttle\n elif mount.inherited_throttle is not NOT_SET:\n self.throttle = mount.inherited_throttle\n else:\n self.throttle = NOT_SET\n\n # Tags handling (issue #794):\n # - mount.tags (from add_router call) = explicit override, use as-is\n # - Otherwise, accumulate: inherited tags + template's own tags\n self.tags: Optional[List[str]]\n if mount.tags is not None:\n # Explicit tags from add_router() call - use as override\n self.tags = mount.tags\n else:\n # Accumulate inherited tags with template's own tags\n accumulated_tags: List[str] = []\n if mount.inherited_tags is not None:\n accumulated_tags.extend(mount.inherited_tags)\n if mount.template.tags is not None:\n accumulated_tags.extend(mount.template.tags)\n self.tags = accumulated_tags or None\n\n # Clone operations and apply decorators\n self.path_operations: Dict[str, PathView] = {}\n self._bind_operations()\n\n def _bind_operations(self) -> None:\n \"\"\"Clone operations from template and apply effective settings.\"\"\"\n effective_decorators = (\n self.mount.inherited_decorators + self.template._decorators\n )\n\n for path, path_view in self.template.path_operations.items():\n cloned_view = path_view.clone()\n\n for operation in cloned_view.operations:\n # Bind to API\n operation.api = self.api\n\n # Apply auth inheritance\n if operation.auth_param == NOT_SET:\n if self.auth != NOT_SET:\n operation._set_auth(self.auth)\n elif self.api.auth != NOT_SET:\n operation._set_auth(self.api.auth)\n\n # Apply throttle inheritance\n if operation.throttle_param == NOT_SET:\n if self.api.throttle != NOT_SET:\n throttle = self.api.throttle\n operation.throttle_objects = (\n isinstance(throttle, BaseThrottle)\n and [throttle]\n or throttle # type: ignore\n )\n if self.throttle != NOT_SET:\n throttle = self.throttle\n operation.throttle_objects = (\n isinstance(throttle, BaseThrottle)\n and [throttle]\n or throttle # type: ignore\n )\n\n # Apply tags inheritance\n if operation.tags is None and self.tags is not None: # type: ignore[has-type]\n operation.tags = self.tags # type: ignore[has-type]\n\n # Apply decorators (fresh application - no tracking needed)\n for decorator, mode in effective_decorators:\n if mode == \"view\":\n operation.run = decorator(operation.run) # type: ignore\n elif mode == \"operation\":\n operation.view_func = decorator(operation.view_func)\n else:\n raise ValueError(\n f\"Invalid decorator mode: {mode}\"\n ) # pragma: no cover\n\n self.path_operations[path] = cloned_view\n\n def urls_paths(self, prefix: str) -> Iterator[URLPattern]:\n \"\"\"Generate URL patterns for this bound router.\"\"\"\n prefix = replace_path_param_notation(prefix)\n for path, path_view in self.path_operations.items():\n path = replace_path_param_notation(path)\n route = \"/\".join([i for i in (prefix, path) if i])\n route = normalize_path(route)\n route = route.lstrip(\"/\")\n\n for operation in path_view.operations:\n url_name = getattr(operation, \"url_name\", \"\")\n if not url_name:\n url_name = self.api.get_operation_url_name(\n operation, router=self.template\n )\n # Apply url_name_prefix if specified\n if self.url_name_prefix and url_name:\n url_name = f\"{self.url_name_prefix}_{url_name}\"\n\n yield django_path(route, path_view.get_view(), name=url_name)\n\n\nclass Router:\n def __init__(\n self,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n tags: Optional[List[str]] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n ) -> None:\n self._frozen = False\n self.auth = auth\n self.throttle = throttle\n self.tags = tags\n self.by_alias = by_alias\n self.exclude_unset = exclude_unset\n self.exclude_defaults = exclude_defaults\n self.exclude_none = exclude_none\n\n self.path_operations: Dict[str, PathView] = {}\n self._routers: List[Tuple[str, Router, Optional[List[str]]]] = []\n self._decorators: List[Tuple[Callable, DecoratorMode]] = []\n\n def _freeze(self) -> None:\n \"\"\"Mark router as frozen - no more modifications allowed.\"\"\"\n self._frozen = True\n for _, child_router, _ in self._routers:\n child_router._freeze()\n\n def _check_not_frozen(self) -> None:\n \"\"\"Raise error if attempting to modify a frozen router.\"\"\"\n if self._frozen:\n raise ConfigError(\n \"Cannot modify router after URLs have been generated. \"\n \"Routers become frozen when api.urls is accessed.\"\n )\n\n def get(\n self,\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n return self.api_operation(\n [\"GET\"],\n path,\n auth=auth,\n throttle=throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def post(\n self,\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n return self.api_operation(\n [\"POST\"],\n path,\n auth=auth,\n throttle=throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def delete(\n self,\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n return self.api_operation(\n [\"DELETE\"],\n path,\n auth=auth,\n throttle=throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def patch(\n self,\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n return self.api_operation(\n [\"PATCH\"],\n path,\n auth=auth,\n throttle=throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def put(\n self,\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n return self.api_operation(\n [\"PUT\"],\n path,\n auth=auth,\n throttle=throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n\n def api_operation(\n self,\n methods: List[str],\n path: str,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> Callable[[TCallable], TCallable]:\n def decorator(view_func: TCallable) -> TCallable:\n self.add_api_operation(\n path,\n methods,\n view_func,\n auth=auth,\n throttle=throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n return view_func\n\n return decorator\n\n def add_api_operation(\n self,\n path: str,\n methods: List[str],\n view_func: Callable,\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n response: Any = NOT_SET,\n operation_id: Optional[str] = None,\n summary: Optional[str] = None,\n description: Optional[str] = None,\n tags: Optional[List[str]] = None,\n deprecated: Optional[bool] = None,\n by_alias: Optional[bool] = None,\n exclude_unset: Optional[bool] = None,\n exclude_defaults: Optional[bool] = None,\n exclude_none: Optional[bool] = None,\n url_name: Optional[str] = None,\n include_in_schema: bool = True,\n openapi_extra: Optional[Dict[str, Any]] = None,\n ) -> None:\n self._check_not_frozen()\n path = re.sub(r\"\\{uuid:(\\w+)\\}\", r\"{uuidstr:\\1}\", path, flags=re.IGNORECASE)\n # django by default convert strings to UUIDs\n # but we want to keep them as strings to let pydantic handle conversion/validation\n # if user whants UUID object\n # uuidstr is custom registered converter\n\n # No decoration here - will be done in build_routers\n\n if path not in self.path_operations:\n path_view = PathView()\n self.path_operations[path] = path_view\n else:\n path_view = self.path_operations[path]\n\n by_alias = by_alias is None and self.by_alias or by_alias\n exclude_unset = exclude_unset is None and self.exclude_unset or exclude_unset\n exclude_defaults = (\n exclude_defaults is None and self.exclude_defaults or exclude_defaults\n )\n exclude_none = exclude_none is None and self.exclude_none or exclude_none\n\n path_view.add_operation(\n path=path,\n methods=methods,\n view_func=view_func,\n auth=auth,\n throttle=throttle,\n response=response,\n operation_id=operation_id,\n summary=summary,\n description=description,\n tags=tags,\n deprecated=deprecated,\n by_alias=by_alias,\n exclude_unset=exclude_unset,\n exclude_defaults=exclude_defaults,\n exclude_none=exclude_none,\n url_name=url_name,\n include_in_schema=include_in_schema,\n openapi_extra=openapi_extra,\n )\n # Note: API binding is now done via BoundRouter when urls are generated\n\n return None\n\n def urls_paths(\n self, prefix: str, api: Optional[\"NinjaAPI\"] = None\n ) -> Iterator[URLPattern]:\n \"\"\"\n Generate URL patterns for this router.\n\n Note: This method is primarily for internal use. For mounting routers to APIs,\n use NinjaAPI.add_router() which handles proper binding via BoundRouter.\n\n Args:\n prefix: URL prefix for all paths\n api: Optional API instance for generating URL names (for backward compat)\n \"\"\"\n # Ensure decorators are applied before generating URLs\n self._apply_decorators_to_operations()\n\n prefix = replace_path_param_notation(prefix)\n for path, path_view in self.path_operations.items():\n for operation in path_view.operations:\n path = replace_path_param_notation(path)\n route = \"/\".join([i for i in (prefix, path) if i])\n # to skip lot of checks we simply treat double slash as a mistake:\n route = normalize_path(route)\n route = route.lstrip(\"/\")\n\n url_name = getattr(operation, \"url_name\", \"\")\n if not url_name and api:\n url_name = api.get_operation_url_name(operation, router=self)\n\n yield django_path(route, path_view.get_view(), name=url_name)\n\n def add_router(\n self,\n prefix: str,\n router: Union[\"Router\", str],\n *,\n auth: Any = NOT_SET,\n throttle: Union[BaseThrottle, List[BaseThrottle], NOT_SET_TYPE] = NOT_SET,\n tags: Optional[List[str]] = None,\n ) -> None:\n self._check_not_frozen()\n\n if isinstance(router, str):\n router = import_string(router)\n assert isinstance(router, Router)\n\n # Store child router with its mount-time configuration\n # Auth/throttle are stored on the child router template,\n # but tags from add_router are stored separately to distinguish from Router(tags=...)\n if auth != NOT_SET:\n router.auth = auth\n if throttle != NOT_SET:\n router.throttle = throttle\n # Store as (prefix, router, tags) - tags here are mount-level overrides\n self._routers.append((prefix, router, tags))\n\n def add_decorator(\n self,\n decorator: Callable,\n mode: DecoratorMode = \"operation\",\n ) -> None:\n \"\"\"\n Add a decorator to be applied to all operations in this router.\n\n Args:\n decorator: The decorator function to apply\n mode: \"operation\" (default) applies after validation,\n \"view\" applies before validation\n \"\"\"\n self._check_not_frozen()\n if mode not in (\"view\", \"operation\"):\n raise ValueError(f\"Invalid decorator mode: {mode}\")\n self._decorators.append((decorator, mode))\n\n def build_routers(\n self,\n prefix: str,\n inherited_decorators: Optional[List[Tuple[Callable, DecoratorMode]]] = None,\n inherited_auth: Any = NOT_SET,\n inherited_throttle: Any = NOT_SET,\n inherited_tags: Optional[List[str]] = None,\n ) -> List[RouterMount]:\n \"\"\"\n Build mount configurations for this router and all child routers.\n\n This method does NOT mutate any router state - it returns a list of\n RouterMount objects that describe how to bind routers to an API.\n\n Args:\n prefix: The URL prefix for this router\n inherited_decorators: Decorators inherited from parent routers/API\n inherited_auth: Auth inherited from parent routers\n inherited_throttle: Throttle inherited from parent routers\n inherited_tags: Tags inherited from parent routers\n\n Returns:\n List of RouterMount configurations for this router and all descendants\n \"\"\"\n if inherited_decorators is None:\n inherited_decorators = []\n\n # Create mount configuration for this router\n mount = RouterMount(\n template=self,\n prefix=prefix,\n inherited_decorators=list(inherited_decorators),\n inherited_auth=inherited_auth,\n inherited_throttle=inherited_throttle,\n inherited_tags=inherited_tags,\n )\n\n # Calculate values to pass to children\n child_decorators = inherited_decorators + self._decorators\n\n # For auth/throttle/tags, effective value is used for children:\n # priority: this router's own setting > inherited\n child_auth = self.auth if self.auth is not NOT_SET else inherited_auth\n child_throttle = (\n self.throttle if self.throttle is not NOT_SET else inherited_throttle\n )\n child_tags = self.tags if self.tags is not None else inherited_tags\n\n # Build mounts for child routers\n child_mounts: List[RouterMount] = []\n for child_prefix, child_router, child_mount_tags in self._routers:\n child_path = normalize_path(\"/\".join((prefix, child_prefix))).lstrip(\"/\")\n mounts = child_router.build_routers(\n child_path,\n child_decorators,\n child_auth,\n child_throttle,\n child_tags,\n )\n # Apply mount-level tags override to the first mount (the child router itself)\n if mounts and child_mount_tags is not None:\n mounts[0].tags = child_mount_tags\n child_mounts.extend(mounts)\n\n return [mount, *child_mounts]\n\n def _apply_decorators_to_operations(self) -> None:\n \"\"\"Apply all stored decorators to operations in this router\"\"\"\n for path_view in self.path_operations.values():\n for operation in path_view.operations:\n # Track what decorators have already been applied to avoid duplicates\n applied_decorators = getattr(operation, \"_applied_decorators\", [])\n\n # Apply decorators that haven't been applied yet\n for decorator, mode in self._decorators:\n if (decorator, mode) not in applied_decorators:\n if mode == \"view\":\n operation.run = decorator(operation.run) # type: ignore\n elif mode == \"operation\":\n operation.view_func = decorator(operation.view_func)\n else:\n raise ValueError(\n f\"Invalid decorator mode: {mode}\"\n ) # pragma: no cover\n applied_decorators.append((decorator, mode))\n\n # Store what decorators have been applied\n operation._applied_decorators = applied_decorators # type: ignore[attr-defined]\n"
},
{
"path": "ninja/schema.py",
"content": "\"\"\"\nSince \"Model\" word would be very confusing when used in django context, this\nmodule basically makes an alias for it named \"Schema\" and adds extra whistles to\nbe able to work with django querysets and managers.\n\nThe schema is a bit smarter than a standard pydantic Model because it can handle\ndotted attributes and resolver methods. For example::\n\n\n class UserSchema(User):\n name: str\n initials: str\n boss: str = Field(None, alias=\"boss.first_name\")\n\n @staticmethod\n def resolve_name(obj):\n return f\"{obj.first_name} {obj.last_name}\"\n\n\"\"\"\n\nimport warnings\nfrom typing import (\n Any,\n Callable,\n Dict,\n Type,\n TypeVar,\n Union,\n no_type_check,\n)\n\nimport pydantic\nfrom django.db.models import Manager, QuerySet\nfrom django.db.models.fields.files import FieldFile\nfrom django.template import Variable, VariableDoesNotExist\nfrom pydantic import BaseModel, ConfigDict, Field, ValidationInfo, model_validator\nfrom pydantic._internal._model_construction import ModelMetaclass\nfrom pydantic.functional_validators import ModelWrapValidatorHandler\nfrom pydantic.json_schema import GenerateJsonSchema, JsonSchemaValue\nfrom typing_extensions import dataclass_transform\n\nfrom ninja.signature.utils import get_args_names, has_kwargs\nfrom ninja.types import DictStrAny\n\npydantic_version = list(map(int, pydantic.VERSION.split(\".\")[:2]))\nassert pydantic_version >= [2, 0], \"Pydantic 2.0+ required\"\n\n__all__ = [\"BaseModel\", \"Field\", \"DjangoGetter\", \"Schema\"]\n\nS = TypeVar(\"S\", bound=\"Schema\")\n\n\nclass DjangoGetter:\n __slots__ = (\"_obj\", \"_schema_cls\", \"_context\", \"__dict__\")\n\n def __init__(self, obj: Any, schema_cls: Type[S], context: Any = None):\n self._obj = obj\n self._schema_cls = schema_cls\n self._context = context\n\n def __getattr__(self, key: str) -> Any:\n # if key.startswith(\"__pydantic\"):\n # return getattr(self._obj, key)\n\n resolver = self._schema_cls._ninja_resolvers.get(key)\n if resolver:\n value = resolver(getter=self)\n else:\n if isinstance(self._obj, dict):\n if key not in self._obj:\n raise AttributeError(key)\n value = self._obj[key]\n else:\n try:\n value = getattr(self._obj, key)\n except AttributeError:\n try:\n # value = attrgetter(key)(self._obj)\n value = Variable(key).resolve(self._obj)\n # TODO: Variable(key) __init__ is actually slower than\n # Variable.resolve - so it better be cached\n except VariableDoesNotExist as e:\n raise AttributeError(key) from e\n return self._convert_result(value)\n\n # def get(self, key: Any, default: Any = None) -> Any:\n # try:\n # return self[key]\n # except KeyError:\n # return default\n\n def _convert_result(self, result: Any) -> Any:\n if isinstance(result, Manager):\n return list(result.all())\n\n elif isinstance(result, getattr(QuerySet, \"__origin__\", QuerySet)):\n return list(result)\n\n if callable(result):\n return result()\n\n elif isinstance(result, FieldFile):\n if not result:\n return None\n return result.url\n\n return result\n\n def __repr__(self) -> str:\n return f\"\"\n\n\nclass Resolver:\n __slots__ = (\"_func\", \"_static\", \"_takes_context\")\n _static: bool\n _func: Any\n _takes_context: bool\n\n def __init__(self, func: Union[Callable, staticmethod]):\n if isinstance(func, staticmethod):\n self._static = True\n self._func = func.__func__\n else:\n self._static = False\n self._func = func\n\n arg_names = get_args_names(self._func)\n self._takes_context = has_kwargs(self._func) or \"context\" in arg_names\n\n def __call__(self, getter: DjangoGetter) -> Any:\n kwargs = {}\n if self._takes_context:\n kwargs[\"context\"] = getter._context\n\n if self._static:\n return self._func(getter._obj, **kwargs)\n raise NotImplementedError(\n \"Non static resolves are not supported yet\"\n ) # pragma: no cover\n # return self._func(self._fake_instance(getter), getter._obj)\n\n # def _fake_instance(self, getter: DjangoGetter) -> \"Schema\":\n # \"\"\"\n # Generate a partial schema instance that can be used as the ``self``\n # attribute of resolver functions.\n # \"\"\"\n\n # class PartialSchema(Schema):\n # def __getattr__(self, key: str) -> Any:\n # value = getattr(getter, key)\n # field = getter._schema_cls.model_fields[key]\n # value = field.validate(value, values={}, loc=key, cls=None)[0]\n # return value\n\n # return PartialSchema()\n\n\n@dataclass_transform(kw_only_default=True, field_specifiers=(Field,))\nclass ResolverMetaclass(ModelMetaclass):\n _ninja_resolvers: Dict[str, Resolver]\n\n @no_type_check\n def __new__(cls, name, bases, namespace, **kwargs):\n resolvers = {}\n\n for base in reversed(bases):\n base_resolvers = getattr(base, \"_ninja_resolvers\", None)\n if base_resolvers:\n resolvers.update(base_resolvers)\n for attr, resolve_func in namespace.items():\n if not attr.startswith(\"resolve_\"):\n continue\n if (\n not callable(resolve_func)\n # A staticmethod isn't directly callable in Python <=3.9.\n and not isinstance(resolve_func, staticmethod)\n ):\n continue # pragma: no cover\n resolvers[attr[8:]] = Resolver(resolve_func)\n\n result = super().__new__(cls, name, bases, namespace, **kwargs)\n result._ninja_resolvers = resolvers\n return result\n\n\nclass NinjaGenerateJsonSchema(GenerateJsonSchema):\n def default_schema(self, schema: Any) -> JsonSchemaValue:\n # Pydantic default actually renders null's and default_factory's\n # which really breaks swagger and django model callable defaults\n # so here we completely override behavior\n json_schema = self.generate_inner(schema[\"schema\"])\n\n default = None\n if \"default\" in schema and schema[\"default\"] is not None:\n default = self.encode_default(schema[\"default\"])\n\n if \"$ref\" in json_schema:\n # Since reference schemas do not support child keys, we wrap the reference schema in a single-case allOf:\n result = {\"allOf\": [json_schema]}\n else:\n result = json_schema\n\n if default is not None:\n result[\"default\"] = default\n\n return result\n\n\nclass Schema(BaseModel, metaclass=ResolverMetaclass):\n model_config = ConfigDict(from_attributes=True)\n\n @model_validator(mode=\"wrap\")\n @classmethod\n def _run_root_validator(\n cls, values: Any, handler: ModelWrapValidatorHandler[S], info: ValidationInfo\n ) -> Any:\n # If Pydantic intends to validate against the __dict__ of the immediate Schema\n # object, then we need to call `handler` directly on `values` before the conversion\n # to DjangoGetter, since any checks or modifications on DjangoGetter's __dict__\n # will not persist to the original object.\n forbids_extra = cls.model_config.get(\"extra\") == \"forbid\"\n should_validate_assignment = cls.model_config.get(\"validate_assignment\", False)\n if forbids_extra or should_validate_assignment:\n handler(values)\n\n values = DjangoGetter(values, cls, info.context)\n return handler(values)\n\n @classmethod\n def from_orm(cls: Type[S], obj: Any, **kw: Any) -> S:\n return cls.model_validate(obj, **kw)\n\n def dict(self, *a: Any, **kw: Any) -> DictStrAny:\n \"Backward compatibility with pydantic 1.x\"\n return self.model_dump(*a, **kw)\n\n @classmethod\n def json_schema(cls) -> DictStrAny:\n return cls.model_json_schema(schema_generator=NinjaGenerateJsonSchema)\n\n @classmethod\n def schema(cls) -> DictStrAny: # type: ignore\n warnings.warn(\n \".schema() is deprecated, use .json_schema() instead\",\n DeprecationWarning,\n stacklevel=2,\n )\n return cls.json_schema()\n"
},
{
"path": "ninja/security/__init__.py",
"content": "from ninja.security.apikey import APIKeyCookie, APIKeyHeader, APIKeyQuery\nfrom ninja.security.http import HttpBasicAuth, HttpBearer\nfrom ninja.security.session import SessionAuth, SessionAuthIsStaff, SessionAuthSuperUser\n\n__all__ = [\n \"APIKeyCookie\",\n \"APIKeyHeader\",\n \"APIKeyQuery\",\n \"HttpBasicAuth\",\n \"HttpBearer\",\n \"SessionAuth\",\n \"SessionAuthSuperUser\",\n \"django_auth\",\n \"django_auth_superuser\",\n \"django_auth_is_staff\",\n]\n\ndjango_auth = SessionAuth()\ndjango_auth_superuser = SessionAuthSuperUser()\ndjango_auth_is_staff = SessionAuthIsStaff()\n"
},
{
"path": "ninja/security/apikey.py",
"content": "from abc import ABC, abstractmethod\nfrom typing import Any, Optional\n\nfrom django.http import HttpRequest\n\nfrom ninja.errors import HttpError\nfrom ninja.security.base import AuthBase\nfrom ninja.utils import check_csrf\n\n__all__ = [\"APIKeyBase\", \"APIKeyQuery\", \"APIKeyCookie\", \"APIKeyHeader\"]\n\n\nclass APIKeyBase(AuthBase, ABC):\n openapi_type: str = \"apiKey\"\n param_name: str = \"key\"\n\n def __init__(self) -> None:\n self.openapi_name = self.param_name # this sets the name of the security schema\n super().__init__()\n\n def __call__(self, request: HttpRequest) -> Optional[Any]:\n key = self._get_key(request)\n return self.authenticate(request, key)\n\n @abstractmethod\n def _get_key(self, request: HttpRequest) -> Optional[str]:\n pass # pragma: no cover\n\n @abstractmethod\n def authenticate(self, request: HttpRequest, key: Optional[str]) -> Optional[Any]:\n pass # pragma: no cover\n\n\nclass APIKeyQuery(APIKeyBase, ABC):\n openapi_in: str = \"query\"\n\n def _get_key(self, request: HttpRequest) -> Optional[str]:\n return request.GET.get(self.param_name)\n\n\nclass APIKeyCookie(APIKeyBase, ABC):\n openapi_in: str = \"cookie\"\n\n def __init__(self, csrf: bool = True) -> None:\n self.csrf = csrf\n super().__init__()\n\n def _get_key(self, request: HttpRequest) -> Optional[str]:\n # Skip CSRF check if the operation is marked as csrf_exempt\n if self.csrf and not getattr(request, \"_ninja_csrf_exempt\", False):\n error_response = check_csrf(request)\n if error_response:\n raise HttpError(403, \"CSRF check Failed\")\n return request.COOKIES.get(self.param_name)\n\n\nclass APIKeyHeader(APIKeyBase, ABC):\n openapi_in: str = \"header\"\n\n def _get_key(self, request: HttpRequest) -> Optional[str]:\n headers = request.headers\n return headers.get(self.param_name)\n"
},
{
"path": "ninja/security/base.py",
"content": "from abc import ABC, abstractmethod\nfrom typing import Any, Optional\n\nfrom django.http import HttpRequest\n\nfrom ninja.errors import ConfigError\nfrom ninja.utils import is_async_callable\n\n__all__ = [\"SecuritySchema\", \"AuthBase\"]\n\n\nclass SecuritySchema(dict):\n def __init__(self, type: str, **kwargs: Any) -> None:\n super().__init__(type=type, **kwargs)\n\n\nclass AuthBase(ABC):\n def __init__(self) -> None:\n if not hasattr(self, \"openapi_type\"):\n raise ConfigError(\"If you extend AuthBase you need to define openapi_type\")\n\n kwargs = {}\n for attr in dir(self):\n if attr.startswith(\"openapi_\"):\n name = attr.replace(\"openapi_\", \"\", 1)\n kwargs[name] = getattr(self, attr)\n self.openapi_security_schema = SecuritySchema(**kwargs)\n\n self.is_async = False\n if hasattr(self, \"authenticate\"): # pragma: no branch\n self.is_async = is_async_callable(self.authenticate)\n\n @abstractmethod\n def __call__(self, request: HttpRequest) -> Optional[Any]:\n pass # pragma: no cover\n"
},
{
"path": "ninja/security/http.py",
"content": "import logging\nfrom abc import ABC, abstractmethod\nfrom base64 import b64decode\nfrom typing import Any, Optional, Tuple\nfrom urllib.parse import unquote\n\nfrom django.conf import settings\nfrom django.http import HttpRequest\n\nfrom ninja.security.base import AuthBase\n\n__all__ = [\"HttpAuthBase\", \"HttpBearer\", \"DecodeError\", \"HttpBasicAuth\"]\n\n\nlogger = logging.getLogger(\"django\")\n\n\nclass HttpAuthBase(AuthBase, ABC):\n openapi_type: str = \"http\"\n\n\nclass HttpBearer(HttpAuthBase, ABC):\n openapi_scheme: str = \"bearer\"\n header: str = \"Authorization\"\n\n def __call__(self, request: HttpRequest) -> Optional[Any]:\n headers = request.headers\n auth_value = headers.get(self.header)\n if not auth_value:\n return None\n parts = auth_value.split(\" \")\n\n if parts[0].lower() != self.openapi_scheme:\n if settings.DEBUG:\n logger.error(f\"Unexpected auth - '{auth_value}'\")\n return None\n token = \" \".join(parts[1:])\n return self.authenticate(request, token)\n\n @abstractmethod\n def authenticate(self, request: HttpRequest, token: str) -> Optional[Any]:\n pass # pragma: no cover\n\n\nclass DecodeError(Exception):\n pass\n\n\nclass HttpBasicAuth(HttpAuthBase, ABC): # TODO: maybe HttpBasicAuthBase\n openapi_scheme = \"basic\"\n header = \"Authorization\"\n\n def __call__(self, request: HttpRequest) -> Optional[Any]:\n headers = request.headers\n auth_value = headers.get(self.header)\n if not auth_value:\n return None\n\n try:\n username, password = self.decode_authorization(auth_value)\n except DecodeError as e:\n if settings.DEBUG:\n logger.exception(e)\n return None\n return self.authenticate(request, username, password)\n\n @abstractmethod\n def authenticate(\n self, request: HttpRequest, username: str, password: str\n ) -> Optional[Any]:\n pass # pragma: no cover\n\n def decode_authorization(self, value: str) -> Tuple[str, str]:\n parts = value.split(\" \")\n if len(parts) == 1:\n user_pass_encoded = parts[0]\n elif len(parts) == 2 and parts[0].lower() == \"basic\":\n user_pass_encoded = parts[1]\n else:\n raise DecodeError(\"Invalid Authorization header\")\n\n try:\n username, password = b64decode(user_pass_encoded).decode().split(\":\", 1)\n return unquote(username), unquote(password)\n except Exception as e: # dear contributors please do not change to valueerror - here can be multiple exceptions\n raise DecodeError(\"Invalid Authorization header\") from e\n"
},
{
"path": "ninja/security/session.py",
"content": "from typing import Any, Optional\n\nfrom django.conf import settings\nfrom django.http import HttpRequest\n\nfrom ninja.security.apikey import APIKeyCookie\n\n__all__ = [\"SessionAuth\", \"SessionAuthSuperUser\", \"SessionAuthIsStaff\"]\n\n\nclass SessionAuth(APIKeyCookie):\n \"Reusing Django session authentication\"\n\n param_name: str = settings.SESSION_COOKIE_NAME\n\n def authenticate(self, request: HttpRequest, key: Optional[str]) -> Optional[Any]:\n if request.user.is_authenticated:\n return request.user\n\n return None\n\n\nclass SessionAuthSuperUser(APIKeyCookie):\n \"Reusing Django session authentication & verify that the user is a super user\"\n\n param_name: str = settings.SESSION_COOKIE_NAME\n\n def authenticate(self, request: HttpRequest, key: Optional[str]) -> Optional[Any]:\n is_superuser = getattr(request.user, \"is_superuser\", None)\n if request.user.is_authenticated and is_superuser:\n return request.user\n\n return None\n\n\nclass SessionAuthIsStaff(SessionAuthSuperUser):\n def authenticate(self, request: HttpRequest, key: Optional[str]) -> Optional[Any]:\n result = super().authenticate(request, key)\n if result is not None:\n return result\n if request.user.is_authenticated and getattr(request.user, \"is_staff\", None):\n return request.user\n\n return None\n"
},
{
"path": "ninja/signature/__init__.py",
"content": "from ninja.signature.details import ViewSignature\nfrom ninja.signature.utils import is_async\n\n__all__ = [\"ViewSignature\", \"is_async\"]\n"
},
{
"path": "ninja/signature/details.py",
"content": "import inspect\nimport warnings\nfrom collections import defaultdict, namedtuple\nfrom sys import version_info\nfrom typing import Any, Callable, Dict, Generator, List, Optional, Tuple\n\nimport pydantic\nfrom django.http import HttpResponse\nfrom pydantic.fields import FieldInfo\nfrom pydantic_core import PydanticUndefined\nfrom typing_extensions import Annotated, get_args, get_origin\n\nfrom ninja import UploadedFile\nfrom ninja.compatibility.util import UNION_TYPES\nfrom ninja.errors import ConfigError\nfrom ninja.params.models import (\n Body,\n File,\n Form,\n Param,\n Path,\n Query,\n TModel,\n TModels,\n _MultiPartBody,\n)\nfrom ninja.signature.utils import get_path_param_names, get_typed_signature\nfrom ninja.utils import is_optional_type\n\n__all__ = [\n \"ViewSignature\",\n \"is_pydantic_model\",\n \"is_collection_type\",\n \"detect_collection_fields\",\n]\n\nFuncParam = namedtuple(\n \"FuncParam\", [\"name\", \"alias\", \"source\", \"annotation\", \"is_collection\"]\n)\n\n\nclass ViewSignature:\n FLATTEN_PATH_SEP = (\n \"\\x1e\" # ASCII Record Separator. IE: not generally used in query names\n )\n response_arg: Optional[str] = None\n\n def __init__(self, path: str, view_func: Callable[..., Any]) -> None:\n self.view_func = view_func\n self.signature = get_typed_signature(self.view_func)\n self.path = path\n self.path_params_names = get_path_param_names(path)\n self.docstring = inspect.cleandoc(view_func.__doc__ or \"\")\n self.has_kwargs = False\n\n self.params = []\n for name, arg in self.signature.parameters.items():\n if name == \"request\":\n # TODO: maybe better assert that 1st param is request or check by type?\n # maybe even have attribute like `has_request`\n # so that users can ignore passing request if not needed\n continue\n\n if arg.kind == arg.VAR_KEYWORD:\n # Skipping **kwargs\n self.has_kwargs = True\n continue\n\n if arg.kind == arg.VAR_POSITIONAL:\n # Skipping *args\n continue\n\n if arg.annotation is HttpResponse:\n self.response_arg = name\n continue\n\n if (\n arg.annotation is inspect.Parameter.empty\n and isinstance(arg.default, type)\n and issubclass(arg.default, pydantic.BaseModel)\n ):\n raise ConfigError(\n f\"Looks like you are using `{name}={arg.default.__name__}` instead of `{name}: {arg.default.__name__}` (annotation)\"\n )\n\n func_param = self._get_param_type(name, arg)\n self.params.append(func_param)\n\n if hasattr(view_func, \"_ninja_contribute_args\"):\n # _ninja_contribute_args is a special attribute\n # which allows developers to create custom function params\n # inside decorators or other functions\n for p_name, p_type, p_source in view_func._ninja_contribute_args:\n self.params.append(\n FuncParam(p_name, p_source.alias or p_name, p_source, p_type, False)\n )\n\n self.models: TModels = self._create_models()\n\n self._validate_view_path_params()\n\n def _validate_view_path_params(self) -> None:\n \"\"\"verify all path params are present in the path model fields\"\"\"\n if self.path_params_names:\n path_model = next(\n (m for m in self.models if m.__ninja_param_source__ == \"path\"), None\n )\n missing = tuple(\n sorted(\n name\n for name in self.path_params_names\n if not (path_model and name in path_model.__ninja_flatten_map__)\n )\n )\n if missing:\n warnings.warn_explicit(\n UserWarning(\n f\"Field(s) {missing} are in the view path, but were not found in the view signature.\"\n ),\n category=None,\n filename=inspect.getfile(self.view_func),\n lineno=inspect.getsourcelines(self.view_func)[1],\n source=None,\n )\n\n def _create_models(self) -> TModels:\n params_by_source_cls: Dict[Any, List[FuncParam]] = defaultdict(list)\n for param in self.params:\n param_source_cls = type(param.source)\n params_by_source_cls[param_source_cls].append(param)\n\n is_multipart_response_with_body = Body in params_by_source_cls and (\n File in params_by_source_cls or Form in params_by_source_cls\n )\n if is_multipart_response_with_body:\n params_by_source_cls[_MultiPartBody] = params_by_source_cls.pop(Body)\n\n result = []\n for param_cls, args in params_by_source_cls.items():\n cls_name: str = param_cls.__name__ + \"Params\"\n attrs = {i.name: i.source for i in args}\n attrs[\"__ninja_param_source__\"] = param_cls._param_source()\n attrs[\"__ninja_flatten_map_reverse__\"] = {}\n\n if attrs[\"__ninja_param_source__\"] == \"file\":\n pass\n\n elif attrs[\"__ninja_param_source__\"] in {\n \"form\",\n \"query\",\n \"header\",\n \"cookie\",\n \"path\",\n }:\n flatten_map = self._args_flatten_map(args)\n attrs[\"__ninja_flatten_map__\"] = flatten_map\n attrs[\"__ninja_flatten_map_reverse__\"] = {\n v: (k,) for k, v in flatten_map.items()\n }\n\n else:\n assert attrs[\"__ninja_param_source__\"] == \"body\"\n if is_multipart_response_with_body:\n attrs[\"__ninja_body_params__\"] = {\n i.alias: i.annotation for i in args\n }\n else:\n # ::TODO:: this is still sus. build some test cases\n attrs[\"__read_from_single_attr__\"] = (\n args[0].name if len(args) == 1 else None\n )\n\n # adding annotations\n attrs[\"__annotations__\"] = {i.name: i.annotation for i in args}\n\n # collection fields:\n attrs[\"__ninja_collection_fields__\"] = detect_collection_fields(\n args, attrs.get(\"__ninja_flatten_map__\", {})\n )\n\n base_cls = param_cls._model\n model_cls = type(cls_name, (base_cls,), attrs)\n # TODO: https://pydantic-docs.helpmanual.io/usage/models/#dynamic-model-creation - check if anything special in create_model method that I did not use\n result.append(model_cls)\n return result\n\n def _args_flatten_map(self, args: List[FuncParam]) -> Dict[str, Tuple[str, ...]]:\n flatten_map = {}\n arg_names: Any = {}\n for arg in args:\n if is_pydantic_model(arg.annotation):\n for name, path in self._model_flatten_map(arg.annotation, arg.alias):\n if name in flatten_map:\n raise ConfigError(\n f\"Duplicated name: '{name}' in params: '{arg_names[name]}' & '{arg.name}'\"\n )\n flatten_map[name] = tuple(path.split(self.FLATTEN_PATH_SEP))\n arg_names[name] = arg.name\n else:\n name = arg.alias\n if name in flatten_map:\n raise ConfigError(\n f\"Duplicated name: '{name}' also in '{arg_names[name]}'\"\n )\n flatten_map[name] = (name,)\n arg_names[name] = name\n\n return flatten_map\n\n def _model_flatten_map(self, model: TModel, prefix: str) -> Generator:\n model = _unwrap_union_model(model)\n field: FieldInfo\n for attr, field in model.model_fields.items():\n field_name = field.alias or attr\n name = f\"{prefix}{self.FLATTEN_PATH_SEP}{field_name}\"\n if is_pydantic_model(field.annotation):\n yield from self._model_flatten_map(field.annotation, name) # type: ignore\n else:\n yield field_name, name\n\n def _get_param_type(self, name: str, arg: inspect.Parameter) -> FuncParam:\n # _EMPTY = self.signature.empty\n annotation = arg.annotation\n default = arg.default\n\n if get_origin(annotation) is Annotated:\n args = get_args(annotation)\n if isinstance(args[-1], Param):\n prev_default = default\n if len(args) == 2:\n annotation, default = args\n else:\n # TODO: Remove version check once support for <=3.8 is dropped.\n # Annotated[] is only available at runtime in 3.9+ per\n # https://docs.python.org/3/library/typing.html#typing.Annotated\n if version_info >= (3, 9):\n # NOTE: Annotated[args[:-1]] seems to have the same runtime\n # behavior as Annotated[*args[:-1]], but the latter is\n # invalid in Python < 3.11 because star expressions\n # were not allowed in index expressions.\n annotation, default = Annotated[args[:-1]], args[-1]\n else: # pragma: no cover -- requires specific Python versions\n raise NotImplementedError(\n \"This definition requires Python version 3.9+\"\n )\n if prev_default != self.signature.empty:\n default.default = prev_default\n\n if annotation == self.signature.empty:\n if default == self.signature.empty:\n annotation = str\n else:\n if isinstance(default, Param):\n annotation = type(default.default)\n else:\n annotation = type(default)\n\n if annotation == PydanticUndefined.__class__:\n # TODO: ^ check why is that so\n annotation = str\n\n if annotation == type(None) or annotation == type(Ellipsis): # noqa\n annotation = str\n\n is_collection = is_collection_type(annotation)\n\n if annotation == UploadedFile or (\n is_collection and annotation.__args__[0] == UploadedFile\n ):\n # People often forgot to mark UploadedFile as a File, so we better assign it automatically\n if default == self.signature.empty or default is None:\n default = default == self.signature.empty and ... or default\n return FuncParam(name, name, File(default), annotation, is_collection)\n\n # 1) if type of the param is defined as one of the Param's subclasses - we just use that definition\n if isinstance(default, Param):\n param_source = default\n\n # 2) if param name is a part of the path parameter\n elif name in self.path_params_names:\n assert (\n default == self.signature.empty\n ), f\"'{name}' is a path param, default not allowed\"\n param_source = Path(...)\n\n # 3) if param is a collection, or annotation is part of pydantic model:\n elif is_collection or is_pydantic_model(annotation):\n if default == self.signature.empty:\n param_source = Body(...)\n else:\n param_source = Body(default)\n\n # 4) the last case is query param\n else:\n if default == self.signature.empty:\n param_source = Query(...)\n else:\n param_source = Query(default)\n\n # If default is None but annotation is not Optional,\n # wrap it in Optional to allow None values in Pydantic v2\n if default is None and not is_optional_type(annotation):\n annotation = Optional[annotation]\n\n return FuncParam(\n name, param_source.alias or name, param_source, annotation, is_collection\n )\n\n\ndef _unwrap_union_model(annotation: Any) -> Any:\n \"\"\"If annotation is a Union containing a pydantic model, return that model class.\"\"\"\n if get_origin(annotation) in UNION_TYPES:\n for arg in get_args(annotation):\n if arg is not type(None) and is_pydantic_model(arg):\n return arg\n return annotation\n\n\ndef is_pydantic_model(cls: Any) -> bool:\n try:\n origin = get_origin(cls)\n\n # Handle Annotated types - extract the actual type\n if origin is Annotated:\n args = get_args(cls)\n return is_pydantic_model(args[0])\n\n # Handle Union types\n if origin in UNION_TYPES:\n return any(issubclass(arg, pydantic.BaseModel) for arg in get_args(cls))\n return issubclass(cls, pydantic.BaseModel)\n except TypeError: # pragma: no cover\n return False\n\n\ndef is_collection_type(annotation: Any) -> bool:\n origin = get_origin(annotation)\n\n if origin in UNION_TYPES:\n for arg in get_args(annotation):\n if is_collection_type(arg):\n return True\n return False\n\n collection_types = (List, list, set, tuple)\n if origin is None:\n return (\n isinstance(annotation, collection_types)\n if not isinstance(annotation, type)\n else issubclass(annotation, collection_types)\n )\n else:\n return origin in collection_types # TODO: I guess we should handle only list\n\n\ndef detect_collection_fields(\n args: List[FuncParam], flatten_map: Dict[str, Tuple[str, ...]]\n) -> List[str]:\n \"\"\"\n Django QueryDict has values that are always lists, so we need to help django ninja to understand\n better the input parameters if it's a list or a single value\n This method detects attributes that should be treated by ninja as lists and returns this list as a result\n \"\"\"\n result = [i.alias or i.name for i in args if i.is_collection]\n\n if flatten_map:\n args_d = {arg.alias: arg for arg in args}\n for path in (p for p in flatten_map.values() if len(p) > 1):\n annotation_or_field: Any = args_d[path[0]].annotation\n for attr in path[1:]:\n if hasattr(annotation_or_field, \"annotation\"):\n annotation_or_field = annotation_or_field.annotation\n annotation_or_field = _unwrap_union_model(annotation_or_field)\n annotation_or_field = next(\n (\n a\n for a in annotation_or_field.model_fields.values()\n if a.alias == attr\n ),\n annotation_or_field.model_fields.get(attr),\n ) # pragma: no cover\n\n annotation_or_field = getattr(\n annotation_or_field, \"outer_type_\", annotation_or_field\n )\n\n # if hasattr(annotation_or_field, \"annotation\"):\n annotation_or_field = annotation_or_field.annotation\n\n if is_collection_type(annotation_or_field):\n result.append(path[-1])\n return result\n"
},
{
"path": "ninja/signature/utils.py",
"content": "import asyncio\nimport inspect\nimport re\nfrom sys import version_info\nfrom typing import Any, Callable, ForwardRef, List, Set\n\nfrom django.urls import register_converter\nfrom django.urls.converters import UUIDConverter\nfrom pydantic._internal._typing_extra import eval_type_lenient as evaluate_forwardref\n\nfrom ninja.types import DictStrAny\n\n__all__ = [\n \"get_typed_signature\",\n \"get_typed_annotation\",\n \"make_forwardref\",\n \"get_path_param_names\",\n \"is_async\",\n]\n\n\ndef get_typed_signature(call: Callable[..., Any]) -> inspect.Signature:\n \"Finds call signature and resolves all forwardrefs\"\n signature = inspect.signature(call)\n globalns = getattr(call, \"__globals__\", {})\n typed_params = [\n inspect.Parameter(\n name=param.name,\n kind=param.kind,\n default=param.default,\n annotation=get_typed_annotation(param, globalns),\n )\n for param in signature.parameters.values()\n ]\n typed_signature = inspect.Signature(typed_params)\n return typed_signature\n\n\ndef get_typed_annotation(param: inspect.Parameter, globalns: DictStrAny) -> Any:\n annotation = param.annotation\n if isinstance(annotation, str):\n annotation = make_forwardref(annotation, globalns)\n return annotation\n\n\ndef make_forwardref(annotation: str, globalns: DictStrAny) -> Any:\n # NOTE: in future versions of pydantic, the import may be changed to:\n # from pydantic._internal._typing_extra import try_eval_type\n # usage:\n # result, _ = try_eval_type(forward_ref, globalns, globalns)\n forward_ref = ForwardRef(annotation)\n return evaluate_forwardref(forward_ref, globalns, globalns)\n\n\ndef get_path_param_names(path: str) -> Set[str]:\n \"\"\"turns path string like /foo/{var}/path/{int:another}/end to set {'var', 'another'}\"\"\"\n return {item.strip(\"{}\").split(\":\")[-1] for item in re.findall(\"{[^}]*}\", path)}\n\n\ndef is_async(callable: Callable[..., Any]) -> bool:\n # TODO: Drop this condition once support for <= 3.11 is dropped\n if version_info >= (3, 12):\n return inspect.iscoroutinefunction(callable)\n else:\n return asyncio.iscoroutinefunction(callable) # pragma: no cover\n\n\ndef has_kwargs(func: Callable[..., Any]) -> bool:\n for param in inspect.signature(func).parameters.values():\n if param.kind == param.VAR_KEYWORD:\n return True\n return False\n\n\ndef get_args_names(func: Callable[..., Any]) -> List[str]:\n \"returns list of function argument names\"\n return list(inspect.signature(func).parameters.keys())\n\n\nclass UUIDStrConverter(UUIDConverter):\n \"\"\"Return a path converted UUID as a str instead of the standard UUID\"\"\"\n\n def to_python(self, value: str) -> str: # type: ignore\n return value # return string value instead of UUID\n\n\nregister_converter(UUIDStrConverter, \"uuidstr\")\n"
},
{
"path": "ninja/static/ninja/redoc.standalone.js",
"content": "/*! For license information please see redoc.standalone.js.LICENSE.txt */\n!function(e,t){\"object\"==typeof exports&&\"object\"==typeof module?module.exports=t(require(\"null\")):\"function\"==typeof define&&define.amd?define([\"null\"],t):\"object\"==typeof exports?exports.Redoc=t(require(\"null\")):e.Redoc=t(e.null)}(this,(function(e){return function(){var t={854:function(e,t,n){\"use strict\";var r=this&&this.__awaiter||function(e,t,n,r){return new(n||(n=Promise))((function(i,o){function s(e){try{l(r.next(e))}catch(e){o(e)}}function a(e){try{l(r.throw(e))}catch(e){o(e)}}function l(e){var t;e.done?i(e.value):(t=e.value,t instanceof n?t:new n((function(e){e(t)}))).then(s,a)}l((r=r.apply(e,t||[])).next())}))};Object.defineProperty(t,\"__esModule\",{value:!0}),t.mapTypeToComponent=t.bundleDocument=t.bundleFromString=t.bundle=t.OasVersion=void 0;const i=n(8142),o=n(2928),s=n(2161),a=n(1990),l=n(5735),c=n(3101),u=n(3873),p=n(2900),d=n(3416),f=n(8209),h=n(4125),m=n(474),g=n(4335);var y;function b(e){return r(this,void 0,void 0,(function*(){const{document:t,config:n,customTypes:r,externalRefResolver:i,dereference:u=!1,skipRedoclyRegistryRefs:d=!1,removeUnusedComponents:f=!1,keepUrlRefs:h=!1}=e,y=(0,c.detectSpec)(t.parsed),b=(0,c.getMajorSpecVersion)(y),v=n.getRulesForOasVersion(b),w=(0,a.normalizeTypes)(n.extendTypes(null!=r?r:(0,c.getTypes)(y),y),n),k=(0,p.initRules)(v,n,\"preprocessors\",y),S=(0,p.initRules)(v,n,\"decorators\",y),E={problems:[],oasVersion:y,refTypes:new Map,visitorsData:{}};f&&S.push({severity:\"error\",ruleId:\"remove-unused-components\",visitor:b===c.SpecMajorVersion.OAS2?(0,m.RemoveUnusedComponents)({}):(0,g.RemoveUnusedComponents)({})});let O=yield(0,o.resolveDocument)({rootDocument:t,rootType:w.Root,externalRefResolver:i});k.length>0&&((0,l.walkDocument)({document:t,rootType:w.Root,normalizedVisitors:(0,s.normalizeVisitors)(k,w),resolvedRefMap:O,ctx:E}),O=yield(0,o.resolveDocument)({rootDocument:t,rootType:w.Root,externalRefResolver:i}));const _=(0,s.normalizeVisitors)([{severity:\"error\",ruleId:\"bundler\",visitor:x(b,u,d,t,O,h)},...S],w);return(0,l.walkDocument)({document:t,rootType:w.Root,normalizedVisitors:_,resolvedRefMap:O,ctx:E}),{bundle:t,problems:E.problems.map((e=>n.addProblemToIgnore(e))),fileDependencies:i.getFiles(),rootType:w.Root,refTypes:E.refTypes,visitorsData:E.visitorsData}}))}function v(e,t){switch(t){case c.SpecMajorVersion.OAS3:switch(e){case\"Schema\":return\"schemas\";case\"Parameter\":return\"parameters\";case\"Response\":return\"responses\";case\"Example\":return\"examples\";case\"RequestBody\":return\"requestBodies\";case\"Header\":return\"headers\";case\"SecuritySchema\":return\"securitySchemes\";case\"Link\":return\"links\";case\"Callback\":return\"callbacks\";default:return null}case c.SpecMajorVersion.OAS2:switch(e){case\"Schema\":return\"definitions\";case\"Parameter\":return\"parameters\";case\"Response\":return\"responses\";default:return null}case c.SpecMajorVersion.Async2:switch(e){case\"Schema\":return\"schemas\";case\"Parameter\":return\"parameters\";default:return null}}}function x(e,t,n,r,s,a){let l,p;const m={ref:{leave(i,l,c){if(!c.location||void 0===c.node)return void(0,d.reportUnresolvedRef)(c,l.report,l.location);if(c.location.source===r.source&&c.location.source===l.location.source&&\"scalar\"!==l.type.name&&!t)return;if(n&&(0,h.isRedoclyRegistryURL)(i.$ref))return;if(a&&(0,u.isAbsoluteUrl)(i.$ref))return;const p=v(l.type.name,e);p?t?(y(p,c,l),g(i,c,l)):(i.$ref=y(p,c,l),function(e,t,n){const i=(0,o.makeRefId)(n.location.source.absoluteRef,e.$ref);s.set(i,{document:r,isRemote:!1,node:t.node,nodePointer:e.$ref,resolved:!0})}(i,c,l)):g(i,c,l)}},Root:{enter(t,n){p=n.location,e===c.SpecMajorVersion.OAS3?l=t.components=t.components||{}:e===c.SpecMajorVersion.OAS2&&(l=t)}}};function g(e,t,n){if((0,f.isPlainObject)(t.node)){delete e.$ref;const n=Object.assign({},t.node,e);Object.assign(e,n)}else n.parent[n.key]=t.node}function y(t,n,r){l[t]=l[t]||{};const i=function(e,t,n){const[r,i]=[e.location.source.absoluteRef,e.location.pointer],o=l[t];let s=\"\";const a=i.slice(2).split(\"/\").filter(f.isTruthy);for(;a.length>0;)if(s=a.pop()+(s?`-${s}`:\"\"),!o||!o[s]||b(o[s],e,n))return s;if(s=(0,u.refBaseName)(r)+(s?`_${s}`:\"\"),!o[s]||b(o[s],e,n))return s;const c=s;let p=2;for(;o[s]&&!b(o[s],e,n);)s=`${c}-${p}`,p++;return o[s]||n.report({message:`Two schemas are referenced with the same name but different content. Renamed ${c} to ${s}.`,location:n.location,forceSeverity:\"warn\"}),s}(n,t,r);return l[t][i]=n.node,e===c.SpecMajorVersion.OAS3?`#/components/${t}/${i}`:`#/${t}/${i}`}function b(e,t,n){var r;return!(!(0,u.isRef)(e)||(null===(r=n.resolve(e,p.absolutePointer).location)||void 0===r?void 0:r.absolutePointer)!==t.location.absolutePointer)||i(e,t.node)}return e===c.SpecMajorVersion.OAS3&&(m.DiscriminatorMapping={leave(n,r){for(const i of Object.keys(n)){const o=n[i],s=r.resolve({$ref:o});if(!s.location||void 0===s.node)return void(0,d.reportUnresolvedRef)(s,r.report,r.location.child(i));const a=v(\"Schema\",e);t?y(a,s,r):n[i]=y(a,s,r)}}}),m}!function(e){e.Version2=\"oas2\",e.Version3_0=\"oas3_0\",e.Version3_1=\"oas3_1\"}(y||(t.OasVersion=y={})),t.bundle=function(e){return r(this,void 0,void 0,(function*(){const{ref:t,doc:n,externalRefResolver:r=new o.BaseResolver(e.config.resolve),base:i=null}=e;if(!t&&!n)throw new Error(\"Document or reference is required.\\n\");const s=void 0===n?yield r.resolveDocument(i,t,!0):n;if(s instanceof Error)throw s;return b(Object.assign(Object.assign({document:s},e),{config:e.config.styleguide,externalRefResolver:r}))}))},t.bundleFromString=function(e){return r(this,void 0,void 0,(function*(){const{source:t,absoluteRef:n,externalRefResolver:r=new o.BaseResolver(e.config.resolve)}=e,i=(0,o.makeDocumentFromString)(t,n||\"/\");return b(Object.assign(Object.assign({document:i},e),{externalRefResolver:r,config:e.config.styleguide}))}))},t.bundleDocument=b,t.mapTypeToComponent=v},8921:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.Config=t.StyleguideConfig=t.AVAILABLE_REGIONS=t.DOMAINS=t.DEFAULT_REGION=t.IGNORE_FILE=void 0;const r=n(7992),i=n(7975),o=n(970),s=n(8209),a=n(3101),l=n(1827),c=n(462),u=n(3873);t.IGNORE_FILE=\".redocly.lint-ignore.yaml\",t.DEFAULT_REGION=\"us\",t.DOMAINS=function(){const e={us:\"redocly.com\",eu:\"eu.redocly.com\"},t=l.env.REDOCLY_DOMAIN;return(null==t?void 0:t.endsWith(\".redocly.host\"))&&(e[t.split(\".\")[0]]=t),\"redoc.online\"===t&&(e[t]=t),e}(),t.AVAILABLE_REGIONS=Object.keys(t.DOMAINS);class p{constructor(e,n){this.rawConfig=e,this.configFile=n,this.ignore={},this._usedRules=new Set,this._usedVersions=new Set,this.plugins=e.plugins||[],this.doNotResolveExamples=!!e.doNotResolveExamples,this.recommendedFallback=e.recommendedFallback||!1,this.rules={[a.SpecVersion.OAS2]:Object.assign(Object.assign({},e.rules),e.oas2Rules),[a.SpecVersion.OAS3_0]:Object.assign(Object.assign({},e.rules),e.oas3_0Rules),[a.SpecVersion.OAS3_1]:Object.assign(Object.assign({},e.rules),e.oas3_1Rules),[a.SpecVersion.Async2]:Object.assign(Object.assign({},e.rules),e.async2Rules)},this.preprocessors={[a.SpecVersion.OAS2]:Object.assign(Object.assign({},e.preprocessors),e.oas2Preprocessors),[a.SpecVersion.OAS3_0]:Object.assign(Object.assign({},e.preprocessors),e.oas3_0Preprocessors),[a.SpecVersion.OAS3_1]:Object.assign(Object.assign({},e.preprocessors),e.oas3_1Preprocessors),[a.SpecVersion.Async2]:Object.assign(Object.assign({},e.preprocessors),e.async2Preprocessors)},this.decorators={[a.SpecVersion.OAS2]:Object.assign(Object.assign({},e.decorators),e.oas2Decorators),[a.SpecVersion.OAS3_0]:Object.assign(Object.assign({},e.decorators),e.oas3_0Decorators),[a.SpecVersion.OAS3_1]:Object.assign(Object.assign({},e.decorators),e.oas3_1Decorators),[a.SpecVersion.Async2]:Object.assign(Object.assign({},e.decorators),e.async2Decorators)},this.extendPaths=e.extendPaths||[],this.pluginPaths=e.pluginPaths||[],this.resolveIgnore(function(e){return e?(0,s.doesYamlFileExist)(e)?i.join(i.dirname(e),t.IGNORE_FILE):i.join(e,t.IGNORE_FILE):l.isBrowser?void 0:i.join(process.cwd(),t.IGNORE_FILE)}(n))}resolveIgnore(e){if(e&&(0,s.doesYamlFileExist)(e)){this.ignore=(0,o.parseYaml)(r.readFileSync(e,\"utf-8\"))||{};for(const t of Object.keys(this.ignore)){this.ignore[(0,u.isAbsoluteUrl)(t)?t:i.resolve(i.dirname(e),t)]=this.ignore[t];for(const e of Object.keys(this.ignore[t]))this.ignore[t][e]=new Set(this.ignore[t][e]);(0,u.isAbsoluteUrl)(t)||delete this.ignore[t]}}}saveIgnore(){const e=this.configFile?i.dirname(this.configFile):process.cwd(),n=i.join(e,t.IGNORE_FILE),a={};for(const t of Object.keys(this.ignore)){const n=a[(0,u.isAbsoluteUrl)(t)?t:(0,s.slash)(i.relative(e,t))]=this.ignore[t];for(const e of Object.keys(n))n[e]=Array.from(n[e])}r.writeFileSync(n,\"# This file instructs Redocly's linter to ignore the rules contained for specific parts of your API.\\n# See https://redoc.ly/docs/cli/ for more information.\\n\"+(0,o.stringifyYaml)(a))}addIgnore(e){const t=this.ignore,n=e.location[0];if(void 0===n.pointer)return;const r=t[n.source.absoluteRef]=t[n.source.absoluteRef]||{};(r[e.ruleId]=r[e.ruleId]||new Set).add(n.pointer)}addProblemToIgnore(e){const t=e.location[0];if(void 0===t.pointer)return e;const n=(this.ignore[t.source.absoluteRef]||{})[e.ruleId],r=n&&n.has(t.pointer);return r?Object.assign(Object.assign({},e),{ignored:r}):e}extendTypes(e,t){let n=e;for(const e of this.plugins)if(void 0!==e.typeExtension)switch(t){case a.SpecVersion.OAS3_0:case a.SpecVersion.OAS3_1:if(!e.typeExtension.oas3)continue;n=e.typeExtension.oas3(n,t);break;case a.SpecVersion.OAS2:if(!e.typeExtension.oas2)continue;n=e.typeExtension.oas2(n,t);break;case a.SpecVersion.Async2:if(!e.typeExtension.async2)continue;n=e.typeExtension.async2(n,t);break;default:throw new Error(\"Not implemented\")}return n}getRuleSettings(e,t){this._usedRules.add(e),this._usedVersions.add(t);const n=this.rules[t][e]||\"off\";return\"string\"==typeof n?{severity:n}:Object.assign({severity:\"error\"},n)}getPreprocessorSettings(e,t){this._usedRules.add(e),this._usedVersions.add(t);const n=this.preprocessors[t][e]||\"off\";return\"string\"==typeof n?{severity:\"on\"===n?\"error\":n}:Object.assign({severity:\"error\"},n)}getDecoratorSettings(e,t){this._usedRules.add(e),this._usedVersions.add(t);const n=this.decorators[t][e]||\"off\";return\"string\"==typeof n?{severity:\"on\"===n?\"error\":n}:Object.assign({severity:\"error\"},n)}getUnusedRules(){const e=[],t=[],n=[];for(const r of Array.from(this._usedVersions))e.push(...Object.keys(this.rules[r]).filter((e=>!this._usedRules.has(e)))),t.push(...Object.keys(this.decorators[r]).filter((e=>!this._usedRules.has(e)))),n.push(...Object.keys(this.preprocessors[r]).filter((e=>!this._usedRules.has(e))));return{rules:e,preprocessors:n,decorators:t}}getRulesForOasVersion(e){switch(e){case a.SpecMajorVersion.OAS3:const e=[];return this.plugins.forEach((t=>{var n;return(null===(n=t.preprocessors)||void 0===n?void 0:n.oas3)&&e.push(t.preprocessors.oas3)})),this.plugins.forEach((t=>{var n;return(null===(n=t.rules)||void 0===n?void 0:n.oas3)&&e.push(t.rules.oas3)})),this.plugins.forEach((t=>{var n;return(null===(n=t.decorators)||void 0===n?void 0:n.oas3)&&e.push(t.decorators.oas3)})),e;case a.SpecMajorVersion.OAS2:const t=[];return this.plugins.forEach((e=>{var n;return(null===(n=e.preprocessors)||void 0===n?void 0:n.oas2)&&t.push(e.preprocessors.oas2)})),this.plugins.forEach((e=>{var n;return(null===(n=e.rules)||void 0===n?void 0:n.oas2)&&t.push(e.rules.oas2)})),this.plugins.forEach((e=>{var n;return(null===(n=e.decorators)||void 0===n?void 0:n.oas2)&&t.push(e.decorators.oas2)})),t;case a.SpecMajorVersion.Async2:const n=[];return this.plugins.forEach((e=>{var t;return(null===(t=e.preprocessors)||void 0===t?void 0:t.async2)&&n.push(e.preprocessors.async2)})),this.plugins.forEach((e=>{var t;return(null===(t=e.rules)||void 0===t?void 0:t.async2)&&n.push(e.rules.async2)})),this.plugins.forEach((e=>{var t;return(null===(t=e.decorators)||void 0===t?void 0:t.async2)&&n.push(e.decorators.async2)})),n}}skipRules(e){for(const t of e||[])for(const e of Object.values(a.SpecVersion))this.rules[e][t]&&(this.rules[e][t]=\"off\")}skipPreprocessors(e){for(const t of e||[])for(const e of Object.values(a.SpecVersion))this.preprocessors[e][t]&&(this.preprocessors[e][t]=\"off\")}skipDecorators(e){for(const t of e||[])for(const e of Object.values(a.SpecVersion))this.decorators[e][t]&&(this.decorators[e][t]=\"off\")}}t.StyleguideConfig=p,t.Config=class{constructor(e,t){this.rawConfig=e,this.configFile=t,this.apis=e.apis||{},this.styleguide=new p(e.styleguide||{},t),this.theme=e.theme||{},this.resolve=(0,c.getResolveConfig)(null==e?void 0:e.resolve),this.region=e.region,this.organization=e.organization,this.files=e.files||[],this.telemetry=e.telemetry}}},2900:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.initRules=void 0;const r=n(8209);t.initRules=function(e,t,n,i){return e.flatMap((e=>Object.keys(e).map((r=>{const o=e[r],s=\"rules\"===n?t.getRuleSettings(r,i):\"preprocessors\"===n?t.getPreprocessorSettings(r,i):t.getDecoratorSettings(r,i);if(\"off\"===s.severity)return;const a=s.severity,l=o(s);return Array.isArray(l)?l.map((e=>({severity:a,ruleId:r,visitor:e}))):{severity:a,ruleId:r,visitor:l}})))).flatMap((e=>e)).filter(r.isDefined)}},462:function(e,t,n){\"use strict\";var r=this&&this.__rest||function(e,t){var n={};for(var r in e)Object.prototype.hasOwnProperty.call(e,r)&&t.indexOf(r)<0&&(n[r]=e[r]);if(null!=e&&\"function\"==typeof Object.getOwnPropertySymbols){var i=0;for(r=Object.getOwnPropertySymbols(e);it[e]));n[e]&&null===t&&(0,i.showWarningForDeprecatedField)(e),n[e]&&t&&n[t]&&(0,i.showErrorForDeprecatedField)(e,t),n[e]&&r&&n[r]&&(0,i.showErrorForDeprecatedField)(e,t,r),(n[e]||o)&&(0,i.showWarningForDeprecatedField)(e,t,r)}t.parsePresetName=function(e){if(e.indexOf(\"/\")>-1){const[t,n]=e.split(\"/\");return{pluginId:t,configName:n}}return{pluginId:\"\",configName:e}},t.transformApiDefinitionsToApis=a,t.prefixRules=function(e,t){if(!t)return e;const n={};for(const r of Object.keys(e))n[`${t}/${r}`]=e[r];return n},t.mergeExtends=function(e){const t={rules:{},oas2Rules:{},oas3_0Rules:{},oas3_1Rules:{},async2Rules:{},preprocessors:{},oas2Preprocessors:{},oas3_0Preprocessors:{},oas3_1Preprocessors:{},async2Preprocessors:{},decorators:{},oas2Decorators:{},oas3_0Decorators:{},oas3_1Decorators:{},async2Decorators:{},plugins:[],pluginPaths:[],extendPaths:[]};for(const n of e){if(n.extends)throw new Error(`'extends' is not supported in shared configs yet: ${JSON.stringify(n,null,2)}.`);Object.assign(t.rules,n.rules),Object.assign(t.oas2Rules,n.oas2Rules),(0,i.assignExisting)(t.oas2Rules,n.rules||{}),Object.assign(t.oas3_0Rules,n.oas3_0Rules),(0,i.assignExisting)(t.oas3_0Rules,n.rules||{}),Object.assign(t.oas3_1Rules,n.oas3_1Rules),(0,i.assignExisting)(t.oas3_1Rules,n.rules||{}),Object.assign(t.async2Rules,n.async2Rules),(0,i.assignExisting)(t.async2Rules,n.rules||{}),Object.assign(t.preprocessors,n.preprocessors),Object.assign(t.oas2Preprocessors,n.oas2Preprocessors),(0,i.assignExisting)(t.oas2Preprocessors,n.preprocessors||{}),Object.assign(t.oas3_0Preprocessors,n.oas3_0Preprocessors),(0,i.assignExisting)(t.oas3_0Preprocessors,n.preprocessors||{}),Object.assign(t.oas3_1Preprocessors,n.oas3_1Preprocessors),(0,i.assignExisting)(t.oas3_1Preprocessors,n.preprocessors||{}),Object.assign(t.async2Preprocessors,n.async2Preprocessors),(0,i.assignExisting)(t.async2Preprocessors,n.preprocessors||{}),Object.assign(t.decorators,n.decorators),Object.assign(t.oas2Decorators,n.oas2Decorators),(0,i.assignExisting)(t.oas2Decorators,n.decorators||{}),Object.assign(t.oas3_0Decorators,n.oas3_0Decorators),(0,i.assignExisting)(t.oas3_0Decorators,n.decorators||{}),Object.assign(t.oas3_1Decorators,n.oas3_1Decorators),(0,i.assignExisting)(t.oas3_1Decorators,n.decorators||{}),Object.assign(t.async2Decorators,n.async2Decorators),(0,i.assignExisting)(t.async2Decorators,n.decorators||{}),t.plugins.push(...n.plugins||[]),t.pluginPaths.push(...n.pluginPaths||[]),t.extendPaths.push(...new Set(n.extendPaths))}return t},t.getMergedConfig=function(e,t){var n,r,s,a,l,c,u,p;const d=[...Object.values(e.apis).map((e=>{var t;return null===(t=null==e?void 0:e.styleguide)||void 0===t?void 0:t.extendPaths})),null===(r=null===(n=e.rawConfig)||void 0===n?void 0:n.styleguide)||void 0===r?void 0:r.extendPaths].flat().filter(i.isTruthy),f=[...Object.values(e.apis).map((e=>{var t;return null===(t=null==e?void 0:e.styleguide)||void 0===t?void 0:t.pluginPaths})),null===(a=null===(s=e.rawConfig)||void 0===s?void 0:s.styleguide)||void 0===a?void 0:a.pluginPaths].flat().filter(i.isTruthy);return t?new o.Config(Object.assign(Object.assign({},e.rawConfig),{styleguide:Object.assign(Object.assign({},e.apis[t]?e.apis[t].styleguide:e.rawConfig.styleguide),{extendPaths:d,pluginPaths:f}),theme:Object.assign(Object.assign({},e.rawConfig.theme),null===(l=e.apis[t])||void 0===l?void 0:l.theme),files:[...e.files,...null!==(p=null===(u=null===(c=e.apis)||void 0===c?void 0:c[t])||void 0===u?void 0:u.files)&&void 0!==p?p:[]]}),e.configFile):e},t.checkForDeprecatedFields=u,t.transformConfig=function(e){var t,n;const i=[[\"apiDefinitions\",\"apis\",void 0],[\"referenceDocs\",\"openapi\",\"theme\"],[\"lint\",void 0,void 0],[\"styleguide\",void 0,void 0],[\"features.openapi\",\"openapi\",\"theme\"]];for(const[t,n,r]of i)u(t,n,e,r);const{apis:o,apiDefinitions:p,referenceDocs:d,lint:f}=e,h=r(e,[\"apis\",\"apiDefinitions\",\"referenceDocs\",\"lint\"]),{styleguideConfig:m,rawConfigRest:g}=l(h),y=Object.assign({theme:{openapi:Object.assign(Object.assign(Object.assign({},d),e[\"features.openapi\"]),null===(t=e.theme)||void 0===t?void 0:t.openapi),mockServer:Object.assign(Object.assign({},e[\"features.mockServer\"]),null===(n=e.theme)||void 0===n?void 0:n.mockServer)},apis:c(o)||a(p),styleguide:m||f},g);return function(e){var t,n;let r=Object.assign({},null===(t=e.styleguide)||void 0===t?void 0:t.rules);for(const t of Object.values(e.apis||{}))r=Object.assign(Object.assign({},r),null===(n=null==t?void 0:t.styleguide)||void 0===n?void 0:n.rules);for(const e of Object.keys(r))e.startsWith(\"assert/\")&&s.logger.warn(`\\nThe 'assert/' syntax in ${e} is deprecated. Update your configuration to use 'rule/' instead. Examples and more information: https://redocly.com/docs/cli/rules/configurable-rules/\\n`)}(y),y},t.getResolveConfig=function(e){var t,n;return{http:{headers:null!==(n=null===(t=null==e?void 0:e.http)||void 0===t?void 0:t.headers)&&void 0!==n?n:[],customFetch:void 0}}},t.getUniquePlugins=function(e){const t=new Set,n=[];for(const r of e)t.has(r.id)?r.id&&s.logger.warn(`Duplicate plugin id \"${s.colorize.red(r.id)}\".\\n`):(n.push(r),t.add(r.id));return n};class p extends Error{}t.ConfigValidationError=p},1827:function(e,t){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.env=t.isBrowser=void 0,t.isBrowser=\"undefined\"!=typeof window||\"undefined\"!=typeof self||\"undefined\"==typeof process,t.env=t.isBrowser?{}:{}||{}},970:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.stringifyYaml=t.parseYaml=void 0;const r=n(7210),i=r.JSON_SCHEMA.extend({implicit:[r.types.merge],explicit:[r.types.binary,r.types.omap,r.types.pairs,r.types.set]});t.parseYaml=(e,t)=>(0,r.load)(e,Object.assign({schema:i},t)),t.stringifyYaml=(e,t)=>(0,r.dump)(e,t)},2678:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.logger=t.colorize=t.colorOptions=void 0;const r=n(8825);var i=n(8825);Object.defineProperty(t,\"colorOptions\",{enumerable:!0,get:function(){return i.options}});const o=n(1827),s=n(8209);t.colorize=new Proxy(r,{get(e,t){return o.isBrowser?s.identity:e[t]}}),t.logger=new class{stderr(e){return process.stderr.write(e)}info(e){return o.isBrowser?console.log(e):this.stderr(e)}warn(e){return o.isBrowser?console.warn(e):this.stderr(t.colorize.yellow(e))}error(e){return o.isBrowser?console.error(e):this.stderr(t.colorize.red(e))}}},3101:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.getTypes=t.getMajorSpecVersion=t.detectSpec=t.SpecMajorVersion=t.SpecVersion=void 0;const r=n(4409),i=n(4154),o=n(2082),s=n(264);var a,l;!function(e){e.OAS2=\"oas2\",e.OAS3_0=\"oas3_0\",e.OAS3_1=\"oas3_1\",e.Async2=\"async2\"}(a||(t.SpecVersion=a={})),function(e){e.OAS2=\"oas2\",e.OAS3=\"oas3\",e.Async2=\"async2\"}(l||(t.SpecMajorVersion=l={}));const c={[a.OAS2]:r.Oas2Types,[a.OAS3_0]:i.Oas3Types,[a.OAS3_1]:o.Oas3_1Types,[a.Async2]:s.AsyncApi2Types};t.detectSpec=function(e){if(\"object\"!=typeof e)throw new Error(\"Document must be JSON object, got \"+typeof e);if(e.openapi&&\"string\"!=typeof e.openapi)throw new Error(`Invalid OpenAPI version: should be a string but got \"${typeof e.openapi}\"`);if(e.openapi&&e.openapi.startsWith(\"3.0\"))return a.OAS3_0;if(e.openapi&&e.openapi.startsWith(\"3.1\"))return a.OAS3_1;if(e.swagger&&\"2.0\"===e.swagger)return a.OAS2;if(e.openapi||e.swagger)throw new Error(`Unsupported OpenAPI version: ${e.openapi||e.swagger}`);if(e.asyncapi&&e.asyncapi.startsWith(\"2.\"))return a.Async2;if(e.asyncapi)throw new Error(`Unsupported AsyncAPI version: ${e.asyncapi}`);throw new Error(\"Unsupported specification\")},t.getMajorSpecVersion=function(e){return e===a.OAS2?l.OAS2:e===a.Async2?l.Async2:l.OAS3},t.getTypes=function(e){return c[e]}},4125:function(e,t,n){\"use strict\";var r=this&&this.__awaiter||function(e,t,n,r){return new(n||(n=Promise))((function(i,o){function s(e){try{l(r.next(e))}catch(e){o(e)}}function a(e){try{l(r.throw(e))}catch(e){o(e)}}function l(e){var t;e.done?i(e.value):(t=e.value,t instanceof n?t:new n((function(e){e(t)}))).then(s,a)}l((r=r.apply(e,t||[])).next())}))};Object.defineProperty(t,\"__esModule\",{value:!0}),t.isRedoclyRegistryURL=t.RedoclyClient=void 0;const i=n(3986),o=n(7975),s=n(2941),a=n(919),l=n(8921),c=n(1827),u=n(8209),p=n(2678),d=\".redocly-config.json\";t.RedoclyClient=class{constructor(e){this.accessTokens={},this.region=this.loadRegion(e),this.loadTokens(),this.domain=e?l.DOMAINS[e]:c.env.REDOCLY_DOMAIN||l.DOMAINS[l.DEFAULT_REGION],c.env.REDOCLY_DOMAIN=this.domain,this.registryApi=new a.RegistryApi(this.accessTokens,this.region)}loadRegion(e){if(e&&!l.DOMAINS[e])throw new Error(`Invalid argument: region in config file.\\nGiven: ${p.colorize.green(e)}, choices: \"us\", \"eu\".`);return c.env.REDOCLY_DOMAIN?l.AVAILABLE_REGIONS.find((e=>l.DOMAINS[e]===c.env.REDOCLY_DOMAIN))||l.DEFAULT_REGION:e||l.DEFAULT_REGION}getRegion(){return this.region}hasTokens(){return(0,u.isNotEmptyObject)(this.accessTokens)}hasToken(){return!!this.accessTokens[this.region]}getAuthorizationHeader(){return r(this,void 0,void 0,(function*(){return this.accessTokens[this.region]}))}setAccessTokens(e){this.accessTokens=e}loadTokens(){const e=(0,o.resolve)((0,s.homedir)(),d),t=this.readCredentialsFile(e);(0,u.isNotEmptyObject)(t)&&this.setAccessTokens(Object.assign(Object.assign({},t),t.token&&!t[this.region]&&{[this.region]:t.token})),c.env.REDOCLY_AUTHORIZATION&&this.setAccessTokens(Object.assign(Object.assign({},this.accessTokens),{[this.region]:c.env.REDOCLY_AUTHORIZATION}))}getAllTokens(){return Object.entries(this.accessTokens).filter((([e])=>l.AVAILABLE_REGIONS.includes(e))).map((([e,t])=>({region:e,token:t})))}getValidTokens(){return r(this,void 0,void 0,(function*(){const e=this.getAllTokens(),t=yield Promise.allSettled(e.map((({token:e,region:t})=>this.verifyToken(e,t))));return e.filter(((e,n)=>\"fulfilled\"===t[n].status)).map((({token:e,region:t})=>({token:e,region:t,valid:!0})))}))}getTokens(){return r(this,void 0,void 0,(function*(){return this.hasTokens()?yield this.getValidTokens():[]}))}isAuthorizedWithRedoclyByRegion(){return r(this,void 0,void 0,(function*(){if(!this.hasTokens())return!1;const e=this.accessTokens[this.region];if(!e)return!1;try{return yield this.verifyToken(e,this.region),!0}catch(e){return!1}}))}isAuthorizedWithRedocly(){return r(this,void 0,void 0,(function*(){return this.hasTokens()&&(0,u.isNotEmptyObject)(yield this.getValidTokens())}))}readCredentialsFile(e){return(0,i.existsSync)(e)?JSON.parse((0,i.readFileSync)(e,\"utf-8\")):{}}verifyToken(e,t,n=!1){return r(this,void 0,void 0,(function*(){return this.registryApi.authStatus(e,t,n)}))}login(e,t=!1){return r(this,void 0,void 0,(function*(){const n=(0,o.resolve)((0,s.homedir)(),d);try{yield this.verifyToken(e,this.region,t)}catch(e){throw new Error(\"Authorization failed. Please check if you entered a valid API key.\")}const r=Object.assign(Object.assign({},this.readCredentialsFile(n)),{[this.region]:e,token:e});this.accessTokens=r,this.registryApi.setAccessTokens(r),(0,i.writeFileSync)(n,JSON.stringify(r,null,2))}))}logout(){const e=(0,o.resolve)((0,s.homedir)(),d);(0,i.existsSync)(e)&&(0,i.unlinkSync)(e)}},t.isRedoclyRegistryURL=function(e){const t=c.env.REDOCLY_DOMAIN||l.DOMAINS[l.DEFAULT_REGION],n=\"redocly.com\"===t?\"redoc.ly\":t;return!(!e.startsWith(`https://api.${t}/registry/`)&&!e.startsWith(`https://api.${n}/registry/`))}},919:function(e,t,n){\"use strict\";var r=this&&this.__awaiter||function(e,t,n,r){return new(n||(n=Promise))((function(i,o){function s(e){try{l(r.next(e))}catch(e){o(e)}}function a(e){try{l(r.throw(e))}catch(e){o(e)}}function l(e){var t;e.done?i(e.value):(t=e.value,t instanceof n?t:new n((function(e){e(t)}))).then(s,a)}l((r=r.apply(e,t||[])).next())}))};Object.defineProperty(t,\"__esModule\",{value:!0}),t.RegistryApi=void 0;const i=n(8381),o=n(8921),s=n(8209),a=n(2079).rE;t.RegistryApi=class{constructor(e,t){this.accessTokens=e,this.region=t}get accessToken(){return(0,s.isNotEmptyObject)(this.accessTokens)&&this.accessTokens[this.region]}getBaseUrl(e=o.DEFAULT_REGION){return`https://api.${o.DOMAINS[e]}/registry`}setAccessTokens(e){return this.accessTokens=e,this}request(e=\"\",t={},n){var o,s;return r(this,void 0,void 0,(function*(){const r=\"undefined\"!=typeof process&&(null===(o={})||void 0===o?void 0:o.REDOCLY_CLI_COMMAND)||\"\",l=\"undefined\"!=typeof process&&(null===(s={})||void 0===s?void 0:s.REDOCLY_ENVIRONMENT)||\"\",c=Object.assign({},t.headers||{},{\"x-redocly-cli-version\":a,\"user-agent\":`redocly-cli / ${a} ${r} ${l}`});if(!c.hasOwnProperty(\"authorization\"))throw new Error(\"Unauthorized\");const u=yield(0,i.default)(`${this.getBaseUrl(n)}${e}`,Object.assign({},t,{headers:c}));if(401===u.status)throw new Error(\"Unauthorized\");if(404===u.status){const e=yield u.json();throw new Error(e.code)}return u}))}authStatus(e,t,n=!1){return r(this,void 0,void 0,(function*(){try{const n=yield this.request(\"\",{headers:{authorization:e}},t);return yield n.json()}catch(e){throw n&&console.log(e),e}}))}prepareFileUpload({organizationId:e,name:t,version:n,filesHash:i,filename:o,isUpsert:s}){return r(this,void 0,void 0,(function*(){const r=yield this.request(`/${e}/${t}/${n}/prepare-file-upload`,{method:\"POST\",headers:{\"content-type\":\"application/json\",authorization:this.accessToken},body:JSON.stringify({filesHash:i,filename:o,isUpsert:s})},this.region);if(r.ok)return r.json();throw new Error(\"Could not prepare file upload\")}))}pushApi({organizationId:e,name:t,version:n,rootFilePath:i,filePaths:o,branch:s,isUpsert:a,isPublic:l,batchId:c,batchSize:u}){return r(this,void 0,void 0,(function*(){if(!(yield this.request(`/${e}/${t}/${n}`,{method:\"PUT\",headers:{\"content-type\":\"application/json\",authorization:this.accessToken},body:JSON.stringify({rootFilePath:i,filePaths:o,branch:s,isUpsert:a,isPublic:l,batchId:c,batchSize:u})},this.region)).ok)throw new Error(\"Could not push api\")}))}}},3873:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.isAnchor=t.isMappingRef=t.isAbsoluteUrl=t.refBaseName=t.pointerBaseName=t.parsePointer=t.parseRef=t.escapePointer=t.unescapePointer=t.Location=t.isRef=t.joinPointer=void 0;const r=n(8209);function i(e,t){return\"\"===e&&(e=\"#/\"),\"/\"===e[e.length-1]?e+t:e+\"/\"+t}t.joinPointer=i,t.isRef=function(e){return e&&\"string\"==typeof e.$ref};class o{constructor(e,t){this.source=e,this.pointer=t}child(e){return new o(this.source,i(this.pointer,(Array.isArray(e)?e:[e]).map(a).join(\"/\")))}key(){return Object.assign(Object.assign({},this),{reportOnKey:!0})}get absolutePointer(){return this.source.absoluteRef+(\"#/\"===this.pointer?\"\":this.pointer)}}function s(e){return decodeURIComponent(e.replace(/~1/g,\"/\").replace(/~0/g,\"~\"))}function a(e){return\"number\"==typeof e?e:e.replace(/~/g,\"~0\").replace(/\\//g,\"~1\")}t.Location=o,t.unescapePointer=s,t.escapePointer=a,t.parseRef=function(e){const[t,n]=e.split(\"#/\");return{uri:t||null,pointer:n?n.split(\"/\").map(s).filter(r.isTruthy):[]}},t.parsePointer=function(e){return e.substr(2).split(\"/\").map(s)},t.pointerBaseName=function(e){const t=e.split(\"/\");return t[t.length-1]},t.refBaseName=function(e){const t=e.split(/[\\/\\\\]/);return t[t.length-1].replace(/\\.[^.]+$/,\"\")},t.isAbsoluteUrl=function(e){return e.startsWith(\"http://\")||e.startsWith(\"https://\")},t.isMappingRef=function(e){return e.startsWith(\"#\")||e.startsWith(\"https://\")||e.startsWith(\"http://\")||e.startsWith(\"./\")||e.startsWith(\"../\")||e.indexOf(\"/\")>-1},t.isAnchor=function(e){return/^#[A-Za-z][A-Za-z0-9\\-_:.]*$/.test(e)}},2928:function(e,t,n){\"use strict\";var r=this&&this.__awaiter||function(e,t,n,r){return new(n||(n=Promise))((function(i,o){function s(e){try{l(r.next(e))}catch(e){o(e)}}function a(e){try{l(r.throw(e))}catch(e){o(e)}}function l(e){var t;e.done?i(e.value):(t=e.value,t instanceof n?t:new n((function(e){e(t)}))).then(s,a)}l((r=r.apply(e,t||[])).next())}))};Object.defineProperty(t,\"__esModule\",{value:!0}),t.resolveDocument=t.BaseResolver=t.makeDocumentFromString=t.makeRefId=t.YamlParseError=t.ResolveError=t.Source=void 0;const i=n(7411),o=n(7975),s=n(3873),a=n(1990),l=n(8209);class c{constructor(e,t,n){this.absoluteRef=e,this.body=t,this.mimeType=n}getAst(e){var t;return void 0===this._ast&&(this._ast=null!==(t=e(this.body,{filename:this.absoluteRef}))&&void 0!==t?t:void 0,this._ast&&0===this._ast.kind&&\"\"===this._ast.value&&1!==this._ast.startPosition&&(this._ast.startPosition=1,this._ast.endPosition=1)),this._ast}getLines(){return void 0===this._lines&&(this._lines=this.body.split(/\\r\\n|[\\n\\r]/g)),this._lines}}t.Source=c;class u extends Error{constructor(e){super(e.message),this.originalError=e,Object.setPrototypeOf(this,u.prototype)}}t.ResolveError=u;const p=/\\((\\d+):(\\d+)\\)$/;class d extends Error{constructor(e,t){super(e.message.split(\"\\n\")[0]),this.originalError=e,this.source=t,Object.setPrototypeOf(this,d.prototype);const[,n,r]=this.message.match(p)||[];this.line=parseInt(n,10),this.col=parseInt(r,10)}}function f(e,t){return e+\"::\"+t}function h(e,t){return{prev:e,node:t}}t.YamlParseError=d,t.makeRefId=f,t.makeDocumentFromString=function(e,t){const n=new c(t,e);try{return{source:n,parsed:(0,l.parseYaml)(e,{filename:t})}}catch(e){throw new d(e,n)}},t.BaseResolver=class{constructor(e={http:{headers:[]}}){this.config=e,this.cache=new Map}getFiles(){return new Set(Array.from(this.cache.keys()))}resolveExternalRef(e,t){return(0,s.isAbsoluteUrl)(t)?t:e&&(0,s.isAbsoluteUrl)(e)?new URL(t,e).href:o.resolve(e?o.dirname(e):process.cwd(),t)}loadExternalRef(e){return r(this,void 0,void 0,(function*(){try{if((0,s.isAbsoluteUrl)(e)){const{body:t,mimeType:n}=yield(0,l.readFileFromUrl)(e,this.config.http);return new c(e,t,n)}{if(i.lstatSync(e).isDirectory())throw new Error(`Expected a file but received a folder at ${e}`);const t=yield i.promises.readFile(e,\"utf-8\");return new c(e,t.replace(/\\r\\n/g,\"\\n\"))}}catch(e){throw e.message=e.message.replace(\", lstat\",\"\"),new u(e)}}))}parseDocument(e,t=!1){var n;const r=e.absoluteRef.substr(e.absoluteRef.lastIndexOf(\".\"));if(![\".json\",\".json\",\".yml\",\".yaml\"].includes(r)&&!(null===(n=e.mimeType)||void 0===n?void 0:n.match(/(json|yaml|openapi)/))&&!t)return{source:e,parsed:e.body};try{return{source:e,parsed:(0,l.parseYaml)(e.body,{filename:e.absoluteRef})}}catch(t){throw new d(t,e)}}resolveDocument(e,t,n=!1){return r(this,void 0,void 0,(function*(){const r=this.resolveExternalRef(e,t),i=this.cache.get(r);if(i)return i;const o=this.loadExternalRef(r).then((e=>this.parseDocument(e,n)));return this.cache.set(r,o),o}))}};const m={name:\"unknown\",properties:{}},g={name:\"scalar\",properties:{}};t.resolveDocument=function(e){return r(this,void 0,void 0,(function*(){const{rootDocument:t,externalRefResolver:n,rootType:i}=e,o=new Map,c=new Set,u=[];let p;!function e(t,i,p,d){const y=i.source.absoluteRef,b=new Map;function v(e,t,i){return r(this,void 0,void 0,(function*(){if(function(e,t){for(;e;){if(e.node===t)return!0;e=e.prev}return!1}(i.prev,t))throw new Error(\"Self-referencing circular pointer\");if((0,s.isAnchor)(t.$ref)){yield(0,l.nextTick)();const n={resolved:!0,isRemote:!1,node:b.get(t.$ref),document:e,nodePointer:t.$ref},r=f(e.source.absoluteRef,t.$ref);return o.set(r,n),n}const{uri:r,pointer:a}=(0,s.parseRef)(t.$ref),c=null!==r;let u;try{u=c?yield n.resolveDocument(e.source.absoluteRef,r):e}catch(n){const r={resolved:!1,isRemote:c,document:void 0,error:n},i=f(e.source.absoluteRef,t.$ref);return o.set(i,r),r}let p={resolved:!0,document:u,isRemote:c,node:e.parsed,nodePointer:\"#/\"},d=u.parsed;const m=a;for(const e of m){if(\"object\"!=typeof d){d=void 0;break}if(void 0!==d[e])d=d[e],p.nodePointer=(0,s.joinPointer)(p.nodePointer,(0,s.escapePointer)(e));else{if(!(0,s.isRef)(d)){d=void 0;break}if(p=yield v(u,d,h(i,d)),u=p.document||u,\"object\"!=typeof p.node){d=void 0;break}d=p.node[e],p.nodePointer=(0,s.joinPointer)(p.nodePointer,(0,s.escapePointer)(e))}}p.node=d,p.document=u;const g=f(e.source.absoluteRef,t.$ref);return p.document&&(0,s.isRef)(d)&&(p=yield v(p.document,d,h(i,d))),o.set(g,p),Object.assign({},p)}))}!function t(n,r,o){if(\"object\"!=typeof n||null===n)return;const l=`${r.name}::${o}`;if(c.has(l))return;c.add(l);const[p,d]=Object.entries(n).find((([e])=>\"$anchor\"===e))||[];if(d&&b.set(`#${d}`,n),Array.isArray(n)){const e=r.items;if(void 0===e&&r!==m&&r!==a.SpecExtension)return;for(let r=0;r{t.resolved&&e(t.node,t.document,t.nodePointer,r)}));u.push(t)}}}(t,d,y+p)}(t.parsed,t,\"#/\",i);do{p=yield Promise.all(u)}while(u.length!==p.length);return o}))}},3416:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.reportUnresolvedRef=t.NoUnresolvedRefs=void 0;const r=n(2928);function i(e,t,n){var i;const o=e.error;o instanceof r.YamlParseError&&t({message:\"Failed to parse: \"+o.message,location:{source:o.source,pointer:void 0,start:{col:o.col,line:o.line}}});const s=null===(i=e.error)||void 0===i?void 0:i.message;t({location:n,message:\"Can't resolve $ref\"+(s?\": \"+s:\"\")})}t.NoUnresolvedRefs=()=>({ref:{leave(e,{report:t,location:n},r){void 0===r.node&&i(r,t,n)}},DiscriminatorMapping(e,{report:t,resolve:n,location:r}){for(const o of Object.keys(e)){const s=n({$ref:e[o]});if(void 0!==s.node)return;i(s,t,r.child(o))}}}),t.reportUnresolvedRef=i},474:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.RemoveUnusedComponents=void 0;const r=n(8209);t.RemoveUnusedComponents=()=>{const e=new Map;function t(t,n,r){var i;e.set(t.absolutePointer,{used:(null===(i=e.get(t.absolutePointer))||void 0===i?void 0:i.used)||!1,componentType:n,name:r})}return{ref:{leave(t,{type:n,resolve:r,key:i}){if([\"Schema\",\"Parameter\",\"Response\",\"SecurityScheme\"].includes(n.name)){const n=r(t);if(!n.location)return;const[o,s]=n.location.absolutePointer.split(\"#\",2),a=`${o}#${s.split(\"/\").slice(0,3).join(\"/\")}`;e.set(a,{used:!0,name:i.toString()})}}},Root:{leave(t,n){const i=n.getVisitorData();i.removedCount=0;const o=new Set;e.forEach((e=>{const{used:n,name:r,componentType:s}=e;!n&&s&&(o.add(s),delete t[s][r],i.removedCount++)}));for(const e of o)(0,r.isEmptyObject)(t[e])&&delete t[e]}},NamedSchemas:{Schema(e,{location:n,key:r}){e.allOf||t(n,\"definitions\",r.toString())}},NamedParameters:{Parameter(e,{location:n,key:r}){t(n,\"parameters\",r.toString())}},NamedResponses:{Response(e,{location:n,key:r}){t(n,\"responses\",r.toString())}},NamedSecuritySchemes:{SecurityScheme(e,{location:n,key:r}){t(n,\"securityDefinitions\",r.toString())}}}}},4335:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.RemoveUnusedComponents=void 0;const r=n(8209);t.RemoveUnusedComponents=()=>{const e=new Map;function t(t,n,r){var i;e.set(t.absolutePointer,{used:(null===(i=e.get(t.absolutePointer))||void 0===i?void 0:i.used)||!1,componentType:n,name:r})}return{ref:{leave(t,{type:n,resolve:r,key:i}){if([\"Schema\",\"Header\",\"Parameter\",\"Response\",\"Example\",\"RequestBody\"].includes(n.name)){const n=r(t);if(!n.location)return;const[o,s]=n.location.absolutePointer.split(\"#\",2),a=`${o}#${s.split(\"/\").slice(0,4).join(\"/\")}`;e.set(a,{used:!0,name:i.toString()})}}},Root:{leave(t,n){const i=n.getVisitorData();i.removedCount=0,e.forEach((e=>{const{used:n,componentType:o,name:s}=e;if(!n&&o&&t.components){const e=t.components[o];delete e[s],i.removedCount++,(0,r.isEmptyObject)(e)&&delete t.components[o]}})),(0,r.isEmptyObject)(t.components)&&delete t.components}},NamedSchemas:{Schema(e,{location:n,key:r}){e.allOf||t(n,\"schemas\",r.toString())}},NamedParameters:{Parameter(e,{location:n,key:r}){t(n,\"parameters\",r.toString())}},NamedResponses:{Response(e,{location:n,key:r}){t(n,\"responses\",r.toString())}},NamedExamples:{Example(e,{location:n,key:r}){t(n,\"examples\",r.toString())}},NamedRequestBodies:{RequestBody(e,{location:n,key:r}){t(n,\"requestBodies\",r.toString())}},NamedHeaders:{Header(e,{location:n,key:r}){t(n,\"headers\",r.toString())}}}}},264:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.AsyncApi2Types=void 0;const r=n(1990),i=n(3873),o={properties:{},allowed(){return[\"http\",\"ws\",\"kafka\",\"anypointmq\",\"amqp\",\"amqp1\",\"mqtt\",\"mqtt5\",\"nats\",\"jms\",\"sns\",\"solace\",\"sqs\",\"stomp\",\"redis\",\"mercure\",\"ibmmq\",\"googlepubsub\",\"pulsar\"]},additionalProperties:{type:\"object\"}},s={properties:{},allowed(){return[\"http\",\"ws\",\"kafka\",\"anypointmq\",\"amqp\",\"amqp1\",\"mqtt\",\"mqtt5\",\"nats\",\"jms\",\"sns\",\"solace\",\"sqs\",\"stomp\",\"redis\",\"mercure\",\"ibmmq\",\"googlepubsub\",\"pulsar\"]},additionalProperties:{type:\"object\"}},a={properties:{},allowed(){return[\"http\",\"ws\",\"kafka\",\"anypointmq\",\"amqp\",\"amqp1\",\"mqtt\",\"mqtt5\",\"nats\",\"jms\",\"sns\",\"solace\",\"sqs\",\"stomp\",\"redis\",\"mercure\",\"ibmmq\",\"googlepubsub\",\"pulsar\"]},additionalProperties:{type:\"object\"}},l={properties:{},allowed(){return[\"http\",\"ws\",\"kafka\",\"anypointmq\",\"amqp\",\"amqp1\",\"mqtt\",\"mqtt5\",\"nats\",\"jms\",\"sns\",\"solace\",\"sqs\",\"stomp\",\"redis\",\"mercure\",\"ibmmq\",\"googlepubsub\",\"pulsar\"]},additionalProperties:{type:\"object\"}},c={properties:{$id:{type:\"string\"},id:{type:\"string\"},$schema:{type:\"string\"},definitions:\"NamedSchemas\",$defs:\"NamedSchemas\",$vocabulary:{type:\"string\"},externalDocs:\"ExternalDocs\",discriminator:\"Discriminator\",myArbitraryKeyword:{type:\"boolean\"},title:{type:\"string\"},multipleOf:{type:\"number\",minimum:0},maximum:{type:\"number\"},minimum:{type:\"number\"},exclusiveMaximum:{type:\"number\"},exclusiveMinimum:{type:\"number\"},maxLength:{type:\"integer\",minimum:0},minLength:{type:\"integer\",minimum:0},pattern:{type:\"string\"},maxItems:{type:\"integer\",minimum:0},minItems:{type:\"integer\",minimum:0},uniqueItems:{type:\"boolean\"},maxProperties:{type:\"integer\",minimum:0},minProperties:{type:\"integer\",minimum:0},required:{type:\"array\",items:{type:\"string\"}},enum:{type:\"array\"},type:e=>Array.isArray(e)?{type:\"array\",items:{enum:[\"object\",\"array\",\"string\",\"number\",\"integer\",\"boolean\",\"null\"]}}:{enum:[\"object\",\"array\",\"string\",\"number\",\"integer\",\"boolean\",\"null\"]},allOf:(0,r.listOf)(\"Schema\"),anyOf:(0,r.listOf)(\"Schema\"),oneOf:(0,r.listOf)(\"Schema\"),not:\"Schema\",if:\"Schema\",then:\"Schema\",else:\"Schema\",dependentSchemas:(0,r.listOf)(\"Schema\"),prefixItems:(0,r.listOf)(\"Schema\"),contains:\"Schema\",minContains:{type:\"integer\",minimum:0},maxContains:{type:\"integer\",minimum:0},patternProperties:{type:\"object\"},propertyNames:\"Schema\",unevaluatedItems:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",unevaluatedProperties:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",summary:{type:\"string\"},properties:\"SchemaProperties\",items:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",additionalProperties:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",description:{type:\"string\"},format:{type:\"string\"},contentEncoding:{type:\"string\"},contentMediaType:{type:\"string\"},default:null,readOnly:{type:\"boolean\"},writeOnly:{type:\"boolean\"},examples:{type:\"array\"},example:{isExample:!0},deprecated:{type:\"boolean\"},const:null,$comment:{type:\"string\"},dependencies:{type:\"object\"}}},u={properties:{},additionalProperties:e=>(0,i.isMappingRef)(e)?{type:\"string\",directResolveAs:\"Schema\"}:{type:\"string\"}},p={properties:{type:{enum:[\"userPassword\",\"apiKey\",\"X509\",\"symmetricEncryption\",\"asymmetricEncryption\",\"httpApiKey\",\"http\",\"oauth2\",\"openIdConnect\",\"plain\",\"scramSha256\",\"scramSha512\",\"gssapi\"]},description:{type:\"string\"},name:{type:\"string\"},in:{type:\"string\",enum:[\"query\",\"header\",\"cookie\",\"user\",\"password\"]},scheme:{type:\"string\"},bearerFormat:{type:\"string\"},flows:\"SecuritySchemeFlows\",openIdConnectUrl:{type:\"string\"}},required(e){switch(null==e?void 0:e.type){case\"apiKey\":return[\"type\",\"in\"];case\"httpApiKey\":return[\"type\",\"name\",\"in\"];case\"http\":return[\"type\",\"scheme\"];case\"oauth2\":return[\"type\",\"flows\"];case\"openIdConnect\":return[\"type\",\"openIdConnectUrl\"];default:return[\"type\"]}},allowed(e){switch(null==e?void 0:e.type){case\"apiKey\":return[\"type\",\"in\",\"description\"];case\"httpApiKey\":return[\"type\",\"name\",\"in\",\"description\"];case\"http\":return[\"type\",\"scheme\",\"bearerFormat\",\"description\"];case\"oauth2\":return[\"type\",\"flows\",\"description\"];case\"openIdConnect\":return[\"type\",\"openIdConnectUrl\",\"description\"];default:return[\"type\",\"description\"]}},extensionsPrefix:\"x-\"},d={properties:{}};o.properties.http=d;const f={properties:{}};s.properties.http=f;const h={properties:{headers:\"Schema\",bindingVersion:{type:\"string\"}}};a.properties.http=h;const m={properties:{type:{type:\"string\"},method:{type:\"string\",enum:[\"GET\",\"POST\",\"PUT\",\"PATCH\",\"DELETE\",\"HEAD\",\"OPTIONS\",\"CONNECT\",\"TRACE\"]},headers:\"Schema\",bindingVersion:{type:\"string\"}}};l.properties.http=m;const g={properties:{method:{type:\"string\"},query:\"Schema\",headers:\"Schema\",bindingVersion:{type:\"string\"}}};o.properties.ws=g;const y={properties:{}};s.properties.ws=y;const b={properties:{}};a.properties.ws=b;const v={properties:{}};l.properties.ws=v;const x={properties:{topic:{type:\"string\"},partitions:{type:\"integer\"},replicas:{type:\"integer\"},topicConfiguration:\"KafkaTopicConfiguration\",bindingVersion:{type:\"string\"}}};o.properties.kafka=x;const w={properties:{}};s.properties.kafka=w;const k={properties:{key:\"Schema\",schemaIdLocation:{type:\"string\"},schemaIdPayloadEncoding:{type:\"string\"},schemaLookupStrategy:{type:\"string\"},bindingVersion:{type:\"string\"}}};a.properties.kafka=k;const S={properties:{groupId:\"Schema\",clientId:\"Schema\",bindingVersion:{type:\"string\"}}};l.properties.kafka=S;const E={properties:{destination:{type:\"string\"},destinationType:{type:\"string\"},bindingVersion:{type:\"string\"}}};o.properties.anypointmq=E;const O={properties:{}};s.properties.anypointmq=O;const _={properties:{headers:\"Schema\",bindingVersion:{type:\"string\"}}};a.properties.anypointmq=_;const A={properties:{}};l.properties.anypointmq=A;const C={properties:{}};o.properties.amqp=C;const j={properties:{}};s.properties.amqp=j;const P={properties:{contentEncoding:{type:\"string\"},messageType:{type:\"string\"},bindingVersion:{type:\"string\"}}};a.properties.amqp=P;const T={properties:{expiration:{type:\"integer\"},userId:{type:\"string\"},cc:{type:\"array\",items:{type:\"string\"}},priority:{type:\"integer\"},deliveryMode:{type:\"integer\"},mandatory:{type:\"boolean\"},bcc:{type:\"array\",items:{type:\"string\"}},replyTo:{type:\"string\"},timestamp:{type:\"boolean\"},ack:{type:\"boolean\"},bindingVersion:{type:\"string\"}}};l.properties.amqp=T;const I={properties:{}};o.properties.amqp1=I;const R={properties:{}};s.properties.amqp1=R;const N={properties:{}};a.properties.amqp1=N;const $={properties:{}};l.properties.amqp1=$;const L={properties:{qos:{type:\"integer\"},retain:{type:\"boolean\"},bindingVersion:{type:\"string\"}}};o.properties.mqtt=L;const D={properties:{clientId:{type:\"string\"},cleanSession:{type:\"boolean\"},lastWill:\"MqttServerBindingLastWill\",keepAlive:{type:\"integer\"},bindingVersion:{type:\"string\"}}};s.properties.mqtt=D;const M={properties:{bindingVersion:{type:\"string\"}}};a.properties.mqtt=M;const F={properties:{qos:{type:\"integer\"},retain:{type:\"boolean\"},bindingVersion:{type:\"string\"}}};l.properties.mqtt=F;const z={properties:{}};o.properties.mqtt5=z;const B={properties:{}};s.properties.mqtt5=B;const U={properties:{}};a.properties.mqtt5=U;const q={properties:{}};l.properties.mqtt5=q;const V={properties:{}};o.properties.nats=V;const W={properties:{}};s.properties.nats=W;const H={properties:{}};a.properties.nats=H;const Y={properties:{queue:{type:\"string\"},bindingVersion:{type:\"string\"}}};l.properties.nats=Y;const G={properties:{destination:{type:\"string\"},destinationType:{type:\"string\"},bindingVersion:{type:\"string\"}}};o.properties.jms=G;const Q={properties:{}};s.properties.jms=Q;const X={properties:{headers:\"Schema\",bindingVersion:{type:\"string\"}}};a.properties.jms=X;const K={properties:{headers:\"Schema\",bindingVersion:{type:\"string\"}}};l.properties.jms=K;const Z={properties:{}};o.properties.solace=Z;const J={properties:{bindingVersion:{type:\"string\"},msgVpn:{type:\"string\"}}};s.properties.solace=J;const ee={properties:{}};a.properties.solace=ee;const te={properties:{bindingVersion:{type:\"string\"},destinations:(0,r.listOf)(\"SolaceDestination\")}};l.properties.solace=te;const ne={properties:{}};o.properties.stomp=ne;const re={properties:{}};s.properties.stomp=re;const ie={properties:{}};a.properties.stomp=ie;const oe={properties:{}};l.properties.stomp=oe;const se={properties:{}};o.properties.redis=se;const ae={properties:{}};s.properties.redis=ae;const le={properties:{}};a.properties.redis=le;const ce={properties:{}};l.properties.redis=ce;const ue={properties:{}};o.properties.mercure=ue;const pe={properties:{}};s.properties.mercure=pe;const de={properties:{}};a.properties.mercure=de;const fe={properties:{}};l.properties.mercure=fe,t.AsyncApi2Types={Root:{properties:{asyncapi:null,info:\"Info\",id:{type:\"string\"},servers:\"ServerMap\",channels:\"ChannelMap\",components:\"Components\",tags:\"TagList\",externalDocs:\"ExternalDocs\",defaultContentType:{type:\"string\"}},required:[\"asyncapi\",\"channels\",\"info\"]},Tag:{properties:{name:{type:\"string\"},description:{type:\"string\"},externalDocs:\"ExternalDocs\"},required:[\"name\"]},TagList:(0,r.listOf)(\"Tag\"),ServerMap:{properties:{},additionalProperties:(e,t)=>t.match(/^[A-Za-z0-9_\\-]+$/)?\"Server\":void 0},ExternalDocs:{properties:{description:{type:\"string\"},url:{type:\"string\"}},required:[\"url\"]},Server:{properties:{url:{type:\"string\"},protocol:{type:\"string\"},protocolVersion:{type:\"string\"},description:{type:\"string\"},variables:\"ServerVariablesMap\",security:\"SecurityRequirementList\",bindings:\"ServerBindings\",tags:\"TagList\"},required:[\"url\",\"protocol\"]},ServerVariable:{properties:{enum:{type:\"array\",items:{type:\"string\"}},default:{type:\"string\"},description:{type:\"string\"},examples:{type:\"array\",items:{type:\"string\"}}},required:[]},ServerVariablesMap:(0,r.mapOf)(\"ServerVariable\"),SecurityRequirement:{properties:{},additionalProperties:{type:\"array\",items:{type:\"string\"}}},SecurityRequirementList:(0,r.listOf)(\"SecurityRequirement\"),Info:{properties:{title:{type:\"string\"},version:{type:\"string\"},description:{type:\"string\"},termsOfService:{type:\"string\"},contact:\"Contact\",license:\"License\"},required:[\"title\",\"version\"]},Contact:{properties:{name:{type:\"string\"},url:{type:\"string\"},email:{type:\"string\"}}},License:{properties:{name:{type:\"string\"},url:{type:\"string\"}},required:[\"name\"]},HttpServerBinding:f,HttpChannelBinding:d,HttpMessageBinding:h,HttpOperationBinding:m,WsServerBinding:y,WsChannelBinding:g,WsMessageBinding:b,WsOperationBinding:v,KafkaServerBinding:w,KafkaTopicConfiguration:{properties:{\"cleanup.policy\":{type:\"array\",items:{enum:[\"delete\",\"compact\"]}},\"retention.ms\":{type:\"integer\"},\"retention.bytes\":{type:\"integer\"},\"delete.retention.ms\":{type:\"integer\"},\"max.message.bytes\":{type:\"integer\"}}},KafkaChannelBinding:x,KafkaMessageBinding:k,KafkaOperationBinding:S,AnypointmqServerBinding:O,AnypointmqChannelBinding:E,AnypointmqMessageBinding:_,AnypointmqOperationBinding:A,AmqpServerBinding:j,AmqpChannelBinding:C,AmqpMessageBinding:P,AmqpOperationBinding:T,Amqp1ServerBinding:R,Amqp1ChannelBinding:I,Amqp1MessageBinding:N,Amqp1OperationBinding:$,MqttServerBindingLastWill:{properties:{topic:{type:\"string\"},qos:{type:\"integer\"},message:{type:\"string\"},retain:{type:\"boolean\"}}},MqttServerBinding:D,MqttChannelBinding:L,MqttMessageBinding:M,MqttOperationBinding:F,Mqtt5ServerBinding:B,Mqtt5ChannelBinding:z,Mqtt5MessageBinding:U,Mqtt5OperationBinding:q,NatsServerBinding:W,NatsChannelBinding:V,NatsMessageBinding:H,NatsOperationBinding:Y,JmsServerBinding:Q,JmsChannelBinding:G,JmsMessageBinding:X,JmsOperationBinding:K,SolaceServerBinding:J,SolaceChannelBinding:Z,SolaceMessageBinding:ee,SolaceDestination:{properties:{destinationType:{type:\"string\",enum:[\"queue\",\"topic\"]},deliveryMode:{type:\"string\",enum:[\"direct\",\"persistent\"]},\"queue.name\":{type:\"string\"},\"queue.topicSubscriptions\":{type:\"array\",items:{type:\"string\"}},\"queue.accessType\":{type:\"string\",enum:[\"exclusive\",\"nonexclusive\"]},\"queue.maxMsgSpoolSize\":{type:\"string\"},\"queue.maxTtl\":{type:\"string\"},\"topic.topicSubscriptions\":{type:\"array\",items:{type:\"string\"}}}},SolaceOperationBinding:te,StompServerBinding:re,StompChannelBinding:ne,StompMessageBinding:ie,StompOperationBinding:oe,RedisServerBinding:ae,RedisChannelBinding:se,RedisMessageBinding:le,RedisOperationBinding:ce,MercureServerBinding:pe,MercureChannelBinding:ue,MercureMessageBinding:de,MercureOperationBinding:fe,ServerBindings:s,ChannelBindings:o,ChannelMap:{properties:{},additionalProperties:\"Channel\"},Channel:{properties:{description:{type:\"string\"},subscribe:\"Operation\",publish:\"Operation\",parameters:\"ParametersMap\",bindings:\"ChannelBindings\",servers:{type:\"array\",items:{type:\"string\"}}}},Parameter:{properties:{description:{type:\"string\"},schema:\"Schema\",location:{type:\"string\"}}},ParametersMap:(0,r.mapOf)(\"Parameter\"),Operation:{properties:{tags:{type:\"array\",items:{type:\"string\"}},summary:{type:\"string\"},description:{type:\"string\"},externalDocs:\"ExternalDocs\",operationId:{type:\"string\"},security:\"SecurityRequirementList\",bindings:\"OperationBindings\",traits:\"OperationTraitList\",message:\"Message\"},required:[]},Schema:c,MessageExample:{properties:{payload:{isExample:!0},summary:{type:\"string\"},name:{type:\"string\"},headers:{type:\"object\"}}},SchemaProperties:{properties:{},additionalProperties:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\"},DiscriminatorMapping:u,Discriminator:{properties:{propertyName:{type:\"string\"},mapping:\"DiscriminatorMapping\"},required:[\"propertyName\"]},Components:{properties:{messages:\"NamedMessages\",parameters:\"NamedParameters\",schemas:\"NamedSchemas\",correlationIds:\"NamedCorrelationIds\",messageTraits:\"NamedMessageTraits\",operationTraits:\"NamedOperationTraits\",streamHeaders:\"NamedStreamHeaders\",securitySchemes:\"NamedSecuritySchemes\",servers:\"ServerMap\",serverVariables:\"ServerVariablesMap\",channels:\"ChannelMap\",serverBindings:\"ServerBindings\",channelBindings:\"ChannelBindings\",operationBindings:\"OperationBindings\",messageBindings:\"MessageBindings\"}},NamedSchemas:(0,r.mapOf)(\"Schema\"),NamedMessages:(0,r.mapOf)(\"Message\"),NamedMessageTraits:(0,r.mapOf)(\"MessageTrait\"),NamedOperationTraits:(0,r.mapOf)(\"OperationTrait\"),NamedParameters:(0,r.mapOf)(\"Parameter\"),NamedSecuritySchemes:(0,r.mapOf)(\"SecurityScheme\"),NamedCorrelationIds:(0,r.mapOf)(\"CorrelationId\"),NamedStreamHeaders:(0,r.mapOf)(\"StreamHeader\"),ImplicitFlow:{properties:{refreshUrl:{type:\"string\"},scopes:{type:\"object\",additionalProperties:{type:\"string\"}},authorizationUrl:{type:\"string\"}},required:[\"authorizationUrl\",\"scopes\"]},PasswordFlow:{properties:{refreshUrl:{type:\"string\"},scopes:{type:\"object\",additionalProperties:{type:\"string\"}},tokenUrl:{type:\"string\"}},required:[\"tokenUrl\",\"scopes\"]},ClientCredentials:{properties:{refreshUrl:{type:\"string\"},scopes:{type:\"object\",additionalProperties:{type:\"string\"}},tokenUrl:{type:\"string\"}},required:[\"tokenUrl\",\"scopes\"]},AuthorizationCode:{properties:{refreshUrl:{type:\"string\"},authorizationUrl:{type:\"string\"},scopes:{type:\"object\",additionalProperties:{type:\"string\"}},tokenUrl:{type:\"string\"}},required:[\"authorizationUrl\",\"tokenUrl\",\"scopes\"]},SecuritySchemeFlows:{properties:{implicit:\"ImplicitFlow\",password:\"PasswordFlow\",clientCredentials:\"ClientCredentials\",authorizationCode:\"AuthorizationCode\"}},SecurityScheme:p,Message:{properties:{messageId:{type:\"string\"},headers:\"Schema\",payload:\"Schema\",correlationId:\"CorrelationId\",schemaFormat:{type:\"string\"},contentType:{type:\"string\"},name:{type:\"string\"},title:{type:\"string\"},summary:{type:\"string\"},description:{type:\"string\"},tags:\"TagList\",externalDocs:\"ExternalDocs\",bindings:\"MessageBindings\",traits:\"MessageTraitList\"},additionalProperties:{}},MessageBindings:a,OperationBindings:l,OperationTrait:{properties:{tags:{type:\"array\",items:{type:\"string\"}},summary:{type:\"string\"},description:{type:\"string\"},externalDocs:\"ExternalDocs\",operationId:{type:\"string\"},security:\"SecurityRequirementList\",bindings:\"OperationBindings\"},required:[]},OperationTraitList:(0,r.listOf)(\"OperationTrait\"),MessageTrait:{properties:{messageId:{type:\"string\"},headers:\"Schema\",correlationId:\"CorrelationId\",schemaFormat:{type:\"string\"},contentType:{type:\"string\"},name:{type:\"string\"},title:{type:\"string\"},summary:{type:\"string\"},description:{type:\"string\"},tags:\"TagList\",externalDocs:\"ExternalDocs\",bindings:\"MessageBindings\"},additionalProperties:{}},MessageTraitList:(0,r.listOf)(\"MessageTrait\"),CorrelationId:{properties:{description:{type:\"string\"},location:{type:\"string\"}},required:[\"location\"]}}},1990:function(e,t){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.isNamedType=t.normalizeTypes=t.SpecExtension=t.mapOf=t.listOf=void 0,t.listOf=function(e){return{name:`${e}List`,properties:{},items:e}},t.mapOf=function(e){return{name:`${e}Map`,properties:{},additionalProperties:()=>e}},t.SpecExtension={name:\"SpecExtension\",properties:{},additionalProperties:{resolvable:!0}},t.normalizeTypes=function(e,n={}){const r={};for(const t of Object.keys(e))r[t]=Object.assign(Object.assign({},e[t]),{name:t});for(const e of Object.values(r))i(e);return r.SpecExtension=t.SpecExtension,r;function i(e){if(e.additionalProperties&&(e.additionalProperties=o(e.additionalProperties)),e.items&&(e.items=o(e.items)),e.properties){const t={};for(const[r,i]of Object.entries(e.properties))t[r]=o(i),n.doNotResolveExamples&&i&&i.isExample&&(t[r]=Object.assign(Object.assign({},i),{resolvable:!1}));e.properties=t}}function o(e){if(\"string\"==typeof e){if(!r[e])throw new Error(`Unknown type name found: ${e}`);return r[e]}return\"function\"==typeof e?(t,n)=>o(e(t,n)):e&&e.name?(i(e=Object.assign({},e)),e):e&&e.directResolveAs?Object.assign(Object.assign({},e),{directResolveAs:o(e.directResolveAs)}):e}},t.isNamedType=function(e){return\"string\"==typeof(null==e?void 0:e.name)}},4409:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.Oas2Types=void 0;const r=n(1990),i=/^[0-9][0-9Xx]{2}$/,o={properties:{name:{type:\"string\"},in:{type:\"string\",enum:[\"query\",\"header\",\"path\",\"formData\",\"body\"]},description:{type:\"string\"},required:{type:\"boolean\"},schema:\"Schema\",type:{type:\"string\",enum:[\"string\",\"number\",\"integer\",\"boolean\",\"array\",\"file\"]},format:{type:\"string\"},allowEmptyValue:{type:\"boolean\"},items:\"ParameterItems\",collectionFormat:{type:\"string\",enum:[\"csv\",\"ssv\",\"tsv\",\"pipes\",\"multi\"]},default:null,maximum:{type:\"integer\"},exclusiveMaximum:{type:\"boolean\"},minimum:{type:\"integer\"},exclusiveMinimum:{type:\"boolean\"},maxLength:{type:\"integer\"},minLength:{type:\"integer\"},pattern:{type:\"string\"},maxItems:{type:\"integer\"},minItems:{type:\"integer\"},uniqueItems:{type:\"boolean\"},enum:{type:\"array\"},multipleOf:{type:\"number\"},\"x-example\":\"Example\",\"x-examples\":\"ExamplesMap\"},required(e){return e&&e.in?\"body\"===e.in?[\"name\",\"in\",\"schema\"]:\"array\"===e.type?[\"name\",\"in\",\"type\",\"items\"]:[\"name\",\"in\",\"type\"]:[\"name\",\"in\"]},extensionsPrefix:\"x-\"},s={properties:{type:{type:\"string\",enum:[\"string\",\"number\",\"integer\",\"boolean\",\"array\"]},format:{type:\"string\"},items:\"ParameterItems\",collectionFormat:{type:\"string\",enum:[\"csv\",\"ssv\",\"tsv\",\"pipes\",\"multi\"]},default:null,maximum:{type:\"integer\"},exclusiveMaximum:{type:\"boolean\"},minimum:{type:\"integer\"},exclusiveMinimum:{type:\"boolean\"},maxLength:{type:\"integer\"},minLength:{type:\"integer\"},pattern:{type:\"string\"},maxItems:{type:\"integer\"},minItems:{type:\"integer\"},uniqueItems:{type:\"boolean\"},enum:{type:\"array\"},multipleOf:{type:\"number\"}},required(e){return e&&\"array\"===e.type?[\"type\",\"items\"]:[\"type\"]},extensionsPrefix:\"x-\"},a={properties:{default:\"Response\"},additionalProperties:(e,t)=>i.test(t)?\"Response\":void 0},l={properties:{description:{type:\"string\"},schema:\"Schema\",headers:(0,r.mapOf)(\"Header\"),examples:\"Examples\",\"x-summary\":{type:\"string\"}},required:[\"description\"],extensionsPrefix:\"x-\"},c={properties:{description:{type:\"string\"},type:{type:\"string\",enum:[\"string\",\"number\",\"integer\",\"boolean\",\"array\"]},format:{type:\"string\"},items:\"ParameterItems\",collectionFormat:{type:\"string\",enum:[\"csv\",\"ssv\",\"tsv\",\"pipes\",\"multi\"]},default:null,maximum:{type:\"integer\"},exclusiveMaximum:{type:\"boolean\"},minimum:{type:\"integer\"},exclusiveMinimum:{type:\"boolean\"},maxLength:{type:\"integer\"},minLength:{type:\"integer\"},pattern:{type:\"string\"},maxItems:{type:\"integer\"},minItems:{type:\"integer\"},uniqueItems:{type:\"boolean\"},enum:{type:\"array\"},multipleOf:{type:\"number\"}},required(e){return e&&\"array\"===e.type?[\"type\",\"items\"]:[\"type\"]},extensionsPrefix:\"x-\"},u={properties:{format:{type:\"string\"},title:{type:\"string\"},description:{type:\"string\"},default:null,multipleOf:{type:\"number\"},maximum:{type:\"number\"},minimum:{type:\"number\"},exclusiveMaximum:{type:\"boolean\"},exclusiveMinimum:{type:\"boolean\"},maxLength:{type:\"number\"},minLength:{type:\"number\"},pattern:{type:\"string\"},maxItems:{type:\"number\"},minItems:{type:\"number\"},uniqueItems:{type:\"boolean\"},maxProperties:{type:\"number\"},minProperties:{type:\"number\"},required:{type:\"array\",items:{type:\"string\"}},enum:{type:\"array\"},type:{type:\"string\",enum:[\"object\",\"array\",\"string\",\"number\",\"integer\",\"boolean\",\"null\"]},items:e=>Array.isArray(e)?(0,r.listOf)(\"Schema\"):\"Schema\",allOf:(0,r.listOf)(\"Schema\"),properties:\"SchemaProperties\",additionalProperties:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",discriminator:{type:\"string\"},readOnly:{type:\"boolean\"},xml:\"Xml\",externalDocs:\"ExternalDocs\",example:{isExample:!0},\"x-tags\":{type:\"array\",items:{type:\"string\"}},\"x-nullable\":{type:\"boolean\"},\"x-extendedDiscriminator\":{type:\"string\"},\"x-additionalPropertiesName\":{type:\"string\"},\"x-explicitMappingOnly\":{type:\"boolean\"},\"x-enumDescriptions\":\"EnumDescriptions\"},extensionsPrefix:\"x-\"},p={properties:{type:{enum:[\"basic\",\"apiKey\",\"oauth2\"]},description:{type:\"string\"},name:{type:\"string\"},in:{type:\"string\",enum:[\"query\",\"header\"]},flow:{enum:[\"implicit\",\"password\",\"application\",\"accessCode\"]},authorizationUrl:{type:\"string\"},tokenUrl:{type:\"string\"},scopes:{type:\"object\",additionalProperties:{type:\"string\"}},\"x-defaultClientId\":{type:\"string\"}},required(e){switch(null==e?void 0:e.type){case\"apiKey\":return[\"type\",\"name\",\"in\"];case\"oauth2\":switch(null==e?void 0:e.flow){case\"implicit\":return[\"type\",\"flow\",\"authorizationUrl\",\"scopes\"];case\"accessCode\":return[\"type\",\"flow\",\"authorizationUrl\",\"tokenUrl\",\"scopes\"];case\"application\":case\"password\":return[\"type\",\"flow\",\"tokenUrl\",\"scopes\"];default:return[\"type\",\"flow\",\"scopes\"]}default:return[\"type\"]}},allowed(e){switch(null==e?void 0:e.type){case\"basic\":return[\"type\",\"description\"];case\"apiKey\":return[\"type\",\"name\",\"in\",\"description\"];case\"oauth2\":switch(null==e?void 0:e.flow){case\"implicit\":return[\"type\",\"flow\",\"authorizationUrl\",\"description\",\"scopes\"];case\"accessCode\":return[\"type\",\"flow\",\"authorizationUrl\",\"tokenUrl\",\"description\",\"scopes\"];case\"application\":case\"password\":return[\"type\",\"flow\",\"tokenUrl\",\"description\",\"scopes\"];default:return[\"type\",\"flow\",\"tokenUrl\",\"authorizationUrl\",\"description\",\"scopes\"]}default:return[\"type\",\"description\"]}},extensionsPrefix:\"x-\"};t.Oas2Types={Root:{properties:{swagger:{type:\"string\"},info:\"Info\",host:{type:\"string\"},basePath:{type:\"string\"},schemes:{type:\"array\",items:{type:\"string\"}},consumes:{type:\"array\",items:{type:\"string\"}},produces:{type:\"array\",items:{type:\"string\"}},paths:\"Paths\",definitions:\"NamedSchemas\",parameters:\"NamedParameters\",responses:\"NamedResponses\",securityDefinitions:\"NamedSecuritySchemes\",security:\"SecurityRequirementList\",tags:\"TagList\",externalDocs:\"ExternalDocs\",\"x-servers\":\"XServerList\",\"x-tagGroups\":\"TagGroups\",\"x-ignoredHeaderParameters\":{type:\"array\",items:{type:\"string\"}}},required:[\"swagger\",\"paths\",\"info\"],extensionsPrefix:\"x-\"},Tag:{properties:{name:{type:\"string\"},description:{type:\"string\"},externalDocs:\"ExternalDocs\",\"x-traitTag\":{type:\"boolean\"},\"x-displayName\":{type:\"string\"}},required:[\"name\"],extensionsPrefix:\"x-\"},TagList:(0,r.listOf)(\"Tag\"),TagGroups:(0,r.listOf)(\"TagGroup\"),TagGroup:{properties:{name:{type:\"string\"},tags:{type:\"array\",items:{type:\"string\"}}}},ExternalDocs:{properties:{description:{type:\"string\"},url:{type:\"string\"}},required:[\"url\"],extensionsPrefix:\"x-\"},Example:{properties:{value:{isExample:!0},summary:{type:\"string\"},description:{type:\"string\"},externalValue:{type:\"string\"}},extensionsPrefix:\"x-\"},ExamplesMap:(0,r.mapOf)(\"Example\"),EnumDescriptions:{properties:{},additionalProperties:{type:\"string\"}},SecurityRequirement:{properties:{},additionalProperties:{type:\"array\",items:{type:\"string\"}}},SecurityRequirementList:(0,r.listOf)(\"SecurityRequirement\"),Info:{properties:{title:{type:\"string\"},description:{type:\"string\"},termsOfService:{type:\"string\"},contact:\"Contact\",license:\"License\",version:{type:\"string\"},\"x-logo\":\"Logo\"},required:[\"title\",\"version\"],extensionsPrefix:\"x-\"},Contact:{properties:{name:{type:\"string\"},url:{type:\"string\"},email:{type:\"string\"}},extensionsPrefix:\"x-\"},License:{properties:{name:{type:\"string\"},url:{type:\"string\"}},required:[\"name\"],extensionsPrefix:\"x-\"},Logo:{properties:{url:{type:\"string\"},altText:{type:\"string\"},backgroundColor:{type:\"string\"},href:{type:\"string\"}},extensionsPrefix:\"x-\"},Paths:{properties:{},additionalProperties:(e,t)=>t.startsWith(\"/\")?\"PathItem\":void 0},PathItem:{properties:{$ref:{type:\"string\"},parameters:\"ParameterList\",get:\"Operation\",put:\"Operation\",post:\"Operation\",delete:\"Operation\",options:\"Operation\",head:\"Operation\",patch:\"Operation\"},extensionsPrefix:\"x-\"},Parameter:o,ParameterItems:s,ParameterList:(0,r.listOf)(\"Parameter\"),Operation:{properties:{tags:{type:\"array\",items:{type:\"string\"}},summary:{type:\"string\"},description:{type:\"string\"},externalDocs:\"ExternalDocs\",operationId:{type:\"string\"},consumes:{type:\"array\",items:{type:\"string\"}},produces:{type:\"array\",items:{type:\"string\"}},parameters:\"ParameterList\",responses:\"Responses\",schemes:{type:\"array\",items:{type:\"string\"}},deprecated:{type:\"boolean\"},security:\"SecurityRequirementList\",\"x-codeSamples\":\"XCodeSampleList\",\"x-code-samples\":\"XCodeSampleList\",\"x-hideTryItPanel\":{type:\"boolean\"}},required:[\"responses\"],extensionsPrefix:\"x-\"},Examples:{properties:{},additionalProperties:{isExample:!0}},Header:c,Responses:a,Response:l,Schema:u,Xml:{properties:{name:{type:\"string\"},namespace:{type:\"string\"},prefix:{type:\"string\"},attribute:{type:\"boolean\"},wrapped:{type:\"boolean\"}},extensionsPrefix:\"x-\"},SchemaProperties:{properties:{},additionalProperties:\"Schema\"},NamedSchemas:(0,r.mapOf)(\"Schema\"),NamedResponses:(0,r.mapOf)(\"Response\"),NamedParameters:(0,r.mapOf)(\"Parameter\"),NamedSecuritySchemes:(0,r.mapOf)(\"SecurityScheme\"),SecurityScheme:p,XCodeSample:{properties:{lang:{type:\"string\"},label:{type:\"string\"},source:{type:\"string\"}}},XCodeSampleList:(0,r.listOf)(\"XCodeSample\"),XServerList:(0,r.listOf)(\"XServer\"),XServer:{properties:{url:{type:\"string\"},description:{type:\"string\"}},required:[\"url\"]}}},4154:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.Oas3Types=void 0;const r=n(1990),i=n(3873),o=/^[0-9][0-9Xx]{2}$/,s={properties:{default:\"Response\"},additionalProperties:(e,t)=>o.test(t)?\"Response\":void 0},a={properties:{externalDocs:\"ExternalDocs\",discriminator:\"Discriminator\",title:{type:\"string\"},multipleOf:{type:\"number\",minimum:0},maximum:{type:\"number\"},minimum:{type:\"number\"},exclusiveMaximum:{type:\"boolean\"},exclusiveMinimum:{type:\"boolean\"},maxLength:{type:\"integer\",minimum:0},minLength:{type:\"integer\",minimum:0},pattern:{type:\"string\"},maxItems:{type:\"integer\",minimum:0},minItems:{type:\"integer\",minimum:0},uniqueItems:{type:\"boolean\"},maxProperties:{type:\"integer\",minimum:0},minProperties:{type:\"integer\",minimum:0},required:{type:\"array\",items:{type:\"string\"}},enum:{type:\"array\"},type:{enum:[\"object\",\"array\",\"string\",\"number\",\"integer\",\"boolean\",\"null\"]},allOf:(0,r.listOf)(\"Schema\"),anyOf:(0,r.listOf)(\"Schema\"),oneOf:(0,r.listOf)(\"Schema\"),not:\"Schema\",properties:\"SchemaProperties\",items:e=>Array.isArray(e)?(0,r.listOf)(\"Schema\"):\"Schema\",additionalItems:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",additionalProperties:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",description:{type:\"string\"},format:{type:\"string\"},default:null,nullable:{type:\"boolean\"},readOnly:{type:\"boolean\"},writeOnly:{type:\"boolean\"},xml:\"Xml\",example:{isExample:!0},deprecated:{type:\"boolean\"},\"x-tags\":{type:\"array\",items:{type:\"string\"}},\"x-additionalPropertiesName\":{type:\"string\"},\"x-explicitMappingOnly\":{type:\"boolean\"}},extensionsPrefix:\"x-\"},l={properties:{},additionalProperties:e=>(0,i.isMappingRef)(e)?{type:\"string\",directResolveAs:\"Schema\"}:{type:\"string\"}},c={properties:{type:{enum:[\"apiKey\",\"http\",\"oauth2\",\"openIdConnect\"]},description:{type:\"string\"},name:{type:\"string\"},in:{type:\"string\",enum:[\"query\",\"header\",\"cookie\"]},scheme:{type:\"string\"},bearerFormat:{type:\"string\"},flows:\"OAuth2Flows\",openIdConnectUrl:{type:\"string\"},\"x-defaultClientId\":{type:\"string\"}},required(e){switch(null==e?void 0:e.type){case\"apiKey\":return[\"type\",\"name\",\"in\"];case\"http\":return[\"type\",\"scheme\"];case\"oauth2\":return[\"type\",\"flows\"];case\"openIdConnect\":return[\"type\",\"openIdConnectUrl\"];default:return[\"type\"]}},allowed(e){switch(null==e?void 0:e.type){case\"apiKey\":return[\"type\",\"name\",\"in\",\"description\"];case\"http\":return[\"type\",\"scheme\",\"bearerFormat\",\"description\"];case\"oauth2\":return[\"type\",\"flows\",\"description\"];case\"openIdConnect\":return[\"type\",\"openIdConnectUrl\",\"description\"];default:return[\"type\",\"description\"]}},extensionsPrefix:\"x-\"};t.Oas3Types={Root:{properties:{openapi:null,info:\"Info\",servers:\"ServerList\",security:\"SecurityRequirementList\",tags:\"TagList\",externalDocs:\"ExternalDocs\",paths:\"Paths\",components:\"Components\",\"x-webhooks\":\"WebhooksMap\",\"x-tagGroups\":\"TagGroups\",\"x-ignoredHeaderParameters\":{type:\"array\",items:{type:\"string\"}}},required:[\"openapi\",\"paths\",\"info\"],extensionsPrefix:\"x-\"},Tag:{properties:{name:{type:\"string\"},description:{type:\"string\"},externalDocs:\"ExternalDocs\",\"x-traitTag\":{type:\"boolean\"},\"x-displayName\":{type:\"string\"}},required:[\"name\"],extensionsPrefix:\"x-\"},TagList:(0,r.listOf)(\"Tag\"),TagGroups:(0,r.listOf)(\"TagGroup\"),TagGroup:{properties:{name:{type:\"string\"},tags:{type:\"array\",items:{type:\"string\"}}},extensionsPrefix:\"x-\"},ExternalDocs:{properties:{description:{type:\"string\"},url:{type:\"string\"}},required:[\"url\"],extensionsPrefix:\"x-\"},Server:{properties:{url:{type:\"string\"},description:{type:\"string\"},variables:\"ServerVariablesMap\"},required:[\"url\"],extensionsPrefix:\"x-\"},ServerList:(0,r.listOf)(\"Server\"),ServerVariable:{properties:{enum:{type:\"array\",items:{type:\"string\"}},default:{type:\"string\"},description:{type:\"string\"}},required:[\"default\"],extensionsPrefix:\"x-\"},ServerVariablesMap:(0,r.mapOf)(\"ServerVariable\"),SecurityRequirement:{properties:{},additionalProperties:{type:\"array\",items:{type:\"string\"}}},SecurityRequirementList:(0,r.listOf)(\"SecurityRequirement\"),Info:{properties:{title:{type:\"string\"},version:{type:\"string\"},description:{type:\"string\"},termsOfService:{type:\"string\"},contact:\"Contact\",license:\"License\",\"x-logo\":\"Logo\"},required:[\"title\",\"version\"],extensionsPrefix:\"x-\"},Contact:{properties:{name:{type:\"string\"},url:{type:\"string\"},email:{type:\"string\"}},extensionsPrefix:\"x-\"},License:{properties:{name:{type:\"string\"},url:{type:\"string\"}},required:[\"name\"],extensionsPrefix:\"x-\"},Paths:{properties:{},additionalProperties:(e,t)=>t.startsWith(\"/\")?\"PathItem\":void 0},PathItem:{properties:{$ref:{type:\"string\"},servers:\"ServerList\",parameters:\"ParameterList\",summary:{type:\"string\"},description:{type:\"string\"},get:\"Operation\",put:\"Operation\",post:\"Operation\",delete:\"Operation\",options:\"Operation\",head:\"Operation\",patch:\"Operation\",trace:\"Operation\"},extensionsPrefix:\"x-\"},Parameter:{properties:{name:{type:\"string\"},in:{enum:[\"query\",\"header\",\"path\",\"cookie\"]},description:{type:\"string\"},required:{type:\"boolean\"},deprecated:{type:\"boolean\"},allowEmptyValue:{type:\"boolean\"},style:{enum:[\"form\",\"simple\",\"label\",\"matrix\",\"spaceDelimited\",\"pipeDelimited\",\"deepObject\"]},explode:{type:\"boolean\"},allowReserved:{type:\"boolean\"},schema:\"Schema\",example:{isExample:!0},examples:\"ExamplesMap\",content:\"MediaTypesMap\"},required:[\"name\",\"in\"],requiredOneOf:[\"schema\",\"content\"],extensionsPrefix:\"x-\"},ParameterList:(0,r.listOf)(\"Parameter\"),Operation:{properties:{tags:{type:\"array\",items:{type:\"string\"}},summary:{type:\"string\"},description:{type:\"string\"},externalDocs:\"ExternalDocs\",operationId:{type:\"string\"},parameters:\"ParameterList\",security:\"SecurityRequirementList\",servers:\"ServerList\",requestBody:\"RequestBody\",responses:\"Responses\",deprecated:{type:\"boolean\"},callbacks:\"CallbacksMap\",\"x-codeSamples\":\"XCodeSampleList\",\"x-code-samples\":\"XCodeSampleList\",\"x-hideTryItPanel\":{type:\"boolean\"}},required:[\"responses\"],extensionsPrefix:\"x-\"},Callback:(0,r.mapOf)(\"PathItem\"),CallbacksMap:(0,r.mapOf)(\"Callback\"),RequestBody:{properties:{description:{type:\"string\"},required:{type:\"boolean\"},content:\"MediaTypesMap\"},required:[\"content\"],extensionsPrefix:\"x-\"},MediaTypesMap:{properties:{},additionalProperties:\"MediaType\"},MediaType:{properties:{schema:\"Schema\",example:{isExample:!0},examples:\"ExamplesMap\",encoding:\"EncodingMap\"},extensionsPrefix:\"x-\"},Example:{properties:{value:{isExample:!0},summary:{type:\"string\"},description:{type:\"string\"},externalValue:{type:\"string\"}},extensionsPrefix:\"x-\"},ExamplesMap:(0,r.mapOf)(\"Example\"),Encoding:{properties:{contentType:{type:\"string\"},headers:\"HeadersMap\",style:{enum:[\"form\",\"simple\",\"label\",\"matrix\",\"spaceDelimited\",\"pipeDelimited\",\"deepObject\"]},explode:{type:\"boolean\"},allowReserved:{type:\"boolean\"}},extensionsPrefix:\"x-\"},EncodingMap:(0,r.mapOf)(\"Encoding\"),EnumDescriptions:{properties:{},additionalProperties:{type:\"string\"}},Header:{properties:{description:{type:\"string\"},required:{type:\"boolean\"},deprecated:{type:\"boolean\"},allowEmptyValue:{type:\"boolean\"},style:{enum:[\"form\",\"simple\",\"label\",\"matrix\",\"spaceDelimited\",\"pipeDelimited\",\"deepObject\"]},explode:{type:\"boolean\"},allowReserved:{type:\"boolean\"},schema:\"Schema\",example:{isExample:!0},examples:\"ExamplesMap\",content:\"MediaTypesMap\"},requiredOneOf:[\"schema\",\"content\"],extensionsPrefix:\"x-\"},HeadersMap:(0,r.mapOf)(\"Header\"),Responses:s,Response:{properties:{description:{type:\"string\"},headers:\"HeadersMap\",content:\"MediaTypesMap\",links:\"LinksMap\",\"x-summary\":{type:\"string\"}},required:[\"description\"],extensionsPrefix:\"x-\"},Link:{properties:{operationRef:{type:\"string\"},operationId:{type:\"string\"},parameters:null,requestBody:null,description:{type:\"string\"},server:\"Server\"},extensionsPrefix:\"x-\"},Logo:{properties:{url:{type:\"string\"},altText:{type:\"string\"},backgroundColor:{type:\"string\"},href:{type:\"string\"}}},Schema:a,Xml:{properties:{name:{type:\"string\"},namespace:{type:\"string\"},prefix:{type:\"string\"},attribute:{type:\"boolean\"},wrapped:{type:\"boolean\"}},extensionsPrefix:\"x-\"},SchemaProperties:{properties:{},additionalProperties:\"Schema\"},DiscriminatorMapping:l,Discriminator:{properties:{propertyName:{type:\"string\"},mapping:\"DiscriminatorMapping\"},required:[\"propertyName\"],extensionsPrefix:\"x-\"},Components:{properties:{parameters:\"NamedParameters\",schemas:\"NamedSchemas\",responses:\"NamedResponses\",examples:\"NamedExamples\",requestBodies:\"NamedRequestBodies\",headers:\"NamedHeaders\",securitySchemes:\"NamedSecuritySchemes\",links:\"NamedLinks\",callbacks:\"NamedCallbacks\"},extensionsPrefix:\"x-\"},LinksMap:(0,r.mapOf)(\"Link\"),NamedSchemas:(0,r.mapOf)(\"Schema\"),NamedResponses:(0,r.mapOf)(\"Response\"),NamedParameters:(0,r.mapOf)(\"Parameter\"),NamedExamples:(0,r.mapOf)(\"Example\"),NamedRequestBodies:(0,r.mapOf)(\"RequestBody\"),NamedHeaders:(0,r.mapOf)(\"Header\"),NamedSecuritySchemes:(0,r.mapOf)(\"SecurityScheme\"),NamedLinks:(0,r.mapOf)(\"Link\"),NamedCallbacks:(0,r.mapOf)(\"Callback\"),ImplicitFlow:{properties:{refreshUrl:{type:\"string\"},scopes:{type:\"object\",additionalProperties:{type:\"string\"}},authorizationUrl:{type:\"string\"}},required:[\"authorizationUrl\",\"scopes\"],extensionsPrefix:\"x-\"},PasswordFlow:{properties:{refreshUrl:{type:\"string\"},scopes:{type:\"object\",additionalProperties:{type:\"string\"}},tokenUrl:{type:\"string\"}},required:[\"tokenUrl\",\"scopes\"],extensionsPrefix:\"x-\"},ClientCredentials:{properties:{refreshUrl:{type:\"string\"},scopes:{type:\"object\",additionalProperties:{type:\"string\"}},tokenUrl:{type:\"string\"}},required:[\"tokenUrl\",\"scopes\"],extensionsPrefix:\"x-\"},AuthorizationCode:{properties:{refreshUrl:{type:\"string\"},authorizationUrl:{type:\"string\"},scopes:{type:\"object\",additionalProperties:{type:\"string\"}},tokenUrl:{type:\"string\"},\"x-usePkce\":e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"XUsePkce\"},required:[\"authorizationUrl\",\"tokenUrl\",\"scopes\"],extensionsPrefix:\"x-\"},OAuth2Flows:{properties:{implicit:\"ImplicitFlow\",password:\"PasswordFlow\",clientCredentials:\"ClientCredentials\",authorizationCode:\"AuthorizationCode\"},extensionsPrefix:\"x-\"},SecurityScheme:c,XCodeSample:{properties:{lang:{type:\"string\"},label:{type:\"string\"},source:{type:\"string\"}}},XCodeSampleList:(0,r.listOf)(\"XCodeSample\"),XUsePkce:{properties:{disableManualConfiguration:{type:\"boolean\"},hideClientSecretInput:{type:\"boolean\"}}},WebhooksMap:{properties:{},additionalProperties:()=>\"PathItem\"}}},2082:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.Oas3_1Types=void 0;const r=n(1990),i=n(4154),o={properties:{$id:{type:\"string\"},$anchor:{type:\"string\"},id:{type:\"string\"},$schema:{type:\"string\"},definitions:\"NamedSchemas\",$defs:\"NamedSchemas\",$vocabulary:{type:\"string\"},externalDocs:\"ExternalDocs\",discriminator:\"Discriminator\",title:{type:\"string\"},multipleOf:{type:\"number\",minimum:0},maximum:{type:\"number\"},minimum:{type:\"number\"},exclusiveMaximum:{type:\"number\"},exclusiveMinimum:{type:\"number\"},maxLength:{type:\"integer\",minimum:0},minLength:{type:\"integer\",minimum:0},pattern:{type:\"string\"},maxItems:{type:\"integer\",minimum:0},minItems:{type:\"integer\",minimum:0},uniqueItems:{type:\"boolean\"},maxProperties:{type:\"integer\",minimum:0},minProperties:{type:\"integer\",minimum:0},required:{type:\"array\",items:{type:\"string\"}},enum:{type:\"array\"},type:e=>Array.isArray(e)?{type:\"array\",items:{enum:[\"object\",\"array\",\"string\",\"number\",\"integer\",\"boolean\",\"null\"]}}:{enum:[\"object\",\"array\",\"string\",\"number\",\"integer\",\"boolean\",\"null\"]},allOf:(0,r.listOf)(\"Schema\"),anyOf:(0,r.listOf)(\"Schema\"),oneOf:(0,r.listOf)(\"Schema\"),not:\"Schema\",if:\"Schema\",then:\"Schema\",else:\"Schema\",dependentSchemas:(0,r.listOf)(\"Schema\"),prefixItems:(0,r.listOf)(\"Schema\"),contains:\"Schema\",minContains:{type:\"integer\",minimum:0},maxContains:{type:\"integer\",minimum:0},patternProperties:{type:\"object\"},propertyNames:\"Schema\",unevaluatedItems:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",unevaluatedProperties:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",summary:{type:\"string\"},properties:\"SchemaProperties\",items:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",additionalProperties:e=>\"boolean\"==typeof e?{type:\"boolean\"}:\"Schema\",description:{type:\"string\"},format:{type:\"string\"},contentEncoding:{type:\"string\"},contentMediaType:{type:\"string\"},default:null,readOnly:{type:\"boolean\"},writeOnly:{type:\"boolean\"},xml:\"Xml\",examples:{type:\"array\"},example:{isExample:!0},deprecated:{type:\"boolean\"},const:null,$comment:{type:\"string\"},\"x-tags\":{type:\"array\",items:{type:\"string\"}}},extensionsPrefix:\"x-\"},s={properties:{type:{enum:[\"apiKey\",\"http\",\"oauth2\",\"openIdConnect\",\"mutualTLS\"]},description:{type:\"string\"},name:{type:\"string\"},in:{type:\"string\",enum:[\"query\",\"header\",\"cookie\"]},scheme:{type:\"string\"},bearerFormat:{type:\"string\"},flows:\"OAuth2Flows\",openIdConnectUrl:{type:\"string\"}},required(e){switch(null==e?void 0:e.type){case\"apiKey\":return[\"type\",\"name\",\"in\"];case\"http\":return[\"type\",\"scheme\"];case\"oauth2\":return[\"type\",\"flows\"];case\"openIdConnect\":return[\"type\",\"openIdConnectUrl\"];default:return[\"type\"]}},allowed(e){switch(null==e?void 0:e.type){case\"apiKey\":return[\"type\",\"name\",\"in\",\"description\"];case\"http\":return[\"type\",\"scheme\",\"bearerFormat\",\"description\"];case\"oauth2\":switch(null==e?void 0:e.flows){case\"implicit\":return[\"type\",\"flows\",\"authorizationUrl\",\"refreshUrl\",\"description\",\"scopes\"];case\"password\":case\"clientCredentials\":return[\"type\",\"flows\",\"tokenUrl\",\"refreshUrl\",\"description\",\"scopes\"];default:return[\"type\",\"flows\",\"authorizationUrl\",\"refreshUrl\",\"tokenUrl\",\"description\",\"scopes\"]}case\"openIdConnect\":return[\"type\",\"openIdConnectUrl\",\"description\"];default:return[\"type\",\"description\"]}},extensionsPrefix:\"x-\"};t.Oas3_1Types=Object.assign(Object.assign({},i.Oas3Types),{Info:{properties:{title:{type:\"string\"},version:{type:\"string\"},description:{type:\"string\"},termsOfService:{type:\"string\"},summary:{type:\"string\"},contact:\"Contact\",license:\"License\",\"x-logo\":\"Logo\"},required:[\"title\",\"version\"],extensionsPrefix:\"x-\"},Root:{properties:{openapi:null,info:\"Info\",servers:\"ServerList\",security:\"SecurityRequirementList\",tags:\"TagList\",externalDocs:\"ExternalDocs\",paths:\"Paths\",webhooks:\"WebhooksMap\",components:\"Components\",jsonSchemaDialect:{type:\"string\"}},required:[\"openapi\",\"info\"],requiredOneOf:[\"paths\",\"components\",\"webhooks\"],extensionsPrefix:\"x-\"},Schema:o,License:{properties:{name:{type:\"string\"},url:{type:\"string\"},identifier:{type:\"string\"}},required:[\"name\"],extensionsPrefix:\"x-\"},Components:{properties:{parameters:\"NamedParameters\",schemas:\"NamedSchemas\",responses:\"NamedResponses\",examples:\"NamedExamples\",requestBodies:\"NamedRequestBodies\",headers:\"NamedHeaders\",securitySchemes:\"NamedSecuritySchemes\",links:\"NamedLinks\",callbacks:\"NamedCallbacks\",pathItems:\"NamedPathItems\"},extensionsPrefix:\"x-\"},NamedPathItems:(0,r.mapOf)(\"PathItem\"),SecurityScheme:s,Operation:{properties:{tags:{type:\"array\",items:{type:\"string\"}},summary:{type:\"string\"},description:{type:\"string\"},externalDocs:\"ExternalDocs\",operationId:{type:\"string\"},parameters:\"ParameterList\",security:\"SecurityRequirementList\",servers:\"ServerList\",requestBody:\"RequestBody\",responses:\"Responses\",deprecated:{type:\"boolean\"},callbacks:\"CallbacksMap\",\"x-codeSamples\":\"XCodeSampleList\",\"x-code-samples\":\"XCodeSampleList\",\"x-hideTryItPanel\":{type:\"boolean\"}},extensionsPrefix:\"x-\"}})},8209:function(e,t,n){\"use strict\";var r=this&&this.__awaiter||function(e,t,n,r){return new(n||(n=Promise))((function(i,o){function s(e){try{l(r.next(e))}catch(e){o(e)}}function a(e){try{l(r.throw(e))}catch(e){o(e)}}function l(e){var t;e.done?i(e.value):(t=e.value,t instanceof n?t:new n((function(e){e(t)}))).then(s,a)}l((r=r.apply(e,t||[])).next())}))};Object.defineProperty(t,\"__esModule\",{value:!0}),t.nextTick=t.pickDefined=t.keysOf=t.identity=t.isTruthy=t.showErrorForDeprecatedField=t.showWarningForDeprecatedField=t.doesYamlFileExist=t.isCustomRuleId=t.getMatchingStatusCodeRange=t.assignExisting=t.isNotString=t.isString=t.isNotEmptyObject=t.slash=t.isPathParameter=t.yamlAndJsonSyncReader=t.readFileAsStringSync=t.isSingular=t.validateMimeTypeOAS3=t.validateMimeType=t.splitCamelCaseIntoWords=t.omitObjectProps=t.pickObjectProps=t.readFileFromUrl=t.isEmptyArray=t.isEmptyObject=t.isPlainObject=t.isDefined=t.loadYaml=t.popStack=t.pushStack=t.stringifyYaml=t.parseYaml=void 0;const i=n(7411),o=n(7975),s=n(4536),a=n(8381),l=n(5127),c=n(970),u=n(1827),p=n(2678);var d=n(970);function f(e){return null!==e&&\"object\"==typeof e&&!Array.isArray(e)}function h(e,t){return t.match(/^https?:\\/\\//)||(e=e.replace(/^https?:\\/\\//,\"\")),s(e,t)}function m(e){return\"string\"==typeof e}function g(e){return!!e}function y(e,t){return`${void 0!==t?`${t}.`:\"\"}${e}`}Object.defineProperty(t,\"parseYaml\",{enumerable:!0,get:function(){return d.parseYaml}}),Object.defineProperty(t,\"stringifyYaml\",{enumerable:!0,get:function(){return d.stringifyYaml}}),t.pushStack=function(e,t){return{prev:e,value:t}},t.popStack=function(e){var t;return null!==(t=null==e?void 0:e.prev)&&void 0!==t?t:null},t.loadYaml=function(e){return r(this,void 0,void 0,(function*(){const t=yield i.promises.readFile(e,\"utf-8\");return(0,c.parseYaml)(t)}))},t.isDefined=function(e){return void 0!==e},t.isPlainObject=f,t.isEmptyObject=function(e){return f(e)&&0===Object.keys(e).length},t.isEmptyArray=function(e){return Array.isArray(e)&&0===e.length},t.readFileFromUrl=function(e,t){return r(this,void 0,void 0,(function*(){const n={};for(const r of t.headers)h(e,r.matches)&&(n[r.name]=void 0!==r.envVariable?u.env[r.envVariable]||\"\":r.value);const r=yield(t.customFetch||a.default)(e,{headers:n});if(!r.ok)throw new Error(`Failed to load ${e}: ${r.status} ${r.statusText}`);return{body:yield r.text(),mimeType:r.headers.get(\"content-type\")}}))},t.pickObjectProps=function(e,t){return Object.fromEntries(t.filter((t=>t in e)).map((t=>[t,e[t]])))},t.omitObjectProps=function(e,t){return Object.fromEntries(Object.entries(e).filter((([e])=>!t.includes(e))))},t.splitCamelCaseIntoWords=function(e){const t=e.split(/(?:[-._])|([A-Z][a-z]+)/).filter(g).map((e=>e.toLocaleLowerCase())),n=e.split(/([A-Z]{2,})/).filter((e=>e&&e===e.toUpperCase())).map((e=>e.toLocaleLowerCase()));return new Set([...t,...n])},t.validateMimeType=function({type:e,value:t},{report:n,location:r},i){if(!i)throw new Error(`Parameter \"allowedValues\" is not provided for \"${\"consumes\"===e?\"request\":\"response\"}-mime-type\" rule`);if(t[e])for(const o of t[e])i.includes(o)||n({message:`Mime type \"${o}\" is not allowed`,location:r.child(t[e].indexOf(o)).key()})},t.validateMimeTypeOAS3=function({type:e,value:t},{report:n,location:r},i){if(!i)throw new Error(`Parameter \"allowedValues\" is not provided for \"${\"consumes\"===e?\"request\":\"response\"}-mime-type\" rule`);if(t.content)for(const e of Object.keys(t.content))i.includes(e)||n({message:`Mime type \"${e}\" is not allowed`,location:r.child(\"content\").child(e).key()})},t.isSingular=function(e){return l.isSingular(e)},t.readFileAsStringSync=function(e){return i.readFileSync(e,\"utf-8\")},t.yamlAndJsonSyncReader=function(e){const t=i.readFileSync(e,\"utf-8\");return(0,c.parseYaml)(t)},t.isPathParameter=function(e){return e.startsWith(\"{\")&&e.endsWith(\"}\")},t.slash=function(e){return/^\\\\\\\\\\?\\\\/.test(e)?e:e.replace(/\\\\/g,\"/\")},t.isNotEmptyObject=function(e){return!!e&&Object.keys(e).length>0},t.isString=m,t.isNotString=function(e){return!m(e)},t.assignExisting=function(e,t){for(const n of Object.keys(t))e.hasOwnProperty(n)&&(e[n]=t[n])},t.getMatchingStatusCodeRange=function(e){return`${e}`.replace(/^(\\d)\\d\\d$/,((e,t)=>`${t}XX`))},t.isCustomRuleId=function(e){return e.includes(\"/\")},t.doesYamlFileExist=function(e){return(\".yaml\"===(0,o.extname)(e)||\".yml\"===(0,o.extname)(e))&&i.hasOwnProperty(\"existsSync\")&&i.existsSync(e)},t.showWarningForDeprecatedField=function(e,t,n){p.logger.warn(`The '${p.colorize.red(e)}' field is deprecated. ${t?`Use ${p.colorize.green(y(t,n))} instead. `:\"\"}Read more about this change: https://redocly.com/docs/api-registry/guides/migration-guide-config-file/#changed-properties\\n`)},t.showErrorForDeprecatedField=function(e,t,n){throw new Error(`Do not use '${e}' field. ${t?`Use '${y(t,n)}' instead. `:\"\"}\\n`)},t.isTruthy=g,t.identity=function(e){return e},t.keysOf=function(e){return e?Object.keys(e):[]},t.pickDefined=function(e){if(!e)return;const t={};for(const n in e)void 0!==e[n]&&(t[n]=e[n]);return t},t.nextTick=function(){new Promise((e=>{setTimeout(e)}))}},2161:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.normalizeVisitors=void 0;const r=n(1990),i={Root:\"DefinitionRoot\",ServerVariablesMap:\"ServerVariableMap\",Paths:[\"PathMap\",\"PathsMap\"],CallbacksMap:\"CallbackMap\",MediaTypesMap:\"MediaTypeMap\",ExamplesMap:\"ExampleMap\",EncodingMap:\"EncodingsMap\",HeadersMap:\"HeaderMap\",LinksMap:\"LinkMap\",OAuth2Flows:\"SecuritySchemeFlows\",Responses:\"ResponsesMap\"};t.normalizeVisitors=function(e,t){const n={any:{enter:[],leave:[]}};for(const e of Object.keys(t))n[e]={enter:[],leave:[]};n.ref={enter:[],leave:[]};for(const{ruleId:t,severity:n,visitor:r}of e)a({ruleId:t,severity:n},r,null);for(const e of Object.keys(n))n[e].enter.sort(((e,t)=>t.depth-e.depth)),n[e].leave.sort(((e,t)=>e.depth-t.depth));return n;function o(e,t,i,s,a=[]){if(a.includes(t))return;a=[...a,t];const l=new Set;for(const n of Object.values(t.properties))n!==i?\"object\"==typeof n&&null!==n&&n.name&&l.add(n):c(e,a);t.additionalProperties&&\"function\"!=typeof t.additionalProperties&&(t.additionalProperties===i?c(e,a):void 0!==t.additionalProperties.name&&l.add(t.additionalProperties)),t.items&&(t.items===i?c(e,a):void 0!==t.items.name&&l.add(t.items)),t.extensionsPrefix&&l.add(r.SpecExtension);for(const t of Array.from(l.values()))o(e,t,i,s,a);function c(e,t){for(const r of t.slice(1))n[r.name]=n[r.name]||{enter:[],leave:[]},n[r.name].enter.push(Object.assign(Object.assign({},e),{visit:()=>{},depth:0,context:{isSkippedLevel:!0,seen:new Set,parent:s}}))}}function s(e,t){if(Array.isArray(t)){const n=t.find((t=>e[t]))||void 0;return n&&e[n]}return e[t]}function a(e,r,l,c=0){const u=Object.keys(t);if(0===c)u.push(\"any\"),u.push(\"ref\");else{if(r.any)throw new Error(\"any() is allowed only on top level\");if(r.ref)throw new Error(\"ref() is allowed only on top level\")}for(const p of u){const u=r[p]||s(r,i[p]),d=n[p];if(!u)continue;let f,h,m;const g=\"object\"==typeof u;if(\"ref\"===p&&g&&u.skip)throw new Error(\"ref() visitor does not support skip\");\"function\"==typeof u?f=u:g&&(f=u.enter,h=u.leave,m=u.skip);const y={activatedOn:null,type:t[p],parent:l,isSkippedLevel:!1};if(\"object\"==typeof u&&a(e,u,y,c+1),l&&o(e,l.type,t[p],l),f||g){if(f&&\"function\"!=typeof f)throw new Error(\"DEV: should be function\");d.enter.push(Object.assign(Object.assign({},e),{visit:f||(()=>{}),skip:m,depth:c,context:y}))}if(h){if(\"function\"!=typeof h)throw new Error(\"DEV: should be function\");d.leave.push(Object.assign(Object.assign({},e),{visit:h,depth:c,context:y}))}}}}},5735:function(e,t,n){\"use strict\";Object.defineProperty(t,\"__esModule\",{value:!0}),t.walkDocument=void 0;const r=n(3873),i=n(8209),o=n(2928),s=n(1990);function a(e){var t,n;const r={};for(;e.parent;)(null===(t=e.parent.activatedOn)||void 0===t?void 0:t.value.location)&&(r[e.parent.type.name]=null===(n=e.parent.activatedOn)||void 0===n?void 0:n.value.location),e=e.parent;return r}t.walkDocument=function(e){const{document:t,rootType:n,normalizedVisitors:l,resolvedRefMap:c,ctx:u}=e,p={},d=new Set;!function e(t,n,f,h,m){var g,y,b,v,x,w,k,S,E,O,_;const A=(e,t=j.source.absoluteRef)=>{if(!(0,r.isRef)(e))return{location:f,node:e};const n=(0,o.makeRefId)(t,e.$ref),i=c.get(n);if(!i)return{location:void 0,node:void 0};const{resolved:s,node:a,document:l,nodePointer:u,error:p}=i;return{location:s?new r.Location(l.source,u):p instanceof o.YamlParseError?new r.Location(p.source,\"\"):void 0,node:a,error:p}},C=f;let j=f;const{node:P,location:T,error:I}=A(t),R=new Set;if((0,r.isRef)(t)){const e=l.ref.enter;for(const{visit:r,ruleId:i,severity:o,context:s}of e)R.add(s),r(t,{report:$.bind(void 0,i,o),resolve:A,rawNode:t,rawLocation:C,location:f,type:n,parent:h,key:m,parentLocations:{},oasVersion:u.oasVersion,getVisitorData:L.bind(void 0,i)},{node:P,location:T,error:I}),(null==T?void 0:T.source.absoluteRef)&&u.refTypes&&u.refTypes.set(null==T?void 0:T.source.absoluteRef,n)}if(void 0!==P&&T&&\"scalar\"!==n.name){j=T;const o=null===(y=null===(g=p[n.name])||void 0===g?void 0:g.has)||void 0===y?void 0:y.call(g,P);let a=!1;const c=l.any.enter.concat((null===(b=l[n.name])||void 0===b?void 0:b.enter)||[]),u=[];for(const{context:e,visit:r,skip:s,ruleId:l,severity:p}of c){if(d.has(j.pointer))break;if(e.isSkippedLevel)!e.parent.activatedOn||e.parent.activatedOn.value.nextLevelTypeActivated||e.seen.has(t)||(e.seen.add(t),a=!0,u.push(e));else if(e.parent&&e.parent.activatedOn&&(null===(v=e.activatedOn)||void 0===v?void 0:v.value.withParentNode)!==e.parent.activatedOn.value.node&&(null===(x=e.parent.activatedOn.value.nextLevelTypeActivated)||void 0===x?void 0:x.value)!==n||!e.parent&&!o){u.push(e);const o={node:P,location:T,nextLevelTypeActivated:null,withParentNode:null===(k=null===(w=e.parent)||void 0===w?void 0:w.activatedOn)||void 0===k?void 0:k.value.node,skipped:null!==(O=(null===(E=null===(S=e.parent)||void 0===S?void 0:S.activatedOn)||void 0===E?void 0:E.value.skipped)||(null==s?void 0:s(P,m,{location:f,rawLocation:C,resolve:A,rawNode:t})))&&void 0!==O&&O};e.activatedOn=(0,i.pushStack)(e.activatedOn,o);let c=e.parent;for(;c;)c.activatedOn.value.nextLevelTypeActivated=(0,i.pushStack)(c.activatedOn.value.nextLevelTypeActivated,n),c=c.parent;o.skipped||(a=!0,R.add(e),N(r,P,t,e,l,p))}}if(a||!o)if(p[n.name]=p[n.name]||new Set,p[n.name].add(P),Array.isArray(P)){const t=n.items;if(void 0!==t)for(let n=0;n!i.includes(e)))):n.extensionsPrefix&&i.push(...Object.keys(P).filter((e=>e.startsWith(n.extensionsPrefix)))),(0,r.isRef)(t)&&i.push(...Object.keys(t).filter((e=>\"$ref\"!==e&&!i.includes(e))));for(const o of i){let i=P[o],a=T;void 0===i&&(i=t[o],a=f);let l=n.properties[o];void 0===l&&(l=n.additionalProperties),\"function\"==typeof l&&(l=l(i,o)),void 0===l&&n.extensionsPrefix&&o.startsWith(n.extensionsPrefix)&&(l=s.SpecExtension),!(0,s.isNamedType)(l)&&(null==l?void 0:l.directResolveAs)&&(l=l.directResolveAs,i={$ref:i}),l&&void 0===l.name&&!1!==l.resolvable&&(l={name:\"scalar\",properties:{}}),(0,s.isNamedType)(l)&&(\"scalar\"!==l.name||(0,r.isRef)(i))&&e(i,l,a.child([o]),P,o)}}const h=l.any.leave,I=((null===(_=l[n.name])||void 0===_?void 0:_.leave)||[]).concat(h);for(const e of u.reverse())if(e.isSkippedLevel)e.seen.delete(P);else if(e.activatedOn=(0,i.popStack)(e.activatedOn),e.parent){let t=e.parent;for(;t;)t.activatedOn.value.nextLevelTypeActivated=(0,i.popStack)(t.activatedOn.value.nextLevelTypeActivated),t=t.parent}for(const{context:e,visit:n,ruleId:r,severity:i}of I)!e.isSkippedLevel&&R.has(e)&&N(n,P,t,e,r,i)}if(j=f,(0,r.isRef)(t)){const e=l.ref.leave;for(const{visit:r,ruleId:i,severity:o,context:s}of e)R.has(s)&&r(t,{report:$.bind(void 0,i,o),resolve:A,rawNode:t,rawLocation:C,location:f,type:n,parent:h,key:m,parentLocations:{},oasVersion:u.oasVersion,getVisitorData:L.bind(void 0,i)},{node:P,location:T,error:I})}function N(e,t,r,i,o,s){e(t,{report:$.bind(void 0,o,s),resolve:A,rawNode:r,location:j,rawLocation:C,type:n,parent:h,key:m,parentLocations:a(i),oasVersion:u.oasVersion,ignoreNextVisitorsOnNode:()=>{d.add(j.pointer)},getVisitorData:L.bind(void 0,o)},function(e){var t;const n={};for(;e.parent;)n[e.parent.type.name]=null===(t=e.parent.activatedOn)||void 0===t?void 0:t.value.node,e=e.parent;return n}(i),i)}function $(e,t,n){const r=(n.location?Array.isArray(n.location)?n.location:[n.location]:[Object.assign(Object.assign({},j),{reportOnKey:!1})]).map((e=>Object.assign(Object.assign(Object.assign({},j),{reportOnKey:!1}),e))),i=n.forceSeverity||t;\"off\"!==i&&u.problems.push(Object.assign(Object.assign({ruleId:n.ruleId||e,severity:i},n),{suggest:n.suggest||[],location:r}))}function L(e){return u.visitorsData[e]=u.visitorsData[e]||{},u.visitorsData[e]}}(t.parsed,n,new r.Location(t.source,\"#/\"),void 0,\"\")}},1431:function(e,t,n){var r=n(8505);e.exports=function(e){return e?(\"{}\"===e.substr(0,2)&&(e=\"\\\\{\\\\}\"+e.substr(2)),g(function(e){return e.split(\"\\\\\\\\\").join(i).split(\"\\\\{\").join(o).split(\"\\\\}\").join(s).split(\"\\\\,\").join(a).split(\"\\\\.\").join(l)}(e),!0).map(u)):[]};var i=\"\\0SLASH\"+Math.random()+\"\\0\",o=\"\\0OPEN\"+Math.random()+\"\\0\",s=\"\\0CLOSE\"+Math.random()+\"\\0\",a=\"\\0COMMA\"+Math.random()+\"\\0\",l=\"\\0PERIOD\"+Math.random()+\"\\0\";function c(e){return parseInt(e,10)==e?parseInt(e,10):e.charCodeAt(0)}function u(e){return e.split(i).join(\"\\\\\").split(o).join(\"{\").split(s).join(\"}\").split(a).join(\",\").split(l).join(\".\")}function p(e){if(!e)return[\"\"];var t=[],n=r(\"{\",\"}\",e);if(!n)return e.split(\",\");var i=n.pre,o=n.body,s=n.post,a=i.split(\",\");a[a.length-1]+=\"{\"+o+\"}\";var l=p(s);return s.length&&(a[a.length-1]+=l.shift(),a.push.apply(a,l)),t.push.apply(t,a),t}function d(e){return\"{\"+e+\"}\"}function f(e){return/^-?0\\d/.test(e)}function h(e,t){return e<=t}function m(e,t){return e>=t}function g(e,t){var n=[],i=r(\"{\",\"}\",e);if(!i)return[e];var o=i.pre,a=i.post.length?g(i.post,!1):[\"\"];if(/\\$$/.test(i.pre))for(var l=0;l=0;if(!w&&!k)return i.post.match(/,(?!,).*\\}/)?g(e=i.pre+\"{\"+i.body+s+i.post):[e];if(w)y=i.body.split(/\\.\\./);else if(1===(y=p(i.body)).length&&1===(y=g(y[0],!1).map(d)).length)return a.map((function(e){return i.pre+y[0]+e}));if(w){var S=c(y[0]),E=c(y[1]),O=Math.max(y[0].length,y[1].length),_=3==y.length?Math.abs(c(y[2])):1,A=h;E0){var I=new Array(T+1).join(\"0\");P=j<0?\"-\"+I+P.slice(1):I+P}}b.push(P)}}else{b=[];for(var R=0;R(g(t),!(!n.nocomment&&\"#\"===t.charAt(0))&&new v(t,n).match(e));e.exports=r;const i=n(4077);r.sep=i.sep;const o=Symbol(\"globstar **\");r.GLOBSTAR=o;const s=n(1431),a={\"!\":{open:\"(?:(?!(?:\",close:\"))[^/]*?)\"},\"?\":{open:\"(?:\",close:\")?\"},\"+\":{open:\"(?:\",close:\")+\"},\"*\":{open:\"(?:\",close:\")*\"},\"@\":{open:\"(?:\",close:\")\"}},l=\"[^/]\",c=l+\"*?\",u=e=>e.split(\"\").reduce(((e,t)=>(e[t]=!0,e)),{}),p=u(\"().*{}+?[]^$\\\\!\"),d=u(\"[.(\"),f=/\\/+/;r.filter=(e,t={})=>(n,i,o)=>r(n,e,t);const h=(e,t={})=>{const n={};return Object.keys(e).forEach((t=>n[t]=e[t])),Object.keys(t).forEach((e=>n[e]=t[e])),n};r.defaults=e=>{if(!e||\"object\"!=typeof e||!Object.keys(e).length)return r;const t=r,n=(n,r,i)=>t(n,r,h(e,i));return(n.Minimatch=class extends t.Minimatch{constructor(t,n){super(t,h(e,n))}}).defaults=n=>t.defaults(h(e,n)).Minimatch,n.filter=(n,r)=>t.filter(n,h(e,r)),n.defaults=n=>t.defaults(h(e,n)),n.makeRe=(n,r)=>t.makeRe(n,h(e,r)),n.braceExpand=(n,r)=>t.braceExpand(n,h(e,r)),n.match=(n,r,i)=>t.match(n,r,h(e,i)),n},r.braceExpand=(e,t)=>m(e,t);const m=(e,t={})=>(g(e),t.nobrace||!/\\{(?:(?!\\{).)*\\}/.test(e)?[e]:s(e)),g=e=>{if(\"string\"!=typeof e)throw new TypeError(\"invalid pattern\");if(e.length>65536)throw new TypeError(\"pattern is too long\")},y=Symbol(\"subparse\");r.makeRe=(e,t)=>new v(e,t||{}).makeRe(),r.match=(e,t,n={})=>{const r=new v(t,n);return e=e.filter((e=>r.match(e))),r.options.nonull&&!e.length&&e.push(t),e};const b=e=>e.replace(/[[\\]\\\\]/g,\"\\\\$&\");class v{constructor(e,t){g(e),t||(t={}),this.options=t,this.set=[],this.pattern=e,this.windowsPathsNoEscape=!!t.windowsPathsNoEscape||!1===t.allowWindowsEscape,this.windowsPathsNoEscape&&(this.pattern=this.pattern.replace(/\\\\/g,\"/\")),this.regexp=null,this.negate=!1,this.comment=!1,this.empty=!1,this.partial=!!t.partial,this.make()}debug(){}make(){const e=this.pattern,t=this.options;if(!t.nocomment&&\"#\"===e.charAt(0))return void(this.comment=!0);if(!e)return void(this.empty=!0);this.parseNegate();let n=this.globSet=this.braceExpand();t.debug&&(this.debug=(...e)=>console.error(...e)),this.debug(this.pattern,n),n=this.globParts=n.map((e=>e.split(f))),this.debug(this.pattern,n),n=n.map(((e,t,n)=>e.map(this.parse,this))),this.debug(this.pattern,n),n=n.filter((e=>-1===e.indexOf(!1))),this.debug(this.pattern,n),this.set=n}parseNegate(){if(this.options.nonegate)return;const e=this.pattern;let t=!1,n=0;for(let r=0;r>> no match, partial?\",e,d,t,f),d!==a))}if(\"string\"==typeof u?(c=p===u,this.debug(\"string match\",u,p,c)):(c=p.match(u),this.debug(\"pattern match\",u,p,c)),!c)return!1}if(i===a&&s===l)return!0;if(i===a)return n;if(s===l)return i===a-1&&\"\"===e[i];throw new Error(\"wtf?\")}braceExpand(){return m(this.pattern,this.options)}parse(e,t){g(e);const n=this.options;if(\"**\"===e){if(!n.noglobstar)return o;e=\"*\"}if(\"\"===e)return\"\";let r=\"\",i=!1,s=!1;const u=[],f=[];let h,m,v,x,w=!1,k=-1,S=-1,E=\".\"===e.charAt(0),O=n.dot||E;const _=e=>\".\"===e.charAt(0)?\"\":n.dot?\"(?!(?:^|\\\\/)\\\\.{1,2}(?:$|\\\\/))\":\"(?!\\\\.)\",A=()=>{if(h){switch(h){case\"*\":r+=c,i=!0;break;case\"?\":r+=l,i=!0;break;default:r+=\"\\\\\"+h}this.debug(\"clearStateChar %j %j\",h,r),h=!1}};for(let t,o=0;o(n||(n=\"\\\\\"),t+t+n+\"|\"))),this.debug(\"tail=%j\\n %s\",e,e,v,r);const t=\"*\"===v.type?c:\"?\"===v.type?l:\"\\\\\"+v.type;i=!0,r=r.slice(0,v.reStart)+t+\"\\\\(\"+e}A(),s&&(r+=\"\\\\\\\\\");const C=d[r.charAt(0)];for(let e=f.length-1;e>-1;e--){const n=f[e],i=r.slice(0,n.reStart),o=r.slice(n.reStart,n.reEnd-8);let s=r.slice(n.reEnd);const a=r.slice(n.reEnd-8,n.reEnd)+s,l=i.split(\")\").length,c=i.split(\"(\").length-l;let u=s;for(let e=0;ee.replace(/\\\\(.)/g,\"$1\"))(e);const j=n.nocase?\"i\":\"\";try{return Object.assign(new RegExp(\"^\"+r+\"$\",j),{_glob:e,_src:r})}catch(e){return new RegExp(\"$.\")}}makeRe(){if(this.regexp||!1===this.regexp)return this.regexp;const e=this.set;if(!e.length)return this.regexp=!1,this.regexp;const t=this.options,n=t.noglobstar?c:t.dot?\"(?:(?!(?:\\\\/|^)(?:\\\\.{1,2})($|\\\\/)).)*?\":\"(?:(?!(?:\\\\/|^)\\\\.).)*?\",r=t.nocase?\"i\":\"\";let i=e.map((e=>(e=e.map((e=>\"string\"==typeof e?e.replace(/[-[\\]{}()*+?.,\\\\^$|#\\s]/g,\"\\\\$&\"):e===o?o:e._src)).reduce(((e,t)=>(e[e.length-1]===o&&t===o||e.push(t),e)),[]),e.forEach(((t,r)=>{t===o&&e[r-1]!==o&&(0===r?e.length>1?e[r+1]=\"(?:\\\\/|\"+n+\"\\\\/)?\"+e[r+1]:e[r]=n:r===e.length-1?e[r-1]+=\"(?:\\\\/|\"+n+\")?\":(e[r-1]+=\"(?:\\\\/|\\\\/\"+n+\"\\\\/)\"+e[r+1],e[r+1]=o))})),e.filter((e=>e!==o)).join(\"/\")))).join(\"|\");i=\"^(?:\"+i+\")$\",this.negate&&(i=\"^(?!\"+i+\").*$\");try{this.regexp=new RegExp(i,r)}catch(e){this.regexp=!1}return this.regexp}match(e,t=this.partial){if(this.debug(\"match\",e,this.pattern),this.comment)return!1;if(this.empty)return\"\"===e;if(\"/\"===e&&t)return!0;const n=this.options;\"/\"!==i.sep&&(e=e.split(i.sep).join(\"/\")),e=e.split(f),this.debug(this.pattern,\"split\",e);const r=this.set;let o;this.debug(this.pattern,\"set\",r);for(let t=e.length-1;t>=0&&(o=e[t],!o);t--);for(let i=0;i=0&&c>0){if(e===t)return[l,c];for(r=[],o=n.length;u>=0&&!a;)u==l?(r.push(u),l=n.indexOf(e,u+1)):1==r.length?a=[r.pop(),c]:((i=r.pop())=0?l:c;r.length&&(a=[o,s])}return a}e.exports=t,t.range=r},3998:function(e,t,n){\"use strict\";var r=n(1137);e.exports=function(e,t){return e?void t.then((function(t){r((function(){e(null,t)}))}),(function(t){r((function(){e(t)}))})):t}},1137:function(e){\"use strict\";e.exports=\"object\"==typeof process&&\"function\"==typeof process.nextTick?process.nextTick:\"function\"==typeof setImmediate?setImmediate:function(e){setTimeout(e,0)}},2485:function(e,t){var n;!function(){\"use strict\";var r={}.hasOwnProperty;function i(){for(var e=[],t=0;tu;)if((a=l[u++])!=a)return!0}else for(;c>u;u++)if((e||u in l)&&l[u]===n)return e||u||0;return!e&&-1}};e.exports={includes:s(!0),indexOf:s(!1)}},1344:function(e,t,n){var r=n(6885),i=n(8664),o=n(2612),s=n(3747),a=n(2998),l=[].push,c=function(e){var t=1==e,n=2==e,c=3==e,u=4==e,p=6==e,d=7==e,f=5==e||p;return function(h,m,g,y){for(var b,v,x=o(h),w=i(x),k=r(m,g,3),S=s(w.length),E=0,O=y||a,_=t?O(h,S):n||d?O(h,0):void 0;S>E;E++)if((f||E in w)&&(v=k(b=w[E],E,x),e))if(t)_[E]=v;else if(v)switch(e){case 3:return!0;case 5:return b;case 6:return E;case 2:l.call(_,b)}else switch(e){case 4:return!1;case 7:l.call(_,b)}return p?-1:c||u?u:_}};e.exports={forEach:c(0),map:c(1),filter:c(2),some:c(3),every:c(4),find:c(5),findIndex:c(6),filterOut:c(7)}},5634:function(e,t,n){var r=n(2074),i=n(1602),o=n(6845),s=i(\"species\");e.exports=function(e){return o>=51||!r((function(){var t=[];return(t.constructor={})[s]=function(){return{foo:1}},1!==t[e](Boolean).foo}))}},2998:function(e,t,n){var r=n(5335),i=n(8679),o=n(1602)(\"species\");e.exports=function(e,t){var n;return i(e)&&(\"function\"!=typeof(n=e.constructor)||n!==Array&&!i(n.prototype)?r(n)&&null===(n=n[o])&&(n=void 0):n=void 0),new(void 0===n?Array:n)(0===t?0:t)}},8569:function(e){var t={}.toString;e.exports=function(e){return t.call(e).slice(8,-1)}},3062:function(e,t,n){var r=n(3129),i=n(8569),o=n(1602)(\"toStringTag\"),s=\"Arguments\"==i(function(){return arguments}());e.exports=r?i:function(e){var t,n,r;return void 0===e?\"Undefined\":null===e?\"Null\":\"string\"==typeof(n=function(e,t){try{return e[t]}catch(e){}}(t=Object(e),o))?n:s?i(t):\"Object\"==(r=i(t))&&\"function\"==typeof t.callee?\"Arguments\":r}},4361:function(e,t,n){var r=n(1883),i=n(5816),o=n(7632),s=n(3610);e.exports=function(e,t){for(var n=i(t),a=s.f,l=o.f,c=0;c=74)&&(r=s.match(/Chrome\\/(\\d+)/))&&(i=r[1]),e.exports=i&&+i},290:function(e){e.exports=[\"constructor\",\"hasOwnProperty\",\"isPrototypeOf\",\"propertyIsEnumerable\",\"toLocaleString\",\"toString\",\"valueOf\"]},1605:function(e,t,n){var r=n(200),i=n(7632).f,o=n(7712),s=n(7485),a=n(5975),l=n(4361),c=n(4977);e.exports=function(e,t){var n,u,p,d,f,h=e.target,m=e.global,g=e.stat;if(n=m?r:g?r[h]||a(h,{}):(r[h]||{}).prototype)for(u in t){if(d=t[u],p=e.noTargetGet?(f=i(n,u))&&f.value:n[u],!c(m?u:h+(g?\".\":\"#\")+u,e.forced)&&void 0!==p){if(typeof d==typeof p)continue;l(d,p)}(e.sham||p&&p.sham)&&o(d,\"sham\",!0),s(n,u,d,e)}}},2074:function(e){e.exports=function(e){try{return!!e()}catch(e){return!0}}},6885:function(e,t,n){var r=n(9085);e.exports=function(e,t,n){if(r(e),void 0===t)return e;switch(n){case 0:return function(){return e.call(t)};case 1:return function(n){return e.call(t,n)};case 2:return function(n,r){return e.call(t,n,r)};case 3:return function(n,r,i){return e.call(t,n,r,i)}}return function(){return e.apply(t,arguments)}}},6492:function(e,t,n){var r=n(9720),i=n(200),o=function(e){return\"function\"==typeof e?e:void 0};e.exports=function(e,t){return arguments.length<2?o(r[e])||o(i[e]):r[e]&&r[e][t]||i[e]&&i[e][t]}},200:function(e,t,n){var r=function(e){return e&&e.Math==Math&&e};e.exports=r(\"object\"==typeof globalThis&&globalThis)||r(\"object\"==typeof window&&window)||r(\"object\"==typeof self&&self)||r(\"object\"==typeof n.g&&n.g)||function(){return this}()||Function(\"return this\")()},1883:function(e,t,n){var r=n(2612),i={}.hasOwnProperty;e.exports=Object.hasOwn||function(e,t){return i.call(r(e),t)}},7708:function(e){e.exports={}},8890:function(e,t,n){var r=n(6492);e.exports=r(\"document\",\"documentElement\")},7694:function(e,t,n){var r=n(5077),i=n(2074),o=n(3262);e.exports=!r&&!i((function(){return 7!=Object.defineProperty(o(\"div\"),\"a\",{get:function(){return 7}}).a}))},8664:function(e,t,n){var r=n(2074),i=n(8569),o=\"\".split;e.exports=r((function(){return!Object(\"z\").propertyIsEnumerable(0)}))?function(e){return\"String\"==i(e)?o.call(e,\"\"):Object(e)}:Object},9965:function(e,t,n){var r=n(9310),i=Function.toString;\"function\"!=typeof r.inspectSource&&(r.inspectSource=function(e){return i.call(e)}),e.exports=r.inspectSource},9206:function(e,t,n){var r,i,o,s=n(2886),a=n(200),l=n(5335),c=n(7712),u=n(1883),p=n(9310),d=n(5904),f=n(7708),h=\"Object already initialized\",m=a.WeakMap;if(s||p.state){var g=p.state||(p.state=new m),y=g.get,b=g.has,v=g.set;r=function(e,t){if(b.call(g,e))throw new TypeError(h);return t.facade=e,v.call(g,e,t),t},i=function(e){return y.call(g,e)||{}},o=function(e){return b.call(g,e)}}else{var x=d(\"state\");f[x]=!0,r=function(e,t){if(u(e,x))throw new TypeError(h);return t.facade=e,c(e,x,t),t},i=function(e){return u(e,x)?e[x]:{}},o=function(e){return u(e,x)}}e.exports={set:r,get:i,has:o,enforce:function(e){return o(e)?i(e):r(e,{})},getterFor:function(e){return function(t){var n;if(!l(t)||(n=i(t)).type!==e)throw TypeError(\"Incompatible receiver, \"+e+\" required\");return n}}}},8679:function(e,t,n){var r=n(8569);e.exports=Array.isArray||function(e){return\"Array\"==r(e)}},4977:function(e,t,n){var r=n(2074),i=/#|\\.prototype\\./,o=function(e,t){var n=a[s(e)];return n==c||n!=l&&(\"function\"==typeof t?r(t):!!t)},s=o.normalize=function(e){return String(e).replace(i,\".\").toLowerCase()},a=o.data={},l=o.NATIVE=\"N\",c=o.POLYFILL=\"P\";e.exports=o},5335:function(e){e.exports=function(e){return\"object\"==typeof e?null!==e:\"function\"==typeof e}},6926:function(e){e.exports=!1},1849:function(e,t,n){var r=n(6845),i=n(2074);e.exports=!!Object.getOwnPropertySymbols&&!i((function(){var e=Symbol();return!String(e)||!(Object(e)instanceof Symbol)||!Symbol.sham&&r&&r<41}))},2886:function(e,t,n){var r=n(200),i=n(9965),o=r.WeakMap;e.exports=\"function\"==typeof o&&/native code/.test(i(o))},3105:function(e,t,n){var r,i=n(3938),o=n(5318),s=n(290),a=n(7708),l=n(8890),c=n(3262),u=n(5904),p=\"prototype\",d=\"script\",f=u(\"IE_PROTO\"),h=function(){},m=function(e){return\"<\"+d+\">\"+e+\"\"},g=function(){try{r=document.domain&&new ActiveXObject(\"htmlfile\")}catch(e){}var e,t,n;g=r?function(e){e.write(m(\"\")),e.close();var t=e.parentWindow.Object;return e=null,t}(r):(t=c(\"iframe\"),n=\"java\"+d+\":\",t.style.display=\"none\",l.appendChild(t),t.src=String(n),(e=t.contentWindow.document).open(),e.write(m(\"document.F=Object\")),e.close(),e.F);for(var i=s.length;i--;)delete g[p][s[i]];return g()};a[f]=!0,e.exports=Object.create||function(e,t){var n;return null!==e?(h[p]=i(e),n=new h,h[p]=null,n[f]=e):n=g(),void 0===t?n:o(n,t)}},5318:function(e,t,n){var r=n(5077),i=n(3610),o=n(3938),s=n(1641);e.exports=r?Object.defineProperties:function(e,t){o(e);for(var n,r=s(t),a=r.length,l=0;a>l;)i.f(e,n=r[l++],t[n]);return e}},3610:function(e,t,n){var r=n(5077),i=n(7694),o=n(3938),s=n(874),a=Object.defineProperty;t.f=r?a:function(e,t,n){if(o(e),t=s(t,!0),o(n),i)try{return a(e,t,n)}catch(e){}if(\"get\"in n||\"set\"in n)throw TypeError(\"Accessors not supported\");return\"value\"in n&&(e[t]=n.value),e}},7632:function(e,t,n){var r=n(5077),i=n(9304),o=n(6843),s=n(5476),a=n(874),l=n(1883),c=n(7694),u=Object.getOwnPropertyDescriptor;t.f=r?u:function(e,t){if(e=s(e),t=a(t,!0),c)try{return u(e,t)}catch(e){}if(l(e,t))return o(!i.f.call(e,t),e[t])}},6509:function(e,t,n){var r=n(5476),i=n(4789).f,o={}.toString,s=\"object\"==typeof window&&window&&Object.getOwnPropertyNames?Object.getOwnPropertyNames(window):[];e.exports.f=function(e){return s&&\"[object Window]\"==o.call(e)?function(e){try{return i(e)}catch(e){return s.slice()}}(e):i(r(e))}},4789:function(e,t,n){var r=n(6347),i=n(290).concat(\"length\",\"prototype\");t.f=Object.getOwnPropertyNames||function(e){return r(e,i)}},8916:function(e,t){t.f=Object.getOwnPropertySymbols},6347:function(e,t,n){var r=n(1883),i=n(5476),o=n(8186).indexOf,s=n(7708);e.exports=function(e,t){var n,a=i(e),l=0,c=[];for(n in a)!r(s,n)&&r(a,n)&&c.push(n);for(;t.length>l;)r(a,n=t[l++])&&(~o(c,n)||c.push(n));return c}},1641:function(e,t,n){var r=n(6347),i=n(290);e.exports=Object.keys||function(e){return r(e,i)}},9304:function(e,t){\"use strict\";var n={}.propertyIsEnumerable,r=Object.getOwnPropertyDescriptor,i=r&&!n.call({1:2},1);t.f=i?function(e){var t=r(this,e);return!!t&&t.enumerable}:n},4972:function(e,t,n){\"use strict\";var r=n(3129),i=n(3062);e.exports=r?{}.toString:function(){return\"[object \"+i(this)+\"]\"}},5816:function(e,t,n){var r=n(6492),i=n(4789),o=n(8916),s=n(3938);e.exports=r(\"Reflect\",\"ownKeys\")||function(e){var t=i.f(s(e)),n=o.f;return n?t.concat(n(e)):t}},9720:function(e,t,n){var r=n(200);e.exports=r},7485:function(e,t,n){var r=n(200),i=n(7712),o=n(1883),s=n(5975),a=n(9965),l=n(9206),c=l.get,u=l.enforce,p=String(String).split(\"String\");(e.exports=function(e,t,n,a){var l,c=!!a&&!!a.unsafe,d=!!a&&!!a.enumerable,f=!!a&&!!a.noTargetGet;\"function\"==typeof n&&(\"string\"!=typeof t||o(n,\"name\")||i(n,\"name\",t),(l=u(n)).source||(l.source=p.join(\"string\"==typeof t?t:\"\"))),e!==r?(c?!f&&e[t]&&(d=!0):delete e[t],d?e[t]=n:i(e,t,n)):d?e[t]=n:s(t,n)})(Function.prototype,\"toString\",(function(){return\"function\"==typeof this&&c(this).source||a(this)}))},1229:function(e){e.exports=function(e){if(null==e)throw TypeError(\"Can't call method on \"+e);return e}},5975:function(e,t,n){var r=n(200),i=n(7712);e.exports=function(e,t){try{i(r,e,t)}catch(n){r[e]=t}return t}},5282:function(e,t,n){var r=n(3610).f,i=n(1883),o=n(1602)(\"toStringTag\");e.exports=function(e,t,n){e&&!i(e=n?e:e.prototype,o)&&r(e,o,{configurable:!0,value:t})}},5904:function(e,t,n){var r=n(2),i=n(665),o=r(\"keys\");e.exports=function(e){return o[e]||(o[e]=i(e))}},9310:function(e,t,n){var r=n(200),i=n(5975),o=\"__core-js_shared__\",s=r[o]||i(o,{});e.exports=s},2:function(e,t,n){var r=n(6926),i=n(9310);(e.exports=function(e,t){return i[e]||(i[e]=void 0!==t?t:{})})(\"versions\",[]).push({version:\"3.14.0\",mode:r?\"pure\":\"global\",copyright:\"© 2021 Denis Pushkarev (zloirock.ru)\"})},6539:function(e,t,n){var r=n(7317),i=Math.max,o=Math.min;e.exports=function(e,t){var n=r(e);return n<0?i(n+t,0):o(n,t)}},5476:function(e,t,n){var r=n(8664),i=n(1229);e.exports=function(e){return r(i(e))}},7317:function(e){var t=Math.ceil,n=Math.floor;e.exports=function(e){return isNaN(e=+e)?0:(e>0?n:t)(e)}},3747:function(e,t,n){var r=n(7317),i=Math.min;e.exports=function(e){return e>0?i(r(e),9007199254740991):0}},2612:function(e,t,n){var r=n(1229);e.exports=function(e){return Object(r(e))}},874:function(e,t,n){var r=n(5335);e.exports=function(e,t){if(!r(e))return e;var n,i;if(t&&\"function\"==typeof(n=e.toString)&&!r(i=n.call(e)))return i;if(\"function\"==typeof(n=e.valueOf)&&!r(i=n.call(e)))return i;if(!t&&\"function\"==typeof(n=e.toString)&&!r(i=n.call(e)))return i;throw TypeError(\"Can't convert object to primitive value\")}},3129:function(e,t,n){var r={};r[n(1602)(\"toStringTag\")]=\"z\",e.exports=\"[object z]\"===String(r)},665:function(e){var t=0,n=Math.random();e.exports=function(e){return\"Symbol(\"+String(void 0===e?\"\":e)+\")_\"+(++t+n).toString(36)}},5225:function(e,t,n){var r=n(1849);e.exports=r&&!Symbol.sham&&\"symbol\"==typeof Symbol.iterator},802:function(e,t,n){var r=n(1602);t.f=r},1602:function(e,t,n){var r=n(200),i=n(2),o=n(1883),s=n(665),a=n(1849),l=n(5225),c=i(\"wks\"),u=r.Symbol,p=l?u:u&&u.withoutSetter||s;e.exports=function(e){return o(c,e)&&(a||\"string\"==typeof c[e])||(a&&o(u,e)?c[e]=u[e]:c[e]=p(\"Symbol.\"+e)),c[e]}},115:function(e,t,n){\"use strict\";var r=n(1605),i=n(2074),o=n(8679),s=n(5335),a=n(2612),l=n(3747),c=n(2057),u=n(2998),p=n(5634),d=n(1602),f=n(6845),h=d(\"isConcatSpreadable\"),m=9007199254740991,g=\"Maximum allowed index exceeded\",y=f>=51||!i((function(){var e=[];return e[h]=!1,e.concat()[0]!==e})),b=p(\"concat\"),v=function(e){if(!s(e))return!1;var t=e[h];return void 0!==t?!!t:o(e)};r({target:\"Array\",proto:!0,forced:!y||!b},{concat:function(e){var t,n,r,i,o,s=a(this),p=u(s,0),d=0;for(t=-1,r=arguments.length;tm)throw TypeError(g);for(n=0;n=m)throw TypeError(g);c(p,d++,o)}return p.length=d,p}})},1586:function(e,t,n){var r=n(200);n(5282)(r.JSON,\"JSON\",!0)},6982:function(e,t,n){n(5282)(Math,\"Math\",!0)},5086:function(e,t,n){var r=n(3129),i=n(7485),o=n(4972);r||i(Object.prototype,\"toString\",o,{unsafe:!0})},3719:function(e,t,n){var r=n(1605),i=n(200),o=n(5282);r({global:!0},{Reflect:{}}),o(i.Reflect,\"Reflect\",!0)},7727:function(e,t,n){n(1272)(\"asyncIterator\")},590:function(e,t,n){\"use strict\";var r=n(1605),i=n(5077),o=n(200),s=n(1883),a=n(5335),l=n(3610).f,c=n(4361),u=o.Symbol;if(i&&\"function\"==typeof u&&(!(\"description\"in u.prototype)||void 0!==u().description)){var p={},d=function(){var e=arguments.length<1||void 0===arguments[0]?void 0:String(arguments[0]),t=this instanceof d?new u(e):void 0===e?u():u(e);return\"\"===e&&(p[t]=!0),t};c(d,u);var f=d.prototype=u.prototype;f.constructor=d;var h=f.toString,m=\"Symbol(test)\"==String(u(\"test\")),g=/^Symbol\\((.*)\\)[^)]+$/;l(f,\"description\",{configurable:!0,get:function(){var e=a(this)?this.valueOf():this,t=h.call(e);if(s(p,e))return\"\";var n=m?t.slice(7,-1):t.replace(g,\"$1\");return\"\"===n?void 0:n}}),r({global:!0,forced:!0},{Symbol:d})}},8290:function(e,t,n){n(1272)(\"hasInstance\")},2619:function(e,t,n){n(1272)(\"isConcatSpreadable\")},4216:function(e,t,n){n(1272)(\"iterator\")},3534:function(e,t,n){\"use strict\";var r=n(1605),i=n(200),o=n(6492),s=n(6926),a=n(5077),l=n(1849),c=n(5225),u=n(2074),p=n(1883),d=n(8679),f=n(5335),h=n(3938),m=n(2612),g=n(5476),y=n(874),b=n(6843),v=n(3105),x=n(1641),w=n(4789),k=n(6509),S=n(8916),E=n(7632),O=n(3610),_=n(9304),A=n(7712),C=n(7485),j=n(2),P=n(5904),T=n(7708),I=n(665),R=n(1602),N=n(802),$=n(1272),L=n(5282),D=n(9206),M=n(1344).forEach,F=P(\"hidden\"),z=\"Symbol\",B=\"prototype\",U=R(\"toPrimitive\"),q=D.set,V=D.getterFor(z),W=Object[B],H=i.Symbol,Y=o(\"JSON\",\"stringify\"),G=E.f,Q=O.f,X=k.f,K=_.f,Z=j(\"symbols\"),J=j(\"op-symbols\"),ee=j(\"string-to-symbol-registry\"),te=j(\"symbol-to-string-registry\"),ne=j(\"wks\"),re=i.QObject,ie=!re||!re[B]||!re[B].findChild,oe=a&&u((function(){return 7!=v(Q({},\"a\",{get:function(){return Q(this,\"a\",{value:7}).a}})).a}))?function(e,t,n){var r=G(W,t);r&&delete W[t],Q(e,t,n),r&&e!==W&&Q(W,t,r)}:Q,se=function(e,t){var n=Z[e]=v(H[B]);return q(n,{type:z,tag:e,description:t}),a||(n.description=t),n},ae=c?function(e){return\"symbol\"==typeof e}:function(e){return Object(e)instanceof H},le=function(e,t,n){e===W&&le(J,t,n),h(e);var r=y(t,!0);return h(n),p(Z,r)?(n.enumerable?(p(e,F)&&e[F][r]&&(e[F][r]=!1),n=v(n,{enumerable:b(0,!1)})):(p(e,F)||Q(e,F,b(1,{})),e[F][r]=!0),oe(e,r,n)):Q(e,r,n)},ce=function(e,t){h(e);var n=g(t),r=x(n).concat(fe(n));return M(r,(function(t){a&&!ue.call(n,t)||le(e,t,n[t])})),e},ue=function(e){var t=y(e,!0),n=K.call(this,t);return!(this===W&&p(Z,t)&&!p(J,t))&&(!(n||!p(this,t)||!p(Z,t)||p(this,F)&&this[F][t])||n)},pe=function(e,t){var n=g(e),r=y(t,!0);if(n!==W||!p(Z,r)||p(J,r)){var i=G(n,r);return!i||!p(Z,r)||p(n,F)&&n[F][r]||(i.enumerable=!0),i}},de=function(e){var t=X(g(e)),n=[];return M(t,(function(e){p(Z,e)||p(T,e)||n.push(e)})),n},fe=function(e){var t=e===W,n=X(t?J:g(e)),r=[];return M(n,(function(e){!p(Z,e)||t&&!p(W,e)||r.push(Z[e])})),r};l||(H=function(){if(this instanceof H)throw TypeError(\"Symbol is not a constructor\");var e=arguments.length&&void 0!==arguments[0]?String(arguments[0]):void 0,t=I(e),n=function(e){this===W&&n.call(J,e),p(this,F)&&p(this[F],t)&&(this[F][t]=!1),oe(this,t,b(1,e))};return a&&ie&&oe(W,t,{configurable:!0,set:n}),se(t,e)},C(H[B],\"toString\",(function(){return V(this).tag})),C(H,\"withoutSetter\",(function(e){return se(I(e),e)})),_.f=ue,O.f=le,E.f=pe,w.f=k.f=de,S.f=fe,N.f=function(e){return se(R(e),e)},a&&(Q(H[B],\"description\",{configurable:!0,get:function(){return V(this).description}}),s||C(W,\"propertyIsEnumerable\",ue,{unsafe:!0}))),r({global:!0,wrap:!0,forced:!l,sham:!l},{Symbol:H}),M(x(ne),(function(e){$(e)})),r({target:z,stat:!0,forced:!l},{for:function(e){var t=String(e);if(p(ee,t))return ee[t];var n=H(t);return ee[t]=n,te[n]=t,n},keyFor:function(e){if(!ae(e))throw TypeError(e+\" is not a symbol\");if(p(te,e))return te[e]},useSetter:function(){ie=!0},useSimple:function(){ie=!1}}),r({target:\"Object\",stat:!0,forced:!l,sham:!a},{create:function(e,t){return void 0===t?v(e):ce(v(e),t)},defineProperty:le,defineProperties:ce,getOwnPropertyDescriptor:pe}),r({target:\"Object\",stat:!0,forced:!l},{getOwnPropertyNames:de,getOwnPropertySymbols:fe}),r({target:\"Object\",stat:!0,forced:u((function(){S.f(1)}))},{getOwnPropertySymbols:function(e){return S.f(m(e))}}),Y&&r({target:\"JSON\",stat:!0,forced:!l||u((function(){var e=H();return\"[null]\"!=Y([e])||\"{}\"!=Y({a:e})||\"{}\"!=Y(Object(e))}))},{stringify:function(e,t,n){for(var r,i=[e],o=1;arguments.length>o;)i.push(arguments[o++]);if(r=t,(f(t)||void 0!==e)&&!ae(e))return d(t)||(t=function(e,t){if(\"function\"==typeof r&&(t=r.call(this,e,t)),!ae(t))return t}),i[1]=t,Y.apply(null,i)}}),H[B][U]||A(H[B],U,H[B].valueOf),L(H,z),T[F]=!0},6195:function(e,t,n){n(1272)(\"matchAll\")},2957:function(e,t,n){n(1272)(\"match\")},4100:function(e,t,n){n(1272)(\"replace\")},3006:function(e,t,n){n(1272)(\"search\")},4910:function(e,t,n){n(1272)(\"species\")},2820:function(e,t,n){n(1272)(\"split\")},6611:function(e,t,n){n(1272)(\"toPrimitive\")},9576:function(e,t,n){n(1272)(\"toStringTag\")},9747:function(e,t,n){n(1272)(\"unscopables\")},8997:function(e,t,n){\"use strict\";var r=n(4991),i=n.n(r),o=n(6314),s=n.n(o)()(i());s.push([e.id,\".ps{overflow:hidden!important;overflow-anchor:none;-ms-overflow-style:none;touch-action:auto;-ms-touch-action:auto}.ps__rail-x{display:none;opacity:0;transition:background-color .2s linear,opacity .2s linear;-webkit-transition:background-color .2s linear,opacity .2s linear;height:15px;bottom:0;position:absolute}.ps__rail-y{display:none;opacity:0;transition:background-color .2s linear,opacity .2s linear;-webkit-transition:background-color .2s linear,opacity .2s linear;width:15px;right:0;position:absolute}.ps--active-x>.ps__rail-x,.ps--active-y>.ps__rail-y{display:block;background-color:transparent}.ps:hover>.ps__rail-x,.ps:hover>.ps__rail-y,.ps--focus>.ps__rail-x,.ps--focus>.ps__rail-y,.ps--scrolling-x>.ps__rail-x,.ps--scrolling-y>.ps__rail-y{opacity:.6}.ps .ps__rail-x:hover,.ps .ps__rail-y:hover,.ps .ps__rail-x:focus,.ps .ps__rail-y:focus,.ps .ps__rail-x.ps--clicking,.ps .ps__rail-y.ps--clicking{background-color:#eee;opacity:.9}.ps__thumb-x{background-color:#aaa;border-radius:6px;transition:background-color .2s linear,height .2s ease-in-out;-webkit-transition:background-color .2s linear,height .2s ease-in-out;height:6px;bottom:2px;position:absolute}.ps__thumb-y{background-color:#aaa;border-radius:6px;transition:background-color .2s linear,width .2s ease-in-out;-webkit-transition:background-color .2s linear,width .2s ease-in-out;width:6px;right:2px;position:absolute}.ps__rail-x:hover>.ps__thumb-x,.ps__rail-x:focus>.ps__thumb-x,.ps__rail-x.ps--clicking .ps__thumb-x{background-color:#999;height:11px}.ps__rail-y:hover>.ps__thumb-y,.ps__rail-y:focus>.ps__thumb-y,.ps__rail-y.ps--clicking .ps__thumb-y{background-color:#999;width:11px}@supports (-ms-overflow-style: none){.ps{overflow:auto!important}}@media screen and (-ms-high-contrast: active),(-ms-high-contrast: none){.ps{overflow:auto!important}}\\n\",\"\",{version:3,sources:[\"webpack://./node_modules/perfect-scrollbar/css/perfect-scrollbar.css\"],names:[],mappings:\"AAGA,IACE,yBAAU,CACV,oBAAiB,CACjB,uBAAoB,CACpB,iBAAc,CACd,qBACF,CAKA,YACE,YAAS,CACT,SAAS,CACT,yDAAqD,CACrD,iEAA6D,CAC7D,WAAQ,CAER,QAAQ,CAER,iBACF,CAEA,YACE,YAAS,CACT,SAAS,CACT,yDAAqD,CACrD,iEAA6D,CAC7D,UAAO,CAEP,OAAO,CAEP,iBACF,CAEA,oDAEE,aAAS,CACT,4BACF,CAEA,oJAME,UACF,CAEA,kJAME,qBAAkB,CAClB,UACF,CAKA,aACE,qBAAkB,CAnEpB,iBAoEiB,CACf,6DAAoD,CACpD,qEAA4D,CAC5D,UAAQ,CAER,UAAQ,CAER,iBACF,CAEA,aACE,qBAAkB,CA/EpB,iBAgFiB,CACf,4DAAmD,CACnD,oEAA2D,CAC3D,SAAO,CAEP,SAAO,CAEP,iBACF,CAEA,oGAGE,qBAAkB,CAClB,WACF,CAEA,oGAGE,qBAAkB,CAClB,UACF,CAGA,qCACE,IACE,uBACF,CACF,CAEA,wEACE,IACE,uBACF,CACF\",sourcesContent:[\"/*\\n * Container style\\n */\\n.ps {\\n overflow: hidden !important;\\n overflow-anchor: none;\\n -ms-overflow-style: none;\\n touch-action: auto;\\n -ms-touch-action: auto;\\n}\\n\\n/*\\n * Scrollbar rail styles\\n */\\n.ps__rail-x {\\n display: none;\\n opacity: 0;\\n transition: background-color .2s linear, opacity .2s linear;\\n -webkit-transition: background-color .2s linear, opacity .2s linear;\\n height: 15px;\\n /* there must be 'bottom' or 'top' for ps__rail-x */\\n bottom: 0px;\\n /* please don't change 'position' */\\n position: absolute;\\n}\\n\\n.ps__rail-y {\\n display: none;\\n opacity: 0;\\n transition: background-color .2s linear, opacity .2s linear;\\n -webkit-transition: background-color .2s linear, opacity .2s linear;\\n width: 15px;\\n /* there must be 'right' or 'left' for ps__rail-y */\\n right: 0;\\n /* please don't change 'position' */\\n position: absolute;\\n}\\n\\n.ps--active-x > .ps__rail-x,\\n.ps--active-y > .ps__rail-y {\\n display: block;\\n background-color: transparent;\\n}\\n\\n.ps:hover > .ps__rail-x,\\n.ps:hover > .ps__rail-y,\\n.ps--focus > .ps__rail-x,\\n.ps--focus > .ps__rail-y,\\n.ps--scrolling-x > .ps__rail-x,\\n.ps--scrolling-y > .ps__rail-y {\\n opacity: 0.6;\\n}\\n\\n.ps .ps__rail-x:hover,\\n.ps .ps__rail-y:hover,\\n.ps .ps__rail-x:focus,\\n.ps .ps__rail-y:focus,\\n.ps .ps__rail-x.ps--clicking,\\n.ps .ps__rail-y.ps--clicking {\\n background-color: #eee;\\n opacity: 0.9;\\n}\\n\\n/*\\n * Scrollbar thumb styles\\n */\\n.ps__thumb-x {\\n background-color: #aaa;\\n border-radius: 6px;\\n transition: background-color .2s linear, height .2s ease-in-out;\\n -webkit-transition: background-color .2s linear, height .2s ease-in-out;\\n height: 6px;\\n /* there must be 'bottom' for ps__thumb-x */\\n bottom: 2px;\\n /* please don't change 'position' */\\n position: absolute;\\n}\\n\\n.ps__thumb-y {\\n background-color: #aaa;\\n border-radius: 6px;\\n transition: background-color .2s linear, width .2s ease-in-out;\\n -webkit-transition: background-color .2s linear, width .2s ease-in-out;\\n width: 6px;\\n /* there must be 'right' for ps__thumb-y */\\n right: 2px;\\n /* please don't change 'position' */\\n position: absolute;\\n}\\n\\n.ps__rail-x:hover > .ps__thumb-x,\\n.ps__rail-x:focus > .ps__thumb-x,\\n.ps__rail-x.ps--clicking .ps__thumb-x {\\n background-color: #999;\\n height: 11px;\\n}\\n\\n.ps__rail-y:hover > .ps__thumb-y,\\n.ps__rail-y:focus > .ps__thumb-y,\\n.ps__rail-y.ps--clicking .ps__thumb-y {\\n background-color: #999;\\n width: 11px;\\n}\\n\\n/* MS supports */\\n@supports (-ms-overflow-style: none) {\\n .ps {\\n overflow: auto !important;\\n }\\n}\\n\\n@media screen and (-ms-high-contrast: active), (-ms-high-contrast: none) {\\n .ps {\\n overflow: auto !important;\\n }\\n}\\n\"],sourceRoot:\"\"}]),t.A=s},6314:function(e){\"use strict\";e.exports=function(e){var t=[];return t.toString=function(){return this.map((function(t){var n=e(t);return t[2]?\"@media \".concat(t[2],\" {\").concat(n,\"}\"):n})).join(\"\")},t.i=function(e,n,r){\"string\"==typeof e&&(e=[[null,e,\"\"]]);var i={};if(r)for(var o=0;oe.length)&&(t=e.length);for(var n=0,r=new Array(t);n2?r:e).apply(void 0,i)}}e.memoize=s,e.debounce=a,e.bind=l,e.default={memoize:s,debounce:a,bind:l}},void 0===(r=n.apply(t,[t]))||(e.exports=r)},6364:function(e){e.exports={}},228:function(e){\"use strict\";var t=Object.prototype.hasOwnProperty,n=\"~\";function r(){}function i(e,t,n){this.fn=e,this.context=t,this.once=n||!1}function o(e,t,r,o,s){if(\"function\"!=typeof r)throw new TypeError(\"The listener must be a function\");var a=new i(r,o||e,s),l=n?n+t:t;return e._events[l]?e._events[l].fn?e._events[l]=[e._events[l],a]:e._events[l].push(a):(e._events[l]=a,e._eventsCount++),e}function s(e,t){0==--e._eventsCount?e._events=new r:delete e._events[t]}function a(){this._events=new r,this._eventsCount=0}Object.create&&(r.prototype=Object.create(null),(new r).__proto__||(n=!1)),a.prototype.eventNames=function(){var e,r,i=[];if(0===this._eventsCount)return i;for(r in e=this._events)t.call(e,r)&&i.push(n?r.slice(1):r);return Object.getOwnPropertySymbols?i.concat(Object.getOwnPropertySymbols(e)):i},a.prototype.listeners=function(e){var t=n?n+e:e,r=this._events[t];if(!r)return[];if(r.fn)return[r.fn];for(var i=0,o=r.length,s=new Array(o);iu.depthLimit)return void a(t,e,r,s);if(void 0!==u.edgesLimit&&i+1>u.edgesLimit)return void a(t,e,r,s);if(o.push(e),Array.isArray(e))for(p=0;pt?1:0}function u(e,t,n,s){void 0===s&&(s=o());var a,l=p(e,\"\",0,[],void 0,0,s)||e;try{a=0===i.length?JSON.stringify(l,t,n):JSON.stringify(l,d(t),n)}catch(e){return JSON.stringify(\"[unable to serialize, circular reference is too complex to analyze]\")}finally{for(;0!==r.length;){var c=r.pop();4===c.length?Object.defineProperty(c[0],c[1],c[3]):c[0][c[1]]=c[2]}}return a}function p(e,i,o,s,l,u,d){var f;if(u+=1,\"object\"==typeof e&&null!==e){for(f=0;fd.depthLimit)return void a(t,e,i,l);if(void 0!==d.edgesLimit&&o+1>d.edgesLimit)return void a(t,e,i,l);if(s.push(e),Array.isArray(e))for(f=0;f0)for(var r=0;r{for(const n of e){if(\"string\"==typeof n&&t===n)return!0;if(n instanceof RegExp&&n.test(t))return!0}}:()=>!1}},5334:function(e,t){\"use strict\";const n=\":A-Za-z_\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\",r=\"[\"+n+\"][\"+n+\"\\\\-.\\\\d\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*\",i=new RegExp(\"^\"+r+\"$\");t.isExist=function(e){return void 0!==e},t.isEmptyObject=function(e){return 0===Object.keys(e).length},t.merge=function(e,t,n){if(t){const r=Object.keys(t),i=r.length;for(let o=0;o5&&\"xml\"===r)return h(\"InvalidXml\",\"XML declaration allowed only at the start of the document.\",g(e,t));if(\"?\"==e[t]&&\">\"==e[t+1]){t++;break}}return t}function a(e,t){if(e.length>t+5&&\"-\"===e[t+1]&&\"-\"===e[t+2]){for(t+=3;t\"===e[t+2]){t+=2;break}}else if(e.length>t+8&&\"D\"===e[t+1]&&\"O\"===e[t+2]&&\"C\"===e[t+3]&&\"T\"===e[t+4]&&\"Y\"===e[t+5]&&\"P\"===e[t+6]&&\"E\"===e[t+7]){let n=1;for(t+=8;t\"===e[t]&&(n--,0===n))break}else if(e.length>t+9&&\"[\"===e[t+1]&&\"C\"===e[t+2]&&\"D\"===e[t+3]&&\"A\"===e[t+4]&&\"T\"===e[t+5]&&\"A\"===e[t+6]&&\"[\"===e[t+7])for(t+=8;t\"===e[t+2]){t+=2;break}return t}t.validate=function(e,t){t=Object.assign({},i,t);const n=[];let l=!1,c=!1;\"\\ufeff\"===e[0]&&(e=e.substr(1));for(let i=0;i\"!==e[i]&&\" \"!==e[i]&&\"\\t\"!==e[i]&&\"\\n\"!==e[i]&&\"\\r\"!==e[i];i++)b+=e[i];if(b=b.trim(),\"/\"===b[b.length-1]&&(b=b.substring(0,b.length-1),i--),p=b,!r.isName(p)){let t;return t=0===b.trim().length?\"Invalid space after '<'.\":\"Tag '\"+b+\"' is an invalid name.\",h(\"InvalidTag\",t,g(e,i))}const v=u(e,i);if(!1===v)return h(\"InvalidAttr\",\"Attributes for '\"+b+\"' have open quote.\",g(e,i));let x=v.value;if(i=v.index,\"/\"===x[x.length-1]){const n=i-x.length;x=x.substring(0,x.length-1);const r=d(x,t);if(!0!==r)return h(r.err.code,r.err.msg,g(e,n+r.err.line));l=!0}else if(y){if(!v.tagClosed)return h(\"InvalidTag\",\"Closing tag '\"+b+\"' doesn't have proper closing.\",g(e,i));if(x.trim().length>0)return h(\"InvalidTag\",\"Closing tag '\"+b+\"' can't have attributes or invalid starting.\",g(e,m));if(0===n.length)return h(\"InvalidTag\",\"Closing tag '\"+b+\"' has not been opened.\",g(e,m));{const t=n.pop();if(b!==t.tagName){let n=g(e,t.tagStartPos);return h(\"InvalidTag\",\"Expected closing tag '\"+t.tagName+\"' (opened in line \"+n.line+\", col \"+n.col+\") instead of closing tag '\"+b+\"'.\",g(e,m))}0==n.length&&(c=!0)}}else{const r=d(x,t);if(!0!==r)return h(r.err.code,r.err.msg,g(e,i-x.length+r.err.line));if(!0===c)return h(\"InvalidXml\",\"Multiple possible root nodes found.\",g(e,i));-1!==t.unpairedTags.indexOf(b)||n.push({tagName:b,tagStartPos:m}),l=!0}for(i++;i0)||h(\"InvalidXml\",\"Invalid '\"+JSON.stringify(n.map((e=>e.tagName)),null,4).replace(/\\r?\\n/g,\"\")+\"' found.\",{line:1,col:1}):h(\"InvalidXml\",\"Start tag expected.\",1)};const l='\"',c=\"'\";function u(e,t){let n=\"\",r=\"\",i=!1;for(;t\"===e[t]&&\"\"===r){i=!0;break}n+=e[t]}return\"\"===r&&{value:n,index:t,tagClosed:i}}const p=new RegExp(\"(\\\\s*)([^\\\\s=]+)(\\\\s*=)?(\\\\s*(['\\\"])(([\\\\s\\\\S])*?)\\\\5)?\",\"g\");function d(e,t){const n=r.getAllMatches(e,p),i={};for(let e=0;e\",\"g\"),val:\">\"},{regex:new RegExp(\"<\",\"g\"),val:\"<\"},{regex:new RegExp(\"'\",\"g\"),val:\"'\"},{regex:new RegExp('\"',\"g\"),val:\""\"}],processEntities:!0,stopNodes:[],oneListGroup:!1};function s(e){this.options=Object.assign({},o,e),!0===this.options.ignoreAttributes||this.options.attributesGroupName?this.isAttribute=function(){return!1}:(this.ignoreAttributesFn=i(this.options.ignoreAttributes),this.attrPrefixLen=this.options.attributeNamePrefix.length,this.isAttribute=c),this.processTextOrObjNode=a,this.options.format?(this.indentate=l,this.tagEndChar=\">\\n\",this.newLine=\"\\n\"):(this.indentate=function(){return\"\"},this.tagEndChar=\">\",this.newLine=\"\")}function a(e,t,n,r){const i=this.j2x(e,n+1,r.concat(t));return void 0!==e[this.options.textNodeName]&&1===Object.keys(e).length?this.buildTextValNode(e[this.options.textNodeName],t,i.attrStr,n):this.buildObjectNode(i.val,t,i.attrStr,n)}function l(e){return this.options.indentBy.repeat(e)}function c(e){return!(!e.startsWith(this.options.attributeNamePrefix)||e===this.options.textNodeName)&&e.substr(this.attrPrefixLen)}s.prototype.build=function(e){return this.options.preserveOrder?r(e,this.options):(Array.isArray(e)&&this.options.arrayNodeName&&this.options.arrayNodeName.length>1&&(e={[this.options.arrayNodeName]:e}),this.j2x(e,0,[]).val)},s.prototype.j2x=function(e,t,n){let r=\"\",i=\"\";const o=n.join(\".\");for(let s in e)if(Object.prototype.hasOwnProperty.call(e,s))if(void 0===e[s])this.isAttribute(s)&&(i+=\"\");else if(null===e[s])this.isAttribute(s)||s===this.options.cdataPropName?i+=\"\":\"?\"===s[0]?i+=this.indentate(t)+\"<\"+s+\"?\"+this.tagEndChar:i+=this.indentate(t)+\"<\"+s+\"/\"+this.tagEndChar;else if(e[s]instanceof Date)i+=this.buildTextValNode(e[s],s,\"\",t);else if(\"object\"!=typeof e[s]){const n=this.isAttribute(s);if(n&&!this.ignoreAttributesFn(n,o))r+=this.buildAttrPairStr(n,\"\"+e[s]);else if(!n)if(s===this.options.textNodeName){let t=this.options.tagValueProcessor(s,\"\"+e[s]);i+=this.replaceEntitiesValue(t)}else i+=this.buildTextValNode(e[s],s,\"\",t)}else if(Array.isArray(e[s])){const r=e[s].length;let o=\"\",a=\"\";for(let l=0;l\"+e+i}},s.prototype.closeTag=function(e){let t=\"\";return-1!==this.options.unpairedTags.indexOf(e)?this.options.suppressUnpairedNode||(t=\"/\"):t=this.options.suppressEmptyNode?\"/\":`>`+this.newLine;if(!1!==this.options.commentPropName&&t===this.options.commentPropName)return this.indentate(r)+`\\x3c!--${e}--\\x3e`+this.newLine;if(\"?\"===t[0])return this.indentate(r)+\"<\"+t+n+\"?\"+this.tagEndChar;{let i=this.options.tagValueProcessor(t,e);return i=this.replaceEntitiesValue(i),\"\"===i?this.indentate(r)+\"<\"+t+n+this.closeTag(t)+this.tagEndChar:this.indentate(r)+\"<\"+t+n+\">\"+i+\"0&&this.options.processEntities)for(let t=0;t`,u=!1;continue}if(f===s.commentPropName){c+=l+`\\x3c!--${d[f][0][s.textNodeName]}--\\x3e`,u=!0;continue}if(\"?\"===f[0]){const e=r(d[\":@\"],s),t=\"?xml\"===f?\"\":l;let n=d[f][0][s.textNodeName];n=0!==n.length?\" \"+n:\"\",c+=t+`<${f}${n}${e}?>`,u=!0;continue}let m=l;\"\"!==m&&(m+=s.indentBy);const g=l+`<${f}${r(d[\":@\"],s)}`,y=t(d[f],s,h,m);-1!==s.unpairedTags.indexOf(f)?s.suppressUnpairedNode?c+=g+\">\":c+=g+\"/>\":y&&0!==y.length||!s.suppressEmptyNode?y&&y.endsWith(\">\")?c+=g+`>${y}${l}`:(c+=g+\">\",y&&\"\"!==l&&(y.includes(\"/>\")||y.includes(\"`):c+=g+\"/>\",u=!0}return c}function n(e){const t=Object.keys(e);for(let n=0;n0&&t.processEntities)for(let n=0;n0&&(r=\"\\n\"),t(e,n,\"\",r)}},9400:function(e,t,n){const r=n(5334);function i(e,t){let n=\"\";for(;t\"===e[t]){if(d?\"-\"===e[t-1]&&\"-\"===e[t-2]&&(d=!1,r--):r--,0===r)break}else\"[\"===e[t]?p=!0:f+=e[t];else{if(p&&s(e,t)){let r,o;t+=7,[r,o,t]=i(e,t+1),-1===o.indexOf(\"&\")&&(n[u(r)]={regx:RegExp(`&${r};`,\"g\"),val:o})}else if(p&&a(e,t))t+=8;else if(p&&l(e,t))t+=8;else if(p&&c(e,t))t+=9;else{if(!o)throw new Error(\"Invalid DOCTYPE\");d=!0}r++,f=\"\"}if(0!==r)throw new Error(\"Unclosed DOCTYPE\")}return{entities:n,i:t}}},460:function(e,t){const n={preserveOrder:!1,attributeNamePrefix:\"@_\",attributesGroupName:!1,textNodeName:\"#text\",ignoreAttributes:!0,removeNSPrefix:!1,allowBooleanAttributes:!1,parseTagValue:!0,parseAttributeValue:!1,trimValues:!0,cdataPropName:!1,numberParseOptions:{hex:!0,leadingZeros:!0,eNotation:!0},tagValueProcessor:function(e,t){return t},attributeValueProcessor:function(e,t){return t},stopNodes:[],alwaysCreateTextNode:!1,isArray:()=>!1,commentPropName:!1,unpairedTags:[],processEntities:!0,htmlEntities:!1,ignoreDeclaration:!1,ignorePiTags:!1,transformTagName:!1,transformAttributeName:!1,updateTag:function(e,t,n){return e}};t.buildOptions=function(e){return Object.assign({},n,e)},t.defaultOptions=n},7680:function(e,t,n){\"use strict\";const r=n(5334),i=n(3832),o=n(9400),s=n(7983),a=n(3085);function l(e){const t=Object.keys(e);for(let n=0;n0)){s||(e=this.replaceEntitiesValue(e));const r=this.options.tagValueProcessor(t,e,n,i,o);return null==r?e:typeof r!=typeof e||r!==e?r:this.options.trimValues||e.trim()===e?w(e,this.options.parseTagValue,this.options.numberParseOptions):e}}function u(e){if(this.options.removeNSPrefix){const t=e.split(\":\"),n=\"/\"===e.charAt(0)?\"/\":\"\";if(\"xmlns\"===t[0])return\"\";2===t.length&&(e=n+t[1])}return e}const p=new RegExp(\"([^\\\\s=]+)\\\\s*(=\\\\s*(['\\\"])([\\\\s\\\\S]*?)\\\\3)?\",\"gm\");function d(e,t,n){if(!0!==this.options.ignoreAttributes&&\"string\"==typeof e){const n=r.getAllMatches(e,p),i=n.length,o={};for(let e=0;e\",a,\"Closing Tag is not closed.\");let i=e.substring(a+2,t).trim();if(this.options.removeNSPrefix){const e=i.indexOf(\":\");-1!==e&&(i=i.substr(e+1))}this.options.transformTagName&&(i=this.options.transformTagName(i)),n&&(r=this.saveTextToParentTag(r,n,s));const o=s.substring(s.lastIndexOf(\".\")+1);if(i&&-1!==this.options.unpairedTags.indexOf(i))throw new Error(`Unpaired tag can not be used as closing tag: `);let l=0;o&&-1!==this.options.unpairedTags.indexOf(o)?(l=s.lastIndexOf(\".\",s.lastIndexOf(\".\")-1),this.tagsNodeStack.pop()):l=s.lastIndexOf(\".\"),s=s.substring(0,l),n=this.tagsNodeStack.pop(),r=\"\",a=t}else if(\"?\"===e[a+1]){let t=v(e,a,!1,\"?>\");if(!t)throw new Error(\"Pi Tag is not closed.\");if(r=this.saveTextToParentTag(r,n,s),this.options.ignoreDeclaration&&\"?xml\"===t.tagName||this.options.ignorePiTags);else{const e=new i(t.tagName);e.add(this.options.textNodeName,\"\"),t.tagName!==t.tagExp&&t.attrExpPresent&&(e[\":@\"]=this.buildAttributesMap(t.tagExp,s,t.tagName)),this.addChild(n,e,s)}a=t.closeIndex+1}else if(\"!--\"===e.substr(a+1,3)){const t=b(e,\"--\\x3e\",a+4,\"Comment is not closed.\");if(this.options.commentPropName){const i=e.substring(a+4,t-2);r=this.saveTextToParentTag(r,n,s),n.add(this.options.commentPropName,[{[this.options.textNodeName]:i}])}a=t}else if(\"!D\"===e.substr(a+1,2)){const t=o(e,a);this.docTypeEntities=t.entities,a=t.i}else if(\"![\"===e.substr(a+1,2)){const t=b(e,\"]]>\",a,\"CDATA is not closed.\")-2,i=e.substring(a+9,t);r=this.saveTextToParentTag(r,n,s);let o=this.parseTextData(i,n.tagname,s,!0,!1,!0,!0);null==o&&(o=\"\"),this.options.cdataPropName?n.add(this.options.cdataPropName,[{[this.options.textNodeName]:i}]):n.add(this.options.textNodeName,o),a=t+2}else{let o=v(e,a,this.options.removeNSPrefix),l=o.tagName;const c=o.rawTagName;let u=o.tagExp,p=o.attrExpPresent,d=o.closeIndex;this.options.transformTagName&&(l=this.options.transformTagName(l)),n&&r&&\"!xml\"!==n.tagname&&(r=this.saveTextToParentTag(r,n,s,!1));const f=n;if(f&&-1!==this.options.unpairedTags.indexOf(f.tagname)&&(n=this.tagsNodeStack.pop(),s=s.substring(0,s.lastIndexOf(\".\"))),l!==t.tagname&&(s+=s?\".\"+l:l),this.isItStopNode(this.options.stopNodes,s,l)){let t=\"\";if(u.length>0&&u.lastIndexOf(\"/\")===u.length-1)\"/\"===l[l.length-1]?(l=l.substr(0,l.length-1),s=s.substr(0,s.length-1),u=l):u=u.substr(0,u.length-1),a=o.closeIndex;else if(-1!==this.options.unpairedTags.indexOf(l))a=o.closeIndex;else{const n=this.readStopNodeData(e,c,d+1);if(!n)throw new Error(`Unexpected end of ${c}`);a=n.i,t=n.tagContent}const r=new i(l);l!==u&&p&&(r[\":@\"]=this.buildAttributesMap(u,s,l)),t&&(t=this.parseTextData(t,l,s,!0,p,!0,!0)),s=s.substr(0,s.lastIndexOf(\".\")),r.add(this.options.textNodeName,t),this.addChild(n,r,s)}else{if(u.length>0&&u.lastIndexOf(\"/\")===u.length-1){\"/\"===l[l.length-1]?(l=l.substr(0,l.length-1),s=s.substr(0,s.length-1),u=l):u=u.substr(0,u.length-1),this.options.transformTagName&&(l=this.options.transformTagName(l));const e=new i(l);l!==u&&p&&(e[\":@\"]=this.buildAttributesMap(u,s,l)),this.addChild(n,e,s),s=s.substr(0,s.lastIndexOf(\".\"))}else{const e=new i(l);this.tagsNodeStack.push(n),l!==u&&p&&(e[\":@\"]=this.buildAttributesMap(u,s,l)),this.addChild(n,e,s),n=e}r=\"\",a=d}}else r+=e[a];return t.child};function h(e,t,n){const r=this.options.updateTag(t.tagname,n,t[\":@\"]);!1===r||(\"string\"==typeof r?(t.tagname=r,e.addChild(t)):e.addChild(t))}const m=function(e){if(this.options.processEntities){for(let t in this.docTypeEntities){const n=this.docTypeEntities[t];e=e.replace(n.regx,n.val)}for(let t in this.lastEntities){const n=this.lastEntities[t];e=e.replace(n.regex,n.val)}if(this.options.htmlEntities)for(let t in this.htmlEntities){const n=this.htmlEntities[t];e=e.replace(n.regex,n.val)}e=e.replace(this.ampEntity.regex,this.ampEntity.val)}return e};function g(e,t,n,r){return e&&(void 0===r&&(r=0===t.child.length),void 0!==(e=this.parseTextData(e,t.tagname,n,!1,!!t[\":@\"]&&0!==Object.keys(t[\":@\"]).length,r))&&\"\"!==e&&t.add(this.options.textNodeName,e),e=\"\"),e}function y(e,t,n){const r=\"*.\"+n;for(const n in e){const i=e[n];if(r===i||t===i)return!0}return!1}function b(e,t,n,r){const i=e.indexOf(t,n);if(-1===i)throw new Error(r);return i+t.length-1}function v(e,t,n,r=\">\"){const i=function(e,t,n=\">\"){let r,i=\"\";for(let o=t;o\",n,`${t} is not closed`);if(e.substring(n+2,o).trim()===t&&(i--,0===i))return{tagContent:e.substring(r,n),i:o};n=o}else if(\"?\"===e[n+1])n=b(e,\"?>\",n+1,\"StopNode is not closed.\");else if(\"!--\"===e.substr(n+1,3))n=b(e,\"--\\x3e\",n+3,\"StopNode is not closed.\");else if(\"![\"===e.substr(n+1,2))n=b(e,\"]]>\",n,\"StopNode is not closed.\")-2;else{const r=v(e,n,\">\");r&&((r&&r.tagName)===t&&\"/\"!==r.tagExp[r.tagExp.length-1]&&i++,n=r.closeIndex)}}function w(e,t,n){if(t&&\"string\"==typeof e){const t=e.trim();return\"true\"===t||\"false\"!==t&&s(e,n)}return r.isExist(e)?e:\"\"}e.exports=class{constructor(e){this.options=e,this.currentNode=null,this.tagsNodeStack=[],this.docTypeEntities={},this.lastEntities={apos:{regex:/&(apos|#39|#x27);/g,val:\"'\"},gt:{regex:/&(gt|#62|#x3E);/g,val:\">\"},lt:{regex:/&(lt|#60|#x3C);/g,val:\"<\"},quot:{regex:/&(quot|#34|#x22);/g,val:'\"'}},this.ampEntity={regex:/&(amp|#38|#x26);/g,val:\"&\"},this.htmlEntities={space:{regex:/&(nbsp|#160);/g,val:\" \"},cent:{regex:/&(cent|#162);/g,val:\"¢\"},pound:{regex:/&(pound|#163);/g,val:\"£\"},yen:{regex:/&(yen|#165);/g,val:\"¥\"},euro:{regex:/&(euro|#8364);/g,val:\"€\"},copyright:{regex:/&(copy|#169);/g,val:\"©\"},reg:{regex:/&(reg|#174);/g,val:\"®\"},inr:{regex:/&(inr|#8377);/g,val:\"₹\"},num_dec:{regex:/&#([0-9]{1,7});/g,val:(e,t)=>String.fromCharCode(Number.parseInt(t,10))},num_hex:{regex:/&#x([0-9a-fA-F]{1,6});/g,val:(e,t)=>String.fromCharCode(Number.parseInt(t,16))}},this.addExternalEntities=l,this.parseXml=f,this.parseTextData=c,this.resolveNameSpace=u,this.buildAttributesMap=d,this.isItStopNode=y,this.replaceEntitiesValue=m,this.readStopNodeData=x,this.saveTextToParentTag=g,this.addChild=h,this.ignoreAttributesFn=a(this.options.ignoreAttributes)}}},2923:function(e,t,n){const{buildOptions:r}=n(460),i=n(7680),{prettify:o}=n(5629),s=n(3918);e.exports=class{constructor(e){this.externalEntities={},this.options=r(e)}parse(e,t){if(\"string\"==typeof e);else{if(!e.toString)throw new Error(\"XML data is accepted in String or Bytes[] form.\");e=e.toString()}if(t){!0===t&&(t={});const n=s.validate(e,t);if(!0!==n)throw Error(`${n.err.msg}:${n.err.line}:${n.err.col}`)}const n=new i(this.options);n.addExternalEntities(this.externalEntities);const r=n.parseXml(e);return this.options.preserveOrder||void 0===r?r:o(r,this.options)}addEntity(e,t){if(-1!==t.indexOf(\"&\"))throw new Error(\"Entity value can't have '&'\");if(-1!==e.indexOf(\"&\")||-1!==e.indexOf(\";\"))throw new Error(\"An entity must be set without '&' and ';'. Eg. use '#xD' for '
'\");if(\"&\"===t)throw new Error(\"An entity with value '&' is not permitted\");this.externalEntities[e]=t}}},5629:function(e,t){\"use strict\";function n(e,t,s){let a;const l={};for(let c=0;c0&&(l[t.textNodeName]=a):void 0!==a&&(l[t.textNodeName]=a),l}function r(e){const t=Object.keys(e);for(let e=0;e0?this.child.push({[e.tagname]:e.child,\":@\":e[\":@\"]}):this.child.push({[e.tagname]:e.child})}}},7593:function(e){var t=Object.prototype.hasOwnProperty,n=Object.prototype.toString;e.exports=function(e,r,i){if(\"[object Function]\"!==n.call(r))throw new TypeError(\"iterator must be a function\");var o=e.length;if(o===+o)for(var s=0;s=55296&&r<=56319&&t+1=56320&&n<=57343?1024*(r-55296)+n-56320+65536:r}function H(e){return/^\\n* /.test(e)}var Y=1,G=2,Q=3,X=4,K=5;function Z(e,t,n,r,o){e.dump=function(){if(0===t.length)return e.quotingType===D?'\"\"':\"''\";if(!e.noCompatMode&&(-1!==N.indexOf(t)||$.test(t)))return e.quotingType===D?'\"'+t+'\"':\"'\"+t+\"'\";var s=e.indent*Math.max(1,n),a=-1===e.lineWidth?-1:Math.max(Math.min(e.lineWidth,40),e.lineWidth-s),c=r||e.flowLevel>-1&&n>=e.flowLevel;switch(function(e,t,n,r,i,o,s,a){var c,p,d=0,R=null,N=!1,$=!1,L=-1!==r,M=-1,F=U(p=W(e,0))&&p!==l&&!B(p)&&p!==w&&p!==O&&p!==k&&p!==x&&p!==A&&p!==C&&p!==P&&p!==I&&p!==m&&p!==y&&p!==v&&p!==f&&p!==T&&p!==S&&p!==E&&p!==b&&p!==h&&p!==g&&p!==_&&p!==j&&function(e){return!B(e)&&e!==k}(W(e,e.length-1));if(t||s)for(c=0;c=65536?c+=2:c++){if(!U(d=W(e,c)))return K;F=F&&V(d,R,a),R=d}else{for(c=0;c=65536?c+=2:c++){if((d=W(e,c))===u)N=!0,L&&($=$||c-M-1>r&&\" \"!==e[M+1],M=c);else if(!U(d))return K;F=F&&V(d,R,a),R=d}$=$||L&&c-M-1>r&&\" \"!==e[M+1]}return N||$?n>9&&H(e)?K:s?o===D?K:G:$?X:Q:!F||s||i(e)?o===D?K:G:Y}(t,c,e.indent,a,(function(t){return function(e,t){var n,r;for(n=0,r=e.implicitTypes.length;n\"+J(t,e.indent)+ee(F(function(e,t){for(var n,r,i,o=/(\\n+)([^\\n]*)/g,s=(i=-1!==(i=e.indexOf(\"\\n\"))?i:e.length,o.lastIndex=i,te(e.slice(0,i),t)),a=\"\\n\"===e[0]||\" \"===e[0];r=o.exec(e);){var l=r[1],c=r[2];n=\" \"===c[0],s+=l+(a||n||\"\"===c?\"\":\"\\n\")+te(c,t),a=n}return s}(t,a),s));case K:return'\"'+function(e){for(var t,n=\"\",r=0,i=0;i=65536?i+=2:i++)r=W(e,i),!(t=R[r])&&U(r)?(n+=e[i],r>=65536&&(n+=e[i+1])):n+=t||L(r);return n}(t)+'\"';default:throw new i(\"impossible error: invalid scalar style\")}}()}function J(e,t){var n=H(e)?String(t):\"\",r=\"\\n\"===e[e.length-1];return n+(!r||\"\\n\"!==e[e.length-2]&&\"\\n\"!==e?r?\"\":\"-\":\"+\")+\"\\n\"}function ee(e){return\"\\n\"===e[e.length-1]?e.slice(0,-1):e}function te(e,t){if(\"\"===e||\" \"===e[0])return e;for(var n,r,i=/ [^ ]/g,o=0,s=0,a=0,l=\"\";n=i.exec(e);)(a=n.index)-o>t&&(r=s>o?s:a,l+=\"\\n\"+e.slice(o,r),o=r+1),s=a;return l+=\"\\n\",e.length-o>t&&s>o?l+=e.slice(o,s)+\"\\n\"+e.slice(s+1):l+=e.slice(o),l.slice(1)}function ne(e,t,n,r){var i,o,s,a=\"\",l=e.tag;for(i=0,o=n.length;i tag resolver accepts not \"'+p+'\" style');r=u.represent[p](t,p)}e.dump=r}return!0}return!1}function ie(e,t,n,r,o,a,l){e.tag=null,e.dump=n,re(e,n,!1)||re(e,n,!0);var c,p=s.call(e.dump),d=r;r&&(r=e.flowLevel<0||e.flowLevel>t);var f,h,m=\"[object Object]\"===p||\"[object Array]\"===p;if(m&&(h=-1!==(f=e.duplicates.indexOf(n))),(null!==e.tag&&\"?\"!==e.tag||h||2!==e.indent&&t>0)&&(o=!1),h&&e.usedDuplicates[f])e.dump=\"*ref_\"+f;else{if(m&&h&&!e.usedDuplicates[f]&&(e.usedDuplicates[f]=!0),\"[object Object]\"===p)r&&0!==Object.keys(e.dump).length?(function(e,t,n,r){var o,s,a,l,c,p,d=\"\",f=e.tag,h=Object.keys(n);if(!0===e.sortKeys)h.sort();else if(\"function\"==typeof e.sortKeys)h.sort(e.sortKeys);else if(e.sortKeys)throw new i(\"sortKeys must be a boolean or a function\");for(o=0,s=h.length;o1024)&&(e.dump&&u===e.dump.charCodeAt(0)?p+=\"?\":p+=\"? \"),p+=e.dump,c&&(p+=z(e,t)),ie(e,t+1,l,!0,c)&&(e.dump&&u===e.dump.charCodeAt(0)?p+=\":\":p+=\": \",d+=p+=e.dump));e.tag=f,e.dump=d||\"{}\"}(e,t,e.dump,o),h&&(e.dump=\"&ref_\"+f+e.dump)):(function(e,t,n){var r,i,o,s,a,l=\"\",c=e.tag,u=Object.keys(n);for(r=0,i=u.length;r1024&&(a+=\"? \"),a+=e.dump+(e.condenseFlow?'\"':\"\")+\":\"+(e.condenseFlow?\"\":\" \"),ie(e,t,s,!1,!1)&&(l+=a+=e.dump));e.tag=c,e.dump=\"{\"+l+\"}\"}(e,t,e.dump),h&&(e.dump=\"&ref_\"+f+\" \"+e.dump));else if(\"[object Array]\"===p)r&&0!==e.dump.length?(e.noArrayIndent&&!l&&t>0?ne(e,t-1,e.dump,o):ne(e,t,e.dump,o),h&&(e.dump=\"&ref_\"+f+e.dump)):(function(e,t,n){var r,i,o,s=\"\",a=e.tag;for(r=0,i=n.length;r\",e.dump=c+\" \"+e.dump)}return!0}function oe(e,t){var n,r,i=[],o=[];for(se(e,i,o),n=0,r=o.length;n>10),56320+(e-65536&1023))}for(var C=new Array(256),j=new Array(256),P=0;P<256;P++)C[P]=_(P)?1:0,j[P]=_(P);function T(e,t){this.input=e,this.filename=t.filename||null,this.schema=t.schema||s,this.onWarning=t.onWarning||null,this.legacy=t.legacy||!1,this.json=t.json||!1,this.listener=t.listener||null,this.implicitTypes=this.schema.compiledImplicit,this.typeMap=this.schema.compiledTypeMap,this.length=e.length,this.position=0,this.line=0,this.lineStart=0,this.lineIndent=0,this.firstTabInLine=-1,this.documents=[]}function I(e,t){var n={name:e.filename,buffer:e.input.slice(0,-1),position:e.position,line:e.line,column:e.position-e.lineStart};return n.snippet=o(n),new i(t,n)}function R(e,t){throw I(e,t)}function N(e,t){e.onWarning&&e.onWarning.call(null,I(e,t))}var $={YAML:function(e,t,n){var r,i,o;null!==e.version&&R(e,\"duplication of %YAML directive\"),1!==n.length&&R(e,\"YAML directive accepts exactly one argument\"),null===(r=/^([0-9]+)\\.([0-9]+)$/.exec(n[0]))&&R(e,\"ill-formed argument of the YAML directive\"),i=parseInt(r[1],10),o=parseInt(r[2],10),1!==i&&R(e,\"unacceptable YAML version of the document\"),e.version=n[0],e.checkLineBreaks=o<2,1!==o&&2!==o&&N(e,\"unsupported YAML version of the document\")},TAG:function(e,t,n){var r,i;2!==n.length&&R(e,\"TAG directive accepts exactly two arguments\"),r=n[0],i=n[1],b.test(r)||R(e,\"ill-formed tag handle (first argument) of the TAG directive\"),a.call(e.tagMap,r)&&R(e,'there is a previously declared suffix for \"'+r+'\" tag handle'),v.test(i)||R(e,\"ill-formed tag prefix (second argument) of the TAG directive\");try{i=decodeURIComponent(i)}catch(t){R(e,\"tag prefix is malformed: \"+i)}e.tagMap[r]=i}};function L(e,t,n,r){var i,o,s,a;if(t1&&(e.result+=r.repeat(\"\\n\",t-1))}function q(e,t){var n,r,i=e.tag,o=e.anchor,s=[],a=!1;if(-1!==e.firstTabInLine)return!1;for(null!==e.anchor&&(e.anchorMap[e.anchor]=s),r=e.input.charCodeAt(e.position);0!==r&&(-1!==e.firstTabInLine&&(e.position=e.firstTabInLine,R(e,\"tab characters must not be used in indentation\")),45===r)&&S(e.input.charCodeAt(e.position+1));)if(a=!0,e.position++,z(e,!0,-1)&&e.lineIndent<=t)s.push(null),r=e.input.charCodeAt(e.position);else if(n=e.line,H(e,t,u,!1,!0),s.push(e.result),z(e,!0,-1),r=e.input.charCodeAt(e.position),(e.line===n||e.lineIndent>t)&&0!==r)R(e,\"bad indentation of a sequence entry\");else if(e.lineIndentt?T=1:e.lineIndent===t?T=0:e.lineIndentt?T=1:e.lineIndent===t?T=0:e.lineIndentt)&&(v&&(s=e.line,a=e.lineStart,l=e.position),H(e,t,p,!0,i)&&(v?y=e.result:b=e.result),v||(M(e,h,m,g,y,b,s,a,l),g=y=b=null),z(e,!0,-1),u=e.input.charCodeAt(e.position)),(e.line===o||e.lineIndent>t)&&0!==u)R(e,\"bad indentation of a mapping entry\");else if(e.lineIndent=0))break;0===o?R(e,\"bad explicit indentation width of a block scalar; it cannot be less than one\"):u?R(e,\"repeat of an indentation width identifier\"):(p=t+o-1,u=!0)}if(k(s)){do{s=e.input.charCodeAt(++e.position)}while(k(s));if(35===s)do{s=e.input.charCodeAt(++e.position)}while(!w(s)&&0!==s)}for(;0!==s;){for(F(e),e.lineIndent=0,s=e.input.charCodeAt(e.position);(!u||e.lineIndentp&&(p=e.lineIndent),w(s))m++;else{if(e.lineIndent0){for(i=s,o=0;i>0;i--)(s=O(a=e.input.charCodeAt(++e.position)))>=0?o=(o<<4)+s:R(e,\"expected hexadecimal character\");e.result+=A(o),e.position++}else R(e,\"unknown escape sequence\");n=r=e.position}else w(a)?(L(e,n,r,!0),U(e,z(e,!1,t)),n=r=e.position):e.position===e.lineStart&&B(e)?R(e,\"unexpected end of the document within a double quoted scalar\"):(e.position++,r=e.position)}R(e,\"unexpected end of the stream within a double quoted scalar\")}(e,_)?N=!0:function(e){var t,n,r;if(42!==(r=e.input.charCodeAt(e.position)))return!1;for(r=e.input.charCodeAt(++e.position),t=e.position;0!==r&&!S(r)&&!E(r);)r=e.input.charCodeAt(++e.position);return e.position===t&&R(e,\"name of an alias node must contain at least one character\"),n=e.input.slice(t,e.position),a.call(e.anchorMap,n)||R(e,'unidentified alias \"'+n+'\"'),e.result=e.anchorMap[n],z(e,!0,-1),!0}(e)?(N=!0,null===e.tag&&null===e.anchor||R(e,\"alias node should not have any properties\")):function(e,t,n){var r,i,o,s,a,l,c,u,p=e.kind,d=e.result;if(S(u=e.input.charCodeAt(e.position))||E(u)||35===u||38===u||42===u||33===u||124===u||62===u||39===u||34===u||37===u||64===u||96===u)return!1;if((63===u||45===u)&&(S(r=e.input.charCodeAt(e.position+1))||n&&E(r)))return!1;for(e.kind=\"scalar\",e.result=\"\",i=o=e.position,s=!1;0!==u;){if(58===u){if(S(r=e.input.charCodeAt(e.position+1))||n&&E(r))break}else if(35===u){if(S(e.input.charCodeAt(e.position-1)))break}else{if(e.position===e.lineStart&&B(e)||n&&E(u))break;if(w(u)){if(a=e.line,l=e.lineStart,c=e.lineIndent,z(e,!1,-1),e.lineIndent>=t){s=!0,u=e.input.charCodeAt(e.position);continue}e.position=o,e.line=a,e.lineStart=l,e.lineIndent=c;break}}s&&(L(e,i,o,!1),U(e,e.line-a),i=o=e.position,s=!1),k(u)||(o=e.position+1),u=e.input.charCodeAt(++e.position)}return L(e,i,o,!1),!!e.result||(e.kind=p,e.result=d,!1)}(e,_,l===n)&&(N=!0,null===e.tag&&(e.tag=\"?\")),null!==e.anchor&&(e.anchorMap[e.anchor]=e.result)):0===T&&(N=g&&q(e,P))),null===e.tag)null!==e.anchor&&(e.anchorMap[e.anchor]=e.result);else if(\"?\"===e.tag){for(null!==e.result&&\"scalar\"!==e.kind&&R(e,'unacceptable node kind for ! tag; it should be \"scalar\", not \"'+e.kind+'\"'),y=0,b=e.implicitTypes.length;y\"),null!==e.result&&x.kind!==e.kind&&R(e,\"unacceptable node kind for !<\"+e.tag+'> tag; it should be \"'+x.kind+'\", not \"'+e.kind+'\"'),x.resolve(e.result,e.tag)?(e.result=x.construct(e.result,e.tag),null!==e.anchor&&(e.anchorMap[e.anchor]=e.result)):R(e,\"cannot resolve a node with !<\"+e.tag+\"> explicit tag\")}return null!==e.listener&&e.listener(\"close\",e),null!==e.tag||null!==e.anchor||N}function Y(e){var t,n,r,i,o=e.position,s=!1;for(e.version=null,e.checkLineBreaks=e.legacy,e.tagMap=Object.create(null),e.anchorMap=Object.create(null);0!==(i=e.input.charCodeAt(e.position))&&(z(e,!0,-1),i=e.input.charCodeAt(e.position),!(e.lineIndent>0||37!==i));){for(s=!0,i=e.input.charCodeAt(++e.position),t=e.position;0!==i&&!S(i);)i=e.input.charCodeAt(++e.position);for(r=[],(n=e.input.slice(t,e.position)).length<1&&R(e,\"directive name must not be less than one character in length\");0!==i;){for(;k(i);)i=e.input.charCodeAt(++e.position);if(35===i){do{i=e.input.charCodeAt(++e.position)}while(0!==i&&!w(i));break}if(w(i))break;for(t=e.position;0!==i&&!S(i);)i=e.input.charCodeAt(++e.position);r.push(e.input.slice(t,e.position))}0!==i&&F(e),a.call($,n)?$[n](e,n,r):N(e,'unknown document directive \"'+n+'\"')}z(e,!0,-1),0===e.lineIndent&&45===e.input.charCodeAt(e.position)&&45===e.input.charCodeAt(e.position+1)&&45===e.input.charCodeAt(e.position+2)?(e.position+=3,z(e,!0,-1)):s&&R(e,\"directives end mark is expected\"),H(e,e.lineIndent-1,p,!1,!0),z(e,!0,-1),e.checkLineBreaks&&g.test(e.input.slice(o,e.position))&&N(e,\"non-ASCII line breaks are interpreted as content\"),e.documents.push(e.result),e.position===e.lineStart&&B(e)?46===e.input.charCodeAt(e.position)&&(e.position+=3,z(e,!0,-1)):e.positiona&&(t=r-a+(o=\" ... \").length),n-r>a&&(n=r+a-(s=\" ...\").length),{str:o+e.slice(t,n).replace(/\\t/g,\"→\")+s,pos:r-t+o.length}}function o(e,t){return r.repeat(\" \",t-e.length)+e}e.exports=function(e,t){if(t=Object.create(t||null),!e.buffer)return null;t.maxLength||(t.maxLength=79),\"number\"!=typeof t.indent&&(t.indent=1),\"number\"!=typeof t.linesBefore&&(t.linesBefore=3),\"number\"!=typeof t.linesAfter&&(t.linesAfter=2);for(var n,s=/\\r?\\n|\\r|\\0/g,a=[0],l=[],c=-1;n=s.exec(e.buffer);)l.push(n.index),a.push(n.index+n[0].length),e.position<=n.index&&c<0&&(c=a.length-2);c<0&&(c=a.length-1);var u,p,d=\"\",f=Math.min(e.line+t.linesAfter,l.length).toString().length,h=t.maxLength-(t.indent+f+3);for(u=1;u<=t.linesBefore&&!(c-u<0);u++)p=i(e.buffer,a[c-u],l[c-u],e.position-(a[c]-a[c-u]),h),d=r.repeat(\" \",t.indent)+o((e.line-u+1).toString(),f)+\" | \"+p.str+\"\\n\"+d;for(p=i(e.buffer,a[c],l[c],e.position,h),d+=r.repeat(\" \",t.indent)+o((e.line+1).toString(),f)+\" | \"+p.str+\"\\n\",d+=r.repeat(\"-\",t.indent+f+3+p.pos)+\"^\\n\",u=1;u<=t.linesAfter&&!(c+u>=l.length);u++)p=i(e.buffer,a[c+u],l[c+u],e.position-(a[c]-a[c+u]),h),d+=r.repeat(\" \",t.indent)+o((e.line+u+1).toString(),f)+\" | \"+p.str+\"\\n\";return d.replace(/\\n$/,\"\")}},5388:function(e,t,n){\"use strict\";var r=n(1231),i=[\"kind\",\"multi\",\"resolve\",\"construct\",\"instanceOf\",\"predicate\",\"represent\",\"representName\",\"defaultStyle\",\"styleAliases\"],o=[\"scalar\",\"sequence\",\"mapping\"];e.exports=function(e,t){var n,s;if(t=t||{},Object.keys(t).forEach((function(t){if(-1===i.indexOf(t))throw new r('Unknown option \"'+t+'\" is met in definition of \"'+e+'\" YAML type.')})),this.options=t,this.tag=e,this.kind=t.kind||null,this.resolve=t.resolve||function(){return!0},this.construct=t.construct||function(e){return e},this.instanceOf=t.instanceOf||null,this.predicate=t.predicate||null,this.represent=t.represent||null,this.representName=t.representName||null,this.defaultStyle=t.defaultStyle||null,this.multi=t.multi||!1,this.styleAliases=(n=t.styleAliases||null,s={},null!==n&&Object.keys(n).forEach((function(e){n[e].forEach((function(t){s[String(t)]=e}))})),s),-1===o.indexOf(this.kind))throw new r('Unknown kind \"'+this.kind+'\" is specified for \"'+e+'\" YAML type.')}},9342:function(e,t,n){\"use strict\";var r=n(5388),i=\"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=\\n\\r\";e.exports=new r(\"tag:yaml.org,2002:binary\",{kind:\"scalar\",resolve:function(e){if(null===e)return!1;var t,n,r=0,o=e.length,s=i;for(n=0;n64)){if(t<0)return!1;r+=6}return r%8==0},construct:function(e){var t,n,r=e.replace(/[\\r\\n=]/g,\"\"),o=r.length,s=i,a=0,l=[];for(t=0;t>16&255),l.push(a>>8&255),l.push(255&a)),a=a<<6|s.indexOf(r.charAt(t));return 0==(n=o%4*6)?(l.push(a>>16&255),l.push(a>>8&255),l.push(255&a)):18===n?(l.push(a>>10&255),l.push(a>>2&255)):12===n&&l.push(a>>4&255),new Uint8Array(l)},predicate:function(e){return\"[object Uint8Array]\"===Object.prototype.toString.call(e)},represent:function(e){var t,n,r=\"\",o=0,s=e.length,a=i;for(t=0;t>18&63],r+=a[o>>12&63],r+=a[o>>6&63],r+=a[63&o]),o=(o<<8)+e[t];return 0==(n=s%3)?(r+=a[o>>18&63],r+=a[o>>12&63],r+=a[o>>6&63],r+=a[63&o]):2===n?(r+=a[o>>10&63],r+=a[o>>4&63],r+=a[o<<2&63],r+=a[64]):1===n&&(r+=a[o>>2&63],r+=a[o<<4&63],r+=a[64],r+=a[64]),r}})},6199:function(e,t,n){\"use strict\";var r=n(5388);e.exports=new r(\"tag:yaml.org,2002:bool\",{kind:\"scalar\",resolve:function(e){if(null===e)return!1;var t=e.length;return 4===t&&(\"true\"===e||\"True\"===e||\"TRUE\"===e)||5===t&&(\"false\"===e||\"False\"===e||\"FALSE\"===e)},construct:function(e){return\"true\"===e||\"True\"===e||\"TRUE\"===e},predicate:function(e){return\"[object Boolean]\"===Object.prototype.toString.call(e)},represent:{lowercase:function(e){return e?\"true\":\"false\"},uppercase:function(e){return e?\"TRUE\":\"FALSE\"},camelcase:function(e){return e?\"True\":\"False\"}},defaultStyle:\"lowercase\"})},1461:function(e,t,n){\"use strict\";var r=n(8433),i=n(5388),o=new RegExp(\"^(?:[-+]?(?:[0-9][0-9_]*)(?:\\\\.[0-9_]*)?(?:[eE][-+]?[0-9]+)?|\\\\.[0-9_]+(?:[eE][-+]?[0-9]+)?|[-+]?\\\\.(?:inf|Inf|INF)|\\\\.(?:nan|NaN|NAN))$\"),s=/^[-+]?[0-9]+e/;e.exports=new i(\"tag:yaml.org,2002:float\",{kind:\"scalar\",resolve:function(e){return null!==e&&!(!o.test(e)||\"_\"===e[e.length-1])},construct:function(e){var t,n;return n=\"-\"===(t=e.replace(/_/g,\"\").toLowerCase())[0]?-1:1,\"+-\".indexOf(t[0])>=0&&(t=t.slice(1)),\".inf\"===t?1===n?Number.POSITIVE_INFINITY:Number.NEGATIVE_INFINITY:\".nan\"===t?NaN:n*parseFloat(t,10)},predicate:function(e){return\"[object Number]\"===Object.prototype.toString.call(e)&&(e%1!=0||r.isNegativeZero(e))},represent:function(e,t){var n;if(isNaN(e))switch(t){case\"lowercase\":return\".nan\";case\"uppercase\":return\".NAN\";case\"camelcase\":return\".NaN\"}else if(Number.POSITIVE_INFINITY===e)switch(t){case\"lowercase\":return\".inf\";case\"uppercase\":return\".INF\";case\"camelcase\":return\".Inf\"}else if(Number.NEGATIVE_INFINITY===e)switch(t){case\"lowercase\":return\"-.inf\";case\"uppercase\":return\"-.INF\";case\"camelcase\":return\"-.Inf\"}else if(r.isNegativeZero(e))return\"-0.0\";return n=e.toString(10),s.test(n)?n.replace(\"e\",\".e\"):n},defaultStyle:\"lowercase\"})},4466:function(e,t,n){\"use strict\";var r=n(8433),i=n(5388);function o(e){return 48<=e&&e<=55}function s(e){return 48<=e&&e<=57}e.exports=new i(\"tag:yaml.org,2002:int\",{kind:\"scalar\",resolve:function(e){if(null===e)return!1;var t,n,r=e.length,i=0,a=!1;if(!r)return!1;if(\"-\"!==(t=e[i])&&\"+\"!==t||(t=e[++i]),\"0\"===t){if(i+1===r)return!0;if(\"b\"===(t=e[++i])){for(i++;i=0?\"0b\"+e.toString(2):\"-0b\"+e.toString(2).slice(1)},octal:function(e){return e>=0?\"0o\"+e.toString(8):\"-0o\"+e.toString(8).slice(1)},decimal:function(e){return e.toString(10)},hexadecimal:function(e){return e>=0?\"0x\"+e.toString(16).toUpperCase():\"-0x\"+e.toString(16).toUpperCase().slice(1)}},defaultStyle:\"decimal\",styleAliases:{binary:[2,\"bin\"],octal:[8,\"oct\"],decimal:[10,\"dec\"],hexadecimal:[16,\"hex\"]}})},2369:function(e,t,n){\"use strict\";var r=n(5388);e.exports=new r(\"tag:yaml.org,2002:map\",{kind:\"mapping\",construct:function(e){return null!==e?e:{}}})},1851:function(e,t,n){\"use strict\";var r=n(5388);e.exports=new r(\"tag:yaml.org,2002:merge\",{kind:\"scalar\",resolve:function(e){return\"<<\"===e||null===e}})},9198:function(e,t,n){\"use strict\";var r=n(5388);e.exports=new r(\"tag:yaml.org,2002:null\",{kind:\"scalar\",resolve:function(e){if(null===e)return!0;var t=e.length;return 1===t&&\"~\"===e||4===t&&(\"null\"===e||\"Null\"===e||\"NULL\"===e)},construct:function(){return null},predicate:function(e){return null===e},represent:{canonical:function(){return\"~\"},lowercase:function(){return\"null\"},uppercase:function(){return\"NULL\"},camelcase:function(){return\"Null\"},empty:function(){return\"\"}},defaultStyle:\"lowercase\"})},6946:function(e,t,n){\"use strict\";var r=n(5388),i=Object.prototype.hasOwnProperty,o=Object.prototype.toString;e.exports=new r(\"tag:yaml.org,2002:omap\",{kind:\"sequence\",resolve:function(e){if(null===e)return!0;var t,n,r,s,a,l=[],c=e;for(t=0,n=c.length;tc))return!1;var p=a.get(e);if(p&&a.get(t))return p==t;var d=-1,f=!0,h=n&o?new Ae:void 0;for(a.set(e,t),a.set(t,e);++d-1},Oe.prototype.set=function(e,t){var n=this.__data__,r=je(n,e);return r<0?(++this.size,n.push([e,t])):n[r][1]=t,this},_e.prototype.clear=function(){this.size=0,this.__data__={hash:new Ee,map:new(de||Oe),string:new Ee}},_e.prototype.delete=function(e){var t=$e(this,e).delete(e);return this.size-=t?1:0,t},_e.prototype.get=function(e){return $e(this,e).get(e)},_e.prototype.has=function(e){return $e(this,e).has(e)},_e.prototype.set=function(e,t){var n=$e(this,e),r=n.size;return n.set(e,t),this.size+=n.size==r?0:1,this},Ae.prototype.add=Ae.prototype.push=function(e){return this.__data__.set(e,r),this},Ae.prototype.has=function(e){return this.__data__.has(e)},Ce.prototype.clear=function(){this.__data__=new Oe,this.size=0},Ce.prototype.delete=function(e){var t=this.__data__,n=t.delete(e);return this.size=t.size,n},Ce.prototype.get=function(e){return this.__data__.get(e)},Ce.prototype.has=function(e){return this.__data__.has(e)},Ce.prototype.set=function(e,t){var n=this.__data__;if(n instanceof Oe){var r=n.__data__;if(!de||r.length<199)return r.push([e,t]),this.size=++n.size,this;n=this.__data__=new _e(r)}return n.set(e,t),this.size=n.size,this};var De=le?function(e){return null==e?[]:(e=Object(e),function(t){for(var n=-1,r=null==t?0:t.length,i=0,o=[];++n-1&&e%1==0&&e-1&&e%1==0&&e<=s}function Ye(e){var t=typeof e;return null!=e&&(\"object\"==t||\"function\"==t)}function Ge(e){return null!=e&&\"object\"==typeof e}var Qe=F?function(e){return function(t){return e(t)}}(F):function(e){return Ge(e)&&He(e.length)&&!!P[Pe(e)]};function Xe(e){return null!=(t=e)&&He(t.length)&&!We(t)?function(e,t){var n=qe(e),r=!n&&Ue(e),i=!n&&!r&&Ve(e),o=!n&&!r&&!i&&Qe(e),s=n||r||i||o,a=s?function(e,t){for(var n=-1,r=Array(e);++n1&&void 0!==arguments[1])||arguments[1],i=arguments.length>2&&void 0!==arguments[2]?arguments[2]:[],o=arguments.length>3&&void 0!==arguments[3]?arguments[3]:5e3;t(this,e),this.ctx=n,this.iframes=r,this.exclude=i,this.iframesTimeout=o}return n(e,[{key:\"getContexts\",value:function(){var e=[];return(void 0!==this.ctx&&this.ctx?NodeList.prototype.isPrototypeOf(this.ctx)?Array.prototype.slice.call(this.ctx):Array.isArray(this.ctx)?this.ctx:\"string\"==typeof this.ctx?Array.prototype.slice.call(document.querySelectorAll(this.ctx)):[this.ctx]:[]).forEach((function(t){var n=e.filter((function(e){return e.contains(t)})).length>0;-1!==e.indexOf(t)||n||e.push(t)})),e}},{key:\"getIframeContents\",value:function(e,t){var n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:function(){},r=void 0;try{var i=e.contentWindow;if(r=i.document,!i||!r)throw new Error(\"iframe inaccessible\")}catch(e){n()}r&&t(r)}},{key:\"isIframeBlank\",value:function(e){var t=\"about:blank\",n=e.getAttribute(\"src\").trim();return e.contentWindow.location.href===t&&n!==t&&n}},{key:\"observeIframeLoad\",value:function(e,t,n){var r=this,i=!1,o=null,s=function s(){if(!i){i=!0,clearTimeout(o);try{r.isIframeBlank(e)||(e.removeEventListener(\"load\",s),r.getIframeContents(e,t,n))}catch(e){n()}}};e.addEventListener(\"load\",s),o=setTimeout(s,this.iframesTimeout)}},{key:\"onIframeReady\",value:function(e,t,n){try{\"complete\"===e.contentWindow.document.readyState?this.isIframeBlank(e)?this.observeIframeLoad(e,t,n):this.getIframeContents(e,t,n):this.observeIframeLoad(e,t,n)}catch(e){n()}}},{key:\"waitForIframes\",value:function(e,t){var n=this,r=0;this.forEachIframe(e,(function(){return!0}),(function(e){r++,n.waitForIframes(e.querySelector(\"html\"),(function(){--r||t()}))}),(function(e){e||t()}))}},{key:\"forEachIframe\",value:function(t,n,r){var i=this,o=arguments.length>3&&void 0!==arguments[3]?arguments[3]:function(){},s=t.querySelectorAll(\"iframe\"),a=s.length,l=0;s=Array.prototype.slice.call(s);var c=function(){--a<=0&&o(l)};a||c(),s.forEach((function(t){e.matches(t,i.exclude)?c():i.onIframeReady(t,(function(e){n(t)&&(l++,r(e)),c()}),c)}))}},{key:\"createIterator\",value:function(e,t,n){return document.createNodeIterator(e,t,n,!1)}},{key:\"createInstanceOnIframe\",value:function(t){return new e(t.querySelector(\"html\"),this.iframes)}},{key:\"compareNodeIframe\",value:function(e,t,n){if(e.compareDocumentPosition(n)&Node.DOCUMENT_POSITION_PRECEDING){if(null===t)return!0;if(t.compareDocumentPosition(n)&Node.DOCUMENT_POSITION_FOLLOWING)return!0}return!1}},{key:\"getIteratorNode\",value:function(e){var t=e.previousNode();return{prevNode:t,node:(null===t||e.nextNode())&&e.nextNode()}}},{key:\"checkIframeFilter\",value:function(e,t,n,r){var i=!1,o=!1;return r.forEach((function(e,t){e.val===n&&(i=t,o=e.handled)})),this.compareNodeIframe(e,t,n)?(!1!==i||o?!1===i||o||(r[i].handled=!0):r.push({val:n,handled:!0}),!0):(!1===i&&r.push({val:n,handled:!1}),!1)}},{key:\"handleOpenIframes\",value:function(e,t,n,r){var i=this;e.forEach((function(e){e.handled||i.getIframeContents(e.val,(function(e){i.createInstanceOnIframe(e).forEachNode(t,n,r)}))}))}},{key:\"iterateThroughNodes\",value:function(e,t,n,r,i){for(var o=this,s=this.createIterator(t,e,r),a=[],l=[],c=void 0,u=void 0;p=void 0,p=o.getIteratorNode(s),u=p.prevNode,c=p.node;)this.iframes&&this.forEachIframe(t,(function(e){return o.checkIframeFilter(c,u,e,a)}),(function(t){o.createInstanceOnIframe(t).forEachNode(e,(function(e){return l.push(e)}),r)})),l.push(c);var p;l.forEach((function(e){n(e)})),this.iframes&&this.handleOpenIframes(a,e,n,r),i()}},{key:\"forEachNode\",value:function(e,t,n){var r=this,i=arguments.length>3&&void 0!==arguments[3]?arguments[3]:function(){},o=this.getContexts(),s=o.length;s||i(),o.forEach((function(o){var a=function(){r.iterateThroughNodes(e,o,t,n,(function(){--s<=0&&i()}))};r.iframes?r.waitForIframes(o,a):a()}))}}],[{key:\"matches\",value:function(e,t){var n=\"string\"==typeof t?[t]:t,r=e.matches||e.matchesSelector||e.msMatchesSelector||e.mozMatchesSelector||e.oMatchesSelector||e.webkitMatchesSelector;if(r){var i=!1;return n.every((function(t){return!r.call(e,t)||(i=!0,!1)})),i}return!1}}]),e}(),o=function(){function o(e){t(this,o),this.ctx=e,this.ie=!1;var n=window.navigator.userAgent;(n.indexOf(\"MSIE\")>-1||n.indexOf(\"Trident\")>-1)&&(this.ie=!0)}return n(o,[{key:\"log\",value:function(t){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:\"debug\",r=this.opt.log;this.opt.debug&&\"object\"===(void 0===r?\"undefined\":e(r))&&\"function\"==typeof r[n]&&r[n](\"mark.js: \"+t)}},{key:\"escapeStr\",value:function(e){return e.replace(/[\\-\\[\\]\\/\\{\\}\\(\\)\\*\\+\\?\\.\\\\\\^\\$\\|]/g,\"\\\\$&\")}},{key:\"createRegExp\",value:function(e){return\"disabled\"!==this.opt.wildcards&&(e=this.setupWildcardsRegExp(e)),e=this.escapeStr(e),Object.keys(this.opt.synonyms).length&&(e=this.createSynonymsRegExp(e)),(this.opt.ignoreJoiners||this.opt.ignorePunctuation.length)&&(e=this.setupIgnoreJoinersRegExp(e)),this.opt.diacritics&&(e=this.createDiacriticsRegExp(e)),e=this.createMergedBlanksRegExp(e),(this.opt.ignoreJoiners||this.opt.ignorePunctuation.length)&&(e=this.createJoinersRegExp(e)),\"disabled\"!==this.opt.wildcards&&(e=this.createWildcardsRegExp(e)),this.createAccuracyRegExp(e)}},{key:\"createSynonymsRegExp\",value:function(e){var t=this.opt.synonyms,n=this.opt.caseSensitive?\"\":\"i\",r=this.opt.ignoreJoiners||this.opt.ignorePunctuation.length?\"\\0\":\"\";for(var i in t)if(t.hasOwnProperty(i)){var o=t[i],s=\"disabled\"!==this.opt.wildcards?this.setupWildcardsRegExp(i):this.escapeStr(i),a=\"disabled\"!==this.opt.wildcards?this.setupWildcardsRegExp(o):this.escapeStr(o);\"\"!==s&&\"\"!==a&&(e=e.replace(new RegExp(\"(\"+this.escapeStr(s)+\"|\"+this.escapeStr(a)+\")\",\"gm\"+n),r+\"(\"+this.processSynomyms(s)+\"|\"+this.processSynomyms(a)+\")\"+r))}return e}},{key:\"processSynomyms\",value:function(e){return(this.opt.ignoreJoiners||this.opt.ignorePunctuation.length)&&(e=this.setupIgnoreJoinersRegExp(e)),e}},{key:\"setupWildcardsRegExp\",value:function(e){return(e=e.replace(/(?:\\\\)*\\?/g,(function(e){return\"\\\\\"===e.charAt(0)?\"?\":\"\u0001\"}))).replace(/(?:\\\\)*\\*/g,(function(e){return\"\\\\\"===e.charAt(0)?\"*\":\"\u0002\"}))}},{key:\"createWildcardsRegExp\",value:function(e){var t=\"withSpaces\"===this.opt.wildcards;return e.replace(/\\u0001/g,t?\"[\\\\S\\\\s]?\":\"\\\\S?\").replace(/\\u0002/g,t?\"[\\\\S\\\\s]*?\":\"\\\\S*\")}},{key:\"setupIgnoreJoinersRegExp\",value:function(e){return e.replace(/[^(|)\\\\]/g,(function(e,t,n){var r=n.charAt(t+1);return/[(|)\\\\]/.test(r)||\"\"===r?e:e+\"\\0\"}))}},{key:\"createJoinersRegExp\",value:function(e){var t=[],n=this.opt.ignorePunctuation;return Array.isArray(n)&&n.length&&t.push(this.escapeStr(n.join(\"\"))),this.opt.ignoreJoiners&&t.push(\"\\\\u00ad\\\\u200b\\\\u200c\\\\u200d\"),t.length?e.split(/\\u0000+/).join(\"[\"+t.join(\"\")+\"]*\"):e}},{key:\"createDiacriticsRegExp\",value:function(e){var t=this.opt.caseSensitive?\"\":\"i\",n=this.opt.caseSensitive?[\"aàáảãạăằắẳẵặâầấẩẫậäåāą\",\"AÀÁẢÃẠĂẰẮẲẴẶÂẦẤẨẪẬÄÅĀĄ\",\"cçćč\",\"CÇĆČ\",\"dđď\",\"DĐĎ\",\"eèéẻẽẹêềếểễệëěēę\",\"EÈÉẺẼẸÊỀẾỂỄỆËĚĒĘ\",\"iìíỉĩịîïī\",\"IÌÍỈĨỊÎÏĪ\",\"lł\",\"LŁ\",\"nñňń\",\"NÑŇŃ\",\"oòóỏõọôồốổỗộơởỡớờợöøō\",\"OÒÓỎÕỌÔỒỐỔỖỘƠỞỠỚỜỢÖØŌ\",\"rř\",\"RŘ\",\"sšśșş\",\"SŠŚȘŞ\",\"tťțţ\",\"TŤȚŢ\",\"uùúủũụưừứửữựûüůū\",\"UÙÚỦŨỤƯỪỨỬỮỰÛÜŮŪ\",\"yýỳỷỹỵÿ\",\"YÝỲỶỸỴŸ\",\"zžżź\",\"ZŽŻŹ\"]:[\"aàáảãạăằắẳẵặâầấẩẫậäåāąAÀÁẢÃẠĂẰẮẲẴẶÂẦẤẨẪẬÄÅĀĄ\",\"cçćčCÇĆČ\",\"dđďDĐĎ\",\"eèéẻẽẹêềếểễệëěēęEÈÉẺẼẸÊỀẾỂỄỆËĚĒĘ\",\"iìíỉĩịîïīIÌÍỈĨỊÎÏĪ\",\"lłLŁ\",\"nñňńNÑŇŃ\",\"oòóỏõọôồốổỗộơởỡớờợöøōOÒÓỎÕỌÔỒỐỔỖỘƠỞỠỚỜỢÖØŌ\",\"rřRŘ\",\"sšśșşSŠŚȘŞ\",\"tťțţTŤȚŢ\",\"uùúủũụưừứửữựûüůūUÙÚỦŨỤƯỪỨỬỮỰÛÜŮŪ\",\"yýỳỷỹỵÿYÝỲỶỸỴŸ\",\"zžżźZŽŻŹ\"],r=[];return e.split(\"\").forEach((function(i){n.every((function(n){if(-1!==n.indexOf(i)){if(r.indexOf(n)>-1)return!1;e=e.replace(new RegExp(\"[\"+n+\"]\",\"gm\"+t),\"[\"+n+\"]\"),r.push(n)}return!0}))})),e}},{key:\"createMergedBlanksRegExp\",value:function(e){return e.replace(/[\\s]+/gim,\"[\\\\s]+\")}},{key:\"createAccuracyRegExp\",value:function(e){var t=this,n=this.opt.accuracy,r=\"string\"==typeof n?n:n.value,i=\"string\"==typeof n?[]:n.limiters,o=\"\";switch(i.forEach((function(e){o+=\"|\"+t.escapeStr(e)})),r){case\"partially\":default:return\"()(\"+e+\")\";case\"complementary\":return\"()([^\"+(o=\"\\\\s\"+(o||this.escapeStr(\"!\\\"#$%&'()*+,-./:;<=>?@[\\\\]^_`{|}~¡¿\")))+\"]*\"+e+\"[^\"+o+\"]*)\";case\"exactly\":return\"(^|\\\\s\"+o+\")(\"+e+\")(?=$|\\\\s\"+o+\")\"}}},{key:\"getSeparatedKeywords\",value:function(e){var t=this,n=[];return e.forEach((function(e){t.opt.separateWordSearch?e.split(\" \").forEach((function(e){e.trim()&&-1===n.indexOf(e)&&n.push(e)})):e.trim()&&-1===n.indexOf(e)&&n.push(e)})),{keywords:n.sort((function(e,t){return t.length-e.length})),length:n.length}}},{key:\"isNumeric\",value:function(e){return Number(parseFloat(e))==e}},{key:\"checkRanges\",value:function(e){var t=this;if(!Array.isArray(e)||\"[object Object]\"!==Object.prototype.toString.call(e[0]))return this.log(\"markRanges() will only accept an array of objects\"),this.opt.noMatch(e),[];var n=[],r=0;return e.sort((function(e,t){return e.start-t.start})).forEach((function(e){var i=t.callNoMatchOnInvalidRanges(e,r),o=i.start,s=i.end;i.valid&&(e.start=o,e.length=s-o,n.push(e),r=s)})),n}},{key:\"callNoMatchOnInvalidRanges\",value:function(e,t){var n=void 0,r=void 0,i=!1;return e&&void 0!==e.start?(r=(n=parseInt(e.start,10))+parseInt(e.length,10),this.isNumeric(e.start)&&this.isNumeric(e.length)&&r-t>0&&r-n>0?i=!0:(this.log(\"Ignoring invalid or overlapping range: \"+JSON.stringify(e)),this.opt.noMatch(e))):(this.log(\"Ignoring invalid range: \"+JSON.stringify(e)),this.opt.noMatch(e)),{start:n,end:r,valid:i}}},{key:\"checkWhitespaceRanges\",value:function(e,t,n){var r=void 0,i=!0,o=n.length,s=t-o,a=parseInt(e.start,10)-s;return(r=(a=a>o?o:a)+parseInt(e.length,10))>o&&(r=o,this.log(\"End range automatically set to the max value of \"+o)),a<0||r-a<0||a>o||r>o?(i=!1,this.log(\"Invalid range: \"+JSON.stringify(e)),this.opt.noMatch(e)):\"\"===n.substring(a,r).replace(/\\s+/g,\"\")&&(i=!1,this.log(\"Skipping whitespace only range: \"+JSON.stringify(e)),this.opt.noMatch(e)),{start:a,end:r,valid:i}}},{key:\"getTextNodes\",value:function(e){var t=this,n=\"\",r=[];this.iterator.forEachNode(NodeFilter.SHOW_TEXT,(function(e){r.push({start:n.length,end:(n+=e.textContent).length,node:e})}),(function(e){return t.matchesExclude(e.parentNode)?NodeFilter.FILTER_REJECT:NodeFilter.FILTER_ACCEPT}),(function(){e({value:n,nodes:r})}))}},{key:\"matchesExclude\",value:function(e){return i.matches(e,this.opt.exclude.concat([\"script\",\"style\",\"title\",\"head\",\"html\"]))}},{key:\"wrapRangeInTextNode\",value:function(e,t,n){var r=this.opt.element?this.opt.element:\"mark\",i=e.splitText(t),o=i.splitText(n-t),s=document.createElement(r);return s.setAttribute(\"data-markjs\",\"true\"),this.opt.className&&s.setAttribute(\"class\",this.opt.className),s.textContent=i.textContent,i.parentNode.replaceChild(s,i),o}},{key:\"wrapRangeInMappedTextNode\",value:function(e,t,n,r,i){var o=this;e.nodes.every((function(s,a){var l=e.nodes[a+1];if(void 0===l||l.start>t){if(!r(s.node))return!1;var c=t-s.start,u=(n>s.end?s.end:n)-s.start,p=e.value.substr(0,s.start),d=e.value.substr(u+s.start);if(s.node=o.wrapRangeInTextNode(s.node,c,u),e.value=p+d,e.nodes.forEach((function(t,n){n>=a&&(e.nodes[n].start>0&&n!==a&&(e.nodes[n].start-=u),e.nodes[n].end-=u)})),n-=u,i(s.node.previousSibling,s.start),!(n>s.end))return!1;t=s.end}return!0}))}},{key:\"wrapMatches\",value:function(e,t,n,r,i){var o=this,s=0===t?0:t+1;this.getTextNodes((function(t){t.nodes.forEach((function(t){t=t.node;for(var i=void 0;null!==(i=e.exec(t.textContent))&&\"\"!==i[s];)if(n(i[s],t)){var a=i.index;if(0!==s)for(var l=1;l1&&console.warn(\"Replacing with\",t),m++}}else{let i=u(l(t,e[n]));if(s.verbose>1&&console.warn((!1===i?f.colour.red:f.colour.green)+\"Fragment resolution\",e[n],f.colour.normal),!1===i){if(r.parent[r.pkey]={},s.fatal){let t=new Error(\"Fragment $ref resolution failed \"+e[n]);if(!s.promise)throw t;s.promise.reject(t)}}else m++,r.parent[r.pkey]=i,h[e[n]]=r.path.replace(\"/%24ref\",\"\")}else if(p.protocol){let t=o.resolve(i,e[n]).toString();s.verbose>1&&console.warn(f.colour.yellow+\"Rewriting external url ref\",e[n],\"as\",t,f.colour.normal),e[\"x-miro\"]=e[n],s.externalRefs[e[n]]&&(s.externalRefs[t]||(s.externalRefs[t]=s.externalRefs[e[n]]),s.externalRefs[t].failed=s.externalRefs[e[n]].failed),e[n]=t}else if(!e[\"x-miro\"]){let t=o.resolve(i,e[n]).toString(),r=!1;s.externalRefs[e[n]]&&(r=s.externalRefs[e[n]].failed),r||(s.verbose>1&&console.warn(f.colour.yellow+\"Rewriting external ref\",e[n],\"as\",t,f.colour.normal),e[\"x-miro\"]=e[n],e[n]=t)}}));return c(e,{},(function(e,t,n){d(e,t)&&void 0!==e.$fixed&&delete e.$fixed})),s.verbose>1&&console.warn(\"Finished fragment resolution\"),e}function m(e,t){if(!t.filters||!t.filters.length)return e;for(let n of t.filters)e=n(e,t);return e}function g(e,t,n,s){var c=o.parse(n.source),p=n.source.split(\"\\\\\").join(\"/\").split(\"/\");p.pop()||p.pop();let d=\"\",f=t.split(\"#\");f.length>1&&(d=\"#\"+f[1],t=f[0]),p=p.join(\"/\");let g=(y=o.parse(t).protocol,b=c.protocol,y&&y.length>2?y:b&&b.length>2?b:\"file:\");var y,b;let v;if(v=\"file:\"===g?i.resolve(p?p+\"/\":\"\",t):o.resolve(p?p+\"/\":\"\",t),n.cache[v]){n.verbose&&console.warn(\"CACHED\",v,d);let e=u(n.cache[v]),r=n.externalRef=e;if(d&&(r=l(r,d),!1===r&&(r={},n.fatal))){let e=new Error(\"Cached $ref resolution failed \"+v+d);if(!n.promise)throw e;n.promise.reject(e)}return r=h(r,e,t,d,v,n),r=m(r,n),s(u(r),v,n),Promise.resolve(r)}if(n.verbose&&console.warn(\"GET\",v,d),n.handlers&&n.handlers[g])return n.handlers[g](p,t,d,n).then((function(e){return n.externalRef=e,e=m(e,n),n.cache[v]=e,s(e,v,n),e})).catch((function(e){throw n.verbose&&console.warn(e),e}));if(g&&g.startsWith(\"http\")){const e=Object.assign({},n.fetchOptions,{agent:n.agent});return n.fetch(v,e).then((function(e){if(200!==e.status){if(n.ignoreIOErrors)return n.verbose&&console.warn(\"FAILED\",t),n.externalRefs[t].failed=!0,'{\"$ref\":\"'+t+'\"}';throw new Error(`Received status code ${e.status}: ${v}`)}return e.text()})).then((function(e){try{let r=a.parse(e,{schema:\"core\",prettyErrors:!0});if(e=n.externalRef=r,n.cache[v]=u(e),d&&!1===(e=l(e,d))&&(e={},n.fatal)){let e=new Error(\"Remote $ref resolution failed \"+v+d);if(!n.promise)throw e;n.promise.reject(e)}e=m(e=h(e,r,t,d,v,n),n)}catch(e){if(n.verbose&&console.warn(e),!n.promise||!n.fatal)throw e;n.promise.reject(e)}return s(e,v,n),e})).catch((function(e){if(n.verbose&&console.warn(e),n.cache[v]={},!n.promise||!n.fatal)throw e;n.promise.reject(e)}))}{const e='{\"$ref\":\"'+t+'\"}';return function(e,t,n,i,o){return new Promise((function(s,a){r.readFile(e,t,(function(e,t){e?n.ignoreIOErrors&&o?(n.verbose&&console.warn(\"FAILED\",i),n.externalRefs[i].failed=!0,s(o)):a(e):s(t)}))}))}(v,n.encoding||\"utf8\",n,t,e).then((function(e){try{let r=a.parse(e,{schema:\"core\",prettyErrors:!0});if(e=n.externalRef=r,n.cache[v]=u(e),d&&!1===(e=l(e,d))&&(e={},n.fatal)){let e=new Error(\"File $ref resolution failed \"+v+d);if(!n.promise)throw e;n.promise.reject(e)}e=m(e=h(e,r,t,d,v,n),n)}catch(e){if(n.verbose&&console.warn(e),!n.promise||!n.fatal)throw e;n.promise.reject(e)}return s(e,v,n),e})).catch((function(e){if(n.verbose&&console.warn(e),!n.promise||!n.fatal)throw e;n.promise.reject(e)}))}}function y(e){return new Promise((function(t,n){(function(e){return new Promise((function(t,n){function r(t,n,r){if(t[n]&&d(t[n],\"$ref\")){let o=t[n].$ref;if(!o.startsWith(\"#\")){let s=\"\";if(!i[o]){let t=Object.keys(i).find((function(e,t,n){return o.startsWith(e+\"/\")}));t&&(e.verbose&&console.warn(\"Found potential subschema at\",t),s=\"/\"+(o.split(\"#\")[1]||\"\").replace(t.split(\"#\")[1]||\"\"),s=s.split(\"/undefined\").join(\"\"),o=t)}if(i[o]||(i[o]={resolved:!1,paths:[],extras:{},description:t[n].description}),i[o].resolved)if(i[o].failed);else if(e.rewriteRefs){let r=i[o].resolvedAt;e.verbose>1&&console.warn(\"Rewriting ref\",o,r),t[n][\"x-miro\"]=o,t[n].$ref=r+s}else t[n]=u(i[o].data);else i[o].paths.push(r.path),i[o].extras[r.path]=s}}}let i=e.externalRefs;if(e.resolver.depth>0&&e.source===e.resolver.base)return t(i);c(e.openapi.definitions,{identityDetection:!0,path:\"#/definitions\"},r),c(e.openapi.components,{identityDetection:!0,path:\"#/components\"},r),c(e.openapi,{identityDetection:!0},r),t(i)}))})(e).then((function(t){for(let n in t)if(!t[n].resolved){let r=e.resolver.depth;r>0&&r++,e.resolver.actions[r].push((function(){return g(e.openapi,n,e,(function(e,r,i){if(!t[n].resolved){let o={};o.context=t[n],o.$ref=n,o.original=u(e),o.updated=e,o.source=r,i.externals.push(o),t[n].resolved=!0}let o=Object.assign({},i,{source:\"\",resolver:{actions:i.resolver.actions,depth:i.resolver.actions.length-1,base:i.resolver.base}});i.patch&&t[n].description&&!e.description&&\"object\"==typeof e&&(e.description=t[n].description),t[n].data=e;let s=(a=t[n].paths,[...new Set(a)]);var a;s=s.sort((function(e,t){const n=e.startsWith(\"#/components/\")||e.startsWith(\"#/definitions/\"),r=t.startsWith(\"#/components/\")||t.startsWith(\"#/definitions/\");return n&&!r?-1:r&&!n?1:0}));for(let r of s)if(t[n].resolvedAt&&r!==t[n].resolvedAt&&r.indexOf(\"x-ms-examples/\")<0)i.verbose>1&&console.warn(\"Creating pointer to data at\",r),l(i.openapi,r,{$ref:t[n].resolvedAt+t[n].extras[r],\"x-miro\":n+t[n].extras[r]});else{t[n].resolvedAt?i.verbose>1&&console.warn(\"Avoiding circular reference\"):(t[n].resolvedAt=r,i.verbose>1&&console.warn(\"Creating initial clone of data at\",r));let o=u(e);l(i.openapi,r,o)}0===i.resolver.actions[o.resolver.depth].length&&i.resolver.actions[o.resolver.depth].push((function(){return y(o)}))}))}))}})).catch((function(t){e.verbose&&console.warn(t),n(t)}));let r={options:e};r.actions=e.resolver.actions[e.resolver.depth],t(r)}))}function b(e,t,n){e.resolver.actions.push([]),y(e).then((function(r){var i;(i=r.actions,i.reduce(((e,t)=>e.then((e=>t().then(Array.prototype.concat.bind(e))))),Promise.resolve([]))).then((function(){if(e.resolver.depth>=e.resolver.actions.length)return console.warn(\"Ran off the end of resolver actions\"),t(!0);e.resolver.depth++,e.resolver.actions[e.resolver.depth].length?setTimeout((function(){b(r.options,t,n)}),0):(e.verbose>1&&console.warn(f.colour.yellow+\"Finished external resolution!\",f.colour.normal),e.resolveInternal&&(e.verbose>1&&console.warn(f.colour.yellow+\"Starting internal resolution!\",f.colour.normal),e.openapi=p(e.openapi,e.original,{verbose:e.verbose-1}),e.verbose>1&&console.warn(f.colour.yellow+\"Finished internal resolution!\",f.colour.normal)),c(e.openapi,{},(function(t,n,r){d(t,n)&&(e.preserveMiro||delete t[\"x-miro\"])})),t(e))})).catch((function(t){e.verbose&&console.warn(t),n(t)}))})).catch((function(t){e.verbose&&console.warn(t),n(t)}))}function v(e){if(e.cache||(e.cache={}),e.fetch||(e.fetch=s),e.source){let t=o.parse(e.source);(!t.protocol||t.protocol.length<=2)&&(e.source=i.resolve(e.source))}e.externals=[],e.externalRefs={},e.rewriteRefs=!0,e.resolver={},e.resolver.depth=0,e.resolver.base=e.source,e.resolver.actions=[[]]}e.exports={optionalResolve:function(e){return v(e),new Promise((function(t,n){e.resolve?b(e,t,n):t(e)}))},resolve:function(e,t,n){return n||(n={}),n.openapi=e,n.source=t,n.resolve=!0,v(n),new Promise((function(e,t){b(n,e,t)}))}}},1319:function(e){\"use strict\";function t(){return{depth:0,seen:new WeakMap,top:!0,combine:!1,allowRefSiblings:!1}}e.exports={getDefaultState:t,walkSchema:function e(n,r,i,o){if(void 0===i.depth&&(i=t()),null==n)return n;if(void 0!==n.$ref){let e={$ref:n.$ref};return i.allowRefSiblings&&n.description&&(e.description=n.description),o(e,r,i),e}if(i.combine&&(n.allOf&&Array.isArray(n.allOf)&&1===n.allOf.length&&delete(n=Object.assign({},n.allOf[0],n)).allOf,n.anyOf&&Array.isArray(n.anyOf)&&1===n.anyOf.length&&delete(n=Object.assign({},n.anyOf[0],n)).anyOf,n.oneOf&&Array.isArray(n.oneOf)&&1===n.oneOf.length&&delete(n=Object.assign({},n.oneOf[0],n)).oneOf),o(n,r,i),i.seen.has(n))return n;if(\"object\"==typeof n&&null!==n&&i.seen.set(n,!0),i.top=!1,i.depth++,void 0!==n.items&&(i.property=\"items\",e(n.items,n,i,o)),n.additionalItems&&\"object\"==typeof n.additionalItems&&(i.property=\"additionalItems\",e(n.additionalItems,n,i,o)),n.additionalProperties&&\"object\"==typeof n.additionalProperties&&(i.property=\"additionalProperties\",e(n.additionalProperties,n,i,o)),n.properties)for(let t in n.properties){let r=n.properties[t];i.property=\"properties/\"+t,e(r,n,i,o)}if(n.patternProperties)for(let t in n.patternProperties){let r=n.patternProperties[t];i.property=\"patternProperties/\"+t,e(r,n,i,o)}if(n.allOf)for(let t in n.allOf){let r=n.allOf[t];i.property=\"allOf/\"+t,e(r,n,i,o)}if(n.anyOf)for(let t in n.anyOf){let r=n.anyOf[t];i.property=\"anyOf/\"+t,e(r,n,i,o)}if(n.oneOf)for(let t in n.oneOf){let r=n.oneOf[t];i.property=\"oneOf/\"+t,e(r,n,i,o)}return n.not&&(i.property=\"not\",e(n.not,n,i,o)),i.depth--,n}}},7975:function(e){\"use strict\";function t(e){if(\"string\"!=typeof e)throw new TypeError(\"Path must be a string. Received \"+JSON.stringify(e))}function n(e,t){for(var n,r=\"\",i=0,o=-1,s=0,a=0;a<=e.length;++a){if(a2){var l=r.lastIndexOf(\"/\");if(l!==r.length-1){-1===l?(r=\"\",i=0):i=(r=r.slice(0,l)).length-1-r.lastIndexOf(\"/\"),o=a,s=0;continue}}else if(2===r.length||1===r.length){r=\"\",i=0,o=a,s=0;continue}t&&(r.length>0?r+=\"/..\":r=\"..\",i=2)}else r.length>0?r+=\"/\"+e.slice(o+1,a):r=e.slice(o+1,a),i=a-o-1;o=a,s=0}else 46===n&&-1!==s?++s:s=-1}return r}var r={resolve:function(){for(var e,r=\"\",i=!1,o=arguments.length-1;o>=-1&&!i;o--){var s;o>=0?s=arguments[o]:(void 0===e&&(e=process.cwd()),s=e),t(s),0!==s.length&&(r=s+\"/\"+r,i=47===s.charCodeAt(0))}return r=n(r,!i),i?r.length>0?\"/\"+r:\"/\":r.length>0?r:\".\"},normalize:function(e){if(t(e),0===e.length)return\".\";var r=47===e.charCodeAt(0),i=47===e.charCodeAt(e.length-1);return 0!==(e=n(e,!r)).length||r||(e=\".\"),e.length>0&&i&&(e+=\"/\"),r?\"/\"+e:e},isAbsolute:function(e){return t(e),e.length>0&&47===e.charCodeAt(0)},join:function(){if(0===arguments.length)return\".\";for(var e,n=0;n0&&(void 0===e?e=i:e+=\"/\"+i)}return void 0===e?\".\":r.normalize(e)},relative:function(e,n){if(t(e),t(n),e===n)return\"\";if((e=r.resolve(e))===(n=r.resolve(n)))return\"\";for(var i=1;ic){if(47===n.charCodeAt(a+p))return n.slice(a+p+1);if(0===p)return n.slice(a+p)}else s>c&&(47===e.charCodeAt(i+p)?u=p:0===p&&(u=0));break}var d=e.charCodeAt(i+p);if(d!==n.charCodeAt(a+p))break;47===d&&(u=p)}var f=\"\";for(p=i+u+1;p<=o;++p)p!==o&&47!==e.charCodeAt(p)||(0===f.length?f+=\"..\":f+=\"/..\");return f.length>0?f+n.slice(a+u):(a+=u,47===n.charCodeAt(a)&&++a,n.slice(a))},_makeLong:function(e){return e},dirname:function(e){if(t(e),0===e.length)return\".\";for(var n=e.charCodeAt(0),r=47===n,i=-1,o=!0,s=e.length-1;s>=1;--s)if(47===(n=e.charCodeAt(s))){if(!o){i=s;break}}else o=!1;return-1===i?r?\"/\":\".\":r&&1===i?\"//\":e.slice(0,i)},basename:function(e,n){if(void 0!==n&&\"string\"!=typeof n)throw new TypeError('\"ext\" argument must be a string');t(e);var r,i=0,o=-1,s=!0;if(void 0!==n&&n.length>0&&n.length<=e.length){if(n.length===e.length&&n===e)return\"\";var a=n.length-1,l=-1;for(r=e.length-1;r>=0;--r){var c=e.charCodeAt(r);if(47===c){if(!s){i=r+1;break}}else-1===l&&(s=!1,l=r+1),a>=0&&(c===n.charCodeAt(a)?-1==--a&&(o=r):(a=-1,o=l))}return i===o?o=l:-1===o&&(o=e.length),e.slice(i,o)}for(r=e.length-1;r>=0;--r)if(47===e.charCodeAt(r)){if(!s){i=r+1;break}}else-1===o&&(s=!1,o=r+1);return-1===o?\"\":e.slice(i,o)},extname:function(e){t(e);for(var n=-1,r=0,i=-1,o=!0,s=0,a=e.length-1;a>=0;--a){var l=e.charCodeAt(a);if(47!==l)-1===i&&(o=!1,i=a+1),46===l?-1===n?n=a:1!==s&&(s=1):-1!==n&&(s=-1);else if(!o){r=a+1;break}}return-1===n||-1===i||0===s||1===s&&n===i-1&&n===r+1?\"\":e.slice(n,i)},format:function(e){if(null===e||\"object\"!=typeof e)throw new TypeError('The \"pathObject\" argument must be of type Object. Received type '+typeof e);return function(e,t){var n=t.dir||t.root,r=t.base||(t.name||\"\")+(t.ext||\"\");return n?n===t.root?n+r:n+\"/\"+r:r}(0,e)},parse:function(e){t(e);var n={root:\"\",dir:\"\",base:\"\",ext:\"\",name:\"\"};if(0===e.length)return n;var r,i=e.charCodeAt(0),o=47===i;o?(n.root=\"/\",r=1):r=0;for(var s=-1,a=0,l=-1,c=!0,u=e.length-1,p=0;u>=r;--u)if(47!==(i=e.charCodeAt(u)))-1===l&&(c=!1,l=u+1),46===i?-1===s?s=u:1!==p&&(p=1):-1!==s&&(p=-1);else if(!c){a=u+1;break}return-1===s||-1===l||0===p||1===p&&s===l-1&&s===a+1?-1!==l&&(n.base=n.name=0===a&&o?e.slice(1,l):e.slice(a,l)):(0===a&&o?(n.name=e.slice(1,s),n.base=e.slice(1,l)):(n.name=e.slice(a,s),n.base=e.slice(a,l)),n.ext=e.slice(s,l)),a>0?n.dir=e.slice(0,a-1):o&&(n.dir=\"/\"),n},sep:\"/\",delimiter:\":\",win32:null,posix:null};r.posix=r,e.exports=r},5127:function(e){e.exports=function(){var e=[],t=[],n={},r={},i={};function o(e){return\"string\"==typeof e?new RegExp(\"^\"+e+\"$\",\"i\"):e}function s(e,t){return e===t?t:e===e.toLowerCase()?t.toLowerCase():e===e.toUpperCase()?t.toUpperCase():e[0]===e[0].toUpperCase()?t.charAt(0).toUpperCase()+t.substr(1).toLowerCase():t.toLowerCase()}function a(e,t){return e.replace(t[0],(function(n,r){var i,o,a=(i=t[1],o=arguments,i.replace(/\\$(\\d{1,2})/g,(function(e,t){return o[t]||\"\"})));return s(\"\"===n?e[r-1]:n,a)}))}function l(e,t,r){if(!e.length||n.hasOwnProperty(e))return t;for(var i=r.length;i--;){var o=r[i];if(o[0].test(t))return a(t,o)}return t}function c(e,t,n){return function(r){var i=r.toLowerCase();return t.hasOwnProperty(i)?s(r,i):e.hasOwnProperty(i)?s(r,e[i]):l(i,r,n)}}function u(e,t,n,r){return function(r){var i=r.toLowerCase();return!!t.hasOwnProperty(i)||!e.hasOwnProperty(i)&&l(i,i,n)===i}}function p(e,t,n){return(n?t+\" \":\"\")+(1===t?p.singular(e):p.plural(e))}return p.plural=c(i,r,e),p.isPlural=u(i,r,e),p.singular=c(r,i,t),p.isSingular=u(r,i,t),p.addPluralRule=function(t,n){e.push([o(t),n])},p.addSingularRule=function(e,n){t.push([o(e),n])},p.addUncountableRule=function(e){\"string\"!=typeof e?(p.addPluralRule(e,\"$0\"),p.addSingularRule(e,\"$0\")):n[e.toLowerCase()]=!0},p.addIrregularRule=function(e,t){t=t.toLowerCase(),e=e.toLowerCase(),i[e]=t,r[t]=e},[[\"I\",\"we\"],[\"me\",\"us\"],[\"he\",\"they\"],[\"she\",\"they\"],[\"them\",\"them\"],[\"myself\",\"ourselves\"],[\"yourself\",\"yourselves\"],[\"itself\",\"themselves\"],[\"herself\",\"themselves\"],[\"himself\",\"themselves\"],[\"themself\",\"themselves\"],[\"is\",\"are\"],[\"was\",\"were\"],[\"has\",\"have\"],[\"this\",\"these\"],[\"that\",\"those\"],[\"echo\",\"echoes\"],[\"dingo\",\"dingoes\"],[\"volcano\",\"volcanoes\"],[\"tornado\",\"tornadoes\"],[\"torpedo\",\"torpedoes\"],[\"genus\",\"genera\"],[\"viscus\",\"viscera\"],[\"stigma\",\"stigmata\"],[\"stoma\",\"stomata\"],[\"dogma\",\"dogmata\"],[\"lemma\",\"lemmata\"],[\"schema\",\"schemata\"],[\"anathema\",\"anathemata\"],[\"ox\",\"oxen\"],[\"axe\",\"axes\"],[\"die\",\"dice\"],[\"yes\",\"yeses\"],[\"foot\",\"feet\"],[\"eave\",\"eaves\"],[\"goose\",\"geese\"],[\"tooth\",\"teeth\"],[\"quiz\",\"quizzes\"],[\"human\",\"humans\"],[\"proof\",\"proofs\"],[\"carve\",\"carves\"],[\"valve\",\"valves\"],[\"looey\",\"looies\"],[\"thief\",\"thieves\"],[\"groove\",\"grooves\"],[\"pickaxe\",\"pickaxes\"],[\"passerby\",\"passersby\"]].forEach((function(e){return p.addIrregularRule(e[0],e[1])})),[[/s?$/i,\"s\"],[/[^\\u0000-\\u007F]$/i,\"$0\"],[/([^aeiou]ese)$/i,\"$1\"],[/(ax|test)is$/i,\"$1es\"],[/(alias|[^aou]us|t[lm]as|gas|ris)$/i,\"$1es\"],[/(e[mn]u)s?$/i,\"$1s\"],[/([^l]ias|[aeiou]las|[ejzr]as|[iu]am)$/i,\"$1\"],[/(alumn|syllab|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i,\"$1i\"],[/(alumn|alg|vertebr)(?:a|ae)$/i,\"$1ae\"],[/(seraph|cherub)(?:im)?$/i,\"$1im\"],[/(her|at|gr)o$/i,\"$1oes\"],[/(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|automat|quor)(?:a|um)$/i,\"$1a\"],[/(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)(?:a|on)$/i,\"$1a\"],[/sis$/i,\"ses\"],[/(?:(kni|wi|li)fe|(ar|l|ea|eo|oa|hoo)f)$/i,\"$1$2ves\"],[/([^aeiouy]|qu)y$/i,\"$1ies\"],[/([^ch][ieo][ln])ey$/i,\"$1ies\"],[/(x|ch|ss|sh|zz)$/i,\"$1es\"],[/(matr|cod|mur|sil|vert|ind|append)(?:ix|ex)$/i,\"$1ices\"],[/\\b((?:tit)?m|l)(?:ice|ouse)$/i,\"$1ice\"],[/(pe)(?:rson|ople)$/i,\"$1ople\"],[/(child)(?:ren)?$/i,\"$1ren\"],[/eaux$/i,\"$0\"],[/m[ae]n$/i,\"men\"],[\"thou\",\"you\"]].forEach((function(e){return p.addPluralRule(e[0],e[1])})),[[/s$/i,\"\"],[/(ss)$/i,\"$1\"],[/(wi|kni|(?:after|half|high|low|mid|non|night|[^\\w]|^)li)ves$/i,\"$1fe\"],[/(ar|(?:wo|[ae])l|[eo][ao])ves$/i,\"$1f\"],[/ies$/i,\"y\"],[/\\b([pl]|zomb|(?:neck|cross)?t|coll|faer|food|gen|goon|group|lass|talk|goal|cut)ies$/i,\"$1ie\"],[/\\b(mon|smil)ies$/i,\"$1ey\"],[/\\b((?:tit)?m|l)ice$/i,\"$1ouse\"],[/(seraph|cherub)im$/i,\"$1\"],[/(x|ch|ss|sh|zz|tto|go|cho|alias|[^aou]us|t[lm]as|gas|(?:her|at|gr)o|[aeiou]ris)(?:es)?$/i,\"$1\"],[/(analy|diagno|parenthe|progno|synop|the|empha|cri|ne)(?:sis|ses)$/i,\"$1sis\"],[/(movie|twelve|abuse|e[mn]u)s$/i,\"$1\"],[/(test)(?:is|es)$/i,\"$1is\"],[/(alumn|syllab|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i,\"$1us\"],[/(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|quor)a$/i,\"$1um\"],[/(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)a$/i,\"$1on\"],[/(alumn|alg|vertebr)ae$/i,\"$1a\"],[/(cod|mur|sil|vert|ind)ices$/i,\"$1ex\"],[/(matr|append)ices$/i,\"$1ix\"],[/(pe)(rson|ople)$/i,\"$1rson\"],[/(child)ren$/i,\"$1\"],[/(eau)x?$/i,\"$1\"],[/men$/i,\"man\"]].forEach((function(e){return p.addSingularRule(e[0],e[1])})),[\"adulthood\",\"advice\",\"agenda\",\"aid\",\"aircraft\",\"alcohol\",\"ammo\",\"analytics\",\"anime\",\"athletics\",\"audio\",\"bison\",\"blood\",\"bream\",\"buffalo\",\"butter\",\"carp\",\"cash\",\"chassis\",\"chess\",\"clothing\",\"cod\",\"commerce\",\"cooperation\",\"corps\",\"debris\",\"diabetes\",\"digestion\",\"elk\",\"energy\",\"equipment\",\"excretion\",\"expertise\",\"firmware\",\"flounder\",\"fun\",\"gallows\",\"garbage\",\"graffiti\",\"hardware\",\"headquarters\",\"health\",\"herpes\",\"highjinks\",\"homework\",\"housework\",\"information\",\"jeans\",\"justice\",\"kudos\",\"labour\",\"literature\",\"machinery\",\"mackerel\",\"mail\",\"media\",\"mews\",\"moose\",\"music\",\"mud\",\"manga\",\"news\",\"only\",\"personnel\",\"pike\",\"plankton\",\"pliers\",\"police\",\"pollution\",\"premises\",\"rain\",\"research\",\"rice\",\"salmon\",\"scissors\",\"series\",\"sewage\",\"shambles\",\"shrimp\",\"software\",\"species\",\"staff\",\"swine\",\"tennis\",\"traffic\",\"transportation\",\"trout\",\"tuna\",\"wealth\",\"welfare\",\"whiting\",\"wildebeest\",\"wildlife\",\"you\",/pok[eé]mon$/i,/[^aeiou]ese$/i,/deer$/i,/fish$/i,/measles$/i,/o[iu]s$/i,/pox$/i,/sheep$/i].forEach(p.addUncountableRule),p}()},7022:function(){!function(e){var t=\"\\\\b(?:BASH|BASHOPTS|BASH_ALIASES|BASH_ARGC|BASH_ARGV|BASH_CMDS|BASH_COMPLETION_COMPAT_DIR|BASH_LINENO|BASH_REMATCH|BASH_SOURCE|BASH_VERSINFO|BASH_VERSION|COLORTERM|COLUMNS|COMP_WORDBREAKS|DBUS_SESSION_BUS_ADDRESS|DEFAULTS_PATH|DESKTOP_SESSION|DIRSTACK|DISPLAY|EUID|GDMSESSION|GDM_LANG|GNOME_KEYRING_CONTROL|GNOME_KEYRING_PID|GPG_AGENT_INFO|GROUPS|HISTCONTROL|HISTFILE|HISTFILESIZE|HISTSIZE|HOME|HOSTNAME|HOSTTYPE|IFS|INSTANCE|JOB|LANG|LANGUAGE|LC_ADDRESS|LC_ALL|LC_IDENTIFICATION|LC_MEASUREMENT|LC_MONETARY|LC_NAME|LC_NUMERIC|LC_PAPER|LC_TELEPHONE|LC_TIME|LESSCLOSE|LESSOPEN|LINES|LOGNAME|LS_COLORS|MACHTYPE|MAILCHECK|MANDATORY_PATH|NO_AT_BRIDGE|OLDPWD|OPTERR|OPTIND|ORBIT_SOCKETDIR|OSTYPE|PAPERSIZE|PATH|PIPESTATUS|PPID|PS1|PS2|PS3|PS4|PWD|RANDOM|REPLY|SECONDS|SELINUX_INIT|SESSION|SESSIONTYPE|SESSION_MANAGER|SHELL|SHELLOPTS|SHLVL|SSH_AUTH_SOCK|TERM|UID|UPSTART_EVENTS|UPSTART_INSTANCE|UPSTART_JOB|UPSTART_SESSION|USER|WINDOWID|XAUTHORITY|XDG_CONFIG_DIRS|XDG_CURRENT_DESKTOP|XDG_DATA_DIRS|XDG_GREETER_DATA_DIR|XDG_MENU_PREFIX|XDG_RUNTIME_DIR|XDG_SEAT|XDG_SEAT_PATH|XDG_SESSION_DESKTOP|XDG_SESSION_ID|XDG_SESSION_PATH|XDG_SESSION_TYPE|XDG_VTNR|XMODIFIERS)\\\\b\",n={pattern:/(^([\"']?)\\w+\\2)[ \\t]+\\S.*/,lookbehind:!0,alias:\"punctuation\",inside:null},r={bash:n,environment:{pattern:RegExp(\"\\\\$\"+t),alias:\"constant\"},variable:[{pattern:/\\$?\\(\\([\\s\\S]+?\\)\\)/,greedy:!0,inside:{variable:[{pattern:/(^\\$\\(\\([\\s\\S]+)\\)\\)/,lookbehind:!0},/^\\$\\(\\(/],number:/\\b0x[\\dA-Fa-f]+\\b|(?:\\b\\d+(?:\\.\\d*)?|\\B\\.\\d+)(?:[Ee]-?\\d+)?/,operator:/--|\\+\\+|\\*\\*=?|<<=?|>>=?|&&|\\|\\||[=!+\\-*/%<>^&|]=?|[?~:]/,punctuation:/\\(\\(?|\\)\\)?|,|;/}},{pattern:/\\$\\((?:\\([^)]+\\)|[^()])+\\)|`[^`]+`/,greedy:!0,inside:{variable:/^\\$\\(|^`|\\)$|`$/}},{pattern:/\\$\\{[^}]+\\}/,greedy:!0,inside:{operator:/:[-=?+]?|[!\\/]|##?|%%?|\\^\\^?|,,?/,punctuation:/[\\[\\]]/,environment:{pattern:RegExp(\"(\\\\{)\"+t),lookbehind:!0,alias:\"constant\"}}},/\\$(?:\\w+|[#?*!@$])/],entity:/\\\\(?:[abceEfnrtv\\\\\"]|O?[0-7]{1,3}|U[0-9a-fA-F]{8}|u[0-9a-fA-F]{4}|x[0-9a-fA-F]{1,2})/};e.languages.bash={shebang:{pattern:/^#!\\s*\\/.*/,alias:\"important\"},comment:{pattern:/(^|[^\"{\\\\$])#.*/,lookbehind:!0},\"function-name\":[{pattern:/(\\bfunction\\s+)[\\w-]+(?=(?:\\s*\\(?:\\s*\\))?\\s*\\{)/,lookbehind:!0,alias:\"function\"},{pattern:/\\b[\\w-]+(?=\\s*\\(\\s*\\)\\s*\\{)/,alias:\"function\"}],\"for-or-select\":{pattern:/(\\b(?:for|select)\\s+)\\w+(?=\\s+in\\s)/,alias:\"variable\",lookbehind:!0},\"assign-left\":{pattern:/(^|[\\s;|&]|[<>]\\()\\w+(?:\\.\\w+)*(?=\\+?=)/,inside:{environment:{pattern:RegExp(\"(^|[\\\\s;|&]|[<>]\\\\()\"+t),lookbehind:!0,alias:\"constant\"}},alias:\"variable\",lookbehind:!0},parameter:{pattern:/(^|\\s)-{1,2}(?:\\w+:[+-]?)?\\w+(?:\\.\\w+)*(?=[=\\s]|$)/,alias:\"variable\",lookbehind:!0},string:[{pattern:/((?:^|[^<])<<-?\\s*)(\\w+)\\s[\\s\\S]*?(?:\\r?\\n|\\r)\\2/,lookbehind:!0,greedy:!0,inside:r},{pattern:/((?:^|[^<])<<-?\\s*)([\"'])(\\w+)\\2\\s[\\s\\S]*?(?:\\r?\\n|\\r)\\3/,lookbehind:!0,greedy:!0,inside:{bash:n}},{pattern:/(^|[^\\\\](?:\\\\\\\\)*)\"(?:\\\\[\\s\\S]|\\$\\([^)]+\\)|\\$(?!\\()|`[^`]+`|[^\"\\\\`$])*\"/,lookbehind:!0,greedy:!0,inside:r},{pattern:/(^|[^$\\\\])'[^']*'/,lookbehind:!0,greedy:!0},{pattern:/\\$'(?:[^'\\\\]|\\\\[\\s\\S])*'/,greedy:!0,inside:{entity:r.entity}}],environment:{pattern:RegExp(\"\\\\$?\"+t),alias:\"constant\"},variable:r.variable,function:{pattern:/(^|[\\s;|&]|[<>]\\()(?:add|apropos|apt|apt-cache|apt-get|aptitude|aspell|automysqlbackup|awk|basename|bash|bc|bconsole|bg|bzip2|cal|cargo|cat|cfdisk|chgrp|chkconfig|chmod|chown|chroot|cksum|clear|cmp|column|comm|composer|cp|cron|crontab|csplit|curl|cut|date|dc|dd|ddrescue|debootstrap|df|diff|diff3|dig|dir|dircolors|dirname|dirs|dmesg|docker|docker-compose|du|egrep|eject|env|ethtool|expand|expect|expr|fdformat|fdisk|fg|fgrep|file|find|fmt|fold|format|free|fsck|ftp|fuser|gawk|git|gparted|grep|groupadd|groupdel|groupmod|groups|grub-mkconfig|gzip|halt|head|hg|history|host|hostname|htop|iconv|id|ifconfig|ifdown|ifup|import|install|ip|java|jobs|join|kill|killall|less|link|ln|locate|logname|logrotate|look|lpc|lpr|lprint|lprintd|lprintq|lprm|ls|lsof|lynx|make|man|mc|mdadm|mkconfig|mkdir|mke2fs|mkfifo|mkfs|mkisofs|mknod|mkswap|mmv|more|most|mount|mtools|mtr|mutt|mv|nano|nc|netstat|nice|nl|node|nohup|notify-send|npm|nslookup|op|open|parted|passwd|paste|pathchk|ping|pkill|pnpm|podman|podman-compose|popd|pr|printcap|printenv|ps|pushd|pv|quota|quotacheck|quotactl|ram|rar|rcp|reboot|remsync|rename|renice|rev|rm|rmdir|rpm|rsync|scp|screen|sdiff|sed|sendmail|seq|service|sftp|sh|shellcheck|shuf|shutdown|sleep|slocate|sort|split|ssh|stat|strace|su|sudo|sum|suspend|swapon|sync|sysctl|tac|tail|tar|tee|time|timeout|top|touch|tr|traceroute|tsort|tty|umount|uname|unexpand|uniq|units|unrar|unshar|unzip|update-grub|uptime|useradd|userdel|usermod|users|uudecode|uuencode|v|vcpkg|vdir|vi|vim|virsh|vmstat|wait|watch|wc|wget|whereis|which|who|whoami|write|xargs|xdg-open|yarn|yes|zenity|zip|zsh|zypper)(?=$|[)\\s;|&])/,lookbehind:!0},keyword:{pattern:/(^|[\\s;|&]|[<>]\\()(?:case|do|done|elif|else|esac|fi|for|function|if|in|select|then|until|while)(?=$|[)\\s;|&])/,lookbehind:!0},builtin:{pattern:/(^|[\\s;|&]|[<>]\\()(?:\\.|:|alias|bind|break|builtin|caller|cd|command|continue|declare|echo|enable|eval|exec|exit|export|getopts|hash|help|let|local|logout|mapfile|printf|pwd|read|readarray|readonly|return|set|shift|shopt|source|test|times|trap|type|typeset|ulimit|umask|unalias|unset)(?=$|[)\\s;|&])/,lookbehind:!0,alias:\"class-name\"},boolean:{pattern:/(^|[\\s;|&]|[<>]\\()(?:false|true)(?=$|[)\\s;|&])/,lookbehind:!0},\"file-descriptor\":{pattern:/\\B&\\d\\b/,alias:\"important\"},operator:{pattern:/\\d?<>|>\\||\\+=|=[=~]?|!=?|<<[<-]?|[&\\d]?>>|\\d[<>]&?|[<>][&=]?|&[>&]?|\\|[&|]?/,inside:{\"file-descriptor\":{pattern:/^\\d/,alias:\"important\"}}},punctuation:/\\$?\\(\\(?|\\)\\)?|\\.\\.|[{}[\\];\\\\]/,number:{pattern:/(^|\\s)(?:[1-9]\\d*|0)(?:[.,]\\d+)?\\b/,lookbehind:!0}},n.inside=e.languages.bash;for(var i=[\"comment\",\"function-name\",\"for-or-select\",\"assign-left\",\"parameter\",\"string\",\"environment\",\"function\",\"keyword\",\"builtin\",\"boolean\",\"file-descriptor\",\"operator\",\"punctuation\",\"number\"],o=r.variable[1].inside,s=0;s>=?|<<=?|->|([-+&|:])\\1|[?:~]|[-+*/%&|^!=<>]=?/}),Prism.languages.insertBefore(\"c\",\"string\",{char:{pattern:/'(?:\\\\(?:\\r\\n|[\\s\\S])|[^'\\\\\\r\\n]){0,32}'/,greedy:!0}}),Prism.languages.insertBefore(\"c\",\"string\",{macro:{pattern:/(^[\\t ]*)#\\s*[a-z](?:[^\\r\\n\\\\/]|\\/(?!\\*)|\\/\\*(?:[^*]|\\*(?!\\/))*\\*\\/|\\\\(?:\\r\\n|[\\s\\S]))*/im,lookbehind:!0,greedy:!0,alias:\"property\",inside:{string:[{pattern:/^(#\\s*include\\s*)<[^>]+>/,lookbehind:!0},Prism.languages.c.string],char:Prism.languages.c.char,comment:Prism.languages.c.comment,\"macro-name\":[{pattern:/(^#\\s*define\\s+)\\w+\\b(?!\\()/i,lookbehind:!0},{pattern:/(^#\\s*define\\s+)\\w+\\b(?=\\()/i,lookbehind:!0,alias:\"function\"}],directive:{pattern:/^(#\\s*)[a-z]+/,lookbehind:!0,alias:\"keyword\"},\"directive-hash\":/^#/,punctuation:/##|\\\\(?=[\\r\\n])/,expression:{pattern:/\\S[\\s\\S]*/,inside:Prism.languages.c}}}}),Prism.languages.insertBefore(\"c\",\"function\",{constant:/\\b(?:EOF|NULL|SEEK_CUR|SEEK_END|SEEK_SET|__DATE__|__FILE__|__LINE__|__TIMESTAMP__|__TIME__|__func__|stderr|stdin|stdout)\\b/}),delete Prism.languages.c.boolean},5624:function(){Prism.languages.clike={comment:[{pattern:/(^|[^\\\\])\\/\\*[\\s\\S]*?(?:\\*\\/|$)/,lookbehind:!0,greedy:!0},{pattern:/(^|[^\\\\:])\\/\\/.*/,lookbehind:!0,greedy:!0}],string:{pattern:/([\"'])(?:\\\\(?:\\r\\n|[\\s\\S])|(?!\\1)[^\\\\\\r\\n])*\\1/,greedy:!0},\"class-name\":{pattern:/(\\b(?:class|extends|implements|instanceof|interface|new|trait)\\s+|\\bcatch\\s+\\()[\\w.\\\\]+/i,lookbehind:!0,inside:{punctuation:/[.\\\\]/}},keyword:/\\b(?:break|catch|continue|do|else|finally|for|function|if|in|instanceof|new|null|return|throw|try|while)\\b/,boolean:/\\b(?:false|true)\\b/,function:/\\b\\w+(?=\\()/,number:/\\b0x[\\da-f]+\\b|(?:\\b\\d+(?:\\.\\d*)?|\\B\\.\\d+)(?:e[+-]?\\d+)?/i,operator:/[<>]=?|[!=]=?=?|--?|\\+\\+?|&&?|\\|\\|?|[?*/~^%]/,punctuation:/[{}[\\];(),.:]/}},4511:function(){!function(e){var t=/#(?!\\{).+/,n={pattern:/#\\{[^}]+\\}/,alias:\"variable\"};e.languages.coffeescript=e.languages.extend(\"javascript\",{comment:t,string:[{pattern:/'(?:\\\\[\\s\\S]|[^\\\\'])*'/,greedy:!0},{pattern:/\"(?:\\\\[\\s\\S]|[^\\\\\"])*\"/,greedy:!0,inside:{interpolation:n}}],keyword:/\\b(?:and|break|by|catch|class|continue|debugger|delete|do|each|else|extend|extends|false|finally|for|if|in|instanceof|is|isnt|let|loop|namespace|new|no|not|null|of|off|on|or|own|return|super|switch|then|this|throw|true|try|typeof|undefined|unless|until|when|while|window|with|yes|yield)\\b/,\"class-member\":{pattern:/@(?!\\d)\\w+/,alias:\"variable\"}}),e.languages.insertBefore(\"coffeescript\",\"comment\",{\"multiline-comment\":{pattern:/###[\\s\\S]+?###/,alias:\"comment\"},\"block-regex\":{pattern:/\\/{3}[\\s\\S]*?\\/{3}/,alias:\"regex\",inside:{comment:t,interpolation:n}}}),e.languages.insertBefore(\"coffeescript\",\"string\",{\"inline-javascript\":{pattern:/`(?:\\\\[\\s\\S]|[^\\\\`])*`/,inside:{delimiter:{pattern:/^`|`$/,alias:\"punctuation\"},script:{pattern:/[\\s\\S]+/,alias:\"language-javascript\",inside:e.languages.javascript}}},\"multiline-string\":[{pattern:/'''[\\s\\S]*?'''/,greedy:!0,alias:\"string\"},{pattern:/\"\"\"[\\s\\S]*?\"\"\"/,greedy:!0,alias:\"string\",inside:{interpolation:n}}]}),e.languages.insertBefore(\"coffeescript\",\"keyword\",{property:/(?!\\d)\\w+(?=\\s*:(?!:))/}),delete e.languages.coffeescript[\"template-string\"],e.languages.coffee=e.languages.coffeescript}(Prism)},2415:function(){!function(e){var t=/\\b(?:alignas|alignof|asm|auto|bool|break|case|catch|char|char16_t|char32_t|char8_t|class|co_await|co_return|co_yield|compl|concept|const|const_cast|consteval|constexpr|constinit|continue|decltype|default|delete|do|double|dynamic_cast|else|enum|explicit|export|extern|final|float|for|friend|goto|if|import|inline|int|int16_t|int32_t|int64_t|int8_t|long|module|mutable|namespace|new|noexcept|nullptr|operator|override|private|protected|public|register|reinterpret_cast|requires|return|short|signed|sizeof|static|static_assert|static_cast|struct|switch|template|this|thread_local|throw|try|typedef|typeid|typename|uint16_t|uint32_t|uint64_t|uint8_t|union|unsigned|using|virtual|void|volatile|wchar_t|while)\\b/,n=/\\b(?!)\\w+(?:\\s*\\.\\s*\\w+)*\\b/.source.replace(//g,(function(){return t.source}));e.languages.cpp=e.languages.extend(\"c\",{\"class-name\":[{pattern:RegExp(/(\\b(?:class|concept|enum|struct|typename)\\s+)(?!)\\w+/.source.replace(//g,(function(){return t.source}))),lookbehind:!0},/\\b[A-Z]\\w*(?=\\s*::\\s*\\w+\\s*\\()/,/\\b[A-Z_]\\w*(?=\\s*::\\s*~\\w+\\s*\\()/i,/\\b\\w+(?=\\s*<(?:[^<>]|<(?:[^<>]|<[^<>]*>)*>)*>\\s*::\\s*\\w+\\s*\\()/],keyword:t,number:{pattern:/(?:\\b0b[01']+|\\b0x(?:[\\da-f']+(?:\\.[\\da-f']*)?|\\.[\\da-f']+)(?:p[+-]?[\\d']+)?|(?:\\b[\\d']+(?:\\.[\\d']*)?|\\B\\.[\\d']+)(?:e[+-]?[\\d']+)?)[ful]{0,4}/i,greedy:!0},operator:/>>=?|<<=?|->|--|\\+\\+|&&|\\|\\||[?:~]|<=>|[-+*/%&|^!=<>]=?|\\b(?:and|and_eq|bitand|bitor|not|not_eq|or|or_eq|xor|xor_eq)\\b/,boolean:/\\b(?:false|true)\\b/}),e.languages.insertBefore(\"cpp\",\"string\",{module:{pattern:RegExp(/(\\b(?:import|module)\\s+)/.source+\"(?:\"+/\"(?:\\\\(?:\\r\\n|[\\s\\S])|[^\"\\\\\\r\\n])*\"|<[^<>\\r\\n]*>/.source+\"|\"+/(?:\\s*:\\s*)?|:\\s*/.source.replace(//g,(function(){return n}))+\")\"),lookbehind:!0,greedy:!0,inside:{string:/^[<\"][\\s\\S]+/,operator:/:/,punctuation:/\\./}},\"raw-string\":{pattern:/R\"([^()\\\\ ]{0,16})\\([\\s\\S]*?\\)\\1\"/,alias:\"string\",greedy:!0}}),e.languages.insertBefore(\"cpp\",\"keyword\",{\"generic-function\":{pattern:/\\b(?!operator\\b)[a-z_]\\w*\\s*<(?:[^<>]|<[^<>]*>)*>(?=\\s*\\()/i,inside:{function:/^\\w+/,generic:{pattern:/<[\\s\\S]+/,alias:\"class-name\",inside:e.languages.cpp}}}}),e.languages.insertBefore(\"cpp\",\"operator\",{\"double-colon\":{pattern:/::/,alias:\"punctuation\"}}),e.languages.insertBefore(\"cpp\",\"class-name\",{\"base-clause\":{pattern:/(\\b(?:class|struct)\\s+\\w+\\s*:\\s*)[^;{}\"'\\s]+(?:\\s+[^;{}\"'\\s]+)*(?=\\s*[;{])/,lookbehind:!0,greedy:!0,inside:e.languages.extend(\"cpp\",{})}}),e.languages.insertBefore(\"inside\",\"double-colon\",{\"class-name\":/\\b[a-z_]\\w*\\b(?!\\s*::)/i},e.languages.cpp[\"base-clause\"])}(Prism)},5651:function(){!function(e){function t(e,t){return e.replace(/<<(\\d+)>>/g,(function(e,n){return\"(?:\"+t[+n]+\")\"}))}function n(e,n,r){return RegExp(t(e,n),r||\"\")}function r(e,t){for(var n=0;n>/g,(function(){return\"(?:\"+e+\")\"}));return e.replace(/<>/g,\"[^\\\\s\\\\S]\")}var i=\"bool byte char decimal double dynamic float int long object sbyte short string uint ulong ushort var void\",o=\"class enum interface record struct\",s=\"add alias and ascending async await by descending from(?=\\\\s*(?:\\\\w|$)) get global group into init(?=\\\\s*;) join let nameof not notnull on or orderby partial remove select set unmanaged value when where with(?=\\\\s*{)\",a=\"abstract as base break case catch checked const continue default delegate do else event explicit extern finally fixed for foreach goto if implicit in internal is lock namespace new null operator out override params private protected public readonly ref return sealed sizeof stackalloc static switch this throw try typeof unchecked unsafe using virtual volatile while yield\";function l(e){return\"\\\\b(?:\"+e.trim().replace(/ /g,\"|\")+\")\\\\b\"}var c=l(o),u=RegExp(l(i+\" \"+o+\" \"+s+\" \"+a)),p=l(o+\" \"+s+\" \"+a),d=l(i+\" \"+o+\" \"+a),f=r(/<(?:[^<>;=+\\-*/%&|^]|<>)*>/.source,2),h=r(/\\((?:[^()]|<>)*\\)/.source,2),m=/@?\\b[A-Za-z_]\\w*\\b/.source,g=t(/<<0>>(?:\\s*<<1>>)?/.source,[m,f]),y=t(/(?!<<0>>)<<1>>(?:\\s*\\.\\s*<<1>>)*/.source,[p,g]),b=/\\[\\s*(?:,\\s*)*\\]/.source,v=t(/<<0>>(?:\\s*(?:\\?\\s*)?<<1>>)*(?:\\s*\\?)?/.source,[y,b]),x=t(/[^,()<>[\\];=+\\-*/%&|^]|<<0>>|<<1>>|<<2>>/.source,[f,h,b]),w=t(/\\(<<0>>+(?:,<<0>>+)+\\)/.source,[x]),k=t(/(?:<<0>>|<<1>>)(?:\\s*(?:\\?\\s*)?<<2>>)*(?:\\s*\\?)?/.source,[w,y,b]),S={keyword:u,punctuation:/[<>()?,.:[\\]]/},E=/'(?:[^\\r\\n'\\\\]|\\\\.|\\\\[Uux][\\da-fA-F]{1,8})'/.source,O=/\"(?:\\\\.|[^\\\\\"\\r\\n])*\"/.source,_=/@\"(?:\"\"|\\\\[\\s\\S]|[^\\\\\"])*\"(?!\")/.source;e.languages.csharp=e.languages.extend(\"clike\",{string:[{pattern:n(/(^|[^$\\\\])<<0>>/.source,[_]),lookbehind:!0,greedy:!0},{pattern:n(/(^|[^@$\\\\])<<0>>/.source,[O]),lookbehind:!0,greedy:!0}],\"class-name\":[{pattern:n(/(\\busing\\s+static\\s+)<<0>>(?=\\s*;)/.source,[y]),lookbehind:!0,inside:S},{pattern:n(/(\\busing\\s+<<0>>\\s*=\\s*)<<1>>(?=\\s*;)/.source,[m,k]),lookbehind:!0,inside:S},{pattern:n(/(\\busing\\s+)<<0>>(?=\\s*=)/.source,[m]),lookbehind:!0},{pattern:n(/(\\b<<0>>\\s+)<<1>>/.source,[c,g]),lookbehind:!0,inside:S},{pattern:n(/(\\bcatch\\s*\\(\\s*)<<0>>/.source,[y]),lookbehind:!0,inside:S},{pattern:n(/(\\bwhere\\s+)<<0>>/.source,[m]),lookbehind:!0},{pattern:n(/(\\b(?:is(?:\\s+not)?|as)\\s+)<<0>>/.source,[v]),lookbehind:!0,inside:S},{pattern:n(/\\b<<0>>(?=\\s+(?!<<1>>|with\\s*\\{)<<2>>(?:\\s*[=,;:{)\\]]|\\s+(?:in|when)\\b))/.source,[k,d,m]),inside:S}],keyword:u,number:/(?:\\b0(?:x[\\da-f_]*[\\da-f]|b[01_]*[01])|(?:\\B\\.\\d+(?:_+\\d+)*|\\b\\d+(?:_+\\d+)*(?:\\.\\d+(?:_+\\d+)*)?)(?:e[-+]?\\d+(?:_+\\d+)*)?)(?:[dflmu]|lu|ul)?\\b/i,operator:/>>=?|<<=?|[-=]>|([-+&|])\\1|~|\\?\\?=?|[-+*/%&|^!=<>]=?/,punctuation:/\\?\\.?|::|[{}[\\];(),.:]/}),e.languages.insertBefore(\"csharp\",\"number\",{range:{pattern:/\\.\\./,alias:\"operator\"}}),e.languages.insertBefore(\"csharp\",\"punctuation\",{\"named-parameter\":{pattern:n(/([(,]\\s*)<<0>>(?=\\s*:)/.source,[m]),lookbehind:!0,alias:\"punctuation\"}}),e.languages.insertBefore(\"csharp\",\"class-name\",{namespace:{pattern:n(/(\\b(?:namespace|using)\\s+)<<0>>(?:\\s*\\.\\s*<<0>>)*(?=\\s*[;{])/.source,[m]),lookbehind:!0,inside:{punctuation:/\\./}},\"type-expression\":{pattern:n(/(\\b(?:default|sizeof|typeof)\\s*\\(\\s*(?!\\s))(?:[^()\\s]|\\s(?!\\s)|<<0>>)*(?=\\s*\\))/.source,[h]),lookbehind:!0,alias:\"class-name\",inside:S},\"return-type\":{pattern:n(/<<0>>(?=\\s+(?:<<1>>\\s*(?:=>|[({]|\\.\\s*this\\s*\\[)|this\\s*\\[))/.source,[k,y]),inside:S,alias:\"class-name\"},\"constructor-invocation\":{pattern:n(/(\\bnew\\s+)<<0>>(?=\\s*[[({])/.source,[k]),lookbehind:!0,inside:S,alias:\"class-name\"},\"generic-method\":{pattern:n(/<<0>>\\s*<<1>>(?=\\s*\\()/.source,[m,f]),inside:{function:n(/^<<0>>/.source,[m]),generic:{pattern:RegExp(f),alias:\"class-name\",inside:S}}},\"type-list\":{pattern:n(/\\b((?:<<0>>\\s+<<1>>|record\\s+<<1>>\\s*<<5>>|where\\s+<<2>>)\\s*:\\s*)(?:<<3>>|<<4>>|<<1>>\\s*<<5>>|<<6>>)(?:\\s*,\\s*(?:<<3>>|<<4>>|<<6>>))*(?=\\s*(?:where|[{;]|=>|$))/.source,[c,g,m,k,u.source,h,/\\bnew\\s*\\(\\s*\\)/.source]),lookbehind:!0,inside:{\"record-arguments\":{pattern:n(/(^(?!new\\s*\\()<<0>>\\s*)<<1>>/.source,[g,h]),lookbehind:!0,greedy:!0,inside:e.languages.csharp},keyword:u,\"class-name\":{pattern:RegExp(k),greedy:!0,inside:S},punctuation:/[,()]/}},preprocessor:{pattern:/(^[\\t ]*)#.*/m,lookbehind:!0,alias:\"property\",inside:{directive:{pattern:/(#)\\b(?:define|elif|else|endif|endregion|error|if|line|nullable|pragma|region|undef|warning)\\b/,lookbehind:!0,alias:\"keyword\"}}}});var A=O+\"|\"+E,C=t(/\\/(?![*/])|\\/\\/[^\\r\\n]*[\\r\\n]|\\/\\*(?:[^*]|\\*(?!\\/))*\\*\\/|<<0>>/.source,[A]),j=r(t(/[^\"'/()]|<<0>>|\\(<>*\\)/.source,[C]),2),P=/\\b(?:assembly|event|field|method|module|param|property|return|type)\\b/.source,T=t(/<<0>>(?:\\s*\\(<<1>>*\\))?/.source,[y,j]);e.languages.insertBefore(\"csharp\",\"class-name\",{attribute:{pattern:n(/((?:^|[^\\s\\w>)?])\\s*\\[\\s*)(?:<<0>>\\s*:\\s*)?<<1>>(?:\\s*,\\s*<<1>>)*(?=\\s*\\])/.source,[P,T]),lookbehind:!0,greedy:!0,inside:{target:{pattern:n(/^<<0>>(?=\\s*:)/.source,[P]),alias:\"keyword\"},\"attribute-arguments\":{pattern:n(/\\(<<0>>*\\)/.source,[j]),inside:e.languages.csharp},\"class-name\":{pattern:RegExp(y),inside:{punctuation:/\\./}},punctuation:/[:,]/}}});var I=/:[^}\\r\\n]+/.source,R=r(t(/[^\"'/()]|<<0>>|\\(<>*\\)/.source,[C]),2),N=t(/\\{(?!\\{)(?:(?![}:])<<0>>)*<<1>>?\\}/.source,[R,I]),$=r(t(/[^\"'/()]|\\/(?!\\*)|\\/\\*(?:[^*]|\\*(?!\\/))*\\*\\/|<<0>>|\\(<>*\\)/.source,[A]),2),L=t(/\\{(?!\\{)(?:(?![}:])<<0>>)*<<1>>?\\}/.source,[$,I]);function D(t,r){return{interpolation:{pattern:n(/((?:^|[^{])(?:\\{\\{)*)<<0>>/.source,[t]),lookbehind:!0,inside:{\"format-string\":{pattern:n(/(^\\{(?:(?![}:])<<0>>)*)<<1>>(?=\\}$)/.source,[r,I]),lookbehind:!0,inside:{punctuation:/^:/}},punctuation:/^\\{|\\}$/,expression:{pattern:/[\\s\\S]+/,alias:\"language-csharp\",inside:e.languages.csharp}}},string:/[\\s\\S]+/}}e.languages.insertBefore(\"csharp\",\"string\",{\"interpolation-string\":[{pattern:n(/(^|[^\\\\])(?:\\$@|@\\$)\"(?:\"\"|\\\\[\\s\\S]|\\{\\{|<<0>>|[^\\\\{\"])*\"/.source,[N]),lookbehind:!0,greedy:!0,inside:D(N,R)},{pattern:n(/(^|[^@\\\\])\\$\"(?:\\\\.|\\{\\{|<<0>>|[^\\\\\"{])*\"/.source,[L]),lookbehind:!0,greedy:!0,inside:D(L,$)}],char:{pattern:RegExp(E),greedy:!0}}),e.languages.dotnet=e.languages.cs=e.languages.csharp}(Prism)},2630:function(){Prism.languages.csv={value:/[^\\r\\n,\"]+|\"(?:[^\"]|\"\")*\"(?!\")/,punctuation:/,/}},6378:function(){Prism.languages.go=Prism.languages.extend(\"clike\",{string:{pattern:/(^|[^\\\\])\"(?:\\\\.|[^\"\\\\\\r\\n])*\"|`[^`]*`/,lookbehind:!0,greedy:!0},keyword:/\\b(?:break|case|chan|const|continue|default|defer|else|fallthrough|for|func|go(?:to)?|if|import|interface|map|package|range|return|select|struct|switch|type|var)\\b/,boolean:/\\b(?:_|false|iota|nil|true)\\b/,number:[/\\b0(?:b[01_]+|o[0-7_]+)i?\\b/i,/\\b0x(?:[a-f\\d_]+(?:\\.[a-f\\d_]*)?|\\.[a-f\\d_]+)(?:p[+-]?\\d+(?:_\\d+)*)?i?(?!\\w)/i,/(?:\\b\\d[\\d_]*(?:\\.[\\d_]*)?|\\B\\.\\d[\\d_]*)(?:e[+-]?[\\d_]+)?i?(?!\\w)/i],operator:/[*\\/%^!=]=?|\\+[=+]?|-[=-]?|\\|[=|]?|&(?:=|&|\\^=?)?|>(?:>=?|=)?|<(?:<=?|=|-)?|:=|\\.\\.\\./,builtin:/\\b(?:append|bool|byte|cap|close|complex|complex(?:64|128)|copy|delete|error|float(?:32|64)|u?int(?:8|16|32|64)?|imag|len|make|new|panic|print(?:ln)?|real|recover|rune|string|uintptr)\\b/}),Prism.languages.insertBefore(\"go\",\"string\",{char:{pattern:/'(?:\\\\.|[^'\\\\\\r\\n]){0,10}'/,greedy:!0}}),delete Prism.languages.go[\"class-name\"]},4784:function(){!function(e){function t(e){return RegExp(\"(^(?:\"+e+\"):[ \\t]*(?![ \\t]))[^]+\",\"i\")}e.languages.http={\"request-line\":{pattern:/^(?:CONNECT|DELETE|GET|HEAD|OPTIONS|PATCH|POST|PRI|PUT|SEARCH|TRACE)\\s(?:https?:\\/\\/|\\/)\\S*\\sHTTP\\/[\\d.]+/m,inside:{method:{pattern:/^[A-Z]+\\b/,alias:\"property\"},\"request-target\":{pattern:/^(\\s)(?:https?:\\/\\/|\\/)\\S*(?=\\s)/,lookbehind:!0,alias:\"url\",inside:e.languages.uri},\"http-version\":{pattern:/^(\\s)HTTP\\/[\\d.]+/,lookbehind:!0,alias:\"property\"}}},\"response-status\":{pattern:/^HTTP\\/[\\d.]+ \\d+ .+/m,inside:{\"http-version\":{pattern:/^HTTP\\/[\\d.]+/,alias:\"property\"},\"status-code\":{pattern:/^(\\s)\\d+(?=\\s)/,lookbehind:!0,alias:\"number\"},\"reason-phrase\":{pattern:/^(\\s).+/,lookbehind:!0,alias:\"string\"}}},header:{pattern:/^[\\w-]+:.+(?:(?:\\r\\n?|\\n)[ \\t].+)*/m,inside:{\"header-value\":[{pattern:t(/Content-Security-Policy/.source),lookbehind:!0,alias:[\"csp\",\"languages-csp\"],inside:e.languages.csp},{pattern:t(/Public-Key-Pins(?:-Report-Only)?/.source),lookbehind:!0,alias:[\"hpkp\",\"languages-hpkp\"],inside:e.languages.hpkp},{pattern:t(/Strict-Transport-Security/.source),lookbehind:!0,alias:[\"hsts\",\"languages-hsts\"],inside:e.languages.hsts},{pattern:t(/[^:]+/.source),lookbehind:!0}],\"header-name\":{pattern:/^[^:]+/,alias:\"keyword\"},punctuation:/^:/}}};var n,r=e.languages,i={\"application/javascript\":r.javascript,\"application/json\":r.json||r.javascript,\"application/xml\":r.xml,\"text/xml\":r.xml,\"text/html\":r.html,\"text/css\":r.css,\"text/plain\":r.plain},o={\"application/json\":!0,\"application/xml\":!0};function s(e){var t=e.replace(/^[a-z]+\\//,\"\");return\"(?:\"+e+\"|\\\\w+/(?:[\\\\w.-]+\\\\+)+\"+t+\"(?![+\\\\w.-]))\"}for(var a in i)if(i[a]){n=n||{};var l=o[a]?s(a):a;n[a.replace(/\\//g,\"-\")]={pattern:RegExp(\"(\"+/content-type:\\s*/.source+l+/(?:(?:\\r\\n?|\\n)[\\w-].*)*(?:\\r(?:\\n|(?!\\n))|\\n)/.source+\")\"+/[^ \\t\\w-][\\s\\S]*/.source,\"i\"),lookbehind:!0,inside:i[a]}}n&&e.languages.insertBefore(\"http\",\"header\",n)}(Prism)},6976:function(){!function(e){var t=/\\b(?:abstract|assert|boolean|break|byte|case|catch|char|class|const|continue|default|do|double|else|enum|exports|extends|final|finally|float|for|goto|if|implements|import|instanceof|int|interface|long|module|native|new|non-sealed|null|open|opens|package|permits|private|protected|provides|public|record(?!\\s*[(){}[\\]<>=%~.:,;?+\\-*/&|^])|requires|return|sealed|short|static|strictfp|super|switch|synchronized|this|throw|throws|to|transient|transitive|try|uses|var|void|volatile|while|with|yield)\\b/,n=/(?:[a-z]\\w*\\s*\\.\\s*)*(?:[A-Z]\\w*\\s*\\.\\s*)*/.source,r={pattern:RegExp(/(^|[^\\w.])/.source+n+/[A-Z](?:[\\d_A-Z]*[a-z]\\w*)?\\b/.source),lookbehind:!0,inside:{namespace:{pattern:/^[a-z]\\w*(?:\\s*\\.\\s*[a-z]\\w*)*(?:\\s*\\.)?/,inside:{punctuation:/\\./}},punctuation:/\\./}};e.languages.java=e.languages.extend(\"clike\",{string:{pattern:/(^|[^\\\\])\"(?:\\\\.|[^\"\\\\\\r\\n])*\"/,lookbehind:!0,greedy:!0},\"class-name\":[r,{pattern:RegExp(/(^|[^\\w.])/.source+n+/[A-Z]\\w*(?=\\s+\\w+\\s*[;,=()]|\\s*(?:\\[[\\s,]*\\]\\s*)?::\\s*new\\b)/.source),lookbehind:!0,inside:r.inside},{pattern:RegExp(/(\\b(?:class|enum|extends|implements|instanceof|interface|new|record|throws)\\s+)/.source+n+/[A-Z]\\w*\\b/.source),lookbehind:!0,inside:r.inside}],keyword:t,function:[e.languages.clike.function,{pattern:/(::\\s*)[a-z_]\\w*/,lookbehind:!0}],number:/\\b0b[01][01_]*L?\\b|\\b0x(?:\\.[\\da-f_p+-]+|[\\da-f_]+(?:\\.[\\da-f_p+-]+)?)\\b|(?:\\b\\d[\\d_]*(?:\\.[\\d_]*)?|\\B\\.\\d[\\d_]*)(?:e[+-]?\\d[\\d_]*)?[dfl]?/i,operator:{pattern:/(^|[^.])(?:<<=?|>>>?=?|->|--|\\+\\+|&&|\\|\\||::|[?:~]|[-+*/%&|^!=<>]=?)/m,lookbehind:!0},constant:/\\b[A-Z][A-Z_\\d]+\\b/}),e.languages.insertBefore(\"java\",\"string\",{\"triple-quoted-string\":{pattern:/\"\"\"[ \\t]*[\\r\\n](?:(?:\"|\"\")?(?:\\\\.|[^\"\\\\]))*\"\"\"/,greedy:!0,alias:\"string\"},char:{pattern:/'(?:\\\\.|[^'\\\\\\r\\n]){1,6}'/,greedy:!0}}),e.languages.insertBefore(\"java\",\"class-name\",{annotation:{pattern:/(^|[^.])@\\w+(?:\\s*\\.\\s*\\w+)*/,lookbehind:!0,alias:\"punctuation\"},generics:{pattern:/<(?:[\\w\\s,.?]|&(?!&)|<(?:[\\w\\s,.?]|&(?!&)|<(?:[\\w\\s,.?]|&(?!&)|<(?:[\\w\\s,.?]|&(?!&))*>)*>)*>)*>/,inside:{\"class-name\":r,keyword:t,punctuation:/[<>(),.:]/,operator:/[?&|]/}},import:[{pattern:RegExp(/(\\bimport\\s+)/.source+n+/(?:[A-Z]\\w*|\\*)(?=\\s*;)/.source),lookbehind:!0,inside:{namespace:r.inside.namespace,punctuation:/\\./,operator:/\\*/,\"class-name\":/\\w+/}},{pattern:RegExp(/(\\bimport\\s+static\\s+)/.source+n+/(?:\\w+|\\*)(?=\\s*;)/.source),lookbehind:!0,alias:\"static\",inside:{namespace:r.inside.namespace,static:/\\b\\w+$/,punctuation:/\\./,operator:/\\*/,\"class-name\":/\\w+/}}],namespace:{pattern:RegExp(/(\\b(?:exports|import(?:\\s+static)?|module|open|opens|package|provides|requires|to|transitive|uses|with)\\s+)(?!)[a-z]\\w*(?:\\.[a-z]\\w*)*\\.?/.source.replace(//g,(function(){return t.source}))),lookbehind:!0,inside:{punctuation:/\\./}}})}(Prism)},64:function(){Prism.languages.lua={comment:/^#!.+|--(?:\\[(=*)\\[[\\s\\S]*?\\]\\1\\]|.*)/m,string:{pattern:/([\"'])(?:(?!\\1)[^\\\\\\r\\n]|\\\\z(?:\\r\\n|\\s)|\\\\(?:\\r\\n|[^z]))*\\1|\\[(=*)\\[[\\s\\S]*?\\]\\2\\]/,greedy:!0},number:/\\b0x[a-f\\d]+(?:\\.[a-f\\d]*)?(?:p[+-]?\\d+)?\\b|\\b\\d+(?:\\.\\B|(?:\\.\\d*)?(?:e[+-]?\\d+)?\\b)|\\B\\.\\d+(?:e[+-]?\\d+)?\\b/i,keyword:/\\b(?:and|break|do|else|elseif|end|false|for|function|goto|if|in|local|nil|not|or|repeat|return|then|true|until|while)\\b/,function:/(?!\\d)\\w+(?=\\s*(?:[({]))/,operator:[/[-+*%^&|#]|\\/\\/?|<[<=]?|>[>=]?|[=~]=?/,{pattern:/(^|[^.])\\.\\.(?!\\.)/,lookbehind:!0}],punctuation:/[\\[\\](){},;]|\\.+|:+/}},9700:function(){!function(e){function t(e,t){return\"___\"+e.toUpperCase()+t+\"___\"}Object.defineProperties(e.languages[\"markup-templating\"]={},{buildPlaceholders:{value:function(n,r,i,o){if(n.language===r){var s=n.tokenStack=[];n.code=n.code.replace(i,(function(e){if(\"function\"==typeof o&&!o(e))return e;for(var i,a=s.length;-1!==n.code.indexOf(i=t(r,a));)++a;return s[a]=e,i})),n.grammar=e.languages.markup}}},tokenizePlaceholders:{value:function(n,r){if(n.language===r&&n.tokenStack){n.grammar=e.languages[r];var i=0,o=Object.keys(n.tokenStack);!function s(a){for(var l=0;l=o.length);l++){var c=a[l];if(\"string\"==typeof c||c.content&&\"string\"==typeof c.content){var u=o[i],p=n.tokenStack[u],d=\"string\"==typeof c?c:c.content,f=t(r,u),h=d.indexOf(f);if(h>-1){++i;var m=d.substring(0,h),g=new e.Token(r,e.tokenize(p,n.grammar),\"language-\"+r,p),y=d.substring(h+f.length),b=[];m&&b.push.apply(b,s([m])),b.push(g),y&&b.push.apply(b,s([y])),\"string\"==typeof c?a.splice.apply(a,[l,1].concat(b)):c.content=b}}else c.content&&s(c.content)}return a}(n.tokens)}}}})}(Prism)},4312:function(){Prism.languages.markup={comment:{pattern://,greedy:!0},prolog:{pattern:/<\\?[\\s\\S]+?\\?>/,greedy:!0},doctype:{pattern:/\"'[\\]]|\"[^\"]*\"|'[^']*')+(?:\\[(?:[^<\"'\\]]|\"[^\"]*\"|'[^']*'|<(?!!--)|)*\\]\\s*)?>/i,greedy:!0,inside:{\"internal-subset\":{pattern:/(^[^\\[]*\\[)[\\s\\S]+(?=\\]>$)/,lookbehind:!0,greedy:!0,inside:null},string:{pattern:/\"[^\"]*\"|'[^']*'/,greedy:!0},punctuation:/^$|[[\\]]/,\"doctype-tag\":/^DOCTYPE/i,name:/[^\\s<>'\"]+/}},cdata:{pattern://i,greedy:!0},tag:{pattern:/<\\/?(?!\\d)[^\\s>\\/=$<%]+(?:\\s(?:\\s*[^\\s>\\/=]+(?:\\s*=\\s*(?:\"[^\"]*\"|'[^']*'|[^\\s'\">=]+(?=[\\s>]))|(?=[\\s/>])))+)?\\s*\\/?>/,greedy:!0,inside:{tag:{pattern:/^<\\/?[^\\s>\\/]+/,inside:{punctuation:/^<\\/?/,namespace:/^[^\\s>\\/:]+:/}},\"special-attr\":[],\"attr-value\":{pattern:/=\\s*(?:\"[^\"]*\"|'[^']*'|[^\\s'\">=]+)/,inside:{punctuation:[{pattern:/^=/,alias:\"attr-equals\"},{pattern:/^(\\s*)[\"']|[\"']$/,lookbehind:!0}]}},punctuation:/\\/?>/,\"attr-name\":{pattern:/[^\\s>\\/]+/,inside:{namespace:/^[^\\s>\\/:]+:/}}}},entity:[{pattern:/&[\\da-z]{1,8};/i,alias:\"named-entity\"},/&#x?[\\da-f]{1,8};/i]},Prism.languages.markup.tag.inside[\"attr-value\"].inside.entity=Prism.languages.markup.entity,Prism.languages.markup.doctype.inside[\"internal-subset\"].inside=Prism.languages.markup,Prism.hooks.add(\"wrap\",(function(e){\"entity\"===e.type&&(e.attributes.title=e.content.replace(/&/,\"&\"))})),Object.defineProperty(Prism.languages.markup.tag,\"addInlined\",{value:function(e,t){var n={};n[\"language-\"+t]={pattern:/(^$)/i,lookbehind:!0,inside:Prism.languages[t]},n.cdata=/^$/i;var r={\"included-cdata\":{pattern://i,inside:n}};r[\"language-\"+t]={pattern:/[\\s\\S]+/,inside:Prism.languages[t]};var i={};i[e]={pattern:RegExp(/(<__[^>]*>)(?:))*\\]\\]>|(?!)/.source.replace(/__/g,(function(){return e})),\"i\"),lookbehind:!0,greedy:!0,inside:r},Prism.languages.insertBefore(\"markup\",\"cdata\",i)}}),Object.defineProperty(Prism.languages.markup.tag,\"addAttribute\",{value:function(e,t){Prism.languages.markup.tag.inside[\"special-attr\"].push({pattern:RegExp(/(^|[\"'\\s])/.source+\"(?:\"+e+\")\"+/\\s*=\\s*(?:\"[^\"]*\"|'[^']*'|[^\\s'\">=]+(?=[\\s>]))/.source,\"i\"),lookbehind:!0,inside:{\"attr-name\":/^[^\\s=]+/,\"attr-value\":{pattern:/=[\\s\\S]+/,inside:{value:{pattern:/(^=\\s*([\"']|(?![\"'])))\\S[\\s\\S]*(?=\\2$)/,lookbehind:!0,alias:[t,\"language-\"+t],inside:Prism.languages[t]},punctuation:[{pattern:/^=/,alias:\"attr-equals\"},/\"|'/]}}}})}}),Prism.languages.html=Prism.languages.markup,Prism.languages.mathml=Prism.languages.markup,Prism.languages.svg=Prism.languages.markup,Prism.languages.xml=Prism.languages.extend(\"markup\",{}),Prism.languages.ssml=Prism.languages.xml,Prism.languages.atom=Prism.languages.xml,Prism.languages.rss=Prism.languages.xml},596:function(){Prism.languages.objectivec=Prism.languages.extend(\"c\",{string:{pattern:/@?\"(?:\\\\(?:\\r\\n|[\\s\\S])|[^\"\\\\\\r\\n])*\"/,greedy:!0},keyword:/\\b(?:asm|auto|break|case|char|const|continue|default|do|double|else|enum|extern|float|for|goto|if|in|inline|int|long|register|return|self|short|signed|sizeof|static|struct|super|switch|typedef|typeof|union|unsigned|void|volatile|while)\\b|(?:@interface|@end|@implementation|@protocol|@class|@public|@protected|@private|@property|@try|@catch|@finally|@throw|@synthesize|@dynamic|@selector)\\b/,operator:/-[->]?|\\+\\+?|!=?|<>?=?|==?|&&?|\\|\\|?|[~^%?*\\/@]/}),delete Prism.languages.objectivec[\"class-name\"],Prism.languages.objc=Prism.languages.objectivec},2821:function(){!function(e){var t=/(?:\\((?:[^()\\\\]|\\\\[\\s\\S])*\\)|\\{(?:[^{}\\\\]|\\\\[\\s\\S])*\\}|\\[(?:[^[\\]\\\\]|\\\\[\\s\\S])*\\]|<(?:[^<>\\\\]|\\\\[\\s\\S])*>)/.source;e.languages.perl={comment:[{pattern:/(^\\s*)=\\w[\\s\\S]*?=cut.*/m,lookbehind:!0,greedy:!0},{pattern:/(^|[^\\\\$])#.*/,lookbehind:!0,greedy:!0}],string:[{pattern:RegExp(/\\b(?:q|qq|qw|qx)(?![a-zA-Z0-9])\\s*/.source+\"(?:\"+[/([^a-zA-Z0-9\\s{(\\[<])(?:(?!\\1)[^\\\\]|\\\\[\\s\\S])*\\1/.source,/([a-zA-Z0-9])(?:(?!\\2)[^\\\\]|\\\\[\\s\\S])*\\2/.source,t].join(\"|\")+\")\"),greedy:!0},{pattern:/(\"|`)(?:(?!\\1)[^\\\\]|\\\\[\\s\\S])*\\1/,greedy:!0},{pattern:/'(?:[^'\\\\\\r\\n]|\\\\.)*'/,greedy:!0}],regex:[{pattern:RegExp(/\\b(?:m|qr)(?![a-zA-Z0-9])\\s*/.source+\"(?:\"+[/([^a-zA-Z0-9\\s{(\\[<])(?:(?!\\1)[^\\\\]|\\\\[\\s\\S])*\\1/.source,/([a-zA-Z0-9])(?:(?!\\2)[^\\\\]|\\\\[\\s\\S])*\\2/.source,t].join(\"|\")+\")\"+/[msixpodualngc]*/.source),greedy:!0},{pattern:RegExp(/(^|[^-])\\b(?:s|tr|y)(?![a-zA-Z0-9])\\s*/.source+\"(?:\"+[/([^a-zA-Z0-9\\s{(\\[<])(?:(?!\\2)[^\\\\]|\\\\[\\s\\S])*\\2(?:(?!\\2)[^\\\\]|\\\\[\\s\\S])*\\2/.source,/([a-zA-Z0-9])(?:(?!\\3)[^\\\\]|\\\\[\\s\\S])*\\3(?:(?!\\3)[^\\\\]|\\\\[\\s\\S])*\\3/.source,t+/\\s*/.source+t].join(\"|\")+\")\"+/[msixpodualngcer]*/.source),lookbehind:!0,greedy:!0},{pattern:/\\/(?:[^\\/\\\\\\r\\n]|\\\\.)*\\/[msixpodualngc]*(?=\\s*(?:$|[\\r\\n,.;})&|\\-+*~<>!?^]|(?:and|cmp|eq|ge|gt|le|lt|ne|not|or|x|xor)\\b))/,greedy:!0}],variable:[/[&*$@%]\\{\\^[A-Z]+\\}/,/[&*$@%]\\^[A-Z_]/,/[&*$@%]#?(?=\\{)/,/[&*$@%]#?(?:(?:::)*'?(?!\\d)[\\w$]+(?![\\w$]))+(?:::)*/,/[&*$@%]\\d+/,/(?!%=)[$@%][!\"#$%&'()*+,\\-.\\/:;<=>?@[\\\\\\]^_`{|}~]/],filehandle:{pattern:/<(?![<=])\\S*?>|\\b_\\b/,alias:\"symbol\"},\"v-string\":{pattern:/v\\d+(?:\\.\\d+)*|\\d+(?:\\.\\d+){2,}/,alias:\"string\"},function:{pattern:/(\\bsub[ \\t]+)\\w+/,lookbehind:!0},keyword:/\\b(?:any|break|continue|default|delete|die|do|else|elsif|eval|for|foreach|given|goto|if|last|local|my|next|our|package|print|redo|require|return|say|state|sub|switch|undef|unless|until|use|when|while)\\b/,number:/\\b(?:0x[\\dA-Fa-f](?:_?[\\dA-Fa-f])*|0b[01](?:_?[01])*|(?:(?:\\d(?:_?\\d)*)?\\.)?\\d(?:_?\\d)*(?:[Ee][+-]?\\d+)?)\\b/,operator:/-[rwxoRWXOezsfdlpSbctugkTBMAC]\\b|\\+[+=]?|-[-=>]?|\\*\\*?=?|\\/\\/?=?|=[=~>]?|~[~=]?|\\|\\|?=?|&&?=?|<(?:=>?|<=?)?|>>?=?|![~=]?|[%^]=?|\\.(?:=|\\.\\.?)?|[\\\\?]|\\bx(?:=|\\b)|\\b(?:and|cmp|eq|ge|gt|le|lt|ne|not|or|xor)\\b/,punctuation:/[{}[\\];(),:]/}}(Prism)},3554:function(){!function(e){var t=/\\/\\*[\\s\\S]*?\\*\\/|\\/\\/.*|#(?!\\[).*/,n=[{pattern:/\\b(?:false|true)\\b/i,alias:\"boolean\"},{pattern:/(::\\s*)\\b[a-z_]\\w*\\b(?!\\s*\\()/i,greedy:!0,lookbehind:!0},{pattern:/(\\b(?:case|const)\\s+)\\b[a-z_]\\w*(?=\\s*[;=])/i,greedy:!0,lookbehind:!0},/\\b(?:null)\\b/i,/\\b[A-Z_][A-Z0-9_]*\\b(?!\\s*\\()/],r=/\\b0b[01]+(?:_[01]+)*\\b|\\b0o[0-7]+(?:_[0-7]+)*\\b|\\b0x[\\da-f]+(?:_[\\da-f]+)*\\b|(?:\\b\\d+(?:_\\d+)*\\.?(?:\\d+(?:_\\d+)*)?|\\B\\.\\d+)(?:e[+-]?\\d+)?/i,i=/|\\?\\?=?|\\.{3}|\\??->|[!=]=?=?|::|\\*\\*=?|--|\\+\\+|&&|\\|\\||<<|>>|[?~]|[/^|%*&<>.+-]=?/,o=/[{}\\[\\](),:;]/;e.languages.php={delimiter:{pattern:/\\?>$|^<\\?(?:php(?=\\s)|=)?/i,alias:\"important\"},comment:t,variable:/\\$+(?:\\w+\\b|(?=\\{))/,package:{pattern:/(namespace\\s+|use\\s+(?:function\\s+)?)(?:\\\\?\\b[a-z_]\\w*)+\\b(?!\\\\)/i,lookbehind:!0,inside:{punctuation:/\\\\/}},\"class-name-definition\":{pattern:/(\\b(?:class|enum|interface|trait)\\s+)\\b[a-z_]\\w*(?!\\\\)\\b/i,lookbehind:!0,alias:\"class-name\"},\"function-definition\":{pattern:/(\\bfunction\\s+)[a-z_]\\w*(?=\\s*\\()/i,lookbehind:!0,alias:\"function\"},keyword:[{pattern:/(\\(\\s*)\\b(?:array|bool|boolean|float|int|integer|object|string)\\b(?=\\s*\\))/i,alias:\"type-casting\",greedy:!0,lookbehind:!0},{pattern:/([(,?]\\s*)\\b(?:array(?!\\s*\\()|bool|callable|(?:false|null)(?=\\s*\\|)|float|int|iterable|mixed|object|self|static|string)\\b(?=\\s*\\$)/i,alias:\"type-hint\",greedy:!0,lookbehind:!0},{pattern:/(\\)\\s*:\\s*(?:\\?\\s*)?)\\b(?:array(?!\\s*\\()|bool|callable|(?:false|null)(?=\\s*\\|)|float|int|iterable|mixed|never|object|self|static|string|void)\\b/i,alias:\"return-type\",greedy:!0,lookbehind:!0},{pattern:/\\b(?:array(?!\\s*\\()|bool|float|int|iterable|mixed|object|string|void)\\b/i,alias:\"type-declaration\",greedy:!0},{pattern:/(\\|\\s*)(?:false|null)\\b|\\b(?:false|null)(?=\\s*\\|)/i,alias:\"type-declaration\",greedy:!0,lookbehind:!0},{pattern:/\\b(?:parent|self|static)(?=\\s*::)/i,alias:\"static-context\",greedy:!0},{pattern:/(\\byield\\s+)from\\b/i,lookbehind:!0},/\\bclass\\b/i,{pattern:/((?:^|[^\\s>:]|(?:^|[^-])>|(?:^|[^:]):)\\s*)\\b(?:abstract|and|array|as|break|callable|case|catch|clone|const|continue|declare|default|die|do|echo|else|elseif|empty|enddeclare|endfor|endforeach|endif|endswitch|endwhile|enum|eval|exit|extends|final|finally|fn|for|foreach|function|global|goto|if|implements|include|include_once|instanceof|insteadof|interface|isset|list|match|namespace|never|new|or|parent|print|private|protected|public|readonly|require|require_once|return|self|static|switch|throw|trait|try|unset|use|var|while|xor|yield|__halt_compiler)\\b/i,lookbehind:!0}],\"argument-name\":{pattern:/([(,]\\s*)\\b[a-z_]\\w*(?=\\s*:(?!:))/i,lookbehind:!0},\"class-name\":[{pattern:/(\\b(?:extends|implements|instanceof|new(?!\\s+self|\\s+static))\\s+|\\bcatch\\s*\\()\\b[a-z_]\\w*(?!\\\\)\\b/i,greedy:!0,lookbehind:!0},{pattern:/(\\|\\s*)\\b[a-z_]\\w*(?!\\\\)\\b/i,greedy:!0,lookbehind:!0},{pattern:/\\b[a-z_]\\w*(?!\\\\)\\b(?=\\s*\\|)/i,greedy:!0},{pattern:/(\\|\\s*)(?:\\\\?\\b[a-z_]\\w*)+\\b/i,alias:\"class-name-fully-qualified\",greedy:!0,lookbehind:!0,inside:{punctuation:/\\\\/}},{pattern:/(?:\\\\?\\b[a-z_]\\w*)+\\b(?=\\s*\\|)/i,alias:\"class-name-fully-qualified\",greedy:!0,inside:{punctuation:/\\\\/}},{pattern:/(\\b(?:extends|implements|instanceof|new(?!\\s+self\\b|\\s+static\\b))\\s+|\\bcatch\\s*\\()(?:\\\\?\\b[a-z_]\\w*)+\\b(?!\\\\)/i,alias:\"class-name-fully-qualified\",greedy:!0,lookbehind:!0,inside:{punctuation:/\\\\/}},{pattern:/\\b[a-z_]\\w*(?=\\s*\\$)/i,alias:\"type-declaration\",greedy:!0},{pattern:/(?:\\\\?\\b[a-z_]\\w*)+(?=\\s*\\$)/i,alias:[\"class-name-fully-qualified\",\"type-declaration\"],greedy:!0,inside:{punctuation:/\\\\/}},{pattern:/\\b[a-z_]\\w*(?=\\s*::)/i,alias:\"static-context\",greedy:!0},{pattern:/(?:\\\\?\\b[a-z_]\\w*)+(?=\\s*::)/i,alias:[\"class-name-fully-qualified\",\"static-context\"],greedy:!0,inside:{punctuation:/\\\\/}},{pattern:/([(,?]\\s*)[a-z_]\\w*(?=\\s*\\$)/i,alias:\"type-hint\",greedy:!0,lookbehind:!0},{pattern:/([(,?]\\s*)(?:\\\\?\\b[a-z_]\\w*)+(?=\\s*\\$)/i,alias:[\"class-name-fully-qualified\",\"type-hint\"],greedy:!0,lookbehind:!0,inside:{punctuation:/\\\\/}},{pattern:/(\\)\\s*:\\s*(?:\\?\\s*)?)\\b[a-z_]\\w*(?!\\\\)\\b/i,alias:\"return-type\",greedy:!0,lookbehind:!0},{pattern:/(\\)\\s*:\\s*(?:\\?\\s*)?)(?:\\\\?\\b[a-z_]\\w*)+\\b(?!\\\\)/i,alias:[\"class-name-fully-qualified\",\"return-type\"],greedy:!0,lookbehind:!0,inside:{punctuation:/\\\\/}}],constant:n,function:{pattern:/(^|[^\\\\\\w])\\\\?[a-z_](?:[\\w\\\\]*\\w)?(?=\\s*\\()/i,lookbehind:!0,inside:{punctuation:/\\\\/}},property:{pattern:/(->\\s*)\\w+/,lookbehind:!0},number:r,operator:i,punctuation:o};var s={pattern:/\\{\\$(?:\\{(?:\\{[^{}]+\\}|[^{}]+)\\}|[^{}])+\\}|(^|[^\\\\{])\\$+(?:\\w+(?:\\[[^\\r\\n\\[\\]]+\\]|->\\w+)?)/,lookbehind:!0,inside:e.languages.php},a=[{pattern:/<<<'([^']+)'[\\r\\n](?:.*[\\r\\n])*?\\1;/,alias:\"nowdoc-string\",greedy:!0,inside:{delimiter:{pattern:/^<<<'[^']+'|[a-z_]\\w*;$/i,alias:\"symbol\",inside:{punctuation:/^<<<'?|[';]$/}}}},{pattern:/<<<(?:\"([^\"]+)\"[\\r\\n](?:.*[\\r\\n])*?\\1;|([a-z_]\\w*)[\\r\\n](?:.*[\\r\\n])*?\\2;)/i,alias:\"heredoc-string\",greedy:!0,inside:{delimiter:{pattern:/^<<<(?:\"[^\"]+\"|[a-z_]\\w*)|[a-z_]\\w*;$/i,alias:\"symbol\",inside:{punctuation:/^<<<\"?|[\";]$/}},interpolation:s}},{pattern:/`(?:\\\\[\\s\\S]|[^\\\\`])*`/,alias:\"backtick-quoted-string\",greedy:!0},{pattern:/'(?:\\\\[\\s\\S]|[^\\\\'])*'/,alias:\"single-quoted-string\",greedy:!0},{pattern:/\"(?:\\\\[\\s\\S]|[^\\\\\"])*\"/,alias:\"double-quoted-string\",greedy:!0,inside:{interpolation:s}}];e.languages.insertBefore(\"php\",\"variable\",{string:a,attribute:{pattern:/#\\[(?:[^\"'\\/#]|\\/(?![*/])|\\/\\/.*$|#(?!\\[).*$|\\/\\*(?:[^*]|\\*(?!\\/))*\\*\\/|\"(?:\\\\[\\s\\S]|[^\\\\\"])*\"|'(?:\\\\[\\s\\S]|[^\\\\'])*')+\\](?=\\s*[a-z$#])/im,greedy:!0,inside:{\"attribute-content\":{pattern:/^(#\\[)[\\s\\S]+(?=\\]$)/,lookbehind:!0,inside:{comment:t,string:a,\"attribute-class-name\":[{pattern:/([^:]|^)\\b[a-z_]\\w*(?!\\\\)\\b/i,alias:\"class-name\",greedy:!0,lookbehind:!0},{pattern:/([^:]|^)(?:\\\\?\\b[a-z_]\\w*)+/i,alias:[\"class-name\",\"class-name-fully-qualified\"],greedy:!0,lookbehind:!0,inside:{punctuation:/\\\\/}}],constant:n,number:r,operator:i,punctuation:o}},delimiter:{pattern:/^#\\[|\\]$/,alias:\"punctuation\"}}}}),e.hooks.add(\"before-tokenize\",(function(t){/<\\?/.test(t.code)&&e.languages[\"markup-templating\"].buildPlaceholders(t,\"php\",/<\\?(?:[^\"'/#]|\\/(?![*/])|(\"|')(?:\\\\[\\s\\S]|(?!\\1)[^\\\\])*\\1|(?:\\/\\/|#(?!\\[))(?:[^?\\n\\r]|\\?(?!>))*(?=$|\\?>|[\\r\\n])|#\\[|\\/\\*(?:[^*]|\\*(?!\\/))*(?:\\*\\/|$))*?(?:\\?>|$)/g)})),e.hooks.add(\"after-tokenize\",(function(t){e.languages[\"markup-templating\"].tokenizePlaceholders(t,\"php\")}))}(Prism)},2342:function(){Prism.languages.python={comment:{pattern:/(^|[^\\\\])#.*/,lookbehind:!0,greedy:!0},\"string-interpolation\":{pattern:/(?:f|fr|rf)(?:(\"\"\"|''')[\\s\\S]*?\\1|(\"|')(?:\\\\.|(?!\\2)[^\\\\\\r\\n])*\\2)/i,greedy:!0,inside:{interpolation:{pattern:/((?:^|[^{])(?:\\{\\{)*)\\{(?!\\{)(?:[^{}]|\\{(?!\\{)(?:[^{}]|\\{(?!\\{)(?:[^{}])+\\})+\\})+\\}/,lookbehind:!0,inside:{\"format-spec\":{pattern:/(:)[^:(){}]+(?=\\}$)/,lookbehind:!0},\"conversion-option\":{pattern://,alias:\"punctuation\"},rest:null}},string:/[\\s\\S]+/}},\"triple-quoted-string\":{pattern:/(?:[rub]|br|rb)?(\"\"\"|''')[\\s\\S]*?\\1/i,greedy:!0,alias:\"string\"},string:{pattern:/(?:[rub]|br|rb)?(\"|')(?:\\\\.|(?!\\1)[^\\\\\\r\\n])*\\1/i,greedy:!0},function:{pattern:/((?:^|\\s)def[ \\t]+)[a-zA-Z_]\\w*(?=\\s*\\()/g,lookbehind:!0},\"class-name\":{pattern:/(\\bclass\\s+)\\w+/i,lookbehind:!0},decorator:{pattern:/(^[\\t ]*)@\\w+(?:\\.\\w+)*/m,lookbehind:!0,alias:[\"annotation\",\"punctuation\"],inside:{punctuation:/\\./}},keyword:/\\b(?:_(?=\\s*:)|and|as|assert|async|await|break|case|class|continue|def|del|elif|else|except|exec|finally|for|from|global|if|import|in|is|lambda|match|nonlocal|not|or|pass|print|raise|return|try|while|with|yield)\\b/,builtin:/\\b(?:__import__|abs|all|any|apply|ascii|basestring|bin|bool|buffer|bytearray|bytes|callable|chr|classmethod|cmp|coerce|compile|complex|delattr|dict|dir|divmod|enumerate|eval|execfile|file|filter|float|format|frozenset|getattr|globals|hasattr|hash|help|hex|id|input|int|intern|isinstance|issubclass|iter|len|list|locals|long|map|max|memoryview|min|next|object|oct|open|ord|pow|property|range|raw_input|reduce|reload|repr|reversed|round|set|setattr|slice|sorted|staticmethod|str|sum|super|tuple|type|unichr|unicode|vars|xrange|zip)\\b/,boolean:/\\b(?:False|None|True)\\b/,number:/\\b0(?:b(?:_?[01])+|o(?:_?[0-7])+|x(?:_?[a-f0-9])+)\\b|(?:\\b\\d+(?:_\\d+)*(?:\\.(?:\\d+(?:_\\d+)*)?)?|\\B\\.\\d+(?:_\\d+)*)(?:e[+-]?\\d+(?:_\\d+)*)?j?(?!\\w)/i,operator:/[-+%=]=?|!=|:=|\\*\\*?=?|\\/\\/?=?|<[<=>]?|>[=>]?|[&|^~]/,punctuation:/[{}[\\];(),.:]/},Prism.languages.python[\"string-interpolation\"].inside.interpolation.inside.rest=Prism.languages.python,Prism.languages.py=Prism.languages.python},4113:function(){Prism.languages.q={string:/\"(?:\\\\.|[^\"\\\\\\r\\n])*\"/,comment:[{pattern:/([\\t )\\]}])\\/.*/,lookbehind:!0,greedy:!0},{pattern:/(^|\\r?\\n|\\r)\\/[\\t ]*(?:(?:\\r?\\n|\\r)(?:.*(?:\\r?\\n|\\r(?!\\n)))*?(?:\\\\(?=[\\t ]*(?:\\r?\\n|\\r))|$)|\\S.*)/,lookbehind:!0,greedy:!0},{pattern:/^\\\\[\\t ]*(?:\\r?\\n|\\r)[\\s\\S]+/m,greedy:!0},{pattern:/^#!.+/m,greedy:!0}],symbol:/`(?::\\S+|[\\w.]*)/,datetime:{pattern:/0N[mdzuvt]|0W[dtz]|\\d{4}\\.\\d\\d(?:m|\\.\\d\\d(?:T(?:\\d\\d(?::\\d\\d(?::\\d\\d(?:[.:]\\d\\d\\d)?)?)?)?)?[dz]?)|\\d\\d:\\d\\d(?::\\d\\d(?:[.:]\\d\\d\\d)?)?[uvt]?/,alias:\"number\"},number:/\\b(?![01]:)(?:0N[hje]?|0W[hj]?|0[wn]|0x[\\da-fA-F]+|\\d+(?:\\.\\d*)?(?:e[+-]?\\d+)?[hjfeb]?)/,keyword:/\\\\\\w+\\b|\\b(?:abs|acos|aj0?|all|and|any|asc|asin|asof|atan|attr|avgs?|binr?|by|ceiling|cols|cor|cos|count|cov|cross|csv|cut|delete|deltas|desc|dev|differ|distinct|div|do|dsave|ej|enlist|eval|except|exec|exit|exp|fby|fills|first|fkeys|flip|floor|from|get|getenv|group|gtime|hclose|hcount|hdel|hopen|hsym|iasc|identity|idesc|if|ij|in|insert|inter|inv|keys?|last|like|list|ljf?|load|log|lower|lsq|ltime|ltrim|mavg|maxs?|mcount|md5|mdev|med|meta|mins?|mmax|mmin|mmu|mod|msum|neg|next|not|null|or|over|parse|peach|pj|plist|prds?|prev|prior|rand|rank|ratios|raze|read0|read1|reciprocal|reval|reverse|rload|rotate|rsave|rtrim|save|scan|scov|sdev|select|set|setenv|show|signum|sin|sqrt|ssr?|string|sublist|sums?|sv|svar|system|tables|tan|til|trim|txf|type|uj|ungroup|union|update|upper|upsert|value|var|views?|vs|wavg|where|while|within|wj1?|wsum|ww|xasc|xbar|xcols?|xdesc|xexp|xgroup|xkey|xlog|xprev|xrank)\\b/,adverb:{pattern:/['\\/\\\\]:?|\\beach\\b/,alias:\"function\"},verb:{pattern:/(?:\\B\\.\\B|\\b[01]:|<[=>]?|>=?|[:+\\-*%,!?~=|$&#@^]):?|\\b_\\b:?/,alias:\"operator\"},punctuation:/[(){}\\[\\];.]/}},1648:function(){!function(e){e.languages.ruby=e.languages.extend(\"clike\",{comment:{pattern:/#.*|^=begin\\s[\\s\\S]*?^=end/m,greedy:!0},\"class-name\":{pattern:/(\\b(?:class|module)\\s+|\\bcatch\\s+\\()[\\w.\\\\]+|\\b[A-Z_]\\w*(?=\\s*\\.\\s*new\\b)/,lookbehind:!0,inside:{punctuation:/[.\\\\]/}},keyword:/\\b(?:BEGIN|END|alias|and|begin|break|case|class|def|define_method|defined|do|each|else|elsif|end|ensure|extend|for|if|in|include|module|new|next|nil|not|or|prepend|private|protected|public|raise|redo|require|rescue|retry|return|self|super|then|throw|undef|unless|until|when|while|yield)\\b/,operator:/\\.{2,3}|&\\.|===||[!=]?~|(?:&&|\\|\\||<<|>>|\\*\\*|[+\\-*/%<>!^&|=])=?|[?:]/,punctuation:/[(){}[\\].,;]/}),e.languages.insertBefore(\"ruby\",\"operator\",{\"double-colon\":{pattern:/::/,alias:\"punctuation\"}});var t={pattern:/((?:^|[^\\\\])(?:\\\\{2})*)#\\{(?:[^{}]|\\{[^{}]*\\})*\\}/,lookbehind:!0,inside:{content:{pattern:/^(#\\{)[\\s\\S]+(?=\\}$)/,lookbehind:!0,inside:e.languages.ruby},delimiter:{pattern:/^#\\{|\\}$/,alias:\"punctuation\"}}};delete e.languages.ruby.function;var n=\"(?:\"+[/([^a-zA-Z0-9\\s{(\\[<=])(?:(?!\\1)[^\\\\]|\\\\[\\s\\S])*\\1/.source,/\\((?:[^()\\\\]|\\\\[\\s\\S]|\\((?:[^()\\\\]|\\\\[\\s\\S])*\\))*\\)/.source,/\\{(?:[^{}\\\\]|\\\\[\\s\\S]|\\{(?:[^{}\\\\]|\\\\[\\s\\S])*\\})*\\}/.source,/\\[(?:[^\\[\\]\\\\]|\\\\[\\s\\S]|\\[(?:[^\\[\\]\\\\]|\\\\[\\s\\S])*\\])*\\]/.source,/<(?:[^<>\\\\]|\\\\[\\s\\S]|<(?:[^<>\\\\]|\\\\[\\s\\S])*>)*>/.source].join(\"|\")+\")\",r=/(?:\"(?:\\\\.|[^\"\\\\\\r\\n])*\"|(?:\\b[a-zA-Z_]\\w*|[^\\s\\0-\\x7F]+)[?!]?|\\$.)/.source;e.languages.insertBefore(\"ruby\",\"keyword\",{\"regex-literal\":[{pattern:RegExp(/%r/.source+n+/[egimnosux]{0,6}/.source),greedy:!0,inside:{interpolation:t,regex:/[\\s\\S]+/}},{pattern:/(^|[^/])\\/(?!\\/)(?:\\[[^\\r\\n\\]]+\\]|\\\\.|[^[/\\\\\\r\\n])+\\/[egimnosux]{0,6}(?=\\s*(?:$|[\\r\\n,.;})#]))/,lookbehind:!0,greedy:!0,inside:{interpolation:t,regex:/[\\s\\S]+/}}],variable:/[@$]+[a-zA-Z_]\\w*(?:[?!]|\\b)/,symbol:[{pattern:RegExp(/(^|[^:]):/.source+r),lookbehind:!0,greedy:!0},{pattern:RegExp(/([\\r\\n{(,][ \\t]*)/.source+r+/(?=:(?!:))/.source),lookbehind:!0,greedy:!0}],\"method-definition\":{pattern:/(\\bdef\\s+)\\w+(?:\\s*\\.\\s*\\w+)?/,lookbehind:!0,inside:{function:/\\b\\w+$/,keyword:/^self\\b/,\"class-name\":/^\\w+/,punctuation:/\\./}}}),e.languages.insertBefore(\"ruby\",\"string\",{\"string-literal\":[{pattern:RegExp(/%[qQiIwWs]?/.source+n),greedy:!0,inside:{interpolation:t,string:/[\\s\\S]+/}},{pattern:/(\"|')(?:#\\{[^}]+\\}|#(?!\\{)|\\\\(?:\\r\\n|[\\s\\S])|(?!\\1)[^\\\\#\\r\\n])*\\1/,greedy:!0,inside:{interpolation:t,string:/[\\s\\S]+/}},{pattern:/<<[-~]?([a-z_]\\w*)[\\r\\n](?:.*[\\r\\n])*?[\\t ]*\\1/i,alias:\"heredoc-string\",greedy:!0,inside:{delimiter:{pattern:/^<<[-~]?[a-z_]\\w*|\\b[a-z_]\\w*$/i,inside:{symbol:/\\b\\w+/,punctuation:/^<<[-~]?/}},interpolation:t,string:/[\\s\\S]+/}},{pattern:/<<[-~]?'([a-z_]\\w*)'[\\r\\n](?:.*[\\r\\n])*?[\\t ]*\\1/i,alias:\"heredoc-string\",greedy:!0,inside:{delimiter:{pattern:/^<<[-~]?'[a-z_]\\w*'|\\b[a-z_]\\w*$/i,inside:{symbol:/\\b\\w+/,punctuation:/^<<[-~]?'|'$/}},string:/[\\s\\S]+/}}],\"command-literal\":[{pattern:RegExp(/%x/.source+n),greedy:!0,inside:{interpolation:t,command:{pattern:/[\\s\\S]+/,alias:\"string\"}}},{pattern:/`(?:#\\{[^}]+\\}|#(?!\\{)|\\\\(?:\\r\\n|[\\s\\S])|[^\\\\`#\\r\\n])*`/,greedy:!0,inside:{interpolation:t,command:{pattern:/[\\s\\S]+/,alias:\"string\"}}}]}),delete e.languages.ruby.string,e.languages.insertBefore(\"ruby\",\"number\",{builtin:/\\b(?:Array|Bignum|Binding|Class|Continuation|Dir|Exception|FalseClass|File|Fixnum|Float|Hash|IO|Integer|MatchData|Method|Module|NilClass|Numeric|Object|Proc|Range|Regexp|Stat|String|Struct|Symbol|TMS|Thread|ThreadGroup|Time|TrueClass)\\b/,constant:/\\b[A-Z][A-Z0-9_]*(?:[?!]|\\b)/}),e.languages.rb=e.languages.ruby}(Prism)},4252:function(){Prism.languages.scala=Prism.languages.extend(\"java\",{\"triple-quoted-string\":{pattern:/\"\"\"[\\s\\S]*?\"\"\"/,greedy:!0,alias:\"string\"},string:{pattern:/(\"|')(?:\\\\.|(?!\\1)[^\\\\\\r\\n])*\\1/,greedy:!0},keyword:/<-|=>|\\b(?:abstract|case|catch|class|def|derives|do|else|enum|extends|extension|final|finally|for|forSome|given|if|implicit|import|infix|inline|lazy|match|new|null|object|opaque|open|override|package|private|protected|return|sealed|self|super|this|throw|trait|transparent|try|type|using|val|var|while|with|yield)\\b/,number:/\\b0x(?:[\\da-f]*\\.)?[\\da-f]+|(?:\\b\\d+(?:\\.\\d*)?|\\B\\.\\d+)(?:e\\d+)?[dfl]?/i,builtin:/\\b(?:Any|AnyRef|AnyVal|Boolean|Byte|Char|Double|Float|Int|Long|Nothing|Short|String|Unit)\\b/,symbol:/'[^\\d\\s\\\\]\\w*/}),Prism.languages.insertBefore(\"scala\",\"triple-quoted-string\",{\"string-interpolation\":{pattern:/\\b[a-z]\\w*(?:\"\"\"(?:[^$]|\\$(?:[^{]|\\{(?:[^{}]|\\{[^{}]*\\})*\\}))*?\"\"\"|\"(?:[^$\"\\r\\n]|\\$(?:[^{]|\\{(?:[^{}]|\\{[^{}]*\\})*\\}))*\")/i,greedy:!0,inside:{id:{pattern:/^\\w+/,greedy:!0,alias:\"function\"},escape:{pattern:/\\\\\\$\"|\\$[$\"]/,greedy:!0,alias:\"symbol\"},interpolation:{pattern:/\\$(?:\\w+|\\{(?:[^{}]|\\{[^{}]*\\})*\\})/,greedy:!0,inside:{punctuation:/^\\$\\{?|\\}$/,expression:{pattern:/[\\s\\S]+/,inside:Prism.languages.scala}}},string:/[\\s\\S]+/}}}),delete Prism.languages.scala[\"class-name\"],delete Prism.languages.scala.function,delete Prism.languages.scala.constant},6966:function(){Prism.languages.sql={comment:{pattern:/(^|[^\\\\])(?:\\/\\*[\\s\\S]*?\\*\\/|(?:--|\\/\\/|#).*)/,lookbehind:!0},variable:[{pattern:/@([\"'`])(?:\\\\[\\s\\S]|(?!\\1)[^\\\\])+\\1/,greedy:!0},/@[\\w.$]+/],string:{pattern:/(^|[^@\\\\])(\"|')(?:\\\\[\\s\\S]|(?!\\2)[^\\\\]|\\2\\2)*\\2/,greedy:!0,lookbehind:!0},identifier:{pattern:/(^|[^@\\\\])`(?:\\\\[\\s\\S]|[^`\\\\]|``)*`/,greedy:!0,lookbehind:!0,inside:{punctuation:/^`|`$/}},function:/\\b(?:AVG|COUNT|FIRST|FORMAT|LAST|LCASE|LEN|MAX|MID|MIN|MOD|NOW|ROUND|SUM|UCASE)(?=\\s*\\()/i,keyword:/\\b(?:ACTION|ADD|AFTER|ALGORITHM|ALL|ALTER|ANALYZE|ANY|APPLY|AS|ASC|AUTHORIZATION|AUTO_INCREMENT|BACKUP|BDB|BEGIN|BERKELEYDB|BIGINT|BINARY|BIT|BLOB|BOOL|BOOLEAN|BREAK|BROWSE|BTREE|BULK|BY|CALL|CASCADED?|CASE|CHAIN|CHAR(?:ACTER|SET)?|CHECK(?:POINT)?|CLOSE|CLUSTERED|COALESCE|COLLATE|COLUMNS?|COMMENT|COMMIT(?:TED)?|COMPUTE|CONNECT|CONSISTENT|CONSTRAINT|CONTAINS(?:TABLE)?|CONTINUE|CONVERT|CREATE|CROSS|CURRENT(?:_DATE|_TIME|_TIMESTAMP|_USER)?|CURSOR|CYCLE|DATA(?:BASES?)?|DATE(?:TIME)?|DAY|DBCC|DEALLOCATE|DEC|DECIMAL|DECLARE|DEFAULT|DEFINER|DELAYED|DELETE|DELIMITERS?|DENY|DESC|DESCRIBE|DETERMINISTIC|DISABLE|DISCARD|DISK|DISTINCT|DISTINCTROW|DISTRIBUTED|DO|DOUBLE|DROP|DUMMY|DUMP(?:FILE)?|DUPLICATE|ELSE(?:IF)?|ENABLE|ENCLOSED|END|ENGINE|ENUM|ERRLVL|ERRORS|ESCAPED?|EXCEPT|EXEC(?:UTE)?|EXISTS|EXIT|EXPLAIN|EXTENDED|FETCH|FIELDS|FILE|FILLFACTOR|FIRST|FIXED|FLOAT|FOLLOWING|FOR(?: EACH ROW)?|FORCE|FOREIGN|FREETEXT(?:TABLE)?|FROM|FULL|FUNCTION|GEOMETRY(?:COLLECTION)?|GLOBAL|GOTO|GRANT|GROUP|HANDLER|HASH|HAVING|HOLDLOCK|HOUR|IDENTITY(?:COL|_INSERT)?|IF|IGNORE|IMPORT|INDEX|INFILE|INNER|INNODB|INOUT|INSERT|INT|INTEGER|INTERSECT|INTERVAL|INTO|INVOKER|ISOLATION|ITERATE|JOIN|KEYS?|KILL|LANGUAGE|LAST|LEAVE|LEFT|LEVEL|LIMIT|LINENO|LINES|LINESTRING|LOAD|LOCAL|LOCK|LONG(?:BLOB|TEXT)|LOOP|MATCH(?:ED)?|MEDIUM(?:BLOB|INT|TEXT)|MERGE|MIDDLEINT|MINUTE|MODE|MODIFIES|MODIFY|MONTH|MULTI(?:LINESTRING|POINT|POLYGON)|NATIONAL|NATURAL|NCHAR|NEXT|NO|NONCLUSTERED|NULLIF|NUMERIC|OFF?|OFFSETS?|ON|OPEN(?:DATASOURCE|QUERY|ROWSET)?|OPTIMIZE|OPTION(?:ALLY)?|ORDER|OUT(?:ER|FILE)?|OVER|PARTIAL|PARTITION|PERCENT|PIVOT|PLAN|POINT|POLYGON|PRECEDING|PRECISION|PREPARE|PREV|PRIMARY|PRINT|PRIVILEGES|PROC(?:EDURE)?|PUBLIC|PURGE|QUICK|RAISERROR|READS?|REAL|RECONFIGURE|REFERENCES|RELEASE|RENAME|REPEAT(?:ABLE)?|REPLACE|REPLICATION|REQUIRE|RESIGNAL|RESTORE|RESTRICT|RETURN(?:ING|S)?|REVOKE|RIGHT|ROLLBACK|ROUTINE|ROW(?:COUNT|GUIDCOL|S)?|RTREE|RULE|SAVE(?:POINT)?|SCHEMA|SECOND|SELECT|SERIAL(?:IZABLE)?|SESSION(?:_USER)?|SET(?:USER)?|SHARE|SHOW|SHUTDOWN|SIMPLE|SMALLINT|SNAPSHOT|SOME|SONAME|SQL|START(?:ING)?|STATISTICS|STATUS|STRIPED|SYSTEM_USER|TABLES?|TABLESPACE|TEMP(?:ORARY|TABLE)?|TERMINATED|TEXT(?:SIZE)?|THEN|TIME(?:STAMP)?|TINY(?:BLOB|INT|TEXT)|TOP?|TRAN(?:SACTIONS?)?|TRIGGER|TRUNCATE|TSEQUAL|TYPES?|UNBOUNDED|UNCOMMITTED|UNDEFINED|UNION|UNIQUE|UNLOCK|UNPIVOT|UNSIGNED|UPDATE(?:TEXT)?|USAGE|USE|USER|USING|VALUES?|VAR(?:BINARY|CHAR|CHARACTER|YING)|VIEW|WAITFOR|WARNINGS|WHEN|WHERE|WHILE|WITH(?: ROLLUP|IN)?|WORK|WRITE(?:TEXT)?|YEAR)\\b/i,boolean:/\\b(?:FALSE|NULL|TRUE)\\b/i,number:/\\b0x[\\da-f]+\\b|\\b\\d+(?:\\.\\d*)?|\\B\\.\\d+\\b/i,operator:/[-+*\\/=%^~]|&&?|\\|\\|?|!=?|<(?:=>?|<|>)?|>[>=]?|\\b(?:AND|BETWEEN|DIV|ILIKE|IN|IS|LIKE|NOT|OR|REGEXP|RLIKE|SOUNDS LIKE|XOR)\\b/i,punctuation:/[;[\\]()`,.]/}},4793:function(){Prism.languages.swift={comment:{pattern:/(^|[^\\\\:])(?:\\/\\/.*|\\/\\*(?:[^/*]|\\/(?!\\*)|\\*(?!\\/)|\\/\\*(?:[^*]|\\*(?!\\/))*\\*\\/)*\\*\\/)/,lookbehind:!0,greedy:!0},\"string-literal\":[{pattern:RegExp(/(^|[^\"#])/.source+\"(?:\"+/\"(?:\\\\(?:\\((?:[^()]|\\([^()]*\\))*\\)|\\r\\n|[^(])|[^\\\\\\r\\n\"])*\"/.source+\"|\"+/\"\"\"(?:\\\\(?:\\((?:[^()]|\\([^()]*\\))*\\)|[^(])|[^\\\\\"]|\"(?!\"\"))*\"\"\"/.source+\")\"+/(?![\"#])/.source),lookbehind:!0,greedy:!0,inside:{interpolation:{pattern:/(\\\\\\()(?:[^()]|\\([^()]*\\))*(?=\\))/,lookbehind:!0,inside:null},\"interpolation-punctuation\":{pattern:/^\\)|\\\\\\($/,alias:\"punctuation\"},punctuation:/\\\\(?=[\\r\\n])/,string:/[\\s\\S]+/}},{pattern:RegExp(/(^|[^\"#])(#+)/.source+\"(?:\"+/\"(?:\\\\(?:#+\\((?:[^()]|\\([^()]*\\))*\\)|\\r\\n|[^#])|[^\\\\\\r\\n])*?\"/.source+\"|\"+/\"\"\"(?:\\\\(?:#+\\((?:[^()]|\\([^()]*\\))*\\)|[^#])|[^\\\\])*?\"\"\"/.source+\")\\\\2\"),lookbehind:!0,greedy:!0,inside:{interpolation:{pattern:/(\\\\#+\\()(?:[^()]|\\([^()]*\\))*(?=\\))/,lookbehind:!0,inside:null},\"interpolation-punctuation\":{pattern:/^\\)|\\\\#+\\($/,alias:\"punctuation\"},string:/[\\s\\S]+/}}],directive:{pattern:RegExp(/#/.source+\"(?:\"+/(?:elseif|if)\\b/.source+\"(?:[ \\t]*\"+/(?:![ \\t]*)?(?:\\b\\w+\\b(?:[ \\t]*\\((?:[^()]|\\([^()]*\\))*\\))?|\\((?:[^()]|\\([^()]*\\))*\\))(?:[ \\t]*(?:&&|\\|\\|))?/.source+\")+|\"+/(?:else|endif)\\b/.source+\")\"),alias:\"property\",inside:{\"directive-name\":/^#\\w+/,boolean:/\\b(?:false|true)\\b/,number:/\\b\\d+(?:\\.\\d+)*\\b/,operator:/!|&&|\\|\\||[<>]=?/,punctuation:/[(),]/}},literal:{pattern:/#(?:colorLiteral|column|dsohandle|file(?:ID|Literal|Path)?|function|imageLiteral|line)\\b/,alias:\"constant\"},\"other-directive\":{pattern:/#\\w+\\b/,alias:\"property\"},attribute:{pattern:/@\\w+/,alias:\"atrule\"},\"function-definition\":{pattern:/(\\bfunc\\s+)\\w+/,lookbehind:!0,alias:\"function\"},label:{pattern:/\\b(break|continue)\\s+\\w+|\\b[a-zA-Z_]\\w*(?=\\s*:\\s*(?:for|repeat|while)\\b)/,lookbehind:!0,alias:\"important\"},keyword:/\\b(?:Any|Protocol|Self|Type|actor|as|assignment|associatedtype|associativity|async|await|break|case|catch|class|continue|convenience|default|defer|deinit|didSet|do|dynamic|else|enum|extension|fallthrough|fileprivate|final|for|func|get|guard|higherThan|if|import|in|indirect|infix|init|inout|internal|is|isolated|lazy|left|let|lowerThan|mutating|none|nonisolated|nonmutating|open|operator|optional|override|postfix|precedencegroup|prefix|private|protocol|public|repeat|required|rethrows|return|right|safe|self|set|some|static|struct|subscript|super|switch|throw|throws|try|typealias|unowned|unsafe|var|weak|where|while|willSet)\\b/,boolean:/\\b(?:false|true)\\b/,nil:{pattern:/\\bnil\\b/,alias:\"constant\"},\"short-argument\":/\\$\\d+\\b/,omit:{pattern:/\\b_\\b/,alias:\"keyword\"},number:/\\b(?:[\\d_]+(?:\\.[\\de_]+)?|0x[a-f0-9_]+(?:\\.[a-f0-9p_]+)?|0b[01_]+|0o[0-7_]+)\\b/i,\"class-name\":/\\b[A-Z](?:[A-Z_\\d]*[a-z]\\w*)?\\b/,function:/\\b[a-z_]\\w*(?=\\s*\\()/i,constant:/\\b(?:[A-Z_]{2,}|k[A-Z][A-Za-z_]+)\\b/,operator:/[-+*/%=!<>&|^~?]+|\\.[.\\-+*/%=!<>&|^~?]+/,punctuation:/[{}[\\]();,.:\\\\]/},Prism.languages.swift[\"string-literal\"].forEach((function(e){e.inside.interpolation.inside=Prism.languages.swift}))},83:function(){!function(e){var t=/[*&][^\\s[\\]{},]+/,n=/!(?:<[\\w\\-%#;/?:@&=+$,.!~*'()[\\]]+>|(?:[a-zA-Z\\d-]*!)?[\\w\\-%#;/?:@&=+$.~*'()]+)?/,r=\"(?:\"+n.source+\"(?:[ \\t]+\"+t.source+\")?|\"+t.source+\"(?:[ \\t]+\"+n.source+\")?)\",i=/(?:[^\\s\\x00-\\x08\\x0e-\\x1f!\"#%&'*,\\-:>?@[\\]`{|}\\x7f-\\x84\\x86-\\x9f\\ud800-\\udfff\\ufffe\\uffff]|[?:-])(?:[ \\t]*(?:(?![#:])|:))*/.source.replace(//g,(function(){return/[^\\s\\x00-\\x08\\x0e-\\x1f,[\\]{}\\x7f-\\x84\\x86-\\x9f\\ud800-\\udfff\\ufffe\\uffff]/.source})),o=/\"(?:[^\"\\\\\\r\\n]|\\\\.)*\"|'(?:[^'\\\\\\r\\n]|\\\\.)*'/.source;function s(e,t){t=(t||\"\").replace(/m/g,\"\")+\"m\";var n=/([:\\-,[{]\\s*(?:\\s<>[ \\t]+)?)(?:<>)(?=[ \\t]*(?:$|,|\\]|\\}|(?:[\\r\\n]\\s*)?#))/.source.replace(/<>/g,(function(){return r})).replace(/<>/g,(function(){return e}));return RegExp(n,t)}e.languages.yaml={scalar:{pattern:RegExp(/([\\-:]\\s*(?:\\s<>[ \\t]+)?[|>])[ \\t]*(?:((?:\\r?\\n|\\r)[ \\t]+)\\S[^\\r\\n]*(?:\\2[^\\r\\n]+)*)/.source.replace(/<>/g,(function(){return r}))),lookbehind:!0,alias:\"string\"},comment:/#.*/,key:{pattern:RegExp(/((?:^|[:\\-,[{\\r\\n?])[ \\t]*(?:<>[ \\t]+)?)<>(?=\\s*:\\s)/.source.replace(/<>/g,(function(){return r})).replace(/<>/g,(function(){return\"(?:\"+i+\"|\"+o+\")\"}))),lookbehind:!0,greedy:!0,alias:\"atrule\"},directive:{pattern:/(^[ \\t]*)%.+/m,lookbehind:!0,alias:\"important\"},datetime:{pattern:s(/\\d{4}-\\d\\d?-\\d\\d?(?:[tT]|[ \\t]+)\\d\\d?:\\d{2}:\\d{2}(?:\\.\\d*)?(?:[ \\t]*(?:Z|[-+]\\d\\d?(?::\\d{2})?))?|\\d{4}-\\d{2}-\\d{2}|\\d\\d?:\\d{2}(?::\\d{2}(?:\\.\\d*)?)?/.source),lookbehind:!0,alias:\"number\"},boolean:{pattern:s(/false|true/.source,\"i\"),lookbehind:!0,alias:\"important\"},null:{pattern:s(/null|~/.source,\"i\"),lookbehind:!0,alias:\"important\"},string:{pattern:s(o),lookbehind:!0,greedy:!0},number:{pattern:s(/[+-]?(?:0x[\\da-f]+|0o[0-7]+|(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:e[+-]?\\d+)?|\\.inf|\\.nan)/.source,\"i\"),lookbehind:!0},tag:n,important:t,punctuation:/---|[:[\\]{}\\-,|>?]|\\.\\.\\./},e.languages.yml=e.languages.yaml}(Prism)},8848:function(e,t,n){var r=function(e){var t=/(?:^|\\s)lang(?:uage)?-([\\w-]+)(?=\\s|$)/i,n=0,r={},i={manual:e.Prism&&e.Prism.manual,disableWorkerMessageHandler:e.Prism&&e.Prism.disableWorkerMessageHandler,util:{encode:function e(t){return t instanceof o?new o(t.type,e(t.content),t.alias):Array.isArray(t)?t.map(e):t.replace(/&/g,\"&\").replace(/=p.reach);S+=k.value.length,k=k.next){var E=k.value;if(t.length>e.length)return;if(!(E instanceof o)){var O,_=1;if(b){if(!(O=s(w,S,e,y))||O.index>=e.length)break;var A=O.index,C=O.index+O[0].length,j=S;for(j+=k.value.length;A>=j;)j+=(k=k.next).value.length;if(S=j-=k.value.length,k.value instanceof o)continue;for(var P=k;P!==t.tail&&(jp.reach&&(p.reach=N);var $=k.prev;if(I&&($=c(t,$,I),S+=I.length),u(t,$,_),k=c(t,$,new o(d,g?i.tokenize(T,g):T,v,T)),R&&c(t,k,R),_>1){var L={cause:d+\",\"+h,reach:N};a(e,t,n,k.prev,S,L),p&&L.reach>p.reach&&(p.reach=L.reach)}}}}}}function l(){var e={value:null,prev:null,next:null},t={value:null,prev:e,next:null};e.next=t,this.head=e,this.tail=t,this.length=0}function c(e,t,n){var r=t.next,i={value:n,prev:t,next:r};return t.next=i,r.prev=i,e.length++,i}function u(e,t,n){for(var r=t.next,i=0;i\"+o.content+\"\"},!e.document)return e.addEventListener?(i.disableWorkerMessageHandler||e.addEventListener(\"message\",(function(t){var n=JSON.parse(t.data),r=n.language,o=n.code,s=n.immediateClose;e.postMessage(i.highlight(o,i.languages[r],r)),s&&e.close()}),!1),i):i;var p=i.util.currentScript();function d(){i.manual||i.highlightAll()}if(p&&(i.filename=p.src,p.hasAttribute(\"data-manual\")&&(i.manual=!0)),!i.manual){var f=document.readyState;\"loading\"===f||\"interactive\"===f&&p&&p.defer?document.addEventListener(\"DOMContentLoaded\",d):window.requestAnimationFrame?window.requestAnimationFrame(d):window.setTimeout(d,16)}return i}(\"undefined\"!=typeof window?window:\"undefined\"!=typeof WorkerGlobalScope&&self instanceof WorkerGlobalScope?self:{});e.exports&&(e.exports=r),void 0!==n.g&&(n.g.Prism=r),r.languages.markup={comment:{pattern://,greedy:!0},prolog:{pattern:/<\\?[\\s\\S]+?\\?>/,greedy:!0},doctype:{pattern:/\"'[\\]]|\"[^\"]*\"|'[^']*')+(?:\\[(?:[^<\"'\\]]|\"[^\"]*\"|'[^']*'|<(?!!--)|)*\\]\\s*)?>/i,greedy:!0,inside:{\"internal-subset\":{pattern:/(^[^\\[]*\\[)[\\s\\S]+(?=\\]>$)/,lookbehind:!0,greedy:!0,inside:null},string:{pattern:/\"[^\"]*\"|'[^']*'/,greedy:!0},punctuation:/^$|[[\\]]/,\"doctype-tag\":/^DOCTYPE/i,name:/[^\\s<>'\"]+/}},cdata:{pattern://i,greedy:!0},tag:{pattern:/<\\/?(?!\\d)[^\\s>\\/=$<%]+(?:\\s(?:\\s*[^\\s>\\/=]+(?:\\s*=\\s*(?:\"[^\"]*\"|'[^']*'|[^\\s'\">=]+(?=[\\s>]))|(?=[\\s/>])))+)?\\s*\\/?>/,greedy:!0,inside:{tag:{pattern:/^<\\/?[^\\s>\\/]+/,inside:{punctuation:/^<\\/?/,namespace:/^[^\\s>\\/:]+:/}},\"special-attr\":[],\"attr-value\":{pattern:/=\\s*(?:\"[^\"]*\"|'[^']*'|[^\\s'\">=]+)/,inside:{punctuation:[{pattern:/^=/,alias:\"attr-equals\"},{pattern:/^(\\s*)[\"']|[\"']$/,lookbehind:!0}]}},punctuation:/\\/?>/,\"attr-name\":{pattern:/[^\\s>\\/]+/,inside:{namespace:/^[^\\s>\\/:]+:/}}}},entity:[{pattern:/&[\\da-z]{1,8};/i,alias:\"named-entity\"},/&#x?[\\da-f]{1,8};/i]},r.languages.markup.tag.inside[\"attr-value\"].inside.entity=r.languages.markup.entity,r.languages.markup.doctype.inside[\"internal-subset\"].inside=r.languages.markup,r.hooks.add(\"wrap\",(function(e){\"entity\"===e.type&&(e.attributes.title=e.content.replace(/&/,\"&\"))})),Object.defineProperty(r.languages.markup.tag,\"addInlined\",{value:function(e,t){var n={};n[\"language-\"+t]={pattern:/(^$)/i,lookbehind:!0,inside:r.languages[t]},n.cdata=/^$/i;var i={\"included-cdata\":{pattern://i,inside:n}};i[\"language-\"+t]={pattern:/[\\s\\S]+/,inside:r.languages[t]};var o={};o[e]={pattern:RegExp(/(<__[^>]*>)(?:))*\\]\\]>|(?!)/.source.replace(/__/g,(function(){return e})),\"i\"),lookbehind:!0,greedy:!0,inside:i},r.languages.insertBefore(\"markup\",\"cdata\",o)}}),Object.defineProperty(r.languages.markup.tag,\"addAttribute\",{value:function(e,t){r.languages.markup.tag.inside[\"special-attr\"].push({pattern:RegExp(/(^|[\"'\\s])/.source+\"(?:\"+e+\")\"+/\\s*=\\s*(?:\"[^\"]*\"|'[^']*'|[^\\s'\">=]+(?=[\\s>]))/.source,\"i\"),lookbehind:!0,inside:{\"attr-name\":/^[^\\s=]+/,\"attr-value\":{pattern:/=[\\s\\S]+/,inside:{value:{pattern:/(^=\\s*([\"']|(?![\"'])))\\S[\\s\\S]*(?=\\2$)/,lookbehind:!0,alias:[t,\"language-\"+t],inside:r.languages[t]},punctuation:[{pattern:/^=/,alias:\"attr-equals\"},/\"|'/]}}}})}}),r.languages.html=r.languages.markup,r.languages.mathml=r.languages.markup,r.languages.svg=r.languages.markup,r.languages.xml=r.languages.extend(\"markup\",{}),r.languages.ssml=r.languages.xml,r.languages.atom=r.languages.xml,r.languages.rss=r.languages.xml,function(e){var t=/(?:\"(?:\\\\(?:\\r\\n|[\\s\\S])|[^\"\\\\\\r\\n])*\"|'(?:\\\\(?:\\r\\n|[\\s\\S])|[^'\\\\\\r\\n])*')/;e.languages.css={comment:/\\/\\*[\\s\\S]*?\\*\\//,atrule:{pattern:RegExp(\"@[\\\\w-](?:\"+/[^;{\\s\"']|\\s+(?!\\s)/.source+\"|\"+t.source+\")*?\"+/(?:;|(?=\\s*\\{))/.source),inside:{rule:/^@[\\w-]+/,\"selector-function-argument\":{pattern:/(\\bselector\\s*\\(\\s*(?![\\s)]))(?:[^()\\s]|\\s+(?![\\s)])|\\((?:[^()]|\\([^()]*\\))*\\))+(?=\\s*\\))/,lookbehind:!0,alias:\"selector\"},keyword:{pattern:/(^|[^\\w-])(?:and|not|only|or)(?![\\w-])/,lookbehind:!0}}},url:{pattern:RegExp(\"\\\\burl\\\\((?:\"+t.source+\"|\"+/(?:[^\\\\\\r\\n()\"']|\\\\[\\s\\S])*/.source+\")\\\\)\",\"i\"),greedy:!0,inside:{function:/^url/i,punctuation:/^\\(|\\)$/,string:{pattern:RegExp(\"^\"+t.source+\"$\"),alias:\"url\"}}},selector:{pattern:RegExp(\"(^|[{}\\\\s])[^{}\\\\s](?:[^{};\\\"'\\\\s]|\\\\s+(?![\\\\s{])|\"+t.source+\")*(?=\\\\s*\\\\{)\"),lookbehind:!0},string:{pattern:t,greedy:!0},property:{pattern:/(^|[^-\\w\\xA0-\\uFFFF])(?!\\s)[-_a-z\\xA0-\\uFFFF](?:(?!\\s)[-\\w\\xA0-\\uFFFF])*(?=\\s*:)/i,lookbehind:!0},important:/!important\\b/i,function:{pattern:/(^|[^-a-z0-9])[-a-z0-9]+(?=\\()/i,lookbehind:!0},punctuation:/[(){};:,]/},e.languages.css.atrule.inside.rest=e.languages.css;var n=e.languages.markup;n&&(n.tag.addInlined(\"style\",\"css\"),n.tag.addAttribute(\"style\",\"css\"))}(r),r.languages.clike={comment:[{pattern:/(^|[^\\\\])\\/\\*[\\s\\S]*?(?:\\*\\/|$)/,lookbehind:!0,greedy:!0},{pattern:/(^|[^\\\\:])\\/\\/.*/,lookbehind:!0,greedy:!0}],string:{pattern:/([\"'])(?:\\\\(?:\\r\\n|[\\s\\S])|(?!\\1)[^\\\\\\r\\n])*\\1/,greedy:!0},\"class-name\":{pattern:/(\\b(?:class|extends|implements|instanceof|interface|new|trait)\\s+|\\bcatch\\s+\\()[\\w.\\\\]+/i,lookbehind:!0,inside:{punctuation:/[.\\\\]/}},keyword:/\\b(?:break|catch|continue|do|else|finally|for|function|if|in|instanceof|new|null|return|throw|try|while)\\b/,boolean:/\\b(?:false|true)\\b/,function:/\\b\\w+(?=\\()/,number:/\\b0x[\\da-f]+\\b|(?:\\b\\d+(?:\\.\\d*)?|\\B\\.\\d+)(?:e[+-]?\\d+)?/i,operator:/[<>]=?|[!=]=?=?|--?|\\+\\+?|&&?|\\|\\|?|[?*/~^%]/,punctuation:/[{}[\\];(),.:]/},r.languages.javascript=r.languages.extend(\"clike\",{\"class-name\":[r.languages.clike[\"class-name\"],{pattern:/(^|[^$\\w\\xA0-\\uFFFF])(?!\\s)[_$A-Z\\xA0-\\uFFFF](?:(?!\\s)[$\\w\\xA0-\\uFFFF])*(?=\\.(?:constructor|prototype))/,lookbehind:!0}],keyword:[{pattern:/((?:^|\\})\\s*)catch\\b/,lookbehind:!0},{pattern:/(^|[^.]|\\.\\.\\.\\s*)\\b(?:as|assert(?=\\s*\\{)|async(?=\\s*(?:function\\b|\\(|[$\\w\\xA0-\\uFFFF]|$))|await|break|case|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally(?=\\s*(?:\\{|$))|for|from(?=\\s*(?:['\"]|$))|function|(?:get|set)(?=\\s*(?:[#\\[$\\w\\xA0-\\uFFFF]|$))|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|static|super|switch|this|throw|try|typeof|undefined|var|void|while|with|yield)\\b/,lookbehind:!0}],function:/#?(?!\\s)[_$a-zA-Z\\xA0-\\uFFFF](?:(?!\\s)[$\\w\\xA0-\\uFFFF])*(?=\\s*(?:\\.\\s*(?:apply|bind|call)\\s*)?\\()/,number:{pattern:RegExp(/(^|[^\\w$])/.source+\"(?:\"+/NaN|Infinity/.source+\"|\"+/0[bB][01]+(?:_[01]+)*n?/.source+\"|\"+/0[oO][0-7]+(?:_[0-7]+)*n?/.source+\"|\"+/0[xX][\\dA-Fa-f]+(?:_[\\dA-Fa-f]+)*n?/.source+\"|\"+/\\d+(?:_\\d+)*n/.source+\"|\"+/(?:\\d+(?:_\\d+)*(?:\\.(?:\\d+(?:_\\d+)*)?)?|\\.\\d+(?:_\\d+)*)(?:[Ee][+-]?\\d+(?:_\\d+)*)?/.source+\")\"+/(?![\\w$])/.source),lookbehind:!0},operator:/--|\\+\\+|\\*\\*=?|=>|&&=?|\\|\\|=?|[!=]==|<<=?|>>>?=?|[-+*/%&|^!=<>]=?|\\.{3}|\\?\\?=?|\\?\\.?|[~:]/}),r.languages.javascript[\"class-name\"][0].pattern=/(\\b(?:class|extends|implements|instanceof|interface|new)\\s+)[\\w.\\\\]+/,r.languages.insertBefore(\"javascript\",\"keyword\",{regex:{pattern:RegExp(/((?:^|[^$\\w\\xA0-\\uFFFF.\"'\\])\\s]|\\b(?:return|yield))\\s*)/.source+/\\//.source+\"(?:\"+/(?:\\[(?:[^\\]\\\\\\r\\n]|\\\\.)*\\]|\\\\.|[^/\\\\\\[\\r\\n])+\\/[dgimyus]{0,7}/.source+\"|\"+/(?:\\[(?:[^[\\]\\\\\\r\\n]|\\\\.|\\[(?:[^[\\]\\\\\\r\\n]|\\\\.|\\[(?:[^[\\]\\\\\\r\\n]|\\\\.)*\\])*\\])*\\]|\\\\.|[^/\\\\\\[\\r\\n])+\\/[dgimyus]{0,7}v[dgimyus]{0,7}/.source+\")\"+/(?=(?:\\s|\\/\\*(?:[^*]|\\*(?!\\/))*\\*\\/)*(?:$|[\\r\\n,.;:})\\]]|\\/\\/))/.source),lookbehind:!0,greedy:!0,inside:{\"regex-source\":{pattern:/^(\\/)[\\s\\S]+(?=\\/[a-z]*$)/,lookbehind:!0,alias:\"language-regex\",inside:r.languages.regex},\"regex-delimiter\":/^\\/|\\/$/,\"regex-flags\":/^[a-z]+$/}},\"function-variable\":{pattern:/#?(?!\\s)[_$a-zA-Z\\xA0-\\uFFFF](?:(?!\\s)[$\\w\\xA0-\\uFFFF])*(?=\\s*[=:]\\s*(?:async\\s*)?(?:\\bfunction\\b|(?:\\((?:[^()]|\\([^()]*\\))*\\)|(?!\\s)[_$a-zA-Z\\xA0-\\uFFFF](?:(?!\\s)[$\\w\\xA0-\\uFFFF])*)\\s*=>))/,alias:\"function\"},parameter:[{pattern:/(function(?:\\s+(?!\\s)[_$a-zA-Z\\xA0-\\uFFFF](?:(?!\\s)[$\\w\\xA0-\\uFFFF])*)?\\s*\\(\\s*)(?!\\s)(?:[^()\\s]|\\s+(?![\\s)])|\\([^()]*\\))+(?=\\s*\\))/,lookbehind:!0,inside:r.languages.javascript},{pattern:/(^|[^$\\w\\xA0-\\uFFFF])(?!\\s)[_$a-z\\xA0-\\uFFFF](?:(?!\\s)[$\\w\\xA0-\\uFFFF])*(?=\\s*=>)/i,lookbehind:!0,inside:r.languages.javascript},{pattern:/(\\(\\s*)(?!\\s)(?:[^()\\s]|\\s+(?![\\s)])|\\([^()]*\\))+(?=\\s*\\)\\s*=>)/,lookbehind:!0,inside:r.languages.javascript},{pattern:/((?:\\b|\\s|^)(?!(?:as|async|await|break|case|catch|class|const|continue|debugger|default|delete|do|else|enum|export|extends|finally|for|from|function|get|if|implements|import|in|instanceof|interface|let|new|null|of|package|private|protected|public|return|set|static|super|switch|this|throw|try|typeof|undefined|var|void|while|with|yield)(?![$\\w\\xA0-\\uFFFF]))(?:(?!\\s)[_$a-zA-Z\\xA0-\\uFFFF](?:(?!\\s)[$\\w\\xA0-\\uFFFF])*\\s*)\\(\\s*|\\]\\s*\\(\\s*)(?!\\s)(?:[^()\\s]|\\s+(?![\\s)])|\\([^()]*\\))+(?=\\s*\\)\\s*\\{)/,lookbehind:!0,inside:r.languages.javascript}],constant:/\\b[A-Z](?:[A-Z_]|\\dx?)*\\b/}),r.languages.insertBefore(\"javascript\",\"string\",{hashbang:{pattern:/^#!.*/,greedy:!0,alias:\"comment\"},\"template-string\":{pattern:/`(?:\\\\[\\s\\S]|\\$\\{(?:[^{}]|\\{(?:[^{}]|\\{[^}]*\\})*\\})+\\}|(?!\\$\\{)[^\\\\`])*`/,greedy:!0,inside:{\"template-punctuation\":{pattern:/^`|`$/,alias:\"string\"},interpolation:{pattern:/((?:^|[^\\\\])(?:\\\\{2})*)\\$\\{(?:[^{}]|\\{(?:[^{}]|\\{[^}]*\\})*\\})+\\}/,lookbehind:!0,inside:{\"interpolation-punctuation\":{pattern:/^\\$\\{|\\}$/,alias:\"punctuation\"},rest:r.languages.javascript}},string:/[\\s\\S]+/}},\"string-property\":{pattern:/((?:^|[,{])[ \\t]*)([\"'])(?:\\\\(?:\\r\\n|[\\s\\S])|(?!\\2)[^\\\\\\r\\n])*\\2(?=\\s*:)/m,lookbehind:!0,greedy:!0,alias:\"property\"}}),r.languages.insertBefore(\"javascript\",\"operator\",{\"literal-property\":{pattern:/((?:^|[,{])[ \\t]*)(?!\\s)[_$a-zA-Z\\xA0-\\uFFFF](?:(?!\\s)[$\\w\\xA0-\\uFFFF])*(?=\\s*:)/m,lookbehind:!0,alias:\"property\"}}),r.languages.markup&&(r.languages.markup.tag.addInlined(\"script\",\"javascript\"),r.languages.markup.tag.addAttribute(/on(?:abort|blur|change|click|composition(?:end|start|update)|dblclick|error|focus(?:in|out)?|key(?:down|up)|load|mouse(?:down|enter|leave|move|out|over|up)|reset|resize|scroll|select|slotchange|submit|unload|wheel)/.source,\"javascript\")),r.languages.js=r.languages.javascript,function(){if(void 0!==r&&\"undefined\"!=typeof document){Element.prototype.matches||(Element.prototype.matches=Element.prototype.msMatchesSelector||Element.prototype.webkitMatchesSelector);var e={js:\"javascript\",py:\"python\",rb:\"ruby\",ps1:\"powershell\",psm1:\"powershell\",sh:\"bash\",bat:\"batch\",h:\"c\",tex:\"latex\"},t=\"data-src-status\",n=\"loading\",i=\"loaded\",o=\"pre[data-src]:not([\"+t+'=\"'+i+'\"]):not(['+t+'=\"'+n+'\"])';r.hooks.add(\"before-highlightall\",(function(e){e.selector+=\", \"+o})),r.hooks.add(\"before-sanity-check\",(function(s){var a=s.element;if(a.matches(o)){s.code=\"\",a.setAttribute(t,n);var l=a.appendChild(document.createElement(\"CODE\"));l.textContent=\"Loading…\";var c=a.getAttribute(\"data-src\"),u=s.language;if(\"none\"===u){var p=(/\\.(\\w+)$/.exec(c)||[,\"none\"])[1];u=e[p]||p}r.util.setLanguage(l,u),r.util.setLanguage(a,u);var d=r.plugins.autoloader;d&&d.loadLanguages(u),function(e,n,o){var s=new XMLHttpRequest;s.open(\"GET\",e,!0),s.onreadystatechange=function(){4==s.readyState&&(s.status<400&&s.responseText?function(e){a.setAttribute(t,i);var n=function(e){var t=/^\\s*(\\d+)\\s*(?:(,)\\s*(?:(\\d+)\\s*)?)?$/.exec(e||\"\");if(t){var n=Number(t[1]),r=t[2],i=t[3];return r?i?[n,Number(i)]:[n,void 0]:[n,n]}}(a.getAttribute(\"data-range\"));if(n){var o=e.split(/\\r\\n?|\\n/g),s=n[0],c=null==n[1]?o.length:n[1];s<0&&(s+=o.length),s=Math.max(0,Math.min(s-1,o.length)),c<0&&(c+=o.length),c=Math.max(0,Math.min(c,o.length)),e=o.slice(s,c).join(\"\\n\"),a.hasAttribute(\"data-start\")||a.setAttribute(\"data-start\",String(s+1))}l.textContent=e,r.highlightElement(l)}(s.responseText):s.status>=400?o(\"✖ Error \"+s.status+\" while fetching file: \"+s.statusText):o(\"✖ Error: File does not exist or is empty\"))},s.send(null)}(c,0,(function(e){a.setAttribute(t,\"failed\"),l.textContent=e}))}})),r.plugins.fileHighlight={highlight:function(e){for(var t,n=(e||document).querySelectorAll(o),i=0;t=n[i++];)r.highlightElement(t)}};var s=!1;r.fileHighlight=function(){s||(console.warn(\"Prism.fileHighlight is deprecated. Use `Prism.plugins.fileHighlight.highlight` instead.\"),s=!0),r.plugins.fileHighlight.highlight.apply(this,arguments)}}}()},2694:function(e,t,n){\"use strict\";var r=n(6925);function i(){}function o(){}o.resetWarningCache=i,e.exports=function(){function e(e,t,n,i,o,s){if(s!==r){var a=new Error(\"Calling PropTypes validators directly is not supported by the `prop-types` package. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types\");throw a.name=\"Invariant Violation\",a}}function t(){return e}e.isRequired=e;var n={array:e,bigint:e,bool:e,func:e,number:e,object:e,string:e,symbol:e,any:e,arrayOf:t,element:e,elementType:e,instanceOf:t,node:e,objectOf:t,oneOf:t,oneOfType:t,shape:t,exact:t,checkPropTypes:o,resetWarningCache:i};return n.PropTypes=n,n}},5556:function(e,t,n){e.exports=n(2694)()},6925:function(e){\"use strict\";e.exports=\"SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED\"},2551:function(e,t,n){\"use strict\";var r=n(6540),i=n(194);function o(e){for(var t=\"https://reactjs.org/docs/error-decoder.html?invariant=\"+e,n=1;nt}return!1}(t,n,i,r)&&(n=null),r||null===i?function(e){return!!p.call(h,e)||!p.call(f,e)&&(d.test(e)?h[e]=!0:(f[e]=!0,!1))}(t)&&(null===n?e.removeAttribute(t):e.setAttribute(t,\"\"+n)):i.mustUseProperty?e[i.propertyName]=null===n?3!==i.type&&\"\":n:(t=i.attributeName,r=i.attributeNamespace,null===n?e.removeAttribute(t):(n=3===(i=i.type)||4===i&&!0===n?\"\":\"\"+n,r?e.setAttributeNS(r,t,n):e.setAttribute(t,n))))}\"accent-height alignment-baseline arabic-form baseline-shift cap-height clip-path clip-rule color-interpolation color-interpolation-filters color-profile color-rendering dominant-baseline enable-background fill-opacity fill-rule flood-color flood-opacity font-family font-size font-size-adjust font-stretch font-style font-variant font-weight glyph-name glyph-orientation-horizontal glyph-orientation-vertical horiz-adv-x horiz-origin-x image-rendering letter-spacing lighting-color marker-end marker-mid marker-start overline-position overline-thickness paint-order panose-1 pointer-events rendering-intent shape-rendering stop-color stop-opacity strikethrough-position strikethrough-thickness stroke-dasharray stroke-dashoffset stroke-linecap stroke-linejoin stroke-miterlimit stroke-opacity stroke-width text-anchor text-decoration text-rendering underline-position underline-thickness unicode-bidi unicode-range units-per-em v-alphabetic v-hanging v-ideographic v-mathematical vector-effect vert-adv-y vert-origin-x vert-origin-y word-spacing writing-mode xmlns:xlink x-height\".split(\" \").forEach((function(e){var t=e.replace(y,b);g[t]=new m(t,1,!1,e,null,!1,!1)})),\"xlink:actuate xlink:arcrole xlink:role xlink:show xlink:title xlink:type\".split(\" \").forEach((function(e){var t=e.replace(y,b);g[t]=new m(t,1,!1,e,\"http://www.w3.org/1999/xlink\",!1,!1)})),[\"xml:base\",\"xml:lang\",\"xml:space\"].forEach((function(e){var t=e.replace(y,b);g[t]=new m(t,1,!1,e,\"http://www.w3.org/XML/1998/namespace\",!1,!1)})),[\"tabIndex\",\"crossOrigin\"].forEach((function(e){g[e]=new m(e,1,!1,e.toLowerCase(),null,!1,!1)})),g.xlinkHref=new m(\"xlinkHref\",1,!1,\"xlink:href\",\"http://www.w3.org/1999/xlink\",!0,!1),[\"src\",\"href\",\"action\",\"formAction\"].forEach((function(e){g[e]=new m(e,1,!1,e.toLowerCase(),null,!0,!0)}));var x=r.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED,w=Symbol.for(\"react.element\"),k=Symbol.for(\"react.portal\"),S=Symbol.for(\"react.fragment\"),E=Symbol.for(\"react.strict_mode\"),O=Symbol.for(\"react.profiler\"),_=Symbol.for(\"react.provider\"),A=Symbol.for(\"react.context\"),C=Symbol.for(\"react.forward_ref\"),j=Symbol.for(\"react.suspense\"),P=Symbol.for(\"react.suspense_list\"),T=Symbol.for(\"react.memo\"),I=Symbol.for(\"react.lazy\");Symbol.for(\"react.scope\"),Symbol.for(\"react.debug_trace_mode\");var R=Symbol.for(\"react.offscreen\");Symbol.for(\"react.legacy_hidden\"),Symbol.for(\"react.cache\"),Symbol.for(\"react.tracing_marker\");var N=Symbol.iterator;function $(e){return null===e||\"object\"!=typeof e?null:\"function\"==typeof(e=N&&e[N]||e[\"@@iterator\"])?e:null}var L,D=Object.assign;function M(e){if(void 0===L)try{throw Error()}catch(e){var t=e.stack.trim().match(/\\n( *(at )?)/);L=t&&t[1]||\"\"}return\"\\n\"+L+e}var F=!1;function z(e,t){if(!e||F)return\"\";F=!0;var n=Error.prepareStackTrace;Error.prepareStackTrace=void 0;try{if(t)if(t=function(){throw Error()},Object.defineProperty(t.prototype,\"props\",{set:function(){throw Error()}}),\"object\"==typeof Reflect&&Reflect.construct){try{Reflect.construct(t,[])}catch(e){var r=e}Reflect.construct(e,[],t)}else{try{t.call()}catch(e){r=e}e.call(t.prototype)}else{try{throw Error()}catch(e){r=e}e()}}catch(t){if(t&&r&&\"string\"==typeof t.stack){for(var i=t.stack.split(\"\\n\"),o=r.stack.split(\"\\n\"),s=i.length-1,a=o.length-1;1<=s&&0<=a&&i[s]!==o[a];)a--;for(;1<=s&&0<=a;s--,a--)if(i[s]!==o[a]){if(1!==s||1!==a)do{if(s--,0>--a||i[s]!==o[a]){var l=\"\\n\"+i[s].replace(\" at new \",\" at \");return e.displayName&&l.includes(\"\")&&(l=l.replace(\"\",e.displayName)),l}}while(1<=s&&0<=a);break}}}finally{F=!1,Error.prepareStackTrace=n}return(e=e?e.displayName||e.name:\"\")?M(e):\"\"}function B(e){switch(e.tag){case 5:return M(e.type);case 16:return M(\"Lazy\");case 13:return M(\"Suspense\");case 19:return M(\"SuspenseList\");case 0:case 2:case 15:return z(e.type,!1);case 11:return z(e.type.render,!1);case 1:return z(e.type,!0);default:return\"\"}}function U(e){if(null==e)return null;if(\"function\"==typeof e)return e.displayName||e.name||null;if(\"string\"==typeof e)return e;switch(e){case S:return\"Fragment\";case k:return\"Portal\";case O:return\"Profiler\";case E:return\"StrictMode\";case j:return\"Suspense\";case P:return\"SuspenseList\"}if(\"object\"==typeof e)switch(e.$$typeof){case A:return(e.displayName||\"Context\")+\".Consumer\";case _:return(e._context.displayName||\"Context\")+\".Provider\";case C:var t=e.render;return(e=e.displayName)||(e=\"\"!==(e=t.displayName||t.name||\"\")?\"ForwardRef(\"+e+\")\":\"ForwardRef\"),e;case T:return null!==(t=e.displayName||null)?t:U(e.type)||\"Memo\";case I:t=e._payload,e=e._init;try{return U(e(t))}catch(e){}}return null}function q(e){var t=e.type;switch(e.tag){case 24:return\"Cache\";case 9:return(t.displayName||\"Context\")+\".Consumer\";case 10:return(t._context.displayName||\"Context\")+\".Provider\";case 18:return\"DehydratedFragment\";case 11:return e=(e=t.render).displayName||e.name||\"\",t.displayName||(\"\"!==e?\"ForwardRef(\"+e+\")\":\"ForwardRef\");case 7:return\"Fragment\";case 5:return t;case 4:return\"Portal\";case 3:return\"Root\";case 6:return\"Text\";case 16:return U(t);case 8:return t===E?\"StrictMode\":\"Mode\";case 22:return\"Offscreen\";case 12:return\"Profiler\";case 21:return\"Scope\";case 13:return\"Suspense\";case 19:return\"SuspenseList\";case 25:return\"TracingMarker\";case 1:case 0:case 17:case 2:case 14:case 15:if(\"function\"==typeof t)return t.displayName||t.name||null;if(\"string\"==typeof t)return t}return null}function V(e){switch(typeof e){case\"boolean\":case\"number\":case\"string\":case\"undefined\":case\"object\":return e;default:return\"\"}}function W(e){var t=e.type;return(e=e.nodeName)&&\"input\"===e.toLowerCase()&&(\"checkbox\"===t||\"radio\"===t)}function H(e){e._valueTracker||(e._valueTracker=function(e){var t=W(e)?\"checked\":\"value\",n=Object.getOwnPropertyDescriptor(e.constructor.prototype,t),r=\"\"+e[t];if(!e.hasOwnProperty(t)&&void 0!==n&&\"function\"==typeof n.get&&\"function\"==typeof n.set){var i=n.get,o=n.set;return Object.defineProperty(e,t,{configurable:!0,get:function(){return i.call(this)},set:function(e){r=\"\"+e,o.call(this,e)}}),Object.defineProperty(e,t,{enumerable:n.enumerable}),{getValue:function(){return r},setValue:function(e){r=\"\"+e},stopTracking:function(){e._valueTracker=null,delete e[t]}}}}(e))}function Y(e){if(!e)return!1;var t=e._valueTracker;if(!t)return!0;var n=t.getValue(),r=\"\";return e&&(r=W(e)?e.checked?\"true\":\"false\":e.value),(e=r)!==n&&(t.setValue(e),!0)}function G(e){if(void 0===(e=e||(\"undefined\"!=typeof document?document:void 0)))return null;try{return e.activeElement||e.body}catch(t){return e.body}}function Q(e,t){var n=t.checked;return D({},t,{defaultChecked:void 0,defaultValue:void 0,value:void 0,checked:null!=n?n:e._wrapperState.initialChecked})}function X(e,t){var n=null==t.defaultValue?\"\":t.defaultValue,r=null!=t.checked?t.checked:t.defaultChecked;n=V(null!=t.value?t.value:n),e._wrapperState={initialChecked:r,initialValue:n,controlled:\"checkbox\"===t.type||\"radio\"===t.type?null!=t.checked:null!=t.value}}function K(e,t){null!=(t=t.checked)&&v(e,\"checked\",t,!1)}function Z(e,t){K(e,t);var n=V(t.value),r=t.type;if(null!=n)\"number\"===r?(0===n&&\"\"===e.value||e.value!=n)&&(e.value=\"\"+n):e.value!==\"\"+n&&(e.value=\"\"+n);else if(\"submit\"===r||\"reset\"===r)return void e.removeAttribute(\"value\");t.hasOwnProperty(\"value\")?ee(e,t.type,n):t.hasOwnProperty(\"defaultValue\")&&ee(e,t.type,V(t.defaultValue)),null==t.checked&&null!=t.defaultChecked&&(e.defaultChecked=!!t.defaultChecked)}function J(e,t,n){if(t.hasOwnProperty(\"value\")||t.hasOwnProperty(\"defaultValue\")){var r=t.type;if(!(\"submit\"!==r&&\"reset\"!==r||void 0!==t.value&&null!==t.value))return;t=\"\"+e._wrapperState.initialValue,n||t===e.value||(e.value=t),e.defaultValue=t}\"\"!==(n=e.name)&&(e.name=\"\"),e.defaultChecked=!!e._wrapperState.initialChecked,\"\"!==n&&(e.name=n)}function ee(e,t,n){\"number\"===t&&G(e.ownerDocument)===e||(null==n?e.defaultValue=\"\"+e._wrapperState.initialValue:e.defaultValue!==\"\"+n&&(e.defaultValue=\"\"+n))}var te=Array.isArray;function ne(e,t,n,r){if(e=e.options,t){t={};for(var i=0;i\"+t.valueOf().toString()+\"\",t=ce.firstChild;e.firstChild;)e.removeChild(e.firstChild);for(;t.firstChild;)e.appendChild(t.firstChild)}},\"undefined\"!=typeof MSApp&&MSApp.execUnsafeLocalFunction?function(e,t,n,r){MSApp.execUnsafeLocalFunction((function(){return ue(e,t)}))}:ue);function de(e,t){if(t){var n=e.firstChild;if(n&&n===e.lastChild&&3===n.nodeType)return void(n.nodeValue=t)}e.textContent=t}var fe={animationIterationCount:!0,aspectRatio:!0,borderImageOutset:!0,borderImageSlice:!0,borderImageWidth:!0,boxFlex:!0,boxFlexGroup:!0,boxOrdinalGroup:!0,columnCount:!0,columns:!0,flex:!0,flexGrow:!0,flexPositive:!0,flexShrink:!0,flexNegative:!0,flexOrder:!0,gridArea:!0,gridRow:!0,gridRowEnd:!0,gridRowSpan:!0,gridRowStart:!0,gridColumn:!0,gridColumnEnd:!0,gridColumnSpan:!0,gridColumnStart:!0,fontWeight:!0,lineClamp:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,tabSize:!0,widows:!0,zIndex:!0,zoom:!0,fillOpacity:!0,floodOpacity:!0,stopOpacity:!0,strokeDasharray:!0,strokeDashoffset:!0,strokeMiterlimit:!0,strokeOpacity:!0,strokeWidth:!0},he=[\"Webkit\",\"ms\",\"Moz\",\"O\"];function me(e,t,n){return null==t||\"boolean\"==typeof t||\"\"===t?\"\":n||\"number\"!=typeof t||0===t||fe.hasOwnProperty(e)&&fe[e]?(\"\"+t).trim():t+\"px\"}function ge(e,t){for(var n in e=e.style,t)if(t.hasOwnProperty(n)){var r=0===n.indexOf(\"--\"),i=me(n,t[n],r);\"float\"===n&&(n=\"cssFloat\"),r?e.setProperty(n,i):e[n]=i}}Object.keys(fe).forEach((function(e){he.forEach((function(t){t=t+e.charAt(0).toUpperCase()+e.substring(1),fe[t]=fe[e]}))}));var ye=D({menuitem:!0},{area:!0,base:!0,br:!0,col:!0,embed:!0,hr:!0,img:!0,input:!0,keygen:!0,link:!0,meta:!0,param:!0,source:!0,track:!0,wbr:!0});function be(e,t){if(t){if(ye[e]&&(null!=t.children||null!=t.dangerouslySetInnerHTML))throw Error(o(137,e));if(null!=t.dangerouslySetInnerHTML){if(null!=t.children)throw Error(o(60));if(\"object\"!=typeof t.dangerouslySetInnerHTML||!(\"__html\"in t.dangerouslySetInnerHTML))throw Error(o(61))}if(null!=t.style&&\"object\"!=typeof t.style)throw Error(o(62))}}function ve(e,t){if(-1===e.indexOf(\"-\"))return\"string\"==typeof t.is;switch(e){case\"annotation-xml\":case\"color-profile\":case\"font-face\":case\"font-face-src\":case\"font-face-uri\":case\"font-face-format\":case\"font-face-name\":case\"missing-glyph\":return!1;default:return!0}}var xe=null;function we(e){return(e=e.target||e.srcElement||window).correspondingUseElement&&(e=e.correspondingUseElement),3===e.nodeType?e.parentNode:e}var ke=null,Se=null,Ee=null;function Oe(e){if(e=vi(e)){if(\"function\"!=typeof ke)throw Error(o(280));var t=e.stateNode;t&&(t=wi(t),ke(e.stateNode,e.type,t))}}function _e(e){Se?Ee?Ee.push(e):Ee=[e]:Se=e}function Ae(){if(Se){var e=Se,t=Ee;if(Ee=Se=null,Oe(e),t)for(e=0;e>>=0)?32:31-(at(e)/lt|0)|0},at=Math.log,lt=Math.LN2,ct=64,ut=4194304;function pt(e){switch(e&-e){case 1:return 1;case 2:return 2;case 4:return 4;case 8:return 8;case 16:return 16;case 32:return 32;case 64:case 128:case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:case 262144:case 524288:case 1048576:case 2097152:return 4194240&e;case 4194304:case 8388608:case 16777216:case 33554432:case 67108864:return 130023424&e;case 134217728:return 134217728;case 268435456:return 268435456;case 536870912:return 536870912;case 1073741824:return 1073741824;default:return e}}function dt(e,t){var n=e.pendingLanes;if(0===n)return 0;var r=0,i=e.suspendedLanes,o=e.pingedLanes,s=268435455&n;if(0!==s){var a=s&~i;0!==a?r=pt(a):0!=(o&=s)&&(r=pt(o))}else 0!=(s=n&~i)?r=pt(s):0!==o&&(r=pt(o));if(0===r)return 0;if(0!==t&&t!==r&&!(t&i)&&((i=r&-r)>=(o=t&-t)||16===i&&4194240&o))return t;if(4&r&&(r|=16&n),0!==(t=e.entangledLanes))for(e=e.entanglements,t&=r;0n;n++)t.push(e);return t}function yt(e,t,n){e.pendingLanes|=t,536870912!==t&&(e.suspendedLanes=0,e.pingedLanes=0),(e=e.eventTimes)[t=31-st(t)]=n}function bt(e,t){var n=e.entangledLanes|=t;for(e=e.entanglements;n;){var r=31-st(n),i=1<=$n),Mn=String.fromCharCode(32),Fn=!1;function zn(e,t){switch(e){case\"keyup\":return-1!==Rn.indexOf(t.keyCode);case\"keydown\":return 229!==t.keyCode;case\"keypress\":case\"mousedown\":case\"focusout\":return!0;default:return!1}}function Bn(e){return\"object\"==typeof(e=e.detail)&&\"data\"in e?e.data:null}var Un=!1,qn={color:!0,date:!0,datetime:!0,\"datetime-local\":!0,email:!0,month:!0,number:!0,password:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0};function Vn(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return\"input\"===t?!!qn[e.type]:\"textarea\"===t}function Wn(e,t,n,r){_e(r),0<(t=Hr(t,\"onChange\")).length&&(n=new un(\"onChange\",\"change\",null,n,r),e.push({event:n,listeners:t}))}var Hn=null,Yn=null;function Gn(e){Mr(e,0)}function Qn(e){if(Y(xi(e)))return e}function Xn(e,t){if(\"change\"===e)return t}var Kn=!1;if(u){var Zn;if(u){var Jn=\"oninput\"in document;if(!Jn){var er=document.createElement(\"div\");er.setAttribute(\"oninput\",\"return;\"),Jn=\"function\"==typeof er.oninput}Zn=Jn}else Zn=!1;Kn=Zn&&(!document.documentMode||9=t)return{node:r,offset:t-e};e=n}e:{for(;r;){if(r.nextSibling){r=r.nextSibling;break e}r=r.parentNode}r=void 0}r=cr(r)}}function pr(e,t){return!(!e||!t)&&(e===t||(!e||3!==e.nodeType)&&(t&&3===t.nodeType?pr(e,t.parentNode):\"contains\"in e?e.contains(t):!!e.compareDocumentPosition&&!!(16&e.compareDocumentPosition(t))))}function dr(){for(var e=window,t=G();t instanceof e.HTMLIFrameElement;){try{var n=\"string\"==typeof t.contentWindow.location.href}catch(e){n=!1}if(!n)break;t=G((e=t.contentWindow).document)}return t}function fr(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return t&&(\"input\"===t&&(\"text\"===e.type||\"search\"===e.type||\"tel\"===e.type||\"url\"===e.type||\"password\"===e.type)||\"textarea\"===t||\"true\"===e.contentEditable)}function hr(e){var t=dr(),n=e.focusedElem,r=e.selectionRange;if(t!==n&&n&&n.ownerDocument&&pr(n.ownerDocument.documentElement,n)){if(null!==r&&fr(n))if(t=r.start,void 0===(e=r.end)&&(e=t),\"selectionStart\"in n)n.selectionStart=t,n.selectionEnd=Math.min(e,n.value.length);else if((e=(t=n.ownerDocument||document)&&t.defaultView||window).getSelection){e=e.getSelection();var i=n.textContent.length,o=Math.min(r.start,i);r=void 0===r.end?o:Math.min(r.end,i),!e.extend&&o>r&&(i=r,r=o,o=i),i=ur(n,o);var s=ur(n,r);i&&s&&(1!==e.rangeCount||e.anchorNode!==i.node||e.anchorOffset!==i.offset||e.focusNode!==s.node||e.focusOffset!==s.offset)&&((t=t.createRange()).setStart(i.node,i.offset),e.removeAllRanges(),o>r?(e.addRange(t),e.extend(s.node,s.offset)):(t.setEnd(s.node,s.offset),e.addRange(t)))}for(t=[],e=n;e=e.parentNode;)1===e.nodeType&&t.push({element:e,left:e.scrollLeft,top:e.scrollTop});for(\"function\"==typeof n.focus&&n.focus(),n=0;n=document.documentMode,gr=null,yr=null,br=null,vr=!1;function xr(e,t,n){var r=n.window===n?n.document:9===n.nodeType?n:n.ownerDocument;vr||null==gr||gr!==G(r)||(r=\"selectionStart\"in(r=gr)&&fr(r)?{start:r.selectionStart,end:r.selectionEnd}:{anchorNode:(r=(r.ownerDocument&&r.ownerDocument.defaultView||window).getSelection()).anchorNode,anchorOffset:r.anchorOffset,focusNode:r.focusNode,focusOffset:r.focusOffset},br&&lr(br,r)||(br=r,0<(r=Hr(yr,\"onSelect\")).length&&(t=new un(\"onSelect\",\"select\",null,t,n),e.push({event:t,listeners:r}),t.target=gr)))}function wr(e,t){var n={};return n[e.toLowerCase()]=t.toLowerCase(),n[\"Webkit\"+e]=\"webkit\"+t,n[\"Moz\"+e]=\"moz\"+t,n}var kr={animationend:wr(\"Animation\",\"AnimationEnd\"),animationiteration:wr(\"Animation\",\"AnimationIteration\"),animationstart:wr(\"Animation\",\"AnimationStart\"),transitionend:wr(\"Transition\",\"TransitionEnd\")},Sr={},Er={};function Or(e){if(Sr[e])return Sr[e];if(!kr[e])return e;var t,n=kr[e];for(t in n)if(n.hasOwnProperty(t)&&t in Er)return Sr[e]=n[t];return e}u&&(Er=document.createElement(\"div\").style,\"AnimationEvent\"in window||(delete kr.animationend.animation,delete kr.animationiteration.animation,delete kr.animationstart.animation),\"TransitionEvent\"in window||delete kr.transitionend.transition);var _r=Or(\"animationend\"),Ar=Or(\"animationiteration\"),Cr=Or(\"animationstart\"),jr=Or(\"transitionend\"),Pr=new Map,Tr=\"abort auxClick cancel canPlay canPlayThrough click close contextMenu copy cut drag dragEnd dragEnter dragExit dragLeave dragOver dragStart drop durationChange emptied encrypted ended error gotPointerCapture input invalid keyDown keyPress keyUp load loadedData loadedMetadata loadStart lostPointerCapture mouseDown mouseMove mouseOut mouseOver mouseUp paste pause play playing pointerCancel pointerDown pointerMove pointerOut pointerOver pointerUp progress rateChange reset resize seeked seeking stalled submit suspend timeUpdate touchCancel touchEnd touchStart volumeChange scroll toggle touchMove waiting wheel\".split(\" \");function Ir(e,t){Pr.set(e,t),l(t,[e])}for(var Rr=0;RrSi||(e.current=ki[Si],ki[Si]=null,Si--)}function _i(e,t){Si++,ki[Si]=e.current,e.current=t}var Ai={},Ci=Ei(Ai),ji=Ei(!1),Pi=Ai;function Ti(e,t){var n=e.type.contextTypes;if(!n)return Ai;var r=e.stateNode;if(r&&r.__reactInternalMemoizedUnmaskedChildContext===t)return r.__reactInternalMemoizedMaskedChildContext;var i,o={};for(i in n)o[i]=t[i];return r&&((e=e.stateNode).__reactInternalMemoizedUnmaskedChildContext=t,e.__reactInternalMemoizedMaskedChildContext=o),o}function Ii(e){return null!=e.childContextTypes}function Ri(){Oi(ji),Oi(Ci)}function Ni(e,t,n){if(Ci.current!==Ai)throw Error(o(168));_i(Ci,t),_i(ji,n)}function $i(e,t,n){var r=e.stateNode;if(t=t.childContextTypes,\"function\"!=typeof r.getChildContext)return n;for(var i in r=r.getChildContext())if(!(i in t))throw Error(o(108,q(e)||\"Unknown\",i));return D({},n,r)}function Li(e){return e=(e=e.stateNode)&&e.__reactInternalMemoizedMergedChildContext||Ai,Pi=Ci.current,_i(Ci,e),_i(ji,ji.current),!0}function Di(e,t,n){var r=e.stateNode;if(!r)throw Error(o(169));n?(e=$i(e,t,Pi),r.__reactInternalMemoizedMergedChildContext=e,Oi(ji),Oi(Ci),_i(Ci,e)):Oi(ji),_i(ji,n)}var Mi=null,Fi=!1,zi=!1;function Bi(e){null===Mi?Mi=[e]:Mi.push(e)}function Ui(){if(!zi&&null!==Mi){zi=!0;var e=0,t=vt;try{var n=Mi;for(vt=1;e>=s,i-=s,Xi=1<<32-st(t)+i|n<m?(g=p,p=null):g=p.sibling;var y=f(i,p,a[m],l);if(null===y){null===p&&(p=g);break}e&&p&&null===y.alternate&&t(i,p),o=s(y,o,m),null===u?c=y:u.sibling=y,u=y,p=g}if(m===a.length)return n(i,p),io&&Zi(i,m),c;if(null===p){for(;mg?(y=m,m=null):y=m.sibling;var v=f(i,m,b.value,c);if(null===v){null===m&&(m=y);break}e&&m&&null===v.alternate&&t(i,m),a=s(v,a,g),null===p?u=v:p.sibling=v,p=v,m=y}if(b.done)return n(i,m),io&&Zi(i,g),u;if(null===m){for(;!b.done;g++,b=l.next())null!==(b=d(i,b.value,c))&&(a=s(b,a,g),null===p?u=b:p.sibling=b,p=b);return io&&Zi(i,g),u}for(m=r(i,m);!b.done;g++,b=l.next())null!==(b=h(m,i,g,b.value,c))&&(e&&null!==b.alternate&&m.delete(null===b.key?g:b.key),a=s(b,a,g),null===p?u=b:p.sibling=b,p=b);return e&&m.forEach((function(e){return t(i,e)})),io&&Zi(i,g),u}return function e(r,o,s,l){if(\"object\"==typeof s&&null!==s&&s.type===S&&null===s.key&&(s=s.props.children),\"object\"==typeof s&&null!==s){switch(s.$$typeof){case w:e:{for(var c=s.key,u=o;null!==u;){if(u.key===c){if((c=s.type)===S){if(7===u.tag){n(r,u.sibling),(o=i(u,s.props.children)).return=r,r=o;break e}}else if(u.elementType===c||\"object\"==typeof c&&null!==c&&c.$$typeof===I&&vo(c)===u.type){n(r,u.sibling),(o=i(u,s.props)).ref=yo(r,u,s),o.return=r,r=o;break e}n(r,u);break}t(r,u),u=u.sibling}s.type===S?((o=$c(s.props.children,r.mode,l,s.key)).return=r,r=o):((l=Nc(s.type,s.key,s.props,null,r.mode,l)).ref=yo(r,o,s),l.return=r,r=l)}return a(r);case k:e:{for(u=s.key;null!==o;){if(o.key===u){if(4===o.tag&&o.stateNode.containerInfo===s.containerInfo&&o.stateNode.implementation===s.implementation){n(r,o.sibling),(o=i(o,s.children||[])).return=r,r=o;break e}n(r,o);break}t(r,o),o=o.sibling}(o=Mc(s,r.mode,l)).return=r,r=o}return a(r);case I:return e(r,o,(u=s._init)(s._payload),l)}if(te(s))return m(r,o,s,l);if($(s))return g(r,o,s,l);bo(r,s)}return\"string\"==typeof s&&\"\"!==s||\"number\"==typeof s?(s=\"\"+s,null!==o&&6===o.tag?(n(r,o.sibling),(o=i(o,s)).return=r,r=o):(n(r,o),(o=Dc(s,r.mode,l)).return=r,r=o),a(r)):n(r,o)}}var wo=xo(!0),ko=xo(!1),So=Ei(null),Eo=null,Oo=null,_o=null;function Ao(){_o=Oo=Eo=null}function Co(e){var t=So.current;Oi(So),e._currentValue=t}function jo(e,t,n){for(;null!==e;){var r=e.alternate;if((e.childLanes&t)!==t?(e.childLanes|=t,null!==r&&(r.childLanes|=t)):null!==r&&(r.childLanes&t)!==t&&(r.childLanes|=t),e===n)break;e=e.return}}function Po(e,t){Eo=e,_o=Oo=null,null!==(e=e.dependencies)&&null!==e.firstContext&&(!!(e.lanes&t)&&(va=!0),e.firstContext=null)}function To(e){var t=e._currentValue;if(_o!==e)if(e={context:e,memoizedValue:t,next:null},null===Oo){if(null===Eo)throw Error(o(308));Oo=e,Eo.dependencies={lanes:0,firstContext:e}}else Oo=Oo.next=e;return t}var Io=null;function Ro(e){null===Io?Io=[e]:Io.push(e)}function No(e,t,n,r){var i=t.interleaved;return null===i?(n.next=n,Ro(t)):(n.next=i.next,i.next=n),t.interleaved=n,$o(e,r)}function $o(e,t){e.lanes|=t;var n=e.alternate;for(null!==n&&(n.lanes|=t),n=e,e=e.return;null!==e;)e.childLanes|=t,null!==(n=e.alternate)&&(n.childLanes|=t),n=e,e=e.return;return 3===n.tag?n.stateNode:null}var Lo=!1;function Do(e){e.updateQueue={baseState:e.memoizedState,firstBaseUpdate:null,lastBaseUpdate:null,shared:{pending:null,interleaved:null,lanes:0},effects:null}}function Mo(e,t){e=e.updateQueue,t.updateQueue===e&&(t.updateQueue={baseState:e.baseState,firstBaseUpdate:e.firstBaseUpdate,lastBaseUpdate:e.lastBaseUpdate,shared:e.shared,effects:e.effects})}function Fo(e,t){return{eventTime:e,lane:t,tag:0,payload:null,callback:null,next:null}}function zo(e,t,n){var r=e.updateQueue;if(null===r)return null;if(r=r.shared,2&Cl){var i=r.pending;return null===i?t.next=t:(t.next=i.next,i.next=t),r.pending=t,$o(e,n)}return null===(i=r.interleaved)?(t.next=t,Ro(r)):(t.next=i.next,i.next=t),r.interleaved=t,$o(e,n)}function Bo(e,t,n){if(null!==(t=t.updateQueue)&&(t=t.shared,4194240&n)){var r=t.lanes;n|=r&=e.pendingLanes,t.lanes=n,bt(e,n)}}function Uo(e,t){var n=e.updateQueue,r=e.alternate;if(null!==r&&n===(r=r.updateQueue)){var i=null,o=null;if(null!==(n=n.firstBaseUpdate)){do{var s={eventTime:n.eventTime,lane:n.lane,tag:n.tag,payload:n.payload,callback:n.callback,next:null};null===o?i=o=s:o=o.next=s,n=n.next}while(null!==n);null===o?i=o=t:o=o.next=t}else i=o=t;return n={baseState:r.baseState,firstBaseUpdate:i,lastBaseUpdate:o,shared:r.shared,effects:r.effects},void(e.updateQueue=n)}null===(e=n.lastBaseUpdate)?n.firstBaseUpdate=t:e.next=t,n.lastBaseUpdate=t}function qo(e,t,n,r){var i=e.updateQueue;Lo=!1;var o=i.firstBaseUpdate,s=i.lastBaseUpdate,a=i.shared.pending;if(null!==a){i.shared.pending=null;var l=a,c=l.next;l.next=null,null===s?o=c:s.next=c,s=l;var u=e.alternate;null!==u&&(a=(u=u.updateQueue).lastBaseUpdate)!==s&&(null===a?u.firstBaseUpdate=c:a.next=c,u.lastBaseUpdate=l)}if(null!==o){var p=i.baseState;for(s=0,u=c=l=null,a=o;;){var d=a.lane,f=a.eventTime;if((r&d)===d){null!==u&&(u=u.next={eventTime:f,lane:0,tag:a.tag,payload:a.payload,callback:a.callback,next:null});e:{var h=e,m=a;switch(d=t,f=n,m.tag){case 1:if(\"function\"==typeof(h=m.payload)){p=h.call(f,p,d);break e}p=h;break e;case 3:h.flags=-65537&h.flags|128;case 0:if(null==(d=\"function\"==typeof(h=m.payload)?h.call(f,p,d):h))break e;p=D({},p,d);break e;case 2:Lo=!0}}null!==a.callback&&0!==a.lane&&(e.flags|=64,null===(d=i.effects)?i.effects=[a]:d.push(a))}else f={eventTime:f,lane:d,tag:a.tag,payload:a.payload,callback:a.callback,next:null},null===u?(c=u=f,l=p):u=u.next=f,s|=d;if(null===(a=a.next)){if(null===(a=i.shared.pending))break;a=(d=a).next,d.next=null,i.lastBaseUpdate=d,i.shared.pending=null}}if(null===u&&(l=p),i.baseState=l,i.firstBaseUpdate=c,i.lastBaseUpdate=u,null!==(t=i.shared.interleaved)){i=t;do{s|=i.lane,i=i.next}while(i!==t)}else null===o&&(i.shared.lanes=0);Ll|=s,e.lanes=s,e.memoizedState=p}}function Vo(e,t,n){if(e=t.effects,t.effects=null,null!==e)for(t=0;tn?n:4,e(!0);var r=os.transition;os.transition={};try{e(!1),t()}finally{vt=n,os.transition=r}}function Hs(){return vs().memoizedState}function Ys(e,t,n){var r=tc(e);n={lane:r,action:n,hasEagerState:!1,eagerState:null,next:null},Qs(e)?Xs(t,n):null!==(n=No(e,t,n,r))&&(nc(n,e,r,ec()),Ks(n,t,r))}function Gs(e,t,n){var r=tc(e),i={lane:r,action:n,hasEagerState:!1,eagerState:null,next:null};if(Qs(e))Xs(t,i);else{var o=e.alternate;if(0===e.lanes&&(null===o||0===o.lanes)&&null!==(o=t.lastRenderedReducer))try{var s=t.lastRenderedState,a=o(s,n);if(i.hasEagerState=!0,i.eagerState=a,ar(a,s)){var l=t.interleaved;return null===l?(i.next=i,Ro(t)):(i.next=l.next,l.next=i),void(t.interleaved=i)}}catch(e){}null!==(n=No(e,t,i,r))&&(nc(n,e,r,i=ec()),Ks(n,t,r))}}function Qs(e){var t=e.alternate;return e===as||null!==t&&t===as}function Xs(e,t){ps=us=!0;var n=e.pending;null===n?t.next=t:(t.next=n.next,n.next=t),e.pending=t}function Ks(e,t,n){if(4194240&n){var r=t.lanes;n|=r&=e.pendingLanes,t.lanes=n,bt(e,n)}}var Zs={readContext:To,useCallback:hs,useContext:hs,useEffect:hs,useImperativeHandle:hs,useInsertionEffect:hs,useLayoutEffect:hs,useMemo:hs,useReducer:hs,useRef:hs,useState:hs,useDebugValue:hs,useDeferredValue:hs,useTransition:hs,useMutableSource:hs,useSyncExternalStore:hs,useId:hs,unstable_isNewReconciler:!1},Js={readContext:To,useCallback:function(e,t){return bs().memoizedState=[e,void 0===t?null:t],e},useContext:To,useEffect:$s,useImperativeHandle:function(e,t,n){return n=null!=n?n.concat([e]):null,Rs(4194308,4,Fs.bind(null,t,e),n)},useLayoutEffect:function(e,t){return Rs(4194308,4,e,t)},useInsertionEffect:function(e,t){return Rs(4,2,e,t)},useMemo:function(e,t){var n=bs();return t=void 0===t?null:t,e=e(),n.memoizedState=[e,t],e},useReducer:function(e,t,n){var r=bs();return t=void 0!==n?n(t):t,r.memoizedState=r.baseState=t,e={pending:null,interleaved:null,lanes:0,dispatch:null,lastRenderedReducer:e,lastRenderedState:t},r.queue=e,e=e.dispatch=Ys.bind(null,as,e),[r.memoizedState,e]},useRef:function(e){return e={current:e},bs().memoizedState=e},useState:Ps,useDebugValue:Bs,useDeferredValue:function(e){return bs().memoizedState=e},useTransition:function(){var e=Ps(!1),t=e[0];return e=Ws.bind(null,e[1]),bs().memoizedState=e,[t,e]},useMutableSource:function(){},useSyncExternalStore:function(e,t,n){var r=as,i=bs();if(io){if(void 0===n)throw Error(o(407));n=n()}else{if(n=t(),null===jl)throw Error(o(349));30&ss||Os(r,t,n)}i.memoizedState=n;var s={value:n,getSnapshot:t};return i.queue=s,$s(As.bind(null,r,s,e),[e]),r.flags|=2048,Ts(9,_s.bind(null,r,s,n,t),void 0,null),n},useId:function(){var e=bs(),t=jl.identifierPrefix;if(io){var n=Ki;t=\":\"+t+\"R\"+(n=(Xi&~(1<<32-st(Xi)-1)).toString(32)+n),0<(n=ds++)&&(t+=\"H\"+n.toString(32)),t+=\":\"}else t=\":\"+t+\"r\"+(n=fs++).toString(32)+\":\";return e.memoizedState=t},unstable_isNewReconciler:!1},ea={readContext:To,useCallback:Us,useContext:To,useEffect:Ls,useImperativeHandle:zs,useInsertionEffect:Ds,useLayoutEffect:Ms,useMemo:qs,useReducer:ws,useRef:Is,useState:function(){return ws(xs)},useDebugValue:Bs,useDeferredValue:function(e){return Vs(vs(),ls.memoizedState,e)},useTransition:function(){return[ws(xs)[0],vs().memoizedState]},useMutableSource:Ss,useSyncExternalStore:Es,useId:Hs,unstable_isNewReconciler:!1},ta={readContext:To,useCallback:Us,useContext:To,useEffect:Ls,useImperativeHandle:zs,useInsertionEffect:Ds,useLayoutEffect:Ms,useMemo:qs,useReducer:ks,useRef:Is,useState:function(){return ks(xs)},useDebugValue:Bs,useDeferredValue:function(e){var t=vs();return null===ls?t.memoizedState=e:Vs(t,ls.memoizedState,e)},useTransition:function(){return[ks(xs)[0],vs().memoizedState]},useMutableSource:Ss,useSyncExternalStore:Es,useId:Hs,unstable_isNewReconciler:!1};function na(e,t){if(e&&e.defaultProps){for(var n in t=D({},t),e=e.defaultProps)void 0===t[n]&&(t[n]=e[n]);return t}return t}function ra(e,t,n,r){n=null==(n=n(r,t=e.memoizedState))?t:D({},t,n),e.memoizedState=n,0===e.lanes&&(e.updateQueue.baseState=n)}var ia={isMounted:function(e){return!!(e=e._reactInternals)&&Ue(e)===e},enqueueSetState:function(e,t,n){e=e._reactInternals;var r=ec(),i=tc(e),o=Fo(r,i);o.payload=t,null!=n&&(o.callback=n),null!==(t=zo(e,o,i))&&(nc(t,e,i,r),Bo(t,e,i))},enqueueReplaceState:function(e,t,n){e=e._reactInternals;var r=ec(),i=tc(e),o=Fo(r,i);o.tag=1,o.payload=t,null!=n&&(o.callback=n),null!==(t=zo(e,o,i))&&(nc(t,e,i,r),Bo(t,e,i))},enqueueForceUpdate:function(e,t){e=e._reactInternals;var n=ec(),r=tc(e),i=Fo(n,r);i.tag=2,null!=t&&(i.callback=t),null!==(t=zo(e,i,r))&&(nc(t,e,r,n),Bo(t,e,r))}};function oa(e,t,n,r,i,o,s){return\"function\"==typeof(e=e.stateNode).shouldComponentUpdate?e.shouldComponentUpdate(r,o,s):!(t.prototype&&t.prototype.isPureReactComponent&&lr(n,r)&&lr(i,o))}function sa(e,t,n){var r=!1,i=Ai,o=t.contextType;return\"object\"==typeof o&&null!==o?o=To(o):(i=Ii(t)?Pi:Ci.current,o=(r=null!=(r=t.contextTypes))?Ti(e,i):Ai),t=new t(n,o),e.memoizedState=null!==t.state&&void 0!==t.state?t.state:null,t.updater=ia,e.stateNode=t,t._reactInternals=e,r&&((e=e.stateNode).__reactInternalMemoizedUnmaskedChildContext=i,e.__reactInternalMemoizedMaskedChildContext=o),t}function aa(e,t,n,r){e=t.state,\"function\"==typeof t.componentWillReceiveProps&&t.componentWillReceiveProps(n,r),\"function\"==typeof t.UNSAFE_componentWillReceiveProps&&t.UNSAFE_componentWillReceiveProps(n,r),t.state!==e&&ia.enqueueReplaceState(t,t.state,null)}function la(e,t,n,r){var i=e.stateNode;i.props=n,i.state=e.memoizedState,i.refs={},Do(e);var o=t.contextType;\"object\"==typeof o&&null!==o?i.context=To(o):(o=Ii(t)?Pi:Ci.current,i.context=Ti(e,o)),i.state=e.memoizedState,\"function\"==typeof(o=t.getDerivedStateFromProps)&&(ra(e,t,o,n),i.state=e.memoizedState),\"function\"==typeof t.getDerivedStateFromProps||\"function\"==typeof i.getSnapshotBeforeUpdate||\"function\"!=typeof i.UNSAFE_componentWillMount&&\"function\"!=typeof i.componentWillMount||(t=i.state,\"function\"==typeof i.componentWillMount&&i.componentWillMount(),\"function\"==typeof i.UNSAFE_componentWillMount&&i.UNSAFE_componentWillMount(),t!==i.state&&ia.enqueueReplaceState(i,i.state,null),qo(e,n,i,r),i.state=e.memoizedState),\"function\"==typeof i.componentDidMount&&(e.flags|=4194308)}function ca(e,t){try{var n=\"\",r=t;do{n+=B(r),r=r.return}while(r);var i=n}catch(e){i=\"\\nError generating stack: \"+e.message+\"\\n\"+e.stack}return{value:e,source:t,stack:i,digest:null}}function ua(e,t,n){return{value:e,source:null,stack:null!=n?n:null,digest:null!=t?t:null}}function pa(e,t){try{console.error(t.value)}catch(e){setTimeout((function(){throw e}))}}var da=\"function\"==typeof WeakMap?WeakMap:Map;function fa(e,t,n){(n=Fo(-1,n)).tag=3,n.payload={element:null};var r=t.value;return n.callback=function(){Vl||(Vl=!0,Wl=r),pa(0,t)},n}function ha(e,t,n){(n=Fo(-1,n)).tag=3;var r=e.type.getDerivedStateFromError;if(\"function\"==typeof r){var i=t.value;n.payload=function(){return r(i)},n.callback=function(){pa(0,t)}}var o=e.stateNode;return null!==o&&\"function\"==typeof o.componentDidCatch&&(n.callback=function(){pa(0,t),\"function\"!=typeof r&&(null===Hl?Hl=new Set([this]):Hl.add(this));var e=t.stack;this.componentDidCatch(t.value,{componentStack:null!==e?e:\"\"})}),n}function ma(e,t,n){var r=e.pingCache;if(null===r){r=e.pingCache=new da;var i=new Set;r.set(t,i)}else void 0===(i=r.get(t))&&(i=new Set,r.set(t,i));i.has(n)||(i.add(n),e=Oc.bind(null,e,t,n),t.then(e,e))}function ga(e){do{var t;if((t=13===e.tag)&&(t=null===(t=e.memoizedState)||null!==t.dehydrated),t)return e;e=e.return}while(null!==e);return null}function ya(e,t,n,r,i){return 1&e.mode?(e.flags|=65536,e.lanes=i,e):(e===t?e.flags|=65536:(e.flags|=128,n.flags|=131072,n.flags&=-52805,1===n.tag&&(null===n.alternate?n.tag=17:((t=Fo(-1,1)).tag=2,zo(n,t,1))),n.lanes|=1),e)}var ba=x.ReactCurrentOwner,va=!1;function xa(e,t,n,r){t.child=null===e?ko(t,null,n,r):wo(t,e.child,n,r)}function wa(e,t,n,r,i){n=n.render;var o=t.ref;return Po(t,i),r=gs(e,t,n,r,o,i),n=ys(),null===e||va?(io&&n&&eo(t),t.flags|=1,xa(e,t,r,i),t.child):(t.updateQueue=e.updateQueue,t.flags&=-2053,e.lanes&=~i,Va(e,t,i))}function ka(e,t,n,r,i){if(null===e){var o=n.type;return\"function\"!=typeof o||Ic(o)||void 0!==o.defaultProps||null!==n.compare||void 0!==n.defaultProps?((e=Nc(n.type,null,r,t,t.mode,i)).ref=t.ref,e.return=t,t.child=e):(t.tag=15,t.type=o,Sa(e,t,o,r,i))}if(o=e.child,!(e.lanes&i)){var s=o.memoizedProps;if((n=null!==(n=n.compare)?n:lr)(s,r)&&e.ref===t.ref)return Va(e,t,i)}return t.flags|=1,(e=Rc(o,r)).ref=t.ref,e.return=t,t.child=e}function Sa(e,t,n,r,i){if(null!==e){var o=e.memoizedProps;if(lr(o,r)&&e.ref===t.ref){if(va=!1,t.pendingProps=r=o,!(e.lanes&i))return t.lanes=e.lanes,Va(e,t,i);131072&e.flags&&(va=!0)}}return _a(e,t,n,r,i)}function Ea(e,t,n){var r=t.pendingProps,i=r.children,o=null!==e?e.memoizedState:null;if(\"hidden\"===r.mode)if(1&t.mode){if(!(1073741824&n))return e=null!==o?o.baseLanes|n:n,t.lanes=t.childLanes=1073741824,t.memoizedState={baseLanes:e,cachePool:null,transitions:null},t.updateQueue=null,_i(Rl,Il),Il|=e,null;t.memoizedState={baseLanes:0,cachePool:null,transitions:null},r=null!==o?o.baseLanes:n,_i(Rl,Il),Il|=r}else t.memoizedState={baseLanes:0,cachePool:null,transitions:null},_i(Rl,Il),Il|=n;else null!==o?(r=o.baseLanes|n,t.memoizedState=null):r=n,_i(Rl,Il),Il|=r;return xa(e,t,i,n),t.child}function Oa(e,t){var n=t.ref;(null===e&&null!==n||null!==e&&e.ref!==n)&&(t.flags|=512,t.flags|=2097152)}function _a(e,t,n,r,i){var o=Ii(n)?Pi:Ci.current;return o=Ti(t,o),Po(t,i),n=gs(e,t,n,r,o,i),r=ys(),null===e||va?(io&&r&&eo(t),t.flags|=1,xa(e,t,n,i),t.child):(t.updateQueue=e.updateQueue,t.flags&=-2053,e.lanes&=~i,Va(e,t,i))}function Aa(e,t,n,r,i){if(Ii(n)){var o=!0;Li(t)}else o=!1;if(Po(t,i),null===t.stateNode)qa(e,t),sa(t,n,r),la(t,n,r,i),r=!0;else if(null===e){var s=t.stateNode,a=t.memoizedProps;s.props=a;var l=s.context,c=n.contextType;c=\"object\"==typeof c&&null!==c?To(c):Ti(t,c=Ii(n)?Pi:Ci.current);var u=n.getDerivedStateFromProps,p=\"function\"==typeof u||\"function\"==typeof s.getSnapshotBeforeUpdate;p||\"function\"!=typeof s.UNSAFE_componentWillReceiveProps&&\"function\"!=typeof s.componentWillReceiveProps||(a!==r||l!==c)&&aa(t,s,r,c),Lo=!1;var d=t.memoizedState;s.state=d,qo(t,r,s,i),l=t.memoizedState,a!==r||d!==l||ji.current||Lo?(\"function\"==typeof u&&(ra(t,n,u,r),l=t.memoizedState),(a=Lo||oa(t,n,a,r,d,l,c))?(p||\"function\"!=typeof s.UNSAFE_componentWillMount&&\"function\"!=typeof s.componentWillMount||(\"function\"==typeof s.componentWillMount&&s.componentWillMount(),\"function\"==typeof s.UNSAFE_componentWillMount&&s.UNSAFE_componentWillMount()),\"function\"==typeof s.componentDidMount&&(t.flags|=4194308)):(\"function\"==typeof s.componentDidMount&&(t.flags|=4194308),t.memoizedProps=r,t.memoizedState=l),s.props=r,s.state=l,s.context=c,r=a):(\"function\"==typeof s.componentDidMount&&(t.flags|=4194308),r=!1)}else{s=t.stateNode,Mo(e,t),a=t.memoizedProps,c=t.type===t.elementType?a:na(t.type,a),s.props=c,p=t.pendingProps,d=s.context,l=\"object\"==typeof(l=n.contextType)&&null!==l?To(l):Ti(t,l=Ii(n)?Pi:Ci.current);var f=n.getDerivedStateFromProps;(u=\"function\"==typeof f||\"function\"==typeof s.getSnapshotBeforeUpdate)||\"function\"!=typeof s.UNSAFE_componentWillReceiveProps&&\"function\"!=typeof s.componentWillReceiveProps||(a!==p||d!==l)&&aa(t,s,r,l),Lo=!1,d=t.memoizedState,s.state=d,qo(t,r,s,i);var h=t.memoizedState;a!==p||d!==h||ji.current||Lo?(\"function\"==typeof f&&(ra(t,n,f,r),h=t.memoizedState),(c=Lo||oa(t,n,c,r,d,h,l)||!1)?(u||\"function\"!=typeof s.UNSAFE_componentWillUpdate&&\"function\"!=typeof s.componentWillUpdate||(\"function\"==typeof s.componentWillUpdate&&s.componentWillUpdate(r,h,l),\"function\"==typeof s.UNSAFE_componentWillUpdate&&s.UNSAFE_componentWillUpdate(r,h,l)),\"function\"==typeof s.componentDidUpdate&&(t.flags|=4),\"function\"==typeof s.getSnapshotBeforeUpdate&&(t.flags|=1024)):(\"function\"!=typeof s.componentDidUpdate||a===e.memoizedProps&&d===e.memoizedState||(t.flags|=4),\"function\"!=typeof s.getSnapshotBeforeUpdate||a===e.memoizedProps&&d===e.memoizedState||(t.flags|=1024),t.memoizedProps=r,t.memoizedState=h),s.props=r,s.state=h,s.context=l,r=c):(\"function\"!=typeof s.componentDidUpdate||a===e.memoizedProps&&d===e.memoizedState||(t.flags|=4),\"function\"!=typeof s.getSnapshotBeforeUpdate||a===e.memoizedProps&&d===e.memoizedState||(t.flags|=1024),r=!1)}return Ca(e,t,n,r,o,i)}function Ca(e,t,n,r,i,o){Oa(e,t);var s=!!(128&t.flags);if(!r&&!s)return i&&Di(t,n,!1),Va(e,t,o);r=t.stateNode,ba.current=t;var a=s&&\"function\"!=typeof n.getDerivedStateFromError?null:r.render();return t.flags|=1,null!==e&&s?(t.child=wo(t,e.child,null,o),t.child=wo(t,null,a,o)):xa(e,t,a,o),t.memoizedState=r.state,i&&Di(t,n,!0),t.child}function ja(e){var t=e.stateNode;t.pendingContext?Ni(0,t.pendingContext,t.pendingContext!==t.context):t.context&&Ni(0,t.context,!1),Xo(e,t.containerInfo)}function Pa(e,t,n,r,i){return ho(),mo(i),t.flags|=256,xa(e,t,n,r),t.child}var Ta,Ia,Ra,Na,$a={dehydrated:null,treeContext:null,retryLane:0};function La(e){return{baseLanes:e,cachePool:null,transitions:null}}function Da(e,t,n){var r,i=t.pendingProps,s=es.current,a=!1,l=!!(128&t.flags);if((r=l)||(r=(null===e||null!==e.memoizedState)&&!!(2&s)),r?(a=!0,t.flags&=-129):null!==e&&null===e.memoizedState||(s|=1),_i(es,1&s),null===e)return co(t),null!==(e=t.memoizedState)&&null!==(e=e.dehydrated)?(1&t.mode?\"$!\"===e.data?t.lanes=8:t.lanes=1073741824:t.lanes=1,null):(l=i.children,e=i.fallback,a?(i=t.mode,a=t.child,l={mode:\"hidden\",children:l},1&i||null===a?a=Lc(l,i,0,null):(a.childLanes=0,a.pendingProps=l),e=$c(e,i,n,null),a.return=t,e.return=t,a.sibling=e,t.child=a,t.child.memoizedState=La(n),t.memoizedState=$a,e):Ma(t,l));if(null!==(s=e.memoizedState)&&null!==(r=s.dehydrated))return function(e,t,n,r,i,s,a){if(n)return 256&t.flags?(t.flags&=-257,Fa(e,t,a,r=ua(Error(o(422))))):null!==t.memoizedState?(t.child=e.child,t.flags|=128,null):(s=r.fallback,i=t.mode,r=Lc({mode:\"visible\",children:r.children},i,0,null),(s=$c(s,i,a,null)).flags|=2,r.return=t,s.return=t,r.sibling=s,t.child=r,1&t.mode&&wo(t,e.child,null,a),t.child.memoizedState=La(a),t.memoizedState=$a,s);if(!(1&t.mode))return Fa(e,t,a,null);if(\"$!\"===i.data){if(r=i.nextSibling&&i.nextSibling.dataset)var l=r.dgst;return r=l,Fa(e,t,a,r=ua(s=Error(o(419)),r,void 0))}if(l=!!(a&e.childLanes),va||l){if(null!==(r=jl)){switch(a&-a){case 4:i=2;break;case 16:i=8;break;case 64:case 128:case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:case 262144:case 524288:case 1048576:case 2097152:case 4194304:case 8388608:case 16777216:case 33554432:case 67108864:i=32;break;case 536870912:i=268435456;break;default:i=0}0!==(i=i&(r.suspendedLanes|a)?0:i)&&i!==s.retryLane&&(s.retryLane=i,$o(e,i),nc(r,e,i,-1))}return mc(),Fa(e,t,a,r=ua(Error(o(421))))}return\"$?\"===i.data?(t.flags|=128,t.child=e.child,t=Ac.bind(null,e),i._reactRetry=t,null):(e=s.treeContext,ro=ci(i.nextSibling),no=t,io=!0,oo=null,null!==e&&(Yi[Gi++]=Xi,Yi[Gi++]=Ki,Yi[Gi++]=Qi,Xi=e.id,Ki=e.overflow,Qi=t),(t=Ma(t,r.children)).flags|=4096,t)}(e,t,l,i,r,s,n);if(a){a=i.fallback,l=t.mode,r=(s=e.child).sibling;var c={mode:\"hidden\",children:i.children};return 1&l||t.child===s?(i=Rc(s,c)).subtreeFlags=14680064&s.subtreeFlags:((i=t.child).childLanes=0,i.pendingProps=c,t.deletions=null),null!==r?a=Rc(r,a):(a=$c(a,l,n,null)).flags|=2,a.return=t,i.return=t,i.sibling=a,t.child=i,i=a,a=t.child,l=null===(l=e.child.memoizedState)?La(n):{baseLanes:l.baseLanes|n,cachePool:null,transitions:l.transitions},a.memoizedState=l,a.childLanes=e.childLanes&~n,t.memoizedState=$a,i}return e=(a=e.child).sibling,i=Rc(a,{mode:\"visible\",children:i.children}),!(1&t.mode)&&(i.lanes=n),i.return=t,i.sibling=null,null!==e&&(null===(n=t.deletions)?(t.deletions=[e],t.flags|=16):n.push(e)),t.child=i,t.memoizedState=null,i}function Ma(e,t){return(t=Lc({mode:\"visible\",children:t},e.mode,0,null)).return=e,e.child=t}function Fa(e,t,n,r){return null!==r&&mo(r),wo(t,e.child,null,n),(e=Ma(t,t.pendingProps.children)).flags|=2,t.memoizedState=null,e}function za(e,t,n){e.lanes|=t;var r=e.alternate;null!==r&&(r.lanes|=t),jo(e.return,t,n)}function Ba(e,t,n,r,i){var o=e.memoizedState;null===o?e.memoizedState={isBackwards:t,rendering:null,renderingStartTime:0,last:r,tail:n,tailMode:i}:(o.isBackwards=t,o.rendering=null,o.renderingStartTime=0,o.last=r,o.tail=n,o.tailMode=i)}function Ua(e,t,n){var r=t.pendingProps,i=r.revealOrder,o=r.tail;if(xa(e,t,r.children,n),2&(r=es.current))r=1&r|2,t.flags|=128;else{if(null!==e&&128&e.flags)e:for(e=t.child;null!==e;){if(13===e.tag)null!==e.memoizedState&&za(e,n,t);else if(19===e.tag)za(e,n,t);else if(null!==e.child){e.child.return=e,e=e.child;continue}if(e===t)break e;for(;null===e.sibling;){if(null===e.return||e.return===t)break e;e=e.return}e.sibling.return=e.return,e=e.sibling}r&=1}if(_i(es,r),1&t.mode)switch(i){case\"forwards\":for(n=t.child,i=null;null!==n;)null!==(e=n.alternate)&&null===ts(e)&&(i=n),n=n.sibling;null===(n=i)?(i=t.child,t.child=null):(i=n.sibling,n.sibling=null),Ba(t,!1,i,n,o);break;case\"backwards\":for(n=null,i=t.child,t.child=null;null!==i;){if(null!==(e=i.alternate)&&null===ts(e)){t.child=i;break}e=i.sibling,i.sibling=n,n=i,i=e}Ba(t,!0,n,null,o);break;case\"together\":Ba(t,!1,null,null,void 0);break;default:t.memoizedState=null}else t.memoizedState=null;return t.child}function qa(e,t){!(1&t.mode)&&null!==e&&(e.alternate=null,t.alternate=null,t.flags|=2)}function Va(e,t,n){if(null!==e&&(t.dependencies=e.dependencies),Ll|=t.lanes,!(n&t.childLanes))return null;if(null!==e&&t.child!==e.child)throw Error(o(153));if(null!==t.child){for(n=Rc(e=t.child,e.pendingProps),t.child=n,n.return=t;null!==e.sibling;)e=e.sibling,(n=n.sibling=Rc(e,e.pendingProps)).return=t;n.sibling=null}return t.child}function Wa(e,t){if(!io)switch(e.tailMode){case\"hidden\":t=e.tail;for(var n=null;null!==t;)null!==t.alternate&&(n=t),t=t.sibling;null===n?e.tail=null:n.sibling=null;break;case\"collapsed\":n=e.tail;for(var r=null;null!==n;)null!==n.alternate&&(r=n),n=n.sibling;null===r?t||null===e.tail?e.tail=null:e.tail.sibling=null:r.sibling=null}}function Ha(e){var t=null!==e.alternate&&e.alternate.child===e.child,n=0,r=0;if(t)for(var i=e.child;null!==i;)n|=i.lanes|i.childLanes,r|=14680064&i.subtreeFlags,r|=14680064&i.flags,i.return=e,i=i.sibling;else for(i=e.child;null!==i;)n|=i.lanes|i.childLanes,r|=i.subtreeFlags,r|=i.flags,i.return=e,i=i.sibling;return e.subtreeFlags|=r,e.childLanes=n,t}function Ya(e,t,n){var r=t.pendingProps;switch(to(t),t.tag){case 2:case 16:case 15:case 0:case 11:case 7:case 8:case 12:case 9:case 14:return Ha(t),null;case 1:case 17:return Ii(t.type)&&Ri(),Ha(t),null;case 3:return r=t.stateNode,Ko(),Oi(ji),Oi(Ci),rs(),r.pendingContext&&(r.context=r.pendingContext,r.pendingContext=null),null!==e&&null!==e.child||(po(t)?t.flags|=4:null===e||e.memoizedState.isDehydrated&&!(256&t.flags)||(t.flags|=1024,null!==oo&&(sc(oo),oo=null))),Ia(e,t),Ha(t),null;case 5:Jo(t);var i=Qo(Go.current);if(n=t.type,null!==e&&null!=t.stateNode)Ra(e,t,n,r,i),e.ref!==t.ref&&(t.flags|=512,t.flags|=2097152);else{if(!r){if(null===t.stateNode)throw Error(o(166));return Ha(t),null}if(e=Qo(Ho.current),po(t)){r=t.stateNode,n=t.type;var s=t.memoizedProps;switch(r[di]=t,r[fi]=s,e=!!(1&t.mode),n){case\"dialog\":Fr(\"cancel\",r),Fr(\"close\",r);break;case\"iframe\":case\"object\":case\"embed\":Fr(\"load\",r);break;case\"video\":case\"audio\":for(i=0;i<$r.length;i++)Fr($r[i],r);break;case\"source\":Fr(\"error\",r);break;case\"img\":case\"image\":case\"link\":Fr(\"error\",r),Fr(\"load\",r);break;case\"details\":Fr(\"toggle\",r);break;case\"input\":X(r,s),Fr(\"invalid\",r);break;case\"select\":r._wrapperState={wasMultiple:!!s.multiple},Fr(\"invalid\",r);break;case\"textarea\":ie(r,s),Fr(\"invalid\",r)}for(var l in be(n,s),i=null,s)if(s.hasOwnProperty(l)){var c=s[l];\"children\"===l?\"string\"==typeof c?r.textContent!==c&&(!0!==s.suppressHydrationWarning&&Zr(r.textContent,c,e),i=[\"children\",c]):\"number\"==typeof c&&r.textContent!==\"\"+c&&(!0!==s.suppressHydrationWarning&&Zr(r.textContent,c,e),i=[\"children\",\"\"+c]):a.hasOwnProperty(l)&&null!=c&&\"onScroll\"===l&&Fr(\"scroll\",r)}switch(n){case\"input\":H(r),J(r,s,!0);break;case\"textarea\":H(r),se(r);break;case\"select\":case\"option\":break;default:\"function\"==typeof s.onClick&&(r.onclick=Jr)}r=i,t.updateQueue=r,null!==r&&(t.flags|=4)}else{l=9===i.nodeType?i:i.ownerDocument,\"http://www.w3.org/1999/xhtml\"===e&&(e=ae(n)),\"http://www.w3.org/1999/xhtml\"===e?\"script\"===n?((e=l.createElement(\"div\")).innerHTML=\"\n \n \n \n![\"SCR-20230123-m1t\"](\"https://user-images.githubusercontent.com/95222/214056666-585c0479-c122-4cb3-add4-b8844088ccdd.png\")
![](\"https://django-ninja.dev/img/logo-big.png\"){kind=logo}
\n